Johnny-Five 温度传感器实战:基于 SI7021 温湿度芯片在 Tessel 上读取摄氏 / 华氏 / 开尔文温度

原创2026-09-22 21:47:261,906 阅读
文章标签:IoT机器人嵌入式

Johnny-Five 温度传感器实战:基于 SI7021 温湿度芯片在 Tessel 上读取摄氏 / 华氏 / 开尔文温度

本文以 Johnny-Five 官方示例 docs/temperature-SI7021.md 为骨架,完整讲解如何在 Tessel 开发板上通过 Thermometer 组件驱动 Silicon Labs SI7021 温湿度传感器,实时读取 celsius、fahrenheit、kelvin 三套温度单位,并结合仓库源码剖析 I2C 寄存器读取、转换公式与事件机制。读完本文,你将能够在 Johnny-Five 项目中独立接线、运行示例,并理解 controller: "SI7021" 从驱动初始化到温度换算的完整调用链。

SI7021 与 Johnny-Five 中的定位

SI7021 是 Silicon Labs 推出的一颗 I2C 接口数字温湿度传感器芯片,片上同时集成温度传感器与相对湿度传感器。在 Johnny-Five 生态中,SI7021 并不需要专用固件,而是直接走 I2C 总线通信,既可作为独立的 Thermometer 温度计组件使用,也可通过 Multi 组件一次性获得温度 + 湿度两类读数。

从源码看,Johnny-Five 在内部把 SI7021 视作 SI7020 的同源设备——两颗芯片的寄存器与换算公式一致,因此在 lib/thermometer.js、lib/sip.js 与 lib/sip.js 三处均存在同一行别名注册:

Controllers.SI7021 = Controllers.SI7020;
Drivers.SI7021 = Drivers.SI7020;

也就是说,controller: "SI7021" 在运行时实际走的是 SI7020 控制器与驱动的实现,这是阅读源码时最容易困惑、也最值得注意的一个别名设计。

硬件接线:Tessel 的 Port A

SI7021 采用标准 I2C 接口(SCL / SDA / VCC / GND),在 Tessel 板上将其接入 Port A 即可。官方文档给出了对应的面包板接线图与 Fritzing 工程文件:

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

Fritzing 接线工程:docs/breadboard/multi-SI7021.fzz

在 Tessel 上,模块端口中的 I2C 引脚(SCL、SDA)会被 Johnny-Five 通过 tessel-io 自动映射,代码中只需要通过 port: "A" 指明所在端口,无需手工指定引脚号。

安装依赖并运行示例

从仓库根目录执行以下命令安装依赖(johnny-five 为框架本体,tessel-io 为 Tessel 板的 IO 插件):

npm install johnny-five tessel-io

随后在命令行中运行官方示例:

node eg/temperature-SI7021.js

该示例的完整源码位于 eg/temperature-SI7021.js,与文档中的示例一一对应,可直接复制使用。

完整代码示例与逐步解读

以下是文档中给出的完整示例代码,添加了必要的注释:

const { Board, Thermometer } = require("johnny-five");
const Tessel = require("tessel-io");

const board = new Board({
  io: new Tessel()
});

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

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

关键点拆解:

  1. new Board({ io: new Tessel() }):Johnny-Five 本身是平台无关的框架,必须通过 io 注入具体平台的 IO 适配器。Tessel 板使用 tessel-io,它负责把 Johnny-Five 的 pinMode / i2cRead 等调用翻译为 Tessel 硬件的原生操作。
  2. new Thermometer({ controller: "SI7021", port: "A" }):controller 指定传感器驱动类型,port 指定 Tessel 上传感器的物理端口。对于走 I2C 的 SI7021,无需再配置 pin 或 address——默认 I2C 地址 0x40 会由驱动自动解析。
  3. thermometer.on("change", ...):当温度数值发生变化时触发回调,从实例上解构出 celsius、fahrenheit、kelvin 三个属性并打印。

运行后终端会持续输出类似下面的读数(数值取决于实际环境温度):

Thermometer
  celsius      :  25.3
  fahrenheit   :  77.54
  kelvin       :  298.45
--------------------------------------

温度属性与事件机制:源码级解读

Thermometer 实例上的 celsius、fahrenheit、kelvin 并不是静态字段,而是基于原始 ADC 读数实时换算的 getter,定义在 lib/thermometer.js:

celsius: {
  get() {
    return this.toCelsius(raw);
  }
},
fahrenheit: {
  get() {
    return toFixed((this.celsius * 9 / 5) + 32, 2);
  }
},
kelvin: {
  get() {
    return toFixed(this.celsius + CELSIUS_TO_KELVIN, 2);
  }
},

其中 CELSIUS_TO_KELVIN = 273.15(lib/thermometer.js)。换算链为:原始 I2C 数据 → toCelsius(得到摄氏)→ 华氏 celsius * 9/5 + 32 → 开尔文 celsius + 273.15。

事件方面,构造函数中注册了一个按固定频率执行的 eventProcessing(lib/thermometer.js):

  • 每次轮询都会发射 data 事件(携带 celsius/fahrenheit/kelvin 对象);
  • 仅当当前摄氏值与上次不同(this.celsius !== last)时,才发射 change 事件,避免重复输出相同读数。

轮询频率由 options.freq 控制,默认值为 25(毫秒),即每秒约采样 40 次(lib/thermometer.js)。读者可按需传入 freq: 100 等值降低采样密度。

I2C 底层驱动:地址、寄存器与 50ms 延时

Thermometer 的 SI7020 控制器(SI7021 的别名实现)在 lib/thermometer.js 中定义:它通过 Drivers.get(this.board, "SI7020", options) 从 lib/sip.js 获取共享驱动实例,并在数据事件中取出 temperature 字段交给 toCelsius 换算。

