0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看威廉希尔官方网站 视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

RT-Thread记录(十、全面认识 I/O 设备模型)

矜辰所致 来源:矜辰所致 作者:矜辰所致 2022-06-30 10:38 次阅读
学完 RT-Thread 内核,从本文开始熟悉了解 RT-Thread I/O 设备管理相关知识。

目录

前言
一、RT-Thread 的 I/O设备管理

1.1 什么是 I/O 设备模型
1.2 I/O 设备模型框架解析
1.2.1 应用程序
1.2.2 I/O 设备管理层
1.2.3 设备驱动框架层
1.2.4 设备驱动层
1.2.5 硬件
1.3 I/O 设备操作逻辑说明
1.4 I/O 设备模型框架有什么用?

二、I/O 设备模型操作 API

2.1 I/O 设备控制块
2.1.1 设备类型 type
2.1.2 设备注册 flag
2.1.3 设备访问 open_flag
2.2 创建 I/O 设备相关
2.2.1 创建设备
2.2.2 销毁设备
2.2.3 设备注册
2.2.4 设备注销
2.3 访问 I/O 设备相关
2.3.1 查找设备
2.3.2 初始化设备
2.3.3 打开和关闭设备
2.3.4 读写设备
2.3.5 控制设备
2.3.6 数据收发回调

三、新建 I/O 设备模型实例
结语

前言

我们已经把 RT-Thread 内核学习完成,也已经使用 RT-Thread 做了一个实例应用。

但是作为一个操作系统, RT-Thread 除了内核部分还有自己的设备框架,类似于 Linux 操作系统设备的管理方式的 I/O 设备模型。

从本文开始,我们要开始学习了解 RT-Thread 的 I/O 设备模型。

说明,概念性质的说明主要还是使用引用方式,毕竟有权威的官方在,对于一些细节的理解,我会阐述自己的看法,同时会设计一些实例加深我们对基本概念的理解。

❤️ 我想做到的是,仅此一片文章,让所有人都能明白RT-Thread 的I/O 设备模型 ❤️

一、RT-Thread 的 I/O设备管理

有些小伙伴在刚接触到这个概念的时候还不太明白, I/O 设备模型,IO口? IO口的模型?

注意这里的 I/O 指的是 Input/Output。I/O 设备,就是指的输入 / 输出设备。

所谓 I/O 设备模型,指的是 RT-Thread 把所有的 输入 / 输出设备当做一类对象,然后通过自己的一套体系对这类对象进行管理,这类 I/O 设备对象就可以认为是 I/O 设备模型。

RT-Thread 提供了一套模型框架用来对所有的输入/输出设备进行管理的,名叫 I/O 设备模型框架 ,其 位于硬件层和应用程序之间,包括IO设备管理层、设备驱动框架层和设备驱动层,向上层层抽象,目标是针对各种不同的I/O设备提供给应用程序相同的接口,如下图:

pYYBAGK9DJWALOWBAAOPg3TZ6Ho023.png

1.2 I/O 设备模型框架解析

根据上图,结合工程代码,我们对每个层分别说:

1.2.1 应用程序

我们写的应用程序,调用 I/O 设备管理层给的接口进行底层硬件操作;

对应 main.c :

poYBAGK9DJWAK43VAAA3FT2lzKM769.png

1.2.2 I/O 设备管理层

I/O 设备管理层实现了对设备驱动程序的封装。
应用程序通过 I/O 设备管理接口获得正确的设备驱动,然后通过这个设备驱动与底层 I/O 硬件设备进行数据交互。
设备驱动程序的升级、更替不会对上层应用产生影响。这种方式使得设备的硬件操作相关的代码能够独立于应用程序而存在,双方只需关注各自的功能实现,从而降低了代码的耦合性、复杂性,提高了系统的可靠性。

对应 device.c

pYYBAGK9DJWAEce_AAApcEWezF4881.png

1.2.3 设备驱动框架层

设备驱动框架层对同类硬件设备驱动的抽象,将不同厂家的同类硬件设备驱动中相同的部分抽取出来,将不同部分留出接口,由驱动程序实现。

对应的比如 serial.c 等

poYBAGK9DJaAG9KJAAA3hwS3nZU266.png

❤️ 上面的 I/O 设备管理层 和 设备驱动框架层 是属于RT-Thread 系统的范畴,官方已写好,所以在项目中的位置存放于 rt-thread 文件夹下面。

1.2.4 设备驱动层

