关于stm32HAL库中HAL_I2C_Master_Transmit详解

于 2024-07-11 17:50:32 发布
阅读量743 收藏 2
点赞数 2
文章标签： 单片机 stm32
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lmzyhhh/article/details/140357691
版权

最近开始使用stm32的模块来配置I2C，其中先主要分析一下HAL_I2C_Master_Transmit()库函数。

HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData,
                                          uint16_t Size, uint32_t Timeout)
{
  uint32_t tickstart;

  if (hi2c->State == HAL_I2C_STATE_READY)
  {
    /* Process Locked */
    __HAL_LOCK(hi2c);

    /* Init tickstart for timeout management*/
    tickstart = HAL_GetTick();

    if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY, tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

    hi2c->State     = HAL_I2C_STATE_BUSY_TX;
    hi2c->Mode      = HAL_I2C_MODE_MASTER;
    hi2c->ErrorCode = HAL_I2C_ERROR_NONE;

    /* Prepare transfer parameters */
    hi2c->pBuffPtr  = pData;
    hi2c->XferCount = Size;
    hi2c->XferISR   = NULL;

    /* Send Slave Address */
    /* Set NBYTES to write and reload if hi2c->XferCount > MAX_NBYTE_SIZE and generate RESTART */
    if (hi2c->XferCount > MAX_NBYTE_SIZE)
    {
      hi2c->XferSize = MAX_NBYTE_SIZE;
      I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_RELOAD_MODE,             //配置CR2 register
                         I2C_GENERATE_START_WRITE);
    }
    else
    {
      hi2c->XferSize = hi2c->XferCount;
      I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_AUTOEND_MODE,
                         I2C_GENERATE_START_WRITE);
    }

    while (hi2c->XferCount > 0U)
    {
      /* Wait until TXIS flag is set */
      if (I2C_WaitOnTXISFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
      {
        return HAL_ERROR;
      }
      /* Write data to TXDR */
      hi2c->Instance->TXDR = *hi2c->pBuffPtr;

      /* Increment Buffer pointer */
      hi2c->pBuffPtr++;

      hi2c->XferCount--;
      hi2c->XferSize--;

      if ((hi2c->XferCount != 0U) && (hi2c->XferSize == 0U))
      {
        /* Wait until TCR flag is set */
        if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_TCR, RESET, Timeout, tickstart) != HAL_OK)
        {
          return HAL_ERROR;
        }

        if (hi2c->XferCount > MAX_NBYTE_SIZE)
        {
          hi2c->XferSize = MAX_NBYTE_SIZE;
          I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_RELOAD_MODE,
                             I2C_NO_STARTSTOP);
        }
        else
        {
          hi2c->XferSize = hi2c->XferCount;
          I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_AUTOEND_MODE,
                             I2C_NO_STARTSTOP);
        }
      }
    }

    /* No need to Check TC flag, with AUTOEND mode the stop is automatically generated */
    /* Wait until STOPF flag is set */
    if (I2C_WaitOnSTOPFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

    /* Clear STOP Flag */
    __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_STOPF);

    /* Clear Configuration Register 2 */
    I2C_RESET_CR2(hi2c);

    hi2c->State = HAL_I2C_STATE_READY;
    hi2c->Mode  = HAL_I2C_MODE_NONE;

    /* Process Unlocked */
    __HAL_UNLOCK(hi2c);

    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }
}

首先函数四个形参分别是：1.指向i2c结构体的句柄.2.从机的设备地址。3.指向buffer的指针。4.需要发送数据的size总数 .5.延时。

接下来具体分析这个函数。

  tickstart = HAL_GetTick();

首先判断是ready状态，因为函数有超时判断，所以获取时钟。


    if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY, tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

接着看这个函数

