/* * Copyright (c) 2021 Zach White * 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 `. * * This has only been tested on AVR, specifically a Teensy 2.0++. */ #include "max7219.h" #include "spi_master.h" #include "debug.h" #include "gpio.h" #include "wait.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 * 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= 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_num0; 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_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) { 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); }