设备驱动层是一组驱使硬件设备工作的程序,实现访问硬件设备的功能。它负责创建和注册 I/O 设备,就类似于使用裸机编写程序时候的底层驱动。
裸机的驱动是直接被应用层调用,这里的驱动是提供给 设备驱动框架层调用 或者 直接给 I/O 设备管理层调用的。

对于一些常用的芯片或者与官方有合作的芯片,官方也会提供了写好的驱动,比如STM32,下图就是官方已经写好的基于STM32 的设备驱动层的代码。

对应比如 drv_gpio.c 、drv_usart.c 这些 :

pYYBAGK9DJaAf10ZAAA651d5Q04796.png

❤️ 设备驱动层的编写是需要基于芯片或外设的手册、SDK,是需要额外实现的。
但是有些常用芯片和外设官方已经帮我们写好了,比如基于 STM32 的 HAL 库,RT-Thread官方已经实现了基于 STM32 的设备驱动层 。

1.2.5 硬件层

比如Flash芯片,SD卡,stm32芯片等外设和MCU设备。

1.3 I/O 设备操作逻辑说明

简单介绍一下 I/O 设备操作逻辑,这部分应用官方的说明。

对于操作逻辑简单的设备,可以不经过设备驱动框架层,直接将设备注册到 I/O 设备管理器中,过程如下:

在我们本文后面的新建设备模型实例中就举了个简单设备的例子。

poYBAGK9DJaASOvsAADEkSQNTGw266.png

对于复杂点的设备,需要经过设备驱动框架层:

pYYBAGK9DJaAXsODAACyCrlrinY973.pngpoYBAGK9DJaADCALAADNyf5MhT0777.png

为了更好的理解上面的流程,可以结合工程源码理解,多看源码,比如下图所示:

pYYBAGK9DJeAKfIJAAD8rGHr6D0552.png

1.4 I/O 设备模型框架有什么用?

有很多初学者会问, I/O 设备模型意义在哪里? 在裸机使用中,比如操作一个IO口,直接调用驱动函数,不是更简单,更直接,使用了设个模型,反而变得复杂了?

在某些时候,如果你只使用一种芯片一种方案,或许某种意义上说, I/O 设备模型确实可能会比直接调用驱动函数复杂。 也可以说,你使用的方案单一,项目简单,没有必要使用 I/O 设备模型,甚至可能连 RTOS 都不一定需要。

总之就是,只用一种芯片方案简单项目或者内存空间实在有限,完全是可以不用这个框架,直接用 RT-Thread Nano 完成功能,和我们前面讲的项目实例一样完成,是没有问题的!

但是作为一个工程师,不能局限在一种方案上面,尤其当今芯片市场变幻莫测,指不定哪天需要换芯片,换方案呢? 而且 RT-Thread 作为一个面向对象思想设计的操作系统,必须得全面考虑,需要降低了代码的耦合性、复杂性,提高了系统的可靠性,能够使得系统运行与不同的芯片设备上。

如果没有 I/O 设备模型,那么每次换方案,从底层到应用层所有的代码基本上都得重写,对于简单的项目无所谓,对于复杂一点的项目,那可是需要花费大量功夫。

使用了 RT-Thread 的 I/O 设备模型,不管你使用哪种MCU,应用层对设备操作的函数一模一样,设备驱动程序的升级、更替不会对上层应用产生影响。这种方式使得设备的硬件操作相关的代码能够独立于应用程序而存在,双方只需关注各自的功能实现。

如果学过 Linux 的朋友肯定知道,RT-Thread 的 I/O 设备模型 思想 是和 Linux 类似的,作为嵌入式工程师,如果你懂 Linux,那么就应该知道 I/O 设备模型框架 的优点。如果你不懂 Linux,那么学会了 RT-Thread 操作系统的 I/O 设备模型,对于以后深入学习 Linux 操作系统,也是有帮助的 。 这话没毛病! 感觉怎么说怎么有道理,人往高处走嘛!= =!

所有最终结果就是,反正就是好,人往高处走,学会了没坏处 = =!

二、I/O 设备模型操作 API

上文我们说明了RT-Thread I/O 设备模型的基本概念先关内容,也了解了 I/O 设备模型框架以及操作逻辑,那么我们用户该如何来实现这一流程呢?

所以现在我们就来学习一下I/O设备模型操作的相关API函数,包括创建、注册、访问等 。。。

2.1 I/O 设备控制块

我们不止一次的说明了 RT-Thread 的面向对象的思想,在RT-Thread中,设备也是一种内核对象,那么他和以前说的线程,IPC机制,定时器等对象一样,有自己的对象控制块。

