diff options
| author | Erovia <Erovia@users.noreply.github.com> | 2019-02-15 15:52:04 +0100 |
|---|---|---|
| committer | MechMerlin <30334081+mechmerlin@users.noreply.github.com> | 2019-02-15 06:52:04 -0800 |
| commit | 642f6cf14f2bcc91af61b0d64b4ad0632622dc7a (patch) | |
| tree | 61722ebd3669dd26b8e87d72be7cc33b348e41ea /docs | |
| parent | f3bdd436a3e8e37e274fcd1147eb13e05b24fe98 (diff) | |
| download | qmk_firmware-642f6cf14f2bcc91af61b0d64b4ad0632622dc7a.tar.gz qmk_firmware-642f6cf14f2bcc91af61b0d64b4ad0632622dc7a.zip | |
Add support for using ranges for RGB (#4981)
* Add support for using ranges for RGB
This patch adds support for controlling continuous ranges of RGB LEDs.
Helper functions for split boards are also available.
* RGB Range: Use hardware-platform agnostic wait
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/feature_rgblight.md | 68 |
1 files changed, 37 insertions, 31 deletions
diff --git a/docs/feature_rgblight.md b/docs/feature_rgblight.md index 52d5c5fe8..23b6f1c94 100644 --- a/docs/feature_rgblight.md +++ b/docs/feature_rgblight.md | |||
| @@ -148,37 +148,43 @@ const uint16_t RGBLED_GRADIENT_RANGES[] PROGMEM = {360, 240, 180, 120, 90}; | |||
| 148 | 148 | ||
| 149 | If you need to change your RGB lighting in code, for example in a macro to change the color whenever you switch layers, QMK provides a set of functions to assist you. See [`rgblight.h`](https://github.com/qmk/qmk_firmware/blob/master/quantum/rgblight.h) for the full list, but the most commonly used functions include: | 149 | If you need to change your RGB lighting in code, for example in a macro to change the color whenever you switch layers, QMK provides a set of functions to assist you. See [`rgblight.h`](https://github.com/qmk/qmk_firmware/blob/master/quantum/rgblight.h) for the full list, but the most commonly used functions include: |
| 150 | 150 | ||
| 151 | |Function |Description | | 151 | |Function |Description | |
| 152 | |-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 152 | |--------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 153 | |`rgblight_enable()` |Turn LEDs on, based on their previous state | | 153 | |`rgblight_enable()` |Turn LEDs on, based on their previous state | |
| 154 | |`rgblight_enable_noeeprom()` |Turn LEDs on, based on their previous state (not written to EEPROM) | | 154 | |`rgblight_enable_noeeprom()` |Turn LEDs on, based on their previous state (not written to EEPROM) | |
| 155 | |`rgblight_disable()` |Turn LEDs off | | 155 | |`rgblight_disable()` |Turn LEDs off | |
| 156 | |`rgblight_disable_noeeprom()` |Turn LEDs off (not written to EEPROM) | | 156 | |`rgblight_disable_noeeprom()` |Turn LEDs off (not written to EEPROM) | |
| 157 | |`rgblight_mode(x)` |Set the mode, if RGB animations are enabled | | 157 | |`rgblight_mode(x)` |Set the mode, if RGB animations are enabled | |
| 158 | |`rgblight_mode_noeeprom(x)` |Set the mode, if RGB animations are enabled (not written to EEPROM) | | 158 | |`rgblight_mode_noeeprom(x)` |Set the mode, if RGB animations are enabled (not written to EEPROM) | |
| 159 | |`rgblight_setrgb(r, g, b)` |Set all LEDs to the given RGB value where `r`/`g`/`b` are between 0 and 255 (not written to EEPROM) | | 159 | |`rgblight_setrgb(r, g, b)` |Set all LEDs to the given RGB value where `r`/`g`/`b` are between 0 and 255 (not written to EEPROM) | |
| 160 | |`rgblight_setrgb_at(r, g, b, led)` |Set a single LED to the given RGB value, where `r`/`g`/`b` are between 0 and 255 and `led` is between 0 and `RGBLED_NUM` (not written to EEPROM) | | 160 | |`rgblight_setrgb_at(r, g, b, led)` |Set a single LED to the given RGB value, where `r`/`g`/`b` are between 0 and 255 and `led` is between 0 and `RGBLED_NUM` (not written to EEPROM) | |
| 161 | |`rgblight_sethsv(h, s, v)` |Set all LEDs to the given HSV value where `h` is between 0 and 360 and `s`/`v` are between 0 and 255 | | 161 | |`rgblight_setrgb_range(r, g, b, start, end)`|Set a continuous range of LEDs to the given RGB value, where `r`/`g`/`b` are between 0 and 255 and `start`(included) and `stop`(excluded) are between 0 and `RGBLED_NUM` (not written to EEPROM)| |
| 162 | |`rgblight_sethsv_noeeprom(h, s, v)`|Set all LEDs to the given HSV value where `h` is between 0 and 360 and `s`/`v` are between 0 and 255 (not written to EEPROM) | | 162 | |`rgblight_setrgb_master(r, g, b)` |Set the LEDs on the master side to the given RGB value, where `r`/`g`/`b` are between 0 and 255 (not written to EEPROM) | |
| 163 | |`rgblight_sethsv_at(h, s, v, led)` |Set a single LED to the given HSV value, where `h` is between 0 and 360, `s`/`v` are between 0 and 255, and `led` is between 0 and `RGBLED_NUM` (not written to EEPROM)| | 163 | |`rgblight_setrgb_slave(r, g, b)` |Set the LEDs on the slave side to the given RGB value, where `r`/`g`/`b` are between 0 and 255 (not written to EEPROM) | |
| 164 | |`rgblight_toggle()` |Toggle all LEDs between on and off | | 164 | |`rgblight_sethsv(h, s, v)` |Set all LEDs to the given HSV value where `h` is between 0 and 360 and `s`/`v` are between 0 and 255 | |
| 165 | |`rgblight_toggle_noeeprom()` |Toggle all LEDs between on and off (not written to EEPROM) | | 165 | |`rgblight_sethsv_noeeprom(h, s, v)` |Set all LEDs to the given HSV value where `h` is between 0 and 360 and `s`/`v` are between 0 and 255 (not written to EEPROM) | |
| 166 | |`rgblight_step()` |Change the mode to the next RGB animation in the list of enabled RGB animations | | 166 | |`rgblight_sethsv_at(h, s, v, led)` |Set a single LED to the given HSV value, where `h` is between 0 and 360, `s`/`v` are between 0 and 255, and `led` is between 0 and `RGBLED_NUM` (not written to EEPROM)| |
| 167 | |`rgblight_step_noeeprom()` |Change the mode to the next RGB animation in the list of enabled RGB animations (not written to EEPROM) | | 167 | |`rgblight_sethsv_range(h, s, v, start, end)`|Set a continuous range of LEDs to the given HSV value, where `h` is between 0 and 360, `s`/`v` are between 0 and 255, and `start`(included) and `stop`(excluded) are between 0 and `RGBLED_NUM` (not written to EEPROM)| |
| 168 | |`rgblight_step_reverse()` |Change the mode to the previous RGB animation in the list of enabled RGB animations | | 168 | |`rgblight_sethsv_master(h, s, v)` |Set the LEDs on the master side to the given HSV value, where `h` is between 0 and 360, `s`/`v` are between 0 and 255 (not written to EEPROM) | |
| 169 | |`rgblight_step_reverse_noeeprom()` |Change the mode to the previous RGB animation in the list of enabled RGB animations (not written to EEPROM) | | 169 | |`rgblight_sethsv_slave(h, s, v)` |Set the LEDs on the slave side to the given HSV value, where `h` is between 0 and 360, `s`/`v` are between 0 and 255 (not written to EEPROM) | |
| 170 | |`rgblight_increase_hue()` |Increase the hue for all LEDs. This wraps around at maximum hue | | 170 | |`rgblight_toggle()` |Toggle all LEDs between on and off | |
| 171 | |`rgblight_increase_hue_noeeprom()` |Increase the hue for all LEDs. This wraps around at maximum hue (not written to EEPROM) | | 171 | |`rgblight_toggle_noeeprom()` |Toggle all LEDs between on and off (not written to EEPROM) | |
| 172 | |`rgblight_decrease_hue()` |Decrease the hue for all LEDs. This wraps around at minimum hue | | 172 | |`rgblight_step()` |Change the mode to the next RGB animation in the list of enabled RGB animations | |
| 173 | |`rgblight_decrease_hue_noeeprom()` |Decrease the hue for all LEDs. This wraps around at minimum hue (not written to EEPROM) | | 173 | |`rgblight_step_noeeprom()` |Change the mode to the next RGB animation in the list of enabled RGB animations (not written to EEPROM) | |
| 174 | |`rgblight_increase_sat()` |Increase the saturation for all LEDs. This wraps around at maximum saturation | | 174 | |`rgblight_step_reverse()` |Change the mode to the previous RGB animation in the list of enabled RGB animations | |
| 175 | |`rgblight_increase_sat_noeeprom()` |Increase the saturation for all LEDs. This wraps around at maximum saturation (not written to EEPROM) | | 175 | |`rgblight_step_reverse_noeeprom()` |Change the mode to the previous RGB animation in the list of enabled RGB animations (not written to EEPROM) | |
| 176 | |`rgblight_decrease_sat()` |Decrease the saturation for all LEDs. This wraps around at minimum saturation | | 176 | |`rgblight_increase_hue()` |Increase the hue for all LEDs. This wraps around at maximum hue | |
| 177 | |`rgblight_decrease_sat_noeeprom()` |Decrease the saturation for all LEDs. This wraps around at minimum saturation (not written to EEPROM) | | 177 | |`rgblight_increase_hue_noeeprom()` |Increase the hue for all LEDs. This wraps around at maximum hue (not written to EEPROM) | |
| 178 | |`rgblight_increase_val()` |Increase the value for all LEDs. This wraps around at maximum value | | 178 | |`rgblight_decrease_hue()` |Decrease the hue for all LEDs. This wraps around at minimum hue | |
| 179 | |`rgblight_increase_val_noeeprom()` |Increase the value for all LEDs. This wraps around at maximum value (not written to EEPROM) | | 179 | |`rgblight_decrease_hue_noeeprom()` |Decrease the hue for all LEDs. This wraps around at minimum hue (not written to EEPROM) | |
| 180 | |`rgblight_decrease_val()` |Decrease the value for all LEDs. This wraps around at minimum value | | 180 | |`rgblight_increase_sat()` |Increase the saturation for all LEDs. This wraps around at maximum saturation | |
| 181 | |`rgblight_decrease_val_noeeprom()` |Decrease the value for all LEDs. This wraps around at minimum value (not written to EEPROM) | | 181 | |`rgblight_increase_sat_noeeprom()` |Increase the saturation for all LEDs. This wraps around at maximum saturation (not written to EEPROM) | |
| 182 | |`rgblight_decrease_sat()` |Decrease the saturation for all LEDs. This wraps around at minimum saturation | | ||
| 183 | |`rgblight_decrease_sat_noeeprom()` |Decrease the saturation for all LEDs. This wraps around at minimum saturation (not written to EEPROM) | | ||
| 184 | |`rgblight_increase_val()` |Increase the value for all LEDs. This wraps around at maximum value | | ||
| 185 | |`rgblight_increase_val_noeeprom()` |Increase the value for all LEDs. This wraps around at maximum value (not written to EEPROM) | | ||
| 186 | |`rgblight_decrease_val()` |Decrease the value for all LEDs. This wraps around at minimum value | | ||
| 187 | |`rgblight_decrease_val_noeeprom()` |Decrease the value for all LEDs. This wraps around at minimum value (not written to EEPROM) | | ||
| 182 | 188 | ||
| 183 | Additionally, [`rgblight_list.h`](https://github.com/qmk/qmk_firmware/blob/master/quantum/rgblight_list.h) defines several predefined shortcuts for various colors. Feel free to add to this list! | 189 | Additionally, [`rgblight_list.h`](https://github.com/qmk/qmk_firmware/blob/master/quantum/rgblight_list.h) defines several predefined shortcuts for various colors. Feel free to add to this list! |
| 184 | 190 | ||