nanoFramework.Iot.Device.Dhtxx 1.2.613

DHT10/DHT11/DHT12/DHT21/DHT22 - 数字输出湿度 & 温度传感器模块

重要 此传感器对时间敏感。该实现仅在少数几款版上工作。请不要与 ESP32 一起使用。如果您正在使用 ESP32，并想要使用 1 线协议的任何 DHT，请使用 Dhtxx.Esp32 版本。

DHT 温湿度传感器非常流行。本项目支持 DHT10、DHT11、DHT12、DHT21(AM2301)、DHT22(AM2302)。

文档

	DHT10	DHT11	DHT12	DHT21	DHT22
图像
温度范围	-40 ~ 80 ℃	0 ~ 60 ℃	-20 ~ 60 ℃	-40 ~ 80 ℃	-40 ~ 80 ℃
湿度范围	0 ~ 99.9 %	2 ~ 95 %	20 ~ 95 %	0 ~ 99.9 %	0 ~ 99.9 %
温度精度	±0.5 ℃	±2 ℃	±0.5 ℃	±0.5 ℃	±0.5 ℃
湿度精度	±3 %	±5 %	±4 %	±3 %	±2 %
协议	I2C	1-Wire	I2C, 1-Wire	1-Wire	1-Wire

• DHT10 数据手册（目前仅提供中文）
• DHT11 数据手册
• DHT12 数据手册
• DHT21 数据表
• DHT22 数据表

使用

1-Wire 协议

// GPIO Pin
using (Dht11 dht = new Dht11(26))
{
    var temperature = dht.Temperature;
    var humidity = dht.Humidity;
    // You can only display temperature and humidity if the read is successful otherwise, this will raise an exception as
    // both temperature and humidity are NAN
    if (dht.IsLastReadSuccessful)
    {
        Debug.WriteLine($"Temperature: {temperature.DegreesCelsius} \u00B0C, Humidity: {humidity.Percent} %");

        // WeatherHelper supports more calculations, such as saturated vapor pressure, actual vapor pressure and absolute humidity.
        Debug.WriteLine(
            $"Heat index: {WeatherHelper.CalculateHeatIndex(temperature, humidity).Celsius:0.#}\u00B0C");
        Debug.WriteLine(
            $"Dew point: {WeatherHelper.CalculateDewPoint(temperature, humidity).Celsius:0.#}\u00B0C");
    }
    else
    {
        Debug.WriteLine("Error reading DHT sensor");
    }
}

注意： 在带有任何DHT传感器的RPi上，1-Wire使用Raspian时工作正常，但使用Windows 10 IoT Core时则不行。设备需要在输入和输出之间切换1-Wire引脚。似乎Windows IoT Core操作系统无法快速切换引脚方向。有人建议使用两个引脚；一个用于输入，另一个用于输出。这里还没有实施这种解决方案，但是以下是一些可能有用的链接，可以帮助设置：

• https://github.com/ms-iot/samples/tree/develop/GpioOneWire
• 在Hackster.io上： https://www.hackster.io/porrey/go-native-c-with-the-dht22-a8e8eb

I2C 协议

重要： 在创建 I2cDevice 之前，请确保正确设置I2C引脚，特别是对于ESP32，确保您已安装 nanoFramework.Hardware.ESP32 nuget

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

对于STM32等设备，请确保您正在使用预设的I2C总线引脚。

只有DHT12可以使用I2C协议。

I2cConnectionSettings settings = new I2cConnectionSettings(1, DhtSensor.DefaultI2cAddressDht12);
I2cDevice device = I2cDevice.Create(settings);

using (Dht12 dht = new Dht12(device))
{
    var tempValue = dht.Temperature;
    var humValue = dht.Humidity;
    if (dht.IsLastReadSuccessful)
    {
        Debug.WriteLine($"Temperature: {tempValue.Celsius:0.#}\u00B0C");
        Debug.WriteLine($"Relative humidity: {humValue:0.#}%");

        // WeatherHelper supports more calculations, such as saturated vapor pressure, actual vapor pressure and absolute humidity.
        Debug.WriteLine(
            $"Heat index: {WeatherHelper.CalculateHeatIndex(tempValue, humValue).Celsius:0.#}\u00B0C");
        Debug.WriteLine(
            $"Dew point: {WeatherHelper.CalculateDewPoint(tempValue, humValue).Celsius:0.#}\u00B0C");
    }
    else
    {
        Debug.WriteLine("Error reading DHT sensor");
    }
}

读取频率和质量测量

在I2C或GPIO的情况下，DHT类型的任何传感器在两次读取之间都需要一些时间。DHT22文档指传感周期为2秒，收集周期超过1.7秒。提高测量频率不会给出更准确的数据。正如您可以从规格中看到的那样，精度取决于传感器类型，从DHT11的±2℃到其他传感器的±0.5℃。即使奇偶校验可以通过，我们仍建议检查数据是否在正常范围内。例如，如果湿度高于100%，则表示测量错误。此检查本身没有执行，因此您可以考虑在应用程序端添加检查。

DHT传感器非常敏感，请避免使用过长电缆、电磁干扰，并将代码编译为发布而不是调试以提高测量质量。

常见问题解答

我总是得到错误的测量结果，发生了什么？

请检查传感器是否正确连接，确保您使用的是正确的引脚。