在以前博文:RT-Thread记录(六、IPC机制之信号量、互斥量和事件集)这里再次额外说明一下,因为只要理解了这种思想,对于学会他们的使用就更加简单了,在IPC机制的时候我们使用图片说明过:

poYBAGK9DJeAZ3NoAAPLTvh7m9w388.pngpYYBAGK9DJiACQcdAAQfsPD-ENk782.png

其实我们可以看一下设备对象的控制块:

poYBAGK9DJiAIzRcAAEkupi7DCI510.png

上源码方便以后复制:

/**
 * Device structure 设备控制块
 */
struct rt_device
{
    struct rt_object          parent;                   /**< inherit from rt_object */

    enum rt_device_class_type type;                     /**< device type */
    rt_uint16_t               flag;                     /**< device flag */
    rt_uint16_t               open_flag;                /**< device open flag */

    rt_uint8_t                ref_count;                /**< reference count */
    rt_uint8_t                device_id;                /**< 0 - 255 */

    /* device call back */
    rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size);
    rt_err_t (*tx_complete)(rt_device_t dev, void *buffer);

#ifdef RT_USING_DEVICE_OPS
    const struct rt_device_ops *ops;
#else
    /* common device interface */
    rt_err_t  (*init)   (rt_device_t dev);
    rt_err_t  (*open)   (rt_device_t dev, rt_uint16_t oflag);
    rt_err_t  (*close)  (rt_device_t dev);
    rt_size_t (*read)   (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size);
    rt_size_t (*write)  (rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size);
    rt_err_t  (*control)(rt_device_t dev, int cmd, void *args);
#endif

#if defined(RT_USING_POSIX)
    const struct dfs_file_ops *fops;
    struct rt_wqueue wait_queue;
#endif

    void                     *user_data;                /**< device private data */
};

2.1.1 设备类型 type

设备对象的控制块中对于设备类型使用了一个rt_device_class_type枚举的方式,其可能的设备类型如下(简单的没有注释,还有部分吗不太清楚的,以后更新):

pYYBAGK9DJiAIFJlAAEf0PiIGlg009.png

设备类型 需要在创建的时候选择好,写驱动的时候应该知道自己写的是什么类型的设备。

2.1.2 设备注册 flag

设备对象的控制块中有一个 flag 参数设备模式标志 ,表示设备是属于什么状态的设备,可读、可写、收发等,其可以有的参数如下:

poYBAGK9DJiAO5iiAADbHHtBd0s404.png

注意,该标志可以采用或的方式支持多种参数。

设备注册 flag 需要在创建的时候选择好,写驱动的时候应该知道自己写的设备是什么状态,比如只读。只写,中断接收之类的。

2.1.3 设备访问 open_flag

设备对象的控制块中有一个 open_flag 参数,设备打开模式标志 ,表示对设备进行什么操作,其可以有的参数如下:

pYYBAGK9DJiAQMcEAACi9CQYMmU840.png

设备访问的时候,需要使用这个 open_flag 来判断需要对设备进行什么操作,是读?还是写? 还是发送等。。。

❤️ 介绍了 I/O 设备控制块,让我们清楚我们要操作的对象是什么,我们在 设备驱动层 要写的设备驱动以及上层应用对 I/O 设备的访问, 就是基于这个控制块来进行的。

2.2 创建 I/O 设备相关

我们按照 先创建设备,再访问设备 的顺序来介绍对于的 API 函数。

2.2.1 创建设备

老规矩用源码,解释看注释(使用起来也方便复制 ~ ~!):

/*
参数的含义:
1、type 		设备类型,上面 2.1.1 小结说明的设备类型
2、attach_size  用户数据大小
返回值:
创建成功,返回设备的控制块指针
创建失败,返回RT_BULL 
*/

rt_device_t rt_device_create(int type, int attach_size)

/**
 * device (I/O) class type  设备类型
 */
