Johnny-Five 多合一传感器实战:用 Multi 与 SI7021 读取温湿度(Tessel / Arduino 双平台)

原创2026-09-22 14:59:131,639 阅读
文章标签:IoT机器人嵌入式

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 这种同时具备温度与湿度测量能力的芯片,一次实例化即可同时获得两个维度上的数据:

在 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 接线

Tessel 2 与 SI7021 温湿度传感器面包板接线图

Fritzing 源文件:docs/breadboard/multi-SI7021.fzz

Arduino UNO 接线

Arduino UNO 与 SI7021 温湿度传感器面包板接线图

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。关键实现细节如下:

  1. I2C 地址与寄存器:

    • 默认从机地址 ADDRESSES: [0x40];
    • 温度读取寄存器 TEMPERATURE: 0xE0,湿度读取寄存器 HUMIDITY: 0xE5,每次各读 2 字节(uint16 组合)。
  2. "无保持"测量时序:驱动注释明确指出,SI7020/SI7021 的 "no hold" 测量模式要求在写寄存器与读寄存器之间至少等待 22ms,代码中将 options.delay = 50000(即 50ms,单位 μs)作为推荐等待时间。

  3. 双独立读通道:芯片不喜欢一次请求 5 字节(温湿度寄存器虽然相邻),因此驱动把温度与湿度分别放在两条 i2cRead 通道上,各自独立读取并合并到 computed 对象后触发 data 事件。

  4. 子组件组装:Multi 通过 lib/sip.js 的 Components 工厂函数,为 HYGROMETER、THERMOMETER 各创建一个子实例,并把 controller: "SI7021" 与 freq 透传给子组件,最终通过 getter 暴露为 multi.thermometer / multi.hygrometer。

  5. 别名机制:温度、湿度、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 一节)。
登录后查看全文
johnny-five