qmk_firmware/keyboards/clueboard/2x1800/2021/max7219.c

319 lines
9.3 KiB
C

/*
* Copyright (c) 2021 Zach White <skullydazed@gmail.com>
* Copyright (c) 2007 Eberhard Fahle
*
* max7219.c - A library for controling Leds with a MAX7219/MAX7221
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* This permission notice shall be included in all copies or
* substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*/
/*
* This driver started as a port of Arduino's LedControl to QMK. The
* original Arduino code can be found here:
*
* https://github.com/wayoda/LedControl
*
* Unlike LedControl we are using the native SPI support, you will need to
* use the native SPI pins for your MCU. You can set the CS pin with
* `#define MAX7219_LOAD <pin>`.
*
* This has only been tested on AVR, specifically a Teensy 2.0++.
*/
#include "max7219.h"
#include "font.h"
// Datastructures
bool max7219_led_scrolling = true;
uint16_t max7219_buffer_end = 0;
uint8_t max7219_spidata[MAX_BYTES];
uint8_t max7219_led_a[8][MAX7219_BUFFER_SIZE];
/* Write max7219_spidata to all the max7219's
*/
void max7219_write_all(void) {
dprintf("max7219_write_all()\n");
if (spi_start(MAX7219_LOAD, false, 0, 8)) {
for(int i = MAX_BYTES; i>0; i--) {
dprintf("spi_write(%d)\n", max7219_spidata[i-1]);
spi_write(max7219_spidata[i-1]);
}
spi_stop();
} else {
xprintf("Could not spi_start!\n");
}
}
/* Write the current frame in max7219_led_a to all the max7219's
*/
void max7219_write_frame(void) {
dprintf("max7219_write_frame()\n");
// Set our opcode and data
for (int col=0; col<8; col++) {
for (int device_num=0; device_num<MAX7219_CONTROLLERS; device_num++) {
int offset=device_num*2;
max7219_spidata[offset] = max7219_led_a[col][device_num];
max7219_spidata[offset+1] = col+1;
}
max7219_write_all();
}
}
/* Stores a message in the sign buffer.
*
* message should be a 2d array with the outer array having a length of your
* message and the inner array having a length of 6. Use the CHR_<letter>
* macros from font.h to populate your array.
*
* Example:
*
* uint8_t message[10][6] = {CHR_INTERROBANG, CHR_C, CHR_l, CHR_u, CHR_e, CHR_b, CHR_o, CHR_a, CHR_r, CHR_d};
* max7219_message(message, 10);
*/
void max7219_message_sign(uint8_t message[][6], size_t message_len) {
uint8_t letter_num = 0;
uint8_t letter_col = 0;
max7219_buffer_end = message_len * 6 + 32;
for (int device_num=0; device_num<MAX7219_BUFFER_SIZE; device_num++) {
for (int col=0; col<8; col++) {
if (letter_num >= message_len) {
max7219_led_a[col][device_num] = 0b00000000;
} else {
max7219_led_a[col][device_num] = message[letter_num][letter_col];
if (letter_col == 5) {
letter_num++;
letter_col = 0;
} else {
letter_col++;
}
}
}
}
max7219_write_frame();
}
/* Scroll the content on the sign left by 1 column.
*
* When loop_message is true columns that slide off the left will be added
* to the right to be displayed again.
*/
void max7219_message_sign_task(bool loop_message) {
uint8_t left_col = 0b00000000;
if (!max7219_led_scrolling) {
return;
}
if (loop_message) {
left_col = max7219_led_a[0][0];
}
int i=0;
for (int device_num=0; device_num<MAX7219_BUFFER_SIZE; device_num++) {
for (int col=0; col<8; col++) {
i++;
if (i == max7219_buffer_end) {
max7219_led_a[col][device_num] = left_col;
device_num=MAX7219_BUFFER_SIZE;
break;
} else if (col < 7) {
max7219_led_a[col][device_num] = max7219_led_a[col+1][device_num];
} else if (device_num == MAX7219_BUFFER_SIZE-1) {
max7219_led_a[col][device_num] = left_col;
} else {
max7219_led_a[col][device_num] = max7219_led_a[0][device_num+1];
}
}
}
max7219_write_frame();
}
/* Write data to a single max7219
*/
void max7219_write(int device_num, volatile uint8_t opcode, volatile uint8_t data) {
dprintf("max7219_write(%d, %d, %d)\n", device_num, opcode, data);
// Clear the data array
for(int i = MAX_BYTES; i>0; i--) {
max7219_spidata[i-1]=0;
}
// Set our opcode and data
uint8_t offset = device_num*2;
max7219_spidata[offset] = data;
max7219_spidata[offset+1] = opcode;
// Write the data
max7219_write_all();
}
/* Turn off all the LEDs
*/
void max7219_clear_display(void) {
dprintf("max7219_clear_display();\n");
for (int col=0; col<8; col++) {
for (int device_num=0; device_num<MAX7219_BUFFER_SIZE; device_num++) {
max7219_led_a[col][device_num] = 0b00000000;
}
}
max7219_write_frame();
}
/* Enable the display test (IE turn on all 64 LEDs)
*/
void max7219_display_test(int device_num, bool enabled) {
dprintf("max7219_display_test(%d, %d);\n", device_num, enabled);
if (device_num<0 || device_num >= MAX7219_CONTROLLERS) {
return;
}
max7219_write(device_num, OP_DISPLAYTEST, enabled);
}
/* Initialize the max7219 system and set the controller(s) to a default state.
*/
void max7219_init(void) {
wait_ms(1500);
dprintf("max7219_init()\n");
setPinOutput(MAX7219_LOAD);
writePinHigh(MAX7219_LOAD);
spi_init();
for (int i=0; i<MAX7219_CONTROLLERS; i++) {
max7219_shutdown(i, true);
}
for (int i=0; i<MAX7219_CONTROLLERS; i++) {
// Reset everything to defaults and enable the display
max7219_display_test(i, false);
max7219_set_scan_limit(i, 7);
max7219_set_decode_mode(i, 0);
max7219_set_intensity(i, MAX7219_LED_INTENSITY);
}
max7219_clear_display();
#ifndef MAX7219_NO_STARTUP_TEST
for (int i=0; i<MAX7219_CONTROLLERS; i++) {
// Test this display
max7219_display_test(i, true);
wait_ms(75);
max7219_display_test(i, false);
}
#endif
for (int i=0; i<MAX7219_CONTROLLERS; i++) {
max7219_shutdown(i, false);
}
}
/* Set the decode mode of the controller. You probably don't want to change this.
*/
void max7219_set_decode_mode(int device_num, int mode) {
dprintf("max7219_set_decode_mode(%d, %d);\n", device_num, mode);
if (device_num<0 || device_num >= MAX7219_CONTROLLERS) {
return;
}
max7219_write(device_num, OP_DECODEMODE, mode);
}
/* Set the intensity (brightness) for the LEDs.
*/
void max7219_set_intensity(int device_num, int intensity) {
dprintf("max7219_set_intensity(%d, %d);\n", device_num, intensity);
if (device_num<0 || device_num >= MAX7219_CONTROLLERS) {
return;
}
if (intensity >= 0 && intensity<16) {
max7219_write(device_num, OP_INTENSITY, intensity);
}
}
/* Control a single LED.
*/
void max7219_set_led(int row, int column, bool state) {
dprintf("max7219_set_led(%d, %d, %d);\n", row, column, state);
if (column<0 || column>8*MAX7219_CONTROLLERS) {
xprintf("max7219_set_led: column (%d) out of bounds\n", column);
return;
}
if (row<0 || row>7) {
xprintf("max7219_set_led: row (%d) out of bounds\n", row);
return;
}
/* At this point we reverse the sense of row and column to match the
* physical layout of my LEDs.
*/
uint8_t device_num = column / 8;
uint8_t col = column % 8;
uint8_t val = 0b10000000 >> row;
if (state) {
max7219_led_a[col][device_num] = max7219_led_a[col][device_num]|val;
} else {
val = ~val;
max7219_led_a[col][device_num] = max7219_led_a[col][device_num]&val;
}
max7219_write(device_num, col+1, max7219_led_a[col][device_num]);
}
/* Set the number of digits (rows) to be scanned.
*/
void max7219_set_scan_limit(int device_num, int limit) {
dprintf("max7219_set_scan_limit(%d, %d);\n", device_num, limit);
if (device_num<0 || device_num >= MAX7219_CONTROLLERS) {
return;
}
if (limit >= 0 && limit < 8) {
max7219_write(device_num, OP_SCANLIMIT, limit);
}
}
/* Enable (true) or disable (false) the controller.
*/
void max7219_shutdown(int device_num, bool shutdown) {
dprintf("max7219_shutdown(%d, %d);\n", device_num, shutdown);
if (device_num<0 || device_num >= MAX7219_CONTROLLERS) {
return;
}
max7219_write(device_num, OP_SHUTDOWN, !shutdown);
}