103 lines
3.2 KiB
C
103 lines
3.2 KiB
C
/*
|
||
* 模块名称：AT24C02 EEPROM 驱动
|
||
* 模块功能：提供AT24C02的读写操作接口，基于STM32 HAL I2C
|
||
* 适用平台：STM32F103C8T6
|
||
* 作者：王建锋
|
||
* 创建日期：2026-07-14
|
||
* 修改记录：
|
||
* 2026-07-14 王建锋 创建初始版本
|
||
*/
|
||
|
||
#ifndef __AT24C02_H
|
||
#define __AT24C02_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include "main.h"
|
||
|
||
/* AT24C02 器件参数 */
|
||
#define AT24C02_ADDR_WRITE 0xA0 /* 写设备地址 (A2=A1=A0=GND) */
|
||
#define AT24C02_ADDR_READ 0xA1 /* 读设备地址 */
|
||
#define AT24C02_SIZE 256 /* 总字节数 */
|
||
#define AT24C02_PAGE_SIZE 8 /* 页大小 */
|
||
#define AT24C02_PAGE_NUM 32 /* 总页数 */
|
||
#define AT24C02_I2C_TIMEOUT 100 /* I2C 通讯超时 (ms) */
|
||
|
||
/* AT24C02 操作返回值 */
|
||
#define AT24C02_OK 0 /* 操作成功 */
|
||
#define AT24C02_ERR_DEVICE -1 /* 设备未响应 */
|
||
#define AT24C02_ERR_I2C -2 /* I2C通讯错误 */
|
||
#define AT24C02_ERR_TIMEOUT -3 /* 写周期超时 */
|
||
#define AT24C02_ERR_PARAM -4 /* 参数错误 */
|
||
|
||
/*
|
||
* 函数功能：检测AT24C02设备是否存在
|
||
* 入口参数：无
|
||
* 返回值： 0=检测到设备，-1=未响应
|
||
* 函数说明：通过I2C发送设备地址，检查是否有ACK应答
|
||
*/
|
||
int at24c02_scan(void);
|
||
|
||
/*
|
||
* 函数功能：AT24C02字节写入
|
||
* 入口参数：addr - 目标地址（0~255）
|
||
* data - 要写入的数据
|
||
* 返回值： 0=成功，负值=错误码
|
||
* 函数说明：先发送写命令，再等待内部写周期完成
|
||
*/
|
||
int at24c02_write_byte(uint8_t addr, uint8_t data);
|
||
|
||
/*
|
||
* 函数功能：AT24C02随机读取
|
||
* 入口参数：addr - 目标地址（0~255）
|
||
* 返回值：>=0=读取的数据，负值=错误码
|
||
* 函数说明：假写操作设定地址，再重新发送读命令读取
|
||
*/
|
||
int at24c02_read_byte(uint8_t addr);
|
||
|
||
/*
|
||
* 函数功能：AT24C02页写入（不超过页边界）
|
||
* 入口参数：addr - 起始地址（0~255）
|
||
* p_data - 数据缓冲区指针
|
||
* len - 写入长度（≤8）
|
||
* 返回值： 0=成功，负值=错误码
|
||
* 函数说明：页写入，自动等待写周期完成
|
||
*/
|
||
int at24c02_write_page(uint8_t addr, const uint8_t *p_data, uint8_t len);
|
||
|
||
/*
|
||
* 函数功能：AT24C02连续写入（跨页自动拆分）
|
||
* 入口参数：addr - 起始地址（0~255）
|
||
* p_data - 数据缓冲区指针
|
||
* len - 写入长度
|
||
* 返回值： 0=成功，负值=错误码
|
||
* 函数说明：自动处理跨页边界，逐页写入
|
||
*/
|
||
int at24c02_write_buf(uint8_t addr, const uint8_t *p_data, uint16_t len);
|
||
|
||
/*
|
||
* 函数功能：AT24C02连续读取
|
||
* 入口参数：addr - 起始地址（0~255）
|
||
* p_buf - 接收缓冲区指针
|
||
* len - 读取长度
|
||
* 返回值： 0=成功，负值=错误码
|
||
* 函数说明：从指定地址开始顺序读取多个字节
|
||
*/
|
||
int at24c02_read_buf(uint8_t addr, uint8_t *p_buf, uint16_t len);
|
||
|
||
/*
|
||
* 函数功能：等待内部写周期完成（应答查询）
|
||
* 入口参数：无
|
||
* 返回值： 0=完成，-3=超时
|
||
* 函数说明：发送设备地址（写模式），直到器件应答
|
||
*/
|
||
int at24c02_wait_ready(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* __AT24C02_H */
|