mirror of
				https://github.com/mfulz/qmk_firmware.git
				synced 2025-10-31 05:12:33 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			315 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			315 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* Copyright 2017 Yang Liu
 | |
|  *
 | |
|  * This program is free software: you can redistribute it and/or modify
 | |
|  * it under the terms of the GNU General Public License as published by
 | |
|  * the Free Software Foundation, either version 2 of the License, or
 | |
|  * (at your option) any later version.
 | |
|  *
 | |
|  * This program is distributed in the hope that it will be useful,
 | |
|  * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
|  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | |
|  * GNU General Public License for more details.
 | |
|  *
 | |
|  * You should have received a copy of the GNU General Public License
 | |
|  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | |
|  */
 | |
| #ifndef RGBLIGHT_H
 | |
| #define RGBLIGHT_H
 | |
| 
 | |
| #include "rgblight_reconfig.h"
 | |
| 
 | |
| /***** rgblight_mode(mode)/rgblight_mode_noeeprom(mode) ****
 | |
| 
 | |
|  old mode number (before 0.6.117) to new mode name table
 | |
| 
 | |
| |-----------------|-----------------------------------|
 | |
| | old mode number | new mode name                     |
 | |
| |-----------------|-----------------------------------|
 | |
| |        1        | RGBLIGHT_MODE_STATIC_LIGHT        |
 | |
| |        2        | RGBLIGHT_MODE_BREATHING           |
 | |
| |        3        | RGBLIGHT_MODE_BREATHING + 1       |
 | |
| |        4        | RGBLIGHT_MODE_BREATHING + 2       |
 | |
| |        5        | RGBLIGHT_MODE_BREATHING + 3       |
 | |
| |        6        | RGBLIGHT_MODE_RAINBOW_MOOD        |
 | |
| |        7        | RGBLIGHT_MODE_RAINBOW_MOOD + 1    |
 | |
| |        8        | RGBLIGHT_MODE_RAINBOW_MOOD + 2    |
 | |
| |        9        | RGBLIGHT_MODE_RAINBOW_SWIRL       |
 | |
| |       10        | RGBLIGHT_MODE_RAINBOW_SWIRL + 1   |
 | |
| |       11        | RGBLIGHT_MODE_RAINBOW_SWIRL + 2   |
 | |
| |       12        | RGBLIGHT_MODE_RAINBOW_SWIRL + 3   |
 | |
| |       13        | RGBLIGHT_MODE_RAINBOW_SWIRL + 4   |
 | |
| |       14        | RGBLIGHT_MODE_RAINBOW_SWIRL + 5   |
 | |
| |       15        | RGBLIGHT_MODE_SNAKE               |
 | |
| |       16        | RGBLIGHT_MODE_SNAKE + 1           |
 | |
| |       17        | RGBLIGHT_MODE_SNAKE + 2           |
 | |
| |       18        | RGBLIGHT_MODE_SNAKE + 3           |
 | |
| |       19        | RGBLIGHT_MODE_SNAKE + 4           |
 | |
| |       20        | RGBLIGHT_MODE_SNAKE + 5           |
 | |
| |       21        | RGBLIGHT_MODE_KNIGHT              |
 | |
| |       22        | RGBLIGHT_MODE_KNIGHT + 1          |
 | |
| |       23        | RGBLIGHT_MODE_KNIGHT + 2          |
 | |
| |       24        | RGBLIGHT_MODE_CHRISTMAS           |
 | |
| |       25        | RGBLIGHT_MODE_STATIC_GRADIENT     |
 | |
| |       26        | RGBLIGHT_MODE_STATIC_GRADIENT + 1 |
 | |
| |       27        | RGBLIGHT_MODE_STATIC_GRADIENT + 2 |
 | |
| |       28        | RGBLIGHT_MODE_STATIC_GRADIENT + 3 |
 | |
| |       29        | RGBLIGHT_MODE_STATIC_GRADIENT + 4 |
 | |
| |       30        | RGBLIGHT_MODE_STATIC_GRADIENT + 5 |
 | |
| |       31        | RGBLIGHT_MODE_STATIC_GRADIENT + 6 |
 | |
| |       32        | RGBLIGHT_MODE_STATIC_GRADIENT + 7 |
 | |
| |       33        | RGBLIGHT_MODE_STATIC_GRADIENT + 8 |
 | |
| |       34        | RGBLIGHT_MODE_STATIC_GRADIENT + 9 |
 | |
| |       35        | RGBLIGHT_MODE_RGB_TEST            |
 | |
| |       36        | RGBLIGHT_MODE_ALTERNATING         |
 | |
| |-----------------|-----------------------------------|
 | |
|  *****/
 | |
