1. 项目概述用Node.js在树莓派上玩转I2C温度监控最近在折腾一个智能家居的小项目需要实时监控房间角落的温度但又不想用那些成品模块总觉得少了点动手的乐趣。手头正好有个闲置的树莓派Zero W和一块经典的DS1621温度传感器芯片就琢磨着能不能用Node.js写个服务既能通过I2C总线读取传感器数据又能实时展示在网页上。这个组合听起来有点跨界——一个是擅长硬件交互的单板计算机另一个则是以构建高性能网络服务见长的JavaScript运行时。但实际做下来发现Node.js凭借其强大的i2c-bus库和事件驱动模型在树莓派上操作I2C设备异常顺手几行代码就能把传感器数据变成Web API非常适合用来快速搭建物联网原型或者数据面板。这个项目本质上是一个微型的“硬件即服务”案例。核心目标很明确让树莓派通过I2C接口与DS1621传感器对话读取其测量的温度值然后利用Node.js内置的HTTP模块创建一个轻量级Web服务器将温度数据以JSON格式或动态网页的形式推送给任何连接到同一局域网的浏览器或客户端。它省去了复杂的Apache或Nginx配置一个脚本同时扮演了“设备驱动”和“Web后端”两个角色功耗极低非常适合7x24小时运行在角落里的树莓派Zero W上。如果你是对物联网感兴趣的Web开发者想了解如何让JavaScript跳出浏览器、直接操控硬件或者是电子爱好者希望为你的硬件项目快速添加一个网络监控界面那么这个项目会是一个绝佳的起点。整个过程涉及Linux基础配置、I2C总线原理、Node.js硬件接口编程以及简单的Web开发但我会一步步拆解确保即便你之前没接触过树莓派或I2C也能跟着做出来。2. 核心思路与方案选型解析2.1 为什么选择Node.js 树莓派 I2C这个组合首先得说说为什么是这三个元素的组合。树莓派作为一款流行的单板计算机其GPIO通用输入输出引脚支持包括I2C在内的多种硬件通信协议这为我们连接传感器提供了物理基础。而Node.js虽然最初是为网络后端而生但其非阻塞I/O和事件循环架构恰好适合处理像读取传感器数据这种频率不高、但需要持续轮询或监听中断的IO密集型任务。你不需要像在传统单片机编程中那样死循环或处理复杂的中断服务程序只需用setInterval定时读取或者利用某些传感器的中断引脚特性DS1621支持温度阈值中断配合事件监听即可代码逻辑非常清晰。更重要的是Node.js拥有一个极其活跃的生态系统。对于硬件交互有i2c-bus这样成熟、底层的库它提供了近乎原生的I2C总线访问能力对于Web服务其内置的http或express框架能快速搭建REST API或服务器渲染页面。这意味着你用一种语言JavaScript和一套工具npm就能打通从最底层的硬件信号读取到最上层的网络数据展示的整个链路极大地简化了开发和部署的复杂度。至于I2C总线本身它是这个项目的通信基石。I2C是一种同步、半双工、多主从的串行通信总线只需要两根线SDA数据线和SCL时钟线就能连接多个设备每个设备有唯一的地址。DS1621的默认地址是0x48可通过硬件引脚配置为其他地址这就像它在I2C网络上的门牌号。选择I2C而不是SPI或UART主要是因为它接线简单仅需两根信号线加电源和地并且树莓派Linux内核原生支持通过/dev/i2c-1这样的设备文件就能轻松访问无需额外编写内核模块。2.2 硬件选型与成本考量为何是DS1621和树莓派Zero WDS1621是一款非常经典的数字温度传感器其输出是直接的数字值无需像热敏电阻那样进行复杂的模拟-数字转换和校准。它的测量范围是-55°C到125°C精度为±0.5°C对于室内环境监控完全够用。而且它本身就是一个完整的I2C从设备内部集成了ADC和寄存器我们只需要发送简单的命令字如启动转换、读取温度值就能获取数据硬件电路极其简洁只需要在电源引脚加个0.1uF的退耦电容即可稳定工作。树莓派Zero W是我认为的“物联网终端神器”。它体积小巧仅65mm x 30mm功耗极低空闲时约100mA5V/0.5W并且集成了Wi-Fi和蓝牙。低功耗意味着你可以用普通的移动电源或电池组让它连续工作好几天非常适合部署在不易布线的地方。虽然它的计算性能单核1GHz ARM11不如Pi 3或4但对于运行一个Node.js脚本、服务几个网页请求来说绰绰有余。当然如果你手头是树莓派3B或4B整个过程完全一样性能还会更强只是功耗和体积会大一些。这个组合的整体成本非常低树莓派Zero W约10-15美元DS1621传感器芯片约2-3美元加上一些杜邦线和面包板总成本可以控制在20美元以内。相比一些集成的物联网开发板或商业温湿度计它给了你完全的软件控制权和硬件扩展能力。注意市面上有些DS1621是DIP-8封装直插有些是SO-8贴片。对于面包板实验DIP封装更方便。购买时请确认是DS1621而非DS18B20单总线协议或其他型号。3. 硬件连接与树莓派系统配置详解3.1 电路连接从原理图到面包板DS1621与树莓派Zero W的连接非常简单只需要4根杜邦线母对公。树莓派Zero W的GPIO引脚排列与标准40针的树莓派一致我们需要找到I2C1所使用的两个引脚GPIO 2 (SDA1)对应物理引脚第3针。GPIO 3 (SCL1)对应物理引脚第5针。此外还需要为传感器提供电源和地3.3V电源树莓派Zero W的物理引脚第1针或第17针提供3.3V输出。DS1621的工作电压范围是2.7V到5.5V因此使用3.3V完全兼容且与树莓派的GPIO逻辑电平匹配无需电平转换。接地 (GND)树莓派上任意一个GND引脚例如物理引脚第6、9、14、20、25、30、34、39等。具体接线如下将DS1621的VDD引脚通常为第8脚连接到树莓派的3.3V引脚。将DS1621的GND引脚通常为第4脚连接到树莓派的任意GND引脚。将DS1621的SDA引脚通常为第5脚连接到树莓派的GPIO 2 (SDA1)。将DS1621的SCL引脚通常为第6脚连接到树莓派的GPIO 3 (SCL1)。DS1621的其余引脚A0, A1, A2用于设置I2C地址Tout为温度报警输出在此项目中我们暂不使用可以悬空。为了电源稳定建议在DS1621的VDD和GND引脚之间焊接或插接一个0.1µF的陶瓷电容尽可能靠近芯片引脚。实操心得连接时务必在树莓派断电状态下进行。虽然I2C总线理论上支持热插拔但带电操作杜邦线容易造成瞬间短路可能损坏GPIO或传感器。接好后最好用万用表通断档快速检查一下电源和地是否接反、SDA/SCL是否与相邻电源线短路这是避免“冒烟测试”失败的关键一步。3.2 树莓派系统准备从烧录到基础服务启用首先需要为树莓派准备操作系统。我推荐使用Raspberry Pi OS Lite (32-bit)这是一个没有图形桌面的精简版本通过命令行管理资源占用极小非常适合服务器类应用。你可以从树莓派官网下载镜像并使用 Raspberry Pi Imager 工具烧录到Micro SD卡中。在烧录前Imager工具允许你进行一些预配置点击设置图标设置主机名如temperature-pi。启用SSH勾选“Enable SSH”并建议设置密码认证或导入你的SSH公钥。配置Wi-Fi填入你的国家、SSID和密码这样树莓派启动后就能自动连接网络。设置地区选项时区、键盘布局等。这些设置会被写入SD卡启动分区省去了第一次启动后接显示器和键盘的麻烦。烧录完成后将SD卡插入树莓派Zero W上电启动。等待约一分钟后你需要找到树莓派在局域网中的IP地址。有多种方法登录你的路由器管理界面查看DHCP客户端列表。使用网络扫描工具如nmap在另一台Linux/Mac电脑上nmap -sn 192.168.1.0/24或“Fing”这类手机APP。如果树莓派连接了显示器启动后输入hostname -I命令查看。获得IP地址后就可以用SSH客户端连接了。Windows用户推荐使用 PuTTY macOS和Linux用户直接在终端使用ssh命令即可。例如ssh pi192.168.1.100默认用户名是pi密码是你之前通过Imager设置的或者是经典的raspberry如果未改。登录后第一件事是更新系统并安装必要软件sudo apt update sudo apt upgrade -y sudo apt install -y git nodejs npm检查Node.js和npm版本node -v npm -v较新版本的Raspberry Pi OS可能已经预装了Node.js但版本可能较旧。如果版本低于14.x建议通过NodeSource仓库安装更新的LTS版本。3.3 启用I2C接口并安装硬件访问库树莓派的I2C接口默认是禁用的需要手动开启。运行配置工具sudo raspi-config使用方向键选择Interface Options-I2C。当询问“Would you like the ARM I2C interface to be enabled?”时选择Yes。完成后选择Finish并选择重启。重启后SSH重新登录验证I2C是否启用ls /dev/i2c*你应该能看到类似/dev/i2c-1的设备文件。i2c-1对应的是GPIO 2/3这组I2C。为了能在非root用户下访问I2C设备将当前用户pi加入i2c组sudo usermod -aG i2c pi你需要注销并重新登录或重启才能使组权限生效。接下来安装Node.js的I2C库。我们将使用i2c-bus它提供了异步和同步的API功能强大npm install i2c-bus为了测试硬件连接是否正常我们可以先使用一个命令行工具i2c-toolssudo apt install -y i2c-tools安装后扫描I2C总线上的设备i2cdetect -y 1这条命令会扫描I2C-1总线对应GPIO 2/3上从地址0x03到0x77的所有设备。如果DS1621连接正确你应该能在输出表格中看到地址0x48或其他如果A0/A1/A2引脚被上拉/下拉改变了地址被标记为48或UU如果已被驱动占用。看到这个地址就证明物理连接和I2C总线驱动是正常的。4. Node.js与I2C通信的核心原理与代码实现4.1 I2C总线通信基础与DS1621指令集在编写代码前必须理解Node.js如何通过i2c-bus库与I2C设备对话。I2C通信的本质是主设备树莓派向从设备DS1621的特定寄存器读写数据。每个操作都以一个7位设备地址0x48开始后面跟着一个读/写位。i2c-bus库帮我们处理了底层的时序和协议我们只需要关心发送什么命令写入什么数据和读取多少字节。DS1621有几个关键的命令字Command Byte0xAA读取温度值。发送此命令后主设备可以读取两个字节的温度数据。0xEE开始温度转换。发送此命令DS1621开始一次AD转换。0x22停止温度转换。0xAC访问配置寄存器。可以读取或写入配置字节用于设置工作模式如连续转换或单次转换、设置温度阈值等。DS1621的温度数据格式是9位精度通过两个字节16位返回。具体格式如下字节1高8位包含温度的整数部分8位二进制补码形式。例如25°C对应0x19。字节2低8位只有最高位bit 7有效表示0.5°C。如果该位为1则表示温度有0.5°C的小数部分。其余位为0。因此温度计算公式为温度 字节1的值 (字节2 7) * 0.5。如果字节1的最高位bit 7为1则表示负数二进制补码需要先进行转换。在我们的示例中为了简化我们先处理正温度。4.2 编写核心的传感器读取模块首先创建一个项目目录并初始化mkdir temperature-monitor cd temperature-monitor npm init -y npm install i2c-bus然后创建第一个脚本文件read_ds1621.js实现最核心的温度读取功能const i2c require(i2c-bus); // DS1621的I2C地址 const DS1621_ADDR 0x48; // 命令字 const CMD_READ_TEMP 0xaa; const CMD_START_CONVERT 0xee; const CMD_ACCESS_CONFIG 0xac; /** * 从DS1621读取当前温度 * param {number} busNumber - I2C总线编号树莓派上通常为1 * returns {Promisenumber} 解析为摄氏度温度值的Promise */ async function readTemperature(busNumber 1) { // 异步打开I2C总线 const i2cBus await i2c.openPromisified(busNumber); try { // 1. 发送开始转换命令如果传感器未处于连续转换模式 // 对于DS1621上电后默认是单次转换模式。 // 为了确保读到最新数据我们先发送开始转换命令然后等待转换完成。 // 转换时间典型值为500ms9位精度时最大1秒。 await i2cBus.sendByte(DS1621_ADDR, CMD_START_CONVERT); // 等待转换完成。更严谨的做法是轮询配置寄存器的DONE位。 // 这里为了简单固定等待1秒。 await new Promise(resolve setTimeout(resolve, 1000)); // 2. 发送读取温度命令 await i2cBus.sendByte(DS1621_ADDR, CMD_READ_TEMP); // 3. 读取两个字节的温度数据 const buffer Buffer.alloc(2); await i2cBus.readI2cBlock(DS1621_ADDR, 0, buffer.length, buffer); // 4. 解析温度值 let tempHigh buffer[0]; // 整数部分 let tempLow buffer[1]; // 低字节仅最高位有效 // 判断是否为负数补码最高位为1 let temperature; if (tempHigh 0x80) { // 负数处理先取反加1得到绝对值的二进制再结合小数位 tempHigh (~tempHigh) 0xff; // 简单处理本例假设温度为正负数处理逻辑略复杂此处先返回0 // 实际应用中需要完整实现补码转换 temperature 0 - (tempHigh ((tempLow 7) * 0.5)); } else { // 正数处理 temperature tempHigh ((tempLow 7) * 0.5); } return temperature; } catch (error) { console.error(读取温度失败:, error); throw error; // 将错误向上抛 } finally { // 确保关闭I2C总线释放资源 await i2cBus.close(); } } // 示例立即读取一次温度 (async () { try { const temp await readTemperature(1); console.log(当前温度: ${temp.toFixed(1)} °C); } catch (err) { console.error(执行失败:, err); } })();这个模块定义了一个readTemperature异步函数它封装了与DS1621通信的全部细节启动转换、等待、发送读命令、读取原始数据、解析为摄氏度。使用async/await语法让异步操作看起来像同步代码一样清晰。注意我们使用了i2c.openPromisified它返回一个支持Promise的I2C总线对象这样可以用await来调用其方法。重要提示i2c-bus库的readI2cBlock方法在读取时实际上会先发送一个内部的“寄存器指针”字节这里我们传入了0但有些设备需要指定寄存器地址。对于DS1621在发送0xAA读温度命令后其内部指针已经指向温度数据的高字节所以直接读取两个字节即可。这是理解I2C设备数据手册的关键每个命令都可能改变了内部指针的状态。4.3 构建一个简单的HTTP服务器提供数据API仅有读取温度的函数还不够我们需要一个方式将数据暴露出去。接下来我们创建一个Web服务器它提供两个端点一个返回JSON格式的纯数据API另一个返回一个自动刷新的简单网页。创建文件server.jsconst http require(http); const url require(url); const { readTemperature } require(./read_ds1621.js); // 导入刚才写的模块 // 创建一个HTTP服务器 const server http.createServer(async (req, res) { const parsedUrl url.parse(req.url, true); const pathname parsedUrl.pathname; // 设置CORS头部允许任何来源的请求仅用于开发测试 res.setHeader(Access-Control-Allow-Origin, *); res.setHeader(Access-Control-Allow-Methods, GET); // 路由处理 if (pathname /api/temperature req.method GET) { // 端点1: 返回JSON格式的温度数据 try { const temp await readTemperature(1); res.writeHead(200, { Content-Type: application/json }); res.end(JSON.stringify({ success: true, temperature: temp, unit: celsius, timestamp: new Date().toISOString() })); } catch (error) { res.writeHead(500, { Content-Type: application/json }); res.end(JSON.stringify({ success: false, error: error.message })); } } else if (pathname / || pathname /index.html) { // 端点2: 返回一个简单的HTML页面自动刷新显示温度 res.writeHead(200, { Content-Type: text/html; charsetutf-8 }); res.end( !DOCTYPE html html langen head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 titleDS1621 Temperature Monitor/title style body { font-family: Arial, sans-serif; text-align: center; padding: 50px; background-color: #f0f0f0; } .container { background: white; padding: 30px; border-radius: 10px; display: inline-block; box-shadow: 0 0 10px rgba(0,0,0,0.1); } h1 { color: #333; } #tempValue { font-size: 4em; font-weight: bold; color: #e74c3c; margin: 20px 0; } .unit { font-size: 0.5em; color: #777; } #lastUpdate { color: #95a5a6; margin-top: 20px; } .loading { color: #3498db; } /style /head body div classcontainer h1️ DS1621 Temperature Monitor/h1 div idtempDisplay div idtempValue classloadingLoading.../div divTemperature/div /div div idlastUpdateLast updated: span idupdateTime--/span/div psmallData updates every 5 seconds/small/p /div script function updateTemperature() { fetch(/api/temperature) .then(response response.json()) .then(data { const display document.getElementById(tempValue); const timeSpan document.getElementById(updateTime); if (data.success) { display.innerHTML ${data.temperature.toFixed(1)} span classunit°C/span; display.className ; timeSpan.textContent new Date(data.timestamp).toLocaleTimeString(); } else { display.textContent Error; display.style.color #e74c3c; } }) .catch(err { console.error(Fetch error:, err); document.getElementById(tempValue).textContent Connection Error; }); } // 页面加载后立即更新一次 updateTemperature(); // 然后每5秒更新一次 setInterval(updateTemperature, 5000); /script /body /html ); } else { // 404 处理 res.writeHead(404, { Content-Type: text/plain }); res.end(Not Found); } }); // 启动服务器监听8080端口 const PORT process.env.PORT || 8080; server.listen(PORT, () { console.log(✅ Server running at http://0.0.0.0:${PORT}); console.log( Local: http://localhost:${PORT}); console.log( Network: http://YOUR_PI_IP:${PORT}); });这个服务器做了几件事创建HTTP服务器使用Node.js内置的http模块。路由处理当访问/api/temperature时调用readTemperature函数并将结果以JSON格式返回。这种设计便于其他程序如手机APP、Home Assistant通过API获取数据。当访问根路径/时返回一个内嵌了JavaScript的HTML页面。这个页面会每5秒自动调用/api/temperature接口并更新页面上的温度显示。错误处理在读取温度失败时API会返回500错误和错误信息前端页面也会显示错误状态。CORS设置为了方便开发测试我们设置了Access-Control-Allow-Origin: *允许任何网页访问API。在生产环境中你应该将其替换为具体的域名以增强安全性。现在将read_ds1621.js和server.js放在同一个目录下然后运行node server.js如果一切正常你将看到服务器启动的日志。此时在你的电脑或手机浏览器中输入树莓派的IP地址和端口例如http://192.168.1.100:8080就能看到温度监控页面了。页面初始显示“Loading...”5秒内会更新为具体的温度值并且之后每5秒自动刷新一次。5. 深入优化性能、稳定性与功能扩展5.1 性能优化与资源管理上面的基础版本虽然能工作但在长期运行和资源管理上还有优化空间。主要问题有两个一是每次HTTP请求都打开、关闭一次I2C总线二是每次读取都重新启动一次温度转换并等待1秒这会导致响应慢且效率低。优化方案1保持I2C总线长连接并缓存温度值对于长期运行的服务我们应该在服务启动时打开I2C总线并在整个生命周期内复用这个连接。同时可以设置一个后台定时器例如每2秒主动读取温度并缓存这样Web请求到来时能立即返回缓存的值响应速度极快毫秒级。创建优化版temperature_service.jsconst i2c require(i2c-bus); const http require(http); const DS1621_ADDR 0x48; const CMD_READ_TEMP 0xaa; const CMD_START_CONVERT 0xee; const CMD_ACCESS_CONFIG 0xac; const CMD_READ_CONFIG 0xac; class TemperatureService { constructor(busNumber 1, updateInterval 2000) { this.busNumber busNumber; this.updateInterval updateInterval; this.i2cBus null; this.currentTemperature null; this.lastUpdateTime null; this.isUpdating false; this.updateTimer null; } async init() { try { // 打开I2C总线并保持打开状态 this.i2cBus await i2c.openPromisified(this.busNumber); console.log(I2C bus ${this.busNumber} opened successfully.); // 可选配置DS1621为连续转换模式这样它就会自动持续测量 // 写入配置寄存器连续转换模式 (bit 0 0), 保持默认其他位 await this.i2cBus.writeByte(DS1621_ADDR, CMD_ACCESS_CONFIG, 0x00); // 发送开始转换命令在连续模式下只需发一次 await this.i2cBus.sendByte(DS1621_ADDR, CMD_START_CONVERT); console.log(DS1621 configured for continuous conversion.); // 立即进行一次初始读取 await this.updateTemperature(); // 启动定时更新 this.startPeriodicUpdate(); return true; } catch (error) { console.error(Failed to initialize TemperatureService:, error); await this.cleanup(); throw error; } } async updateTemperature() { if (this.isUpdating || !this.i2cBus) return; this.isUpdating true; try { // 发送读取温度命令 await this.i2cBus.sendByte(DS1621_ADDR, CMD_READ_TEMP); // 读取两个字节 const buffer Buffer.alloc(2); await this.i2cBus.readI2cBlock(DS1621_ADDR, 0, buffer.length, buffer); let tempHigh buffer[0]; let tempLow buffer[1]; let temperature; // 简化的正温度解析负数处理略 if (tempHigh 0x80) { // 简单处理负数本例假设环境温度为正若为负则按补码计算 // 实际应完整实现补码转换此处返回一个错误值或特殊值 temperature null; // 表示读取异常 } else { temperature tempHigh ((tempLow 7) * 0.5); } if (temperature ! null) { this.currentTemperature temperature; this.lastUpdateTime new Date(); } } catch (error) { console.error(Error updating temperature:, error); } finally { this.isUpdating false; } } startPeriodicUpdate() { if (this.updateTimer) clearInterval(this.updateTimer); this.updateTimer setInterval(() { this.updateTemperature(); }, this.updateInterval); console.log(Periodic temperature update started (every ${this.updateInterval}ms).); } getTemperature() { return { temperature: this.currentTemperature, lastUpdate: this.lastUpdateTime, success: this.currentTemperature ! null }; } async cleanup() { if (this.updateTimer) { clearInterval(this.updateTimer); this.updateTimer null; } if (this.i2cBus) { await this.i2cBus.close(); console.log(I2C bus closed.); } } } // 使用示例创建服务并启动HTTP服务器 (async () { const tempService new TemperatureService(1, 2000); // 每2秒更新一次 try { await tempService.init(); const server http.createServer((req, res) { if (req.url /api/temperature req.method GET) { const data tempService.getTemperature(); res.writeHead(200, { Content-Type: application/json }); res.end(JSON.stringify({ ...data, timestamp: new Date().toISOString() })); } else { res.writeHead(200, { Content-Type: text/plain }); res.end(Temperature Monitor Service. Use GET /api/temperature); } }); const PORT 8080; server.listen(PORT, () { console.log( Optimized server listening on port ${PORT}); }); // 优雅关闭捕获退出信号清理资源 process.on(SIGINT, async () { console.log(\nShutting down gracefully...); await tempService.cleanup(); server.close(() { console.log(Server closed.); process.exit(0); }); }); } catch (error) { console.error(Service startup failed:, error); process.exit(1); } })();这个优化版做了重大改进单例与长连接TemperatureService类在初始化时打开I2C总线并保持打开避免了频繁开关的开销。后台轮询与缓存设置一个setInterval定时器每2秒主动读取一次温度并更新内部缓存currentTemperature。Web API请求直接返回缓存值响应速度极快。连续转换模式通过写入配置寄存器(0xAC)将DS1621设置为连续转换模式。在这种模式下传感器会自动持续进行AD转换我们读取时总能拿到相对较新的数据无需每次发送开始转换命令并等待1秒将读取延迟从秒级降到毫秒级。优雅关闭监听SIGINT信号如CtrlC在程序退出前主动关闭I2C总线和HTTP服务器确保资源被正确释放。5.2 异常处理与日志记录一个健壮的服务必须能处理各种异常情况并留下清晰的日志供排查。我们可以在上面的服务中添加更完善的错误处理和日志。首先安装一个简单的日志库如winston或pino这里为了轻量我们使用内置的console并稍加封装同时将错误写入文件// 在temperature_service.js开头添加 const fs require(fs).promises; const path require(path); class Logger { constructor(logDir ./logs) { this.logDir logDir; this.init(); } async init() { try { await fs.mkdir(this.logDir, { recursive: true }); } catch (err) { console.error(Could not create log directory:, err); } } async log(level, message, meta {}) { const timestamp new Date().toISOString(); const logEntry ${timestamp} [${level.toUpperCase()}] ${message} ${Object.keys(meta).length ? JSON.stringify(meta) : }\n; // 输出到控制台 console.log(logEntry.trim()); // 写入到文件按日期 const dateStr new Date().toISOString().split(T)[0]; const logFile path.join(this.logDir, temp_service_${dateStr}.log); try { await fs.appendFile(logFile, logEntry); } catch (err) { console.error(Failed to write log file:, err); } } info(message, meta) { return this.log(info, message, meta); } error(message, meta) { return this.log(error, message, meta); } warn(message, meta) { return this.log(warn, message, meta); } } // 在TemperatureService构造函数中初始化logger // this.logger new Logger();然后在TemperatureService的各个方法中用this.logger.info()、this.logger.error()替换console.log和console.error。这样所有的运行状态、温度读数、错误信息都会同时输出到控制台和按日期分割的日志文件中便于后期排查问题。对于I2C通信中可能出现的异常如总线错误、设备无响应等除了在catch块中记录日志外还可以实现重试机制。例如在updateTemperature方法中如果连续多次读取失败可以尝试重新初始化I2C总线或重启转换命令。5.3 功能扩展思路基础的温度读取和Web展示完成后这个项目可以轻松扩展出更多实用功能1. 添加历史数据记录与图表展示使用轻量级数据库如SQLite通过sqlite3npm包或甚至直接写入JSON文件定期如每分钟将温度值连同时间戳存储起来。然后可以新增一个API端点如/api/temperature/history?hours24来查询历史数据。前端可以使用Chart.js等库绘制温度变化曲线图。2. 实现温度报警与通知在TemperatureService类中添加阈值检查逻辑。例如设置一个高温报警阈值如30°C和低温报警阈值如10°C。每次更新温度后进行检查如果超过阈值且距离上次报警已过一段时间防骚扰则触发报警动作。报警动作可以是在服务器日志中记录错误。向一个Webhook URL发送POST请求可用于触发IFTTT、钉钉、Slack等通知。发送电子邮件使用nodemailer库。控制一个连接到树莓派的蜂鸣器或LED灯。3. 支持多传感器与传感器抽象如果你有多个DS1621通过设置不同的A0/A1/A2地址或者想接入其他I2C传感器如BMP280气压计、OLED显示屏可以设计一个通用的Sensor基类或接口然后为每种传感器实现具体的read()方法。TemperatureService管理一个传感器列表定期读取所有传感器数据。Web API可以返回所有传感器的数据集合。4. 提供配置界面与远程控制目前参数如更新间隔、报警阈值是硬编码在代码中的。可以创建一个简单的配置页面另一个HTML文件通过表单让用户修改这些参数并保存到JSON配置文件中。服务器监听配置文件变化并动态应用新配置。这需要添加对应的POST API端点来处理配置更新。5. 容器化部署使用Docker将整个应用打包成一个镜像。这能确保运行环境的一致性简化部署。创建一个Dockerfile基于node:16-slim镜像复制代码安装依赖并设置启动命令。你甚至可以使用Docker Compose来编排多个服务如本应用加上一个Grafana用于可视化。6. 部署、维护与常见问题排查6.1 生产环境部署建议在开发测试完成后你可能希望这个服务能开机自启、稳定运行。有几种方法方法一使用systemd推荐这是Linux系统标准的服务管理方式。创建一个服务文件sudo nano /etc/systemd/system/temperature-monitor.service内容如下[Unit] DescriptionTemperature Monitor Service Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/temperature-monitor ExecStart/usr/bin/node /home/pi/temperature-monitor/temperature_service.js Restarton-failure RestartSec10 StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target然后启用并启动服务sudo systemctl daemon-reload sudo systemctl enable temperature-monitor.service sudo systemctl start temperature-monitor.service # 查看状态和日志 sudo systemctl status temperature-monitor.service journalctl -u temperature-monitor.service -f使用systemd的好处是管理方便start/stop/restart/status并且能自动重启崩溃的服务。方法二使用进程管理工具PM2PM2是Node.js生态中非常流行的进程管理器内置负载均衡、日志管理、监控等功能。# 全局安装PM2 sudo npm install -g pm2 # 启动你的服务 pm2 start temperature_service.js --name temp-monitor # 设置开机自启 pm2 startup # 按照PM2输出的命令执行通常是复制粘贴一行sudo命令 pm2 savePM2提供了丰富的命令pm2 list查看进程pm2 logs temp-monitor查看日志pm2 monit图形化监控。6.2 常见问题与排查技巧即使按照步骤操作也可能会遇到问题。下面是一个快速排查指南问题现象可能原因排查步骤运行node server.js时报错Error: EACCES: permission denied, open /dev/i2c-1当前用户没有访问I2C设备的权限。1. 确认用户已加入i2c组groups $USER查看输出是否包含i2c。2. 如果不在组内sudo usermod -aG i2c $USER然后注销并重新登录。3. 检查设备文件权限ls -l /dev/i2c-1应显示crw-rw----组为i2c。i2cdetect -y 1扫描不到设备地址0x48未出现硬件连接问题、电源问题、传感器损坏或地址不对。1.断电检查所有杜邦线连接是否牢固SDA/SCL是否接反。2. 用万用表测量DS1621的VCC和GND之间电压是否为3.3V左右。3. 检查DS1621的A0, A1, A2引脚是否全部接地默认地址0x48。如果接了VCC地址会改变。4. 尝试扫描所有地址i2cdetect -y 1 0x00 0x7f。5. 换一个I2C设备如OLED屏测试确认树莓派I2C功能正常。Web页面能打开但一直显示“Loading...”或“Error”Node.js服务读取传感器失败或网络端口不通。1. 在树莓派上直接运行读取测试脚本node read_ds1621.js看是否能输出温度。2. 检查服务器是否在运行ps aux温度读数不准、跳动大或为0电源噪声、传感器未校准、软件解析错误。1.确保电源稳定在DS1621的VCC和GND引脚之间并联一个0.1µF陶瓷电容并尽可能靠近芯片引脚焊接。2. 检查软件解析代码是否正确特别是正负数和0.5位的处理。3. 用i2c-tools的i2cget命令手动读取原始值验证sudo i2cget -y 1 0x48 0xAA w会返回两个字节的十六进制数如0x1900表示25.0°C。4. 将传感器与已知准确的温度计放在一起对比。服务运行一段时间后崩溃或无响应内存泄漏、未处理的异常、I2C总线锁死。1. 查看日志文件如果配置了或系统日志journalctl -u temperature-monitor.service --since 1 hour ago。2. 使用htop或free -h命令监控内存使用情况。3. 在代码中确保所有Promise都有.catch()处理防止未捕获的异常导致进程退出。4. 考虑在TemperatureService的updateTemperature方法中添加“看门狗”机制如果连续多次失败尝试重新初始化I2C总线。无法通过Wi-Fi访问网页树莓派和客户端不在同一网络或防火墙限制。1. 确认树莓派已连接Wi-Fiifconfig wlan0查看IP地址。2. 确认客户端设备手机/电脑和树莓派连接的是同一个局域网同一路由器下。3. 在树莓派上ping客户端IP在客户端ping树莓派IP检查双向连通性。4. 检查树莓派防火墙规则。6.3 性能监控与维护脚本为了让服务更稳健可以编写一些简单的维护脚本健康检查脚本health_check.sh:#!/bin/bash # 检查服务是否在运行 if ! pgrep -f temperature_service.js /dev/null; then echo 温度监控服务未运行正在重启... cd /home/pi/temperature-monitor /usr/bin/node temperature_service.js /var/log/temp_monitor.log 21 fi # 检查API是否响应 API_RESPONSE$(curl -s -o /dev/null -w %{http_code} http://localhost:8080/api/temperature || echo 000) if [ $API_RESPONSE ! 200 ]; then echo API无响应 (HTTP $API_RESPONSE)重启服务... pkill -f temperature_service.js sleep 2 cd /home/pi/temperature-monitor /usr/bin/node temperature_service.js /var/log/temp_monitor.log 21 fi然后通过cron定时任务每5分钟执行一次这个脚本crontab -e # 添加一行 */5 * * * * /home/pi/temperature-monitor/health_check.sh日志轮转配置防止日志文件无限增大。可以编辑/etc/logrotate.d/temperature-monitor/home/pi/temperature-monitor/logs/*.log { daily missingok rotate 7 compress delaycompress notifempty create 644 pi pi }这样日志会每天轮转一次保留最近7天的压缩副本。经过以上步骤你就拥有了一个从硬件连接到软件部署、从基础功能到优化扩展、从开发调试到生产维护的完整项目。它不仅仅是一个简单的温度读取脚本而是一个具备一定鲁棒性、可维护性和扩展性的物联网服务原型。你可以基于这个框架轻松替换其他I2C传感器或者添加更复杂的业务逻辑构建出属于自己的智能硬件应用。
Node.js与树莓派I2C通信实战：构建温度监控Web服务
发布时间：2026/5/25 18:38:11
1. 项目概述用Node.js在树莓派上玩转I2C温度监控最近在折腾一个智能家居的小项目需要实时监控房间角落的温度但又不想用那些成品模块总觉得少了点动手的乐趣。手头正好有个闲置的树莓派Zero W和一块经典的DS1621温度传感器芯片就琢磨着能不能用Node.js写个服务既能通过I2C总线读取传感器数据又能实时展示在网页上。这个组合听起来有点跨界——一个是擅长硬件交互的单板计算机另一个则是以构建高性能网络服务见长的JavaScript运行时。但实际做下来发现Node.js凭借其强大的i2c-bus库和事件驱动模型在树莓派上操作I2C设备异常顺手几行代码就能把传感器数据变成Web API非常适合用来快速搭建物联网原型或者数据面板。这个项目本质上是一个微型的“硬件即服务”案例。核心目标很明确让树莓派通过I2C接口与DS1621传感器对话读取其测量的温度值然后利用Node.js内置的HTTP模块创建一个轻量级Web服务器将温度数据以JSON格式或动态网页的形式推送给任何连接到同一局域网的浏览器或客户端。它省去了复杂的Apache或Nginx配置一个脚本同时扮演了“设备驱动”和“Web后端”两个角色功耗极低非常适合7x24小时运行在角落里的树莓派Zero W上。如果你是对物联网感兴趣的Web开发者想了解如何让JavaScript跳出浏览器、直接操控硬件或者是电子爱好者希望为你的硬件项目快速添加一个网络监控界面那么这个项目会是一个绝佳的起点。整个过程涉及Linux基础配置、I2C总线原理、Node.js硬件接口编程以及简单的Web开发但我会一步步拆解确保即便你之前没接触过树莓派或I2C也能跟着做出来。2. 核心思路与方案选型解析2.1 为什么选择Node.js 树莓派 I2C这个组合首先得说说为什么是这三个元素的组合。树莓派作为一款流行的单板计算机其GPIO通用输入输出引脚支持包括I2C在内的多种硬件通信协议这为我们连接传感器提供了物理基础。而Node.js虽然最初是为网络后端而生但其非阻塞I/O和事件循环架构恰好适合处理像读取传感器数据这种频率不高、但需要持续轮询或监听中断的IO密集型任务。你不需要像在传统单片机编程中那样死循环或处理复杂的中断服务程序只需用setInterval定时读取或者利用某些传感器的中断引脚特性DS1621支持温度阈值中断配合事件监听即可代码逻辑非常清晰。更重要的是Node.js拥有一个极其活跃的生态系统。对于硬件交互有i2c-bus这样成熟、底层的库它提供了近乎原生的I2C总线访问能力对于Web服务其内置的http或express框架能快速搭建REST API或服务器渲染页面。这意味着你用一种语言JavaScript和一套工具npm就能打通从最底层的硬件信号读取到最上层的网络数据展示的整个链路极大地简化了开发和部署的复杂度。至于I2C总线本身它是这个项目的通信基石。I2C是一种同步、半双工、多主从的串行通信总线只需要两根线SDA数据线和SCL时钟线就能连接多个设备每个设备有唯一的地址。DS1621的默认地址是0x48可通过硬件引脚配置为其他地址这就像它在I2C网络上的门牌号。选择I2C而不是SPI或UART主要是因为它接线简单仅需两根信号线加电源和地并且树莓派Linux内核原生支持通过/dev/i2c-1这样的设备文件就能轻松访问无需额外编写内核模块。2.2 硬件选型与成本考量为何是DS1621和树莓派Zero WDS1621是一款非常经典的数字温度传感器其输出是直接的数字值无需像热敏电阻那样进行复杂的模拟-数字转换和校准。它的测量范围是-55°C到125°C精度为±0.5°C对于室内环境监控完全够用。而且它本身就是一个完整的I2C从设备内部集成了ADC和寄存器我们只需要发送简单的命令字如启动转换、读取温度值就能获取数据硬件电路极其简洁只需要在电源引脚加个0.1uF的退耦电容即可稳定工作。树莓派Zero W是我认为的“物联网终端神器”。它体积小巧仅65mm x 30mm功耗极低空闲时约100mA5V/0.5W并且集成了Wi-Fi和蓝牙。低功耗意味着你可以用普通的移动电源或电池组让它连续工作好几天非常适合部署在不易布线的地方。虽然它的计算性能单核1GHz ARM11不如Pi 3或4但对于运行一个Node.js脚本、服务几个网页请求来说绰绰有余。当然如果你手头是树莓派3B或4B整个过程完全一样性能还会更强只是功耗和体积会大一些。这个组合的整体成本非常低树莓派Zero W约10-15美元DS1621传感器芯片约2-3美元加上一些杜邦线和面包板总成本可以控制在20美元以内。相比一些集成的物联网开发板或商业温湿度计它给了你完全的软件控制权和硬件扩展能力。注意市面上有些DS1621是DIP-8封装直插有些是SO-8贴片。对于面包板实验DIP封装更方便。购买时请确认是DS1621而非DS18B20单总线协议或其他型号。3. 硬件连接与树莓派系统配置详解3.1 电路连接从原理图到面包板DS1621与树莓派Zero W的连接非常简单只需要4根杜邦线母对公。树莓派Zero W的GPIO引脚排列与标准40针的树莓派一致我们需要找到I2C1所使用的两个引脚GPIO 2 (SDA1)对应物理引脚第3针。GPIO 3 (SCL1)对应物理引脚第5针。此外还需要为传感器提供电源和地3.3V电源树莓派Zero W的物理引脚第1针或第17针提供3.3V输出。DS1621的工作电压范围是2.7V到5.5V因此使用3.3V完全兼容且与树莓派的GPIO逻辑电平匹配无需电平转换。接地 (GND)树莓派上任意一个GND引脚例如物理引脚第6、9、14、20、25、30、34、39等。具体接线如下将DS1621的VDD引脚通常为第8脚连接到树莓派的3.3V引脚。将DS1621的GND引脚通常为第4脚连接到树莓派的任意GND引脚。将DS1621的SDA引脚通常为第5脚连接到树莓派的GPIO 2 (SDA1)。将DS1621的SCL引脚通常为第6脚连接到树莓派的GPIO 3 (SCL1)。DS1621的其余引脚A0, A1, A2用于设置I2C地址Tout为温度报警输出在此项目中我们暂不使用可以悬空。为了电源稳定建议在DS1621的VDD和GND引脚之间焊接或插接一个0.1µF的陶瓷电容尽可能靠近芯片引脚。实操心得连接时务必在树莓派断电状态下进行。虽然I2C总线理论上支持热插拔但带电操作杜邦线容易造成瞬间短路可能损坏GPIO或传感器。接好后最好用万用表通断档快速检查一下电源和地是否接反、SDA/SCL是否与相邻电源线短路这是避免“冒烟测试”失败的关键一步。3.2 树莓派系统准备从烧录到基础服务启用首先需要为树莓派准备操作系统。我推荐使用Raspberry Pi OS Lite (32-bit)这是一个没有图形桌面的精简版本通过命令行管理资源占用极小非常适合服务器类应用。你可以从树莓派官网下载镜像并使用 Raspberry Pi Imager 工具烧录到Micro SD卡中。在烧录前Imager工具允许你进行一些预配置点击设置图标设置主机名如temperature-pi。启用SSH勾选“Enable SSH”并建议设置密码认证或导入你的SSH公钥。配置Wi-Fi填入你的国家、SSID和密码这样树莓派启动后就能自动连接网络。设置地区选项时区、键盘布局等。这些设置会被写入SD卡启动分区省去了第一次启动后接显示器和键盘的麻烦。烧录完成后将SD卡插入树莓派Zero W上电启动。等待约一分钟后你需要找到树莓派在局域网中的IP地址。有多种方法登录你的路由器管理界面查看DHCP客户端列表。使用网络扫描工具如nmap在另一台Linux/Mac电脑上nmap -sn 192.168.1.0/24或“Fing”这类手机APP。如果树莓派连接了显示器启动后输入hostname -I命令查看。获得IP地址后就可以用SSH客户端连接了。Windows用户推荐使用 PuTTY macOS和Linux用户直接在终端使用ssh命令即可。例如ssh pi192.168.1.100默认用户名是pi密码是你之前通过Imager设置的或者是经典的raspberry如果未改。登录后第一件事是更新系统并安装必要软件sudo apt update sudo apt upgrade -y sudo apt install -y git nodejs npm检查Node.js和npm版本node -v npm -v较新版本的Raspberry Pi OS可能已经预装了Node.js但版本可能较旧。如果版本低于14.x建议通过NodeSource仓库安装更新的LTS版本。3.3 启用I2C接口并安装硬件访问库树莓派的I2C接口默认是禁用的需要手动开启。运行配置工具sudo raspi-config使用方向键选择Interface Options-I2C。当询问“Would you like the ARM I2C interface to be enabled?”时选择Yes。完成后选择Finish并选择重启。重启后SSH重新登录验证I2C是否启用ls /dev/i2c*你应该能看到类似/dev/i2c-1的设备文件。i2c-1对应的是GPIO 2/3这组I2C。为了能在非root用户下访问I2C设备将当前用户pi加入i2c组sudo usermod -aG i2c pi你需要注销并重新登录或重启才能使组权限生效。接下来安装Node.js的I2C库。我们将使用i2c-bus它提供了异步和同步的API功能强大npm install i2c-bus为了测试硬件连接是否正常我们可以先使用一个命令行工具i2c-toolssudo apt install -y i2c-tools安装后扫描I2C总线上的设备i2cdetect -y 1这条命令会扫描I2C-1总线对应GPIO 2/3上从地址0x03到0x77的所有设备。如果DS1621连接正确你应该能在输出表格中看到地址0x48或其他如果A0/A1/A2引脚被上拉/下拉改变了地址被标记为48或UU如果已被驱动占用。看到这个地址就证明物理连接和I2C总线驱动是正常的。4. Node.js与I2C通信的核心原理与代码实现4.1 I2C总线通信基础与DS1621指令集在编写代码前必须理解Node.js如何通过i2c-bus库与I2C设备对话。I2C通信的本质是主设备树莓派向从设备DS1621的特定寄存器读写数据。每个操作都以一个7位设备地址0x48开始后面跟着一个读/写位。i2c-bus库帮我们处理了底层的时序和协议我们只需要关心发送什么命令写入什么数据和读取多少字节。DS1621有几个关键的命令字Command Byte0xAA读取温度值。发送此命令后主设备可以读取两个字节的温度数据。0xEE开始温度转换。发送此命令DS1621开始一次AD转换。0x22停止温度转换。0xAC访问配置寄存器。可以读取或写入配置字节用于设置工作模式如连续转换或单次转换、设置温度阈值等。DS1621的温度数据格式是9位精度通过两个字节16位返回。具体格式如下字节1高8位包含温度的整数部分8位二进制补码形式。例如25°C对应0x19。字节2低8位只有最高位bit 7有效表示0.5°C。如果该位为1则表示温度有0.5°C的小数部分。其余位为0。因此温度计算公式为温度 字节1的值 (字节2 7) * 0.5。如果字节1的最高位bit 7为1则表示负数二进制补码需要先进行转换。在我们的示例中为了简化我们先处理正温度。4.2 编写核心的传感器读取模块首先创建一个项目目录并初始化mkdir temperature-monitor cd temperature-monitor npm init -y npm install i2c-bus然后创建第一个脚本文件read_ds1621.js实现最核心的温度读取功能const i2c require(i2c-bus); // DS1621的I2C地址 const DS1621_ADDR 0x48; // 命令字 const CMD_READ_TEMP 0xaa; const CMD_START_CONVERT 0xee; const CMD_ACCESS_CONFIG 0xac; /** * 从DS1621读取当前温度 * param {number} busNumber - I2C总线编号树莓派上通常为1 * returns {Promisenumber} 解析为摄氏度温度值的Promise */ async function readTemperature(busNumber 1) { // 异步打开I2C总线 const i2cBus await i2c.openPromisified(busNumber); try { // 1. 发送开始转换命令如果传感器未处于连续转换模式 // 对于DS1621上电后默认是单次转换模式。 // 为了确保读到最新数据我们先发送开始转换命令然后等待转换完成。 // 转换时间典型值为500ms9位精度时最大1秒。 await i2cBus.sendByte(DS1621_ADDR, CMD_START_CONVERT); // 等待转换完成。更严谨的做法是轮询配置寄存器的DONE位。 // 这里为了简单固定等待1秒。 await new Promise(resolve setTimeout(resolve, 1000)); // 2. 发送读取温度命令 await i2cBus.sendByte(DS1621_ADDR, CMD_READ_TEMP); // 3. 读取两个字节的温度数据 const buffer Buffer.alloc(2); await i2cBus.readI2cBlock(DS1621_ADDR, 0, buffer.length, buffer); // 4. 解析温度值 let tempHigh buffer[0]; // 整数部分 let tempLow buffer[1]; // 低字节仅最高位有效 // 判断是否为负数补码最高位为1 let temperature; if (tempHigh 0x80) { // 负数处理先取反加1得到绝对值的二进制再结合小数位 tempHigh (~tempHigh) 0xff; // 简单处理本例假设温度为正负数处理逻辑略复杂此处先返回0 // 实际应用中需要完整实现补码转换 temperature 0 - (tempHigh ((tempLow 7) * 0.5)); } else { // 正数处理 temperature tempHigh ((tempLow 7) * 0.5); } return temperature; } catch (error) { console.error(读取温度失败:, error); throw error; // 将错误向上抛 } finally { // 确保关闭I2C总线释放资源 await i2cBus.close(); } } // 示例立即读取一次温度 (async () { try { const temp await readTemperature(1); console.log(当前温度: ${temp.toFixed(1)} °C); } catch (err) { console.error(执行失败:, err); } })();这个模块定义了一个readTemperature异步函数它封装了与DS1621通信的全部细节启动转换、等待、发送读命令、读取原始数据、解析为摄氏度。使用async/await语法让异步操作看起来像同步代码一样清晰。注意我们使用了i2c.openPromisified它返回一个支持Promise的I2C总线对象这样可以用await来调用其方法。重要提示i2c-bus库的readI2cBlock方法在读取时实际上会先发送一个内部的“寄存器指针”字节这里我们传入了0但有些设备需要指定寄存器地址。对于DS1621在发送0xAA读温度命令后其内部指针已经指向温度数据的高字节所以直接读取两个字节即可。这是理解I2C设备数据手册的关键每个命令都可能改变了内部指针的状态。4.3 构建一个简单的HTTP服务器提供数据API仅有读取温度的函数还不够我们需要一个方式将数据暴露出去。接下来我们创建一个Web服务器它提供两个端点一个返回JSON格式的纯数据API另一个返回一个自动刷新的简单网页。创建文件server.jsconst http require(http); const url require(url); const { readTemperature } require(./read_ds1621.js); // 导入刚才写的模块 // 创建一个HTTP服务器 const server http.createServer(async (req, res) { const parsedUrl url.parse(req.url, true); const pathname parsedUrl.pathname; // 设置CORS头部允许任何来源的请求仅用于开发测试 res.setHeader(Access-Control-Allow-Origin, *); res.setHeader(Access-Control-Allow-Methods, GET); // 路由处理 if (pathname /api/temperature req.method GET) { // 端点1: 返回JSON格式的温度数据 try { const temp await readTemperature(1); res.writeHead(200, { Content-Type: application/json }); res.end(JSON.stringify({ success: true, temperature: temp, unit: celsius, timestamp: new Date().toISOString() })); } catch (error) { res.writeHead(500, { Content-Type: application/json }); res.end(JSON.stringify({ success: false, error: error.message })); } } else if (pathname / || pathname /index.html) { // 端点2: 返回一个简单的HTML页面自动刷新显示温度 res.writeHead(200, { Content-Type: text/html; charsetutf-8 }); res.end( !DOCTYPE html html langen head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 titleDS1621 Temperature Monitor/title style body { font-family: Arial, sans-serif; text-align: center; padding: 50px; background-color: #f0f0f0; } .container { background: white; padding: 30px; border-radius: 10px; display: inline-block; box-shadow: 0 0 10px rgba(0,0,0,0.1); } h1 { color: #333; } #tempValue { font-size: 4em; font-weight: bold; color: #e74c3c; margin: 20px 0; } .unit { font-size: 0.5em; color: #777; } #lastUpdate { color: #95a5a6; margin-top: 20px; } .loading { color: #3498db; } /style /head body div classcontainer h1️ DS1621 Temperature Monitor/h1 div idtempDisplay div idtempValue classloadingLoading.../div divTemperature/div /div div idlastUpdateLast updated: span idupdateTime--/span/div psmallData updates every 5 seconds/small/p /div script function updateTemperature() { fetch(/api/temperature) .then(response response.json()) .then(data { const display document.getElementById(tempValue); const timeSpan document.getElementById(updateTime); if (data.success) { display.innerHTML ${data.temperature.toFixed(1)} span classunit°C/span; display.className ; timeSpan.textContent new Date(data.timestamp).toLocaleTimeString(); } else { display.textContent Error; display.style.color #e74c3c; } }) .catch(err { console.error(Fetch error:, err); document.getElementById(tempValue).textContent Connection Error; }); } // 页面加载后立即更新一次 updateTemperature(); // 然后每5秒更新一次 setInterval(updateTemperature, 5000); /script /body /html ); } else { // 404 处理 res.writeHead(404, { Content-Type: text/plain }); res.end(Not Found); } }); // 启动服务器监听8080端口 const PORT process.env.PORT || 8080; server.listen(PORT, () { console.log(✅ Server running at http://0.0.0.0:${PORT}); console.log( Local: http://localhost:${PORT}); console.log( Network: http://YOUR_PI_IP:${PORT}); });这个服务器做了几件事创建HTTP服务器使用Node.js内置的http模块。路由处理当访问/api/temperature时调用readTemperature函数并将结果以JSON格式返回。这种设计便于其他程序如手机APP、Home Assistant通过API获取数据。当访问根路径/时返回一个内嵌了JavaScript的HTML页面。这个页面会每5秒自动调用/api/temperature接口并更新页面上的温度显示。错误处理在读取温度失败时API会返回500错误和错误信息前端页面也会显示错误状态。CORS设置为了方便开发测试我们设置了Access-Control-Allow-Origin: *允许任何网页访问API。在生产环境中你应该将其替换为具体的域名以增强安全性。现在将read_ds1621.js和server.js放在同一个目录下然后运行node server.js如果一切正常你将看到服务器启动的日志。此时在你的电脑或手机浏览器中输入树莓派的IP地址和端口例如http://192.168.1.100:8080就能看到温度监控页面了。页面初始显示“Loading...”5秒内会更新为具体的温度值并且之后每5秒自动刷新一次。5. 深入优化性能、稳定性与功能扩展5.1 性能优化与资源管理上面的基础版本虽然能工作但在长期运行和资源管理上还有优化空间。主要问题有两个一是每次HTTP请求都打开、关闭一次I2C总线二是每次读取都重新启动一次温度转换并等待1秒这会导致响应慢且效率低。优化方案1保持I2C总线长连接并缓存温度值对于长期运行的服务我们应该在服务启动时打开I2C总线并在整个生命周期内复用这个连接。同时可以设置一个后台定时器例如每2秒主动读取温度并缓存这样Web请求到来时能立即返回缓存的值响应速度极快毫秒级。创建优化版temperature_service.jsconst i2c require(i2c-bus); const http require(http); const DS1621_ADDR 0x48; const CMD_READ_TEMP 0xaa; const CMD_START_CONVERT 0xee; const CMD_ACCESS_CONFIG 0xac; const CMD_READ_CONFIG 0xac; class TemperatureService { constructor(busNumber 1, updateInterval 2000) { this.busNumber busNumber; this.updateInterval updateInterval; this.i2cBus null; this.currentTemperature null; this.lastUpdateTime null; this.isUpdating false; this.updateTimer null; } async init() { try { // 打开I2C总线并保持打开状态 this.i2cBus await i2c.openPromisified(this.busNumber); console.log(I2C bus ${this.busNumber} opened successfully.); // 可选配置DS1621为连续转换模式这样它就会自动持续测量 // 写入配置寄存器连续转换模式 (bit 0 0), 保持默认其他位 await this.i2cBus.writeByte(DS1621_ADDR, CMD_ACCESS_CONFIG, 0x00); // 发送开始转换命令在连续模式下只需发一次 await this.i2cBus.sendByte(DS1621_ADDR, CMD_START_CONVERT); console.log(DS1621 configured for continuous conversion.); // 立即进行一次初始读取 await this.updateTemperature(); // 启动定时更新 this.startPeriodicUpdate(); return true; } catch (error) { console.error(Failed to initialize TemperatureService:, error); await this.cleanup(); throw error; } } async updateTemperature() { if (this.isUpdating || !this.i2cBus) return; this.isUpdating true; try { // 发送读取温度命令 await this.i2cBus.sendByte(DS1621_ADDR, CMD_READ_TEMP); // 读取两个字节 const buffer Buffer.alloc(2); await this.i2cBus.readI2cBlock(DS1621_ADDR, 0, buffer.length, buffer); let tempHigh buffer[0]; let tempLow buffer[1]; let temperature; // 简化的正温度解析负数处理略 if (tempHigh 0x80) { // 简单处理负数本例假设环境温度为正若为负则按补码计算 // 实际应完整实现补码转换此处返回一个错误值或特殊值 temperature null; // 表示读取异常 } else { temperature tempHigh ((tempLow 7) * 0.5); } if (temperature ! null) { this.currentTemperature temperature; this.lastUpdateTime new Date(); } } catch (error) { console.error(Error updating temperature:, error); } finally { this.isUpdating false; } } startPeriodicUpdate() { if (this.updateTimer) clearInterval(this.updateTimer); this.updateTimer setInterval(() { this.updateTemperature(); }, this.updateInterval); console.log(Periodic temperature update started (every ${this.updateInterval}ms).); } getTemperature() { return { temperature: this.currentTemperature, lastUpdate: this.lastUpdateTime, success: this.currentTemperature ! null }; } async cleanup() { if (this.updateTimer) { clearInterval(this.updateTimer); this.updateTimer null; } if (this.i2cBus) { await this.i2cBus.close(); console.log(I2C bus closed.); } } } // 使用示例创建服务并启动HTTP服务器 (async () { const tempService new TemperatureService(1, 2000); // 每2秒更新一次 try { await tempService.init(); const server http.createServer((req, res) { if (req.url /api/temperature req.method GET) { const data tempService.getTemperature(); res.writeHead(200, { Content-Type: application/json }); res.end(JSON.stringify({ ...data, timestamp: new Date().toISOString() })); } else { res.writeHead(200, { Content-Type: text/plain }); res.end(Temperature Monitor Service. Use GET /api/temperature); } }); const PORT 8080; server.listen(PORT, () { console.log( Optimized server listening on port ${PORT}); }); // 优雅关闭捕获退出信号清理资源 process.on(SIGINT, async () { console.log(\nShutting down gracefully...); await tempService.cleanup(); server.close(() { console.log(Server closed.); process.exit(0); }); }); } catch (error) { console.error(Service startup failed:, error); process.exit(1); } })();这个优化版做了重大改进单例与长连接TemperatureService类在初始化时打开I2C总线并保持打开避免了频繁开关的开销。后台轮询与缓存设置一个setInterval定时器每2秒主动读取一次温度并更新内部缓存currentTemperature。Web API请求直接返回缓存值响应速度极快。连续转换模式通过写入配置寄存器(0xAC)将DS1621设置为连续转换模式。在这种模式下传感器会自动持续进行AD转换我们读取时总能拿到相对较新的数据无需每次发送开始转换命令并等待1秒将读取延迟从秒级降到毫秒级。优雅关闭监听SIGINT信号如CtrlC在程序退出前主动关闭I2C总线和HTTP服务器确保资源被正确释放。5.2 异常处理与日志记录一个健壮的服务必须能处理各种异常情况并留下清晰的日志供排查。我们可以在上面的服务中添加更完善的错误处理和日志。首先安装一个简单的日志库如winston或pino这里为了轻量我们使用内置的console并稍加封装同时将错误写入文件// 在temperature_service.js开头添加 const fs require(fs).promises; const path require(path); class Logger { constructor(logDir ./logs) { this.logDir logDir; this.init(); } async init() { try { await fs.mkdir(this.logDir, { recursive: true }); } catch (err) { console.error(Could not create log directory:, err); } } async log(level, message, meta {}) { const timestamp new Date().toISOString(); const logEntry ${timestamp} [${level.toUpperCase()}] ${message} ${Object.keys(meta).length ? JSON.stringify(meta) : }\n; // 输出到控制台 console.log(logEntry.trim()); // 写入到文件按日期 const dateStr new Date().toISOString().split(T)[0]; const logFile path.join(this.logDir, temp_service_${dateStr}.log); try { await fs.appendFile(logFile, logEntry); } catch (err) { console.error(Failed to write log file:, err); } } info(message, meta) { return this.log(info, message, meta); } error(message, meta) { return this.log(error, message, meta); } warn(message, meta) { return this.log(warn, message, meta); } } // 在TemperatureService构造函数中初始化logger // this.logger new Logger();然后在TemperatureService的各个方法中用this.logger.info()、this.logger.error()替换console.log和console.error。这样所有的运行状态、温度读数、错误信息都会同时输出到控制台和按日期分割的日志文件中便于后期排查问题。对于I2C通信中可能出现的异常如总线错误、设备无响应等除了在catch块中记录日志外还可以实现重试机制。例如在updateTemperature方法中如果连续多次读取失败可以尝试重新初始化I2C总线或重启转换命令。5.3 功能扩展思路基础的温度读取和Web展示完成后这个项目可以轻松扩展出更多实用功能1. 添加历史数据记录与图表展示使用轻量级数据库如SQLite通过sqlite3npm包或甚至直接写入JSON文件定期如每分钟将温度值连同时间戳存储起来。然后可以新增一个API端点如/api/temperature/history?hours24来查询历史数据。前端可以使用Chart.js等库绘制温度变化曲线图。2. 实现温度报警与通知在TemperatureService类中添加阈值检查逻辑。例如设置一个高温报警阈值如30°C和低温报警阈值如10°C。每次更新温度后进行检查如果超过阈值且距离上次报警已过一段时间防骚扰则触发报警动作。报警动作可以是在服务器日志中记录错误。向一个Webhook URL发送POST请求可用于触发IFTTT、钉钉、Slack等通知。发送电子邮件使用nodemailer库。控制一个连接到树莓派的蜂鸣器或LED灯。3. 支持多传感器与传感器抽象如果你有多个DS1621通过设置不同的A0/A1/A2地址或者想接入其他I2C传感器如BMP280气压计、OLED显示屏可以设计一个通用的Sensor基类或接口然后为每种传感器实现具体的read()方法。TemperatureService管理一个传感器列表定期读取所有传感器数据。Web API可以返回所有传感器的数据集合。4. 提供配置界面与远程控制目前参数如更新间隔、报警阈值是硬编码在代码中的。可以创建一个简单的配置页面另一个HTML文件通过表单让用户修改这些参数并保存到JSON配置文件中。服务器监听配置文件变化并动态应用新配置。这需要添加对应的POST API端点来处理配置更新。5. 容器化部署使用Docker将整个应用打包成一个镜像。这能确保运行环境的一致性简化部署。创建一个Dockerfile基于node:16-slim镜像复制代码安装依赖并设置启动命令。你甚至可以使用Docker Compose来编排多个服务如本应用加上一个Grafana用于可视化。6. 部署、维护与常见问题排查6.1 生产环境部署建议在开发测试完成后你可能希望这个服务能开机自启、稳定运行。有几种方法方法一使用systemd推荐这是Linux系统标准的服务管理方式。创建一个服务文件sudo nano /etc/systemd/system/temperature-monitor.service内容如下[Unit] DescriptionTemperature Monitor Service Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/temperature-monitor ExecStart/usr/bin/node /home/pi/temperature-monitor/temperature_service.js Restarton-failure RestartSec10 StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target然后启用并启动服务sudo systemctl daemon-reload sudo systemctl enable temperature-monitor.service sudo systemctl start temperature-monitor.service # 查看状态和日志 sudo systemctl status temperature-monitor.service journalctl -u temperature-monitor.service -f使用systemd的好处是管理方便start/stop/restart/status并且能自动重启崩溃的服务。方法二使用进程管理工具PM2PM2是Node.js生态中非常流行的进程管理器内置负载均衡、日志管理、监控等功能。# 全局安装PM2 sudo npm install -g pm2 # 启动你的服务 pm2 start temperature_service.js --name temp-monitor # 设置开机自启 pm2 startup # 按照PM2输出的命令执行通常是复制粘贴一行sudo命令 pm2 savePM2提供了丰富的命令pm2 list查看进程pm2 logs temp-monitor查看日志pm2 monit图形化监控。6.2 常见问题与排查技巧即使按照步骤操作也可能会遇到问题。下面是一个快速排查指南问题现象可能原因排查步骤运行node server.js时报错Error: EACCES: permission denied, open /dev/i2c-1当前用户没有访问I2C设备的权限。1. 确认用户已加入i2c组groups $USER查看输出是否包含i2c。2. 如果不在组内sudo usermod -aG i2c $USER然后注销并重新登录。3. 检查设备文件权限ls -l /dev/i2c-1应显示crw-rw----组为i2c。i2cdetect -y 1扫描不到设备地址0x48未出现硬件连接问题、电源问题、传感器损坏或地址不对。1.断电检查所有杜邦线连接是否牢固SDA/SCL是否接反。2. 用万用表测量DS1621的VCC和GND之间电压是否为3.3V左右。3. 检查DS1621的A0, A1, A2引脚是否全部接地默认地址0x48。如果接了VCC地址会改变。4. 尝试扫描所有地址i2cdetect -y 1 0x00 0x7f。5. 换一个I2C设备如OLED屏测试确认树莓派I2C功能正常。Web页面能打开但一直显示“Loading...”或“Error”Node.js服务读取传感器失败或网络端口不通。1. 在树莓派上直接运行读取测试脚本node read_ds1621.js看是否能输出温度。2. 检查服务器是否在运行ps aux温度读数不准、跳动大或为0电源噪声、传感器未校准、软件解析错误。1.确保电源稳定在DS1621的VCC和GND引脚之间并联一个0.1µF陶瓷电容并尽可能靠近芯片引脚焊接。2. 检查软件解析代码是否正确特别是正负数和0.5位的处理。3. 用i2c-tools的i2cget命令手动读取原始值验证sudo i2cget -y 1 0x48 0xAA w会返回两个字节的十六进制数如0x1900表示25.0°C。4. 将传感器与已知准确的温度计放在一起对比。服务运行一段时间后崩溃或无响应内存泄漏、未处理的异常、I2C总线锁死。1. 查看日志文件如果配置了或系统日志journalctl -u temperature-monitor.service --since 1 hour ago。2. 使用htop或free -h命令监控内存使用情况。3. 在代码中确保所有Promise都有.catch()处理防止未捕获的异常导致进程退出。4. 考虑在TemperatureService的updateTemperature方法中添加“看门狗”机制如果连续多次失败尝试重新初始化I2C总线。无法通过Wi-Fi访问网页树莓派和客户端不在同一网络或防火墙限制。1. 确认树莓派已连接Wi-Fiifconfig wlan0查看IP地址。2. 确认客户端设备手机/电脑和树莓派连接的是同一个局域网同一路由器下。3. 在树莓派上ping客户端IP在客户端ping树莓派IP检查双向连通性。4. 检查树莓派防火墙规则。6.3 性能监控与维护脚本为了让服务更稳健可以编写一些简单的维护脚本健康检查脚本health_check.sh:#!/bin/bash # 检查服务是否在运行 if ! pgrep -f temperature_service.js /dev/null; then echo 温度监控服务未运行正在重启... cd /home/pi/temperature-monitor /usr/bin/node temperature_service.js /var/log/temp_monitor.log 21 fi # 检查API是否响应 API_RESPONSE$(curl -s -o /dev/null -w %{http_code} http://localhost:8080/api/temperature || echo 000) if [ $API_RESPONSE ! 200 ]; then echo API无响应 (HTTP $API_RESPONSE)重启服务... pkill -f temperature_service.js sleep 2 cd /home/pi/temperature-monitor /usr/bin/node temperature_service.js /var/log/temp_monitor.log 21 fi然后通过cron定时任务每5分钟执行一次这个脚本crontab -e # 添加一行 */5 * * * * /home/pi/temperature-monitor/health_check.sh日志轮转配置防止日志文件无限增大。可以编辑/etc/logrotate.d/temperature-monitor/home/pi/temperature-monitor/logs/*.log { daily missingok rotate 7 compress delaycompress notifempty create 644 pi pi }这样日志会每天轮转一次保留最近7天的压缩副本。经过以上步骤你就拥有了一个从硬件连接到软件部署、从基础功能到优化扩展、从开发调试到生产维护的完整项目。它不仅仅是一个简单的温度读取脚本而是一个具备一定鲁棒性、可维护性和扩展性的物联网服务原型。你可以基于这个框架轻松替换其他I2C传感器或者添加更复杂的业务逻辑构建出属于自己的智能硬件应用。
相关文章
6款论文AI智能降重工具亲测：键清零AI痕迹，这款性价比封神
2026年毕业季临近，知网、维普两大国内核心学术平台已完成AIGC检测算法的全面迭代升级：知网将AI检测模型更新至3.0版本，实现句子级精准识别，对AI生成内容的识别能力提升15-18个百分点；维普则重构检测逻辑，新…
Win10/11 突发 PIN 不可用卡死登录页？msconfig 误设置终极修复教程
很多朋友为了优化电脑开机、禁用多余后台服务，都会手动打开 msconfig 调整系统启动配置。但稍有不慎取消加载系统服务选项，重启后就会直接翻车：登录界面弹出「出现问题，你的 PIN 不可用」提示，点击重置 PIN 毫无反应&a…
终极指南：免费解锁Cursor Pro完整功能的完整解决方案
终极指南：免费解锁Cursor Pro完整功能的完整解决方案 【免费下载链接】cursor-free-vip [Support 0.45]（Multi Language 多语言）自动注册 Cursor Ai ，自动重置机器ID ， 免费升级使用Pro 功能: Youve reached your tria…
企业网盘怎么选？2026 年 10 款团队协作工具对比
很多企业在选企业网盘时，表面看的是“空间够不够、费用合不合理”，真正落地卡住的往往是：大文件传输稳不稳、权限能不能细到部门与角色、外部协作是否可控、版本记录能不能追溯、以及能否顺畅接入现有项目与办公流程。 选型目标也很明确&…
M1 Mac 装 Ollama，我被 Docker 骗了三次
你是不是也有过这种时刻—— 软件下好了，双击打开，终端一运行，直接劈头盖脸甩你一行红字： Symbol not found: _cblas_sgemm$NEWLAPACK$ILP64△ 就是这行字，让我后面多折腾了四个小时 你愣了三秒，不知道自己…
Sora 2 HDR视频生成上线倒计时：OpenAI已向Netflix/Apple提交HDR10+认证包，你的内容管线还卡在Gamma 2.2校准阶段吗？
更多请点击： https://codechina.net 第一章：Sora 2 HDR视频生成上线倒计时全景洞察 OpenAI 正式确认 Sora 2 已进入最终灰度发布阶段，HDR 视频生成功能预计将于 2024 年第四季度面向首批企业合作伙伴开放 API 接入。与初代 Sora 相比&#x…
Claude辅助数据库设计的7大黄金法则：从ER图生成到SQL优化，一线团队已验证有效
更多请点击： https://intelliparadigm.com 第一章：Claude辅助数据库设计的7大黄金法则：从ER图生成到SQL优化，一线团队已验证有效 在真实项目中，Claude并非仅作“SQL翻译器”使用，而是深度参与数据库设计全…
DeepSeek重构模式推荐不是建议，是SLA级保障：实测降低重构回滚率83.6%（附A/B测试原始数据）
更多请点击： https://intelliparadigm.com 第一章：DeepSeek重构模式推荐不是建议，是SLA级保障：实测降低重构回滚率83.6%（附A/B测试原始数据） DeepSeek重构模式推荐引擎已深度集成至CI/CD流水线，…
如何将小爱音箱变身AI智能助手：MiGPT完整指南与3种实用配置方案
如何将小爱音箱变身AI智能助手：MiGPT完整指南与3种实用配置方案 【免费下载链接】mi-gpt 🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。 项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt 你是否曾幻想过&…
Go语言SQLite轻量级数据库应用
Go语言SQLite轻量级数据库应用 引言 SQLite是一款轻量级的嵌入式数据库，无需独立服务进程，非常适合单机应用、移动端应用和开发测试环境。Go语言通过database/sql包配合go-sqlite3驱动可以方便地操作SQLite数据库。本文将深入探讨Go语言中SQLite的使用技…
【前端无障碍】屏幕阅读器兼容性：确保视障用户的良好体验
【前端无障碍】屏幕阅读器兼容性：确保视障用户的良好体验 前言 大家好，我是cannonmonster01！今天咱们来聊聊屏幕阅读器兼容性这个话题。想象一下，一个视障用户打开你的网站，通过屏幕阅读器来浏览内容。如果你的网站没有…
2026年横评10款降AI率软件:只选真正管用的那一款！
随着AI写作工具的广泛应用，论文写作和内容创作效率得到了显著提升，许多学生和职场人士都开始依赖这些工具来完成繁重的文字任务。然而，随着各大高校、期刊平台对AIGC内容检测技术的不断升级，AI生成内容的痕迹越来越容易被识别。不…
施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录
更多请点击： https://codechina.net 第一章：施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录 在华北某大型地铁盾构施工现场，一套轻量化AI Agent系统于2024年Q2完成全栈部署ÿ…
附录 B：术语表
本术语表面向“从 MM 到 HMM”专栏阅读过程中的快速查阅。它不是内核 API 手册，而是把文章中反复出现的概念放到同一张地图上：先给出直观含义，再说明它在 Linux MM/HMM 语境里的作用。建议阅读方式： 初读专栏时，把它当…
Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表·行业首曝）
更多请点击： https://kaifayun.com 第一章：Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表行业首曝） Midjourney 的渐变美学并非传统插值实现，而是由其隐式神经渲染器（Implicit Neu…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…