Johnny-Five 实战:用 Multi 组件驱动 HIH6130 I2C 温湿度传感器
Johnny-Five 实战:用 Multi 组件驱动 HIH6130 I2C 温湿度传感器
Johnny-Five 的 Multi(又称 SIP)组件允许把同一颗 I2C 芯片上的多个物理量抽象为多个子组件统一驱动。本篇以 Honeywell HIH6130 数字温湿度传感器为例,演示如何通过 five.Multi({ controller: "HIH6130" }) 一次性读取摄氏度、华氏度、开尔文温度与相对湿度,并结合仓库源码讲解底层 I2C 测量周期、状态位解析与换算公式。读完本文,你将掌握 Multi 组件的标准用法,并能直接运行 eg/multi-HIH6130.js 示例采集真实数据。
HIH6130 与 Multi 组件定位
HIH6130 是 Honeywell 出品的一款数字温湿度传感器,通过 I2C 总线通信,湿度与温度输出均为 14-bit 数字量,典型测量周期约为 36.65 ms。在 Johnny-Five 中,这类"一芯多量"的芯片被归入 Multi(多合一传感器)抽象:一个传感器对象内部承载多个独立的子组件,每个子组件按各自控制器实现换算逻辑。
在 lib/johnny-five.js 中可以确认 Multi 就是 SIP 模块的别名:
module.exports.Multi = module.exports.SIP;
而在 lib/sip.js 中,Controllers.HIH6130 明确声明了它由两个子组件组成:
HIH6130: {
initialize: {
value(options) {
Components.call(this, "HIH6130", options);
}
},
components: {
value: [HYGROMETER, THERMOMETER]
}
}
也就是说,实例化 new five.Multi({ controller: "HIH6130" }) 后,multi 对象会同时暴露 multi.hygrometer(湿度计)与 multi.thermometer(温度计)两个子组件,这正是文档示例中 this.thermometer 与 this.hygrometer 两个命名空间的来源。
硬件接线与 Fritzing 图纸
HIH6130 采用 I2C 接口,示例文档提供了对应的面包板接线图(上文插图)与可编辑的 Fritzing 工程文件:docs/breadboard/multi-HIH6130.fzz。
参考 lib/sip.js 中驱动定义可知,该传感器默认 I2C 地址为 0x27:
HIH6130: {
ADDRESSES: {
value: [0x27]
},
典型接线方式为:
| HIH6130 引脚 | Arduino / 主控板 |
|---|---|
| VCC | 3.3V |
| GND | GND |
| SDA | A4(Uno)/ 对应 I2C 数据引脚 |
| SCL | A5(Uno)/ 对应 I2C 时钟引脚 |
驱动通过 io.i2cConfig(options) 初始化 I2C 总线(见 lib/sip.js),因此只要主控板的 IO 插件支持 I2C(如 firmata 固件的 Arduino、Raspberry Pi 的 raspi-io 等),即可直接使用。
运行示例:命令行启动
在仓库根目录下,直接用 Node.js 运行配套示例即可:
node eg/multi-HIH6130.js
完整示例源码位于 eg/multi-HIH6130.js,与文档中的代码一致:
var five = require("../");
var board = new five.Board();
board.on("ready", function() {
var multi = new five.Multi({
controller: "HIH6130"
});
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("--------------------------------------");
});
});
程序启动后先等待板卡 ready,随后创建 Multi 实例。每当湿度或温度读数发生变化时,change 事件被触发,回调中的 this 指向该 Multi 实例,从而可以直接访问两个子组件的换算结果。
输出字段与事件模型
示例打印了五个字段,它们的来源与语义如下:
| 字段 | 所属子组件 | 说明 |
|---|---|---|
thermometer.celsius |
Thermometer | 摄氏温度(°C) |
thermometer.fahrenheit |
Thermometer | 华氏温度(°F) |
thermometer.kelvin |
Thermometer | 开尔文温度(K),源码中通过 CELSIUS_TO_KELVIN = 273.15 常量换算(见 lib/thermometer.js) |
hygrometer.relativeHumidity |
Hygrometer | 相对湿度(%RH) |
hygrometer.RH |
Hygrometer | relativeHumidity 的便捷别名(见 lib/hygrometer.js) |
事件机制方面,以湿度计为例(见 lib/hygrometer.js):
- 每个子组件默认以
freq(默认 25 ms)为周期轮询,并持续发出data事件; - 只有当最新读数值与上次不同(发生变化)时,才发出
change事件; data与change事件的载荷均为{ RH, relativeHumidity }结构。
因此示例监听 change 而非 data,可以避免把重复的读数刷屏打印。若你需要更高频的原始数据,可以监听 data,或通过 freq 选项(单位 ms)调整轮询间隔。
源码级原理:I2C 测量循环与状态位
驱动测量循环(lib/sip.js)
HIH6130 的底层驱动位于 lib/sip.js。每次测量循环依次执行:
io.i2cWrite(address, 0xA0, [0x00, 0x00])—— 发起一次新的测量请求;- 等待
delay(初始约 36.65 ms,与数据手册中"典型测量周期"一致)毫秒; io.i2cWrite(address, 0x80, [0x00, 0x00])后通过io.i2cReadOnce(address, 4, ...)一次性读取 4 字节数据。
4 字节数据按数据手册 "Four Byte Data Read" 布局解析:
// B7:6 为状态位
const status = data[0] >> 6;
// 掩掉高两位状态位后得到湿度
computed.humidity = int16(data[0] & 0x3F, data[1]);
// 温度低两位为空位,右移剔除
computed.temperature = int16(data[2], data[3] >> 2);
状态位自适应(Stale 数据)
数据手册规定字节 0 的高两位(B7:6)为状态位,取值含义为:
| 状态位 | 含义 |
|---|---|
00 |
Normal(正常) |
01 |
Stale(陈旧:主控读取速度高于传感器更新速度) |
10 |
Command Mode(命令模式) |
11 |
Diagnostic Condition(诊断状态) |
驱动针对 "Stale" 做了自适应处理(见 lib/sip.js):状态为 00 时把 delay 减 1 以加快节奏,状态为 01 时把 delay 加 1 以留出更多测量时间,从而让采样周期自动贴合传感器的实际更新能力。
驱动单例复用
Drivers.get()(见 lib/sip.js)以 board 与 identifier(HIH6130 为 hih6130-0x27)为键缓存驱动实例:同一块板上创建多个 HIH6130 Multi 实例时,I2C 测量循环只启动一份,避免重复轮询。默认地址通过 addressResolver 解析,也支持通过 options.address 显式指定。
换算公式:从原始计数到工程单位
HIH6130 的湿度与温度原始值都是 14-bit 计数,子组件控制器负责把它们换算为工程单位:
相对湿度换算
lib/hygrometer.js 中实现了 HIH6130 的湿度换算:
// Equation 1: Humidity Conversion Function
// (Humidity Output Count / ((2 ** 14) - 1)) * 100
return toFixed((value / (POW_2_14 - 1)) * 100, 2);
即 %RH = 湿度计数 / (2^14 - 1) × 100,保留两位小数,换算结果即 relativeHumidity。
温度换算
lib/thermometer.js 中实现了温度换算:
toCelsius: {
value(raw) {
// -40 C = 0
// 125 C = 2 ** 14 - 1
return round(raw / 1000);
}
}
toCelsius 接收驱动下发的以千分之一度为单位的温度值(乘 1000 放大),round(raw / 1000) 还原为整数摄氏度;celsius、fahrenheit、kelvin 三个只读属性在 Thermometer 基类中基于该值派生(开尔文换算常量为 273.15,见 lib/thermometer.js)。
进阶:自定义 I2C 地址与多实例
如果你的板卡上有多个 HIH6130(或通过地址跳线改写了地址),可以在构造选项中显式传入地址:
var multi = new five.Multi({
controller: "HIH6130",
address: 0x27
});
驱动会把传入的 address 写回 options.address 并作为 I2C 通信目标,同时参与驱动的缓存标识(见 lib/sip.js),确保不同地址的传感器各自拥有独立的测量循环。
延伸阅读
- 与 HIH6130 同属 Multi 抽象的其他示例:docs/multi-bmp085.md、docs/multi-BME280.md,对应的可运行代码位于 eg 目录(如 eg/multi-bmp085.js)。
- Multi 组件的核心实现集中在 lib/sip.js,湿度与温度子组件分别见 lib/hygrometer.js 与 lib/thermometer.js。
- 各传感器芯片的选型与数据手册索引可参考 lib/datasheets.md。
- HIH6130 的 I2C 固件 / 接线细节可对照 Fritzing 工程 docs/breadboard/multi-HIH6130.fzz。
结语
通过 five.Multi({ controller: "HIH6130" }),Johnny-Five 把 HIH6130 的 I2C 测量循环、状态位自适应和 14-bit 换算全部封装在底层,开发者只需监听 change 事件即可同时获得温、湿度两类数据。理解 lib/sip.js 中的测量时序与两个子组件的换算公式后,你既可以放心把示例用于实际采集,也能在此基础上自定义 address、freq 等选项,按需扩展自己的温湿度监测方案。
