介绍AT24CXX软件包的基本读写功能

1 介绍

AT24CXX 软件包提供了 at24cxx 系列 EEPROM 基本功能。介绍该软件包的基本读写功能，以及Finsh/MSH测试命令等。目前已在 at24512 验证通过。

1.1 目录结构

1.2 许可证

AT24CXX 遵循 Apache-2.0 许可，参见 LICENSE 文件。

1.3 依赖

驱动设备依赖RT-Thread I2C框架。

2 摄取

使用at24cxx包需要在RT-Thread管理器中选择具体路径如下：

功能的配置说明如下：

at24cxx: ee2prom at24cxx driver library：选择使用at24cxx套餐；

Version：配置版本，默认最新版本。

然后让 RT-Thread 的包管理器自动更新，或者使用pkgs --update命令更新包到 BSP 中。

3 使用 at24cxx 巧克力

按照前文介绍，获取at24cxx后，就可以按照 ee2prom 提供的 API 使用以下at24cxx 与 内容进行测试，详细。

3.1 接口

3.1.1 初始化

at24cxx_device_t at24cxx_init(const char *i2c_bus_name)

根据设备名称，自动赋予设备名称2，并根据具体参数与返回说明表4CXX

3.1.2 反初始化

无效 at24cxx_deinit（aht10_device_t 开发）

如果设备不再使用，反初始化将在24cxx设备的相关资源中回收，具体参数说明如下表

3.1.3 读取

rt_err_t at24cxx_read(struct rt_i2c_bus_device *bus,uint16_t ReadAddr,uint8_t *pBuffer,uint16_t NumToRead)

通过at24cxx读取eeprom，在AT24CXX里面的指定地址开始写入指定个数的数据，具体参数返回说明如下表

3.1.4 写入

rt_err_t at24cxx_write(struct rt_i2c_bus_device *bus,uint16_t WriteAddr,uint8_t *pBuffer,uint16_t NumToWrite)

at24cxx通过写入，在 AT24CXX 里面的指定地址开始写入指定个数的数据，具体参数和返回说明如下表

3.1.5 查看设备

rt_err_t at24cxx_check(struct rt_i2c_bus_device *bus)

查看是否存在eeprom设备，通过在最后一个字节写入标志位，进行判断，具体参数与返回说明如下表

3.2 Finsh/MSH 测试命令

at24cxx 传感器提供了丰富的测试命令，项目只要在 RT-开启 Finsh/MSH 功能即可。在做一些基于应用程序at24cxx开发、调试时，这些命令会非常实用，它可以准确的指点测量的温度与控制。具体功能可以输入at24cxx，可以查看完整的命令列表

3.2.1 在指定的i2c上感应传感器

当第一次使用这个at24cxx命令的时候，它会为指定的 i2c 分配，例如不会提示：i2c0 at24cxx probe <dev_name>。<dev_name>如下：

4 注意事项

请在at24cxx.h中修改EE_TYPE为自己使用的型号(默认为AT25C512)。

请在at24cxx.h中修改EE_TWR为自己使用EEPROM的Write Cycle Time，具体值请查看芯片datasheet(默认为5ms)。

从设备地址为7位地址0x50，而不是0xA0。

原作者：cw339004111