当前位置：首页 > news >正文

基于Circuit Playground的坐姿检测器：从加速度计原理到可穿戴实现

news 2026/5/16 8:43:31

1. 项目概述与核心思路

长时间伏案工作，腰酸背痛几乎是每个现代人的“标配”。问题的根源往往在于无意识的坐姿变形——也就是我们常说的“葛优躺”或“弓背”。作为一个常年和代码、硬件打交道的开发者，我一直在寻找一种低成本、可定制的方案来提醒自己保持良好坐姿。市面上的智能坐垫或提醒器要么功能单一，要么价格不菲。直到我发现了Adafruit的Circuit Playground开发板，它内置了加速度计、麦克风、蜂鸣器、RGB灯等一系列传感器和外设，简直就是为这类DIY项目量身定做的。

这个项目的核心思路非常直接：将Circuit Playground像徽章一样别在衣领或胸前口袋处。板载的加速度计会持续感知其相对于重力方向的倾斜角度。当我们坐直时，这个角度（我们称之为“目标角度”）是相对固定的。一旦我们开始弯腰驼背，倾斜角度就会增大。程序会实时计算当前角度与目标角度的差值，如果这个差值（即“驼背角度”）超过了我们设定的阈值，并且持续了一定时间，设备就会通过蜂鸣器发出警报，提醒我们坐直。

整个项目最吸引我的地方在于它的“透明性”和“可塑性”。从最基础的v1版本（检测到倾斜就报警）到v3版本（支持校准和延时报警），你可以清晰地看到一个产品功能是如何一步步迭代和完善的。无论是用Arduino还是CircuitPython，代码逻辑都清晰易懂，非常适合作为嵌入式开发、传感器应用和可穿戴设备制作的入门实践。接下来，我将带你从硬件选型开始，一步步拆解这个项目的实现细节、代码逻辑，并分享我在制作和调试过程中踩过的坑和总结的经验。

2. 硬件准备与选型解析

工欲善其事，必先利其器。一个成功的硬件项目，选择合适的核心板和周边配件是第一步。这个项目的核心是Circuit Playground，但根据版本和你的具体需求，搭配的配件会有所不同。

2.1 核心开发板：Circuit Playground Classic vs. Express

首先，你需要一块Circuit Playground。Adafruit提供了两个主要版本：Classic和Express。它们看起来很像，都集成了10个可编程RGB NeoPixel灯、运动传感器（加速度计）、温度传感器、光线传感器、声音传感器、迷你蜂鸣器、两个按钮、一个滑动开关以及多个触摸感应焊盘。

关键区别在于主控芯片和开发环境：

Circuit Playground Classic：基于ATmega32u4微控制器。它本质上是一块高度集成的Arduino Leonardo，因此只能用Arduino IDE进行编程。如果你对Arduino非常熟悉，或者手头只有Classic版，那么选择Arduino路径是没问题的。
Circuit Playground Express：基于更强大的ATSAMD21 ARM Cortex-M0+处理器。它最大的优势是原生支持CircuitPython，这是一种基于Python的、对初学者极其友好的嵌入式编程语言。你可以像编辑文本文件一样修改代码，板子会像U盘一样出现在电脑上，修改后自动运行。当然，Express也完全兼容Arduino IDE。

我的选择与建议：对于这个坐姿检测项目，尤其是如果你想快速上手并体验交互式编程的乐趣，我强烈推荐Circuit Playground Express。CircuitPython的代码更简洁，调试更方便（可以直接通过串口REPL打印数据），生态也日益完善。除非你已有Classic版或对Arduino有特殊偏好，否则Express是更优解。

2.2 电源方案：如何让设备“无线”穿戴

为了让设备可穿戴，我们必须摆脱USB线的束缚。这就需要电池供电。原文提到了几种方案，我来分析一下各自的优劣：

