RT-Thread在STM32硬件I2C的踩坑记录

RT-Thread在STM32硬件I2C的踩坑记录

  • 0.前言
  • 一、软硬件I2C区别
  • 二、RT Thread中的I2C驱动
  • 三、尝试适配硬件I2C
  • 四、i2c-bit-ops操作函数替换
  • 五、Attention Please!
  • 六、总结


参考文章:
1.将硬件I2C巧妙地将“嫁接”到RTT原生的模拟I2C驱动框架
2.基于STM32F4平台的硬件I2C驱动实现笔记
3.《rt-thread驱动框架分析》- i2c驱动

0.前言

  最近打算用RT-Thread做一个小demo玩玩,其中需要用I2C通信驱动一个oled屏幕,但是找了一圈也没找到RTT中对硬件I2C的支持方式以及使用案例,好像大家都心照不宣的用这个好用又不好用的软件I2C。这里还是忍不住吐槽两句,连硬件SPI都已经支持了,甚至支持SPI DMA模式了,硬件I2C这么多年了也没适配。也希望有大佬能贡献一份力量,做出一份能让DIY玩家凑合用的第三方硬件I2C驱动也行。

一、软硬件I2C区别

  有关I2C通信协议的原理部分就不多介绍了,这个算是很常见的通信协议了,CSDN论坛一搜一大把,RT Thread文档中心也有较详细的介绍。
  软件I2C是使用GPIO的电平翻转模拟出I2C信号,它的好处是方便移植,下至51单片机,上至linux平台,只要有GPIO都能适用(当然linux下也不会有人用这个)。缺点则是速率很低,软件操作GPIO电平翻转不可避免的有时延以及毛刺,为了消除这种现象的影响,模拟的I2C信号之间就需要稍微大点的时间间隔。软件I2C的信号频率一般在30KHz ~ 50KHz,即便优化相当好的情况也差不多在这个量级。用来操作128x64的oled屏幕,帧率基本在2帧左右。
  硬件I2C则是通过操作芯片自带的寄存器进行I2C通信,缺点就是不同芯片间驱动不通用,优点则是速度更快,并且可以适配DMA模式,降低CPU负载。笔者使用的STM32RCT6,硬件I2C标准模式信号频率为100KHz,快速模式400KHz,一些性能较好的芯片还有1MHz的极速模式。400kHz情况下操作128x64的oled帧率在25帧左右,可以说是提升巨大了。

二、RT Thread中的I2C驱动

  关于RT Thread中的I2C驱动框架的实现方式,可以参考上述的第三篇参考文章,个人觉得写的很详细也好懂。RT Thread为类Linux的实时操作系统,所以I2C框架的实现方式和linux中的也比较相像:I2C驱动提供一些操作相关的ops函数,并注册到内核中,I2C设备则可以通过probe函数挂载到总线上,通过ops操作函数进行I2C通信。
在这里插入图片描述
并且在该篇文章中,该作者跳过原本的bit_ops,重新设计了一个硬件I2C的实现方式,将驱动直接挂载到内核core中,也实现了作为master设备的硬件I2C驱动。不过笔者认为这种方式对通用结构的兼容性不太好,所以又找了一些其他方式。
在这里插入图片描述

三、尝试适配硬件I2C

参考文章1和2中,通过修改I2C总线的实现函数,“嫁接”一个硬件的I2C驱动实现方式。这里就先放上代码,首先在原drv_soft_i2c.c和drv_soft_i2c.h的同级目录下,分别创建drv_hard_i2c.c和drv_hard_i2c.h:
drv_hard_i2c.h:

/** Copyright (c) 2006-2018, RT-Thread Development Team** SPDX-License-Identifier: Apache-2.0** Change Logs:* Date           Author       Notes* 2018-11-08     balanceTWK   first version*/#ifndef __DRV_I2C__
#define __DRV_I2C__#include <rtthread.h>
#include <rthw.h>
#include <rtdevice.h>#ifdef BSP_USING_HARD_I2C/* stm32 config class */
typedef void (*pI2cConfig)(void);
struct stm32_hard_i2c_config
{rt_uint8_t scl;                     /* scl pin */rt_uint8_t sda;                     /* sda pin */const pI2cConfig pFunc;             /* i2c init function */const char* pName;                  /* i2c bus name */I2C_HandleTypeDef* pHi2c;           /* i2c handle */struct rt_i2c_bus_device i2c_bus;   /* i2c bus device */
};
/* stm32 i2c dirver class */
struct stm32_i2c
{struct rt_i2c_bit_ops ops;struct rt_i2c_bus_device i2c2_bus;
};#define HARD_I2C_CONFIG(x)  \
{.scl        = BSP_I2C##x##_SCL_PIN,    \.sda        = BSP_I2C##x##_SDA_PIN,    \.pFunc      = MX_I2C##x##_Init,         \.pHi2c      = &hi2c##x,                 \.pName      = "i2c"#x,                  \.i2c_bus    = {.ops = &i2c_bus_ops,},
}int rt_hw_i2c_init(void);#endif#endif /* RT_USING_I2C */

其中stm32_hard_i2c_config可以理解为i2c实例对象,属性包括scl和sda引脚、总线名称及初始化函数等。(注:在参考文章2中的总线速度、信号量及互斥锁则不需要,因为使用CubeMx生成的初始化函数中已有总线速度,HAL库中的I2C操作函数内部已有总线锁)
stm32_i2c则封装了设备操作函数及总线,用于与内核对接。
函数宏HARD_I2C_CONFIG(x)则用来后续创建I2C设备对象。

drv_hard_i2c.c:

