qmk_firmware

QMK firmware for my keyboards (Corne, Sweep Ferris) and trackball (Ploopy Adept)
Log | Files | Refs | Submodules | LICENSE

is31fl3742a-mono.h (7917B)


      1 /* Copyright 2017 Jason Williams
      2  * Copyright 2018 Jack Humbert
      3  * Copyright 2018 Yiancar
      4  * Copyright 2020 MelGeek
      5  * Copyright 2021 MasterSpoon
      6  *
      7  * This program is free software: you can redistribute it and/or modify
      8  * it under the terms of the GNU General Public License as published by
      9  * the Free Software Foundation, either version 2 of the License, or
     10  * (at your option) any later version.
     11  *
     12  * This program is distributed in the hope that it will be useful,
     13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
     14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     15  * GNU General Public License for more details.
     16  *
     17  * You should have received a copy of the GNU General Public License
     18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
     19  */
     20 
     21 #pragma once
     22 
     23 #include <stdint.h>
     24 #include <stdbool.h>
     25 #include "progmem.h"
     26 #include "util.h"
     27 
     28 #define IS31FL3742A_REG_INTERRUPT_MASK 0xF0
     29 #define IS31FL3742A_REG_INTERRUPT_STATUS 0xF1
     30 #define IS31FL3742A_REG_ID 0xFC
     31 
     32 #define IS31FL3742A_REG_COMMAND 0xFD
     33 
     34 #define IS31FL3742A_COMMAND_PWM 0x00
     35 #define IS31FL3742A_COMMAND_SCALING 0x02
     36 #define IS31FL3742A_COMMAND_FUNCTION 0x04
     37 
     38 #define IS31FL3742A_FUNCTION_REG_CONFIGURATION 0x00
     39 #define IS31FL3742A_FUNCTION_REG_GLOBAL_CURRENT 0x01
     40 #define IS31FL3742A_FUNCTION_REG_PULLDOWNUP 0x02
     41 #define IS31FL3742A_FUNCTION_REG_PWM_FREQUENCY 0x36
     42 #define IS31FL3742A_FUNCTION_REG_RESET 0x3F
     43 #define IS31FL3742A_FUNCTION_REG_SPREAD_SPECTRUM 0x41
     44 
     45 #define IS31FL3742A_REG_COMMAND_WRITE_LOCK 0xFE
     46 #define IS31FL3742A_COMMAND_WRITE_LOCK_MAGIC 0xC5
     47 
     48 #define IS31FL3742A_I2C_ADDRESS_GND 0x30
     49 #define IS31FL3742A_I2C_ADDRESS_SCL 0x31
     50 #define IS31FL3742A_I2C_ADDRESS_SDA 0x32
     51 #define IS31FL3742A_I2C_ADDRESS_VCC 0x33
     52 
     53 #if defined(LED_MATRIX_IS31FL3742A)
     54 #    define IS31FL3742A_LED_COUNT LED_MATRIX_LED_COUNT
     55 #endif
     56 
     57 #if defined(IS31FL3742A_I2C_ADDRESS_4)
     58 #    define IS31FL3742A_DRIVER_COUNT 4
     59 #elif defined(IS31FL3742A_I2C_ADDRESS_3)
     60 #    define IS31FL3742A_DRIVER_COUNT 3
     61 #elif defined(IS31FL3742A_I2C_ADDRESS_2)
     62 #    define IS31FL3742A_DRIVER_COUNT 2
     63 #elif defined(IS31FL3742A_I2C_ADDRESS_1)
     64 #    define IS31FL3742A_DRIVER_COUNT 1
     65 #endif
     66 
     67 typedef struct is31fl3742a_led_t {
     68     uint8_t driver : 2;
     69     uint8_t v;
     70 } PACKED is31fl3742a_led_t;
     71 
     72 extern const is31fl3742a_led_t PROGMEM g_is31fl3742a_leds[IS31FL3742A_LED_COUNT];
     73 
     74 void is31fl3742a_init_drivers(void);
     75 void is31fl3742a_init(uint8_t index);
     76 void is31fl3742a_write_register(uint8_t index, uint8_t reg, uint8_t data);
     77 void is31fl3742a_select_page(uint8_t index, uint8_t page);
     78 
     79 void is31fl3742a_set_value(int index, uint8_t value);
     80 void is31fl3742a_set_value_all(uint8_t value);
     81 
     82 void is31fl3742a_set_scaling_register(uint8_t index, uint8_t value);
     83 
     84 void is31fl3742a_update_pwm_buffers(uint8_t index);
     85 void is31fl3742a_update_scaling_registers(uint8_t index);
     86 
     87 void is31fl3742a_flush(void);
     88 
     89 #define IS31FL3742A_PDR_0_OHM 0b000   // No pull-down resistor
     90 #define IS31FL3742A_PDR_0K5_OHM 0b001 // 0.5 kOhm resistor
     91 #define IS31FL3742A_PDR_1K_OHM 0b010  // 1 kOhm resistor
     92 #define IS31FL3742A_PDR_2K_OHM 0b011  // 2 kOhm resistor
     93 #define IS31FL3742A_PDR_4K_OHM 0b100  // 4 kOhm resistor
     94 #define IS31FL3742A_PDR_8K_OHM 0b101  // 8 kOhm resistor
     95 #define IS31FL3742A_PDR_16K_OHM 0b110 // 16 kOhm resistor
     96 #define IS31FL3742A_PDR_32K_OHM 0b111 // 32 kOhm resistor
     97 
     98 #define IS31FL3742A_PUR_0_OHM 0b000   // No pull-up resistor
     99 #define IS31FL3742A_PUR_0K5_OHM 0b001 // 0.5 kOhm resistor
    100 #define IS31FL3742A_PUR_1K_OHM 0b010  // 1 kOhm resistor
    101 #define IS31FL3742A_PUR_2K_OHM 0b011  // 2 kOhm resistor
    102 #define IS31FL3742A_PUR_4K_OHM 0b100  // 4 kOhm resistor
    103 #define IS31FL3742A_PUR_8K_OHM 0b101  // 8 kOhm resistor
    104 #define IS31FL3742A_PUR_16K_OHM 0b110 // 16 kOhm resistor
    105 #define IS31FL3742A_PUR_32K_OHM 0b111 // 32 kOhm resistor
    106 
    107 #define IS31FL3742A_PWM_FREQUENCY_29K_HZ 0b0000
    108 #define IS31FL3742A_PWM_FREQUENCY_3K6_HZ 0b0011
    109 #define IS31FL3742A_PWM_FREQUENCY_1K8_HZ 0b0111
    110 #define IS31FL3742A_PWM_FREQUENCY_900_HZ 0b1011
    111 
    112 #define SW1_CS1 0x00
    113 #define SW1_CS2 0x01
    114 #define SW1_CS3 0x02
    115 #define SW1_CS4 0x03
    116 #define SW1_CS5 0x04
    117 #define SW1_CS6 0x05
    118 #define SW1_CS7 0x06
    119 #define SW1_CS8 0x07
    120 #define SW1_CS9 0x08
    121 #define SW1_CS10 0x09
    122 #define SW1_CS11 0x0A
    123 #define SW1_CS12 0x0B
    124 #define SW1_CS13 0x0C
    125 #define SW1_CS14 0x0D
    126 #define SW1_CS15 0x0E
    127 #define SW1_CS16 0x0F
    128 #define SW1_CS17 0x10
    129 #define SW1_CS18 0x11
    130 #define SW1_CS19 0x12
    131 #define SW1_CS20 0x13
    132 #define SW1_CS21 0x14
    133 #define SW1_CS22 0x15
    134 #define SW1_CS23 0x16
    135 #define SW1_CS24 0x17
    136 #define SW1_CS25 0x18
    137 #define SW1_CS26 0x19
    138 #define SW1_CS27 0x1A
    139 #define SW1_CS28 0x1B
    140 #define SW1_CS29 0x1C
    141 #define SW1_CS30 0x1D
    142 
    143 #define SW2_CS1 0x1E
    144 #define SW2_CS2 0x1F
    145 #define SW2_CS3 0x20
    146 #define SW2_CS4 0x21
    147 #define SW2_CS5 0x22
    148 #define SW2_CS6 0x23
    149 #define SW2_CS7 0x24
    150 #define SW2_CS8 0x25
    151 #define SW2_CS9 0x26
    152 #define SW2_CS10 0x27
    153 #define SW2_CS11 0x28
    154 #define SW2_CS12 0x29
    155 #define SW2_CS13 0x2A
    156 #define SW2_CS14 0x2B
    157 #define SW2_CS15 0x2C
    158 #define SW2_CS16 0x2D
    159 #define SW2_CS17 0x2E
    160 #define SW2_CS18 0x2F
    161 #define SW2_CS19 0x30
    162 #define SW2_CS20 0x31
    163 #define SW2_CS21 0x32
    164 #define SW2_CS22 0x33
    165 #define SW2_CS23 0x34
    166 #define SW2_CS24 0x35
    167 #define SW2_CS25 0x36
    168 #define SW2_CS26 0x37
    169 #define SW2_CS27 0x38
    170 #define SW2_CS28 0x39
    171 #define SW2_CS29 0x3A
    172 #define SW2_CS30 0x3B
    173 
    174 #define SW3_CS1 0x3C
    175 #define SW3_CS2 0x3D
    176 #define SW3_CS3 0x3E
    177 #define SW3_CS4 0x3F
    178 #define SW3_CS5 0x40
    179 #define SW3_CS6 0x41
    180 #define SW3_CS7 0x42
    181 #define SW3_CS8 0x43
    182 #define SW3_CS9 0x44
    183 #define SW3_CS10 0x45
    184 #define SW3_CS11 0x46
    185 #define SW3_CS12 0x47
    186 #define SW3_CS13 0x48
    187 #define SW3_CS14 0x49
    188 #define SW3_CS15 0x4A
    189 #define SW3_CS16 0x4B
    190 #define SW3_CS17 0x4C
    191 #define SW3_CS18 0x4D
    192 #define SW3_CS19 0x4E
    193 #define SW3_CS20 0x4F
    194 #define SW3_CS21 0x50
    195 #define SW3_CS22 0x51
    196 #define SW3_CS23 0x52
    197 #define SW3_CS24 0x53
    198 #define SW3_CS25 0x54
    199 #define SW3_CS26 0x55
    200 #define SW3_CS27 0x56
    201 #define SW3_CS28 0x57
    202 #define SW3_CS29 0x58
    203 #define SW3_CS30 0x59
    204 
    205 #define SW4_CS1 0x5A
    206 #define SW4_CS2 0x5B
    207 #define SW4_CS3 0x5C
    208 #define SW4_CS4 0x5D
    209 #define SW4_CS5 0x5E
    210 #define SW4_CS6 0x5F
    211 #define SW4_CS7 0x60
    212 #define SW4_CS8 0x61
    213 #define SW4_CS9 0x62
    214 #define SW4_CS10 0x63
    215 #define SW4_CS11 0x64
    216 #define SW4_CS12 0x65
    217 #define SW4_CS13 0x66
    218 #define SW4_CS14 0x67
    219 #define SW4_CS15 0x68
    220 #define SW4_CS16 0x69
    221 #define SW4_CS17 0x6A
    222 #define SW4_CS18 0x6B
    223 #define SW4_CS19 0x6C
    224 #define SW4_CS20 0x6D
    225 #define SW4_CS21 0x6E
    226 #define SW4_CS22 0x6F
    227 #define SW4_CS23 0x70
    228 #define SW4_CS24 0x71
    229 #define SW4_CS25 0x72
    230 #define SW4_CS26 0x73
    231 #define SW4_CS27 0x74
    232 #define SW4_CS28 0x75
    233 #define SW4_CS29 0x76
    234 #define SW4_CS30 0x77
    235 
    236 #define SW5_CS1 0x78
    237 #define SW5_CS2 0x79
    238 #define SW5_CS3 0x7A
    239 #define SW5_CS4 0x7B
    240 #define SW5_CS5 0x7C
    241 #define SW5_CS6 0x7D
    242 #define SW5_CS7 0x7E
    243 #define SW5_CS8 0x7F
    244 #define SW5_CS9 0x80
    245 #define SW5_CS10 0x81
    246 #define SW5_CS11 0x82
    247 #define SW5_CS12 0x83
    248 #define SW5_CS13 0x84
    249 #define SW5_CS14 0x85
    250 #define SW5_CS15 0x86
    251 #define SW5_CS16 0x87
    252 #define SW5_CS17 0x88
    253 #define SW5_CS18 0x89
    254 #define SW5_CS19 0x8A
    255 #define SW5_CS20 0x8B
    256 #define SW5_CS21 0x8C
    257 #define SW5_CS22 0x8D
    258 #define SW5_CS23 0x8E
    259 #define SW5_CS24 0x8F
    260 #define SW5_CS25 0x90
    261 #define SW5_CS26 0x91
    262 #define SW5_CS27 0x92
    263 #define SW5_CS28 0x93
    264 #define SW5_CS29 0x94
    265 #define SW5_CS30 0x95
    266 
    267 #define SW6_CS1 0x96
    268 #define SW6_CS2 0x97
    269 #define SW6_CS3 0x98
    270 #define SW6_CS4 0x99
    271 #define SW6_CS5 0x9A
    272 #define SW6_CS6 0x9B
    273 #define SW6_CS7 0x9C
    274 #define SW6_CS8 0x9D
    275 #define SW6_CS9 0x9E
    276 #define SW6_CS10 0x9F
    277 #define SW6_CS11 0xA0
    278 #define SW6_CS12 0xA1
    279 #define SW6_CS13 0xA2
    280 #define SW6_CS14 0xA3
    281 #define SW6_CS15 0xA4
    282 #define SW6_CS16 0xA5
    283 #define SW6_CS17 0xA6
    284 #define SW6_CS18 0xA7
    285 #define SW6_CS19 0xA8
    286 #define SW6_CS20 0xA9
    287 #define SW6_CS21 0xAA
    288 #define SW6_CS22 0xAB
    289 #define SW6_CS23 0xAC
    290 #define SW6_CS24 0xAD
    291 #define SW6_CS25 0xAE
    292 #define SW6_CS26 0xAF
    293 #define SW6_CS27 0xB0
    294 #define SW6_CS28 0xB1
    295 #define SW6_CS29 0xB2
    296 #define SW6_CS30 0xB3