enum rt_device_class_type
{
    RT_Device_Class_Char = 0,                           /**< character device */
    RT_Device_Class_Block,                              /**< block device */
    RT_Device_Class_NetIf,                              /**< net interface */
    RT_Device_Class_MTD,                                /**< memory device */
    RT_Device_Class_CAN,                                /**< CAN device */
    RT_Device_Class_RTC,                                /**< RTC device */
    RT_Device_Class_Sound,                              /**< Sound device */
    RT_Device_Class_Graphic,                            /**< Graphic device */
    RT_Device_Class_I2CBUS,                             /**< I2C bus device */
    RT_Device_Class_USBDevice,                          /**< USB slave device */
    RT_Device_Class_USBHost,                            /**< USB host bus */
    RT_Device_Class_SPIBUS,                             /**< SPI bus device */
    RT_Device_Class_SPIDevice,                          /**< SPI device */
    RT_Device_Class_SDIO,                               /**< SDIO bus device */
    RT_Device_Class_PM,                                 /**< PM pseudo device */
    RT_Device_Class_Pipe,                               /**< Pipe device */
    RT_Device_Class_Portal,                             /**< Portal device */
    RT_Device_Class_Timer,                              /**< Timer device */
    RT_Device_Class_Miscellaneous,                      /**< Miscellaneous device */
    RT_Device_Class_Sensor,                             /**< Sensor device */
    RT_Device_Class_Touch,                              /**< Touch device */
    RT_Device_Class_PHY,                                /**< PHY device */
    RT_Device_Class_Unknown                             /**< unknown device */
};

设备被创建后,需要实现它访问硬件的操作方法,要按照下面的函数指针实现这些对于设备的操作函数:

/* common device interface */
    rt_err_t  (*init)   (rt_device_t dev);
    rt_err_t  (*open)   (rt_device_t dev, rt_uint16_t oflag);
    rt_err_t  (*close)  (rt_device_t dev);
    rt_size_t (*read)   (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size);
    rt_size_t (*write)  (rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size);
    rt_err_t  (*control)(rt_device_t dev, int cmd, void *args);

这里引用官方的说明:

poYBAGK9DJmAbYFbAAI0qwEx3Bg850.png

2.2.2 销毁设备

此函数不一定需要使用,但是有创建就应该有销毁:

/*
参数的含义:
dev 	设备句柄
*/
void rt_device_destroy(rt_device_t dev)

2.2.3 设备注册

设备被创建后,需要注册到 I/O 设备管理器中,应用程序才能够访问:

/*
参数的含义:
dev 	设备句柄
name 	设备名称,
设备名称的最大长度由 rtconfig.h 中定义的宏 RT_NAME_MAX 指定,多余部分会被自动截掉
flags 	设备模式标志,就是上面介绍的 2.1.2 设备注册 flag
返回值:
RT_EOK 	注册成功
-RT_ERROR 	注册失败,dev 为空或者 name 已经存在
*/
rt_err_t rt_device_register(rt_device_t dev,
                            const char *name,
                            rt_uint16_t flags)


/*设备注册 flag*/
#define RT_DEVICE_FLAG_DEACTIVATE       0x000           /**< device is not not initialized */

#define RT_DEVICE_FLAG_RDONLY           0x001           /**< read only */
#define RT_DEVICE_FLAG_WRONLY           0x002           /**< write only */
#define RT_DEVICE_FLAG_RDWR             0x003           /**< read and write */

#define RT_DEVICE_FLAG_REMOVABLE        0x004           /**< removable device */
#define RT_DEVICE_FLAG_STANDALONE       0x008           /**< standalone device */
#define RT_DEVICE_FLAG_ACTIVATED        0x010           /**< device is activated */
#define RT_DEVICE_FLAG_SUSPENDED        0x020           /**< device is suspended */
#define RT_DEVICE_FLAG_STREAM           0x040           /**< stream mode */

#define RT_DEVICE_FLAG_INT_RX           0x100           /**< INT mode on Rx */
#define RT_DEVICE_FLAG_DMA_RX           0x200           /**< DMA mode on Rx */
#define RT_DEVICE_FLAG_INT_TX           0x400           /**< INT mode on Tx */
#define RT_DEVICE_FLAG_DMA_TX           0x800           /**< DMA mode on Tx */
上面需要额外说明的一点,设备流模式 `RT_DEVICE_FLAG_STREAM` 参数用于向串口终端输出字符串:
当输出的字符是 “\n” 时,自动在前面补一个 “\r” 做分行。

2.2.4 设备注销

创建对销毁,注册对注销:

/**
参数 	描述
dev 	设备句柄
返回 	——
RT_EOK 	成功
 */
rt_err_t rt_device_unregister(rt_device_t dev)

当设备注销后的,设备将从设备管理器中移除,也就不能再通过设备查找搜索到该设备。注销设备不会释放设备控制块占用的内存。
注销只是把这个 设备对象结构体 从管理链表中去掉,并不会释放这个对象结构体的空间,要释放空间需要调用销毁设备函数。