static HAL_StatusTypeDef I2C_WaitOnFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, FlagStatus Status,
                                                    uint32_t Timeout, uint32_t Tickstart)
{
  while (__HAL_I2C_GET_FLAG(hi2c, Flag) == Status)
  {
    /* Check if an error is detected */
    if (I2C_IsErrorOccurred(hi2c, Timeout, Tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

    /* Check for the Timeout */
    if (Timeout != HAL_MAX_DELAY)
    {
      if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
      {
        if ((__HAL_I2C_GET_FLAG(hi2c, Flag) == Status))
        {
          hi2c->ErrorCode |= HAL_I2C_ERROR_TIMEOUT;
          hi2c->State = HAL_I2C_STATE_READY;
          hi2c->Mode = HAL_I2C_MODE_NONE;

          /* Process Unlocked */
          __HAL_UNLOCK(hi2c);
          return HAL_ERROR;
        }
      }
    }
  }
  return HAL_OK;
}

正如这个函数名字所示，它用来等待flag直到timeout。

我们更进一步分析一下这个函数：

 while (__HAL_I2C_GET_FLAG(hi2c, Flag) == Status)
  {
    /* Check if an error is detected */
    if (I2C_IsErrorOccurred(hi2c, Timeout, Tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

首先是这个while循环，这个内部条件是判断I2C的Flag状态是否是形参输入的status（在HAL_I2C_Master_Transmit（）函数中是判断是否busy），下面是源代码中的宏定义。

#define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & \
                                                    (__FLAG__)) == (__FLAG__)) ? SET : RESET)

接着看I2C_IsErrorOccurred(hi2c, Timeout, Tickstart)这个函数，这个函数总体较长，就不贴出来了，主要作用是判断有没有什么错误发生（其中包括从机是否应答ack）。

这个函数剩下的内容主要是判断是否超时。

接着我们看HAL_I2C_Master_Transmit（）函数中剩下部分：


    hi2c->State     = HAL_I2C_STATE_BUSY_TX;
    hi2c->Mode      = HAL_I2C_MODE_MASTER;
    hi2c->ErrorCode = HAL_I2C_ERROR_NONE;

    /* Prepare transfer parameters */
    hi2c->pBuffPtr  = pData;
    hi2c->XferCount = Size;
    hi2c->XferISR   = NULL;

这是往结构体里面的一下参数赋值，比较简单。

 if (hi2c->XferCount > MAX_NBYTE_SIZE)
    {
      hi2c->XferSize = MAX_NBYTE_SIZE;
      I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_RELOAD_MODE,             //配置CR2 register
                         I2C_GENERATE_START_WRITE);
    }
    else
    {
      hi2c->XferSize = hi2c->XferCount;
      I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_AUTOEND_MODE,
                         I2C_GENERATE_START_WRITE);
    }

这个是根据xfercount是否大于maxsize来判断，其中I2C_TransferConfig函数用来配置CR2寄存器的内容。

具体内容如下：

static void I2C_TransferConfig(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t Size, uint32_t Mode,
                               uint32_t Request)
{
  /* Check the parameters */
  assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
  assert_param(IS_TRANSFER_MODE(Mode));
  assert_param(IS_TRANSFER_REQUEST(Request));

  /* Declaration of tmp to prevent undefined behavior of volatile usage */
  uint32_t tmp = ((uint32_t)(((uint32_t)DevAddress & I2C_CR2_SADD) | \
                             (((uint32_t)Size << I2C_CR2_NBYTES_Pos) & I2C_CR2_NBYTES) | \
                             (uint32_t)Mode | (uint32_t)Request) & (~0x80000000U));

  /* update CR2 register */
  MODIFY_REG(hi2c->Instance->CR2, \
             ((I2C_CR2_SADD | I2C_CR2_NBYTES | I2C_CR2_RELOAD | I2C_CR2_AUTOEND | \
               (I2C_CR2_RD_WRN & (uint32_t)(Request >> (31U - I2C_CR2_RD_WRN_Pos))) | \
               I2C_CR2_START | I2C_CR2_STOP)), tmp);
}

根据设备地址，传输最大数据等参数，来配置CR2寄存器的值。

