从零到一:在OpenHarmony Hi3861上快速驱动DHT11温湿度传感器
最近在捣鼓一个智能花盆的小项目,需要实时监测土壤环境的温湿度。手头正好有块Hi3861开发板和一枚经典的DHT11传感器,但翻遍官方文档和社区,发现针对Hi3861的DHT11驱动资料并不多,大多是基于STM32的移植。这反而激起了我的兴趣——在OpenHarmony这个新兴的物联网操作系统上,如何用最简洁的方式搞定一个单总线传感器?经过一番折腾和踩坑,我总结出了一套五分钟内即可上手的实战方案,特别适合时间紧迫的创客、学生,或者任何想快速验证想法的人。本文将抛开复杂的理论,直接聚焦于Hi3861的GPIO11引脚,手把手带你完成从硬件连接到数据打印的全过程,并重点剖析那些容易导致失败的细节。
1. 开箱即用:理解DHT11与Hi3861的协作基础
在动手写代码之前,我们需要对两位“主角”有个基本认识。DHT11是一款性价比极高的数字温湿度复合传感器,它采用单总线通信协议。这意味着你只需要一根数据线(除了电源和地),就能与主控芯片对话。其内部集成了一个8位单片机,负责采集并转换数据,因此我们无需处理复杂的模拟信号,只需按照特定的时序“问”,它就会“答”。
而Hi3861作为一款专为物联网设备设计的Wi-Fi SoC,其GPIO(通用输入输出)接口功能强大且灵活。与在Arduino或STM32上编程不同,在OpenHarmony环境下操作GPIO,我们需要调用其提供的硬件抽象层(HAL)接口。这套接口设计清晰,但对于习惯了digitalWrite和digitalRead的开发者来说,初次接触可能需要一点适应。核心在于理解两个概念:引脚功能复用(IoSetFunc) 和 方向控制(GpioSetDir)。前者决定这个引脚是作为普通的GPIO使用,还是作为UART、I2C等特殊功能引脚;后者则控制这个引脚当前是输出模式(向外驱动电平)还是输入模式(读取外部电平)。
对于DHT11,整个通信过程需要GPIO在输出和输入模式间动态切换,这正是驱动编写的关键。下面这个表格概括了DHT11通信各阶段对Hi3861 GPIO的需求:
| 通信阶段 | Hi3861 GPIO模式 | 主要动作 | 目的 |
|---|---|---|---|
| 主机发起起始信号 | 输出模式 | 拉低至少18ms,然后拉高20-40µs | 通知DHT11准备发送数据 |
| 等待DHT11应答 | 浮空输入模式 | 检测总线被拉低约80µs,再拉高80µs | 确认DHT11在线并准备就绪 |
| 读取数据位 | 浮空输入模式 | 检测50µs低电平起始位,然后判断后续26-28µs(0)或70µs(1)的高电平 | 解析每一位数据(0或1) |
注意:Hi3861的GPIO内部上拉/下拉电阻配置(
IoSetPull)在输入模式下至关重要。对于DHT11这类需要外部上拉电阻的传感器,通常配置为WIFI_IOT_IO_PULL_NONE(浮空输入),依靠外部的上拉电阻确保总线空闲时为高电平。
2. 硬件连接与工程初始化:避免第一步就踩坑
硬件连接看似简单,但连接不当会导致后续调试困难重重。我们选择GPIO11,仅仅是因为它在我的开发板上位置方便,你可以根据实际情况选择其他GPIO口。
连接示意图如下:
- Hi3861 5V -> DHT11 VCC (Pin 1)
- Hi3861 GPIO11 -> DHT11 DATA (Pin 2)
- Hi3861 GND -> DHT11 GND (Pin 4)
DHT11的Pin 3通常悬空。务必在DATA引脚和VCC之间连接一个4.7kΩ - 10kΩ的上拉电阻,这是保证单总线稳定通信的必要条件,很多初次使用者会忽略这一点。
接下来,在你的OpenHarmony源码工程中,需要确保驱动文件能正确调用底层硬件接口。首先,在你的BUILD.gn文件中,添加对//base/iot_hardware/interfaces/kits/wifiiot_lite这个路径的依赖。然后,在C源文件中包含必要的头文件:
#include "wifiiot_gpio.h"
#include "wifiiot_gpio_ex.h"
#include "wifiiot_io.h"
#include "hi_time.h" // 关键!用于微秒级延时
提示:
hi_time.h提供的hi_udelay()函数是阻塞式延时,它会占用CPU时间直到延时结束。对于DHT11这种对时序要求极其严格的单总线协议,必须使用这种阻塞延时,而不能使用usleep()等可能引发任务调度的非阻塞延时,否则时序会完全错乱。
定义一个宏来简化引脚操作是个好习惯:
#define DHT11_GPIO_PIN WIFI_IOT_IO_NAME_GPIO_11
#define DHT11_HIGH GpioSetOutputVal(DHT11_GPIO_PIN, 1)
#define DHT11_LOW GpioSetOutputVal(DHT11_GPIO_PIN, 0)
3. 核心驱动实现:拆解三步通信时序
驱动DHT11的本质就是模拟三个时序阶段:复位、应答、读数据。我们将其分解为三个函数。
3.1 第一步:主机复位与GPIO模式切换
首先,我们需要一个函数将GPIO11初始化为输出模式,并发出起始信号。这里有一个易错点:在改变GPIO方向前,最好先设置其输出值为高电平,形成一个已知的稳定状态。
// 将GPIO设置为输出模式
static void DHT11_SetOutput(void) {
IoSetFunc(DHT11_GPIO_PIN, WIFI_IOT_IO_FUNC_GPIO_11_GPIO); // 复用为普通GPIO
GpioSetDir(DHT11_GPIO_PIN, WIFI_IOT_GPIO_DIR_OUT); // 设置为输出
}
// 发出起始信号
static void DHT11_StartSignal(void) {
DHT11_SetOutput();
DHT11_LOW; // 拉低总线
hi_udelay(20000); // 保持低电平至少18ms,这里给20ms留有余量
DHT11_HIGH; // 释放总线,由上拉电阻拉高
hi_udelay(30); // 主机拉高20-40µs,这里取30µs
}
3.2 第二步:等待应答与输入模式配置
起始信号发出后,主机需立刻切换到输入模式,等待DHT11的应答。应答信号是一个约80µs的低电平,紧跟一个约80µs的高电平。
// 将GPIO设置为浮空输入模式
static void DHT11_SetInput(void) {
GpioSetDir(DHT11_GPIO_PIN, WIFI_IOT_GPIO_DIR_IN); // 设置为输入
IoSetPull(DHT11_GPIO_PIN, WIFI_IOT_IO_PULL_NONE); // 浮空输入,依赖外部上拉
}
// 检查DHT11应答
// 返回0:检测到正常应答
// 返回1:超时,未检测到应答
static uint8_t DHT11_CheckResponse(void) {
uint8_t retry = 0;
WifiIotGpioValue pinState;
DHT11_SetInput(); // 立即切换为输入模式
// 等待DHT11拉低总线(应答开始)
while (1) {
GpioGetInputVal(DHT11_GPIO_PIN, &pinState);
if (pinState == WIFI_IOT_GPIO_VALUE0) break; // 检测到低电平
if (++retry > 100) return 1; // 超时约100µs
hi_udelay(1);
}
retry = 0;
// 等待DHT11释放总线(低电平结束)
while (1) {
GpioGetInputVal(DHT11_GPIO_PIN, &pinState);
if (pinState == WIFI_IOT_GPIO_VALUE1) break; // 检测到高电平
if (++retry > 100) return 1; // 超时
hi_udelay(1);
}
return 0; // 应答成功
}
3.3 第三步:读取40位数据与校验
应答之后,DHT11会连续发送40位数据(5字节)。每一位数据都以一个50µs的低电平开始,随后的高电平持续时间决定数据是0(26-28µs)还是1(70µs)。我们可以通过测量高电平的持续时间来判定位值。
// 读取一个位
static uint8_t DHT11_ReadBit(void) {
uint8_t retry = 0;
WifiIotGpioValue pinState;
// 等待50µs低电平起始位结束
while (1) {
GpioGetInputVal(DHT11_GPIO_PIN, &pinState);
if (pinState == WIFI_IOT_GPIO_VALUE1) break; // 变为高电平,起始位结束
if (++retry > 60) return 0; // 超时保护
hi_udelay(1);
}
hi_udelay(40); // 延时40µs后采样,此时若为高电平则是‘1’,低电平则是‘0’
GpioGetInputVal(DHT11_GPIO_PIN, &pinState);
return (pinState == WIFI_IOT_GPIO_VALUE1) ? 1 : 0;
}
// 读取一个字节(高位先出)
static uint8_t DHT11_ReadByte(void) {
uint8_t value = 0;
for (int i = 0; i < 8; i++) {
value <<= 1;
value |= DHT11_ReadBit();
}
return value;
}
// 读取一次完整的温湿度数据
// humi_int: 湿度整数部分
// temp_int: 温度整数部分
// 返回0:成功;返回1:失败(校验错误或应答超时)
uint8_t DHT11_Read(uint8_t *humi_int, uint8_t *temp_int) {
uint8_t data[5] = {0};
uint8_t checksum;
DHT11_StartSignal();
if (DHT11_CheckResponse() != 0) {
return 1; // 应答失败
}
// 连续读取5个字节
for (int i = 0; i < 5; i++) {
data[i] = DHT11_ReadByte();
}
// 校验:前4字节之和的低8位应等于第5字节(校验和)
checksum = data[0] + data[1] + data[2] + data[3];
if (checksum != data[4]) {
return 1; // 校验失败
}
*humi_int = data[0]; // 湿度整数
*temp_int = data[2]; // 温度整数
// 注意:DHT11小数部分通常为0,可根据data[1]和data[3]获取
return 0;
}
4. 数据验证与实战调试技巧
驱动写好了,怎么知道它是否工作?最直接的方式就是通过串口打印出来。在OpenHarmony中,你可以使用printf或OHOS_Printf将数据输出到调试串口(通常是UART0)。
下面是一个在应用任务中循环读取并打印的示例:
#include <stdio.h>
#include "ohos_init.h"
#include "cmsis_os2.h"
static void DHT11_Task(void *arg) {
(void)arg;
uint8_t humidity, temperature;
while (1) {
if (DHT11_Read(&humidity, &temperature) == 0) {
printf("[DHT11] Humidity: %d%% RH, Temperature: %d°C\n", humidity, temperature);
} else {
printf("[DHT11] Read failed!\n");
}
osDelay(2000); // 每2秒读取一次,DHT11两次读取间隔需大于1秒
}
}
void DHT11_ExampleEntry(void) {
osThreadAttr_t attr = {0};
attr.name = "DHT11_Task";
attr.stack_size = 1024;
attr.priority = osPriorityNormal;
if (osThreadNew(DHT11_Task, NULL, &attr) == NULL) {
printf("Failed to create DHT11 task!\n");
}
}
APP_FEATURE_INIT(DHT11_ExampleEntry);
如果串口打印出“Read failed!”,别慌,这是调试的起点。你可以按照以下清单逐一排查:
- 硬件检查:
- 电源电压是否稳定在5V?DHT11在3.3V下可能工作不稳定。
- 上拉电阻(4.7kΩ)是否已正确连接在DATA和VCC之间?
- 杜邦线接触是否良好?尝试按压接口或更换线材。
- 软件时序检查:
- 最可能的原因:是否错误使用了
usleep()?请务必确认所有延时都是hi_udelay()。 - 起始信号的低电平时间是否足够长(≥18ms)?
- 读取数据位时的采样点(代码中
hi_udelay(40))可能需要微调,尝试在35-45µs之间变化。
- 最可能的原因:是否错误使用了
- 信号质量检查(进阶): 如果有条件,用逻辑分析仪或示波器抓取GPIO11上的波形,与DHT11的时序图对比,这是定位时序问题最权威的方法。
调试成功后,你可以看到稳定的输出:
[DHT11] Humidity: 45% RH, Temperature: 23°C
[DHT11] Humidity: 45% RH, Temperature: 23°C
...
5. 从驱动到应用:项目集成与优化思路
当驱动稳定运行后,我们就可以考虑如何将其集成到更大的物联网项目中。例如,在智能花盆项目中,我们不仅需要读取数据,还需要在温湿度超出阈值时报警,或者通过Wi-Fi将数据上传到云端。
首先,考虑数据持久化与任务间通信。 你可以创建一个全局的数据结构来存储最新的温湿度值,并使用信号量或消息队列,让DHT11读取任务在获取新数据后通知其他任务(如显示任务、网络上传任务)。
typedef struct {
uint8_t humidity;
uint8_t temperature;
uint32_t timestamp; // 时间戳
} EnvData_t;
static EnvData_t g_envData;
static osSemaphoreId_t g_newDataSem; // 新数据信号量
// 在DHT11读取任务中,更新数据并释放信号量
if (DHT11_Read(&humi, &temp) == 0) {
g_envData.humidity = humi;
g_envData.temperature = temp;
g_envData.timestamp = osKernelGetTickCount();
osSemaphoreRelease(g_newDataSem); // 通知其他任务
}
其次,考虑驱动健壮性。 目前的驱动在超时后会返回失败,但有时因总线干扰可能导致单次数据错误。可以增加简单的软件滤波,比如连续读取3次,取其中两次结果相同的数据作为有效值,丢弃跳变异常的数据。
最后,功耗考量。 在电池供电的场景下,频繁读取传感器会消耗电量。DHT11的转换功耗其实很低,但你可以让MCU在两次读取之间进入深度睡眠(如果Hi3861支持),或者至少将任务间隔从2秒延长到30秒甚至更长,这取决于你的应用对数据实时性的要求。
整个流程走下来,你会发现驱动一个DHT11的核心并不在于代码有多复杂,而在于对单总线时序的精确把握和对Hi3861 GPIO操作接口的熟练运用。我最初移植时也因为用了usleep而卡了半天,用逻辑分析仪抓到一片混乱的波形后才恍然大悟。希望这份聚焦于实战的指南,能帮你绕过这些坑,快速将想法变为现实。
712



被折叠的 条评论
为什么被折叠?



