这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
kb-mods:hhkb-ble [2020/07/13 09:15] yangdigi |
kb-mods:hhkb-ble [2020/12/21 07:20] (当前版本) yangdigi |
||
---|---|---|---|
行 1: | 行 1: | ||
## HHKB BLE Mod | ## HHKB BLE Mod | ||
+ | <table_w30x70> | ||
^PCB | YANG | | ^PCB | YANG | | ||
^Firmware | YANG | | ^Firmware | YANG | | ||
行 6: | 行 7: | ||
^Test | YANG / 兰某人 | | ^Test | YANG / 兰某人 | | ||
^Seller | YANG / KBDFans | | ^Seller | YANG / KBDFans | | ||
+ | </table_w30x70> | ||
在售:https://item.taobao.com/item.htm?id=590221409485 | 在售:https://item.taobao.com/item.htm?id=590221409485 | ||
行 18: | 行 19: | ||
固件的更新记录可见:[[changelog:hhkb_ble|HHKB BLE固件更新记录]] | 固件的更新记录可见:[[changelog:hhkb_ble|HHKB BLE固件更新记录]] | ||
- | |||
- | --- | ||
### 蓝牙配对 | ### 蓝牙配对 | ||
行 26: | 行 25: | ||
简单说不需要单独启用配对模式,只要蓝牙处于未连接并且可发现状态,就可以配对。mac和ios的搜不到在上面文档里也有写处理方法,另外出现连接异常时,也有处理方法。 | 简单说不需要单独启用配对模式,只要蓝牙处于未连接并且可发现状态,就可以配对。mac和ios的搜不到在上面文档里也有写处理方法,另外出现连接异常时,也有处理方法。 | ||
- | --- | + | ### 开关说明 |
- | ### 开关说明 | + | 在原来的dip开关位置,有一个拨动开关。这也是HHKB BLE主控的惟一一个开关。 |
+ | <html><div class="attention"> | ||
+ | <subtitle>注意:</subtitle> | ||
+ | <ul><li>此开关的作用是关闭电池的对外供电,并不是关闭蓝牙。</li> | ||
+ | <li>因此,关闭时,如果插上USB线,因为还有USB供电,所以蓝牙依然可以工作。</li></ul> | ||
+ | </div></html> | ||
- | 在原来的dip开关位置,有一个拨动开关。这也是HHKB BLE主控的惟一一个开关。其作用是关闭电池的对外供电,并不是关闭蓝牙。直接用盖子可以很方便的拨到开关,靠近USB接口(下图向左)是开,远离USB接口(下图向右)是关。在键盘出现工作异常时,也需要将开关先关闭再打开,让键盘重新上电启动。 | + | 直接用盖子可以很方便的拨到开关,靠近USB接口(下图向左)是开,远离USB接口(下图向右)是关。在键盘出现工作异常时,也需要将开关先关闭再打开,让键盘重新上电启动。 |
{{:kb-mods:hhkb_ble_sw.jpg?600|}} | {{:kb-mods:hhkb_ble_sw.jpg?600|}} | ||
- | 这个开关处于关闭时,如果插上USB线,因为还有USB供电,所以蓝牙依然还是可以工作的。 | + | 如果想要关闭蓝牙功能,请参看[[ble-series:connection-status|蓝牙开关和连接状态]]。 |
- | 如果想要关闭蓝牙,请参看[[ble-series:connection-status|蓝牙开关和连接状态]]。\\ | + | <html><div class="hint"> |
- | 额外的提醒,此软件开关是给想要完全关闭蓝牙,而仅使用或仅暂时使用USB的设计的,并且建议要使用此功能的同时把主控上的拨动开关也关掉。它不是用来日常关闭蓝牙从而节能的,在HHKB上,使用这个功能关闭蓝牙,待机时比使用Lock Mode要耗电很多。 | + | <subtitle>提醒</subtitle> |
+ | <ul><li>此软件开关是给想要完全关闭蓝牙,仅使用或仅暂时使用有线模式而设计。建议同时把主控上的硬件电池开关也关掉。</li> | ||
+ | <li>它不是用来日常关闭蓝牙从而节能的,在HHKB上,使用这个功能关闭蓝牙,待机时比正常的二级节能时耗电很多。</li></ul> | ||
+ | </div></html> | ||
- | --- | ||
- | |||
- | ### Mac下开机进特殊模式 | ||
- | |||
- | 少部分人会遇到有需要使用这个场景,所以这里补充说明一下。 | ||
- | |||
- | Mac在某次更新后,启动时识别USB键盘需要更长的时间,而HHKB BLE又不想让这个时间拖累蓝牙模式下的启动。暂时采用以下方法,有更好的办法再改进,目前请严格按照以下步骤来。 | ||
- | - 首先需要固件是2020-03-16(DK3G)或之后的固件。 | ||
- | - 先使用 **LShift+RShift+W** 关闭蓝牙功能,务必确定蓝牙功能是关闭的。同时,之后要再使用蓝牙模式请记得再打开。 | ||
- | - Mac关机,键盘插上USB线。以进入恢复模式为例,先按Mac的电源开关。这时稍等一下,再按住键盘的 **Command+R**,不要提前按。 | ||
- | |||
- | 补充说明:在第3步,如果掌握不好时机,可以在LEDMAP里将LED3的指示灯设置为 **工作模式**,按下 **Command+R** 的时机就是按Mac电源开关后,键盘LED3亮起时,亮起说明键盘已经以USB模式启动并可以工作了,在这之前提前按住按键是无效的。 | ||
- | |||
- | 当然,大部分人也不止一个键盘。所以更简单的方法是有这个需求时,拿另外的USB键盘操作。 | ||
- | |||
- | --- | ||
### 充电注意 | ### 充电注意 | ||
行 60: | 行 51: | ||
充电接口和数据接口,都是HHKB上的小的那个USB接口,不是两个大的USB母口。 | 充电接口和数据接口,都是HHKB上的小的那个USB接口,不是两个大的USB母口。 | ||
- | 建议使用电脑的usb口或者正规的5v充电器来充电,如果出现充电不当导致蓝牙失效的情况,后果自付。且使用大功率充电器并不会提高充电速度的,默认充电电流约450mA。即,在USB供电充足的情况下,2500mAh电池充满电需要6小时左右。 | + | <html><div class="attention"> |
+ | <subtitle>注意:建议使用电脑USB口或者正规的5v充电器来充电</subtitle> | ||
+ | <br>使用大功率充电器并不会提高充电速度的,默认充电电流大部分为400多ma。即,在USB供电充足的情况下,2500mAh电池充满电需要6小时左右。。如果使用支持快充或非合适充电器,充电电压过高或瞬时过高,可能损坏充电IC等。 | ||
+ | </div></html> | ||
- | 充电指示灯在左边那个USB HUB口下方,从后面可以看到,充电指示灯三种状态。 | + | 充电指示灯在左边那个USB HUB口下方的红灯(非正面的红灯),从后面可以看到。 |
- | - 低亮度或闪烁,表示电池异常(没接电池或电池有问题) | + | <table_w30x70> |
- | - 较高亮度,表示充电中 | + | ^ 充电指示灯状态 ^ 指示说明 ^ |
- | - 熄灭或很低的一丁点亮度,表示电池充满了,充满了会自动停止充电的 | + | | 低亮度或闪烁 | 表示电池异常(没接电池或电池有问题) | |
+ | | 较高亮度 | 表示充电中 | | ||
+ | | 熄灭或极低亮度 | 表示电池充满了,充满了会自动停止充电的 | | ||
+ | </table_w30x70> | ||
一般不用刻意去注意这个指示灯,充过一次电后就能知道大概需要充多久了。 | 一般不用刻意去注意这个指示灯,充过一次电后就能知道大概需要充多久了。 | ||
- | 电量百分比显示,显示的是大概的水平,不是精确的,仅供参考(特别是充电时显示的误差会更大),每10%为一个等级,所以最高的时候显示也只有90%。另外充电的过程中,电量显示为x1%,即比非充电时多显示1%。如下图是正在充电时显示的电量。 | + | 电量百分比显示,显示的是大概的水平,不是精确的,仅供参考(特别是充电时显示的误差会更大),每10%为一个等级。另外充电的过程中,电量显示为x1%,即比非充电时多显示1%。如下图是正在充电时显示的电量。 |
{{:kb-mods:hhkb-ble-charge.png?450|}} | {{:kb-mods:hhkb-ble-charge.png?450|}} | ||
- | 当充满之后,主控上本身的充电指示灯也会熄灭或者亮度降到极低。 | + | 在电量达到90%以后,会进入涓流充电。充满之后,主控上本身的充电指示灯也会熄灭或者亮度降到极低,并且不再对电池进行充电。长期插着线使用是没有问题的。 |
Mac屏蔽了第三方蓝牙设备的电量显示,可以使用文字输出电量的功能,具体见:[[ble-series:blebattery|充电与电量显示]]。 | Mac屏蔽了第三方蓝牙设备的电量显示,可以使用文字输出电量的功能,具体见:[[ble-series:blebattery|充电与电量显示]]。 | ||
- | --- | + | ### 固件设置和更新 |
- | ### 固件设置 | + | 打开网址https://ydkb.io,选择好键盘**HHKB BLE**,然后页面上就有刷的方式[[bootloader:msd-bootloader|Mass Storage Device Bootloader(U盘模式)]]。按键编辑器的说明参看本文档的其他部分。 |
- | 固件基于tmk,在https://ydkb.io上进行设置,常见的功能均可通过网页进行设置。 | + | 除了按住左上角键(一般是ESC)插线可以进入刷机模式,还可以使用**灯光和增强功能**里的<kbd>Reset</kbd>,为了防止误按,需要先按住<kbd>LCtrl</kbd>, 再按这个<kbd>Reset</kbd>,可以直接跳到刷机模式,不用拔线再重插。 |
- | --- | + | <html><div class="attention"> |
+ | <subtitle>注意</subtitle> | ||
+ | <ul><li>键盘除了 <b>HHKB BLE</b> 可以选择外,也可以使用 <b>HHKB BLE S</b>。</li> | ||
+ | <li>带S的这个固件响应速度更快,暂时无法保证兼容所有HHKB,大部分应该是没问题。</li> | ||
+ | <li>如果你的键盘无兼容问题,强烈推荐选择 <b>HHKB BLE S</b> 的固件。</li><ul> | ||
+ | </div></html> | ||
- | ### 固件更新 | + | ### 指示灯说明以及节能 |
+ | 除了上面说的BL模式下指示灯作用外。普通的功能可以通过LEDMAP([[features:ledmap|LEDMAP]])定义三个指示灯的功能。指示灯仅在键盘未节能时亮起,建议不要设置需要经常常亮的指示,每颗指示灯一直亮起增加的耗电,会减少键盘的续航。 | ||
- | 可以直接看这部分。[[bootloader:msd-bootloader|Mass Storage Device Bootloader(U盘模式)]] | + | <html><div class="hint"> |
+ | <subtitle>提醒</subtitle> | ||
+ | <br>上文提过左边USB口下的红灯是充电指示灯。另外,右边USB下方的那个绿灯和LED3相同功能。 | ||
+ | </div></html> | ||
- | 在进入Bootloader后,HHKB_BLE双模主控右上角的指示灯三个会闪,在刷入文件时第三个指示灯会快速闪烁。(如果这三个灯没焊接的,比如黑色外壳自己没额外解决的,也可以看右边USB接口下方的指示灯状态) | + | 正面LEDMAP的默认定义,如果要自己修改,请看[[features:ledmap|LEDMAP]]。 |
+ | <table_w30x70> | ||
+ | ^ 指示灯 ^ 默认配置 ^ | ||
+ | | LED1(默认红灯) | CapsLock指示 | | ||
+ | | LED2(默认黄或白灯) | 层1指示(按Fn时会亮) | | ||
+ | | LED3(默认绿灯) | 层2指示 | | ||
+ | </table_w30x70> | ||
- | 补充说明是除了左上角键(一般是ESC)插线可以进入刷机模式外,还可以使用**灯光和增强功能**里的<html><button style=" text-align: center; line-height: 19px; width: 46px; height: 42px; font-size:12px">Reset</button></html>,为了防止误按,当与左Ctrl一起按的时候,也就是左Ctrl+Reset,可以直接跳到刷机模式,不用拔线再重插。 | + | <html><div class="attention"> |
+ | <subtitle>蓝牙模式下指示灯使用注意</subtitle> | ||
+ | <ul><li>在蓝牙模式下,Num Lock, Caps Lock, Scroll Lock这些指示灯,无法同步显示电脑的这三者状态。</li> | ||
+ | <li>蓝牙模式下,实际是按一下按键就切换显示一次对应指示灯。只有在USB模式下是同步显示的。</li> | ||
+ | <li>不同步时,可使用<kbd>Shift</kbd>+对应按键,如<kbd>Shift</kbd>+<kbd>Capslock</kbd>,这时CapsLock会生效但其指示灯不会变。</li> | ||
+ | <li>合理利用这一点可在蓝牙下反转指示灯使用,如让numlock灯在亮时关,灭时开,可以省电。</li><ul> | ||
+ | </div></html> | ||
- | --- | + | 除了LEDMAP定义的功能外,还有其他指示一些操作和状态。 |
+ | <table_w30x70> | ||
+ | ^ 状态或操作 ^ LED指示方式 ^ | ||
+ | | 刷机模式(空闲) | 三个指示灯一起闪或者交替闪,一直不灭 | | ||
+ | | 刷机模式(数据写入) | 在上面基础上,LED3快速闪烁 | | ||
+ | | 启动时蓝牙 未连接 状态指示 | LED3闪烁,如果一直未连接,约15秒左右会停止闪烁 | | ||
+ | | 启动时蓝牙 已连接 状态指示 | LED2和LED3同时较慢闪。每次亮的时间明显长于灭的时间。 | | ||
+ | | 按键<key>LShift+RShift+s</key> | 按上面的方式指示蓝牙连接状态 | | ||
+ | | 手动进入Lock Mode | 三个灯同时亮起,然后再按LED3 LED2 LED1的顺序依次熄灭 | | ||
+ | | 从二级节能或Lock Mode唤醒 | 三个灯同时亮起,然后开始指示蓝牙连接状态 | | ||
+ | | 低电量提示 | 用键盘时,三个灯同时闪;节能时不闪。依然还可以使用两三天。 | | ||
+ | | 极低电量提示 | 用键盘时,三个灯同时飞快闪;节能时不闪。此时建议尽快充电。 | | ||
+ | </table_w30x70> | ||
- | ### 指示灯说明以及节能 | + | <html><div class="hint"> |
- | 除了上面说的BL模式下指示灯作用外。普通的功能可以通过LEDMAP([[features:ledmap|LEDMAP]])定义三个指示灯的功能。指示灯仅在键盘未节能时亮起,建议不要设置需要经常常亮的指示,每颗指示灯一直亮起增加的耗电,会减少键盘的续航。 | + | <subtitle>提醒</subtitle> |
- | + | <ul><li>低电量提示的优先级最高,只要低电量时它会一直指示,同时覆盖其他的。</li> | |
- | LEDMAP的默认定义,正面,LED1(默认红灯)为CapsLock,LED2(默认黄或白灯)为层1指示(按Fn时会亮),LED3(默认绿灯)为层2指示。 | + | <li>只有白色外壳的HHKB可以正面透光,黑色外壳需要查看时可以看背面USB下的LED3(默认绿灯)。</li><ul> |
+ | </div></html> | ||
- | 除了定义的功能外,还有特殊作用。 | ||
- | - 当进入Lock Mode时,三个灯先是同时亮时,然后从右往左依次熄灭。 | ||
- | - 当从二级节能唤醒时,三个指示灯会同时亮一下,然后再灭。 | ||
- | - 电池电量低时,在使用键盘时三个指示灯会同时闪。报电量不足后依然还可以使用两三天。 | ||
- | - 电池电量极低时,在使用键盘时三个指示灯会同时快闪,每秒闪3下左右。此时建议尽快充电。 | ||
然后关于节能模式的说明: | 然后关于节能模式的说明: | ||
行 110: | 行 136: | ||
- 使用Lock Mode,会直接进入二级节能,与2的区别是,这个模式下,只能同时长按F和J唤醒,不能长按任意键唤醒。 | - 使用Lock Mode,会直接进入二级节能,与2的区别是,这个模式下,只能同时长按F和J唤醒,不能长按任意键唤醒。 | ||
- | 蓝牙连接状态,同时按下 **左Shift+右Shift+S** 切换蓝牙连接状态指示开关: | + | 二级节能的功耗是很低的,如果不是特别长期的不用,比如只是第二天不用,可以直接让键盘自己进入二级节能或者直接手动进入Lock Mode(后者更适合放包里,防止意外唤醒)。 |
- | - 最右边的LED3快递闪烁,闪的过程中,亮和灭时间相当,此时蓝牙未连接 | + | |
- | - 中间的LED2和最右边的LED3稍慢闪烁,闪的过程中,亮的时间比灭的时间明显的更长,此时蓝牙已连接 | + | |
- | 黑色的外壳指示灯是不透光的,所以,要么自己DIY一个led,或者就按操作习惯吧。 | + | ### USB HUB |
+ | 本身自带的接口是miniUSB接口,所以hub这里采用的最高也只支持usb 2.0高速。这些接口禁止接大电流设备,最多接个U盘。不要拿来接其他灯特别多的键盘之类的设备。 | ||
- | 二级节能的功耗是很低的,如果不是特别长期的不用,比如只是第二天不用,可以直接让键盘自己进入二级节能或者直接手动进入Lock Mode(后者更适合放包里,防止意外唤醒)。 | + | <html><div class="attention"> |
+ | <subtitle>注意</subtitle> | ||
+ | <ul><li>USB HUB接口仅在有线模式下可用。所以,其实美观大于实用。</li> | ||
+ | <li>内部那个USB的电源是默认是关闭的,可以用<kbd>Inner USB</kbd>(默认是<kbd>Fn</kbd>+<kbd>U</kbd>)控制开关。如果要使用,建议内部这个装一个隐藏式迷你U盘。</li></ul> | ||
+ | </div></html> | ||
- | 补充说明:另外两个USB母口下方还各有一个led灯,左边那个是充电指示灯,红灯。右边那个和led3是同样功能的,默认用的绿灯。 | ||
- | --- | + | ### Mac下开机进特殊模式 |
- | ### USB HUB | + | 少部分人会遇到有需要使用这个场景,所以这里补充说明一下。 |
- | 本身自带的接口是miniUSB接口,所以hub这里采用的最高也只支持usb 2.0高速。 | + | |
- | 除了本身HHKB外面留了两个接口外,在键盘内部还留了一个USB接口。这些接口禁止接大电流设备,最多接个U盘。不要拿来接其他灯特别多的键盘之类的设备。内部那个USB的电源是可控的,控制的按键可以在**灯光和增强功能**内选择<html><button style=" text-align: center; line-height: 19px; width: 46px; height: 42px; font-size:12px">Inner<br>USB</button></html>,建议内部这个用来放个U盘。 | + | Mac在某次更新后,启动时识别USB键盘需要更长的时间,而HHKB BLE又不想让这个时间拖累蓝牙模式下的启动。暂时采用以下方法,有更好的办法再改进,目前请严格按照以下步骤来。 |
+ | - 首先需要固件是2020-03-16(DK3G)或之后的固件。 | ||
+ | - 先使用 <kbd>LShift+RShift+LCtrl+w</kbd> 关闭蓝牙功能,务必确定蓝牙功能是关闭的。同时,之后要再使用蓝牙模式请记得再打开。 | ||
+ | - Mac关机,键盘插上USB线。以进入恢复模式为例,先按Mac的电源开关。这时稍等一下,再按住键盘的 <kbd>Command+R</kbd>,不要提前按。 | ||
+ | |||
+ | 补充说明:在第3步,如果掌握不好时机,可以在LEDMAP里将LED3的指示灯设置为 **工作模式**,按下 <kbd>Command+r</kbd> 的时机就是按Mac电源开关后,键盘LED3亮起时,亮起说明键盘已经以USB模式启动并可以工作了,在这之前提前按住按键是无效的。 | ||
+ | |||
+ | 当然,大部分人也不止一个键盘。所以更简单的方法是有这个需求时,拿另外的USB键盘操作。 | ||
+ | |||
+ | |||
+ | ### Mac下使用Karabiner-Elements | ||
+ | |||
+ | Karabiner-Elements把同一个键盘蓝牙模式和有线模式,是当成不同键盘的。 | ||
+ | |||
+ | 参考用户提供的说明,要在蓝牙模式下使用Karabiner-Elements,请使用最新版的软件,如下图,勾选上 **[ HHKB BLE(Adafruit Industries) ]** 这一项。 | ||
- | HHKB JP外壳没有留孔,默认就不会焊接上这两个USB母口,内部的那个USB接口还是可以用。 | + | {{:kb-mods:hhkb_karabiner-elements.jpg?|}} |
- | --- | ||
### 异常处理 | ### 异常处理 | ||
行 136: | 行 176: | ||
工作时如果出现什么异常,最快速的方法是重新插一下usb线或是重新开关一下键盘电源开关。 | 工作时如果出现什么异常,最快速的方法是重新插一下usb线或是重新开关一下键盘电源开关。 | ||
- | 如果有配对后使用的问题,只要有线还能使用,那么,首先用文字输出电量功能,看一下输出的数字是多少。如果是44或45,可能需要[[ble-series:reset-ble|重置蓝牙]]。如果是12,那么是因为蓝牙功能关闭了,重新打开,见[[ble-series:connection-status|蓝牙开关和连接状态]]。 | + | 以及请先参看[[ble-series:troubleshooting|BLE系列排错指南]]。 |
- | + | ||
- | 大部分使用的问题参看BLE Series的部分。 | + | |
遇到bug可以通过群里联系等方式报给我。 | 遇到bug可以通过群里联系等方式报给我。 | ||
- | |||
- | --- | ||
### 硬件版本区别 | ### 硬件版本区别 | ||
记录一下售出过的硬件版本的区别,方便以后其他人查看 | 记录一下售出过的硬件版本的区别,方便以后其他人查看 | ||
+ | |||
+ | **v2.4B:** | ||
+ | > 与v2.4的区别是,电路上仅支持HHKB JP(包含Type-S)和Pro 1代。无HUB芯片,用户到手的只是支持Pro1或者JP。 | ||
**v2.4:** | **v2.4:** | ||
> 与v2.3的区别是,不再支持5V,仅支持3.3V。这一版仅支持HHKB Pro2(包含Type-S,US布局的)。内部USB母座改到主控PCB上了。 | > 与v2.3的区别是,不再支持5V,仅支持3.3V。这一版仅支持HHKB Pro2(包含Type-S,US布局的)。内部USB母座改到主控PCB上了。 | ||
- | \\ | ||
**v2.3:** | **v2.3:** | ||
- | > 第一个正式版本。支持5v和3.3v,但是5v电路是未焊接的。此版本PCB在未焊接的时候是同时支持HHKB Pro2(包含Type-S,US布局的)和HHKB JP。用户到手的只是支持Pro2或者JP。 | + | > 第一个正式版本。支持5v和3.3v,但是5v电路是未焊接的。电路同时支持HHKB Pro2(包含Type-S,US布局的)和HHKB JP,用户到手的只是支持Pro2或者JP。 |