盒子夹在电脑和键盘之间:电脑看到的是盒子,你的按键要先经过盒子转一手才能到电脑。这一手能不能转对,取决于盒子知不知道你这把键盘的报文长什么样。
多数键盘用标准格式,盒子自带的那套就够。但另一类键盘不一样:全键无冲用位图、把修饰键和键码拆成两个 report、自己加了 report ID、或者把功能键丢在另一个用途页里。碰上这类键盘,默认格式对不上,键就转不过去。
键盘采样就是给这类键盘用的:采一次,盒子以后按你这把键盘的格式来。
能解决什么问题
出现下面这些症状,先试采样:
症状
具体表现
某些键完全不认
按了电脑没反应,别的键都正常
按住不放变成连击
按住 Shift 走出来一串 Shift,按住方向键光标乱跳
组合键只过去一半
Ctrl+C 到电脑只剩 C,Ctrl+Shift+Esc 只出一个键
功能键、多媒体键失效
主键区正常,上面一排或者侧键不通
换了键盘就出问题
上一把键盘好好的,换这一把就不对
如果整把键盘都不工作、设备根本识别不到,那不是采样的范围,见《设备识别、固件更新与恢复》。
做完之后是什么效果
盒子换成你这把键盘的身份:VID/PID、报文格式都跟着它走,电脑那边认到的就是这把键盘。
状态行显示 Mode: 透传 表示生效了。显示「固定」说明连的还是盒子自己的身份,采样没起作用。
宏不用改。 脚本里的 KeyTap("a") 还是 KeyTap("a"),变的是这一下按键最终以什么格式发出去,采完不用回去改脚本。
可以存下来复用。 采样结果能导出成 .kmps,换机器、恢复出厂之后导回去,不用重采。
采样只读键盘自报的身份信息,不记录你按过的任何键。
操作前先确认
条件
说明
设备要支持
仅新设备具备这个能力,老设备点了不会有回应
设备已激活
未激活的设备不执行采样,直接回错误码 -8
键盘插在盒子上
采样时盒子要能枚举到它,插在电脑上采不到
用键鼠透传程序
采样按钮在键鼠透传里,不在键鼠助手主程序里;两个程序装在同一目录
之前手填过 VID/PID(见《USB 协议自定义》)的,采样之后以采样结果为准,手填的那两个值会被覆盖。
操作步骤
打开键鼠透传。 与键鼠助手同目录的另一个程序。
按压按键。保持按压状态把键鼠透传设备插入电脑。
连接设备。 第一次连不要勾「仅连接」——此时盒子还是它自己的身份,全枚举就能找到。
点底部的「KM 采样」。 按钮变成「采样已发出」,等回包。
看结果。 成功时会提示 采样设备: VID xxxx / PID xxxx,同时这对 ID 自动填进连接条的 VID/PID 框,并自动勾上「仅连接」——设备重启后已经换了身份,不点名就找不到了。(部分设备不会填入VID/PID,可以忽略这个,不影响纯硬件宏使用,只是无法通过软件API调用键鼠事件)。如果没有弹出VID/PID框,也不需要上位机调用,如果想再试连接,重复第2步。如果需要上位机调用,可以换个其它的键鼠设备尝试一下,一般支持板载宏的键鼠都支持,但是并不代表不支持板载宏的键鼠就不支持,只是概率会小很多。
手动点一次「连接」。 采样成功后设备会重启,此时链路是断的。
确认模式。 连接条状态行显示 Mode: 透传 才算成了。显示「固定」说明这次连的还是设备自己的身份。
采样命令发出去后 6 秒没有回应,程序会提示「设备没有回应采样命令」。常见原因:设备没激活、固件太旧不支持、链路已断。
备份与迁移
采样结果能取出来,也能写回去:
按钮
作用
导出
把设备里的采样镜像读出来,存成 .kmps 文件
导入
把 .kmps 写进设备,写完设备自动重启
两种用途:同一型号的键盘有好几把,采一次导出、其余几台导入;或者设备要升级固件、恢复出厂之前先把镜像存一份。
.kmps 里装的是某个键盘型号的 USB 身份。导入来源不明的文件,等于让盒子冒充你没见过的设备。要恢复就换回自己那份,别拿别人给的当通用备份。
遇到问题如何处理
采样失败,弹了错误码
提示格式是「采样失败(错误码 N):说明」:
码
含义
一般怎么处理
-1
没有找到兼容的 USB 设备
键盘没插在盒子上,或插了但不兼容
-2
读设备描述符失败
换线、换口再试
-3
读配置描述符失败
同上
-4
读 HID 报文描述符失败
复合设备容易卡在这步,换口重试
-5
采样数据写入设备失败
设备存储异常,重试;仍失败联系售后
-6
采样数据超出存储上限
描述符太大,多见于 report 很多的自定义键盘
-7
采样超时
键盘响应慢或中途掉了,重插再采
-8
设备未激活
先激活
-9
设备没有回传 VID/PID
固件过旧,见《设备识别、固件更新与恢复》
提示采样成功,但连不上设备
设备重启成新身份,而程序的自动重连还在用旧 VID/PID,必然连不上。这不是坏了,手动点一次「连接」。
采完个别键还是不对
按顺序核两件事:键盘是不是插在盒子上采的;连接后状态行是不是 Mode: 透传。两步都对仍有键不对,说明这把键盘的报文里有盒子没覆盖的字段——带上键盘型号和当时的错误码发帖,比只说「有个键按不出来」有用得多。
换了一把键盘,之前采的还能用吗
不能。采样绑的是那一把键盘,换一把报文格式不同的要重采。
什么时候该重新采样
换键盘、键盘换了 USB 口之后行为变了、或者升级固件后提醒重采——这几种情况重新采一次。日常换机器、重装程序不用重采,把 .kmps 导回去就行。
相关
盒子的身份是怎么被系统识别的:见《USB 协议自定义:VID/PID 与字符串描述符》;
版本信息、固件更新与恢复:见《设备识别、固件更新与恢复》。