# Driver_M24Cxx（可移植 EEPROM 驱动）

这是一个面向 M24Cxx / AT24Cxx 系列 EEPROM 的可移植驱动模块。

核心特性：

- 不依赖特定 MCU/SDK（不绑定 STM32 HAL）
- 支持页写自动拆分
- 通过回调适配底层总线

## 目录结构

- `module/Int_EEPROM24xx.h`：驱动接口定义
- `module/Int_EEPROM24xx.c`：驱动实现
- `examples/adapter_template.c`：适配层模板

## 你需要实现的 3 个函数

移植时，你只需要实现这三个底层函数，然后在配置结构体里挂接：

1. `bus_read`：从 EEPROM 读数据
2. `bus_write`：向 EEPROM 写数据
3. `delay_ms`：毫秒延时

> 这也是本仓库提交信息里的重点：**需要自己实现读、写、延时这三个函数**。

## 快速接入

### 1) 将模块加入工程

把以下文件加入你的工程：

- `module/Int_EEPROM24xx.h`
- `module/Int_EEPROM24xx.c`

### 2) 实现底层适配函数

参考 `examples/adapter_template.c`，按你的平台替换 I2C 读写与延时实现。

### 3) 初始化设备描述并调用 API

```c
static const IntEEPROM24xx_t g_eeprom = {
    .ctx = your_bus_context,
    .dev_addr = (0x50u << 1),
    .page_size = 8u,
    .mem_addr_size = 1u,
    .write_cycle_ms = 6u,
    .timeout_ms = 100u,
    .bus_read = your_bus_read,
    .bus_write = your_bus_write,
    .delay_ms = your_delay_ms,
};

Int_EEPROM24xx_Read(&g_eeprom, 0x00, rx_buf, sizeof(rx_buf));
Int_EEPROM24xx_Write(&g_eeprom, 0x00, tx_buf, sizeof(tx_buf));
```

## 参数说明

- `dev_addr`：设备地址（7bit 或左移后地址，取决于你的底层驱动规范）
- `page_size`：页大小（必须与芯片手册一致）
- `mem_addr_size`：地址字节数（1 或 2）
- `write_cycle_ms`：每次页写后的写周期等待

## 常见问题

- 写入失败：优先检查 `page_size` 和 `write_cycle_ms`
- 读写偏移错乱：检查 `mem_addr_size`（1 字节 / 2 字节）
- 跨平台报错：说明底层回调未按目标 SDK 正确实现