• stm32fxx_hal_i2c.c解读之HAL_I2C_Mem_Write


    HAL_I2C_Mem_Write()函数位于stm32fxx_hal_i2c.c文件的2432行,源代码对该函数的解释如下图

    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 );

    image
    该函数是通过阻塞模式将一定数量的数据写入目标地址器件中目标寄存器地址中去。

    该函数的参数一共有7个,将他们的特性列入下表格:

    参数名 参数数据类型 参数解释
    hi2c I2C_HandleTypeDef * hi2c是一个结构体指针,它包含了特定I2C设备的配置信息
    DevAddress uint16_t 目标器件的地址,七位地址必须左对齐
    MemAddress uint16_t 目标器件的目标寄存器地址
    MemAddSize uint16_t 目标器件内部寄存器地址数据长度
    pData uint8_t* 一个8位的指针,指向待写的数据
    Size uint16_t 待传数据的数量
    Timeout uint32_t 等待时间
    • 结构体I2C_HandleTypeDef的定义如下图所示
      image
    接下来我们看该函数是如何实现功能的:

    image

    首先定义了一个32位的变量tickstart,将目前时钟计数的值赋给它,HAL_GetTick()函数实现了取当前时钟计数的功能,我们看它的源代码

    image
    HAL_GetTick()函数位于stm32f1xx_hal.c文件中,可以看到HAL_GetTick()函数就完成了一个功能返回uwTick,而uwTick即为时钟计数值,当完成初始化HAL库后,uwTick每1ms增加1,溢出后归零。我们可以在代码的不同位置分别取当前的uwTick的值,将两个值相减即为中间代码运行时间。

    再回到源代码:

    image
    assert_param()是一个参数校验函数,它的作用是检验输入参数是否符合要求。

    接下来判断I2C是否准备好,如果i2c准备就绪,就进入下一环节,如果没有,则返回HAL_BUSY。

    如果I2C准备就绪,则等待总线空闲,通过函数I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart)实现,我们来看看此函数的源码:
    image
    本函数位于stm32f1xx_hai_i2c.c文件的6876行,它实现了一个这样的功能:判断在一个时间间隔内,某标志位是否等于某值,如果是则返回HAL_OK;如否,则配置hi2c结构体参数并返回HAL_ERROR。

    image

    _HAL_LOCK(hi2c)实现了对资源的锁定,我们来看它的源代码

    image
    它位于stm32f1xx_hal_def.h文件内,它实现了这样一个功能:判断—_HANDLE_结构体中的成员Lock的值是否等于HAL_LOCKED,如果是,则返回HAL_BUSY,表示资源已被占用;如果否,则给Lock赋值HAL_LOCKED,表示本资源已被占用。

    再回到源码:

    image
    标蓝的代码实现了这样一个功能:检测I2C是否被使能,如果没被使能,则使能。

    下一段代码:

    image

    可以看到,注释对这段代码的解释是失能Pos,这个Pos是什么意思呢?让我们看STM32手册里面的解释

  • 相关阅读:
    07.Octave语言的使用-变量、数值、向量、矩阵
    卸载无用Mac电脑软件应用程序方法教程
    springboot~封装依赖引用包jar还是pom,哪种更规范
    对象存储解决方案 开源对象存储平台 自建对象存储解决方案
    计算机竞赛 深度学习实现行人重识别 - python opencv yolo Reid
    华为防火墙 配置 SSLVPN
    GBase 8a MPP集群规划
    软件架构简介
    linux配置IP、子网掩码、网关
    centos安装flink,通过windows访问webui
  • 原文地址:https://www.cnblogs.com/hhmxf/p/16707197.html