【玩转 RT-Thread】I2C 内核

作者：攻城狮杰森

2022 年 7 月 09 日
本文字数：4149 字
阅读完需：约 14 分钟

一、i2c 协议

由飞利浦公司开发，支持设备间的短距离通信。i2c 通信需要的引脚少，硬件实现简单、可扩展性强，被广泛应用在系统内多个集成电路（IC）间的通信。

二、i2c 物理层

i2c 通信总线可连接多个 i2c 通信设备，支持多个通信主机和多个通信从机。i2c 通信只需要两条双向总线——SDA（串行数据线）和 SCL（串行时钟线）。
SDA：用于传输数据
SCL：用于同步数据收发
每个连接到总线的设备都有一个独立地址，共 7bit，主机正是利用该地址对设备进行访问
i2c 支持多主控，任何时间点都只能有一个主控。
i2c 器件的 SDA 引脚和 SCL 引脚是开漏电路形式，因此，SDA 和 SCL 总线都需要连接上拉电阻，当总线空闲时，两条总线均为高电平。
各器件的 SDA 和 SCL 信号线在总线上都是线与关系。（即连接到总线上的任意器件输出低电平都会将总线信号拉低）

三、i2c 协议层

协议层定义了 i2c 的通信协议。一个完整的 i2c 数据传输包含开始信号，器件地址，读写控制，器件内访问地址，有效数据，应答信号和结束信号。

1.i2c 总线的位传输

数据传输：当 SCL 位高电平时，SDA 必须保持稳定，SDA 上传 1 位数据。

数据改变：当 SCL 为低电平时，SDA 才可以改变电平

i2c位传输时序图

2.i2c 总线的开始和结束信号

开始信号：SCL 为高电平时，主机将 SDA 拉低，表示数据传输即将开始。

结束信号：在 SDA 为低电平时，主机将 SCL 拉高并保持高电平，然后在将 SDA 拉高，表示传输结束。

3.i2c 应答信号

在主机发送完每一个字节数据后，释放 SDA（保持高电平），被寻址的接收器在成功接收到每一个字节后，必须产生一个应答ACK（从机将 SDA 拉低，使它在这个时钟脉冲的高电平期间保持稳定的低电平）
当从机接收不到数据或通信故障时，从机必须使 SDA 保持高电平，主机产生一个结束信号终止传输或者产生新的传输。

4.i2c 总线的仲裁机制

SDA 的仲裁也是建立在总线具有线与逻辑功能的原理上的。
节点在发送 1 位数据后，比较总线上所呈现的数据与自己发送的是否一致。是，继续发送；否则，退出竞争。
SDA 的仲裁可以保证 i2c 总线系统在多个主节点上同时企图控制总线时通信正常进行而且数据不丢失（总线系统通过仲裁只允许一个主节点可以继续占据总线）
当 SCL 为高电平时，仲裁在 SDA 上发生。在其他主机发送低电平时，发送高电平的主机将会断开它的数据传输级，因为总线上的电平是线与连接。

四、访问 i2c 总线设备

一般情况下 MCU 的 I2C 器件都是作为主机和从机通讯，在 RT-Thread 中将 I2C 主机虚拟为 I2C 总线设备，I2C 从机通过 I2C 设备接口和 I2C 总线通讯，相关接口如下所示：

五、查找 i2c 总线设备

在使用 I2C 总线设备前需要根据 I2C 总线设备名称获取设备句柄，进而才可以操作 I2C 总线设备，查找设备函数如下所示，

rt_device_t rt_device_find(const char* name);

复制代码

一般情况下，注册到系统的 I2C 设备名称为 i2c0 ，i2c1 等，使用示例如下所示：

#define AHT10_I2C_BUS_NAME "i2c1" /* 传感器连接的I2C总线设备名称*/struct rt_i2c_bus_device *i2c_bus; /* I2C总线设备句柄*//* 查找I2C总线设备， 获取I2C总线设备句柄*/i2c_bus = (struct rt_i2c_bus_device *)rt_device_find(name);

复制代码

六、数据传输

获取到 I2C 总线设备句柄就可以使用 rt_i2c_transfer() 进行数据传输。函数原型如下所示：

rt_size_t rt_i2c_transfer(struct rt_i2c_bus_device *bus,                    struct rt_i2c_msg msgs[],                    rt_uint32_t num);

复制代码

