QMK/readme.md

53 lines
2.0 KiB
Markdown
Raw Normal View History

2022-02-06 12:00:50 -08:00
# Betalupi Ergodox
2022-04-16 13:50:52 -07:00
This is a modified version of the [ZSA ErgoDox firmware](https://git.betalupi.com/mirrors-QMK/zsa_firmware), based on the `ergodox_ex/glow` keyboard.
2022-02-06 12:00:50 -08:00
--------------------------------------------------------------------------------
# Setup
2022-06-12 21:37:31 -07:00
Clone this repo into `keyboards/betalupi_ergodox` in your qmk directory.
2022-02-06 12:00:50 -08:00
Make example for this keyboard (after setting up your build environment):
make betalupi_ergodox:default:flash
2022-06-12 21:37:31 -07:00
If you get array-bounds errors on build, you may have a bad avr-gcc version. Read [this issue](https://github.com/qmk/qmk_firmware/issues/17064), and try
AVR_CFLAGS="-Wno-array-bounds"
2022-02-06 12:00:50 -08:00
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information.
--------------------------------------------------------------------------------
# Notes from ZSA
### Indicator LEDs
You can use the `LED_LEVEL` keycode to cycle through the brightness levels for the LEDs on the top right of the keyboard. These settings are saved in eeprom (persistant memory).
Alternatively, you can set the brightness by calling the following functions:
```c
void ergodox_led_all_set(uint8_t level);
void ergodox_right_led_1_set(uint8_t level);
void ergodox_right_led_2_set(uint8_t level);
void ergodox_right_led_3_set(uint8_t level);
```
These settings are not persistent, so you'd need to reset it every time the board starts.
These are on a 0-255 scale
2022-06-16 11:19:05 -07:00
2022-02-06 12:00:50 -08:00
### RGB Matrix Features
If you're using the Smart LED (layer indication) feature from the Oryx Configurator, you want to make sure that you enable these options by adding `#define ORYX_CONFIGURATOR` to your keymap's `config.h`.
This changes the `RGB_TOG` keycode so that it will toggle the lights on and off, in a way that will allow the Smart LEDs to continue to work, even with the rest of the LEDs turned off.
2022-06-16 11:19:05 -07:00
Additionally, a new keycode has been added to toggle the Smart LEDs. Use `TOGGLE_LAYER_COLOR`, if you aren't already.