Johnny-Five 温度计实战:使用 DHT21_I2C_NANO_BACKPACK 控制器读取 I2C 温湿度背板
Johnny-Five 温度计实战:使用 DHT21_I2C_NANO_BACKPACK 控制器读取 I2C 温湿度背板
导读
本篇指南围绕 Johnny-Five 的 Thermometer 组件与 DHT21_I2C_NANO_BACKPACK 控制器展开,讲解如何通过 I2C 背板(Backpack)桥接 DHT21 数字温湿度传感器,在 Arduino Nano 上以 I2C 总线方式读取温度数据。读完本文你将掌握:在 Node.js 中使用 Thermometer 组件读取 celsius / fahrenheit / kelvin 三种温标的方法、I2C 背板固件与总线协议的底层工作原理,以及如何将同一传感器同时接入 Multi / Hygrometer 组件获得相对湿度。该方案的核心价值在于:将 DHT 系列传感器依赖时序的 OneWire 信号转换为稳定的 I2C 读写,从而绕开 DHT 驱动对实时性的苛刻要求。
一、示例运行与最小可用代码
在 eg/temperature-DHT21_I2C_NANO_BACKPACK.js 中提供了完整可运行的示例,在命令行直接执行:
node eg/temperature-DHT21_I2C_NANO_BACKPACK.js
示例完整代码如下(与文档 docs/temperature-DHT21_I2C_NANO_BACKPACK.md 一致):
const { Board, Thermometer } = require("johnny-five");
const board = new Board();
board.on("ready", () => {
const thermometer = new Thermometer({
controller: "DHT21_I2C_NANO_BACKPACK"
});
thermometer.on("change", () => {
const {celsius, fahrenheit, kelvin} = thermometer;
console.log("Thermometer");
console.log(" celsius : ", celsius);
console.log(" fahrenheit : ", fahrenheit);
console.log(" kelvin : ", kelvin);
console.log("--------------------------------------");
});
});
关键点拆解:
controller: "DHT21_I2C_NANO_BACKPACK":这是整个配置的核心。Johnny-Five 的Thermometer通过 lib/thermometer.js 中的Controllers映射表查找控制器,Controllers.DHT21_I2C_NANO_BACKPACK = Controllers.DHT_I2C_NANO_BACKPACK(见 lib/thermometer.js),与DHT11_I2C_NANO_BACKPACK、DHT22_I2C_NANO_BACKPACK共用同一套底层驱动,区别仅在传感器型号。change事件:当celsius数值发生变化时触发。从 lib/thermometer.js 的eventProcessing实现可以看到,组件内部以freq(默认 25ms)为周期轮询原始数据,一旦新值与上次不同就派发change事件并携带{ C, F, K, celsius, fahrenheit, kelvin }。- 三个温度属性:
celsius直接由驱动回调的原始值换算而来;fahrenheit = celsius * 9 / 5 + 32;kelvin = celsius + 273.15(见 lib/thermometer.js)。
二、接线与硬件准备
文档为该项目提供了 Fritzing 接线图:图片 docs/breadboard/multi-DHT21_I2C_NANO_BACKPACK.png 以及可编辑的电路图文件 docs/breadboard/multi-DHT21_I2C_NANO_BACKPACK.fzz。
从接线图可以确认的硬件结构:
- 主控:Arduino Nano(烧录了 I2C 背板固件,见下文第四节);
- 传感器:DHT21(又名 AM2301)数字温湿度传感器;
- 背板(Backpack):负责把 DHT21 的单总线信号转换为 I2C 从机接口,板上带有两个地址跳线(对应固件中的
AD0/AD1); - 连接方式:背板通过 SDA / SCL 两根线与主控 I2C 总线相连,同时接电源与地。
需要特别说明:DHT21 传感器本体既可以接在背板上由 I2C 背板固件驱动,也可以在背板固件允许的范围内动态指定其连接的引脚与传感器型号(详见第三节协议分析)。
三、I2C 协议与驱动源码分析
3.1 从机地址与寄存器定义
在 lib/sip.js 中,DHT_I2C_NANO_BACKPACK 驱动的定义为:
DHT_I2C_NANO_BACKPACK: {
ADDRESSES: {
value: [0x0A]
},
REGISTER: {
value: {
READ: 0x00,
}
},
initialize: {
value(board, options) {
const io = board.io;
// Correspond to firmware variables
const dhtPin = 2;
let dhtType = 11;
const address = Drivers.addressResolver(this, options);
io.i2cConfig(options);
const dhtVariantExec = /(\d{2})/.exec(options.controller);
const dhtVariant = dhtVariantExec && dhtVariantExec.length && dhtVariantExec[0];
if (dhtVariant) {
dhtType = +dhtVariant;
if (Number.isNaN(dhtType)) {
dhtType = 11;
}
}
const computed = {
temperature: null,
humidity: null,
};
io.i2cWrite(address, [dhtPin, dhtType]);
io.i2cRead(address, 4, data => {
computed.humidity = int16(data[0], data[1]);
computed.temperature = int16(data[2], data[3]);
this.emit("data", computed);
});
}
},
...
}
几个值得注意的实现事实:
- 默认从机地址
0x0A:ADDRESSES数组给出固件中的I2C_DEFAULT_ADDRESS。若背板通过 AD0/AD1 跳线修改了地址,可通过options.address覆盖,Drivers.addressResolver会解析该选项。 - 型号自动识别:驱动通过正则
/(\d{2})/从options.controller中提取两位数字作为 DHT 型号——"DHT21_I2C_NANO_BACKPACK"会解析出21,"DHT11_I2C_NANO_BACKPACK"解析出11,"DHT22_I2C_NANO_BACKPACK"解析出22。解析失败时回退到11。 - 两段式读写:先
io.i2cWrite(address, [dhtPin, dhtType])把传感器引脚与型号写入从机(对应固件onReceive回调),再io.i2cRead(address, 4, ...)一次读回 4 字节(对应固件onRequest发送的 4 字节缓冲区)。 - 数据布局:
buffer[0..1]为湿度(高字节在前),buffer[2..3]为温度(高字节在前),驱动用int16(data[0], data[1])/int16(data[2], data[3])组合成带符号整数。
3.2 温度换算与控制器到 Thermometer 的桥接
在 lib/thermometer.js 中,DHT_I2C_NANO_BACKPACK 控制器:
DHT_I2C_NANO_BACKPACK: {
initialize: {
value(options, callback) {
const { Drivers } = require("./sip");
Drivers.get(this.board, "DHT_I2C_NANO_BACKPACK", options)
.on("data", ({temperature}) => callback(temperature));
}
},
toCelsius: {
value(raw) {
// Page 2
// 5. Product parameters
// Range: ... ±2°C
return round(raw / 100);
}
}
},
Drivers.get是单例式的驱动获取入口(见 lib/thermometer.js),同一块板上、同一driverName + pin组合只初始化一次,避免重复创建 I2C 读取循环。- 固件侧将温度放大 100 倍传输(
c = (int)((float)dht.readTemperature() * 100),见 firmwares/dht_i2c_nano_backpack.ino),因此toCelsius用round(raw / 100)还原为摄氏度整数。 - 文档注释注明该传感器温度精度为 ±2°C,属于 DHT21 数据手册标称精度的合理范围。
四、背板固件:I2C 从机端的完整工作流程
仓库 firmwares/dht_i2c_nano_backpack.ino 提供了配套的 Arduino 固件(同一固件也适用于 DHT11 / DHT22 背板,见 firmwares/dht11_i2c_nano_backpack.ino)。理解它能帮助你排查接线与地址问题:
- 地址跳线:
AD0(D11)与AD1(D12)作为输入引脚读取,offset |= 1 << i累加后叠加到默认地址0x0A上(firmwares/dht_i2c_nano_backpack.ino)。因此该背板最多可支持 4 个不同的 I2C 地址(0x0A ~ 0x0D)。 - 接收命令:
onReceive按顺序读取两个字节[ pin, type ],即主机(Johnny-Five 驱动)写入的传感器引脚与 DHT 型号(默认[ 2, 11 ])。 - 循环采样:
loop()中每次构建DHT dht(dhtPin, dhtType)并读取湿度与温度,乘以 100 后拆成高、低字节写入 4 字节缓冲区,随后delay(250)约每 250ms 刷新一次采样。 - 应答读取:
onRequest通过Wire.write(buffer, I2C_BUFFER_SIZE)一次发送全部 4 字节,与主机端i2cRead(address, 4, ...)一一对应。 - 调试模式:定义
DEBUG_MODE 1后可通过串口输出原始h/c值与剩余 RAM,便于验证从机端读数。
五、进阶:同一传感器同时读取温度与湿度
DHT21 是温湿度一体的数字传感器,背板固件在 4 字节缓冲区中同时携带湿度和温度。Johnny-Five 因此提供了两条使用路径:
5.1 使用 Multi 组件
参考 eg/multi-DHT21_I2C_NANO_BACKPACK.js 与文档 docs/multi-DHT21_I2C_NANO_BACKPACK.md,可用 Multi 一次拿到 thermometer 与 hygrometer 两个子组件:
var five = require("../");
var board = new five.Board();
board.on("ready", function() {
var multi = new five.Multi({
controller: "DHT21_I2C_NANO_BACKPACK",
pin: 2,
});
multi.on("change", function() {
console.log("Thermometer");
console.log(" celsius : ", this.thermometer.celsius);
console.log(" fahrenheit : ", this.thermometer.fahrenheit);
console.log(" kelvin : ", this.thermometer.kelvin);
console.log("--------------------------------------");
console.log("Hygrometer");
console.log(" relative humidity : ", this.hygrometer.relativeHumidity);
console.log("--------------------------------------");
});
});
Multi 在 lib/sip.js 中为 DHT_I2C_NANO_BACKPACK 注册了 [HYGROMETER, THERMOMETER] 两个组件,change 事件中通过 this.thermometer / this.hygrometer 访问。
5.2 使用 Hygrometer 组件
如果只需要湿度,可参考 eg/hygrometer-DHT21_I2C_NANO_BACKPACK.js,将控制器换为 Hygrometer,在 change 事件中读取 this.relativeHumidity 属性:
var five = require("../");
var board = new five.Board();
board.on("ready", function() {
var hygrometer = new five.Hygrometer({
controller: "DHT21_I2C_NANO_BACKPACK"
});
hygrometer.on("change", function() {
console.log("Hygrometer");
console.log(" relative humidity : ", this.relativeHumidity);
console.log("--------------------------------------");
});
});
注意:上述
Multi/Hygrometer示例中使用require("../")是仓库内相对路径写法;在你的独立项目中统一使用require("johnny-five")即可,二者等价。
六、常见问题与排查建议
- 找不到设备:确认背板固件已烧录、SDA/SCL 接线正确,且从机地址与驱动默认
0x0A一致;若修改过 AD0/AD1 跳线,请在初始化选项中显式传入address。 - 温度读数异常偏大:检查
toCelsius除以 100 的换算前提——固件发送的是放大 100 倍的整数,若读到的是原始字节而非经过int16组合的值,请确认使用的 Johnny-Five 版本驱动与固件版本匹配。 change事件不触发:Thermometer的freq默认 25ms,且仅在celsius数值变化时才触发change;传感器稳定时属于正常现象,此时应监听data事件获取周期性的原始读数。- 多种 DHT 型号共用:
DHT11_I2C_NANO_BACKPACK/DHT21_I2C_NANO_BACKPACK/DHT22_I2C_NANO_BACKPACK共享DHT_I2C_NANO_BACKPACK驱动(见 lib/sip.js 与 lib/thermometer.js),型号由控制器名自动推断,同一背板可灵活切换。
七、小结
DHT21_I2C_NANO_BACKPACK 控制器是 Johnny-Five 将"时序敏感"的 DHT 传感器纳入 I2C 生态的典型方案:固件端 firmwares/dht_i2c_nano_backpack.ino 负责 DHT 采样并暴露 4 字节 I2C 从机接口,JS 端 lib/sip.js 负责按协议读写并解包湿度与温度,lib/thermometer.js 负责将原始值换算为摄氏度并派发事件。借助这一链路,你可以在 Arduino Nano + Johnny-Five 的项目中稳定地同时获取 DHT21 的温度与湿度,并自由切换到 Thermometer、Hygrometer 或 Multi 三种组件形态。
