Johnny-Five 在 Intel Edison 上使用 Grove 空气质量传感器TP-401ANode.js 环境监测实战【免费下载链接】johnny-fiveJavaScript Robotics and IoT programming framework, developed at Bocoup.项目地址: https://gitcode.com/gh_mirrors/jo/johnny-five导读本篇指南基于 Johnny-Five 官方示例 docs/grove-gas-tp401-edison.md 及其配套源码 eg/grove-gas-tp401-edison.js完整讲解如何在Intel Edison Arduino Breakout 开发板 Grove Base Shield v2平台上用 Johnny-Five 驱动 Grove 空气质量传感器TP-401A读取空气污染数据并在污染超标时驱动蜂鸣器Piezo发声报警。读完本文你将掌握Johnny-Five 的Board/Sensor/Piezo三大核心组件的联合使用方式、TP-401A 传感器的预热warm-up与 PPM 换算逻辑、以及一套可直接复制运行的室内空气质量监测与报警参考实现。该示例组件同样适用于任何Arduino 引脚兼容pin-out compatible的硬件平台Grove 传感器与扩展板的组合让接线与移植都极其简单。硬件清单与接线运行示例需要准备以下硬件硬件用途连接位置Intel Edison Arduino Breakout主控平台也可用其他 Arduino 兼容板—Grove Base Shield v2提供 Grove 标准 4-pin 接口免焊接线插于 Breakout 之上Grove 空气质量传感器TP-401A检测室内空气污染插入 Base Shield 的A0模拟输入插孔Grove 蜂鸣器模块Buzzer/Piezo污染超标时发声报警插入 Base Shield 的D6数字输出插孔接线的核心要点是A0与D6两个端口号它们在源码中分别对应new five.Sensor(A0)与new five.Piezo(6)接线与代码一一对应改动端口号需同步修改代码。运行示例在仓库根目录下通过命令行直接运行node eg/grove-gas-tp401-edison.js注意edison-io是与 Johnny-Five 配套的 Edison I/O 插件需要在环境中单独安装npm install edison-io。示例源码使用require(../lib/johnny-five)引用仓库本地的 johnny-five 实现见 eg/grove-gas-tp401-edison.js若在自有项目中运行则应改为require(johnny-five)并同时安装edison-io依赖。程序骨架用 edison-io 驱动 Intel Edison程序开头通过edison-io将 Intel Edison 注入 Johnny-Five 的Boardvar five require(johnny-five); var Edison require(edison-io); var board new five.Board({ io: new Edison() }); board.on(ready, function() { // 此处编写传感器与执行器逻辑 });new Edison()实例即为 Johnny-Five 的 I/O 插件io-plugin负责把 Johnny-Five 的统一硬件 API 映射到 Edison 的底层引脚操作five.Board({ io: new Edison() })表示本次板卡由edison-io提供引脚读写能力因此后续的Sensor、Piezo都能在 Edison 上正常工作只有当board触发ready事件后才能安全地创建组件实例——这是 Johnny-Five 所有示例的统一模式。与之对比docs/board.md 与 docs/board-with-port.md 展示了使用 Firmata 固件时省略io配置的默认板卡方式而本例通过注入edison-io完成了同一抽象层在不同硬件平台上的对接体现了 Johnny-Five write once, run anywhere 的设计理念。核心组件一Sensor 读取模拟信号创建传感器实例var gas new five.Sensor(A0);当只传入一个引脚字符串时Johnny-Five 会将其解析为模拟analog传感器。从源码看lib/sensor.jsSensor构造器默认使用10 位 ADC 分辨率resolution 0x3FF即 0~1023并调用this.io.pinMode(this.pin, this.io.MODES.ANALOG)将 A0 配置为模拟输入模式如果 I/O 插件自身声明了更高的 ADC 分辨率如io.RESOLUTION.ADC则自动采用插件提供的分辨率参见 test/sensor.js 对ioPluginProvidesBitResolution的验证。关键配置项与默认值结合 lib/sensor.js 与 test/sensor.js 中测试用例defShape的断言Sensor的默认行为如下配置项默认值含义freq25ms内部采样事件的触发间隔决定data/change事件的产生频率range[0, resolution]即[0, 1023]模拟值映射时的源范围threshold1触发change事件所需的最小变化量±阈值limitnull上下限告警边界默认关闭事件机制data 与 change传感器在每次freq间隔到达时执行一次采样处理lib/sensor.js模拟读数会先累积到samples数组再取中位数median过滤噪声然后触发data事件携带取整后的中位值仅当中位值相对上一次触发值的变化达到 ±threshold时才触发change事件——这正是本例选用gas.on(change, ...)的原因避免每个采样周期都重复执行污染判断与报警逻辑只在读数发生实质变化时才响应若配置了limit超出边界时还会触发limit/limit:lower/limit:upper事件。test/sensor.js中的data测试test/sensor.js使用假时钟精确验证了data事件必须等到首个freq间隔结束才触发、此后严格按freq周期触发的行为可作为理解事件时序的参考。常用辅助属性与方法Sensor实例还暴露了多个派生属性lib/sensor.jsraw原始读数、value当前值若设置了 scale 则为缩放值、analog0~255 映射值、boolean与阈值比较的布尔态、scaled按比例缩放后的值等方法包括scale()/scaleTo()/fscaleTo()进行范围映射、booleanAt()设置布尔阈值、enable()/disable()启停采样。本例直接读取this.value即 A0 的 10 位原始读数来计算 PPM。核心组件二Piezo 蜂鸣器报警var alarm new five.Piezo(6);new five.Piezo(6)在 D6 引脚上创建一个蜂鸣器实例。从源码看lib/piezo.js默认控制器会将引脚配置为OUTPUT输出模式并通过nanotimer以微秒级定时翻转引脚电平生成方波音调。在污染超标时示例这样触发报警if (!alarm.isPlaying) { alarm.frequency(five.Piezo.Notes.d5, 5000); }alarm.isPlaying是一个只读布尔属性lib/piezo.js用于防止重复触发同一段报警音five.Piezo.Notes.d5是预置音符表lib/piezo.js中的 D5 音符对应587 Hzfrequency(frequency, duration)以Hz 为单位的频率和毫秒为单位的时长播放音调lib/piezo.js此处5000表示持续 5 秒。Piezo 还支持更丰富的用法play()可播放由「音符 拍数」数组或字符串谱子组成的旋律tone()用于更底层的占空比音调控制noTone()/off()用于静音stop()用于终止播放详见 docs/piezo.md 与 eg/piezo.js。本例采用单音符持续报警是最简单直接的告警形态。传感器预热与 PPM 换算预热保护warm-upTP-401A 这类电化学/金属氧化物气敏元件上电后需要一段时间达到稳定工作状态。示例根据 Intel 官方资料在代码中明确处理了这一特性var startAt Date.now(); // ... if (isWarming()) { return; } function isWarming() { return (Date.now() - startAt) 180000; }程序启动时记录startAt时间戳isWarming()判断自启动起是否不足180000 ms3 分钟预热期间change回调直接return不进行污染判断避免将预热期的漂移读数误判为真实污染。该实现细节来自示例源码注释中引用的 Intel 官方文档对传感器 warm up 时间2~3 分钟的说明是真实项目中最容易遗漏、也最影响测量准确性的环节。原始读数 → PPM 换算模拟量读数是 0~1023 的 10 位 ADC 值示例依据 TP-401A 数据手册的线性近似将其换算为污染浓度PPMfunction toPPM(value) { return 25 * value / 1023; }满量程读数 1023 对应约25 PPM的污染物浓度即每个 ADC 计数约等于25 / 1023 ≈ 0.0244PPM换算依据是 Seeed Studio 发布的 TP-401A 数据手册示例源码注释中给出这是该传感器室内空气质量估算的常用工程近似非精密测量手段。空气质量分级与报警逻辑污染等级划分示例还定义了一个基于 PPM 的空气质量分级函数其阈值与描述源自 Intel UPM 库中 TP401 驱动类的实现function quality(ppm) { if (ppm 50) { return Fresh Air; } if (ppm 200) { return Normal Indoor Air; } if (ppm 400) { return Low Pollution; } if (ppm 600) { return High Pollution - Action Recommended; } return Very High Pollution - Take Action Immediately; }PPM 范围空气质量等级 50Fresh Air清新空气50 ~ 200Normal Indoor Air正常室内空气200 ~ 400Low Pollution轻度污染400 ~ 600High Pollution - Action Recommended高度污染建议采取措施 600Very High Pollution - Take Action Immediately极高污染立即行动报警触发条件gas.on(change, function() { if (isWarming()) { return; } var ppm toPPM(this.value); if (ppm 400) { if (!alarm.isPlaying) { alarm.frequency(five.Piezo.Notes.d5, 5000); } } });报警逻辑可归纳为三个条件全部满足才发声已度过 3 分钟预热期isWarming()为 false换算后的 PPM大于 400对应High Pollution及以上等级蜂鸣器当前未在播放!alarm.isPlaying防止事件频繁触发造成报警音重复叠加。this.value在change回调中即触发本次事件的 Sensor 实例等价于gas.value可在回调中直接读取最新采样值。如何扩展为完整的监测系统基于上述骨架可以低成本地扩展出更实用的功能打印分级结果在change回调中调用quality(ppm)将等级文本输出到控制台实现室内空气质量监测 报警一体化多级报警将触发阈值从单一的ppm 400扩展为分级响应例如轻度污染闪烁 LED、重度污染连续蜂鸣数据可视化使用sensor.on(data, ...)高频采样并用串口/网络上报配合 Web 界面展示污染曲线可参考仓库中 eg/radar.js、eg/radar.html 的浏览器可视化模式自定义采样频率通过new five.Sensor({ pin: A0, freq: 100 })调整采样间隔权衡响应速度与系统开销。小结docs/grove-gas-tp401-edison.md展示了一条完整的 Johnny-Five 物联网传感器应用链路edison-io完成平台对接 →Sensor在 A0 上以中值滤波方式持续采样 → 预热保护过滤启动漂移 → 线性换算得到 PPM → 分级判定污染等级 →Piezo在 D6 上发声报警。这套传感器读取 → 数据处理 → 阈值判定 → 执行器响应的范式可以直接迁移到其他 Grove 传感器温湿度、光敏、气体等与任意 Arduino 兼容平台上是 Johnny-Five 入门与进阶都极具参考价值的实战模板。若要进一步学习可继续阅读仓库中的 docs/sensor.mdSensor 通用示例、docs/piezo.mdPiezo 完整用法与对应的源码实现 lib/sensor.js、lib/piezo.js并结合 test/sensor.js 理解各组件的精确行为语义。【免费下载链接】johnny-fiveJavaScript Robotics and IoT programming framework, developed at Bocoup.项目地址: https://gitcode.com/gh_mirrors/jo/johnny-five创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Johnny-Five 在 Intel Edison 上使用 Grove 空气质量传感器（TP-401A）：Node.js 环境监测实战
Johnny-Five 在 Intel Edison 上使用 Grove 空气质量传感器TP-401ANode.js 环境监测实战【免费下载链接】johnny-fiveJavaScript Robotics and IoT programming framework, developed at Bocoup.项目地址: https://gitcode.com/gh_mirrors/jo/johnny-five导读本篇指南基于 Johnny-Five 官方示例 docs/grove-gas-tp401-edison.md 及其配套源码 eg/grove-gas-tp401-edison.js完整讲解如何在Intel Edison Arduino Breakout 开发板 Grove Base Shield v2平台上用 Johnny-Five 驱动 Grove 空气质量传感器TP-401A读取空气污染数据并在污染超标时驱动蜂鸣器Piezo发声报警。读完本文你将掌握Johnny-Five 的Board/Sensor/Piezo三大核心组件的联合使用方式、TP-401A 传感器的预热warm-up与 PPM 换算逻辑、以及一套可直接复制运行的室内空气质量监测与报警参考实现。该示例组件同样适用于任何Arduino 引脚兼容pin-out compatible的硬件平台Grove 传感器与扩展板的组合让接线与移植都极其简单。硬件清单与接线运行示例需要准备以下硬件硬件用途连接位置Intel Edison Arduino Breakout主控平台也可用其他 Arduino 兼容板—Grove Base Shield v2提供 Grove 标准 4-pin 接口免焊接线插于 Breakout 之上Grove 空气质量传感器TP-401A检测室内空气污染插入 Base Shield 的A0模拟输入插孔Grove 蜂鸣器模块Buzzer/Piezo污染超标时发声报警插入 Base Shield 的D6数字输出插孔接线的核心要点是A0与D6两个端口号它们在源码中分别对应new five.Sensor(A0)与new five.Piezo(6)接线与代码一一对应改动端口号需同步修改代码。运行示例在仓库根目录下通过命令行直接运行node eg/grove-gas-tp401-edison.js注意edison-io是与 Johnny-Five 配套的 Edison I/O 插件需要在环境中单独安装npm install edison-io。示例源码使用require(../lib/johnny-five)引用仓库本地的 johnny-five 实现见 eg/grove-gas-tp401-edison.js若在自有项目中运行则应改为require(johnny-five)并同时安装edison-io依赖。程序骨架用 edison-io 驱动 Intel Edison程序开头通过edison-io将 Intel Edison 注入 Johnny-Five 的Boardvar five require(johnny-five); var Edison require(edison-io); var board new five.Board({ io: new Edison() }); board.on(ready, function() { // 此处编写传感器与执行器逻辑 });new Edison()实例即为 Johnny-Five 的 I/O 插件io-plugin负责把 Johnny-Five 的统一硬件 API 映射到 Edison 的底层引脚操作five.Board({ io: new Edison() })表示本次板卡由edison-io提供引脚读写能力因此后续的Sensor、Piezo都能在 Edison 上正常工作只有当board触发ready事件后才能安全地创建组件实例——这是 Johnny-Five 所有示例的统一模式。与之对比docs/board.md 与 docs/board-with-port.md 展示了使用 Firmata 固件时省略io配置的默认板卡方式而本例通过注入edison-io完成了同一抽象层在不同硬件平台上的对接体现了 Johnny-Five write once, run anywhere 的设计理念。核心组件一Sensor 读取模拟信号创建传感器实例var gas new five.Sensor(A0);当只传入一个引脚字符串时Johnny-Five 会将其解析为模拟analog传感器。从源码看lib/sensor.jsSensor构造器默认使用10 位 ADC 分辨率resolution 0x3FF即 0~1023并调用this.io.pinMode(this.pin, this.io.MODES.ANALOG)将 A0 配置为模拟输入模式如果 I/O 插件自身声明了更高的 ADC 分辨率如io.RESOLUTION.ADC则自动采用插件提供的分辨率参见 test/sensor.js 对ioPluginProvidesBitResolution的验证。关键配置项与默认值结合 lib/sensor.js 与 test/sensor.js 中测试用例defShape的断言Sensor的默认行为如下配置项默认值含义freq25ms内部采样事件的触发间隔决定data/change事件的产生频率range[0, resolution]即[0, 1023]模拟值映射时的源范围threshold1触发change事件所需的最小变化量±阈值limitnull上下限告警边界默认关闭事件机制data 与 change传感器在每次freq间隔到达时执行一次采样处理lib/sensor.js模拟读数会先累积到samples数组再取中位数median过滤噪声然后触发data事件携带取整后的中位值仅当中位值相对上一次触发值的变化达到 ±threshold时才触发change事件——这正是本例选用gas.on(change, ...)的原因避免每个采样周期都重复执行污染判断与报警逻辑只在读数发生实质变化时才响应若配置了limit超出边界时还会触发limit/limit:lower/limit:upper事件。test/sensor.js中的data测试test/sensor.js使用假时钟精确验证了data事件必须等到首个freq间隔结束才触发、此后严格按freq周期触发的行为可作为理解事件时序的参考。常用辅助属性与方法Sensor实例还暴露了多个派生属性lib/sensor.jsraw原始读数、value当前值若设置了 scale 则为缩放值、analog0~255 映射值、boolean与阈值比较的布尔态、scaled按比例缩放后的值等方法包括scale()/scaleTo()/fscaleTo()进行范围映射、booleanAt()设置布尔阈值、enable()/disable()启停采样。本例直接读取this.value即 A0 的 10 位原始读数来计算 PPM。核心组件二Piezo 蜂鸣器报警var alarm new five.Piezo(6);new five.Piezo(6)在 D6 引脚上创建一个蜂鸣器实例。从源码看lib/piezo.js默认控制器会将引脚配置为OUTPUT输出模式并通过nanotimer以微秒级定时翻转引脚电平生成方波音调。在污染超标时示例这样触发报警if (!alarm.isPlaying) { alarm.frequency(five.Piezo.Notes.d5, 5000); }alarm.isPlaying是一个只读布尔属性lib/piezo.js用于防止重复触发同一段报警音five.Piezo.Notes.d5是预置音符表lib/piezo.js中的 D5 音符对应587 Hzfrequency(frequency, duration)以Hz 为单位的频率和毫秒为单位的时长播放音调lib/piezo.js此处5000表示持续 5 秒。Piezo 还支持更丰富的用法play()可播放由「音符 拍数」数组或字符串谱子组成的旋律tone()用于更底层的占空比音调控制noTone()/off()用于静音stop()用于终止播放详见 docs/piezo.md 与 eg/piezo.js。本例采用单音符持续报警是最简单直接的告警形态。传感器预热与 PPM 换算预热保护warm-upTP-401A 这类电化学/金属氧化物气敏元件上电后需要一段时间达到稳定工作状态。示例根据 Intel 官方资料在代码中明确处理了这一特性var startAt Date.now(); // ... if (isWarming()) { return; } function isWarming() { return (Date.now() - startAt) 180000; }程序启动时记录startAt时间戳isWarming()判断自启动起是否不足180000 ms3 分钟预热期间change回调直接return不进行污染判断避免将预热期的漂移读数误判为真实污染。该实现细节来自示例源码注释中引用的 Intel 官方文档对传感器 warm up 时间2~3 分钟的说明是真实项目中最容易遗漏、也最影响测量准确性的环节。原始读数 → PPM 换算模拟量读数是 0~1023 的 10 位 ADC 值示例依据 TP-401A 数据手册的线性近似将其换算为污染浓度PPMfunction toPPM(value) { return 25 * value / 1023; }满量程读数 1023 对应约25 PPM的污染物浓度即每个 ADC 计数约等于25 / 1023 ≈ 0.0244PPM换算依据是 Seeed Studio 发布的 TP-401A 数据手册示例源码注释中给出这是该传感器室内空气质量估算的常用工程近似非精密测量手段。空气质量分级与报警逻辑污染等级划分示例还定义了一个基于 PPM 的空气质量分级函数其阈值与描述源自 Intel UPM 库中 TP401 驱动类的实现function quality(ppm) { if (ppm 50) { return Fresh Air; } if (ppm 200) { return Normal Indoor Air; } if (ppm 400) { return Low Pollution; } if (ppm 600) { return High Pollution - Action Recommended; } return Very High Pollution - Take Action Immediately; }PPM 范围空气质量等级 50Fresh Air清新空气50 ~ 200Normal Indoor Air正常室内空气200 ~ 400Low Pollution轻度污染400 ~ 600High Pollution - Action Recommended高度污染建议采取措施 600Very High Pollution - Take Action Immediately极高污染立即行动报警触发条件gas.on(change, function() { if (isWarming()) { return; } var ppm toPPM(this.value); if (ppm 400) { if (!alarm.isPlaying) { alarm.frequency(five.Piezo.Notes.d5, 5000); } } });报警逻辑可归纳为三个条件全部满足才发声已度过 3 分钟预热期isWarming()为 false换算后的 PPM大于 400对应High Pollution及以上等级蜂鸣器当前未在播放!alarm.isPlaying防止事件频繁触发造成报警音重复叠加。this.value在change回调中即触发本次事件的 Sensor 实例等价于gas.value可在回调中直接读取最新采样值。如何扩展为完整的监测系统基于上述骨架可以低成本地扩展出更实用的功能打印分级结果在change回调中调用quality(ppm)将等级文本输出到控制台实现室内空气质量监测 报警一体化多级报警将触发阈值从单一的ppm 400扩展为分级响应例如轻度污染闪烁 LED、重度污染连续蜂鸣数据可视化使用sensor.on(data, ...)高频采样并用串口/网络上报配合 Web 界面展示污染曲线可参考仓库中 eg/radar.js、eg/radar.html 的浏览器可视化模式自定义采样频率通过new five.Sensor({ pin: A0, freq: 100 })调整采样间隔权衡响应速度与系统开销。小结docs/grove-gas-tp401-edison.md展示了一条完整的 Johnny-Five 物联网传感器应用链路edison-io完成平台对接 →Sensor在 A0 上以中值滤波方式持续采样 → 预热保护过滤启动漂移 → 线性换算得到 PPM → 分级判定污染等级 →Piezo在 D6 上发声报警。这套传感器读取 → 数据处理 → 阈值判定 → 执行器响应的范式可以直接迁移到其他 Grove 传感器温湿度、光敏、气体等与任意 Arduino 兼容平台上是 Johnny-Five 入门与进阶都极具参考价值的实战模板。若要进一步学习可继续阅读仓库中的 docs/sensor.mdSensor 通用示例、docs/piezo.mdPiezo 完整用法与对应的源码实现 lib/sensor.js、lib/piezo.js并结合 test/sensor.js 理解各组件的精确行为语义。【免费下载链接】johnny-fiveJavaScript Robotics and IoT programming framework, developed at Bocoup.项目地址: https://gitcode.com/gh_mirrors/jo/johnny-five创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考