❤️ 创建 I/O 设备相关的函数,和 I/O 设备模型框架中 设备驱动层 有关,在我们底层写驱动的时候需要使用。

2.3 访问 I/O 设备相关

上面我们说的创建 I/O 设备相关是和 设备驱动层 有关的代码,本小结说的访问 I/O 设备就是和 应用程序有关的代码,就是告诉我们应用程序怎么去操作我们上面创建的设备。

I/O 设备管理接口与 I/O 设备的操作方法的映射关系下图:

pYYBAGK9DJmAYOf9AAERyxaJSRg014.png

2.3.1 查找设备

注册过的设备才能被查找到,名字对应注册时候使用的名字:

/**
参数 	描述
name 	设备名称
返回 	——
设备句柄 	查找到对应设备将返回相应的设备句柄
RT_NULL 	没有找到相应的设备对象
 */
rt_device_t rt_device_find(const char *name)

2.3.2 初始化设备

对应底层rt_err_t (*init) (rt_device_t dev); 的实现函数:

/**
参数 	描述
dev 	设备句柄
返回 	——
RT_EOK 	设备初始化成功
错误码 	设备初始化失败
 */
rt_err_t rt_device_init(rt_device_t dev)

当一个设备已经初始化成功后,调用这个接口将不再重复做初始化 0。

2.3.3 打开和关闭设备

打开设备:

对应底层rt_err_t (*open) (rt_device_t dev, rt_uint16_t oflag); 的实现函数:

/*
参数 	描述
dev 	设备句柄
oflags 	设备打开模式标志,上面 2.1.3 小结说明的设备访问 open_flag
返回 	——
RT_EOK 	设备打开成功
-RT_EBUSY 	如果设备注册时指定的参数中包括 RT_DEVICE_FLAG_STANDALONE 参数,此设备将不允许重复打开
其他错误码 	设备打开失败
*/
rt_err_t  rt_device_open (rt_device_t dev, rt_uint16_t oflag);

#define RT_DEVICE_FLAG_INT_RX           0x100           /**< INT mode on Rx */
#define RT_DEVICE_FLAG_DMA_RX           0x200           /**< DMA mode on Rx */
#define RT_DEVICE_FLAG_INT_TX           0x400           /**< INT mode on Tx */
#define RT_DEVICE_FLAG_DMA_TX           0x800           /**< DMA mode on Tx */

#define RT_DEVICE_OFLAG_CLOSE           0x000           /**< 设备已经关闭(内部使用) */
#define RT_DEVICE_OFLAG_RDONLY          0x001           /**< read only access */
#define RT_DEVICE_OFLAG_WRONLY          0x002           /**< write only access */
#define RT_DEVICE_OFLAG_RDWR            0x003           /**< read and write */
#define RT_DEVICE_OFLAG_OPEN            0x008           /**< device is opened */
#define RT_DEVICE_OFLAG_MASK            0xf0f           /**< mask of open flag */

注:如果上层应用程序需要设置设备的接收回调函数,则必须以 RT_DEVICE_FLAG_INT_RX 或者 RT_DEVICE_FLAG_DMA_RX 的方式打开设备,否则不会回调函数。

关闭设备:

对应底层rt_err_t (*close) (rt_device_t dev); 的实现函数:

/*
dev 	设备句柄
返回 	——
RT_EOK 	关闭设备成功
-RT_ERROR 	设备已经完全关闭,不能重复关闭设备
其他错误码 	关闭设备失败
*/
rt_err_t  rt_device_open (rt_device_t dev, rt_uint16_t oflag);

关闭设备接口和打开设备接口需配对使用,打开一次设备对应要关闭一次设备,这样设备才会被完全关闭,否则设备仍处于未关闭状态。

2.3.4 读写设备

读设备:

对应底层rt_size_t (*read) (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size); 的实现函数:

/**
参数 	描述
dev 	设备句柄
pos 	读取数据偏移量
buffer 	内存缓冲区指针,读取的数据将会被保存在缓冲区中
size 	读取数据的大小
返回 	——
读到数据的实际大小 	如果是字符设备,返回大小以字节为单位,如果是块设备,返回的大小以块为单位
0 	需要读取当前线程的 errno 来判断错误状态
 */
rt_size_t rt_device_read(rt_device_t dev,
                         rt_off_t    pos,
                         void       *buffer,
                         rt_size_t   size)

调用这个函数,会从 dev 设备中读取数据,并存放在 buffer 缓冲区中,这个缓冲区的最大长度是 size,pos 根据不同的设备类别有不同的意义。

写设备:

对应底层rt_size_t (*write) (rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size); 的实现函数:

/**
参数 	描述
dev 	设备句柄
pos 	写入数据偏移量
buffer 	内存缓冲区指针,放置要写入的数据
size 	写入数据的大小
返回 	——
写入数据的实际大小 	如果是字符设备,返回大小以字节为单位;如果是块设备,返回的大小以块为单位
0 	需要读取当前线程的 errno 来判断错误状态
 */
rt_size_t rt_device_write(rt_device_t dev,
                          rt_off_t    pos,
                          const void *buffer,
                          rt_size_t   size)

调用这个函数,会把缓冲区 buffer 中的数据写入到设备 dev 中,写入数据的最大长度是 size,pos 根据不同的设备类别存在不同的意义。

2.3.5 控制设备

对应底层rt_err_t (*control)(rt_device_t dev, int cmd, void *args); 的实现函数:

/**
参数 	描述
dev 	设备句柄
cmd 	命令控制字,这个参数通常与设备驱动程序相关,见下面列出的参数
arg 	控制的参数
返回 	——
RT_EOK 		函数执行成功
-RT_ENOSYS 	执行失败,dev 为空
其他错误码 	执行失败
 */
rt_err_t rt_device_control(rt_device_t dev, int cmd, void *arg)


/**
 * general device commands 上面 cmd 的参数
 */
#define RT_DEVICE_CTRL_RESUME           0x01            /**< resume device */
#define RT_DEVICE_CTRL_SUSPEND          0x02            /**< suspend device */
#define RT_DEVICE_CTRL_CONFIG           0x03            /**< configure device */
#define RT_DEVICE_CTRL_CLOSE            0x04            /**< close device */

#define RT_DEVICE_CTRL_SET_INT          0x10            /**< set interrupt */
#define RT_DEVICE_CTRL_CLR_INT          0x11            /**< clear interrupt */
#define RT_DEVICE_CTRL_GET_INT          0x12            /**< get interrupt status */

2.3.6 数据收发回调

这个对于 设备控制块中参数中的两个设备回调函数:

poYBAGK9DJmAQ-FvAAAjUuLwMOc015.png

硬件设备收到数据:

/**
参数 	描述
dev 	设备句柄
rx_ind 	回调函数指针
返回 	——
RT_EOK 	设置成功
 */
rt_err_t
rt_device_set_rx_indicate(rt_device_t dev,
                          rt_err_t (*rx_ind)(rt_device_t dev, rt_size_t size))

该函数的回调函数由调用者提供。当硬件设备接收到数据时,会回调这个函数并把收到的数据长度放在 size 参数中传递给上层应用。上层应用线程应在收到指示后,立刻从设备中读取数据。

硬件设备发送数据:

在应用程序调用 rt_device_write() 写入数据时,如果底层硬件能够支持自动发送,那么上层应用可以设置一个回调函数。
这个回调函数会在底层硬件数据发送完成后 (例如 DMA 传送完成或 FIFO 已经写入完毕产生完成中断时) 调用。

通过如下函数设置设备发送完成指示:

/**
参数 	描述
dev 	设备句柄
tx_done 	回调函数指针
返回 	——
RT_EOK 	设置成功
 */
rt_err_t
rt_device_set_tx_complete(rt_device_t dev,
                          rt_err_t (*tx_done)(rt_device_t dev, void *buffer))

调用这个函数时,回调函数由调用者提供,当硬件设备发送完数据时,由驱动程序回调这个函数并把发送完成的数据块地址 buffer 作为参数传递给上层应用。上层应用(线程)在收到指示时会根据发送 buffer 的情况,释放 buffer 内存块或将其作为下一个写数据的缓存。

❤️ 访问 I/O 设备相关的函数,和 I/O 设备模型框架中 应用程序 有关,是我们上层写应用程序直接调用的函数。

三、新建 I/O 设备模型实例

RT-Thread 驱动都是在 drivers 目录下面:

poYBAGK9DJmAYVBuAABCG9j0hGQ134.png

我们在目录下新建一个文件,作为驱动示例:

pYYBAGK9DJmAbSWvAADKwnU6FFs295.png

我们写一个简单的基本框架:

1、创建一个设备;
   使用 rt_device_create 创建一个设备,需要定义一个 rt_device_t 接口体接收设备设备句柄。

2、实现设备操作的函数:
   实现设备对象中对于 设备操作的init,open,close等 函数。

3、注册设备到 I/O 设备管理器;
   使用 rt_device_register 将设备注册到设备管理器。

