RT-Thread-【2024_RSOC】设备和驱动——4.I2C设备使用RT-Thread问答社区

【2024_RSOC】设备和驱动——4.I2C设备使用

发布于 2024-07-27 23:45:16 浏览：670 订阅该版

#设备和驱动——4.I2C设备使用 
在使用RT的i2c用户接口函数之前，我们需要先将要使用的i2c启用。
打开even进入菜单
![3.png](https://oss-club.rt-thread.org/uploads/20240727/783cf3bac63c5e7305d6c877caf616c7.png.webp)
打开硬件驱动配置
![4.png](https://oss-club.rt-thread.org/uploads/20240727/83ec12ebc216e0c0900e82cc0fce161a.png)
打开片上外设
![5.png](https://oss-club.rt-thread.org/uploads/20240727/bd7e4bf320ee0263bd8c32689246a5fe.png)
选择自己要用的外设（这里的iic是软件配置的）
![1.png](https://oss-club.rt-thread.org/uploads/20240727/f77f585e174dd092fb865e8624e8113f.png.webp)
![2png.png](https://oss-club.rt-thread.org/uploads/20240727/0aaef61b7b83662ecc1805fa0fd08176.png.webp)

也就是说，我们除了这5个软件iic还可以自己利用RT的框架配置更多。看教程
打开bord文件夹下的Kconfig文件

![6.png](https://oss-club.rt-thread.org/uploads/20240727/a2ed122e98622f4a6c195e1e20015b35.png.webp)
往下找到iic的部分

![7.png](https://oss-club.rt-thread.org/uploads/20240727/7c0e0b68b737b9547d1b46185b2f7251.png.webp)
照着上面的语法抄一份（也可以自己定义）

![8.png](https://oss-club.rt-thread.org/uploads/20240727/51ff4391e6acbcd0c6311d9c71db4abd.png.webp)
然后打开软件iic的驱动.c文件和.h文件里配置内容
![9.png](https://oss-club.rt-thread.org/uploads/20240727/913598ea82ad3a3c175720e5c9c76670.png.webp)
![10.png](https://oss-club.rt-thread.org/uploads/20240727/30e6e5d51f1395cf409f73a2d678fab4.png.webp)
然后就可以在菜单里使能我们自己配置的iic6了

![11.png](https://oss-club.rt-thread.org/uploads/20240727/8ed9ac73f105c5fc220a133019080159.png)
使能之后可以在rtconfing文件中查看我们定义的宏了
![12.png](https://oss-club.rt-thread.org/uploads/20240727/2a69ec577c6ba8a9a09204ae8222e8e1.png.webp)
总结：其本质就是通过Kconfig这文件编写菜单选项来定义宏，使能这个宏之后又会定义我们自己配置iic6的宏，然后我们利用rt官方的iic驱动定义好iic的基础内容（时钟线和数据线）。那么在启用菜单选项后，程序就会通过这些宏是否定义来配置基础信息，最后注册设备。
##1.查找 I2C 总线设备
在使用 I2C 总线设备前需要根据 I2C 总线设备名称获取设备句柄，进而才可以操作 I2C 总线设备
```c
rt_device_t rt_device_find(const char* name);
name：I2C 总线设备名称，一般情况下，注册到系统的 I2C 设备名称为 i2c0 ，i2c1等。
返回：设备句柄
```
##2.数据传输
此函数会调用 rt_mutex_take(), 不能在中断服务程序里面调用，会导致 assertion 报错。
```c
rt_size_t rt_i2c_transfer(struct rt_i2c_bus_device *bus,
                          struct rt_i2c_msg         msgs[],
                          rt_uint32_t               num);
bus：I2C 总线设备句柄
msgs[]：待传输的消息数组指针，I2C 总线的自定义传输接口传输的数据也是以一个消息为单位。
消息数据结构原型：
struct rt_i2c_msg
{
    rt_uint16_t addr;    /* 从机地址 */（从机地址均不包含读写位，读写位
										控制需修改标志 flags）
    rt_uint16_t flags;   /* 读、写标志等 */
    rt_uint16_t len;     /* 读写数据字节数 */
    rt_uint8_t  *buf;    /* 读写数据缓冲区指针　*/
}
rt_uint16_t 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 RT_I2C_NO_STOP         (1u << 7)     /* 不发送结束位 */
num：消息数组的元素个数
返回：消息数组的元素个数
```
例程：

```c
void demo(void)
{
struct rt_i2c_bus_device * my_i2c_dev_t;
struct rt_i2c_msg         msgs[2];
rt_uint8_t wr_buff[1];
rt_uint8_t rd_buff[1];
my_i2c_dev_t =  ( struct rt_i2c_bus_device *)rt_device_find("i2c2");
if(my_i2c_dev_t !=NULL) 
   rt_kprintf("find_OK\n");   
else   
   rt_kprintf("find_NO\n");

wr_buff[0] = 0x1; 
rd_buff[0] = 0x1;
   
msgs[0].addr = 0x68;
msgs[0].flags = RT_I2C_WR;
msgs[0].buf = wr_buff;
msgs[0].len = 1;
 
msgs[1].addr = 0x68;
msgs[1].flags = RT_I2C_RD;
msgs[1].buf = rd_buff;
msgs[1].len = 1;
if(rt_i2c_transfer(my_i2c_dev_t,msgs,2) == 2) 
{
   rt_kprintf("DEMO_OK\n");
}
}
MSH_CMD_EXPORT(demo,demo);
```

**以下两个读写函数封装自 rt_i2c_transfer() 函数，用于读写I2C从设备的数据，更加简单易用，推荐使用。**
##3.主机发送

```c
rt_size_t rt_i2c_master_send(struct rt_i2c_bus_device *bus,
                             rt_uint16_t               addr,
                             rt_uint16_t               flags,
                             const rt_uint8_t         *buf,
                             rt_uint32_t               count);
bus：I2C 总线设备句柄
addr：I2C 从设备地址
flags：标志位，可为上文提到的除 RT_I2C_WR RT_I2C_RD之外的其他标志位，可以
	   进行 “|” 操作
buf：待发送数据缓冲区
count：待发送数据大小（单位：字节）
返回：消息数组的元素个数（1）
```
##3.主机读取
	
```c
rt_size_t rt_i2c_master_recv(struct rt_i2c_bus_device *bus,
                             rt_uint16_t               addr,
                             rt_uint16_t               flags,
                             rt_uint8_t               *buf,
                             rt_uint32_t               count);
bus：I2C 总线设备句柄
addr：I2C 从设备地址
flags：标志位，可为上文提到的除 RT_I2C_WR RT_I2C_RD之外的其他标志位，可以
	   进行 “|” 操作
buf：待发送数据缓冲区
count：待发送数据大小（单位：字节）
返回：消息数组的元素个数（1）
```