HAL库stm32的AT24C02

### 使用 STM32 HAL 库与 AT24C02 EEPROM 进行通信

#### 初始化硬件配置
为了使STM32能够通过I2C协议访问AT24C02 EEPROM，需先设置好相应的外设参数。这通常借助于STM32CubeMX工具完成初始化工作，在该软件内指定要使用的I2Cx接口，并开启其时钟以及GPIO端口的配置。

// 假定已经在STM32CubeMX中完成了基本配置并生成了初始化代码

#### 定义全局变量和结构体
定义必要的全局变量来保存设备地址和其他可能需要用到的信息；同时创建一个`I2C_HandleTypeDef`类型的句柄对象用于后续调用HAL API函数。

#define EEPROM_DEVICE_ADDRESS  (0xA0 << 1) // 设备地址左移一位得到实际传输中的7位地址加上R/W标志位
extern I2C_HandleTypeDef hi2c1;

#### 编写读取函数
下面是一个简单的例子展示如何利用HAL库提供的API从特定位置开始连续读取多个字节的数据到缓冲区中：

/**
 * @brief Reads a block of data from the specified address in EEPROM.
 *
 * @param pBuffer Pointer to buffer that will hold read data.
 * @param ReadAddr Address within EEPROM memory where reading starts.
 * @param NumByteToRead Number of bytes to be read.
 */
void I2C_EEPROM_BufferRead(uint8_t* pBuffer, uint16_t ReadAddr, uint16_t NumByteToRead){
    HAL_StatusTypeDef status;

    /* Send START condition and write device address with WRITE flag */
    status = HAL_I2C_Mem_Read(&hi2c1,
                              EEPROM_DEVICE_ADDRESS,
                              ReadAddr,
                              I2C_MEMADD_SIZE_8BIT,
                              pBuffer,
                              NumByteToRead,
                              1000);
    
    if(status != HAL_OK){
        // Handle error here...
    }
}

#### 编写写入函数
同样地，这里给出一段用来向EEPROM内部某个起始地址处写入一定长度数据流的方法实现：

/**
 * @brief Writes a block of data into the specified address in EEPROM.
 *
 * @param pBuffer Pointer to source buffer containing data to be written.
 * @param WriteAddr Address within EEPROM memory where writing begins.
 * @param NumByteToWrite Number of bytes to be written.
 */
void I2C_EEPROM_BufferWrite(uint8_t* pBuffer, uint16_t WriteAddr, uint16_t NumByteToWrite){
    HAL_StatusTypeDef status;

    /* Send START condition and write device address with WRITE flag */
    status = HAL_I2C_Mem_Write(&hi2c1,
                               EEPROM_DEVICE_ADDRESS,
                               WriteAddr,
                               I2C_MEMADD_SIZE_8BIT,
                               pBuffer,
                               NumByteToWrite,
                               1000);

    if(status != HAL_OK){
        // Handle error here...
    }

    // Wait until completion or timeout occurs after issuing STOP bit automatically by hardware
    while(HAL_I2C_GetState(&hi2c1)!= HAL_I2C_STATE_READY){}
}

上述两个方法分别实现了对AT24C02 EEPROM的基本读写操作[^1]。需要注意的是，在真实的应用场景下还需要考虑更多的细节处理，比如错误检测机制、重试逻辑等以提高系统的鲁棒性和可靠性。