接下来我们看下一个while循环的内容：

 while (hi2c->XferCount > 0U)
    {
      /* Wait until TXIS flag is set */
      if (I2C_WaitOnTXISFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
      {
        return HAL_ERROR;
      }
      /* Write data to TXDR */
      hi2c->Instance->TXDR = *hi2c->pBuffPtr;

      /* Increment Buffer pointer */
      hi2c->pBuffPtr++;

      hi2c->XferCount--;
      hi2c->XferSize--;

      if ((hi2c->XferCount != 0U) && (hi2c->XferSize == 0U))
      {
        /* Wait until TCR flag is set */
        if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_TCR, RESET, Timeout, tickstart) != HAL_OK)
        {
          return HAL_ERROR;
        }

        if (hi2c->XferCount > MAX_NBYTE_SIZE)
        {
          hi2c->XferSize = MAX_NBYTE_SIZE;
          I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_RELOAD_MODE,
                             I2C_NO_STARTSTOP);
        }
        else
        {
          hi2c->XferSize = hi2c->XferCount;
          I2C_TransferConfig(hi2c, DevAddress, (uint8_t)hi2c->XferSize, I2C_AUTOEND_MODE,
                             I2C_NO_STARTSTOP);
        }
      }
    }

可以见到这个while的内容主要是实现了传输数据的功能，里面的一些函数在上文也有相关介绍。其中值得注意的是这几个if判断，用来判断要传输的数据大于Maxsize的情况。

   /* Wait until STOPF flag is set */
    if (I2C_WaitOnSTOPFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
    {
      return HAL_ERROR;
    }

    /* Clear STOP Flag */
    __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_STOPF);

    /* Clear Configuration Register 2 */
    I2C_RESET_CR2(hi2c);

    hi2c->State = HAL_I2C_STATE_READY;
    hi2c->Mode  = HAL_I2C_MODE_NONE;

    /* Process Unlocked */
    __HAL_UNLOCK(hi2c);

    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }

接下来的代码就不过多赘述。

