1. 从一块坐垫说起:为什么我用 Arduino IDE 而不是裸机寄存器
久坐提醒坐垫这个需求,听起来像个小玩具:一块压力传感垫、一颗 ESP32、一个震动马达,坐上三十分钟就震一下。真动手时,最先卡住的往往不是算法,而是 Arduino IDE 这套代码开发工具的配置——开发板支持包、HX711 库、串口端口号,任何一处不对,编译能过但板子没反应。我把它当成一条最小可复现的固件链路来写:压力采样、落座判断、计时、震动,每个环节都能在串口监视器里看到数。适合刚拿到 ESP32 和 HX711、想把第一版跑起来的人,也适合已经写完代码、却被误报和漂移折腾过的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 把代码开发工具链配到位:Arduino IDE 的开发板支持包与 HX711 库
2.1 先装 IDE,再装开发板支持包
顺序这件事,吃过亏的人才知道有多重要。正确的顺序是:先装 Arduino IDE 本体,再在 IDE 里通过开发板管理器添加 ESP32 支持包,最后装 HX711 库。把支持包当成一个独立安装包、先往电脑上拷,再装 IDE,常见结果是开发板管理器里搜不到对应条目,或者装到一半卡在下载索引上。原因不复杂:开发板支持包是挂在 IDE 的包管理机制下的,它依赖 IDE 的目录结构和索引缓存,脱离 IDE 单独放置,IDE 不会认。
我一般的做法是,IDE 装完后先打开一次,让它把默认的包索引拉完,再进开发板管理器搜索 esp32。如果搜索转圈很久没有结果,先检查首选项里的附加开发板管理器网址有没有填对——这个地址是板包作者维护的索引,填错一个字符都会让列表空掉。网络受限的环境下,不要反复点安装,先把索引地址确认一遍,再考虑用离线包导入,比盲目重装省时间。
装完之后,在「工具 → 开发板」里能看到 ESP32 系列,才算这一步真正完成。只在开发板管理器里看到「已安装」还不够,菜单里不出现板型,上传时照样会报找不到目标。
2.2 HX711 库用库管理器装,别手动拷 zip
HX711 的库文件,常见做法是在 Arduino IDE 的库管理器里搜索 HX711,选一个维护正常的版本安装。不建议从别处下载 zip 直接解压到 libraries 目录,原因有两个:一是目录层级容易多套一层,IDE 扫描不到;二是同一个库的多个版本共存时,编译器可能挑到旧的那份,报错信息却指向你的代码,查半天查不出所以然。
库管理器安装的好处是路径统一、版本可查。装完后不要急着写业务代码,先打开库自带的示例,确认它能编译通过。示例编译不过,说明库和开发板支持包之间至少有一个没装对,这时候改自己的代码没有意义。
这里有个细节值得注意:HX711 库的示例通常直接打印原始读数,不涉及单位换算。如果你的目标是「压力超过某个值就判定落座」,用原始读数配阈值完全够用;如果想让串口输出克数,才需要走校准系数那条路。两种路线的参数含义不一样,后面校准章节会展开。
2.3 一个最小验证 sketch:确认板子、串口、库三件事都通了
在写完整固件之前,我会先跑一个只做读取的最小 sketch。它不判断落座、不驱动马达,只验证三件事:板子选对了、串口能出数、HX711 库能正常调用。
cpp复制#include <HX711.h>
#define HX711_DOUT 26
#define HX711_SCK 27
HX711 scale;
void setup() {
Serial.begin(115200);
scale.begin(HX711_DOUT, HX711_SCK);
scale.set_scale(); // 先用默认系数,只验证通路
scale.tare(); // 上电去皮,把当前状态当作零点
}
void loop() {
Serial.println(scale.read()); // 打印原始 ADC 读数
delay(500);
}
这段代码的逻辑很直白:scale.begin() 把 DOUT 和 SCK 两个引脚注册给库,tare() 把当前读数记成零点,loop() 里每 500 毫秒打印一次原始值。参数上,HX711_DOUT 和 HX711_SCK 必须和实际接线一致,接反了读出来要么是 0,要么是固定的极值。delay(500) 是给串口监视器留出可读的节奏,不代表最终产品的采样率。
上传时三个地方最容易翻车:开发板菜单里选错板型,上传会报目标芯片不匹配;端口菜单是灰的,通常是数据线只供电不传数据,或者驱动没装;串口监视器里全是乱码,检查波特率是不是 115200。这三件事排掉,后面写业务代码才有意义。
提示:最小验证 sketch 跑通之前,不要往工程里加马达、加计时逻辑。先把「能读到数」这件事单独确认,排错范围会小很多。
3. 固件骨架:setup 只做三件事,loop 用状态标志管住计时
3.1 引脚和阈值先宏定义,改参数不用翻代码
完整固件的第一段不是代码逻辑,而是一组宏定义。引脚号、压力阈值、久坐时间阈值都放在文件顶部,好处是调参时只改一处,不用在几百行里找魔数。材料里的定义是 DOUT 接 26、SCK 接 27、震动马达接 13,压力阈值 5000,久坐阈值 1800000 毫秒,也就是 30 分钟。
这里有个容易忽略的点:PRESSURE_THRESHOLD 比较的是 scale.read() 的原始值,不是重量。原始值的大小和传感器量程、供电电压、机械安装都有关系,所以 5000 只是一个起点,不是通用值。把它写成宏,就是为了换一块坐垫时能快速改,而不是把它当成物理常量。
SIT_TIME_THRESHOLD 用毫秒表示,1800000 这个数字读起来不直观,写成 30 * 60 * 1000 更好维护。编译期常量做乘法不会有运行开销,可读性却高很多。
3.2 setup 里的初始化顺序:串口、GPIO、HX711
setup() 里我固定按串口、GPIO、HX711 的顺序初始化。串口最先开,是为了后面的初始化日志都能打出来;震动马达引脚先设为输出并拉低,是为了避免上电瞬间马达抖一下;HX711 最后初始化,因为它需要一点时间稳定。
scale.tare() 放在 setup() 里,作用是「上电时把当前状态记成零点」。这个做法在坐垫空载时上电没问题,但如果上电时上面正好压着东西,零点就偏了,后面所有读数都会带着这个偏移。更稳妥的做法是上电后延时几百毫秒再去皮,或者留一个手动重新去皮的入口。材料里的写法是直接 tare(),适合先跑通,不适合长期无人值守。
scale.set_scale() 在材料代码里没有传参数,只写了空调用。这行代码的实际作用取决于后面用 read() 还是 get_units():用 read() 时它不影响原始值,用 get_units() 时才决定换算比例。这一点在参数章节会讲清楚,先记住「空调用不影响原始读数」就够了。
3.3 loop 的采样平均与落座状态机
loop() 每轮先做 5 次采样,每次间隔 10 毫秒,然后取平均。这样做的目的是压掉单次采样的毛刺,但 10 毫秒的间隔有一个隐患:HX711 常见的输出率是 10Hz,也就是 100 毫秒才出一个新样本,连续 5 次读很可能读到重复值,平均下来并没有真正降噪。这是后面避坑章节要展开的一条。
采样之后进入落座判断。pressureValue >= PRESSURE_THRESHOLD 成立时,如果 isSitting 还是 false,说明这是刚坐下,记录 sitStartTime = millis(),把标志置 true。如果已经坐着,就算 millis() - sitStartTime,超过阈值就震动提醒,然后把 sitStartTime 重置为当前时间,避免下一轮又立刻触发。
没超过阈值时走 else 分支:isSitting = false,马达拉低,串口打印重置。这个分支保证人离开后计时归零,下次坐下重新开始。状态标志的作用就在这里——没有它,每轮循环都会重新记录开始时间,计时永远到不了 30 分钟。
cpp复制#include <HX711.h>
// 引脚定义
#define HX711_DOUT 26
#define HX711_SCK 27
#define VIBRATE_PIN 13
// 阈值设置(需根据实际坐垫校准)
#define PRESSURE_THRESHOLD 5000 // 落座压力阈值(无压力时数值接近0)
#define SIT_TIME_THRESHOLD 1800000 // 久坐阈值(30分钟=30*60*1000毫秒)
// 全局变量
HX711 scale;
unsigned long sitStartTime = 0;
bool isSitting = false;
void setup() {
Serial.begin(115200);
pinMode(VIBRATE_PIN, OUTPUT);
digitalWrite(VIBRATE_PIN, LOW);
scale.begin(HX711_DOUT, HX711_SCK);
scale.set_scale();
scale.tare();
Serial.println("系统初始化完成,开始检测...");
}
void loop() {
long pressureValue = 0;
for (int i = 0; i < 5; i++) {
pressureValue += scale.read();
delay(10);
}
pressureValue = pressureValue / 5;
Serial.print("当前压力值:");
Serial.println(pressureValue);
if (pressureValue >= PRESSURE_THRESHOLD) {
if (!isSitting) {
sitStartTime = millis();
isSitting = true;
Serial.println("检测到落座,开始计时");
} else {
unsigned long sitDuration = millis() - sitStartTime;
if (sitDuration >= SIT_TIME_THRESHOLD) {
Serial.println("久坐超时,震动提醒!");
vibrateRemind();
sitStartTime = millis();
}
}
} else {
isSitting = false;
digitalWrite(VIBRATE_PIN, LOW);
Serial.println("无人落座,重置计时");
}
delay(1000);
}
void vibrateRemind() {
digitalWrite(VIBRATE_PIN, HIGH);
delay(5000);
digitalWrite(VIBRATE_PIN, LOW);
}
3.4 震动函数与复位逻辑
vibrateRemind() 只有三行:拉高、等 5 秒、拉低。它解决的是「提醒要能被感知」,但代价是这 5 秒里 loop() 被完全阻塞,压力采样和落座判断都停了。对于坐垫这种慢变量场景,5 秒不采样通常不至于漏掉落座,但如果人在这 5 秒内起身,代码感知不到,sitStartTime 还是会在函数返回后被重置,下一次坐下重新计时,逻辑上不会错得太离谱。
真正需要留意的是「持续震动」问题。如果提醒后不重置 sitStartTime,下一轮 loop() 会立刻再次满足超时条件,马达就会反复震动。材料代码在调用 vibrateRemind() 之后马上 sitStartTime = millis(),就是为了把这个循环切断。
delay(1000) 放在 loop() 末尾,把检测频率压到 1 秒一次,目的是降功耗、减少串口刷屏。它同时也意味着计时精度是秒级,对于 30 分钟的阈值来说完全够用。如果以后要做更细的采样曲线,这个延时需要重新考虑。
4. 用代码开发工具把参数调准:PRESSURE_THRESHOLD 与 SIT_TIME_THRESHOLD 的校准
4.1 set_scale 的系数不是拍脑袋来的
材料备注里给了一个校准方法:在坐垫上放已知重量的物体,比如 1kg 砝码,读取 scale.read() 的数值,如果读数是 10000,就调用 scale.set_scale(10000 / 1)。这个系数的含义是「每单位重量对应多少个原始计数」,get_units() 用它把原始值换算成重量。
但这里有一个必须说清的分叉:当前固件用的是 scale.read(),不是 scale.get_units()。set_scale() 只影响 get_units() 的换算结果,对 read() 返回的原始值没有任何作用。也就是说,材料代码里的 scale.set_scale() 空调用,和后面用原始值比较阈值,是两套没有打通的路线。这不是致命错误,但会让校准步骤看起来做了、实际没生效。
我的建议是二选一。想继续用原始值配阈值,就把 set_scale() 那行删掉或注释掉,校准工作转成「记录空载和落座两组原始值,取中间值当阈值」。想用克数做阈值,就把判断改成 scale.get_units() >= 5000 这类写法,同时把 set_scale() 的系数校准做准。两条路线不要混着用,混用最容易出现「明明校准了,阈值还是不对」的困惑。
4.2 空载和落座两组数据定阈值
确定阈值最笨也最可靠的办法,是采两组数:坐垫空载时读一组,人坐上去之后读一组。空载值通常在 0 附近,但会有几十到几百的波动;落座值取决于坐垫结构和传感器位置,可能是几千,也可能上万。阈值取两组之间的某个值,离两边都留出余量。
采集时不要让程序只打印一个瞬时值,最好做多次平均。下面这段只做采集,不参与业务判断:
cpp复制void loop() {
long raw = 0;
for (int i = 0; i < 10; i++) {
raw += scale.read();
delay(100); // 间隔大于 HX711 的输出周期,避免重复采样
}
Serial.print("10次平均:");
Serial.println(raw / 10);
delay(1000);
}
delay(100) 这个参数是有讲究的:HX711 常见输出率 10Hz,100 毫秒刚好对应一个新样本,连续读 10 次拿到的是 10 个不同样本,平均才有降噪意义。如果像业务代码那样 delay(10),10 次里可能只有一两个新值,平均效果会打折扣。
采完两组数,把阈值定在中间,再用串口监视器观察几分钟。人起身、坐下、轻微挪动都试一遍,看阈值会不会被误触发。坐垫这类柔性负载,边缘坐姿和正坐的压力分布差别很大,阈值定得太靠近落座值,侧坐就会漏报;定得太靠近空载值,放个包就会误报。
4.3 时间阈值和提醒节奏的取舍
SIT_TIME_THRESHOLD 设成 1800000 毫秒,对应 30 分钟。这个值没有绝对标准,取决于使用场景:办公场景 30 到 45 分钟都常见,学习场景可以短一些。改这个值时只改宏定义,不要动 loop() 里的计算逻辑。
提醒节奏也值得单独考虑。材料里的做法是「震动 5 秒,然后重置计时」,效果是每 30 分钟震一次。如果希望更柔和,可以改成间隔震动:震 1 秒、停 0.5 秒,循环 5 次。这个改动不需要动主逻辑,只改 vibrateRemind() 内部。但要注意,间隔震动如果继续用 delay() 实现,阻塞时间会更长,主循环停得更久,这时候就该考虑非阻塞写法了。
| 参数 | 材料示例值 | 含义 | 调整依据 |
|---|---|---|---|
PRESSURE_THRESHOLD |
5000 | 原始 ADC 落座阈值 | 空载与落座两组读数取中间 |
SIT_TIME_THRESHOLD |
1800000 | 久坐提醒周期(毫秒) | 30 分钟,可按场景改 |
| 采样次数 | 5 | loop() 内平均次数 |
与采样间隔配合,避免重复值 |
| 采样间隔 | 10ms | 每次 scale.read() 间隔 |
建议不小于输出周期 |
| 主循环延时 | 1000ms | 检测频率 | 降功耗、降串口刷屏 |
| 震动时长 | 5000ms | 单次提醒持续时间 | 用非阻塞状态机替代 delay |
注意:
PRESSURE_THRESHOLD和set_scale()的系数是两套体系。用read()比较原始值,就不要指望set_scale()能改变阈值判断结果。
5. 避坑排查:五个让坐垫误报或漏报的细节
5.1 现象:压力值一直跳,落座识别不稳定
串口里打印的原始值上下浮动几百甚至上千,人坐着的时候偶尔掉到阈值以下,计时被反复重置,30 分钟永远走不完。
原因通常有两个。一是采样间隔太短,HX711 的输出率跟不上,连续读到的重复值被平均后并没有压掉真实波动;二是 tare() 只在上电时做了一次,传感器预热不够或者坐垫受力状态变了,零点已经偏了。
解决方式是把采样间隔拉到不小于输出周期,比如 100 毫秒读一次,读 5 到 10 次再平均;同时在上电后延时几百毫秒再 tare(),或者在串口里留一个重新去皮的口令。阈值不要贴着空载值定,留出足够的回差。
5.2 现象:震动 5 秒期间,人起身了但程序没反应
马达震完,串口接着打印「久坐超时」,但中间那 5 秒没有任何采样日志。如果人在这段时间离开,程序要等震动结束后的下一轮才更新状态。
原因就是 vibrateRemind() 里的 delay(5000),它把整个 loop() 阻塞了。坐垫场景对这 5 秒的容忍度还算高,但如果你把提醒改成 10 秒、或者加蜂鸣器、加屏幕,阻塞时间会更长,问题会被放大。
解决方式是把震动改成非阻塞状态机:记录震动开始时间,主循环每轮检查是否到了关闭时间,期间采样和计时照常跑。具体写法在最后一章展开。如果暂时不想改结构,至少把震动时长压短,并且接受这期间的采样空窗。
5.3 现象:运行几天后,久坐计时突然不准
短时间测试一切正常,连续跑上几天,提醒间隔变得忽长忽短,甚至刚坐下就震。
原因要从 millis() 的类型说起。millis() 返回 unsigned long,32 位平台上大约 49 天会溢出回绕。材料代码用的是 millis() - sitStartTime,无符号减法在回绕时仍然能得到正确的差值,这个写法本身是安全的。真正容易翻车的是另一种写法:millis() > sitStartTime + SIT_TIME_THRESHOLD,一旦加法结果溢出,比较就会错乱。
解决方式是统一用「当前时间减开始时间」的差值比较,不要用「当前时间大于开始时间加阈值」。另外,sitStartTime 必须是 unsigned long,不能用 int 或 long,否则差值计算会变成有符号数,回绕时直接出负值。
5.4 现象:换一块坐垫就误触发,或者坐上去不报
同一套代码,在第一块坐垫上工作正常,换一块之后要么空载就震,要么坐半天没反应。
原因在于 PRESSURE_THRESHOLD 比较的是原始 ADC 值,而原始值受传感器安装位置、坐垫厚度、供电电压影响。5000 这个数只对当前样品有意义,不是通用阈值。
解决方式是每换一块坐垫就重新采两组数,重新定阈值。如果要做小批量,至少留一个串口调参入口,能在不重新烧录的情况下改阈值。把阈值写死在宏里、换硬件就重编译,是实验室做法,不是产品做法。
5.5 现象:马达一震动,ESP32 就重启或者读不到压力
震动开始的瞬间,串口断开重连,或者压力读数突然归零。
原因通常出在驱动上。震动马达是感性负载,直接挂在 GPIO 上,启动电流和反电动势都可能把电源拉低。ESP32 的 GPIO 驱动能力有限,带不动马达是常态,能带起来也可能是勉强工作。
解决方式是加一级开关器件,比如三极管或 MOS 管,马达两端并联续流二极管,电源单独走线,必要时给马达电源加滤波电容。代码层面,马达引脚初始化为低电平、震动结束后及时拉低,能减少误动作,但不能替代硬件驱动。这一条不是代码能修好的,遇到重启先查电路。
6. 进阶:把 delay 震动改成非阻塞状态机,并留一个串口校准口
最后一层改造,目标是把 vibrateRemind() 里的 delay(5000) 拿掉,让采样和计时在震动期间继续跑。做法不复杂:加两个全局变量,一个记震动开始时间,一个记当前是否在震动;主循环里用差值判断该开还是该关。
cpp复制unsigned long vibrateStart = 0;
bool vibrating = false;
void loop() {
// 采样与落座判断同上,这里只展示震动状态机
if (sitDuration >= SIT_TIME_THRESHOLD && !vibrating) {
digitalWrite(VIBRATE_PIN, HIGH);
vibrateStart = millis();
vibrating = true;
sitStartTime = millis(); // 重置久坐计时,避免连续触发
}
if (vibrating && millis() - vibrateStart >= 5000) {
digitalWrite(VIBRATE_PIN, LOW);
vibrating = false;
}
}
这段代码的关键在 vibrating 标志:没有它,每一轮循环只要超时条件成立就会重新拉高、重新记开始时间,马达永远关不掉。millis() - vibrateStart 的差值写法同样是为了避开溢出问题。震动期间 loop() 不再停 5 秒,采样日志连续,人起身也能立刻被识别。
第二个改造是留串口校准口。不用做复杂的命令行解析,只要在 loop() 里检查串口有没有输入,收到特定字符就重新 tare() 或者打印当前平均值。这样换坐垫时不用重新烧录,连上串口就能调。验证时按三步走:空载看读数是否稳定在阈值以下,坐上去看是否稳定在阈值以上,计时到点看马达是否按预期启停。三步都过,再让它连续跑一晚,第二天看串口日志有没有异常重置。
从那以后我每次做这类传感器固件,都强制先跑最小读取 sketch、再采两组数定阈值、最后才写业务逻辑,顺序反一次就得多花半天排错。希望帮到你。
