Johnny-Five 温度计实战:在 Arduino 上驱动 HIH6130 I2C 温湿度传感器

原创2026-09-22 15:49:401,831 阅读
文章标签:IoT机器人嵌入式

Johnny-Five 温度计实战:在 Arduino 上驱动 HIH6130 I2C 温湿度传感器

HIH6130 是一款通过 I2C 总线通信的数字温湿度传感器,本文以 Johnny-Five 仓库中的 temperature-HIH6130 文档 为核心,讲解如何使用 Thermometer 组件读取 HIH6130 的温度数据,并深入源码解析其 14 位温度换算、I2C 通信时序与连续采样机制。读完本文,你将能在 Arduino 上完整复现示例、理解 celsius/fahrenheit/kelvin 三个温度单位的底层换算,并掌握如何用 Hygrometer 与 Multi 组件在同一块传感器上同时读取湿度。

HIH6130 传感器与 Johnny-Five 的接入方式

HIH6130 是 Honeywell 出品的一款集温度与相对湿度测量于一体的数字传感器,内部集成了 14 位 ADC,测量结果通过 I2C 接口以数字信号输出。在 Johnny-Five 中,它被三个组件共用同一套底层驱动:

  • Thermometer(温度计):读取温度,本文主题;
  • Hygrometer(湿度计):读取相对湿度,参见 hygrometer-HIH6130 文档;
  • Multi(多合一):同时暴露 thermometer 与 hygrometer 两个子组件,参见 multi-HIH6130 文档。

三者都通过 controller: "HIH6130" 指定控制模式,Johnny-Five 会在 lib/sip.js 中注册同一个 I2C 驱动实例。从源码结构看,驱动层被设计成"一次接线、多组件共享"的模式,因此同一块 HIH6130 的读数可以被温度、湿度甚至 Multi 组件同时消费。

硬件接线:I2C 总线四线连接

HIH6130 的默认 I2C 从机地址为 0x27(定义于 lib/sip.js 的 ADDRESSES)。接线非常简单,只需四根线,与 Arduino 的 I2C 引脚一一对应:

传感器引脚 Arduino 引脚 说明
VCC 5V 供电(默认上拉电阻按 5V 电平配置)
GND GND 共地
SDA A4 I2C 数据线
SCL A5 I2C 时钟线

接线图来自仓库中的官方面包板示意图:

HIH6130 与 Arduino 的 I2C 面包板接线图

同时仓库还提供了同名的 Fritzing 工程源文件 docs/breadboard/multi-HIH6130.fzz,可使用 Fritzing 软件打开后按图布线、核对引脚。

最小可运行示例:读取温度并监听 change 事件

原文档提供的示例完整代码如下(仓库内的可运行版本位于 eg/temperature-HIH6130.js):

const { Board, Thermometer } = require("johnny-five");
const board = new Board();

board.on("ready", () => {
  const thermometer = new Thermometer({
    controller: "HIH6130"
  });

  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("--------------------------------------");
  });
});

从命令行运行:

node eg/temperature-HIH6130.js

代码要点解析:

  1. new Board():Johnny-Five 会自动探测并连接第一个可用的串口(通常是最先枚举到的 Arduino),无需显式指定端口。
  2. controller: "HIH6130":这是关键配置项,告诉 Thermometer 采用 HIH6130 的 I2C 控制器。在 lib/thermometer.js 中,该控制器通过 Drivers.get(this.board, "HIH6130", options) 获取共享驱动,并订阅其 data 事件回调温度值。
  3. change 事件:当温度读数发生变化时触发;由于驱动是连续采样模式,实际运行中该回调会以较高频率被调用。
  4. celsius/fahrenheit/kelvin:Thermometer 实例暴露的三个只读属性,每次读取后都会基于当前摄氏温度自动换算。
  5. 示例在回调内用解构语法一次性取出三个温度值并打印,输出格式与文档一致,便于在终端中观察温度变化。

温度数据换算:14 位原始值如何变成摄氏度

HIH6130 的温度输出是一个 14 位原始计数。在 lib/sip.js 的驱动中,从 4 字节读回的数据按如下方式还原原始计数:

// B7:6 为状态位,先与 0x3F 做掩码从湿度高字节中剔除
computed.humidity = int16(data[0] & 0x3F, data[1]);
// 温度低字节右移 2 位,去掉 B1:0 空位
computed.temperature = int16(data[2], data[3] >> 2);

随后 lib/thermometer.js 中的 toCelsius 完成从原始计数到摄氏度的换算:

toCelsius: {
  value(raw) {
    // Page 3
    // 5.0 Calculation of Optional Temperature
    // from the Digital Output
    //
    // -40 C = 0
    // 125 C = 2 ** 14 - 1
    return round(raw / 1000);
  }
}

