STM32F4 I2C驱动函数调用失败问题排查求助

首先贴出你的代码方便参考：

/**************************************************************************************************************************************
 * @brief  :    Function writes an 8-bit data to sensor's register
 *
 * @param1 :    I2C HandleTypedef structure that handles the I2C slave device
 * @param2 :    Slave device's address
 * @param3 :    The base register address in order to be write.
 * @param4 :    The 8-bit data that desired to be written
 *
 * @return :    Returns PROCESS_OK which is defined as 1
 *      Returns PROCESS_FAIL which is defined as 0 and calls Error_Writing function
 **************************************************************************************************************************************/
process_stat_t Sensor_WriteByte_ToReg(I2C_HandleTypeDef *p_hi2c, uint8_t device_addr, uint8_t base_reg_addr, uint8_t data)
{

    if(HAL_OK == HAL_I2C_Mem_Write(p_hi2c, device_addr, base_reg_addr, 1, &data, 1, I2C_TIMEOUT))
    {
        return PROCESS_OK;
    }
    else
    {
        Error_Writing(); // red led blinks 3 times
        return PROCESS_FAIL;
    }

}

以下是具体排查点：

• 设备地址格式错误
  HAL库的HAL_I2C_Mem_Write要求传入的device_addr是7位地址左移一位后的值（最低位会被HAL自动用作读写位，写操作时置0）。如果直接传入传感器手册上的7位地址（比如0x48）而未左移，实际发送的I2C地址会不符合设备要求，导致无响应。检查device_addr是否为7位地址 << 1，比如手册地址0x48，应传入0x90。

• 寄存器地址宽度不匹配
  HAL_I2C_Mem_Write的第四个参数MemAddSize你传的是1，对应I2C_MEMADD_SIZE_8BIT，但如果传感器使用16位宽度的寄存器地址，这个参数就会出错。查看传感器 datasheet，确认寄存器地址是8位还是16位，若为16位，需将该参数改为2（对应I2C_MEMADD_SIZE_16BIT）。

• 超时时间设置过短
  检查I2C_TIMEOUT宏的定义值，若设置过小（比如10ms），可能因I2C通信延迟导致超时返回HAL_TIMEOUT。先临时将超时值调大到1000ms测试，看是否能成功。

• 硬件连接问题

  • 确认SDA、SCL引脚未接反，且焊接/插线接触良好
  • I2C总线必须接4.7k~10k的上拉电阻，若无拉电阻，总线电平不稳定会导致通信失败
  • 检查传感器供电电压是否符合规格，供电不足或电压错误会导致设备无法响应

• I2C外设配置错误

  • 检查CubeMX中I2C的时钟频率是否符合传感器要求，比如传感器仅支持100kHz标准模式，却配置成400kHz快速模式，会导致通信失败
  • 确认I2C外设配置为主模式，而非从模式
  • 检查引脚复用是否正确，避免I2C引脚被其他外设占用

• 传感器状态异常

  • 部分传感器需要先发送唤醒指令才能进入可操作状态，若传感器处于休眠模式，会不响应I2C写请求
  • 确认base_reg_addr是传感器支持的合法寄存器地址，写入不存在的地址会导致设备无响应

• 句柄参数错误
  检查传入的p_hi2c指针是否指向正确的I2C外设句柄，若系统中有多个I2C外设，传错句柄会导致操作的I2C总线与传感器连接的总线不匹配

内容的提问来源于stack exchange，提问作者doguu