Johnny-Five 多合一传感器实战:用 Multi 与 SI7021 读取温湿度(Tessel / Arduino 双平台)
Johnny-Five 多合一传感器实战:用 Multi 与 SI7021 读取温湿度(Tessel / Arduino 双平台)
本篇技术指南围绕 docs/multi-SI7021.md 展开,讲解如何在 Johnny-Five 框架中使用 Multi(多合一传感器)组件驱动 SI7021 温湿度传感器,在 Tessel 与 Arduino UNO 上同时获取温度与相对湿度数据。读完本文,你将掌握 five.Multi({ controller: "SI7021" }) 的完整用法、事件与数据字段语义,并通过源码了解 I2C 地址、寄存器与换算公式的底层实现。
Multi 组件与 SI7021 简介
Johnny-Five 的 Multi(源码中即 lib/sip.js 里的 SIP 类,入口文件 lib/johnny-five.js 中 module.exports.Multi = module.exports.SIP)是一个"多合一"复合组件:它把多个单一功能传感器聚合到一个对象中。对于 SI7021 这种同时具备温度与湿度测量能力的芯片,一次实例化即可同时获得两个维度上的数据:
multi.thermometer:温度计子组件(对应 lib/thermometer.js);multi.hygrometer:湿度计子组件(对应 lib/hygrometer.js)。
在 lib/sip.js 中,SI7020/SI7021 被声明为包含 <a href="https://link.gitcode.com/i/247d477e61a2a0485ab6cf602a2bc021" target="_blank">HYGROMETER, THERMOMETER] 两个子组件;而 [lib/sip.js 的 Controllers.SI7021 = Controllers.SI7020; 表明 SI7021 与 SI7020 完全复用同一套驱动与换算逻辑。
硬件接线
SI7021 是 I2C 接口的数字温湿度传感器。仓库文档提供了两套接线参考图与对应的 Fritzing 源文件,分别面向 Tessel 与 Arduino UNO。传感器引脚(VCC / GND / SDA / SCL)直接与开发板的 I2C 总线相连即可,无需额外模拟电路。
Tessel 2 接线
Fritzing 源文件:docs/breadboard/multi-SI7021.fzz
Arduino UNO 接线
Fritzing 源文件:docs/breadboard/multi-SI7021-uno.fzz
接线时注意:SI7021 工作在 1.9V~3.6V 区间(典型 3.3V),Arduino 场景下建议确认模块是否自带电平转换,以免 5V 供电损坏芯片;I2C 的 SDA/SCL 对应 Arduino UNO 的 A4/A5 引脚。
完整示例代码
以下代码即仓库 eg/multi-SI7021.js 的完整内容,也是 docs/multi-SI7021.md 的核心示例:
var five = require("../");
var board = new five.Board();
board.on("ready", function() {
var multi = new five.Multi({
controller: "SI7021"
});
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("--------------------------------------");
});
});
代码要点:
var five = require("../")仅在仓库内运行时有效;在自己的项目中使用时,应改为require("johnny-five"),即先执行npm install johnny-five。new five.Board()不传参数时自动探测并连接开发板;若需指定串口,可参考 docs/board-with-port.md 传入port。- 必须等待
board触发"ready"事件后才能创建传感器实例,这与 Johnny-Five 所有组件的一致约定一致(参见 docs/board.md)。
从命令行运行
在原文档及仓库根目录下,直接执行:
node eg/multi-SI7021.js
运行后控制台将周期性输出类似下面的数据(每次数值变化时触发一次):
Thermometer
celsius : 23.4
fahrenheit : 74.1
kelvin : 296.6
--------------------------------------
Hygrometer
relative humidity : 45.30
--------------------------------------
事件与数据字段
Multi(SI7021)实例继承了 EventEmitter,核心事件有两个:
change:当任一子组件读数发生变化时触发。示例代码即监听此事件打印全部温湿度数据。从 lib/thermometer.js 的实现看,温度子组件只有当新的摄氏温度与上一次不同才会发出change(this.celsius !== last判断);湿度子组件同理。data:按固定采样周期(freq,温度与湿度子组件默认均为 25ms,见 lib/thermometer.js 与 lib/hygrometer.js)持续输出读数,即使数值没有变化。
温度数据字段(lib/thermometer.js 中的 getter):
| 字段 | 含义 | 换算方式(源码实现) |
|---|---|---|
celsius(别名 C) |
摄氏温度 | toCelsius(raw),SI7021 为 (175.72 * raw / 65536) - 46.85,保留 1 位小数 |
fahrenheit(别名 F) |
华氏温度 | (celsius * 9 / 5) + 32,保留 2 位小数 |
kelvin(别名 K) |
开尔文温度 | celsius + 273.15,保留 2 位小数 |
湿度数据字段:hygrometer.relativeHumidity,换算公式为 ((125 * raw) / (2 ** 16)) - 6,保留 2 位小数(见 lib/hygrometer.js)。
源码级原理剖析:SI7021 驱动是如何工作的
在 Johnny-Five 中,SI7021 与 SI7020 共用一套 I2C 驱动,定义于 lib/sip.js。关键实现细节如下:
-
I2C 地址与寄存器:
- 默认从机地址
ADDRESSES: [0x40]; - 温度读取寄存器
TEMPERATURE: 0xE0,湿度读取寄存器HUMIDITY: 0xE5,每次各读 2 字节(uint16组合)。
- 默认从机地址
-
"无保持"测量时序:驱动注释明确指出,SI7020/SI7021 的 "no hold" 测量模式要求在写寄存器与读寄存器之间至少等待 22ms,代码中将
options.delay = 50000(即 50ms,单位 μs)作为推荐等待时间。 -
双独立读通道:芯片不喜欢一次请求 5 字节(温湿度寄存器虽然相邻),因此驱动把温度与湿度分别放在两条
i2cRead通道上,各自独立读取并合并到computed对象后触发data事件。 -
子组件组装:
Multi通过 lib/sip.js 的Components工厂函数,为HYGROMETER、THERMOMETER各创建一个子实例,并把controller: "SI7021"与freq透传给子组件,最终通过 getter 暴露为multi.thermometer/multi.hygrometer。 -
别名机制:温度、湿度、SIP 三个模块中均有
Controllers.SI7021 = Controllers.SI7020;(分别见 lib/thermometer.js、lib/hygrometer.js、lib/sip.js),因此controller: "SI7021"与controller: "SI7020"等价。
测试佐证
仓库测试 test/thermometer.js 与 test/hygrometer.js 分别以 controller: "SI7020" 覆盖了温度与湿度的读数与换算行为,可作为验证上述公式与别名机制的参考。
注意事项与扩展阅读
- 供电电压:SI7021 为低压器件,务必核对模块规格后接线。
- 采样频率:如需更平滑或更省资源的读数,可在创建
Multi时传入freq(如new five.Multi({ controller: "SI7021", freq: 100 })),该值会被透传给温度与湿度子组件,替代默认的 25ms。 - 只读温度或只读湿度:如果仅需要其中一个维度,可分别使用
five.Thermometer({ controller: "SI7021" })或five.Hygrometer({ controller: "SI7021" }),对应文档见 docs/temperature-SI7021.md 与 docs/hygrometer-SI7021.md。 - 更多 I2C 温湿度传感器:
Multi还支持 SHT31D、HTU21D、HIH6130、TH02、BME280 等控制器,相关示例分布在 eg 目录与 docs 目录下。 - 官方学习资料:SI7021 芯片的官方接线与使用细节可参考 SparkFun 的 "Si7021 Humidity and Temperature Sensor Hookup Guide"(外部资源,仓库内仅以链接形式存在于 docs/multi-SI7021.md 的 Learn More 一节)。