真正的 I2C 读写在 lib/sip.js 的 SI7020 驱动中完成,其关键参数如下:

参数 值 说明
I2C 地址(ADDRESSES) 0x40 SI7020/SI7021 的标准器件地址
温度寄存器(TEMPERATURE) 0xE0 读取温度原始 16bit 码
湿度寄存器(HUMIDITY) 0xE5 读取相对湿度原始 16bit 码
读取延时(delay) 50000(μs,即 50ms) no-hold 测量模式下写寄存器与读数据之间的最小等待

驱动在 initialize 中强制设置 options.delay = 50000,注释明确说明:no-hold(不保持)测量模式要求在寄存器写入与数据读取之间至少等待 22ms,官方驱动取 50ms 余量(lib/sip.js)。

另一个值得注意的细节是:尽管温度寄存器(0xE0)与湿度寄存器(0xE5)在芯片上是相邻的,但 SI7020 不喜欢一次性请求 5 个字节,因此驱动为两个数据源分别建立独立的 I2C 读通道:

io.i2cRead(address, this.REGISTER.TEMPERATURE, 2, data => {
  computed.temperature = uint16(data[0], data[1]);
  this.emit("data", computed);
});

io.i2cRead(address, this.REGISTER.HUMIDITY, 2, data => {
  computed.humidity = uint16(data[0], data[1]);
  this.emit("data", computed);
});

驱动还实现了按板共享实例的机制:Drivers.get(lib/sip.js)以 si7020-${address} 为 key 缓存驱动,同一块板上多个组件共用同一个 I2C 驱动与读通道,避免重复创建造成总线冲突;Drivers.addressResolver(lib/sip.js)负责在未显式传入 address 时自动使用默认地址 0x40。

温度换算公式

SI7020 控制器中的 toCelsius(lib/thermometer.js)实现了数据手册(Page 23)给出的温度转换表达式:

toCelsius: {
  value(value) {
    // Page 9, Table 5. Temperature Sensor
    // Accuracy1 –10 °C< tA < 85 °C — ±0.3 ±0.4 °C
    //
    // Page 23
    // (See temperature conversion expression)
    return toFixed((175.72 * value / 65536) - 46.85, 1);
  }
}

即:T(°C) = 175.72 * code / 65536 - 46.85,结果保留 1 位小数。原始码 value 为从寄存器读回的 16bit 无符号整数(uint16)。数据手册标注该芯片在 -10 °C ~ 85 °C 范围内精度为 ±0.3 ~ ±0.4 °C。

对应地,湿度换算公式定义在 lib/hygrometer.js 的 toRelativeHumidity 中:

// Page 22, 5.1.1. Measuring Relative Humidity
// ((125 * RH_Code) / (2 ** 16)) - 6
return toFixed((125 * value / POW_2_16) - 6, 2);

即:RH(%) = 125 * code / 65536 - 6,结果保留 2 位小数,12bit 分辨率约为两位小数精度(100 / 2^12)。

在 Arduino 上的接线参考

同样的 SI7021 传感器也可以直接用在 Arduino + Standard Firmata 场景下。官方文档提供了对应的接线示意图与 Fritzing 工程:

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

Fritzing 接线工程:docs/breadboard/multi-SI7021-uno.fzz

在 Arduino 上使用时不写 port,只需 new Thermometer({ controller: "SI7021" }),I2C 默认走 A4(SDA)/ A5(SCL)引脚,地址由驱动自动解析为 0x40。

进阶:用 Multi 一次读取温度与湿度

由于 SI7021 集成了温度与湿度两个传感器,Johnny-Five 还提供了更简洁的组合用法:Multi 组件会自动挂载 thermometer 与 hygrometer 两个子组件。官方示例见 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("--------------------------------------");
  });
});

运行方式为:

node eg/multi-SI7021.js

Multi 的 SI7020 组件定义在 lib/sip.js,其 components 明确声明为 [HYGROMETER, THERMOMETER],这正是 SI7021 在 Multi 模式下同时提供温度和湿度读数的底层依据;而温度与湿度两条数据通道通过共享的 si7020-0x40 驱动实例保持同步。

测试验证:配置透传与延时约束

仓库测试 test/thermometer.js 中专门为 SI7020 控制器编写了 "Thermometer -- SI7020" 测试套件,验证了文档与源码中的两个关键行为:

  • fwdOptionsToi2cConfig:address: 0xff 与 bus: "i2c-1" 等选项会被原样透传给 i2cConfig,即用户可以在不修改驱动的情况下覆盖默认地址与 I2C 总线;
  • enforceExplicitReadDelay:无论是否显式传入,i2cConfig 收到的 delay 恒为 50000(μs),确保 no-hold 测量模式的时序满足数据手册要求。

这两条用例印证了"驱动固定强制 50ms 延时"这一实现事实,也为读者自行扩展或调试 I2C 时序提供了可参考的验证模式。

常见问题与使用注意事项

  • 不要省略 delay:SI7020/SI7021 的 no-hold 测量要求写寄存器与读数据之间至少间隔 22ms,Johnny-Five 固定为 50ms;若更换驱动或自行实现读取,务必保证该时序,否则可能读到过期数据。
  • 不要一次性请求 5 字节:虽然温度与湿度寄存器地址相邻,但芯片对一次多字节读取并不友好,官方驱动为温度、湿度各建一条 2 字节读通道。
  • 同一块板共享驱动:Drivers.get 以地址为 key 缓存驱动,多个组件(如 Thermometer 与 Hygrometer 并存)会共享同一个 I2C 通道,无需也不应重复初始化。
  • controller 名称二选一:"SI7021" 与 "SI7020" 在 Johnny-Five 中是等价的别名,代码中任意使用其一即可。

相关资源

登录后查看全文
johnny-five