qmk_firmware/docs/zh-cn/faq_build.md
IskandarMa f6a7f4d4ac
update the Chinese translation based on the latest English version (#14924)
Co-authored-by: peepeetee <43021794+peepeetee@users.noreply.github.com>
Co-authored-by: Joy Lee <chang.li@westberrytech.com>
Co-authored-by: LitoMore <LitoMore@users.noreply.github.com>
Co-authored-by: Dasky <32983009+daskygit@users.noreply.github.com>
2022-01-18 18:24:02 +00:00

4.2 KiB
Raw Permalink Blame History

常被问及的编译问题

本页涉及所有编译QMK的问题如果你还没有试过请先阅读编译环境配置Make指引

无法在Linux下编程

操作设备需要足够的权限对于Linux用户请参阅下方有关 udev 的规则说明。如果你对 udev 有困惑,可以先试试 sudo 命令,如果你对这个命令不熟悉,可以通过 man sudo这个web页面进行了解。

一个使用 sudo 的示例这里假设你的控制器是ATMega32u4:

$ sudo dfu-programmer atmega32u4 erase --force
$ sudo dfu-programmer atmega32u4 flash your.hex
$ sudo dfu-programmer atmega32u4 reset

或者只是:

$ sudo make <keyboard>:<keymap>:flash

但请留意,用 sudo 来执行 make 通常不是一个好主意,请尽量考虑使用上面的办法。

Linux udev 规则 :id=linux-udev-rules

在linux下需要足够的权限才能读写bootloader设备可以使用 sudo 来刷写固件(不推荐),也可以将这个文件 放到 /etc/udev/rules.d/ 目录下。

放好后,执行:

sudo udevadm control --reload-rules
sudo udevadm trigger

**注意:**在旧版ModeManager<1.12过滤功能仅在严格模式strict mode下可用可以调整一下配置

printf '[Service]\nExecStart=\nExecStart=/usr/sbin/ModemManager --filter-policy=default' | sudo tee /etc/systemd/system/ModemManager.service.d/policy.conf
sudo systemctl daemon-reload
sudo systemctl restart ModemManager

在Linux下无法检测到bootloader模式下的串口设备

确认一下你的内核版本是否已配置为支持该设备。如果你的设备使用USB ACM如Pro MicroAtmega32u4确认内核 配置中包含 CONFIG_USB_ACM=y,其它类型的设备可能需要 USB_SERIAL 及相关子配置的支持。

DFU Bootloader显示为未知设备

在Windows下刷写键盘固件时很常见的一个问题。主要原因是安装了错误的驱动或者压根没有装驱动。

要修复这个问题可以尝试重新执行QMK安装脚本(位于MSYS2或WSL中的 qmk_firmware 目录下的 ./util/qmk_install.sh)或重新安装QMK工具箱。此外也可以尝试下载安装QMK驱动安装包 qmk_driver_installer来修复。

如果问题依旧可能是需要下载安装Zadig具体请参考通过Zadig安装bootloader驱动

USB VID 和 PID

通过编辑 config.h 你可以自由指定ID随便选一个看起来不常用的ID一般不会有什么问题冲突的概率很低。

大部分QMK设备都选用 0xFEED 作为VID选取PID前请先看一下其它键盘的情况再决定。

同时请阅读这个issue https://github.com/tmk/tmk_keyboard/issues/150

你可以在以下地址购买唯一的VID:PID但我觉得个人使用情况下没有必要。

在我刷写完键盘后就没响应了/点了没动静了 -- 设备是arm的rev6 planck, clueboard 60, hs60v2等(2019年2月)

因为ARM平台下EEPROM特殊的工作模式已保存的配置可能会失效。主要影响的是默认层有概率在特定情况下会导致键盘不可用我们还没有搞明白原因。这个问题可以在重置EEPROM后恢复。

Planck rev6 上重置 EEPROM 可以用于强制重置EEPROM。刷入这个文件后再次刷入正常固件会将键盘恢复到_正常_工作状态。 Preonic rev3 上重置 EEPROM

也可以考虑使用bootmagic只要它可以用。参见Bootmagic文档并结合键盘情况来了解如何操作)