3xAAA电池盒（最通用）：这是最经典、最容易获取的方案。一个3节AAA电池盒通过JST-PH接口连接板子，能提供约4.5V电压，电量充足，更换方便。缺点是体积较大，放在口袋里会有明显坠感。
锂聚合物电池（LiPo，最推荐）：这是我个人最喜欢的方案。一块500mAh或更大容量的3.7V LiPo电池，体积小巧、重量轻、可充电。你可以用USB直接给板子充电，同时为内置的电池充电管理芯片供电，非常方便。搭配一个带开关的JST延长线，可以把电池放在更舒适的口袋里。
纽扣电池盒（最轻薄）：使用CR2032等纽扣电池的方案最为轻薄，几乎感觉不到重量。但缺点是容量小、电压低（通常两节串联为6V，需注意板子耐受电压），且不可充电，长期使用成本高。适合对体积重量极其敏感的原型。

实操心得：电源管理的细节：
电压注意：Circuit Playground Express的工作电压范围是3.3V-5.5V。3.7V的LiPo电池（满电约4.2V）完全在安全范围内。使用3节AAA碱性电池（约4.5V）或充电电池（约3.6V）也没问题。
续航估算：这个项目的功耗主要来自主控芯片和加速度计（常开），以及间歇发声的蜂鸣器。实测使用一块500mAh的LiPo电池，可以轻松连续工作一整天（8小时以上）。你可以通过代码优化，例如在检测到长时间无活动后进入轻度睡眠模式，来进一步延长续航。
开关与安全：板子本身没有物理电源开关。长期不用时，务必断开电池！否则电池会缓慢放电直至过放损坏（尤其是LiPo电池，过放很危险）。使用带开关的电池盒或JST延长线是个好习惯。

2.3 穿戴附件：如何稳固又优雅地佩戴

如何把板子固定到衣服上是影响使用体验的关键。原文提到了几种方法：

口袋放置：最简单直接，适合有前胸口袋的衬衫或Polo衫。缺点是位置可能不理想，且活动时板子会在口袋里晃动，影响加速度计读数。
银色别针：这是一个带有强力背胶的别针，直接粘在板子背面。优点是固定牢固，位置可精确控制。缺点是会在衣服上留下针孔，且对于较厚或柔软的面料，别针可能固定不牢。
磁性别针（强烈推荐）：这是我最推荐的方案。它包含一个粘在板子背面的金属片和一个独立的磁性别针。使用时将磁性别针别在衣服内侧，板子通过磁力吸附在外面。优点太多了：不会损伤衣物；摘戴极其方便；可以通过移动磁片微调板子位置。唯一需要注意的是安装方向，务必按照原文图示，让金属片呈一定角度，避免其两端同时接触到板子背面的3.3V和GND测试焊盘，造成短路风险。

3. 核心原理：如何用加速度计测量“驼背角度”

这是整个项目的技术核心。理解了这个，你就能举一反三，用加速度计做很多其他姿态检测项目。

3.1 加速度计与重力感应

Circuit Playground内置的加速度计是一个三轴（X, Y, Z）传感器。它不仅能测量动态加速度（比如晃动），更能持续感知一个恒定的加速度——重力。无论设备静止还是匀速运动，重力加速度（约9.8 m/s²）都会作用在传感器上。

当板子静止时，加速度计三个轴读数的矢量和的大小就等于重力加速度。其方向，则指向地心。因此，通过分析重力加速度在三个轴上的分量，我们就可以反推出设备相对于重力方向的倾斜角度。

3.2 建立数学模型：从加速度到角度

为了简化问题，我们假设将板子垂直别在胸前（USB口朝上或朝下）。此时，我们主要关心板子绕左右轴（假设为Y轴）的前后倾斜。这个倾斜发生在一个二维平面内（由Z轴和X轴构成）。

想象一下：当板子完全垂直时，重力全部落在Z轴上（假设为负方向）。此时，accelZ = -9.8，accelX = 0。当我们向前倾斜板子时，一部分重力分量会转移到X轴上。

这形成了一个经典的直角三角形关系：

斜边：重力加速度的大小（GRAVITY，约9.8）。
对边：Z轴加速度分量的绝对值（-accelZ，因为重力在Z轴负方向）。
邻边：X轴加速度分量（accelX）。

根据三角函数，倾斜角θ可以通过反正弦函数求得：θ = arcsin( (-accelZ) / GRAVITY )

