STM32 I2C总线锁死原因及解决方法

本文介绍STM32 I2C总线锁死原因及解决方法。

在使用STM32 I2C总线操作外设时，有时会遇到I2C总线锁死（I2C总线为Busy状态）的问题，即便复位MCU也无法解决，本文介绍其锁死的原因和解决方法，并给出相应的参考代码。

1.故障现象

在I2C总线锁死时，使用示波器测量发现，SCL为高电平，SDA为低电平。

1)MCU操作I2C总线（读/写）时复位MCU（通过复位按键操作）比较容易再现。

2)MCU操作I2C总线（读/写）时，强制将SDA拉低（用金属摄子夹到地，并持续一段时间）会再现。

3)设想，MCU操作I2C总线过程中，SDA受外界干扰（毛刺）被拉低，也可能导致I2C总线锁死。

2.原因

1)I2C总线被设计成多主机可共享总线，这会导致总线竞争，主设备判断当前总线被占用是根据SDA线为低来判断的。当主设备检测到总线被占用，则指示总线忙，并无法操作总线。

2)主设备操作从设备（读/写）时，复位主设备，如果恰好从设备处于ACK状态（SDA拉低）或回复主设备数据位0，那么在复位完成，主设备重新接管总线时，会错误的认为总线忙，因为此时从设备并未复位，SDA仍然被拉低。从设备等待主设备拉低SCL取走ACK或者数据位0，而主设备等待从设备释放SDA。主设备和从设备互相等待，进入死锁状态。值的注意的时，对于故障现象2)，STM32 I2C内部似乎有超时机制，如果SDA被拉低持续一段时间，则无法恢复。

3.解决方法

1)硬件复位

直接硬件复位外部从设备，比如通过MOS管软开关从设备电源，或通过外部设备硬件复位脚（从设备有才行）复位。

2)软件复位

情况1：

出现I2C总线锁死时正好外设回复数据位0，则需经历小于9个SCL时钟，从设备会释放SDA。

情况2：

出现I2C总线锁死时正好外设ACK，则经历9个SCL时钟，从设备会释放SDA。

综合情况1，2可知，通过软件复位解决时，当检测到总线锁死（BUSY状态），可以生成9个SCL时钟，并不断检测SDA引脚电平状态，若SDA被释放（为高）则退出，主机重新初始化I2C总线。Software Rest如下图。

I2C-bus specification中：

3)某些I2C缓冲器提供I2C总线错误恢复功能（如LTC4307）。

4.参考代码

参考代码如下（这里以STM32F4xx平台为例，其它平台类似）：

DrvI2C1.h:

#ifndef __DRV_I2C1_H
#define __DRV_I2C1_H


#ifdef __cplusplus
 extern "C" {
#endif 
     

#include "datatype.h"
#include "stm32f4xx_hal.h"


#define I2C1_SCL_GPIO_PORT     (GPIOB)
#define I2C1_SCL_PIN           (GPIO_PIN_6)

#define I2C1_SDA_GPIO_PORT     (GPIOB)
#define I2C1_SDA_PIN           (GPIO_PIN_7)


extern I2C_HandleTypeDef hi2c1;


extern int32_t I2C1_Init(void);
     
     
#ifdef __cplusplus
}
#endif




#endif

DrvI2C1.c:

#include "DrvI2C1.h"


I2C_HandleTypeDef hi2c1;


static void I2C1_MspInit(I2C_HandleTypeDef* i2cHandle);
static void I2C1_MspDeInit(I2C_HandleTypeDef* i2cHandle);
static BOOL I2C1_Unlock(void);
static void I2C1_SetPortODOutput(void);


int32_t I2C1_Init(void)
{
    if (!I2C1_Unlock())
    {
        DbgPrint("I2C1 unlock failed!\r\n");
    }

    if (HAL_I2C_RegisterCallback(&hi2c1, HAL_I2C_MSPINIT_CB_ID, I2C1_MspInit) != HAL_OK)
    {
        Error_Handler();
    }

    hi2c1.Instance = I2C1;
    hi2c1.Init.ClockSpeed = 200000;
    hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
    hi2c1.Init.OwnAddress1 = 0;
    hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
    hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
    hi2c1.Init.OwnAddress2 = 0;
    hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
    hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;
    if (HAL_I2C_Init(&hi2c1) != HAL_OK)
    {
        Error_Handler();
    }

    if (HAL_I2C_RegisterCallback(&hi2c1, HAL_I2C_MSPDEINIT_CB_ID, I2C1_MspDeInit) != HAL_OK)
    {
        Error_Handler();
    }

    return 0;
}