请检查您使用的是否是正确的传感器。只有DHT10和DHT12支持I2C。所有其他都仅支持使用1-Wire协议的GPIO。DHT12两者都支持。

我测量的数据是不正确的，湿度似乎正常，但温度总是奇怪，问题在哪里？

请检查您使用的是否是正确的传感器。参看页面顶部，检查您拥有的传感器类型。使用DHT11而不是DHT22将导致错误的温度。

我尝试每秒5次获取温度和湿度，但主要得到错误的数据，为什么？

这是绝对正常的，您应该在约每2秒检查一次测量结果。不要试图每秒获取超过一次测量结果。

在读取温度和湿度并尝试将数据写入控制台时，我会遇到异常，为什么？

您首先需要检查测量是否成功。如果测量没有成功，则默认值将是NaN，因此您无法转换温度或湿度，并会得到异常。这是正确的方法：首先读取传感器，然后检查读取结果是否正确，最后使用温度和湿度数据。

var tempValue = dht.Temperature;
var humValue = dht.Humidity;
if (dht.IsLastReadSuccessful)
{
    Debug.WriteLine($"Temperature: {tempValue.Celsius:0.#}\u00B0C");
    Debug.WriteLine($"Relative humidity: {humValue:0.#}%");
}

我有Raspberry Pi 4，在创建DHT传感器时遇到异常。

请参阅此 问题 1145。我们正在积极尝试自动修复它。您必须强制使用 Raspberry Pi 3 驱动程序或 LibGpiodDriver。就是这样，您可以强制使用特定的驱动程序，在本例中是 Raspberry Pi 3，它将工作

GpioDriver driver = new RaspberryPi3Driver();
var controller = new GpioController(PinNumberingScheme.Logical, driver);
// This uses pin 4 in the logical schema so pin 7 in the physical schema
var dht = new Dht11(4, gpioController: controller);

我的使用单线协议的 DHT 传感器在装有 Windows 10 IoT Core 的 Raspberry Pi 上无法正常工作，我该怎么做？

在带有任意 DHT 传感器的 RPi 上，1-Wire 在 Raspian 上工作，但在 Windows 10 IoT Core 上不行。设备必须在不同时切换 1-wire 引脚的输入和输出状态。Windows IoT Core 操作系统似乎无法足够快速地切换引脚方向。有人建议使用两个引脚；一个用于输入，一个用于输出。这个解决方案尚未在这里实施，但以下是一些可能帮助设置这些链接的方便链接：

• https://github.com/ms-iot/samples/tree/develop/GpioOneWire
• 在Hackster.io上： https://www.hackster.io/porrey/go-native-c-with-the-dht22-a8e8eb

如果你的传感器是 I2C 传感器，它应该在 Windows 10 IoT Core 上完美工作。

DHTxx 示例

所需硬件

• DHT10/DHT11/DHT12/DHT21/DHT22
• 公/母跳线

电路

单线协议电路

只需将您的 DHTxx 数据引脚连接到 GPIO26（物理引脚 37），地将地（物理引脚 6）连接到 +5V（物理引脚 2）。

一些传感器已经配备了 10K 电阻。将 GPIO26 连接到 数据 引脚，其位置可能取决于集 InitializeComponent 。

I2C 协议电路

• SCL - SCL
• SDA - SDA
• VCC - 5V
• GND - GND

代码

// GPIO Pin
using (Dht11 dht = new Dht11(26))
{
    var temperature = dht.Temperature;
    var humidity = dht.Humidity;
    // You can only display temperature and humidity if the read is successful otherwise, this will raise an exception as
    // both temperature and humidity are NAN
    if (dht.IsLastReadSuccessful)
    {
        Debug.WriteLine($"Temperature: {temperature.DegreesCelsius} \u00B0C, Humidity: {humidity.Percent} %");

        // WeatherHelper supports more calculations, such as saturated vapor pressure, actual vapor pressure and absolute humidity.
        Debug.WriteLine(
            $"Heat index: {WeatherHelper.CalculateHeatIndex(temperature, humidity).Celsius:0.#}\u00B0C");
        Debug.WriteLine(
            $"Dew point: {WeatherHelper.CalculateDewPoint(temperature, humidity).Celsius:0.#}\u00B0C");
    }
    else
    {
        Debug.WriteLine("Error reading DHT sensor");
    }
}

示例应用程序导航

此示例应用程序允许您通过 I2C 选择 DHT10，或者通过 GPIO 选择支持的其他任意 DHT。

Select the DHT sensor you want to use:
 1. DHT10 on I2C
 2. DHT11 on GPIO
 3. DHT12 on GPIO
 4. DHT21 on GPIO
 5. DHT22 on GPIO

请选择您希望测试和使用的传感器，输入编号。例如，如果您想测试 DHT22，则输入 5。

然后，系统会提示您输入逻辑电路中的引脚编号

Which pin do you want to use in the logical pin schema?

如果您想使用引脚 26，则键入 26 并按回车键。这将在 26 号引脚上创建一个连接到 DHT22 的传感器并开始测量。

请注意，前三四次测量可能不准确，这是完全正常的，这与传感器需要一些时间来预热并返回数据的事实有关。这些传感器非常灵敏，过长的电线、许多干扰和代码编译为调试会增加错误读数的数量。

结果

注意：读取此传感器是敏感的，如果您无法读取任何内容，请确保已正确连接电缆。另外，注意您将在 释放 模式下获得更好的结果。