/** Copyright (c) 2006-2018, RT-Thread Development Team** SPDX-License-Identifier: Apache-2.0** Change Logs:* Date           Author       Notes* 2018-11-08     balanceTWK   first version*/#include <board.h>
#include "drv_hard_i2c.h"
#include "drv_config.h"
#include<rtthread.h>
#include<rtdevice.h>#ifdef BSP_USING_HARD_I2C//#define DRV_DEBUG
#define LOG_TAG              "drv.i2c"
#include <drv_log.h>static const struct stm32_hard_i2c_config hard_i2c_config[] =
{
#ifdef BSP_USING_HARD_I2C1HARD_I2C_CONFIG(1),
#endif
#ifdef BSP_USING_HARD_I2C2HARD_I2C_CONFIG(2),
#endif
#ifdef BSP_USING_HARD_I2C3HARD_I2C_CONFIG(3),
#endif
#ifdef BSP_USING_HARD_I2C4HARD_I2C_CONFIG(4),
#endif
};static struct stm32_i2c i2c_obj[sizeof(hard_i2c_config) / sizeof(hard_i2c_config[0])];/*** This function initializes the i2c pin.** @param Stm32 i2c dirver class.*/
static void stm32_i2c_gpio_init(struct stm32_i2c *i2c)
{struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)i2c->ops.data;rt_pin_mode(cfg->scl, PIN_MODE_OUTPUT_OD);rt_pin_mode(cfg->sda, PIN_MODE_OUTPUT_OD);rt_pin_write(cfg->scl, PIN_HIGH);rt_pin_write(cfg->sda, PIN_HIGH);
}/*** The time delay function.** @param microseconds.*/
static void stm32_udelay(rt_uint32_t us)
{rt_uint32_t ticks;rt_uint32_t told, tnow, tcnt = 0;rt_uint32_t reload = SysTick->LOAD;ticks = us * reload / (1000000 / RT_TICK_PER_SECOND);told = SysTick->VAL;while (1){tnow = SysTick->VAL;if (tnow != told){if (tnow < told){tcnt += told - tnow;}else{tcnt += reload - tnow + told;}told = tnow;if (tcnt >= ticks){break;}}}
}/*** if i2c is locked, this function will unlock it** @param stm32 config class** @return RT_EOK indicates successful unlock.*/
static rt_err_t stm32_i2c_bus_unlock(const struct stm32_soft_i2c_config *cfg)
{rt_int32_t i = 0;if (PIN_LOW == rt_pin_read(cfg->sda)){while (i++ < 9){rt_pin_write(cfg->scl, PIN_HIGH);stm32_udelay(100);rt_pin_write(cfg->scl, PIN_LOW);stm32_udelay(100);}}if (PIN_LOW == rt_pin_read(cfg->sda)){return -RT_ERROR;}return RT_EOK;
}/* I2C initialization function */
int rt_hw_i2c_init(void)
{rt_int8_t ret = RT_ERROR;rt_size_t obj_num = NR(hard_i2c_config);rt_err_t result;for (int i = 0; i < obj_num; i++){//GPIO初始化stm32_i2c_gpio_init(&hard_i2c_config[i]);//检测SDA是否为低电平,低电平则通过管脚模拟9个CLK解锁stm32_i2c_bus_unlock(&hard_i2c_config[i]);//调用Hal库MX_I2Cx_Init(),配置硬件I2Chard_i2c_config[i].pFunc();//向内核注册I2C Bus设备if(rt_i2c_bus_device_register(&(hard_i2c_config[i].i2c_bus), hard_i2c_config[i].pName) != RT_EOK){LOG_E("%s bus init failed!\r\n", hard_i2c_config[i].pName);ret |= RT_ERROR;}else{ret |= RT_EOK;LOG_I("%s bus init success!\r\n", hard_i2c_config[i].pName);}}return ret;
}
//INIT_BOARD_EXPORT(rt_hw_i2c_init);#endif /* BSP_USING_HARD_I2C */

此文件中则主要根据宏定义开关创建I2C实例对象,并对其进行初始化。主要函数为rt_hw_i2c_init(),此函数中所需要的gpio init、delay函数等,则保留软件i2c中的初始化操作。

user_i2c.h:

/** Copyright (c) 2006-2021, RT-Thread Development Team** SPDX-License-Identifier: Apache-2.0** Change Logs:* Date           Author       Notes* 2023-08-27     14187       the first version*/
#ifndef DRIVERS_HARD_I2C_H_
#define DRIVERS_HARD_I2C_H_//硬件i2c宏开关
//#define     BSP_USING_HARD_I2C
#ifdef      BSP_USING_HARD_I2C
//      #define BSP_USING_HARD_I2C1
//      #define BSP_USING_HARD_I2C2
//      #define BSP_USING_HARD_I2C3
//      #define BSP_USING_HARD_I2C4#if defined(BSP_USING_HARD_I2C1 || BSP_USING_HARD_I2C2 || BSP_USING_HARD_I2C3 || BSP_USING_HARD_I2C4)//#define BSP_USING_DMA_I2C_TX//#define BSP_USING_DMA_I2C_RX#endif
#endif#endif /* DRIVERS_HARD_I2C_H_ */

为了不在每次保存RT Thread Settings时,自己的配置被覆盖刷新,所以额外定义了一个头文件,用于保存自定义的I2C宏开关,这样每次刷新后只需要重新在board.h中包含此头文件即可。

至此自定义的硬件I2C宏开关及设备对象创建已完成,剩下的则只需要替换内核中的bit_ops操作函数即可。

四、i2c-bit-ops操作函数替换

在rt thread项目根目录下的 rt-thread/components/drivers/i2c/ 目录下,有一个i2c-bit-ops.c文件,其中则保存了i2c驱动框架中注册的ops操作函数:

static rt_size_t i2c_bit_xfer(struct rt_i2c_bus_device *bus,struct rt_i2c_msg         msgs[],rt_uint32_t               num)
{struct rt_i2c_msg *msg;struct rt_i2c_bit_ops *ops = (struct rt_i2c_bit_ops *)bus->priv;rt_int32_t i, ret;rt_uint16_t ignore_nack;if (num == 0) return 0;for (i = 0; i < num; i++){msg = &msgs[i];ignore_nack = msg->flags & RT_I2C_IGNORE_NACK;if (!(msg->flags & RT_I2C_NO_START)){if (i){i2c_restart(ops);}else{LOG_D("send start condition");i2c_start(ops);}ret = i2c_bit_send_address(bus, msg);if ((ret != RT_EOK) && !ignore_nack){LOG_D("receive NACK from device addr 0x%02x msg %d",msgs[i].addr, i);goto out;}}if (msg->flags & RT_I2C_RD){ret = i2c_recv_bytes(bus, msg);if (ret >= 1){LOG_D("read %d byte%s", ret, ret == 1 ? "" : "s");}if (ret < msg->len){if (ret >= 0)ret = -RT_EIO;goto out;}}else{ret = i2c_send_bytes(bus, msg);if (ret >= 1){LOG_D("write %d byte%s", ret, ret == 1 ? "" : "s");}if (ret < msg->len){if (ret >= 0)ret = -RT_ERROR;goto out;}}}ret = i;out:if (!(msg->flags & RT_I2C_NO_STOP)){LOG_D("send stop condition");i2c_stop(ops);}return ret;
}
...
static const struct rt_i2c_bus_device_ops i2c_bit_bus_ops =
{i2c_bit_xfer,RT_NULL,RT_NULL
};

这段代码中实现了对每个i2c设备发送对应的i2c msg流程,将其修改为硬件i2c的发送方式:

static rt_size_t i2c_xfer(struct rt_i2c_bus_device *bus,struct rt_i2c_msg     msgs[],rt_uint32_t           num)
{rt_uint32_t i;struct rt_i2c_msg *msg;struct stm32_hard_i2c_config *Pconfig = rt_container_of(bus, struct stm32_hard_i2c_config, i2c_bus);fot(i = 0;i < num;i++){msg = &msgs[i];if(msg->flags & RT_I2C_RD){
#if defined(BSP_USING_DMA_I2C_RX)HAL_I2C_Master_Receive_DMA(Pconfig->pHi2c, (msg->addr)<<1, msg->buf, msg->len);rt_hw_us_delay(100);
#elseHAL_I2C_Master_Receive(Pconfig->pHi2c, (msg->addr)<<1, msg->buf, msg->len, 100);
#endif}else{
#if defined(BSP_USING_DMA_I2C_TX)HAL_I2C_Master_Transmit_DMA(Pconfig->pHi2c, (msg->addr)<<1, msg->buf, msg->len);rt_hw_us_delay(100);
#elseHAL_I2C_Master_Transmit(Pconfig->pHi2c, (msg->addr)<<1, msg->buf, msg->len, 100);
#endif}}return i;
}static const struct rt_i2c_bus_device_ops i2c_bit_bus_ops =
{i2c_xfer,RT_NULL,RT_NULL
};

参考软件i2c的发送方式,创建一个新的发送函数rt_size_t i2c_xfer(),并将rt_i2c_bus_device_ops 中对应的发送方式修改为此方式。

至此,硬件I2C的驱动则算是完成了一部分,可以通过与软件i2c一样的声明及挂载方式,将设备挂载到硬件I2C总线上。

五、Attention Please!

问题1:在上述的实现方式中,可以根据宏定义通过HAL_I2C_Master_Transmit()或HAL_I2C_Master_Transmit_DMA()方式发送I2C消息,但并未对是否发送成功做出判断。
问题2:ST官方的HAL库中,I2C发送消息共有三种方式,polling模式(轮询)、中断模式、DMA模式,HAL_I2C_Master_Transmit()则对应轮询模式,此模式相对于软件I2C虽然速率有所提升,但实际的提升效果其实不是特别大。而对于中断模式,则需要移植并实现对应的中断处理函数,可以按照参考文章2进行实现,不过笔者认为该篇需要注意的地方很多,比如在中断处理函数中释放信号量的操作,可能会造成一些隐患(可以直接去除信号量)。对于DMA模式,理论上也需要移植一些中断处理函数,但笔者目前没有用这种方式,所以也没有细究。所以理论上只能停留在polling模式。
问题3:在drv_hard_i2c.c中,INIT_BOARD_EXPORT(rt_hw_i2c_init);这个注册步骤,需要根据实际情况而定,如果想要使用DMA模式,则在此注册步骤之前,需要先注册MX_DMA_Init(),此函数为CubeMX生成,用来初始化DMA功能。中断模式同理。

六、总结

  目前看来,移植ST的硬件I2C驱动还是困难重重,所以笔者选则了更换平台(我逃避。。。)将oled的电路修改成了SPI模式,并更换了芯片平台,手头还有一个LPC54110和一个CH32的开发板,这两个板子的RTT BSP支持包好像有适配硬件I2C驱动,ST再见,希望下次回来有大佬适配了硬件I2C。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/111377.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Git小白入门——了解分布式版本管理和安装

Git是什么&#xff1f; Git是目前世界上最先进的分布式版本控制系统&#xff08;没有之一&#xff09; 什么是版本控制系统&#xff1f; 程序员开发过程中&#xff0c;对于每次开发对各种文件的修改、增加、删除&#xff0c;达到预期阶段的一个快照就叫做一个版本。 如果有一…

iOS开发Swift-1-Xcode创建项目

1.创建项目 双击Xcode App&#xff0c;选择Create a new Xcode project。 选择创建一个iOS普通的App项目。选择Single View App&#xff0c;点击Next。 填写项目名&#xff0c;组织名称等&#xff0c;点击next。 选择好文件的存储路径&#xff0c;点击create。 2.为前端添加组件…

Unity3D 如何在ECS架构下,用Unity引擎进行游戏开发详解

前言 Unity3D是一款强大的游戏引擎&#xff0c;它提供了丰富的功能和工具&#xff0c;可以帮助开发者快速构建高质量的游戏。而Entity Component System&#xff08;ECS&#xff09;是Unity3D中一种新的架构模式&#xff0c;它可以提高游戏的性能和可扩展性。本文将详细介绍在…

【链表OJ】相交链表 环形链表1

前言: &#x1f4a5;&#x1f388;个人主页:​​​​​​Dream_Chaser&#xff5e; &#x1f388;&#x1f4a5; ✨✨刷题专栏:http://t.csdn.cn/UlvTc ⛳⛳本篇内容:力扣上链表OJ题目 目录 一.leetcode 160. 相交链表 1.问题描述: 2.解题思路: 二.leetcode 141.环形链表 …

C语言:指针类型的意义

1.指针的类型决定了解引用时访问几个字节 2.指针的类型决定了指针1、-1跳过几个字节 一、指针的类型决定指针解引用时访问几个字节 例如 int 型指针解引用时访问4个字节 char 型指针解引用时访问1个字节 详解代码如下&#xff1a; int b 0x11223344&#xff08;十六进制&…

h5分享页适配手机电脑

实现思路 通过media媒体查询结合rem继承html文字大小来实现。 快捷插件配置 这里使用了VSCode的px to rem插件。 先在插件市场搜索cssrem下载插件&#xff1b; 配置插件 页面编写流程及适配详情 配置meta h5常用配置信息:<meta name"viewport" content&quo…

Oracle数据传输加密方法

服务器端“dbhome_1\NETWORK\ADMIN\”sqlnet.ora文件中添加 SQLNET.ENCRYPTION_SERVER requested SQLNET.ENCRYPTION_TYPES_SERVER (RC4_256) 添加后新的链接即刻生效&#xff0c;服务器无需重新启动。 也可以通过Net manager管理工具添加 各个参数含义如下&#xff1a; 是…

双向交错CCM图腾柱无桥单相PFC学习仿真与实现(3)硬件功能实现

前言 前面介绍了双向交错CCM图腾柱的系统设计仿真实现&#xff0c;仿真很理想 双向交错CCM图腾柱无桥单相PFC学习仿真与实现&#xff08;1&#xff09;系统问题分解_卡洛斯伊的博客-CSDN博客 然后又介绍了SOG锁相环仿真实现的原理 双向交错CCM图腾柱无桥单相PFC学习仿真与实…

元素居中的方法总结

垂直居中 行内元素垂直居中 单行文本垂直居中 1.line-height: 200px; <!DOCTYPE html> <html lang"en"><head><meta charset"UTF-8" /><meta name"viewport" content"widthdevice-width, initial-scale1.0&…

IDEA如何打jar包

IntelliJ IDEA如何打jar包 1、无maven打jar包 1、编写好Java项目后&#xff0c;点击File --> Project Structure&#xff0c;然后按照以下图示步骤进行打包操作 若项目还存在一些额外的文件&#xff0c;可通过以下方式&#xff0c;将文件添加到jar包中。 //如果我们将项目…

tp5使用redis及redis7.2安装到window系统上面

redis安装教程 redis7.2安装到window系统上面 https://download.csdn.net/download/qq_39161501/88269037 解决方案&#xff1a;修改配置php.ini文件 打开Apache目录下的php.ini文件&#xff0c;搜索extension&#xff0c;在空白处加上下列代码&#xff1a; 注&#xff1a;e…

K8s简介之什么是K8s

1.概述 Kubernetes&#xff0c;也被称为K8s或Kube,是谷歌推出来的业界最受欢迎的容器编排器。在开始之前&#xff0c;让我们对容器引擎和容器有一个基本的了解。 2.什么是容器引擎&#xff1f; 容器引擎允许你绑定一个和运行一个应用在容器里&#xff0c;这是一个松散隔离的…

05-基础例程5

基础例程5 1、超声波测距 实验介绍 ​ HC-SR04超声波传感器是一款测量距离的传感器。其原理是利用声波在遇到障碍物反射接收结合声波在空气中传播的速度计算的得出。 外观 管脚功能的定义 VCC&#xff1a;供电电源&#xff1b;Trig&#xff1a;触发信号&#xff1b;Echo&a…

Jetbrains IDE新UI设置前进/后退导航键

背景 2023年6月&#xff0c;Jetbrains在新发布的IDE&#xff08;Idea、PyCharm等&#xff09;中开放了新UI选项&#xff0c;我们勾选后重启IDE&#xff0c;便可以使用这一魔性的UI界面了。 但是前进/后退这对常用的导航键却找不到了&#xff0c;以前的设置方式&#xff08;Vi…

Qt 打开文件列表选择文件,实现拖拽方式打开文件

1. 实现打开文件列表选择文件 1.1. 创建 Qt 工程&#xff0c;并添加几个简单控件 这里笔者选用的是 QMainWindow&#xff0c;创建好工程后在 ui 界面设计中添加 QLineEdit、QPushBtton至少这两个控件&#xff0c;如下图摆放。 1.2. 头文件中添加相关操作 在 mainwindow.h 中…

基于AVR128单片机抢答器proteus仿真设计

一、系统方案 二、硬件设计 原理图如下&#xff1a; 三、单片机软件设计 1、首先是系统初始化 void timer0_init() //定时器初始化 { TCCR00x07; //普通模式&#xff0c;OC0不输出&#xff0c;1024分频 TCNT0f_count; //初值&#xff0c;定时为10ms TIFR0x01; //清中断标志…

数据的语言:学习数据可视化的实际应用

数据可视化应该学什么&#xff1f;这是一个在信息时代越来越重要的问题。随着数据不断增长和积累&#xff0c;从社交媒体到企业业务&#xff0c;从科学研究到医疗健康&#xff0c;我们都面临着海量的数据。然而&#xff0c;数据本身往往是冰冷、抽象的数字&#xff0c;对于大多…

01.崩溃捕获设计实践

01.崩溃捕获设计实践方案 目录介绍 01.整体介绍概述 1.1 项目背景介绍1.2 遇到问题1.3 基础概念介绍1.4 设计目标 02.App崩溃流程 2.1 为何崩溃推出App2.2 Java崩溃流程2.3 Native崩溃流程2.4 崩溃日志处理2.5 最后推出App2.6 崩溃流程叙述2.7 Binder死亡通知 03.崩溃处理入口…

leetcode 567. 字符串的排列(滑动窗口-java)

滑动窗口 字符串的排列滑动窗口代码演示进阶优化版 上期经典 字符串的排列 难度 -中等 leetcode567. 字符串的排列 给你两个字符串 s1 和 s2 &#xff0c;写一个函数来判断 s2 是否包含 s1 的排列。如果是&#xff0c;返回 true &#xff1b;否则&#xff0c;返回 false 。 换句…

ios开发 swift5 苹果系统自带的图标 SF Symbols

文章目录 1.官网app的下载和使用2.使用代码 1.官网app的下载和使用 苹果官网网址&#xff1a;SF Symbols 通过上面的网址可以下载dmg, 安装到自己的mac上 貌似下面这样不能展示出动画&#xff0c;还是要使用动画的代码 .bounce.up.byLayer2.使用代码 UIKit UIImage(system…