差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- 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
+<table_w30x70>
 ^PCB | YANG |
 ^Firmware | YANG |
@@ 行 6: / 行 7: @@
 ^Test | YANG / 兰某人 |
 ^Seller | YANG / KBDFans |
+</table_w30x70>
 在售：https://item.taobao.com/item.htm?id=590221409485
@@ 行 18: / 行 19: @@
 固件的更新记录可见：[[changelog:hhkb_ble|HHKB BLE固件更新记录]]
----
 ### 蓝牙配对
@@ 行 26: / 行 25: @@
 简单说不需要单独启用配对模式，只要蓝牙处于未连接并且可发现状态，就可以配对。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|}}
-这个开关处于关闭时，如果插上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母口。
-建议使用电脑的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|}}
-当充满之后，主控上本身的充电指示灯也会熄灭或者亮度降到极低。
+在电量达到90%以后，会进入涓流充电。充满之后，主控上本身的充电指示灯也会熄灭或者亮度降到极低，并且不再对电池进行充电。长期插着线使用是没有问题的。
 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唤醒，不能长按任意键唤醒。
-蓝牙连接状态，同时按下 **左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线或是重新开关一下键盘电源开关。
-如果有配对后使用的问题，只要有线还能使用，那么，首先用文字输出电量功能，看一下输出的数字是多少。如果是44或45，可能需要[[ble-series:reset-ble|重置蓝牙]]。如果是12，那么是因为蓝牙功能关闭了，重新打开，见[[ble-series:connection-status|蓝牙开关和连接状态]]。
+以及请先参看[[ble-series:troubleshooting|BLE系列排错指南]]。
-大部分使用的问题参看BLE Series的部分。
 遇到bug可以通过群里联系等方式报给我。
----
 ### 硬件版本区别
 记录一下售出过的硬件版本的区别，方便以后其他人查看
+**v2.4B:**
+> 与v2.4的区别是，电路上仅支持HHKB JP（包含Type-S）和Pro 1代。无HUB芯片，用户到手的只是支持Pro1或者JP。
 **v2.4:**
 > 与v2.3的区别是，不再支持5V，仅支持3.3V。这一版仅支持HHKB Pro2（包含Type-S，US布局的）。内部USB母座改到主控PCB上了。
-\\
 **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。

Documentation for YDKB

用户工具

站点工具

差别

页面工具