drv_demo.c中,我们实现如下代码:

poYBAGK9DJmALQEkAABuTuaInAY314.png

其次,我们需要实现一下设备操作的函数:

pYYBAGK9DJqAQYcpAABPqLr1W74608.png

最后,别忘了使用 INIT_BOARD_EXPORT 把设备初始化的代码加入板级硬件初始化:

poYBAGK9DJqABG66AAAffT8TlJ8363.png

上一下设备模型实例代码:

#include 
#include 

rt_err_t  demo_init(rt_device_t dev)
{
    rt_kprintf("demo_init ok!\n");
    return 0;
}
rt_err_t  demo_open(rt_device_t dev, rt_uint16_t oflag)
{
    rt_kprintf("demo_open ok!\n");
    return 0;
}
rt_err_t  demo_cloes(rt_device_t dev)
{
    rt_kprintf("demo_cloes ok!\n");
    return 0;
}

int rt_drvdemo_init(void){

    rt_device_t demo_dev = RT_NULL;

    demo_dev = rt_device_create(RT_Device_Class_Char, 0);
    if(demo_dev == RT_NULL){
        LOG_E("demo device create failed...\n");
        return -1;
    }

    demo_dev->init=demo_init;
    demo_dev->open=demo_open;
    demo_dev->close=demo_cloes;

    rt_device_register(demo_dev,"drvdemo",RT_DEVICE_FLAG_RDWR);
    return 0;
}


INIT_BOARD_EXPORT(rt_drvdemo_init);

上面我们完成的是 设备驱动层的 代码,接下来我们还需要简单演示一下,如果在应用层 使用这个 demo 设备。

我们根据上文所介绍的 访问 I/O 设备 进行对应操作,这里直接上图说明一下使用流程:

pYYBAGK9DJqAJv7QAACs50bc4uU608.png

看一下测试结果,我们实现的 3 个驱动函数都只有打印输出,所以我们可以通过打印信息查看是否正确执行的驱动函数的内容:

poYBAGK9DJqAR76DAACrGvu2Bvw047.png

通过上面的测试,我们实现了一个简单的设备驱动的设计,虽然demo比较简单,但是经过这么一个过程可以让我们更加的理解 RT-Thread I/O 设备模型的工作方式和流程。

结语

本文全面了解了 RT-Thread I/O 设备模型,说明了设备模型存在的意义,描述了一下设备模型相关的操作函数,最后使用了一个新建 I/O设备模型的例子,说明了 I/O 设备模型 的工作方式。

在我们使用 RT-Thread 的时候,其实大部分常用的设备 RT-Thread 已经帮我们写好了驱动,我们直接在应用层调用操作接口即可,接下来的系列文章我们将要学习 RT-Thread 常用的 I/O 设备模型。


❤️ 希望开头的愿景能够实现,通过本文让所有人了解 RT-Thread I/O 设备模型 (* ̄︶ ̄) ❤️

本文就到这里,谢谢大家!

审核编辑:汤梓红

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 内核
    +关注

    关注

    3

    文章

    1372

    浏览量

    40282
  • Linux
    +关注

    关注

    87

    文章

    11296

    浏览量

    209365
  • 模型
    +关注

    关注

    1

    文章

    3229

    浏览量

    48813
  • RT-Thread
    +关注

    关注

    31

    文章

    1285

    浏览量

    40096