和 SPI 总线的自定义传输接口一样，I2C 总线的自定义传输接口传输的数据也是以一个消息为单位。
参数 msgs[] 指向待传输的消息数组，用户可以自定义每条消息的内容，实现 I2C 总线所支持的 2 种不同的数据传输模式。如果主设备需要发送重复开始条件，则需要发送 2 个消息。
!!! note “注意事项” 此函数会调用rt_mutex_take(), 不能在中断服务程序里面调用，会导致assertion报错。

I2C 消息数据结构原型如下：

struct rt_i2c_msg{rt_uint16_t addr; /* 从机地址*/rt_uint16_t flags; /* 读、写标志等*/rt_uint16_t len; /* 读写数据字节数*/rt_uint8_t *buf; /* 读写数据缓冲区指针　*/}

复制代码

从机地址 addr：支持 7 位和 10 位二进制地址，需查看不同设备的数据手册。
标志 flags 可取值为以下宏定义，根据需要可以与其他宏使用位运算“|” 组合起来使用。
!!! note “注意事项” RT-Thread I2C 设备接口使用的从机地址均不包含读写位，读写位控制需修改标志flags。

#define RT_I2C_WR 0x0000 /* 写标志*/#define RT_I2C_RD (1u << 0) /* 读标志*/#define RT_I2C_ADDR_10BIT (1u << 2) /* 10 位地址模式*/#define RT_I2C_NO_START (1u << 4) /* 无开始条件*/#define RT_I2C_IGNORE_NACK (1u << 5) /* 忽视NACK */#define RT_I2C_NO_READ_ACK (1u << 6) /* 读的时候不发送ACK */

复制代码

使用示例如下所示：

#define AHT10_I2C_BUS_NAME "i2c1" /* 传感器连接的I2C总线设备名称*/#define AHT10_ADDR 0x38 /* 从机地址*/
struct rt_i2c_bus_device *i2c_bus; /* I2C总线设备句柄*/
/* 查找I2C总线设备， 获取I2C总线设备句柄*/i2c_bus = (struct rt_i2c_bus_device *)rt_device_find(name);
/* 读传感器寄存器数据*/static rt_err_t read_regs(struct rt_i2c_bus_device *bus, rt_uint8_t len, rt_uint8_t*buf){  struct rt_i2c_msg msgs;  msgs.addr = AHT10_ADDR; /* 从机地址*/  msgs.flags = RT_I2C_RD; /* 读标志*/  msgs.buf = buf; /* 读写数据缓冲区指针　*/  msgs.len = len; /* 读写数据字节数*/  /* 调用I2C设备接口传输数据*/  if (rt_i2c_transfer(bus, &msgs, 1) == 1)  {    return RT_EOK;  }  else  {    return -RT_ERROR;  }}

复制代码

七、I2C 总线设备使用示例

I2C 设备的具体使用方式可以参考如下示例代码，示例代码的主要步骤如下：

这两个函数分别调用了 rt_i2c_transfer() 传输数据。读取温湿度信息的函数 read_temp_humi() 则是调用这两个函数完成功能。

