-
-
Notifications
You must be signed in to change notification settings - Fork 39.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
is31fl3218: Add LED Matrix support (#22126)
Co-authored-by: Joel Challis <git@zvecr.com>
- Loading branch information
Showing
6 changed files
with
243 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,143 @@ | ||
/* Copyright 2018 Jason Williams (Wilba) | ||
* | ||
* 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/>. | ||
*/ | ||
#include "is31fl3218.h" | ||
#include <string.h> | ||
#include "i2c_master.h" | ||
|
||
// These are the register addresses | ||
#define IS31FL3218_REG_SHUTDOWN 0x00 | ||
#define IS31FL3218_REG_PWM 0x01 | ||
#define IS31FL3218_REG_CONTROL 0x13 | ||
#define IS31FL3218_REG_UPDATE 0x16 | ||
#define IS31FL3218_REG_RESET 0x17 | ||
|
||
#ifndef IS31FL3218_I2C_TIMEOUT | ||
# define IS31FL3218_I2C_TIMEOUT 100 | ||
#endif | ||
|
||
#ifndef IS31FL3218_I2C_PERSISTENCE | ||
# define IS31FL3218_I2C_PERSISTENCE 0 | ||
#endif | ||
|
||
// Reusable buffer for transfers | ||
uint8_t g_twi_transfer_buffer[20]; | ||
|
||
// IS31FL3218 has 18 PWM outputs and a fixed I2C address, so no chaining. | ||
uint8_t g_pwm_buffer[18]; | ||
bool g_pwm_buffer_update_required = false; | ||
|
||
uint8_t g_led_control_registers[3] = {0}; | ||
bool g_led_control_registers_update_required = false; | ||
|
||
void is31fl3218_write_register(uint8_t reg, uint8_t data) { | ||
g_twi_transfer_buffer[0] = reg; | ||
g_twi_transfer_buffer[1] = data; | ||
#if IS31FL3218_I2C_PERSISTENCE > 0 | ||
for (uint8_t i = 0; i < IS31FL3218_I2C_PERSISTENCE; i++) { | ||
if (i2c_transmit(IS31FL3218_I2C_ADDRESS << 1, g_twi_transfer_buffer, 2, IS31FL3218_I2C_TIMEOUT) == 0) break; | ||
} | ||
#else | ||
i2c_transmit(IS31FL3218_I2C_ADDRESS << 1, g_twi_transfer_buffer, 2, IS31FL3218_I2C_TIMEOUT); | ||
#endif | ||
} | ||
|
||
void is31fl3218_write_pwm_buffer(uint8_t *pwm_buffer) { | ||
g_twi_transfer_buffer[0] = IS31FL3218_REG_PWM; | ||
memcpy(g_twi_transfer_buffer + 1, pwm_buffer, 18); | ||
|
||
#if IS31FL3218_I2C_PERSISTENCE > 0 | ||
for (uint8_t i = 0; i < IS31FL3218_I2C_PERSISTENCE; i++) { | ||
i2c_transmit(IS31FL3218_I2C_ADDRESS << 1, g_twi_transfer_buffer, 19, IS31FL3218_I2C_TIMEOUT); | ||
} | ||
#else | ||
i2c_transmit(IS31FL3218_I2C_ADDRESS << 1, g_twi_transfer_buffer, 19, IS31FL3218_I2C_TIMEOUT); | ||
#endif | ||
} | ||
|
||
void is31fl3218_init(void) { | ||
// In case we ever want to reinitialize (?) | ||
is31fl3218_write_register(IS31FL3218_REG_RESET, 0x00); | ||
|
||
// Turn off software shutdown | ||
is31fl3218_write_register(IS31FL3218_REG_SHUTDOWN, 0x01); | ||
|
||
// Set all PWM values to zero | ||
for (uint8_t i = 0; i < 18; i++) { | ||
is31fl3218_write_register(IS31FL3218_REG_PWM + i, 0x00); | ||
} | ||
|
||
// turn off all LEDs in the LED control register | ||
for (uint8_t i = 0; i < 3; i++) { | ||
is31fl3218_write_register(IS31FL3218_REG_CONTROL + i, 0x00); | ||
} | ||
|
||
// Load PWM registers and LED Control register data | ||
is31fl3218_write_register(IS31FL3218_REG_UPDATE, 0x01); | ||
} | ||
|
||
void is31fl3218_set_value(int index, uint8_t value) { | ||
is31fl3218_led_t led; | ||
if (index >= 0 && index < LED_MATRIX_LED_COUNT) { | ||
memcpy_P(&led, (&g_is31fl3218_leds[index]), sizeof(led)); | ||
} | ||
if (g_pwm_buffer[led.v - IS31FL3218_REG_PWM] == value) { | ||
return; | ||
} | ||
g_pwm_buffer[led.v - IS31FL3218_REG_PWM] = value; | ||
g_pwm_buffer_update_required = true; | ||
} | ||
|
||
void is31fl3218_set_value_all(uint8_t value) { | ||
for (int i = 0; i < LED_MATRIX_LED_COUNT; i++) { | ||
is31fl3218_set_value(i, value); | ||
} | ||
} | ||
|
||
void is31fl3218_set_led_control_register(uint8_t index, bool value) { | ||
is31fl3218_led_t led; | ||
memcpy_P(&led, (&g_is31fl3218_leds[index]), sizeof(led)); | ||
|
||
uint8_t control_register = (led.v - IS31FL3218_REG_PWM) / 6; | ||
uint8_t bit_value = (led.v - IS31FL3218_REG_PWM) % 6; | ||
|
||
if (value) { | ||
g_led_control_registers[control_register] |= (1 << bit_value); | ||
} else { | ||
g_led_control_registers[control_register] &= ~(1 << bit_value); | ||
} | ||
|
||
g_led_control_registers_update_required = true; | ||
} | ||
|
||
void is31fl3218_update_pwm_buffers(void) { | ||
if (g_pwm_buffer_update_required) { | ||
is31fl3218_write_pwm_buffer(g_pwm_buffer); | ||
// Load PWM registers and LED Control register data | ||
is31fl3218_write_register(IS31FL3218_REG_UPDATE, 0x01); | ||
|
||
g_pwm_buffer_update_required = false; | ||
} | ||
} | ||
|
||
void is31fl3218_update_led_control_registers(void) { | ||
if (g_led_control_registers_update_required) { | ||
for (int i = 0; i < 3; i++) { | ||
is31fl3218_write_register(IS31FL3218_REG_CONTROL + i, g_led_control_registers[i]); | ||
} | ||
|
||
g_led_control_registers_update_required = false; | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
/* Copyright 2018 Jason Williams (Wilba) | ||
* | ||
* 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/>. | ||
*/ | ||
|
||
#pragma once | ||
|
||
#include <stdint.h> | ||
#include <stdbool.h> | ||
#include "progmem.h" | ||
|
||
#define IS31FL3218_I2C_ADDRESS 0x54 | ||
|
||
typedef struct is31fl3218_led_t { | ||
uint8_t v; | ||
} __attribute__((packed)) is31fl3218_led_t; | ||
|
||
extern const is31fl3218_led_t PROGMEM g_is31fl3218_leds[LED_MATRIX_LED_COUNT]; | ||
|
||
void is31fl3218_init(void); | ||
|
||
void is31fl3218_set_value(int index, uint8_t value); | ||
|
||
void is31fl3218_set_value_all(uint8_t value); | ||
|
||
void is31fl3218_set_led_control_register(uint8_t index, bool value); | ||
|
||
void is31fl3218_update_pwm_buffers(void); | ||
|
||
void is31fl3218_update_led_control_registers(void); | ||
|
||
#define OUT1 0x01 | ||
#define OUT2 0x02 | ||
#define OUT3 0x03 | ||
#define OUT4 0x04 | ||
#define OUT5 0x05 | ||
#define OUT6 0x06 | ||
#define OUT7 0x07 | ||
#define OUT8 0x08 | ||
#define OUT9 0x09 | ||
#define OUT10 0x0A | ||
#define OUT11 0x0B | ||
#define OUT12 0x0C | ||
#define OUT13 0x0D | ||
#define OUT14 0x0E | ||
#define OUT15 0x0F | ||
#define OUT16 0x10 | ||
#define OUT17 0x11 | ||
#define OUT18 0x12 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters