如何在树莓派上用Rust控制级联MAX7219 8×8 LED点阵屏？

一、MAX7219基础通信格式 #

• 单块MAX7219每次接收16位数据：高8位为寄存器地址，低8位为对应寄存器的写入值
• 4块级联场景下，每次需要连续发送4组16位数据（共8字节），数据传输顺序为：最先发送的16位会被传递到最远的第4块屏，最后发送的16位对应离SPI接口最近的第1块屏

二、必须完成的初始化配置 #

首次上电后需要依次给所有级联芯片写入以下配置寄存器，所有屏配置相同即可：

寄存器地址定义：

• 0x09：译码模式，点阵场景无需硬件译码，写入0x00
• 0x0A：显示亮度，取值范围0x00（最低）~0x0F（最高），可按需调整
• 0x0B：扫描行数，8x8屏需要扫描全部8行，写入0x07
• 0x0C：工作模式，退出关断进入正常工作写入0x01
• 0x0F：测试模式，关闭测试写入0x00

三、显示数据编码规则 #

• 行显示寄存器地址为0x01~0x08，分别对应点阵屏从上到下的第1行到第8行
• 写入行寄存器的8位数据对应当前行从左到右的8个像素状态，1代表点亮，0代表熄灭
• 整屏更新时，按行遍历：每次给4块屏发送同一行的地址+对应行的像素数据，连续发8次即可完成所有像素更新

四、修改后的Rust参考代码 #

use std::io;
use std::io::prelude::*;
use spidev::{Spidev, SpidevOptions, SpiModeFlags};

// 4块级联屏的像素缓存：[屏编号][行号]，屏0为最近的第一块，屏3为最远的第四块
type DisplayBuffer = [[u8;8];4];

fn main() -> io::Result<()> {
    let mut spi = create_spi()?;
    // 初始化所有MAX7219
    init_max7219(&mut spi)?;
    
    // 示例缓存：可以自行修改每个字节控制对应像素
    let mut buf: DisplayBuffer = [
        [0xFF,0x81,0x81,0x81,0x81,0x81,0x81,0xFF], // 屏0：显示方框
        [0x00,0x7E,0x42,0x42,0x7E,0x42,0x42,0x7E], // 屏1：显示H
        [0x00,0x3C,0x42,0x40,0x40,0x40,0x42,0x3C], // 屏2：显示C
        [0x00,0x7E,0x40,0x40,0x78,0x40,0x40,0x7E], // 屏3：显示E
    ];
    
    loop {
        update_display(&mut spi, &buf)?;
        // 这里可以添加缓存修改逻辑，实现动画等效果
    }
}

fn init_max7219(spi: &mut Spidev) -> io::Result<()> {
    // 给所有4块芯片写入相同的配置命令
    fn write_all_reg(spi: &mut Spidev, reg: u8, val: u8) -> io::Result<()> {
        let mut tx_buf = [0u8;8];
        for i in 0..4 {
            tx_buf[i*2] = reg;
            tx_buf[i*2 + 1] = val;
        }
        spi.write(&tx_buf)?;
        Ok(())
    }
    write_all_reg(spi, 0x0F, 0x00)?; // 关闭测试模式
    write_all_reg(spi, 0x09, 0x00)?; // 关闭译码
    write_all_reg(spi, 0x0B, 0x07)?; // 扫描全部8行
    write_all_reg(spi, 0x0A, 0x02)?; // 亮度设为2，可自行调整
    write_all_reg(spi, 0x0C, 0x01)?; // 进入正常工作模式
    Ok(())
}

fn update_display(spi: &mut Spidev, buf: &DisplayBuffer) -> io::Result<()> {
    // 逐行更新
    for row in 0..8 {
        let mut tx_buf = [0u8;8];
        // 按最远到最近的顺序填充4块屏的行数据
        for screen in 0..4 {
            let offset = (3 - screen) * 2; // 最远的屏3先传
            tx_buf[offset] = (row + 1) as u8; // 行地址是1~8
            tx_buf[offset + 1] = buf[screen][row];
        }
        spi.write(&tx_buf)?;
    }
    Ok(())
}

fn create_spi() -> io::Result<Spidev> {
    let mut spi = Spidev::open("/dev/spidev0.0")?;
    let options = SpidevOptions::new()
         .bits_per_word(8)
         .max_speed_hz(1_000_000) // MAX7219支持更高SPI速率，1Mhz完全没问题
         .mode(SpiModeFlags::SPI_MODE_0)
         .build();
    spi.configure(&options)?;
    Ok(spi)
}

内容的提问来源于stack exchange，提问作者Bruno Wallner