max7219

Crates.iomax7219
lib.rsmax7219
version0.4.2
sourcesrc
created_at2019-06-16 14:56:45.345049
updated_at2023-12-13 20:00:13.440482
descriptionA platform agnostic driver to interface the MAX7219 (LED driver)
homepage
repositoryhttps://github.com/almindor/max7219
max_upload_size
id141555
size27,747
Aleš Katona (almindor)

documentation

https://docs.rs/max7219

README

max7219

A platform agnostic driver to interface with the MAX7219 (LED display driver)

Build Status

What works

  • Powering on/off the MAX chip
  • Basic commands for setting LEDs on/off.
  • Chaining support (max 8 devices)
  • Hardware SPI support (with or without CS pin)

Changelog

Example

Example projects are at this repo

Here is a simple example for using the MAX7219 on a hifive1-revb device with e310x_hal:

#![no_std]
#![no_main]

extern crate panic_halt;

use riscv_rt::entry;
use hifive1::hal::prelude::*;
use hifive1::hal::DeviceResources;
use hifive1::pin;
use max7219::*;

#[entry]
fn main() -> ! {
    let dr = DeviceResources::take().unwrap();
    let p = dr.peripherals;
    let gpio = dr.pins;

    // Configure clocks
    hifive1::clock::configure(p.PRCI, p.AONCLK, 320.mhz().into());
    
    let data = pin!(gpio, spi0_mosi).into_output();
    let sck = pin!(gpio, spi0_sck).into_output();
    let cs = pin!(gpio, spi0_ss0).into_output();

    let mut display = MAX7219::from_pins(1, data, cs, sck).unwrap();

    // make sure to wake the display up
    display.power_on().unwrap();
    // write given octet of ASCII characters with dots specified by 3rd param bits
    display.write_str(0, b"pls help", 0b00100000).unwrap();
    // set display intensity lower
    display.set_intensity(0, 0x1).unwrap();

    loop {}
}

Credits

Original work by Maikel Wever. Adapted to latest embedded-hal and documented by Ales Katona.

License

Licensed under MIT license (LICENSE or http://opensource.org/licenses/MIT)

Commit count: 58

cargo fmt