diff options
Diffstat (limited to 'docs/faq_debug.md')
| -rw-r--r-- | docs/faq_debug.md | 70 |
1 files changed, 1 insertions, 69 deletions
diff --git a/docs/faq_debug.md b/docs/faq_debug.md index 5cc20251d..6c66defbd 100644 --- a/docs/faq_debug.md +++ b/docs/faq_debug.md | |||
| @@ -27,7 +27,7 @@ You may need privilege to access the device on OS like Linux. | |||
| 27 | Check: | 27 | Check: |
| 28 | - *hid_listen* finds your device. See above. | 28 | - *hid_listen* finds your device. See above. |
| 29 | - Enable debug with pressing **Magic**+d. See [Magic Commands](https://github.com/tmk/tmk_keyboard#magic-commands). | 29 | - Enable debug with pressing **Magic**+d. See [Magic Commands](https://github.com/tmk/tmk_keyboard#magic-commands). |
| 30 | - set `debug_enable=true` usually in `matrix_init()` in **matrix.c**. | 30 | - set `debug_enable=true`. See [Testing and Debugging](newbs_testing_debugging.md#debugging) |
| 31 | - try using 'print' function instead of debug print. See **common/print.h**. | 31 | - try using 'print' function instead of debug print. See **common/print.h**. |
| 32 | - disconnect other devices with console function. See [Issue #97](https://github.com/tmk/tmk_keyboard/issues/97). | 32 | - disconnect other devices with console function. See [Issue #97](https://github.com/tmk/tmk_keyboard/issues/97). |
| 33 | 33 | ||
| @@ -112,56 +112,6 @@ In C `1` means one of [int] type which is [16 bit] in case of AVR so you can't s | |||
| 112 | 112 | ||
| 113 | http://deskthority.net/workshop-f7/rebuilding-and-redesigning-a-classic-thinkpad-keyboard-t6181-60.html#p146279 | 113 | http://deskthority.net/workshop-f7/rebuilding-and-redesigning-a-classic-thinkpad-keyboard-t6181-60.html#p146279 |
| 114 | 114 | ||
| 115 | |||
| 116 | ## Bootloader Jump Doesn't Work | ||
| 117 | Properly configure bootloader size in **Makefile**. With wrong section size bootloader won't probably start with **Magic command** and **Boot Magic**. | ||
| 118 | ``` | ||
| 119 | # Size of Bootloaders in bytes: | ||
| 120 | # Atmel DFU loader(ATmega32U4) 4096 | ||
| 121 | # Atmel DFU loader(AT90USB128) 8192 | ||
| 122 | # LUFA bootloader(ATmega32U4) 4096 | ||
| 123 | # Arduino Caterina(ATmega32U4) 4096 | ||
| 124 | # USBaspLoader(ATmega***) 2048 | ||
| 125 | # Teensy halfKay(ATmega32U4) 512 | ||
| 126 | # Teensy++ halfKay(AT90USB128) 2048 | ||
| 127 | OPT_DEFS += -DBOOTLOADER_SIZE=4096 | ||
| 128 | ``` | ||
| 129 | AVR Boot section size are defined by setting **BOOTSZ** fuse in fact. Consult with your MCU datasheet. | ||
| 130 | Note that **Word**(2 bytes) size and address are used in datasheet while TMK uses **Byte**. | ||
| 131 | |||
| 132 | AVR Boot section is located at end of Flash memory like the followings. | ||
| 133 | ``` | ||
| 134 | byte Atmel/LUFA(ATMega32u4) byte Atmel(AT90SUB1286) | ||
| 135 | 0x0000 +---------------+ 0x00000 +---------------+ | ||
| 136 | | | | | | ||
| 137 | | | | | | ||
| 138 | | Application | | Application | | ||
| 139 | | | | | | ||
| 140 | = = = = | ||
| 141 | | | 32KB-4KB | | 128KB-8KB | ||
| 142 | 0x6000 +---------------+ 0x1E000 +---------------+ | ||
| 143 | | Bootloader | 4KB | Bootloader | 8KB | ||
| 144 | 0x7FFF +---------------+ 0x1FFFF +---------------+ | ||
| 145 | |||
| 146 | |||
| 147 | byte Teensy(ATMega32u4) byte Teensy++(AT90SUB1286) | ||
| 148 | 0x0000 +---------------+ 0x00000 +---------------+ | ||
| 149 | | | | | | ||
| 150 | | | | | | ||
| 151 | | Application | | Application | | ||
| 152 | | | | | | ||
| 153 | = = = = | ||
| 154 | | | 32KB-512B | | 128KB-2KB | ||
| 155 | 0x7E00 +---------------+ 0x1FC00 +---------------+ | ||
| 156 | | Bootloader | 512B | Bootloader | 2KB | ||
| 157 | 0x7FFF +---------------+ 0x1FFFF +---------------+ | ||
| 158 | ``` | ||
| 159 | |||
| 160 | And see this discussion for further reference. | ||
| 161 | https://github.com/tmk/tmk_keyboard/issues/179 | ||
| 162 | |||
| 163 | If you are using a TeensyUSB, there is a [known bug](https://github.com/qmk/qmk_firmware/issues/164) in which the hardware reset button prevents the RESET key from working. Unplugging the keyboard and plugging it back in should resolve the problem. | ||
| 164 | |||
| 165 | ## Special Extra Key Doesn't Work (System, Audio Control Keys) | 115 | ## Special Extra Key Doesn't Work (System, Audio Control Keys) |
| 166 | You need to define `EXTRAKEY_ENABLE` in `rules.mk` to use them in QMK. | 116 | You need to define `EXTRAKEY_ENABLE` in `rules.mk` to use them in QMK. |
| 167 | 117 | ||
| @@ -194,24 +144,6 @@ If you would like to keep JTAG enabled, just add the following to your `config.h | |||
| 194 | #define NO_JTAG_DISABLE | 144 | #define NO_JTAG_DISABLE |
| 195 | ``` | 145 | ``` |
| 196 | 146 | ||
| 197 | ## Adding LED Indicators of Lock Keys | ||
| 198 | You need your own LED indicators for CapsLock, ScrollLock and NumLock? See this post. | ||
| 199 | |||
| 200 | http://deskthority.net/workshop-f7/tmk-keyboard-firmware-collection-t4478-120.html#p191560 | ||
| 201 | |||
| 202 | ## Program Arduino Micro/Leonardo | ||
| 203 | Push reset button and then run command like this within 8 seconds. | ||
| 204 | |||
| 205 | ``` | ||
| 206 | avrdude -patmega32u4 -cavr109 -b57600 -Uflash:w:adb_usb.hex -P/dev/ttyACM0 | ||
| 207 | ``` | ||
| 208 | |||
| 209 | Device name will vary depending on your system. | ||
| 210 | |||
| 211 | http://arduino.cc/en/Main/ArduinoBoardMicro | ||
| 212 | https://geekhack.org/index.php?topic=14290.msg1563867#msg1563867 | ||
| 213 | |||
| 214 | |||
| 215 | ## USB 3 Compatibility | 147 | ## USB 3 Compatibility |
| 216 | I heard some people have a problem with USB 3 port, try USB 2 port. | 148 | I heard some people have a problem with USB 3 port, try USB 2 port. |
| 217 | 149 | ||
