1 DHT11驱动架构
RT-Thread包含DHT11驱动,这里就没有去造轮子了,但是作为学习者,还是要去了解DHT11的原理及具体实现。这部分内容在笔者博客的STM32系列的外设篇已详细阐述,下面就DHT11驱动在RTT中的实现做个总结。
DHT11是采用单总线通讯的传感器,有的设备没有硬件单总线,DHT11的支持包采用 GPIO 模拟单总线时序。DHT11 的一次完整读时序需要 20ms,时间过长,故无法使用关中断或者关调度的方式实现独占 CPU 以保证时序完整正确。因此可能出现读取数据失败的情况。
DHT11的典型电路如下图所示。
Figure 1-1 DHT11典型电路
DATA 用于微处理器与 DHT11之间的通讯和同步,采用单总线数据格式,一次通讯时间4ms左右,数据分小数部分和整数部分,具体格式在下面说明,当前小数部分用于以后扩展,现读出为零.操作流程如下:
一次完整的数据传输为40bit,高位先出。
数据格式:8bit湿度整数数据+8bit湿度小数数据
+8bi温度整数数据+8bit温度小数数据
+8bit校验和
数据传送正确时校验和数据等于“8bit湿度整数数据+8bit湿度小数数据+8bi温度整数数据+8bit温度小数数据” 所得结果的末8位。
用户MCU发送一次开始信号后,DHT11从低功耗模式转换到高速模式,等待主机开始信号结束后,DHT11发送响应信号,送出40bit的数据,并触发一次信号采集用户可选择读取部分数据。从模式下,DHT11接收到开始信号触发一次温湿度采集,如果没有接收到主机发送开始信号,DHT11不会主动进行温湿度采集.采集数据后转换到低速模式。通讯过程如下图所示:
Figure 1-2 DHT11通讯时序图
熟悉RT-Thread系统都知道,RT-Thread将各个模块进行抽象,为上层提供统一的操作接口,依次提高上层代码的可重用性,自然也提高了应用开发效率。RT-Thread的驱动框架:
Figure 1-3 RT-Thread的驱动框架
应用程序通过 I/O 设备管理接口获得正确的设备驱动,然后通过这个设备驱动与底层 I/O 硬件设备进行数据(或控制)交互。
I/O设备模型框架位于硬件和应用程序之间,共分成三层,从上到下分别是 I/O 设备管理层、设备驱动框架层、设备驱动层。
- I/O设备管理层实现了对设备驱动程序的封装。应用程序通过 I/O 设备层提供的标准接口访问底层设备,设备驱动程序的升级、更替不会对上层应用产生影响。这种方式使得设备的硬件操作相关的代码能够独立于应用程序而存在,双方只需关注各自的功能实现,从而降低了代码的耦合性、复杂性,提高了系统的可靠性。
- 设备驱动框架层是对同类硬件设备驱动的抽象,将不同厂家的同类硬件设备驱动中相同的部分抽取出来,将不同部分留出接口,由驱动程序实现。
- 设备驱动层是一组驱使硬件设备工作的程序,实现访问硬件设备的功能。它负责创建和注册 I/O 设备,对于操作逻辑简单的设备,可以不经过设备驱动框架层,直接将设备注册到 I/O 设备管理器中。
更加详细的内容请参看RT-Thread官方手册。
这里主要讲解Sensor驱动,RT-Thread将各个Sensor进行抽象,将不同厂商的Sensor合并为Sensor设备,从而提高了代码的重用性,提高开发效率。既然是总结,这里就只说重点,先看看DHT11设备驱动的时序图:
Figure 1-4 DHT11设备驱动的时序图
传感器数据接收和发送数据的模式分为 3 种:中断模式、轮询模式、FIFO 模式。在使用的时候,这 3 种模式只能选其一,若传感器的打开参数 oflags 没有指定使用中断模式或者 FIFO 模式,则默认使用轮询模式。
oflags 参数支持下列参数:
#define RT_DEVICE_FLAG_RDONLY 0x001 /* 标准设备的只读模式,对应传感器的轮询模式 */
#define RT_DEVICE_FLAG_INT_RX 0x100 /* 中断接收模式 */
#define RT_DEVICE_FLAG_FIFO_RX 0x200 /* FIFO 接收模式 */
DHT11设备比较简单,采用的是轮询模式,其设备注册函数如下:
result = rt_hw_sensor_register(sensor, name, RT_DEVICE_FLAG_RDONLY, RT_NULL);
硬件初始化如下:
static int rt_hw_dht11_port(void)
{
struct rt_sensor_config cfg;
cfg.intf.user_data = (void *)DHT11_DATA_PIN;
rt_hw_dht11_init("dht11", &cfg);
return RT_EOK;
}
INIT_COMPONENT_EXPORT(rt_hw_dht11_port);
注意INIT_COMPONENT_EXPORT表示组件初始化,初始化顺序为4。
好了,DHT11就讲到这里了。
自动初始化:https://blog.bruceou.cn/2021/02/5-api-pi-auto-initialization/603/
Sensor:https://www.rt-thread.org/document/site/programming-manual/device/sensor/sensor/
2 LVGL UI绘制与移植
2.1 SquareLine绘制UI
笔者这里使用的是SquareLine Studio。在Screen中添加完后控件后,可点击play按钮后如下图所示。
点击Export->Export File,导出UI文件,包括UI Layout的.c和.h文件,以及PNG图片编码后的.c文件。
2.2 移植UI文件到D133CBS
找到一个一直好LVGL的工程,新建UI文件件,将上面生成的.c和.h文件添加到文件夹中。值得注意的是,D133CBS的SDK的LVGL使用的版本是v8.3.1,因此使用SquareLine Studio导数UI需要切换到v8.3.x的版本。
具体移植过程参考上一章。
3 DHT11获取温湿度并显示
RT-Thread提供了DHT11的驱动软件包,配置如下:
Figure 2-1 添加DHT11驱动
DHT11默认使用的 GPIO是可以修改的,在 dht11_sample.c 中修改以下代码:
#define DHT11_DATA_PIN 3//PA3
笔者这里使用PA3。
温度获取的参考代码如下。
/* Modify this pin according to the actual wiring situation */
#define DHT11_DATA_PIN 3
static void read_temp_entry(void *parameter)
{
rt_device_t dev = RT_NULL;
struct rt_sensor_data sensor_data;
rt_size_t res;
rt_uint8_t get_data_freq = 1; /* 1Hz */
dev = rt_device_find("temp_dht11");
if (dev == RT_NULL)
{
return;
}
if (rt_device_open(dev, RT_DEVICE_FLAG_RDWR) != RT_EOK)
{
rt_kprintf("open device failed!\n");
return;
}
rt_device_control(dev, RT_SENSOR_CTRL_SET_ODR, (void *)(&get_data_freq));
while (1)
{
res = rt_device_read(dev, 0, &sensor_data, 1);
if (res != 1)
{
rt_kprintf("read data failed! result is %d\n", res);
rt_device_close(dev);
return;
}
else
{
if (sensor_data.data.temp >= 0)
{
uint8_t temp = (sensor_data.data.temp & 0xffff) >> 0; // get temp
uint8_t humi = (sensor_data.data.temp & 0xffff0000) >> 16; // get humi
rt_kprintf("temp:%d, humi:%d\n" ,temp, humi);
}
}
rt_thread_delay(1000);
}
}
static int dht11_read_temp_sample(void)
{
rt_thread_t dht11_thread;
dht11_thread = rt_thread_create("dht_tem",
read_temp_entry,
RT_NULL,
1024,
RT_THREAD_PRIORITY_MAX / 2,
20);
if (dht11_thread != RT_NULL)
{
rt_thread_startup(dht11_thread);
}
return RT_EOK;
}
将获取的温度显示到UI,核心代码如下。
#include "ui.h"
#include "ui_helpers.h"
#include "sensor.h"
#include "sensor_dallas_dht11.h"
#include "aic_hal_gpio.h"
extern lv_obj_t * ui_HumidityData;
extern lv_obj_t * ui_temperatureData;
static rt_thread_t lvgl_thread = RT_NULL;
static rt_device_t dev = RT_NULL;
struct rt_sensor_data sensor_data;
static void dht11_event(void)
{
char str_temp[16];
float humidity, temperature;
rt_size_t res;
res = rt_device_read(dev, 0, &sensor_data, 1);
if (res != 1)
{
rt_kprintf("read data failed! result is %d\n", res);
rt_device_close(dev);
return;
}
else
{
if (sensor_data.data.temp >= 0)
{
uint8_t temp = (sensor_data.data.temp & 0xffff) >> 0; // get temp
uint8_t humi = (sensor_data.data.temp & 0xffff0000) >> 16; // get humi
rt_kprintf("temp:%d, humi:%d\n" ,temp, humi);
memset(str_temp,0,sizeof(str_temp));
// 把浮点数转换为字符串,存放在str_temp中。
sprintf(str_temp,"%d.00 C", temp);
//sprintf(str_temp,"%d C",lv_rand( 25, 30));
lv_label_set_text(ui_temperatureData, str_temp);
sprintf(str_temp,"%d.00 %%", humi);
//sprintf(str_temp,"%d %%",lv_rand( 50, 55));
lv_label_set_text(ui_HumidityData, str_temp);
}
}
}
static void lvgl_thread_entry(void *parameter)
{
/* 等待传感器正常工作 */
rt_thread_mdelay(1000);
rt_uint8_t get_data_freq = 1; /* 1Hz */
dev = rt_device_find("temp_dht11");
if (dev == RT_NULL)
{
return;
}
if (rt_device_open(dev, RT_DEVICE_FLAG_RDWR) != RT_EOK)
{
rt_kprintf("open device failed!\n");
return;
}
rt_device_control(dev, RT_SENSOR_CTRL_SET_ODR, (void *)(&get_data_freq));
while (1)
{
dht11_event();
rt_thread_mdelay(500);
}
}
int lvgl_update_init(void)
{
/* 创建线程*/
lvgl_thread = rt_thread_create("lvgl thread", /* 线程的名称 */
lvgl_thread_entry, /* 线程入口函数 */
RT_NULL, /* 线程入口函数的参数 */
1024, /* 线程栈大小,单位是字节 */
20, /* 线程的优先级,数值越小优先级越高*/
10); /* 线程的时间片大小 */
/* 如果获得线程控制块,启动这个线程 */
if (lvgl_thread != RT_NULL)
rt_thread_startup(lvgl_thread);
else
rt_kprintf("lvgl thread create failure !!! \n");
return RT_EOK;
}
/* 导出到 msh 命令列表中 */
MSH_CMD_EXPORT(lvgl_update_init, lvgl data thread);
//INIT_APP_EXPORT(lvgl_update_init);
4 实验现象
程序编译下载到板卡后,会在串口中每 1s 打印一次温湿度数据。