| 
 | |
| #define _RGBM_SINGLE_STATIC(sym) RGBLIGHT_MODE_##sym,
 | |
| #define _RGBM_SINGLE_DYNAMIC(sym) RGBLIGHT_MODE_##sym,
 | |
| #define _RGBM_MULTI_STATIC(sym) RGBLIGHT_MODE_##sym,
 | |
| #define _RGBM_MULTI_DYNAMIC(sym) RGBLIGHT_MODE_##sym,
 | |
| #define _RGBM_TMP_STATIC(sym, msym) RGBLIGHT_MODE_##sym,
 | |
| #define _RGBM_TMP_DYNAMIC(sym, msym) RGBLIGHT_MODE_##sym,
 | |
| enum RGBLIGHT_EFFECT_MODE {
 | |
|     RGBLIGHT_MODE_zero = 0,
 | |
| #include "rgblight_modes.h"
 | |
|     RGBLIGHT_MODE_last
 | |
| };
 | |
| 
 | |
| #ifndef RGBLIGHT_H_DUMMY_DEFINE
 | |
| 
 | |
| #    define RGBLIGHT_MODES (RGBLIGHT_MODE_last - 1)
 | |
| 
 | |
| // sample: #define RGBLIGHT_EFFECT_BREATHE_CENTER   1.85
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_BREATHE_MAX
 | |
| #        define RGBLIGHT_EFFECT_BREATHE_MAX 255  // 0-255
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_SNAKE_LENGTH
 | |
| #        define RGBLIGHT_EFFECT_SNAKE_LENGTH 4
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_KNIGHT_LENGTH
 | |
| #        define RGBLIGHT_EFFECT_KNIGHT_LENGTH 3
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_KNIGHT_OFFSET
 | |
| #        define RGBLIGHT_EFFECT_KNIGHT_OFFSET 0
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_KNIGHT_LED_NUM
 | |
| #        define RGBLIGHT_EFFECT_KNIGHT_LED_NUM (effect_num_leds)
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_CHRISTMAS_INTERVAL
 | |
| #        define RGBLIGHT_EFFECT_CHRISTMAS_INTERVAL 1000
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_EFFECT_CHRISTMAS_STEP
 | |
| #        define RGBLIGHT_EFFECT_CHRISTMAS_STEP 2
 | |
| #    endif
 | |
| 
 | |
| #    ifndef RGBLIGHT_HUE_STEP
 | |
| #        define RGBLIGHT_HUE_STEP 8
 | |
| #    endif
 | |
| #    ifndef RGBLIGHT_SAT_STEP
 | |
| #        define RGBLIGHT_SAT_STEP 17
 | |
| #    endif
 | |
| #    ifndef RGBLIGHT_VAL_STEP
 | |
| #        define RGBLIGHT_VAL_STEP 17
 | |
| #    endif
 | |
| #    ifndef RGBLIGHT_LIMIT_VAL
 | |
| #        define RGBLIGHT_LIMIT_VAL 255
 | |
| #    endif
 | |
| 
 | |
| #    define RGBLED_TIMER_TOP F_CPU / (256 * 64)
 | |
| // #define RGBLED_TIMER_TOP 0xFF10
 | |
| 
 | |
| #    include <stdint.h>
 | |
| #    include <stdbool.h>
 | |
| #    include "eeconfig.h"
 | |
| #    ifndef RGBLIGHT_CUSTOM_DRIVER
 | |
| #        include "ws2812.h"
 | |
| #    endif
 | |
| #    include "color.h"
 | |
| #    include "rgblight_list.h"
 | |
| 
 | |
| #    if defined(__AVR__)
 | |
| #        include <avr/pgmspace.h>
 | |
| #    endif
 | |
| 
 | |
| extern LED_TYPE led[RGBLED_NUM];
 | |
| 
 | |
| extern const uint8_t  RGBLED_BREATHING_INTERVALS[4] PROGMEM;
 | |
| extern const uint8_t  RGBLED_RAINBOW_MOOD_INTERVALS[3] PROGMEM;
 | |
| extern const uint8_t  RGBLED_RAINBOW_SWIRL_INTERVALS[3] PROGMEM;
 | |
| extern const uint8_t  RGBLED_SNAKE_INTERVALS[3] PROGMEM;
 | |
| extern const uint8_t  RGBLED_KNIGHT_INTERVALS[3] PROGMEM;
 | |
| extern const uint16_t RGBLED_RGBTEST_INTERVALS[1] PROGMEM;
 | |
| extern bool           is_rgblight_initialized;
 | |
| 
 | |
