max/tmk_keyboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
tmk_keyboard/keyboard/ergodox/Ergodox-FAQ.md
roberto 0fbf77b546 Update command in ergodox FAQ. 
The instructions in the ergodox FAQ use commands that no longer work.
This updates the commands in case someone still wants tu use this
firmware.

Fix bug GH-45
2022-11-11 18:08:15 -08:00

2.6 KiB
Raw Blame History

TMK Generic

  • I'm not sure what the Magic + H does. Is this a menu that will pop up regardless of what platform and program is open?

Yes, this is sort of debugging. Use PJRC's hid_listen to see debug messages.

TMK/Ergodox specific

  • I would like to configure my leds to indicate the active layer. I read that can be done, but I haven't seen an example for this firmware. Can someone please post an example or a link?

TMK for Ergodox have support for seven (!) led's:

Any of these leds can be used as layer indicator or NumLock/CapsLock/ScrollLock led.

Here is example how you can assign some meaning to each led. In this code only left leds are used to show layers, but you can change led_set() and do anything you want with all leds.

Firmware

Where to get binaries?

https://github.com/cub-uanic/tmk_keyboard/releases

Where to get sources?

https://github.com/cub-uanic/tmk_keyboard/tree/master

How to compile?

cd tmk_keyboard/keyboard/ergodox

# just to be safe
make -f Makefile.lufa clean

# use one of these
make -f Makefile.lufa
make -f Makefile.lufa KEYMAP=dvorak
make -f Makefile.lufa KEYMAP=colemak
make -f Makefile.lufa KEYMAP=workman
make -f Makefile.lufa KEYMAP=micro
make -f Makefile.lufa KEYMAP=cub

Layouts

TODO description of layouts in base firmware binaries

Things TO-DO

  • Flash NumLock led only when "numpad" layer is active
  • Command (in terms of IS_COMMAND) to switch to no-leds mode
  • Increase count of ACTION keys
  • Fix command_state() onboard led: it should flash only when kbd in some specific mode (CONSOLE || MOUSE)
  • ergodox_blink_all_leds() should save current state of leds, and restore after blink. initial state of all leds == off
  • add support for pseudo-backlight (reversed LEDs) + docs/photo
  • command to debug all LEDs (on/off/blink)
  • proper (in-core) implementation of DEBUG_MATRIX_SCAN_RATE (non-Ergodox specific)
  • proper (in-core) support for per-layer fn_actions[]
  • create one-handed layouts, see http://half-qwerty.com/ https://geekhack.org/index.php?topic=60165.0 https://www.massdrop.com/ext/ergodox/?hash=e097c3b9932179055023d47e48b25f1d