物联网实践:Node.js 与树莓派玩转 K 型热电偶与 MAX6675

一提到树莓派(Raspberry Pi)与创客硬件传感,很多人的第一反应几乎都是 Python(如 RPi.GPIO)。网络上充斥着“玩树莓派就必须用 Python”的固有偏见。

但这引发了一个灵魂拷问:

难道 JavaScript 就不能在树莓派上直接操控 GPIO 引脚吗?在构建需要高并发采集、异步 I/O 流转以及 Web/WebSocket 实时数据看板的现代物联网(IoT)边缘网关时,Node.js 难道不是更加轻巧全栈的天选利器吗?

之前一位做工业测量的朋友需要一套基于树莓派的高温检测装置,委托我驱动 K 型热电偶传感器。

本文将从热电效应与模数转换(ADC)底层物理原理切入,剖析 MAX6675 模数转换芯片的时序规范,并使用现代 Node.js 从零编写一套轻量鲁棒的硬件驱动库,最后打通 Web 实时温控看板。


一、物理与硬件基础:为什么不能直连树莓派?

1. 塞贝克效应与 K 型热电偶

**热电偶(Thermocouple)**是工业界测量极高温度($0^\circ\text{C} \sim 1024^\circ\text{C}+$)的标准工业元件。其物理基础建立在 塞贝克效应(Seebeck Effect) 之上:

当两种不同材质的金属导体(如 K 型热电偶中的镍铬与镍硅合金)两端连接在一起,且两个接点存在温度差时,回路中就会自发产生一个极微弱的电势差(热电动势,通常只有数十微伏 $\mu\text{V} / ^\circ\text{C}$)。

$$ \Delta V = S \cdot \Delta T $$

2. 为什么树莓派需要 MAX6675 转换芯片?

树莓派的 40-Pin GPIO 引脚是纯数字接口,只能识别 0V (LOW) 和 3.3V (HIGH) 两种离散逻辑电平。直接将热电偶的两根金属线接入树莓派存在三大根本阻碍:

  1. 无板载 ADC:树莓派无法测量连续变化的模拟电压信号;
  2. 信号极度微弱:热电偶产生的微伏级电压淹没在环境噪声中,必须经过超高增益精密放大器;
  3. 冷端补偿缺失:热电偶测出的是“测量端”与“连接端(冷端)”的相对温差,必须实时测量环境温度进行**冷端温度补偿(Cold-Junction Compensation)**才能反算出真实绝对温度。

MAX6675 芯片就是为了完美解决上述问题而生的集成方案:它内部集成了高精度热敏冷端二极管、差分放大器、12 位逐次逼近型模数转换器(ADC)以及只读 SPI 串行接口。


二、MAX6675 时序与通信协议逆向剖析

MAX6675 采用标准的串行外设接口(SPI)只读协议,与树莓派之间仅需 3 根控制线:

  • CS(Chip Select,片选):低电平有效,拉低时开始一次转换并允许输出数据;
  • SCK(Serial Clock,时钟):微控制器产生时钟脉冲,每个下降沿移出一位数据;
  • SO(Serial Output / MISO,数据输出):输出 16 位只读数据流。

1. 16 位只读数据帧结构定义

MAX6675 在一次完整的 SPI 读取周期中,按大端序(MSB First)依序吐出 16 位二进制数据:

1
2
3
4
5
┌────┬──────────────────────────────────────┬──────┬────┬────┐
│D15 │ D14 D13 D12 D11 ... D6 D5 D4 D3│ D2 │ D1 │ D0 │
├────┼──────────────────────────────────────┼──────┼────┼────┤
│ 0 │ 12-Bit 温度数字量 (0 ~ 4095) │OpenTC│ ID │ Tri│
└────┴──────────────────────────────────────┴──────┴────┴────┘
  • Bit 15(虚拟位 Dummy):固定为 0;
  • Bit 14 ~ Bit 3(核心温度有效位):12 位无符号整数,记录当前的温度读数;
  • Bit 2(热电偶开路检测 Open-Circuit Detect):极度关键的故障检测位!
    • 正常接入热电偶时,该位为 0;
    • 若热电偶探头松动、断线或损坏,该位自动置为 1;
  • Bit 1(设备 ID):固定为 0;
  • Bit 0(三态位):保留高阻态。

2. 温度换算公式

MAX6675 的测量分辨率为 $0.25^\circ\text{C}$,测量温度范围为 $0^\circ\text{C} \sim +1023.75^\circ\text{C}$。

提取出 Bit 14 ~ Bit 3 的 12 位整数后,直接乘以 $0.25$ 即可获得精确的摄氏度读数:

