Repository files navigation

This is a platform agnostic Rust driver for the 24x series serial EEPROM,based on theembedded-hal traits.

This driver allows you to:

• Read a single byte from a memory address. See:read_byte().
• Read a byte array starting on a memory address. See:read_data().
• Read the current memory address (please read notes). See:read_current_address().
• Write a byte to a memory address. See:write_byte().
• Write a byte array (up to a memory page) to a memory address. See:write_page().
• ReadCSx-variant devices' factory-programmed unique serial. See:read_unique_serial().
• Use the device in generic code via theEeprom24xTrait.

Can be used at least with the devices listed below.

Introductory blog post

These devices provides a number of bits of serial electrically erasable andprogrammable read only memory (EEPROM) organized as a number of words of 8 bitseach. The devices' cascadable feature allows up to 8 devices to share a common2-wire bus. The devices are optimized for use in many industrial and commercialapplications where low power and low voltage operation are essential.

To use this driver, import this crate and anembedded_hal implementation,then instantiate the appropriate device.In the following examples an instance of the device AT24C256 will be createdas an example. Other devices can be created with similar methods like:Eeprom24x::new_24x64(...).

Please find additional examples using hardware in this repository:driver-examples

use eeprom24x::{Eeprom24x,SlaveAddr};use embedded_hal::blocking::delay::DelayMs;use linux_embedded_hal::{Delay,I2cdev};fnmain(){let dev =I2cdev::new("/dev/i2c-1").unwrap();let address =SlaveAddr::default();letmut eeprom =Eeprom24x::new_24x256(dev, address);let memory_address =0x1234;let data =0xAB;    eeprom.write_byte(memory_address, data).unwrap();Delay.delay_ms(5u16);let read_data = eeprom.read_byte(memory_address).unwrap();println!("Read memory address: {}, retrieved content: {}",        memory_address,&read_data);let _dev = eeprom.destroy();// Get the I2C device back}

To enabledefmt (version0.3.x) support, when specifying the dependency oneeprom24x, add the feature "defmt-03".

[dependencies]eeprom24x = {version ="0.7.2",features = ["defmt-03"] }

For questions, issues, feature requests, and other changes, please file anissue in the github project.

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE orhttp://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT orhttp://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submittedfor inclusion in the work by you, as defined in the Apache-2.0 license, shallbe dual licensed as above, without any additional terms or conditions.