为什么用arcsin而不是arctan？原文的对比实验给出了答案。arctan(accelX / (-accelZ))的计算依赖于X轴和Z轴的比值。当板子旋转（比如你身体侧倾）导致X轴读数很小时，arctan计算会变得不稳定。而arcsin只依赖于Z轴，只要板子的前后倾斜平面大致不变，它就更鲁棒。对于坐姿检测这个应用，我们主要防止前后弯腰，身体轻微的左右扭转影响不大，因此arcsin是更合适的选择。

3.3 从“绝对角度”到“相对驼背角度”

直接使用计算出的“绝对角度”是不行的。因为没人能保证别上板子时身体是绝对垂直的，衣服的褶皱、别的位置都会引入一个初始偏移角。

这就是v2版本引入“目标角度校准”的妙处。其逻辑是：

校准：用户坐直后，按下按钮。程序将此时的currentAngle记录为targetAngle。这个角度代表了“良好坐姿”时板子的倾斜状态。
检测：在后续运行中，程序不再关心绝对角度，而是计算slouchAngle = currentAngle - targetAngle。这个slouchAngle才是真正意义上的“驼背角度”。
判断：当slouchAngle > SLOUCH_ANGLE（例如10度），则认为用户开始驼背。

这个简单的减法操作，完美抵消了设备安装位置带来的个体差异，使得检测标准对每个用户、每次佩戴都是个性化的。

3.4 防误报：延时触发机制

v1和v2版本有个明显问题：一超过角度就报警，太烦人了！捡个笔、探身看下手机都会触发。v3版本引入的延时触发机制解决了这个问题。

其核心是状态机思想：

进入驼背状态：当slouchAngle首次超过阈值时，记录下当前时间slouchStartTime，并将状态标记为slouching = true。
持续监测：只要角度仍超限，就维持slouching = true。
判断时长：在slouching为真的前提下，检查(当前时间 - slouchStartTime)是否大于预设的SLOUCH_TIME（例如3秒）。
触发报警：只有当时长也超限，才最终触发报警。
退出状态：一旦角度恢复到阈值以内，立即将slouching重置为false。这样，短暂的倾斜不会触发计时，只有持续的不良姿势才会被警告。

这个机制极大地提升了产品的可用性，让它从一个“神经质”的提醒器变成了一个“理解人性”的助手。

4. Arduino实现详解与代码逐行剖析

让我们深入代码，看看上述原理是如何用Arduino C++语言实现的。我将以功能最完善的v3版本为例进行拆解。

4.1 基础框架与常量定义

#include <Adafruit_CircuitPlayground.h> #define SLOUCH_ANGLE 10.0 // 允许的驼背角度（度） #define SLOUCH_TIME 3000 // 触发报警前允许的驼背时间（毫秒） #define GRAVITY 9.80665 // 标准重力加速度 (m/s^2) #define RAD2DEG 57.29578 // 弧度转度数的系数 (180/PI) float currentAngle; // 当前计算出的绝对角度 float targetAngle; // 用户校准的良好坐姿角度 unsigned long slouchStartTime; // 开始驼背的时刻（毫秒时间戳） bool slouching; // 当前是否处于驼背状态

头文件：Adafruit_CircuitPlayground.h库封装了所有板载硬件的操作，让我们可以用CircuitPlayground.motionZ()这样的简单函数读取传感器数据。
常量：SLOUCH_ANGLE和SLOUCH_TIME是两个最重要的可调参数。你可以根据个人敏感度调整它们。10.0度和3000毫秒（3秒）是一个不错的起始值。
变量：
- currentAngle,targetAngle：使用float类型存储角度，保证精度。
- slouchStartTime：使用unsigned long类型存储millis()返回的时间戳，范围足够大。
- slouching：一个布尔标志位，是状态机的核心。

4.2 初始化设置（setup函数）