$$ \text{Temp}(^\circ\text{C}) = \text{Data}[14:3] \times 0.25 $$


三、硬件接线图解(Pinout Mapping)

准备树莓派(3B / 4B / Zero 均可)与 MAX6675 模块,使用杜邦线按下表连接:

1
2
3
4
5
6
7
8
9
┌─────────────────────────┐               ┌─────────────────────────┐
│ 树莓派 40-Pin GPIO │ │ MAX6675 驱动模块 │
├─────────────────────────┼───────────────┼─────────────────────────┤
│ Pin 1 (3.3V Power) │ ────────────> │ VCC (供电 3.3V ~ 5V) │
│ Pin 6 (Ground) │ ────────────> │ GND (接地) │
│ Pin 24 (BCM 8 / CE0) │ ────────────> │ CS (片选 Chip Select) │
│ Pin 23 (BCM 11 / SCLK) │ ────────────> │ SCK (时钟 Clock) │
│ Pin 21 (BCM 9 / MISO) │ <──────────── │ SO (数据 Serial Out) │
└─────────────────────────┘ └─────────────────────────┘

⚠️ 电压安全警示:树莓派的 GPIO 耐压为 3.3V。请确保将 MAX6675 的 VCC 接到树莓派的 3.3V 引脚(Pin 1),严禁接在 5V 上,以免反向击穿树莓派 SoC 的 GPIO 口!


四、Node.js 硬件驱动实现

在 Linux / 树莓派操作系统中,底层通过 /sys/class/gpio 接口与内核通信。在 Node.js 生态中,推荐使用广受检验的高性能底层库 onoff。

安装依赖:

1
npm install onoff

1. 软件模拟 SPI(Bit-Banging)高健壮驱动 Max6675.js

由于 MAX6675 只需要读取 16 位数据,无需任何配置写入,使用“软件模拟 SPI(Bit-Banging)”不仅不占用树莓派硬件 SPI 外设资源,而且可以在任意 GPIO 引脚上任意拓展多路探头!

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
const { Gpio } = require('onoff');

/**
* MAX6675 K-Type 热电偶 Node.js 驱动类
*/
class Max6675 {
/**
* 构造函数
* @param {number} csPin BCM 编号:片选引脚
* @param {number} sckPin BCM 编号:时钟引脚
* @param {number} soPin BCM 编号:数据引脚
*/
constructor(csPin, sckPin, soPin) {
this.cs = new Gpio(csPin, 'out');
this.sck = new Gpio(sckPin, 'out');
this.so = new Gpio(soPin, 'in');

// 默认空闲电平:CS 置高,SCK 置低
this.cs.writeSync(1);
this.sck.writeSync(0);

// 监听进程退出信号,确保优雅释放 GPIO 资源
this._bindProcessCleanup();
}

/**
* 异步读取摄氏度温度
* @returns {Promise<number>} 当前摄氏度
*/
async readCelsius() {
// 1. CS 拉低,唤醒 MAX6675 开始 SPI 传输
this.cs.writeSync(0);
this._microDelay();

let rawWord = 0;

// 2. 软件时钟步进,移出 16 位数据 (MSB 先出)
for (let i = 15; i >= 0; i--) {
this.sck.writeSync(1); // 上升沿准备
this._microDelay();

// 在 SCK 高电平期间读取 SO 数据位
const bit = this.so.readSync();
if (bit === 1) {
rawWord |= (1 << i);
}

this.sck.writeSync(0); // 下降沿触发下一位
this._microDelay();
}

// 3. 读取完毕,重新拉高 CS,启动芯片内部下一次 ADC 转换
this.cs.writeSync(1);

// 4. 故障检测:检查 Bit 2 (Open-Circuit Detect)
if ((rawWord & 0x04) !== 0) {
throw new Error('[MAX6675] 探头故障:检测到 K 型热电偶断线或未接入!');
}

// 5. 提取 Bit 14 ~ Bit 3,右移 3 位后乘以 0.25
const rawTemp = (rawWord >> 3) & 0x0FFF;
return rawTemp * 0.25;
}

/**
* 微秒级延时占位
*/
_microDelay() {
for (let i = 0; i < 50; i++) {
// 产生微小循环延时,满足 MAX6675 纳秒级建立时间要求
}
}

/**
* 释放 GPIO 占用(防内存与文件句柄泄漏)
*/
destroy() {
try {
this.cs.unexport();
this.sck.unexport();
this.so.unexport();
console.log('[MAX6675] GPIO 资源已安全卸载释放。');
} catch (err) {
// 忽略重复释放错误
}
}

_bindProcessCleanup() {
const cleanup = () => {
this.destroy();
process.exit(0);
};
process.once('SIGINT', cleanup);
process.once('SIGTERM', cleanup);
}
}

