ps2avrGB键盘刷QMK固件

ps2avrGB键盘刷QMK固件

先聊点题外话,鬼知道为什么我就进了客制化的大坑。
如果是新人,请记得我的经验:客制化不省钱!客制化让键盘适应你,而不是你适应键盘!
ps2avrGB是韩国人开发的主控套件,国内也有很多人用这个做了定制化的开发,比如麦田外设的板子。(pcb上有mt字样)
ps2avrGB的官方刷板应用是BootmapperClient,github上luizribeiro为它做了qmk的适配。
qmk顶顶大名,就不用多介绍了,基于chibiOS系统,支持模拟鼠标,可以一键进入刷机模式。总之功能特别强大!
没错!你的键盘里跑着一个操作系统!!!还能代替鼠标!!!
我买的是麦田的白色pcb的gh60板子,所以我只能以这个为例,记录下刷板子的过程。
我的板子没上灯,所以关于灯光的设置都没有,如果你看得懂qmk文档可以自己加灯光配置。
本文会默认读者已经有了一定的动手能力。毕竟你都搞客制化了,哪有纯菜鸟会玩这个?对吧。
本文会默认读者能读懂英文教程,别怕,翻译软件站在你身后!

动手前请先看下全文,如果大多看不懂,请不要操作,键盘会变砖的!!!
动手前请先看下全文,如果大多看不懂,请不要操作,键盘会变砖的!!!
动手前请先看下全文,如果大多看不懂,请不要操作,键盘会变砖的!!!
如果真的发生的悲剧,键盘变砖,你可以在github上给qmk提issue。
但是我不会对此负责,也不保证能帮助你修复键盘
今天是2018-01-26,如果时间过去太久这个教程可能已经失效了

刷板子准备

在刷板子之前需要做好如下的准备:

  • 1.把github上的luizriberiro的qmk项目clone到本地,并且配置好编译环境。
  • 2.下载BootmapperClient,最新的版本最好。
  • 3.找到进入键盘刷机模式(DFU模式)的方法。

qmk的开发环境我是在ubuntu环境下搭建的,qmk有详细教程,只要搭建好编译环境就可以,不用管烧录工具。
我的bootmapperClient版本是v0.10.0
ps2avrGB进入刷机模式通常有两种:
韩国的键盘是断开连接线,按住左ctrl或者U或者esc,然后再连接。
一些国内客制化键盘是断开连接线,短接电路板上的两个接口,再连接。
我的pcb是要短接电路板的,在电路板侧边缘有标p1的两个接口,我用镊子短接。
一定注意不能用usb扩展口接键盘,电脑识别不出来的。
进入刷机模式成功的标志就是连接电脑之后,键盘所有按键都没反应,变砖是部分按键没反应。

生成刷机文件步骤

首先要修改qmk的代码以适配自己的键盘配列表。
首先编辑config.h,适配键盘的配列。
在#endif前添加如下内容:

/* mouse settings*/  //定义模拟鼠标参数,单位毫秒  
#define MOUSEKEY_DELAY             150  //鼠标连续移动延迟,过大笨拙,过小发飘  
#define MOUSEKEY_INTERVAL          20  //鼠标刷新间隔  
#define MOUSEKEY_MAX_SPEED         2  //鼠标最大速度  
#define MOUSEKEY_TIME_TO_MAX       2  //鼠标到达最大速的时间  
#define MOUSEKEY_WHEEL_MAX_SPEED   2  //鼠标滚轮最大速度  
#define MOUSEKEY_WHEEL_TIME_TO_MAX 2  //鼠标滚轮到达最大速度的时间  

再编辑ps2avrGB.h文件,适配键盘的配列。
在#endif前添加如下内容:

#define MY_KEYMAP( \

  K31, K32, K33, K34, K35, K36, K37, K38, K39, K3A, K3B, K3C, K3D,      K3F, \
  K41, K42, K43, K44, K45, K46, K47, K48, K49, K4A, K4B, K4C, K4D, K4E,      \
  K51, K52, K53, K54, K55, K56, K57, K58, K59, K5A, K5B, K5C,      K5E,      \
  K61,      K63, K64, K65, K66, K67, K68, K69, K6A, K6B, K6C,      K6E,      \
  K71, K72, K73,                     K78,      K7A, K7B,      K7D, K7E       \
){ \
  { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \
  { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \
  { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \
  { K31,   K32,   K33,   K34,   K35,   K36,   K37,   K38,   K39,   K3A,   K3B,   K3C,   K3D,   KC_NO, K3F   }, \
  { K41,   K42,   K43,   K44,   K45,   K46,   K47,   K48,   K49,   K4A,   K4B,   K4C,   K4D,   K4E,   KC_NO }, \
  { K51,   K52,   K53,   K54,   K55,   K56,   K57,   K58,   K59,   K5A,   K5B,   K5C,   KC_NO, K5E,   KC_NO }, \
  { K61,   KC_NO, K63,   K64,   K65,   K66,   K67,   K68,   K69,   K6A,   K6B,   K6C,   KC_NO, K6E,   KC_NO }, \
  { K71,   K72,   K73,   KC_NO, KC_NO, KC_NO, KC_NO, K78,   KC_NO, K7A,   K7B,   KC_NO, K7D,   K7E,   KC_NO }  \
}

配置的方法其实挺简单的。格式如下:

#define MY_KEYMAP( \

    K11, K12, K13, \
    K21,      K23  \
){ \
    { KC_11, KC_12, KC_13 }, \
    { KC_21, KC_NO, KC_23 }  \
}

上面的矩阵是我们的键盘轴排列方式,下面的矩阵是这些轴焊接在了哪里。
比如我们设置了一个2x3的键盘矩阵,在上面焊了五个轴,排列如第一个矩阵。
在第二个矩阵一一对应的,配置轴焊接的位置,没有焊轴的位置用NO占位。
以上是我的怕pcb的布局,每个人习惯不同,布局都不同,可能需要微调。
建立/root/qmk/qmk_firmware/keyboards/ps2avrGB/keymaps/mykeymap文件夹,最后的mykeymap可以任意改名。
进入新建的文件夹,建立keymap.c文件。内容如下:

#include "ps2avrGB.h"

#include "action_layer.h"

#include "rgblight.h"


const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
    [0] = MY_KEYMAP(
        KC_ESC,  KC_1,    KC_2,    KC_3,    KC_4,    KC_5,    KC_6,    KC_7,    KC_8,    KC_9,    KC_0,    KC_MINS, KC_EQL,           KC_BSPC,
        KC_TAB,  KC_Q,    KC_W,    KC_E,    KC_R,    KC_T,    KC_Y,    KC_U,    KC_I,    KC_O,    KC_P,    KC_LBRC, KC_RBRC, KC_BSLS,
        KC_LCTL, KC_A,    KC_S,    KC_D,    KC_F,    KC_G,    KC_H,    KC_J,    KC_K,    KC_L,    KC_SCLN, KC_QUOT,          KC_ENT,
        KC_LSFT,          KC_Z,    KC_X,    KC_C,    KC_V,    KC_B,    KC_N,    KC_M,    KC_COMM, KC_DOT,  KC_SLSH,          KC_FN0,
        KC_FN1,  KC_RGUI, KC_LALT,                                     KC_SPC,           KC_FN2,  KC_APP,           KC_CAPS, KC_INS
    ),
    [1] = MY_KEYMAP(
        KC_GRV,  KC_F1,   KC_F2,   KC_F3,   KC_F4,   KC_F5,   KC_F6,   KC_F7,   KC_F8,   KC_F9,   KC_F10,  KC_F11,  KC_F12,           KC_DEL,
        KC_TRNS, KC_TRNS, KC_TRNS, KC_PGUP, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
        KC_TRNS, KC_TRNS, KC_HOME, KC_PGDN, KC_END,  KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS,          KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS,                                     KC_TRNS,          KC_TRNS, KC_TRNS,          KC_TRNS, KC_TRNS
    ),
    [2] = MY_KEYMAP(
        KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_LEFT, KC_DOWN, KC_UP,   KC_RGHT, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS,          KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS,                                     KC_TRNS,          KC_TRNS, KC_TRNS,          KC_TRNS, KC_TRNS
    ),
    [3] = MY_KEYMAP(
        RESET,   KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS, KC_WH_U, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_MS_U, KC_TRNS, KC_TRNS, KC_TRNS,
        KC_TRNS, KC_TRNS, KC_BTN2, KC_WH_D, KC_BTN1, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_MS_L, KC_MS_D, KC_MS_R,          KC_TRNS,
        KC_TRNS,          KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,          KC_TRNS,
        KC_TRNS, KC_TRNS, KC_TRNS,                                     KC_TRNS,          KC_TRNS, KC_TRNS,          KC_TRNS, KC_TRNS
    ),
};

const uint16_t PROGMEM fn_actions[] = {
  [0]  = ACTION_LAYER_MOMENTARY(1),
  [1]  = ACTION_LAYER_MOMENTARY(2),
  [2]  = ACTION_LAYER_MOMENTARY(3),
};

这里的键位设置是和ps2avrGB.h里的设置对应的。应该很容易看懂。
默认键盘在第0层状态,按下FN0键进入第一层,按下FN1进入第二层,以此类推。
KC_TRNS表示透明,比如字母K键。按下FN1和K键,从第0层进入第2层,KC_TRNS会透明映射到下面第0层,输出还是K。
KC_MS_L就是鼠标模拟向左移动,具体的keycode可以参考qmk的keycode文档
第三层的左上角RESET键表示进入刷机(DFU)模式,有了这个键就不用每次都短接了。
最后回到qmk_firmware,执行下面的命令:

make ps2avrGB

大概会有一个这样的回显:

Making ps2avrGB with keymap default [OK]
Making ps2avrGB with keymap luizribeiro [OK]
Making ps2avrGB with keymap mykeyboard [OK]

成功之后会生成ps2avrGB_mykeyboard.hex文件,就是我们的目标文件了。

刷板子步骤

刷板子我是在windows平台上进行的,linux当然也可以,不过我没成功。
通过按键或者短接,让键盘的板子进入刷机模式,连接电脑,打开bootmapperClient。
右上角选option,左下角的utils里点firm up,弹出的窗口中选中ps2avrGB_mykeyboard.hex,刷机开始。
没问题的话会弹出一个对话框,在跑马灯显示一堆二进制地址,不到10秒对话框消失,刷机完成。
如果刷机成功,以后再刷的时候按reset键就可以进去刷机模式了,不用每次都短接。
第一次配列肯定是会有问题的,用一段时间发现不方便再改,慢慢你的键盘就会进化出最适合你的配列。

可能会遇到的问题

可能会遇到的最大的问题就是运气问题,我的板子变砖过,连上电脑不识别过。
装驱动把其他设备驱动装坏过,编译debug一天没成果过。
不过基本都是因为小问题,运气好的话是不会遇到的。
运气不好的话,恭喜你!因为专家就是把能遇到的问题都遇到了一遍的人。