依据数据手册,-40°C 对应计数 0,125°C 对应计数 2^14 - 1 = 16383,即每个计数约代表 0.01°C(165°C 量程 / 16384 个刻度)。源码中驱动上送的原始值已放大了 1000 倍(毫摄氏度),因此 toCelsius 直接 raw / 1000 再四舍五入即得摄氏度。fahrenheit 与 kelvin 则由摄氏温度通过标准换算公式派生,读者无需关心底层单位。

底层驱动原理:一次完整的 I2C 测量周期

理解驱动实现有助于排查接线与采样异常。在 lib/sip.js 的 HIH6130 初始化逻辑中,measureCycle 定义了完整的测量周期:

  1. 触发测量:向地址 0xA0 写入 [0x00, 0x00],命令传感器开始一次温度与湿度测量;
  2. 等待转换:根据数据手册,一次测量周期典型耗时为 36.65 ms,驱动以 setTimeout 模拟该等待时间;
  3. 读取结果:向地址 0x80 写入 [0x00, 0x00] 后,通过 i2cReadOnce(address, 4, ...) 一次性读回 4 字节数据(对应数据手册第 2 页 Figure 4 的 "Humidity and Temperature Data Fetch, Four Byte Data Read");
  4. 解析状态位:首字节的 B7:6 是状态位,含义如下(数据手册 2.6 Status Bits 一节):
状态位值 含义
0 0 Normal(正常)
0 1 Stale(数据陈旧,缓冲区尚未被新测量刷新)
1 0 Command Mode(命令模式)
1 1 Diagnostic Condition(诊断条件)
  1. 自适应采样节奏:当读到 status === 0(正常)时,delay 递减;当读到 status === 1(陈旧)时 delay 递增。这是对"主控轮询快于传感器更新输出缓冲区"场景的自动补偿,从源码结构看,这种自适应让采样间隔稳定收敛在传感器实际测量能力附近;
  2. 发布数据:将 { humidity, temperature } 通过 data 事件发出,然后递归调用 measureCycle,形成持续不断的连续采样流。

需要说明的是,该驱动默认采用连续采样模式(源码注释明确写道 "The most common use cases involve continuous sampling of sensor data, so that's what this controller-driver will provide."),因此不需要在应用层手动轮询。

进阶组合:在同一块 HIH6130 上同时读温度与湿度

HIH6130 本身就是温湿度一体传感器,Johnny-Five 也为此提供了两种组合玩法:

方式一:单独使用 Hygrometer

将 controller 同样设为 "HIH6130",即可直接读取相对湿度(相对路径示例 eg/hygrometer-HIH6130.js):

const five = require("johnny-five");
const board = new five.Board();

board.on("ready", function() {
  const hygrometer = new five.Hygrometer({
    controller: "HIH6130"
  });

  hygrometer.on("change", function() {
    console.log("Hygrometer");
    console.log("  relative humidity : ", this.relativeHumidity);
    console.log("--------------------------------------");
  });
});

湿度换算同样有据可查:lib/hygrometer.js 中 toRelativeHumidity 采用数据手册 Equation 1 的湿度转换函数 (湿度输出计数 / (2^14 - 1)) * 100,注释还标明典型分辨率约 0.04 %RH。

方式二:使用 Multi 组件一键两得

如果希望用单个组件同时拿到温度和湿度,可以改用 Multi(可运行示例 eg/multi-HIH6130.js):

var five = require("johnny-five");
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("--------------------------------------");
  });
});

Multi 的 HIH6130 组件声明于 lib/sip.js,其 components 明确列出 [HYGROMETER, THERMOMETER],即一个 Multi 实例内部同时实例化湿度计与温度计,this.thermometer 与 this.hygrometer 即为这两个子组件。这也解释了为何 multi-HIH6130 文档 与本文的温度示例共用同一张 面包板接线图:接线完全相同,只是上层组件的抽象粒度不同。

补充说明与排障提示

  • I2C 地址:HIH6130 默认地址为 0x27。驱动通过 Drivers.addressResolver(Drivers.HIH6130, options) 解析地址,identifier 为 hih6130-<address>(见 lib/sip.js),因此在多设备场景下可以按地址区分不同实例。
  • 数据手册依据:温度换算、状态位定义与测量周期时长均来自数据手册的页码注释(见 lib/datasheets.md 中 HIH6130 的资料索引,以及 lib/thermometer.js、lib/hygrometer.js、lib/sip.js 中的内联引用)。
  • 接线验证:若 change 事件从未触发,优先检查 SDA/SCL 是否分别接在 A4/A5、供电是否为 5V,以及传感器地址是否因模块差异而不同。
  • 连续采样与 CPU 占用:驱动采用无间歇的连续采样,在 PC 端长时间运行时注意终端输出频率;如需控制输出节奏,可在回调中自行做节流处理。

以上即 Johnny-Five 中 HIH6130 温度测量的完整路径——从面包板接线、最小示例,到源码级的换算公式与 I2C 时序,均可在当前仓库中逐行对照验证。

登录后查看全文
johnny-five