#led-driver #ic #max7219 #platform #devices

max7219-driver

This crate provides a platform agnostic driver for the MAX7219 LED Driver IC

3 unstable releases

0.2.2 Oct 22, 2022
0.2.1 Oct 22, 2022
0.2.0 Oct 22, 2022
0.1.1 Oct 11, 2022
0.1.0 Oct 11, 2022

#806 in Hardware support

Download history 46/week @ 2024-06-29 56/week @ 2024-07-27

100 downloads per month

MIT/Apache

28KB
331 lines

This crate provides a platform agnostic driver for the MAX7219 LED Driver IC.

This driver was built using the embedded-hal traits.

Usage

Single MAX7219 Device

An updated version of the library should be available on crates.io. Add the following to your Cargo.toml to get is a dependency.

[dependencies]
max7219-driver = "*"

Instantiating

Create an instance of the driver with the new method, by passing SPI and Output pin instances.

use max7219-driver::MAX7219;
let spi = // SPI instantiation code
let cs = // Output pin instantiation code
let mut max7219 = MAX7219::new(spi, cs).unwrap();

Initializing

Initialize the driver instance with the init_display method. A boolean needs to be specified to indicate whether to clear the display after init or not.

 max7219.init_display(true);

Cascading Multiple MAX7219 Devices

If you are cascading multiple devices that are driving 8x8 LED Dot Matrices instead use the MAX7219LedMat driver as follows:

Instantiating

use max7219-driver::MAX7219LedMat;
let spi = // SPI instantiation code
let cs = // Output pin instantiation code
let mut max7219: MAX7219LedMat<_, _, BUFLEN, COUNT> = MAX7219LedMat::new(spi, cs).unwrap();

BUFLEN should be replaced with value equivalent to the total number of pixels/LED in the cascaded displays and COUNT with the number of displays

Example:

If four displays are cascaded then BUFLEN should be replaced with 256 (= 8 x 8 x 4) and COUNT replaced with 4 resulting in

let mut max7219: MAX7219LedMat<_, _, 256, 4> = MAX7219LedMat::new(spi, cs).unwrap();

Initializing

Exactly the same as earlier, the new driver takes care of initializing all the cscaded displays.

max7219.init_display(true);

Dependencies

~5MB
~71K SLoC