varl/qmk_firmware
1
0
Fork 0
forked from forks/qmk_firmware
Code Pull requests Activity
qmk_firmware/docs/zh-cn/faq_debug.md
ymzcdg 894010786c translate docs into Mandarin Chinese (#5890) 
* translate docs into Mandarin Chinese

translate
faq_debug.md
into Chinese

* translate faq_build.md into Chinese

translate faq_build.md into Chinese

* faq_keymap.md to zh-cn

faq_keymap.md to zh-cn
2019-05-22 14:33:10 -07:00

9.9 KiB
Raw Blame History

调试的常见问题

本篇详细介绍了人们在键盘故障排除时的各种常见问题。

调试控制台

hid_listen 无法识别设备

当设备的调试控制台未就绪时，您将看到如下内容：

Waiting for device:.........

插入设备后，hid_listen找到该设备，您将收到以下消息：

Waiting for new device:.........................
Listening:

如果您无法获得这条“Listening:”消息，请尝试在[Makefile]中使用 CONSOLE_ENABLE=yes

在Linux这样的操作系统上，你可能需要一些权限。

  • 使用sudo hid_listen

控制台没有返回消息

检查:

  • hid_listen 找到了你的设备。看前面。
  • 输入Magic+d打开调试。详见Magic Commands。
  • 设置debug_enable=true ，一般存在于matrix.c的matrix_init()中。
  • 尝试使用'print'函数而不要用调试输出。详见common/print.h。
  • 断开其他有控制台功能的设备。 详见Issue #97。

Linux或UNIX这样的系统如何请求超级用户权限

用'sudo'来执行hid_listen就有权限了。

$ sudo hid_listen

或者把一个文件放到规则文件夹来为TMK设备添加udev规则，不同系统的目录可能有所不同。

文件: /etc/udev/rules.d/52-tmk-keyboard.rules(在Ubuntu系统的情况下)

# tmk keyboard products     https://github.com/tmk/tmk_keyboard
SUBSYSTEMS=="usb", ATTRS{idVendor}=="feed", MODE:="0666"

其他

安全注意事项

你应该不想要把你的键盘变成"砖头"吧，就是变成没法重写固件的那种。 下面讲解一些参数来告诉你什么风险很大（其实也不是很大）。

  • 假如你键盘表面没有设计重置键"RESET", 那你要进入bootloader的话就要按PCB上的RESET了。 按PCB上的RESET要拧开键盘底部。
  • 如果 tmk_core / common 里面的文件丢失键盘可能失灵。
  • .hex太大可能不太好; make dfu 会删除块，检验大小（咦?好像反了...）。 一但出错，刷新键盘失败的话就困在DFU出不去了。
    • 所以, 要知道大小限制。 Planck键盘上.hex文件最大大小是 is 7000h (十进制是28672)
Linking: .build/planck_rev4_cbbrowne.elf                                                            [OK]
Creating load file for Flash: .build/planck_rev4_cbbrowne.hex                                       [OK]

Size after:
   text    data     bss     dec     hex filename
      0   22396       0   22396    577c planck_rev4_cbbrowne.hex
  • 上面那个文件大小是 22396/577ch，比28672/7000h小
  • 当你有一个合适的.hex文件时，你就要重试加载那个了
  • 您在键盘Makefile中的某些选项可能消耗额外内存；注意以下这几个 BOOTMAGIC_ENABLE, MOUSEKEY_ENABLE, EXTRAKEY_ENABLE, CONSOLE_ENABLE, API_SYSEX_ENABLE
  • DFU 工具/不/可以写入bootloader (unless you throw in extra fruit salad of options), 所以还是有点危险的
  • EEPROM大概有100000次循环寿命。不要总是频繁重写固件；EEPROM会玩坏的。

全键无冲不好用

首先你要在Makefile用如下命令编译固件NKRO_ENABLE。

全键无冲还不好用的话试着用Magic N 命令(默认是LShift+RShift+N)。这个命令会在全键无冲和六键无冲之间临时切换。有些情况全键无冲不好用你就需要使用六键无冲模式，尤其是在BIOS中。

如果你的固件使用BOOTMAGIC_ENABLE编译的你要用BootMagic N 命令(默认Space+N)打开开关。这个设置保存在EEPROM中并保存在电源循环中。

https://github.com/tmk/tmk_keyboard#boot-magic-configuration---virtual-dip-switch

指点杆需要复位电路(PS/2 鼠标支持)

如果没有复位电路，由于硬件初始化不正确，您将得到不一致的结果。查看TPM754复位电路。

矩阵不可读16以上的列

当列超过16时[matrix.h]的read_cols()中，用1UL<<16而不要用1<<16。

在C语言中1 是一个[int] 类型的[16 bit]值，在AVR中你不能左移大于15次。如果你使用1<<16的话会得到意外的零。你要用 [unsigned long]类型，比如1UL。

http://deskthority.net/workshop-f7/rebuilding-and-redesigning-a-classic-thinkpad-keyboard-t6181-60.html#p146279

Bootloader跳转不好用

在Makefile中正确配置Makefile大小。如果分区大小不正确，引导加载程序可能无法从Magic command和Boot Magic加载。

#   bootloader字节数：
#   Atmel DFU loader(ATmega32U4)   4096
#   Atmel DFU loader(AT90USB128)   8192
#   LUFA bootloader(ATmega32U4)    4096
#   Arduino Caterina(ATmega32U4)   4096
#   USBaspLoader(ATmega***)        2048
#   Teensy   halfKay(ATmega32U4)   512
#   Teensy++ halfKay(AT90USB128)   2048
OPT_DEFS += -DBOOTLOADER_SIZE=4096

AVR引导大小是通过BOOTSZ熔丝位来设置的。查阅你单片机的datasheet。 记住，datasheet用的是Word(2字节)表示大小和地址，TMK用的是Byte。

AVR引导部分位于闪存的末尾，如下所示（Application是应用区，Bootloader是引导区）。

byte     Atmel/LUFA(ATMega32u4)          byte     Atmel(AT90SUB1286)
0x0000   +---------------+               0x00000  +---------------+
         |               |                        |               |
         |               |                        |               |
         |  Application  |                        |  Application  |
         |               |                        |               |
         =               =                        =               =
         |               | 32KB-4KB               |               | 128KB-8KB
0x6000   +---------------+               0x1E000  +---------------+
         |  Bootloader   | 4KB                    |  Bootloader   | 8KB
0x7FFF   +---------------+               0x1FFFF  +---------------+


byte     Teensy(ATMega32u4)              byte     Teensy++(AT90SUB1286)
0x0000   +---------------+               0x00000  +---------------+
         |               |                        |               |
         |               |                        |               |
         |  Application  |                        |  Application  |
         |               |                        |               |
         =               =                        =               =
         |               | 32KB-512B              |               | 128KB-2KB
0x7E00   +---------------+               0x1FC00  +---------------+
         |  Bootloader   | 512B                   |  Bootloader   | 2KB
0x7FFF   +---------------+               0x1FFFF  +---------------+

详情请见下方issue。 https://github.com/tmk/tmk_keyboard/issues/179

如果你使用TeensyUSB, 有一个已知bug硬件重置按钮阻止软件定义重置键工作。重新插拔键盘就好了。

特殊额外键不起作用(系统，音频控制键)

你要在rules.mk定义EXTRAKEY_ENABLE在QMK中使用它们。

EXTRAKEY_ENABLE = yes          # 音频控制和系统控制

睡眠唤醒不好用

在Windows查看设备管理器中该键盘设备属性中电源管理选项卡中的允许此设备唤醒计算机(O)是否勾选。同时看一眼BIOS设置。

在主机睡眠时按下任何键都可以唤醒了。

使用Arduino?

注意Arduino的针脚名字和主控芯片的不一样。 比如, Arduino的D0并不是PD0。自己用原理图捋一下电路。

Arduino Leonardo和micro使用ATMega32U4，该芯片TMK可用，但Arduino的bootloader会导致问题。

在USB AVR使用PF4-7针脚?

你要置位MCUCR寄存器JTD位来将PF4-7设置为GPIO。这些针脚默认是JTAG功能。 像ATMegaU or AT90USB*这样的MCU会受影响。

如果是用Teensy的话就不需要了。Tennsy自带JTAGEN位未编程来失能该功能。

代码如下。

    // F接口JTAG失能。在四个周期内写入两次JTD位。
    MCUCR |= (1<<JTD);
    MCUCR |= (1<<JTD);

https://github.com/tmk/tmk_keyboard/blob/master/keyboard/hbkb/matrix.c#L67

阅读ATMega32U4的datasheet中的26.5.1 MCU Control Register – MCUCR。

为锁定键添加指示灯

你要自制CapsLock, ScrollLock 和 NumLock指示灯？见下文。

http://deskthority.net/workshop-f7/tmk-keyboard-firmware-collection-t4478-120.html#p191560

为Arduino Micro/Leonardo编程

按下重置键然后在8秒内运行下方这样的命令。

avrdude -patmega32u4 -cavr109 -b57600 -Uflash:w:adb_usb.hex -P/dev/ttyACM0

设备名称因系统而异。

http://arduino.cc/en/Main/ArduinoBoardMicro https://geekhack.org/index.php?topic=14290.msg1563867#msg1563867

USB 3 兼容性

据传说有些人用USB3接口会有问题，用USB2的试试。

Mac 兼容性

OS X 10.11 和集线器

https://geekhack.org/index.php?topic=14290.msg1884034#msg1884034

对于BIOS (UEFI)/恢复(睡眠和唤醒)/重新启动 有问题

有人说他们的键盘在BIOS中，或许是恢复(睡眠和唤醒)后不工作.

截止至目前，其根本原因未知，不排除与某些构建选项有关。试着在Makefile中失能CONSOLE_ENABLE, NKRO_ENABLE, SLEEP_LED_ENABLE这样的选项，也试试其他的。

https://github.com/tmk/tmk_keyboard/issues/266 https://geekhack.org/index.php?topic=41989.msg1967778#msg1967778

FLIP 不工作

AtLibUsbDfu.dll 未找到

从设备管理器中删除当前驱动程序并在设备管理器重新安装一个FLIP提供的程序。 http://imgur.com/a/bnwzy