| // Should stay in sycn with rgb matrix config as we reuse eeprom storage for both (for now)
 | |
| typedef union {
 | |
|     uint32_t raw;
 | |
|     struct {
 | |
|         bool    enable : 1;
 | |
|         uint8_t mode : 7;
 | |
|         uint8_t hue : 8;
 | |
|         uint8_t sat : 8;
 | |
|         uint8_t val : 8;
 | |
|         uint8_t speed : 8;  // EECONFIG needs to be increased to support this
 | |
|     };
 | |
| } rgblight_config_t;
 | |
| 
 | |
| typedef struct _rgblight_status_t {
 | |
|     uint8_t base_mode;
 | |
|     bool    timer_enabled;
 | |
| #    ifdef RGBLIGHT_SPLIT
 | |
|     uint8_t change_flags;
 | |
| #    endif
 | |
| } rgblight_status_t;
 | |
| 
 | |
| /* === Utility Functions ===*/
 | |
| void sethsv(uint8_t hue, uint8_t sat, uint8_t val, LED_TYPE *led1);
 | |
| void sethsv_raw(uint8_t hue, uint8_t sat, uint8_t val, LED_TYPE *led1);  // without RGBLIGHT_LIMIT_VAL check
 | |
| void setrgb(uint8_t r, uint8_t g, uint8_t b, LED_TYPE *led1);
 | |
| 
 | |
| /* === Low level Functions === */
 | |
| void rgblight_set(void);
 | |
| void rgblight_set_clipping_range(uint8_t start_pos, uint8_t num_leds);
 | |
| 
 | |
| /* === Effects and Animations Functions === */
 | |
| /*   effect range setting */
 | |
| void rgblight_set_effect_range(uint8_t start_pos, uint8_t num_leds);
 | |
| 
 | |
| /*   direct operation */
 | |
| void rgblight_setrgb_at(uint8_t r, uint8_t g, uint8_t b, uint8_t index);
 | |
| void rgblight_sethsv_at(uint8_t hue, uint8_t sat, uint8_t val, uint8_t index);
 | |
| void rgblight_setrgb_range(uint8_t r, uint8_t g, uint8_t b, uint8_t start, uint8_t end);
 | |
| void rgblight_sethsv_range(uint8_t hue, uint8_t sat, uint8_t val, uint8_t start, uint8_t end);
 | |
| void rgblight_setrgb(uint8_t r, uint8_t g, uint8_t b);
 | |
| 
 | |
| #    ifndef RGBLIGHT_SPLIT
 | |
| void rgblight_setrgb_master(uint8_t r, uint8_t g, uint8_t b);
 | |
| void rgblight_setrgb_slave(uint8_t r, uint8_t g, uint8_t b);
 | |
| void rgblight_sethsv_master(uint8_t hue, uint8_t sat, uint8_t val);
 | |
| void rgblight_sethsv_slave(uint8_t hue, uint8_t sat, uint8_t val);
 | |
| #    endif
 | |
| 
 | |
| /*   effect mode change */
 | |
| void rgblight_mode(uint8_t mode);
 | |
| void rgblight_mode_noeeprom(uint8_t mode);
 | |
| void rgblight_increase(void);
 | |
| void rgblight_decrease(void);
 | |
| void rgblight_step(void);
 | |
| void rgblight_step_noeeprom(void);
 | |
| void rgblight_step_reverse(void);
 | |
| void rgblight_step_reverse_noeeprom(void);
 | |
| 
 | |
| /*   effects mode disable/enable */
 | |
| void rgblight_toggle(void);
 | |
| void rgblight_toggle_noeeprom(void);
 | |
| void rgblight_enable(void);
 | |
| void rgblight_enable_noeeprom(void);
 | |
| void rgblight_disable(void);
 | |
| void rgblight_disable_noeeprom(void);
 | |
| 
 | |
| /*   hue, sat, val change */
 | |
| void rgblight_increase_hue(void);
 | |
| void rgblight_increase_hue_noeeprom(void);
 | |
| void rgblight_decrease_hue(void);
 | |
| void rgblight_decrease_hue_noeeprom(void);
 | |
| void rgblight_increase_sat(void);
 | |
| void rgblight_increase_sat_noeeprom(void);
 | |
| void rgblight_decrease_sat(void);
 | |
| void rgblight_decrease_sat_noeeprom(void);
 | |
| void rgblight_increase_val(void);
 | |
| void rgblight_increase_val_noeeprom(void);
 | |
| void rgblight_decrease_val(void);
 | |
| void rgblight_decrease_val_noeeprom(void);
 | |
| void rgblight_increase_speed(void);
 | |