/** 程序清单： 这是一个I2C 设备使用例程* 例程导出了i2c_aht10_sample 命令到控制终端* 命令调用格式： i2c_aht10_sample i2c1* 命令解释： 命令第二个参数是要使用的I2C总线设备名称， 为空则使用默认的I2C总线设备* 程序功能： 通过I2C 设备读取温湿度传感器aht10 的温湿度数据并打印*/#include <rtthread.h>#include <rtdevice.h>
#define AHT10_I2C_BUS_NAME "i2c1" /* 传感器连接的I2C总线设备名称*/#define AHT10_ADDR 0x38 /* 从机地址*/#define AHT10_CALIBRATION_CMD 0xE1 /* 校准命令*/#define AHT10_NORMAL_CMD 0xA8 /* 一般命令*/#define AHT10_GET_DATA 0xAC /* 获取数据命令*/
static struct rt_i2c_bus_device *i2c_bus = RT_NULL; /* I2C总线设备句柄*/static rt_bool_t initialized = RT_FALSE; /* 传感器初始化状态*/
/* 写传感器寄存器*/static rt_err_t write_reg(struct rt_i2c_bus_device *bus, rt_uint8_t reg, rt_uint8_t*data){  rt_uint8_t buf[3];  struct rt_i2c_msg msgs;  buf[0] = reg; //cmd  buf[1] = data[0];  buf[2] = data[1];  msgs.addr = AHT10_ADDR;  msgs.flags = RT_I2C_WR;  msgs.buf = buf;  msgs.len = 3;    /* 调用I2C设备接口传输数据*/  if (rt_i2c_transfer(bus, &msgs, 1) == 1)  {    return RT_EOK;  }  else  {    return -RT_ERROR;  }}
/* 读传感器寄存器数据*/static rt_err_t read_regs(struct rt_i2c_bus_device *bus, rt_uint8_t len, rt_uint8_t*buf){  struct rt_i2c_msg msgs;  msgs.addr = AHT10_ADDR;  msgs.flags = RT_I2C_RD;  msgs.buf = buf;  msgs.len = len;
  /* 调用I2C设备接口传输数据*/  if (rt_i2c_transfer(bus, &msgs, 1) == 1)  {    return RT_EOK;  }  else  {    return -RT_ERROR;  }}
static void read_temp_humi(float *cur_temp, float *cur_humi){  rt_uint8_t temp[6];  write_reg(i2c_bus, AHT10_GET_DATA, 0); /* 发送命令*/  rt_thread_mdelay(400);  read_regs(i2c_bus, 6, temp); /* 获取传感器数据*/  /* 湿度数据转换*/  *cur_humi = (temp[1] << 12 | temp[2] << 4 | (temp[3] & 0xf0) >> 4) * 100.0 / (1<< 20);  /* 温度数据转换*/  *cur_temp = ((temp[3] & 0xf) << 16 | temp[4] << 8 | temp[5]) * 200.0 / (1 << 20)- 50;}
static void aht10_init(const char *name){  rt_uint8_t temp[2] = {0, 0};  /* 查找I2C总线设备， 获取I2C总线设备句柄*/  i2c_bus = (struct rt_i2c_bus_device *)rt_device_find(name);  if (i2c_bus == RT_NULL)  {    rt_kprintf("can't find %s device!\n", name);  }  else  {    write_reg(i2c_bus, AHT10_NORMAL_CMD, temp);    rt_thread_mdelay(400);    temp[0] = 0x08;    temp[1] = 0x00;    write_reg(i2c_bus, AHT10_CALIBRATION_CMD, temp);    rt_thread_mdelay(400);    initialized = RT_TRUE;  }}
static void i2c_aht10_sample(int argc, char *argv[]){  float humidity, temperature;  char name[RT_NAME_MAX];  humidity = 0.0;  temperature = 0.0;  if (argc == 2)  {    rt_strncpy(name, argv[1], RT_NAME_MAX);  }  else  {    rt_strncpy(name, AHT10_I2C_BUS_NAME, RT_NAME_MAX);  }  if (!initialized)  {    /* 传感器初始化*/    aht10_init(name);  }  if (initialized)  {    /* 读取温湿度数据*/    read_temp_humi(&temperature, &humidity);    rt_kprintf("read aht10 sensor humidity : %d.%d %%\n", (int)humidity, (int)    (humidity * 10) % 10);    if( temperature >= 0 )    {      rt_kprintf("read aht10 sensor temperature: %d.%d°C\n", (int)temperature,      (int)(temperature * 10) % 10);    }    else    {      rt_kprintf("read aht10 sensor temperature: %d.%d°C\n", (int)temperature,      (int)(-temperature * 10) % 10);    }  }  else  {    rt_kprintf("initialize sensor failed!\n");  }}/* 导出到msh 命令列表中*/MSH_CMD_EXPORT(i2c_aht10_sample, i2c aht10 sample);

复制代码

参考资料：

发布于: 刚刚阅读数: 3

原文链接:【http://xie.infoq.cn/article/6d063b0d47111402235e907fd】。文章转载请联系作者。

攻城狮杰森

关注

#以梦为码，不负年华 2022.07.02 加入

目前计算机专业在读，阿里云专家博主，华为云云享专家，51CTO 博客专家，喜欢各类竞赛，熟悉 c/c++，java，html，css，javascript，python...竭力成为一名 Full Stack Developer. 关注杰森，与你同行，共同进步！

发布

暂无评论

创作场景

【玩转 RT-Thread】I2C 内核

一、i2c 协议

二、i2c 物理层

三、i2c 协议层

1.i2c 总线的位传输

2.i2c 总线的开始和结束信号

3.i2c 应答信号

4.i2c 总线的仲裁机制

四、访问 i2c 总线设备

五、查找 i2c 总线设备

六、数据传输

七、I2C 总线设备使用示例

攻城狮杰森

评论