static void I2C1_MspInit(I2C_HandleTypeDef* i2cHandle)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOB_CLK_ENABLE();

    /**I2C1 GPIO Configuration
    PB6     ------> I2C1_SCL
    PB7     ------> I2C1_SDA
    */
    GPIO_InitStruct.Pin = I2C1_SCL_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;
    HAL_GPIO_Init(I2C1_SCL_GPIO_PORT, &GPIO_InitStruct);

    GPIO_InitStruct.Pin = I2C1_SDA_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;
    HAL_GPIO_Init(I2C1_SDA_GPIO_PORT, &GPIO_InitStruct);

    /* I2C1 clock enable */
    __HAL_RCC_I2C1_CLK_ENABLE();
}


static void I2C1_MspDeInit(I2C_HandleTypeDef* i2cHandle)
{
    /* Peripheral clock disable */
    __HAL_RCC_I2C1_CLK_DISABLE();

    /**I2C1 GPIO Configuration
    PB6     ------> I2C1_SCL
    PB7     ------> I2C1_SDA
    */
    HAL_GPIO_DeInit(I2C1_SCL_GPIO_PORT, I2C1_SCL_PIN);

    HAL_GPIO_DeInit(I2C1_SDA_GPIO_PORT, I2C1_SDA_PIN);
}


static BOOL I2C1_Unlock(void)
{
    uint8_t i = 0;

    I2C1_SetPortODOutput();

    HAL_GPIO_WritePin(I2C1_SCL_GPIO_PORT, I2C1_SCL_PIN, GPIO_PIN_SET);  //Release bus
    HAL_GPIO_WritePin(I2C1_SDA_GPIO_PORT, I2C1_SDA_PIN, GPIO_PIN_SET);

    if (HAL_GPIO_ReadPin(I2C1_SDA_GPIO_PORT, I2C1_SDA_PIN) == GPIO_PIN_RESET)
    {
        for (i = 0; i < 9; i++)
        {
            HAL_GPIO_WritePin(I2C1_SCL_GPIO_PORT, I2C1_SCL_PIN, GPIO_PIN_RESET);
            DelayUS(5);  //
            HAL_GPIO_WritePin(I2C1_SCL_GPIO_PORT, I2C1_SCL_PIN, GPIO_PIN_SET);
            DelayUS(5);  //
            if (HAL_GPIO_ReadPin(I2C1_SDA_GPIO_PORT, I2C1_SDA_PIN) == GPIO_PIN_SET)
            {
                break;
            }
        }

        if (i >= 9)
        {
            return FALSE;
        }
    }

    return TRUE;
}


static void I2C1_SetPortODOutput(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOB_CLK_ENABLE();

    GPIO_InitStruct.Pin = I2C1_SCL_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;
    HAL_GPIO_Init(I2C1_SCL_GPIO_PORT, &GPIO_InitStruct);

    GPIO_InitStruct.Pin = I2C1_SDA_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;
    HAL_GPIO_Init(I2C1_SDA_GPIO_PORT, &GPIO_InitStruct);
}

注意：

1)上电即对I2C总线作检测，并执行解锁操作，见初始化的开头部分。

2)“HAL_I2C_Init()”函数内部包含对I2C总线的复位操作，因此，“I2C1_Unlock()”函数里未对I2C总线作复位操作。若HAL库里未对I2C总线作复位操作，则需添加如下代码：

static void I2C1_Reset(void)
{
    /*Reset I2C*/
    I2C1->CR1 |= I2C_CR1_SWRST;
    I2C1->CR1 &= ~I2C_CR1_SWRST;
}

3)在操作I2C外设出错时，若需要添加解锁操作，可按如下进行：

if (HAL_I2C_Master_Transmit(&hi2c1, SlaveAddr, &Value, 1, 1000) != HAL_OK)
{
    HAL_I2C_DeInit(&hi2c1);
    I2C1_Init();
}

先取消初始化I2C，再对I2C进行初始化（包含解锁操作）。

参考：

1)NXP,UM10204 I2C-bus specification and user manual

2)Microchip,AT24CM01 Datasheet

3)Analog,LTC4307 Datasheet（内有芯片采用的死锁恢复机制）

总结，本文介绍了STM32 I2C总线锁死原因及解决方法。