Johnny-Five 实战:用 Multi 组件驱动 HIH6130 I2C 温湿度传感器

原创2026-09-22 17:18:041,915 阅读
文章标签:IoT机器人嵌入式

Johnny-Five 实战:用 Multi 组件驱动 HIH6130 I2C 温湿度传感器

Johnny-Five 的 Multi(又称 SIP)组件允许把同一颗 I2C 芯片上的多个物理量抽象为多个子组件统一驱动。本篇以 Honeywell HIH6130 数字温湿度传感器为例,演示如何通过 five.Multi({ controller: "HIH6130" }) 一次性读取摄氏度、华氏度、开尔文温度与相对湿度,并结合仓库源码讲解底层 I2C 测量周期、状态位解析与换算公式。读完本文,你将掌握 Multi 组件的标准用法,并能直接运行 eg/multi-HIH6130.js 示例采集真实数据。

Johnny-Five multi-HIH6130 示例的 Fritzing 面包板接线图

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。每次测量循环依次执行:

  1. io.i2cWrite(address, 0xA0, [0x00, 0x00]) —— 发起一次新的测量请求;
  2. 等待 delay(初始约 36.65 ms,与数据手册中"典型测量周期"一致)毫秒;
  3. 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),确保不同地址的传感器各自拥有独立的测量循环。

延伸阅读

结语

通过 five.Multi({ controller: "HIH6130" }),Johnny-Five 把 HIH6130 的 I2C 测量循环、状态位自适应和 14-bit 换算全部封装在底层,开发者只需监听 change 事件即可同时获得温、湿度两类数据。理解 lib/sip.js 中的测量时序与两个子组件的换算公式后,你既可以放心把示例用于实际采集,也能在此基础上自定义 address、freq 等选项,按需扩展自己的温湿度监测方案。

登录后查看全文
johnny-five