rsaikali/dht22-mqtt

dht22-mqtt

镜像概述

本Docker镜像基于Python脚本，用于从DHT22温湿度传感器读取数据，并将温度和湿度信息发布到MQTT消息队列broker。适用于树莓派设备，通过GPIO接口连接传感器，支持容器化部署以简化依赖管理。

核心功能

1. 采集DHT22传感器的温度与湿度数据
2. 定时（可配置间隔）将数据发布到指定MQTT主题
3. 通过环境变量灵活配置GPIO引脚、MQTT broker地址/端口/主题等参数
4. 支持独立脚本或Docker容器两种运行方式

使用场景

• 智能家居环境温湿度监测（如客厅、卧室等区域）
• 物联网项目中的环境数据采集节点
• 远程监控场景下的温湿度数据上报

配置说明

通过环境变量配置参数（默认值如下）：

• DHT22_PIN: 连接DHT22的GPIO引脚，默认4
• DHT22_CHECK_EVERY: 采集间隔秒数，默认10
• MQTT_SERVICE_HOST: MQTT broker地址，默认mosquitto.local
• MQTT_SERVICE_PORT: MQTT broker端口，默认1883
• MQTT_SERVICE_TOPIC: 数据发布主题，默认home/livingroom
• MQTT_CLIENT_ID: MQTT客户端ID，默认dht22-mqtt-service

Docker部署示例

使用Docker Hub镜像

直接拉取并运行镜像（需--privileged以访问GPIO）：

sh
docker run --name dht22-mqtt \
           --privileged \
           --restart=always \
           --net=host \
           -tid \
           -e DHT22_PIN=4 \
           -e DHT22_CHECK_EVERY=10 \
           -e MQTT_SERVICE_HOST=mosquitto.local \
           -e MQTT_SERVICE_PORT=1883 \
           -e MQTT_SERVICE_TOPIC=home/livingroom \
           -e MQTT_CLIENT_ID=dht22-mqtt-service \
           rsaikali/dht22-mqtt

构建自定义镜像

若需跨架构构建（如在x86设备上构建arm/v7镜像），需启用Docker实验性功能并使用buildx：

sh
export DOCKER_CLI_EXPERIMENTAL=enabled
docker buildx create --use --name build --node build --driver-opt network=host
docker buildx build --platform linux/arm/v7 -t <你的仓库>/dht22-mqtt --push .

已知问题

• DHT22传感器偶尔会出现校验和错误，镜像会自动重试
• 依赖库libgpiod_pulsein可能存在高CPU占用问题（相关开源项目已在处理）
• 传感器读数偶尔会出现异常，属于硬件或驱动层面的已知问题