lmzyhhh
关注
  • 2
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
stm32的HAL库i2c从机实现
G_Crisis的博客
08-30 1万+
stm32的i2c默认就是slave模式，本文基于HAL库实现中断方式的接收和发送，首先是初始化gpio和i2c，代码如下： I2C_HandleTypeDef I2cHandle; void HAL_I2C_MspInit(I2C_HandleTypeDef* i2cHandle) { GPIO_InitTypeDef GPIO_InitStruct; __HAL_RCC...
stm32f4 模拟I2C master
12-01
Keil工程库函数编写的使用GPIO模拟I2C master模式 实测没有问题
HAL库STM32常用外设教程（九）—— I2C通信（读写EEPROM）
最新发布
That_Assassin的博客
03-30 9028
I2C(Inter-Integrated Circuit)接口，有时也写作IIC，是一种串行数字总线接口。I2C接口只有两根信号线，总线上可以连接多个设备，硬件实现简单，可拓展性强。I2C通信协议可以通过普通GPIO引脚进行软件模拟。I2C接口主要用于通信速率要求不高，以及多个器件之间通信的应用场景。本文讲解了I2C的基础知识，其中涉及了I2C的通信原理、HAL库驱动程序、I2C的三种发送模式（轮询（阻塞）、中断、DMA）。
I2C协议介绍以及HAL库实现I2C对SHT30温湿度采样
m0_51429770的博客
11-06 3393
I2C总线是Philips公司在八十年代初推出的一种串行、半双工的总线，主要用于近距离、低速的芯片之间的通信。12C Bus(IIC, Inter-Integrated Circuit Bus)是由一根数据线SDA用于收发数据，一根时钟线SCL用于通信双方时钟的同步，利用上拉电阻将它们拉成高电平(表示总线空闲)，其典型的电压准位为+3.3V或+5V，具有电路简单、连接线少、控制简单、通信速率高等优点。
AS5600磁编码器 STM32硬件I2C驱动工程 HAL库
08-18
测试通过了STM32F0的硬件I2C最大速度1M读取as5600的角度值的工程，同理也可以读写其他寄存器
【STM32笔记】STM32的IIC通信基础（三）---IIC读取AHT20温湿度数据(中断模式、DMA模式)
Macy~的博客
10-25 1144
IIC读取AHT20温湿度数据(中断模式、DMA模式)
HAL_I2C_Mem_Write与HAL_I2C_Master_Transmit
热门推荐
liangbin414的博客
11-25 4万+
功能：在阻塞模式下将大量数据写入特定的内存地址 HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout) 参数...
STM32软件 I2C Master (不支持Clock stretch)
五少爷的笔记本
07-26 561
软件I2C搞定。硬件软了, 别老是为难软件, 都被逼到用软件写I2C了, 还BB啥。　
i2c 驱动编程接口 i2c_master_send 和 i2c_master_recv i2c_transfer
zclongembedded的专栏
12-04 3万+
1、通信接口 i2c发送或者接收一次数据都以数据包 struct i2c_msg 封装 [cpp]  struct i2c_msg {      __u16 addr;     // 从机地址      __u16 flags;    // 标志  #define I2C_M_TEN   0x0010  // 十位地址标志  #define I2C_M_RD    0x0001  /
I2C传输协议- Master-Transmitter/Receiver Protocol
Ann_xia6的博客
08-12 1585
i2c传输协议
STM32IICDriverDemo_Master主机程序I2C
09-23
我已测试完全可用，注意你的SDASCL加上拉电阻！主机是使用I2C2)，从机使用I2C1)，软件截图 先上电主机，再上电从机，有串口截图 SDA0X10 SDA0X58 SCL400khz
STM32 HAL库 硬件I2C对MPU6050的使用
11-02
4. 编写读写函数，如`HAL_I2C_Master_Transmit()`和`HAL_I2C_Master_Receive()`，用于向MPU6050发送命令和读取数据。 接下来，要操作MPU6050，我们需要执行以下步骤： 1. 初始化MPU6050，包括配置工作模式、陀螺仪...
STM32F1xx_HAL库_V1.4.0_及例程
03-13
2. **外设驱动**：每个STM32的外设如ADC、DAC、DMA、SPI、I2C、UART等都有对应的HAL驱动，如HAL_ADC_Init()、HAL_I2C_Master_Transmit()等。这些函数封装了底层寄存器操作，提供了简单易用的接口。 3. **状态管理和...
STM32F407单片机（HAL库版本） DHT11数字温湿度传感器实验软件例程源码.rar
05-18
2. `stm32f4xx_hal_msp.c/h`：这是HAL库的设备支持包，包含了针对STM32F407硬件外设的初始化函数。 3. `dht11.c/h`：这些文件包含了DHT11传感器的驱动代码，包括发送命令、接收数据和校验等步骤。DHT11通信协议的...
stm32at24c512.rar_at24c512程序_i2c stm32f103_stm32 at24c512_stm32F
07-14
编写STM32F103的I2C驱动程序，涉及HAL库或LL库中的相关函数，如`HAL_I2C_Master_Transmit()`、`HAL_I2C_Master_Receive()`等。还需考虑错误处理和重试机制，确保通信可靠性。 6. 应用示例： `um0427`可能是程序源...
stm32_I2C1602完整驱动程序_STM32F103_stm32用I2c1602_
09-30
这些函数会利用HAL或LL库提供的API，如`HAL_I2C_Master_Transmit()`和`HAL_I2C_Master_Receive()`，发送命令或数据到1602 LCD。 4. **错误处理**：添加适当的错误检查机制，如超时和重试，以确保在通信过程中能正确...
STM32之I2C总线知识和HAL库函数
sealsystem的博客
02-14 3106
I2C总线知识和STM32 HAL库函数
i2c_master_send()、i2c_master_recv()和i2c_transfer()
飞呀飞呀菲
05-20 4591
转载自：https://blog.csdn.net/lz_1990/article/details/42501381 一、数据包I2C_MSG Name struct i2c_msg — an I2C transaction segment beginning with START struct <span style="color:#cc0000;">i2c_msg </span>{ __u16 addr; __u16 flags; #define I2C_M_TEN..
hal_i2c_master_transmit
03-26
hal_i2c_master_transmit是一个函数，用于在HAL库中进行I2C主机传输。它用于向I2C总线上的从设备发送数据。 该函数的原型如下： HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout) 参数说明： - hi2c：指向I2C_HandleTypeDef结构体的指针，该结构体包含了I2C外设的配置和状态信息。 - DevAddress：从设备的地址。 - pData：指向要发送数据的缓冲区。 - Size：要发送的数据字节数。 - Timeout：传输超时时间。 该函数的作用是将pData缓冲区中的数据发送到指定的从设备。它会等待传输完成或超时。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值