module.exports = Max6675;

五、实测与多路轮询采集脚本

编写一个实时监控脚本 monitor.js:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
const Max6675 = require('./Max6675');

// BCM 引脚定义 (对照你的实际杜邦线)
const CS_PIN = 8;
const SCK_PIN = 11;
const SO_PIN = 9;

const sensor = new Max6675(CS_PIN, SCK_PIN, SO_PIN);

console.log('🚀 MAX6675 工业热电偶采集服务已启动...');
console.log('按 Ctrl+C 安全退出并释放引脚资源。\n');

async function loop() {
try {
const tempC = await sensor.readCelsius();
const tempF = (tempC * 9 / 5 + 32).toFixed(2);
const timestamp = new Date().toLocaleTimeString();

console.log(`[${timestamp}] 🌡️ 实时温度: ${tempC.toFixed(2)} °C | ${tempF} °F`);
} catch (err) {
console.error(`⚠️ [采集告警] ${err.message}`);
}

// MAX6675 单次 ADC 转换时间最长约为 220ms,采集间隔建议不低于 250ms
setTimeout(loop, 500);
}

loop();

在树莓派终端运行:

1
node monitor.js

输出效果:

1
2
3
4
5
6
7
🚀 MAX6675 工业热电偶采集服务已启动...
按 Ctrl+C 安全退出并释放引脚资源。

[14:20:01] 🌡️ 实时温度: 24.50 °C | 76.10 °F
[14:20:02] 🌡️ 实时温度: 24.75 °C | 76.55 °F
[14:20:03] 🌡️ 实时温度: 85.25 °C | 185.45 °F (打火机加热探头)
[14:20:04] 🌡️ 实时温度: 142.00 °C | 287.60 °F

六、进阶:打通 Web 实时温控看板

得益于 Node.js 在全栈上的天然亲和力,我们可以用不到 40 行原生代码,利用 SSE(Server-Sent Events) 搭建一个超低延迟的 Web 实时动态图表接口:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
const http = require('http');
const Max6675 = require('./Max6675');

const sensor = new Max6675(8, 11, 9);

const server = http.createServer((req, res) => {
// 提供 SSE 实时流
if (req.url === '/events') {
res.writeHead(200, {
'Content-Type': 'text/event-stream',
'Cache-Control': 'no-cache',
'Connection': 'keep-alive',
'Access-Control-Allow-Origin': '*'
});

const timer = setInterval(async () => {
try {
const temp = await sensor.readCelsius();
res.write(`data: ${JSON.stringify({ temp, time: Date.now() })}\n\n`);
} catch (err) {
res.write(`data: ${JSON.stringify({ error: err.message })}\n\n`);
}
}, 500);

req.on('close', () => clearInterval(timer));
return;
}

// 极简前端展示页
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
res.end(`
<!DOCTYPE html>
<html>
<head><title>树莓派 K 型热电偶实时监控</title></head>
<body style="font-family: sans-serif; text-align: center; padding-top: 50px;">
<h1>树莓派工业温控终端 (Node.js)</h1>
<div id="temp" style="font-size: 72px; font-weight: bold; color: #ff5722;">-- °C</div>
<script>
const es = new EventSource('/events');
es.onmessage = (e) => {
const data = JSON.parse(e.data);
if (data.temp !== undefined) {
document.getElementById('temp').innerText = data.temp.toFixed(2) + ' °C';
}
};
</script>
</body>
</html>
`);
});

server.listen(3000, () => {
console.log('📡 Web 实时温控大屏已就绪: http://localhost:3000');
});

打开浏览器,即刻享受 Node.js 驱动的毫秒级硬件传感实时数据推流!


七、工程总结与排坑要点

  1. ADC 转换周期限制:MAX6675 内部完成一次热电动势向数字量的转换需要大约 0.17 ~ 0.22 秒。读取间隔严禁小于 250ms,否则读取到的只是上一次转换的陈旧数据;
  2. 接地与电磁屏蔽:K 型热电偶导线很长时极易拾取交流电工频干扰(50Hz / 60Hz),在工业现场应使用带金属屏蔽编织网的热电偶导线,并确保接地良好;
  3. GPIO Unexport 资源安全:通过绑定 SIGINT 和 SIGTERM 退出监听,必须主动调用 unexport() 关闭引脚。否则下次重启脚本时,Linux 内核会报 Device or resource busy 拒绝访问。

物联网实践:Node.js 与树莓派玩转 K 型热电偶与 MAX6675
https://bubao.github.io/posts/1d941e94.html
作者
一念
发布于
2019年3月2日
许可协议