mcp794xx 0.3.0

Platform-agnostic Rust driver for the MCP794xx real-time clock / calendar (RTC) family. Compatible with MCP7940N, MCP7940M, MCP79400, MCP79401, MCP79402, MCP79410, MCP79411 and MCP79412.
Documentation
use super::super::interface;
use super::super::{Error, Mcp794xx};

impl<DI, E, IC> Mcp794xx<DI, IC>
where
    DI: interface::WriteData<Error = Error<E>> + interface::ReadData<Error = Error<E>>,
{
    /// Read a single byte from an address.
    ///
    /// Valid addresses are from 0x20 to 0x5F. Otherwise an
    /// Error::InvalidInputData will be returned.
    pub fn read_sram_byte(&mut self, address: u8) -> Result<u8, Error<E>> {
        if !Self::address_valid(address) {
            return Err(Error::InvalidInputData);
        }
        self.iface.read_register(address)
    }

    /// Write a single byte to an address.
    ///
    /// Valid addresses are from 0x20 to 0x5F. Otherwise an
    /// Error::InvalidInputData will be returned.
    pub fn write_sram_byte(&mut self, address: u8, data: u8) -> Result<(), Error<E>> {
        if !Self::address_valid(address) {
            return Err(Error::InvalidInputData);
        }
        self.iface.write_register(address, data)
    }

    /// Read SRAM starting in an address as many bytes as necessary to fill
    /// the data array provided.
    pub fn read_sram_data(&mut self, address: u8, data: &mut [u8]) -> Result<(), Error<E>> {
        if !Self::address_valid(address) || data.len() > 64 || (data.len() as u8 + address) > 0x60 {
            return Err(Error::InvalidInputData);
        }
        self.iface.read_data(address, data)
    }

    /// Write data array to SRAM starting in an address.
    pub fn write_sram_data(&mut self, address: u8, data: &[u8]) -> Result<(), Error<E>> {
        if !Self::address_valid(address) || data.len() > 64 || (data.len() as u8 + address) > 0x60 {
            return Err(Error::InvalidInputData);
        }
        let mut payload = [0; 65]; // max size
        payload[0] = address;
        payload[1..=data.len()].copy_from_slice(data);
        self.iface.write_data(&payload[..=data.len()])
    }

    #[allow(clippy::manual_range_contains)]
    fn address_valid(address: u8) -> bool {
        address >= 0x20 && address <= 0x5F
    }
}

impl<DI, E, IC> Mcp794xx<DI, IC>
where
    DI: interface::ReadCurrent<Error = Error<E>>,
{
    /// Read a single byte from the current address.
    ///
    /// The current address corresponds to the last accessed address
    /// (including addresses accessed in EEPROM) incremented by 1.
    pub fn read_sram_current_byte(&mut self) -> Result<u8, Error<E>> {
        self.iface.read()
    }
}