| void rgblight_decrease_speed(void);
 | |
| void rgblight_sethsv(uint8_t hue, uint8_t sat, uint8_t val);
 | |
| void rgblight_sethsv_noeeprom(uint8_t hue, uint8_t sat, uint8_t val);
 | |
| 
 | |
| /*       query */
 | |
| uint8_t rgblight_get_mode(void);
 | |
| uint8_t rgblight_get_hue(void);
 | |
| uint8_t rgblight_get_sat(void);
 | |
| uint8_t rgblight_get_val(void);
 | |
| 
 | |
| /* === qmk_firmware (core)internal Functions === */
 | |
| void     rgblight_init(void);
 | |
| uint32_t rgblight_read_dword(void);
 | |
| void     rgblight_update_dword(uint32_t dword);
 | |
| uint32_t eeconfig_read_rgblight(void);
 | |
| void     eeconfig_update_rgblight(uint32_t val);
 | |
| void     eeconfig_update_rgblight_default(void);
 | |
| void     eeconfig_debug_rgblight(void);
 | |
| 
 | |
| void rgb_matrix_increase(void);
 | |
| void rgb_matrix_decrease(void);
 | |
| 
 | |
| void rgblight_sethsv_eeprom_helper(uint8_t hue, uint8_t sat, uint8_t val, bool write_to_eeprom);
 | |
| void rgblight_mode_eeprom_helper(uint8_t mode, bool write_to_eeprom);
 | |
| 
 | |
| #    define EZ_RGB(val) rgblight_show_solid_color((val >> 16) & 0xFF, (val >> 8) & 0xFF, val & 0xFF)
 | |
| void rgblight_show_solid_color(uint8_t r, uint8_t g, uint8_t b);
 | |
| 
 | |
| void rgblight_task(void);
 | |
| 
 | |
| void rgblight_timer_init(void);
 | |
| void rgblight_timer_enable(void);
 | |
| void rgblight_timer_disable(void);
 | |
| void rgblight_timer_toggle(void);
 | |
| 
 | |
| #    ifdef RGBLIGHT_SPLIT
 | |
| #        define RGBLIGHT_STATUS_CHANGE_MODE (1 << 0)
 | |
| #        define RGBLIGHT_STATUS_CHANGE_HSVS (1 << 1)
 | |
| #        define RGBLIGHT_STATUS_CHANGE_TIMER (1 << 2)
 | |
| #        define RGBLIGHT_STATUS_ANIMATION_TICK (1 << 3)
 | |
| 
 | |
| typedef struct _rgblight_syncinfo_t {
 | |
|     rgblight_config_t config;
 | |
|     rgblight_status_t status;
 | |
| } rgblight_syncinfo_t;
 | |
| 
 | |
| /* for split keyboard master side */
 | |
| uint8_t rgblight_get_change_flags(void);
 | |
| void    rgblight_clear_change_flags(void);
 | |
| void    rgblight_get_syncinfo(rgblight_syncinfo_t *syncinfo);
 | |
| /* for split keyboard slave side */
 | |
| void rgblight_update_sync(rgblight_syncinfo_t *syncinfo, bool write_to_eeprom);
 | |
| #    endif
 | |
| 
 | |
| #    ifdef RGBLIGHT_USE_TIMER
 | |
| 
 | |
| typedef struct _animation_status_t {
 | |
|     uint16_t last_timer;
 | |
|     uint8_t  delta; /* mode - base_mode */
 | |
|     bool     restart;
 | |
|     union {
 | |
|         uint16_t pos16;
 | |
|         uint8_t  pos;
 | |
|         int8_t   current_hue;
 | |
|         uint16_t current_offset;
 | |
|     };
 | |
| } animation_status_t;
 | |
| 
 | |
| extern animation_status_t animation_status;
 | |
| 
 | |
| void rgblight_effect_breathing(animation_status_t *anim);
 | |
| void rgblight_effect_rainbow_mood(animation_status_t *anim);
 | |
| void rgblight_effect_rainbow_swirl(animation_status_t *anim);
 | |
| void rgblight_effect_snake(animation_status_t *anim);
 | |
| void rgblight_effect_knight(animation_status_t *anim);
 | |
| void rgblight_effect_christmas(animation_status_t *anim);
 | |
| void rgblight_effect_rgbtest(animation_status_t *anim);
 | |
| void rgblight_effect_alternating(animation_status_t *anim);
 | |
| 
 | |
| #    endif
 | |
| 
 | |
| #endif  // #ifndef RGBLIGHT_H_DUMMY_DEFINE
 | |
| #endif  // RGBLIGHT_H
 | 
