qmk_firmware/FAQ.md

Build

'make clean' needs after changing config.h

To build with new config.h you need

$ make clean

WINAVR is obsolete

It is no longer recommended and may cause some problem. See Issue #99.

Degug Console

hid_listen can't find device

When debug console of your device is not ready you will see like this:

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

once the device is pluged in then hid_listen finds it you will get this message:

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

Check if you can't get this 'Listening:' message:

• build with CONSOLE_ENABLE=yes in Makefile.

Can't get message from console

Check:

• connect the device to hid_listen. See above.
• push LShift+RShift+d to enable debug. See Magic Commands.
• set debug_enable=yes usually in matrix_init() in matrix.c.
• try using 'print' function instead of debug print. See common/print.h.
• disconnect other devices with console function. See Issue #97.

---

Miscellaneous

NKRO Doesn't work

Build with this option of Makefile

NKRO_ENABLE = yes

And use Magic command N to toggle NKRO feature. At this time NKRO is not used by default even if it is build with NKRO_ENABLE, you still need the Magic.

TrackPoint needs reset circuit(PS/2 mouse support)

Without reset circuit you will have inconsistent reuslt due to improper initialize of the hardware. See circuit schematic of TPM754.

http://geekhack.org/index.php?topic=50176.msg1127447#msg1127447 http://www.mikrocontroller.net/attachment/52583/tpm754.pdf