void setup() { // 初始化Circuit Playground CircuitPlayground.begin(); // 初始化目标角度为零。 targetAngle = 0; }

setup()函数只运行一次。CircuitPlayground.begin()初始化所有硬件（I2C、传感器等）。将targetAngle初始化为0，等待用户校准。

4.3 主循环逻辑（loop函数）

主循环loop()以尽可能快的速度（通常每秒数百到上千次）重复执行，实现实时检测。

4.3.1 角度计算

void loop() { // 计算当前角度 currentAngle = RAD2DEG * asin(-CircuitPlayground.motionZ() / GRAVITY);

这是核心计算公式。CircuitPlayground.motionZ()返回Z轴加速度值（单位通常是 m/s²）。除以GRAVITY得到正弦值，再用asin()求反正弦得到弧度，最后乘以RAD2DEG转换为角度。前面的负号是因为当板子垂直时，重力加速度在Z轴负方向。

4.3.2 校准功能

// 按下任意按钮设置目标角度 if ((CircuitPlayground.leftButton()) || (CircuitPlayground.rightButton())) { targetAngle = currentAngle; CircuitPlayground.playTone(900,100); delay(100); CircuitPlayground.playTone(900,100); delay(100); }

检测左右按钮是否被按下。按下后，将当前的currentAngle赋值给targetAngle，完成校准。并用两声短促的900Hz提示音给予用户反馈。这里的两个delay(100)是为了让提示音有间隔，同时也能起到简单的按键防抖作用。

注意事项：按键防抖：在实际应用中，机械按钮按下时可能会产生多次电平跳变（抖动）。这里的delay是一种简单的软件防抖。对于要求更高的场景，可以记录按下时间，只在按下持续超过一定时间（如50ms）后才认为是一次有效按键。

4.3.3 驼背状态检测与计时

// 检查是否驼背 if (currentAngle - targetAngle > SLOUCH_ANGLE) { if (!slouching) slouchStartTime = millis(); slouching = true; } else { slouching = false; }

计算相对角度currentAngle - targetAngle并与阈值比较。

如果大于阈值，且之前状态不是驼背（!slouching），则记录下开始驼背的时刻slouchStartTime，然后将状态设为驼背。
如果大于阈值，但已经是驼背状态，则只维持slouching = true，不重置开始时间。
如果小于等于阈值，则将状态设为非驼背。这样，一旦坐直，计时就被清零。

4.3.4 报警判断与触发

// 如果我们处于驼背状态 if (slouching) { // 检查我们驼背多久了 if (millis() - slouchStartTime > SLOUCH_TIME) { // 播放提示音 CircuitPlayground.playTone(800, 500); } } }

只有处于驼背状态时，才检查持续时间。millis()返回Arduino启动后的毫秒数。用当前时间减去开始时间，得到已持续时间。如果超过SLOUCH_TIME，则触发800Hz、持续500ms的报警音。

重要细节：millis()溢出问题：millis()返回的unsigned long类型大约每50天会溢出归零。在if (millis() - slouchStartTime > SLOUCH_TIME)这个判断中，即使发生溢出，只要时间间隔小于最大值（约24.85天），减法运算在无符号整型中依然能得出正确的时间差。这是处理millis()溢出的标准且安全的方法。对于这个项目，时间间隔最多几秒到几分钟，完全不用担心。

5. CircuitPython实现详解与对比

CircuitPython的实现逻辑与Arduino完全一致，但语法更简洁，更像编写脚本。我们同样以v3版本为例。

5.1 代码结构与导入

# Circuit Playground Express Slouch Detector v3 import time import math from adafruit_circuitplayground.express import cpx SLOUCH_ANGLE = 10.0 SLOUCH_TIME = 3 GRAVITY = 9.80665

导入库：time用于时间函数，math提供asin和degrees，cpx是代表Circuit Playground Express的对象，所有硬件操作都通过它（如cpx.acceleration,cpx.button_a）。
常量定义：注意SLOUCH_TIME单位是秒，而不是毫秒，这与Arduino版本不同。

5.2 主循环逻辑

target_angle = 0 slouching = False while True: # 计算当前角度 current_angle = math.asin(-cpx.acceleration[2] / GRAVITY) current_angle = math.degrees(current_angle)

初始化变量后进入无限循环。cpx.acceleration是一个包含 (x, y, z) 三个值的元组。索引[2]对应Z轴。math.degrees()直接将弧度转换为角度。

# 按下按钮设置目标角度 if cpx.button_a or cpx.button_b: target_angle = current_angle cpx.play_tone(900, 0.1) time.sleep(0.1) cpx.play_tone(900, 0.1) time.sleep(0.1)

按钮检测和校准逻辑。play_tone的参数是频率和持续时间（秒）。

# 检查是否驼背 if current_angle - target_angle > SLOUCH_ANGLE: if not slouching: slouch_start_time = time.monotonic() slouching = True else: slouching = False

状态检测逻辑。time.monotonic()返回一个单调递增的时间（秒），不会因系统时间调整而改变，适合用于测量时间间隔。

# 如果我们处于驼背状态 if slouching: # 检查驼背多久了 if time.monotonic() - slouch_start_time > SLOUCH_TIME: # 播放提示音 cpx.play_tone(800, 0.5)

5.3 Arduino与CircuitPython的关键差异与选择建议

开发体验：CircuitPython完胜。代码以.py文件形式存放在板子的U盘里，用任何文本编辑器修改后保存，代码自动重启运行。调试时，可以通过串口连接（如screen或putty）进入REPL交互环境，实时查看变量、执行命令，极其方便。
性能：Arduino（C++）编译成本地机器码，执行效率更高，循环速度更快。对于这个项目，两者都绰绰有余。
语法与生态：CircuitPython语法简单，库的导入和使用更直观。Arduino有更庞大的第三方库生态，适合更复杂的项目。
硬件支持：只有Circuit PlaygroundExpress支持CircuitPython。Classic版只能用Arduino。

给新手的建议：如果你是编程新手，或者想快速看到成果并进行交互式调试，从CircuitPython开始。它的学习曲线平缓，反馈即时。如果你已有嵌入式C/C++基础，或者项目未来需要更复杂的控制、更低的功耗，选择Arduino。

6. 高级优化与功能扩展思路

基础功能实现了，但一个好用的产品还需要打磨。这里分享几个我实践过的优化和扩展方向。

6.1 参数调优与个性化

SLOUCH_ANGLE和SLOUCH_TIME没有“标准答案”。你需要根据自己的体型、座椅和敏感度来调整。

角度阈值（SLOUCH_ANGLE）：建议从10-15度开始尝试。太敏感（如5度）容易误报，太宽松（如20度）则失去提醒意义。可以在代码中增加调试输出，串口打印出实时的slouchAngle，观察你正常坐直和故意驼背时的数值差异，从而确定一个合理的阈值。
时间阈值（SLOUCH_TIME）：2-5秒是比较合理的范围。这个时间应该长于你偶尔前倾捡东西、打喷嚏的时长，但又短到能在你形成习惯性驼背前提醒你。

6.2 实现“静默”视觉报警

蜂鸣器报警在办公室可能有点尴尬。我们可以利用板载的10个NeoPixel RGB灯来实现更优雅的提醒。

渐进式提醒：在刚超过角度阈值时，让灯带呈绿色。随着驼背时间增加，颜色逐渐向红色过渡（例如，用map函数将已驼背时间映射到HSV颜色的色相值）。当超过SLOUCH_TIME时，所有灯快速闪烁红色。这样既能提供持续、无干扰的反馈，又能在严重时给出强烈警告。
方向指示：甚至可以编程让灯光流动方向指示你该向后还是向左/右调整姿势（这需要结合X轴数据分析）。

6.3 利用滑动开关实现模式切换

板子上的滑动开关是一个完美的硬件配置接口。

功能模式：向上拨动，启用蜂鸣器报警模式；向下拨动，启用静默灯光报警模式。在loop()开始读取开关状态CircuitPlayground.slideSwitch()（Arduino）或cpx.switch（CircuitPython），根据其值决定后续执行哪套报警逻辑。
校准锁定：拨动开关到某一位置可以锁定当前的目标角度，防止误触按钮导致校准被重置。

6.4 数据记录与统计分析

为你的姿势健康做个长期追踪。利用板子的存储（CircuitPython可以写文件）或通过串口实时发送数据到电脑。

记录日志：每隔一段时间（如每分钟）记录一次平均驼背角度、单次最长驼背时间、报警次数等。
可视化分析：将数据导入到Excel、Python（Matplotlib）或在线图表工具，生成每日/每周的坐姿报告。这能让你更直观地了解自己的习惯，并评估改进效果。

6.5 低功耗优化

如果你希望用纽扣电池获得数周续航，低功耗优化是关键。

降低采样率：坐姿变化是缓慢的，不需要每秒检测上百次。在loop()中增加delay(100)将主循环降到10Hz，功耗会显著下降。
利用睡眠模式：在检测到长时间无活动（例如，通过加速度计判断设备静止超过10分钟）后，可以让主控芯片进入深度睡眠（Idle或Standby模式），仅由加速度计在中断模式下工作。当加速度变化超过阈值时，产生中断唤醒主控。这需要更深入的寄存器级编程，在Arduino中通常借助LowPower等库实现。

7. 常见问题排查与调试技巧

即使按照教程一步步来，你也可能会遇到一些问题。这里汇总了一些常见坑点和解决方法。

7.1 角度读数不稳定或漂移

现象：即使板子静止，计算出的角度也在小范围跳动（如±1-2度）。
原因：这是加速度计传感器的本底噪声，属于正常现象。数字传感器都有一定的分辨率限制和电气噪声。
解决：
1. 软件滤波：不要使用单次采样值。改为采集最近N次（如10次）的读数，求平均值作为currentAngle。这能有效平滑数据。一个简单的移动平均滤波就能大大改善稳定性。
2. 阈值宽容：在判断slouchAngle > SLOUCH_ANGLE时，可以设置一个回差（Hysteresis）。例如，只有当角度超过12度才认为进入驼背状态，而必须回到8度以内才认为驼背结束。这可以防止在阈值附近因噪声导致的状态频繁切换。

7.2 校准后报警不触发或一直报警

现象：按下按钮校准后，设备要么再也不报警，要么立刻持续报警。
原因：校准姿势不标准，或板子佩戴位置/方向有误。
排查：
1. 串口调试：这是最重要的手段！在代码中增加串口输出语句，实时打印currentAngle,targetAngle,slouchAngle的值。通过观察这些数据，你可以立刻知道是角度计算错误、校准值异常还是判断逻辑问题。
  - Arduino: 在setup()中加上Serial.begin(9600);，在loop()中用Serial.println()输出变量。
  - CircuitPython: 在REPL中直接输入print(current_angle, target_angle)或是在代码中加上。
2. 检查佩戴：确保板子是垂直固定在胸前的，USB口朝上或朝下。如果板子本身是倾斜的，那么“坐直”时各轴的重力分量关系就不符合arcsin模型的假设了。
3. 验证校准：校准后，故意前倾身体，观察slouchAngle是否从0开始正向增加。如果减少或变化不规则，说明佩戴方向可能不对。

7.3 电池耗电过快

现象：新电池很快没电。
原因：NeoPixel全亮、蜂鸣器常响、主循环无延迟都会导致功耗激增。
解决：
1. 灯光管理：确保在不需要的时候用CircuitPlayground.clearPixels()(Arduino) 或cpx.pixels.fill((0,0,0))(CircuitPython) 关闭所有LED。
2. 降低循环频率：如6.5节所述，增加适当的delay。
3. 检查短路：检查磁性别针的金属片是否意外短路了板子背面的测试点。

7.4 代码上传/保存失败

CircuitPython：确保板子处于可编程状态（显示为U盘）。如果电脑无法识别，尝试双击板子上的复位按钮，直到出现CIRCUITPY盘符。编辑代码时，使用如VS Code with CircuitPython插件、Mu Editor等对文本文件保存更友好的编辑器，避免Windows记事本可能添加BOM头导致的问题。
Arduino：在“工具”菜单中正确选择开发板型号（Adafruit Circuit Playground Express）和端口。如果上传失败，尝试在上传时快速双击板子复位按钮，使其进入引导加载模式。

这个项目从原理到实现，从基础功能到高级优化，为你展示了一个完整的小型嵌入式产品开发流程。它不仅仅是一个坐姿提醒器，更是一个绝佳的传感器应用教学案例。当你成功将它制作出来并戴在身上，听到它在你窝在沙发上太久而发出提醒时，那种自己动手解决实际问题的成就感，是任何现成商品都无法给予的。希望你在制作过程中，不仅能收获一个健康小助手，更能深入理解数据、算法与物理世界交互的乐趣。

查看全文

http://www.jsqmd.com/news/827140/