收藏 人收藏

    评论

    相关推荐

    RT-Thread上CAN实践

    开箱测试RT-Thread官方已完成了对英飞凌XMC7200EVK的移植,通过shell可以看到做好了uart3的console。本文将介绍如何进行RT-ThreadCan移植。接下来我们要完成CAN_FD的驱动移植,并正常启动RT-T
    的头像 发表于 11-13 01:03 1153次阅读
    <b class='flag-5'>RT-Thread</b>上CAN实践

    开源共生 商业共赢 | RT-Thread 2024开发者大会报名启动!

    亲爱的RT-Thread开发者我们很高兴地宣布,一年一度的RDC(RT-ThreadDeveloperConference,RT-Thread开发者大会)正式启动报名!2024RT-Threa
    的头像 发表于 10-29 08:06 382次阅读
    开源共生 商业共赢 | <b class='flag-5'>RT-Thread</b> 2024开发者大会报名启动!

    2024 RT-Thread全球巡回 线下培训火热来袭!

    亲爱的RT-Thread社区成员们:我们非常高兴地宣布,2024年RT-Thread全球开发者线下培训即将拉开帷幕!24年全球巡回培训将覆盖超10座城市及国家,为开发者提供一个深入学习RT-Thread嵌入式开发的绝佳机会。
    的头像 发表于 08-07 08:35 1190次阅读
    2024 <b class='flag-5'>RT-Thread</b>全球巡回 线下培训火热来袭!

    【好书推荐】RT-Thread设备驱动开发指南

    强烈,他们迫切地希望有一本可以指导他们在RT-Thread上开发驱动的指南。为了解决开发者的燃眉之急,《RT-Thread设备驱动开发指南》来了!希望帮助RT-Thre
    的头像 发表于 08-01 08:35 621次阅读
    【好书推荐】<b class='flag-5'>RT-Thread</b><b class='flag-5'>设备</b>驱动开发指南

    RT-Thread 新里程碑达成——GitHub Star 破万!

    RT-Thread实时操作系统开源项目在GitHub上的star数量突破一万!截止发文,RT-Thread作为实时操作系统在业界Star数量排名第一!仓库地址:https://github.com
    的头像 发表于 07-04 08:35 472次阅读
    <b class='flag-5'>RT-Thread</b> 新里程碑达成——GitHub Star 破万!

    基于 RT-Thread专业版的EtherCAT主站方案

    (一)方案介绍本方案基于RT-Thread专业版,在RT-Thread端集成EtherCAT主站协议,通过EtherCAT对伺服电机或远程IO进行实时控制,具备传输速度快,实时性高,扩展设备灵活等
    的头像 发表于 06-19 08:35 892次阅读
    基于 <b class='flag-5'>RT-Thread</b>专业版的EtherCAT主站方案

    6月6日杭州站RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    6月6日下午我们将在杭州举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 05-28 08:35 442次阅读
    6月6日杭州站<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    2024 RT-Thread 全球威廉希尔官方网站 大会演讲议程发布!

    RT-ThreadGlobalTechConference(RT-ThreadGTC,RT-Thread全球威廉希尔官方网站 大会)致力于围绕RT-Thread基础软件威廉希尔官方网站 发展、实践创新、开发者能力
    的头像 发表于 05-16 08:34 546次阅读
    2024 <b class='flag-5'>RT-Thread</b> 全球威廉希尔官方网站
大会演讲议程发布!

    RT-Thread混合部署Workshop北京站来啦!

    4月25日,下午我们将在北京举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 04-19 08:34 437次阅读
    <b class='flag-5'>RT-Thread</b>混合部署Workshop北京站来啦!

    4月25日北京站RT-Thread线下workshop,探索RT-Thread混合部署新模式

    4月25日,下午我们将在北京举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 04-16 08:35 417次阅读
    4月25日北京站<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式

    4月10日深圳场RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    4月10日我们将在深圳福田举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深嵌入式软件工程师农晓明老师为您讲
    的头像 发表于 03-27 11:36 817次阅读
    4月10日深圳场<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    4月10日深圳场RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    4月10日我们将在深圳福田举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 03-27 08:34 528次阅读
    4月10日深圳场<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    恩智浦半导体正式加入RT-Thread全球合作伙伴计划!

    前不久,恩智浦半导体正式加入RT-Thread全球合作伙伴计划,成为RT-Thread高级会员合作伙伴。同时,RT-Thread现已成为恩智浦注册合作伙伴(RT-Thread| 简介合
    的头像 发表于 03-14 10:40 616次阅读
    恩智浦半导体正式加入<b class='flag-5'>RT-Thread</b>全球合作伙伴计划!

    RT-Thread设备驱动开发指南》基础篇--以先楫bsp的hwtimer设备为例

    一、概述(一)RT-Thread设备驱动《RT-Thread设备驱动开发指南》书籍是RT-thread官方出品撰写,系统讲解
    的头像 发表于 02-24 08:16 1637次阅读
    《<b class='flag-5'>RT-Thread</b><b class='flag-5'>设备</b>驱动开发指南》基础篇--以先楫bsp的hwtimer<b class='flag-5'>设备</b>为例

    RT-Thread设备驱动开发指南基础篇—以先楫bsp的hwtimer设备为例

    RT-Thread设备驱动开发指南》书籍是RT-thread官方出品撰写,系统讲解RT-thread IO设备驱动开发方法,从三方面进行讲解
    的头像 发表于 02-20 16:01 1687次阅读
    <b class='flag-5'>RT-Thread</b><b class='flag-5'>设备</b>驱动开发指南基础篇—以先楫bsp的hwtimer<b class='flag-5'>设备</b>为例