Microchip 23x SRAM/NVSRAM嵌入式hal SPI驱动程序

这是一个基于embedded-hal特质的平台无关Rust驱动程序，用于23x系列串行SRAM/NVSRAM SPI内存芯片。

查看介绍帖子。

此驱动程序允许您

• 从内存地址读取单个字节。请参阅：read_byte()。
• 从内存地址开始的32字节页。请参阅：read_page()。
• 从内存地址开始的N字节数组。请参阅：read_sequential()。
• 向内存地址写入单个字节。请参阅：write_byte()。
• 从内存地址开始的32字节页。请参阅：write_page()。
• 从内存地址开始的N字节数组。请参阅：write_sequential()。
• 通过管理HOLD引脚来启用和禁用传输。
• 获取/设置操作模式/状态寄存器。

阅读API文档以获取更多信息。

支持的设备

用法

在您的 Cargo.toml 中将 库 作为依赖项包含

[dependencies]
sram23x = "0.3.1"

一些示例用法

extern crate sram23x;
use sram23x::*;

fn main() {
    // 1. Ensure spi, cs, and hold pins are defined. hold pin is required (any unused output pin will do)
    // (device specific)

    // 2. Instantiate memory device 23LCV1024
    let mut sram = Sram23x::new(spi, cs, hold, device_type::M23xv1024).unwrap();

    // 3. Check the operating mode register
    println!("Operating mode register: {:?}", sram.mode);

    // 4. Change the operating mode to sequential
    sram.set_mode(OperatingMode::Sequential as u8).unwrap();
    assert_eq!(sram.mode, 0b01);

    // 5. Write 4 bytes of data starting at address 0x00 from a buffer
    let mut data: [u8; 4] = ['t' as u8, 'e' as u8, 's' as u8, 't' as u8];
    sram.write_sequential(0x00_u32, &mut data).unwrap();

    // 6. Read 4 bytes of data starting at address 0x00 into a buffer
    sram.read_sequential(0x00_u32, &mut data).unwrap();
    println!("Read data: {:?}", data);
    assert_eq!(data[0], 't' as u8);
    assert_eq!(data[1], 'e' as u8);
    assert_eq!(data[2], 's' as u8);
    assert_eq!(data[3], 't' as u8);

    // 7. Write and read 1 byte to/from address 0x04
    sram.set_mode(OperatingMode::Byte as u8).unwrap();
    assert_eq!(sram.mode, 0b00);
    sram.write_byte(0x04_u32, 'a' as u8).unwrap();
    let byte = sram.read_byte(0x04_u32).unwrap();
    println!("Read 1 byte: {:?}", byte);
    assert_eq!(byte, 'a' as u8);

    // 8. Write and read a 32-byte page starting at address 0x00
    sram.set_mode(OperatingMode::Page as u8).unwrap();
    assert_eq!(sram.mode, 0b10);
    let mut data = "Microchip\n1Mbit serial\nsram test".as_bytes();
    sram.write_page(0x00_u32, data).unwrap();
    let page = sram.read_page(0x00_u32).unwrap();
    println!("Read a 32-byte page: {:?}", page);
    assert_eq!(page[0], 'M' as u8);
    assert_eq!(page[31], 't' as u8);
}

待办事项

• 将 I/O 分离成它们自己的私有函数
• 添加测试
• 记录其他缺失的细节

贡献

如果您发现任何错误或问题，请 创建一个问题。

许可证

MIT 许可证

版权所有（c）2021 Alexander Williams，On-Prem [email protected]