随身记录空气中的颗粒物|CanAirIO

口袋里的颗粒物监测器,记录你走过的环境

用ESP32、SPS30和3D打印外壳搭一台带屏幕的空气监测器。先离线查看颗粒物与温湿度,再按需连接手机记录路线。本页选择CanAirIO Bike SPS30原版;不是CO₂版,也不是法定环境监测仪。

alan000

参数信息

M2紧固件
16 颗

复现文档

确认采购的是 SPS30 版本

目标:把这一版需要的主板、两种传感器、电源和固定件分开核数,避免把 CO₂ 版器件代进来。

1. 准备 1 块 TTGO T-Display ESP32 彩屏主板、1 个 Sensirion SPS30、1 个 AM2320 温湿度传感器。

2. 准备 1 个带 EN 控制脚的 5 V 升压模块、1 节 3.7 V/650–800 mAh 电池(最长 48×30×6 mm)、USB-C 数据线和适配 SPS30 的 5 针连接线;原资料指出 SPS30 线缆需另购。

3. 按 BOM 清点 16 颗螺钉:M2×4 四颗、M2×5 八颗、M2×6 两颗、M2×7 两颗;磁铁和热缩管为可选件。

4. 检查包装传感器型号为 SPS30,而不是 CanAirIO CO₂ 版使用的 SCD30;确认主板确为 TTGO T-Display(非 T-Display S3)。

**完成检查**:零件型号、螺钉数量与原版 BOM 一致;SPS30 的 5 针线缆已备齐,电池外观完好。

![CanAirIO Bike 部件实拍](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/e34ca91c55864cda939a23e1f4cf383a.jpg)![CanAirIO Bike 原版组件清单图](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/a133f5fc135e4b7c92c0ab438ad222df.jpg)[官方部件表与版本说明](https://canair.io/docs/canairio_bike.html) · [SPS30 数据手册](https://sensirion.com/file/datasheet_sps30)。

选择匹配电池配置的外壳文件

目标:从当前 CanAirIO Bike 外壳文件中选出能容纳主板、传感器和本页电池配置的打印件。

1. 打开 CanAirIO 固件仓库 `box/canairio_bike_ttgo_display`;当前目录包含电池版与 `_no_battery`、磁铁、复位按键等替代 STL,并非要把所有文件都打印。按原图选电池版主壳(不要选 `display_base_no_battery.stl`、`display_body_no_battery.stl` 或 `display_magnets_no_battery.stl`),再逐一与组装图比对按键/PCB 支架版本。

2. 按 STL 原始尺寸切片并打印;原资料没有规定唯一的打印机、材料或层高,依据打印机与所用材料的安全/切片设置操作,不自行缩放配合孔位。

3. 去除边缘毛刺和打印残料,逐件检查主板固定孔、屏幕开口、按键孔和传感器进/出风通道。

4. 将主板、传感器、电池与打印件空装,检查接口能从开口接入,SPS30 气流口不被外壳遮挡。

**完成检查**:已明确选择电池版而非互斥替代件;所有选定零件空装孔位对齐、开口无堵塞,零件无裂纹。

![CanAirIO Bike 八个外壳 STL 与成品件示意](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/41fbd38f97ad4c1ba17b28e7e293bb30.jpg)[官方最新外壳文件](https://github.com/kike-canaries/canairio_firmware/tree/master/box) · [官方外壳版本提示](https://canair.io/docs/canairio_bike.html)。

安装复位按键与显示支撑

目标:先装复位按键,再把显示支架固定到屏幕周围的打印件上。

1. 断开主板 USB 与电池。辨认主板的复位/电源按键位置,把打印按键帽放在对应开关上;按压后松手,应能自行弹回。

2. 将显示支架对准屏幕边缘和两处安装孔,使用两颗 M2×6 固定,交替拧入至贴合即可,避免压弯主板或挤压屏幕。

3. 从正面确认屏幕显示区域没有被支架遮挡,复位按键没有被持续压住。

**完成检查**:支架平稳贴合、两颗 M2×6 在位,屏幕无遮挡,按键按下后可回弹。

![复位按键安装位置](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/1dff5847d951464cbdb3c20360d7139e.jpg)![TTGO T-Display 屏幕支架安装示意](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/1cf7cfcd8de546e59c6e6e602e8c126b.jpg)[原作者步骤 3–4 图文](https://hackaday.io/project/179753/instructions)。

安装按键盖并合上显示外壳

目标:将两个操作按键和屏幕盖装到主体上,同时让开关保持自由行程。

1. 按原作者图将两个打印按键帽用少量瞬干胶粘在对应位置;每次只点少量胶,等胶固化前保持按键可活动,绝不能让胶流进主板开关或屏幕。

2. 用两颗 M2×7 固定按键/显示盖;螺钉应进入已有孔位并平贴,不要用更长螺钉顶压屏幕或电路板。

3. 用四颗 M2×5 和两颗 M2×4 将图中上侧组件与盒身连接,按照片对角交替拧紧。

4. 原 BOM 还列有四颗 M2×5 和两颗 M2×4,而公开图文没有明确指出这六颗的安装位;只在原装配视频中能对应到明确孔位时才安装,若仍无法对应就先不要封闭壳体或强行拧入。

**完成检查**:盖板平贴,按键均能按下并回弹,屏幕未受压;未确认位置的螺钉留在旁边并记录,不作猜测装配。

![显示盖和按键的分步装配照片;含瞬干胶和螺钉位置](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/bad72cc6f5c041978b0a83927f2e3626.jpg)![屏幕盖在外壳上的安装方向](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/1cf7cfcd8de546e59c6e6e602e8c126b.jpg)[原作者完整装配视频](https://hackaday.io/project/179753/instructions) · [主要装配视频YouTube](https://youtu.be/V2eO1UN5u7Y) · [接线替代演示YouTube](https://youtu.be/Oarq0K0Sz3c)。

按编号辨认 SPS30 五针接口

目标:依据接口编号辨认 SPS30 的电源、I²C 数据和模式选择脚,接线前先确定传感器工作在 I²C 模式。

1. 将传感器断电并找到气流口对侧的 5 针连接器;从传感器厂商图示识别针脚 1 至 5,不要从插头背面凭左右方向猜针序。

2. 核对编号:1=VDD(5 V±10%);2=RX/SDA;3=TX/SCL;4=SEL;5=GND。

3. 本装置采用 I²C:将针 4(SEL)接地,针 2(SDA)接主板 GPIO21,针 3(SCL)接 GPIO22;针 5 接公共地。

4. 确认 SPS30 VDD 使用稳压 5 V;I²C 逻辑线连接 ESP32 前须保持在 3.3 V 逻辑范围。线材或传感器针号与图不一致时暂停,先查该传感器版本的数据手册。

**完成检查**:五个端子按 1–5 顺序标注无误,SEL 已按 I²C 要求接地,VDD 与 GND 未短接,数据线尚未带电。

![SPS30 五针连接器针序图;针 1 至针 5](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/7e5584364e1d499f936c6fa57cbeb967.jpg)[Sensirion SPS30 数据手册:I²C 模式、SEL 和针脚定义](https://sensirion.com/file/datasheet_sps30) · [CanAirIO Bike 接线资料](https://canair.io/docs/canairio_bike.html)。

依总图布线并保留传感器断开

目标:断电状态下连接主板、升压模块和传感器线束;传感器与电池保持断开,等固件启动后再测升压输出。

1. 拔掉 USB-C 并断开电池。按 CanAirIO Bike 总图,升压模块 IN+ 接主板 3V3、IN− 接主板 GND,EN 接 GPIO27;固件启动时才会控制该使能脚。确认所用模块端子确实标有 IN、OUT、EN。若模块引脚排列不符,先停下核对模块自身标识和原图,不按外形猜脚位。

2. 在断电状态布好传感器线束:SPS30 针 2 SDA 接 GPIO21、针 3 SCL 接 GPIO22;AM2320 按针脚定义接入同一 I²C 总线:SDA 到 GPIO21、SCL 到 GPIO22、GND 到公共地、VDD 用主板 3V3(AM2320 允许 3.1–5.5 V)。传感器和电池插头仍保持断开。

3. SPS30 的 SDA/SCL 为开漏信号,确认两线上各有约 10 kΩ 上拉到 3.3 V(不可上拉到 5 V),且 I²C 线尽量短于 10 cm;若板上/线束没有上拉,先补齐。逐线核对模块极性、传感器针序,并检查 GPIO21/22 与 5 V 输出之间没有短路。不要把 5 V 接入 ESP32 的 3V3、GPIO21/22 或其他 I/O。

4. 让传感器与电池继续保持断开,不要在固件启动前测量升压输出。待步骤 8 刷写并启动固件后测 OUT+/OUT−;确认约 5 V 后断电,才将 OUT+ 接 SPS30 针 1 VDD、OUT− 接 SPS30 针 5 GND并共地,SPS30 针 4 SEL 接地进入 I²C 模式;检查气流入口、出口不被遮挡。

**完成检查**:升压模块输入、EN 和信号线已逐线核对且无短路;传感器与电池保持断开,所有插拔均在断电时进行。

![CanAirIO Bike 总接线图:TTGO T-Display、升压板、SPS30 与 AM2320](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/6c37fa79cfdb4d789cd33f9c50f3d5c1.jpg)![AM2320 四针顺序与信号定义](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/41189670e39049cc896669a18dde904d.jpg)[官方 CanAirIO Bike 总图(官方提示为概略图)](https://canair.io/docs/canairio_bike.html) · [官方传感器引脚资料(标注为旧版/已弃用,针脚请优先对照元件数据手册)](https://canair.io/docs/sensors.html) · [AM2320 数据手册](https://cdn-shop.adafruit.com/product-files/3721/AM2320.pdf)。

放置电池并整理线束,暂不接入

目标:将电池放入外壳并整理线束;为刷机与升压测量,电池插头暂不接入。

1. 只使用与 TTGO T-Display 一节锂电池输入兼容的 3.7 V 电池,外形不超过原指南的 48×30×6 mm;电池应平整无鼓包、破皮、异味或异常发热。

2. 确认主板 JST 电池座的正负极定义,再用万用表核对电池插头极性;插头可插入并不代表极性一定匹配。极性标记或接头不一致时停止,不要剪插头或把裸电池线直接焊到板上。

3. 将电池放入专用空间但保持插头断开;整理线束,留出弯折余量,用绝缘热缩管包覆裸露焊点,导线不得被外壳、螺钉或按键夹住。

4. 确认锂电池充电由主板规定的单节电池充电接口完成;不要将 5 V 升压输出接到电池端或主板电池插座。

**完成检查**:电池极性、接口和尺寸均吻合,焊点绝缘且电池插头暂未接入;外壳空合时不会压线,有损伤、鼓包或发热的电池不得继续使用。

![CanAirIO Bike 电池和内部走线参考](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/88549b44d3154809b05bf800a75f6ed8.jpg)[原版电池尺寸及总图](https://canair.io/docs/canairio_bike.html) · [LILYGO T-Display 规格与单节 LiPo 接口说明](https://wiki.lilygo.cc/products/t-display-series/t-display/)。

用官方 Web Installer 刷入稳定固件

目标:给指定的 TTGO T-Display 刷入 CanAirIO 稳定版固件,并确认启动屏幕正常。

1. 在电脑安装 Chrome 或 Edge,准备可传输数据的 USB-C 线;充电专用线不能用于刷机。电池与传感器接线先保持断开,避免第一次启动时故障定位受干扰。

2. 打开 [CanAirIO Web Installer](https://canair.io/installer.html),点击 **STABLE VERSION**,而不是 **TESTING VERSION**;在浏览器串口选择器中选中刚连接的主板串口并授权连接。

3. 若串口列表没有板子,换数据线并按主板 USB-串口芯片型号安装官方页面列出的驱动;不要选其他 ESP32 板型或 CO₂ 固件。

4. 等待写入程序报告完成后断开再重连 USB,让主板重启;检查屏幕可启动并显示 CanAirIO 页面。记录安装日期、固件标识或版本信息。

5. 官方 Web Installer 说明该方式使用 ESP Web Tools,并支持 TTGO T-Display 的 CanAirIO Bike 版;稳定/测试固件具体版本会随上游更新,不在本文锁定版本号。

**完成检查**:浏览器显示刷写完成,重启后屏幕正常启动;若写入中断、屏幕黑屏或循环重启,先断电检查板型与 USB 线,不接传感器继续试错。

![CanAirIO Bike 原版快速启动示意图](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/af00902ee47942b2af094249dd14b464.jpg)![刷写前确认的 TTGO T-Display 主板参考](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/88549b44d3154809b05bf800a75f6ed8.jpg)[官方安装按钮、支持浏览器和串口驱动说明](https://canair.io/installer.html) · [CanAirIO 固件发布记录](https://github.com/kike-canaries/canairio_firmware/releases)。

09 刷机后测升压,再检查传感器并配网

目标:先确认屏幕和两种传感器工作,再用浏览器串口控制台设置 Wi-Fi;不要求先登录云端或安装手机 App。

1. 让 SPS30、AM2320 和电池保持断开,只用 USB-C 给已刷好固件的主板供电。固件启动后 GPIO27 会使能升压模块;用万用表测 OUT+/OUT− 应约为 5 V。若无 5 V,断电检查模块端子、EN 接线和固件,不接传感器继续排查。

2. 确认测得约 5 V 后断电,将传感器和电池接入:SPS30 针 1 VDD 接 5 V、针 5 GND 接公共地、针 4 SEL 接地;SPS30 针 2/3 与 AM2320 SDA/SCL 共接 GPIO21/22。复核公共地、3.3 V I²C 上拉和 SEL 接地,并保持 SPS30 气流通道畅通。

3. 重新上电。固件会为颗粒物传感器预留约 25 秒启动稳定时间,待屏幕读数刷新后记录。确认屏幕显示颗粒物与温湿度信息;通过官方 Web Installer 中的 CLI 串口控制台输入 `info` 查看设备标识,再输入 `setup` 进入配置;I²C 传感器应由固件自动检测。

4. 如需固定站联网,在 CLI 输入 `scan` 查看网络,再按提示输入 `setSSID "你的 Wi-Fi 名称"`、`setPASW "你的 Wi-Fi 密码"`,输入 `connect` 保存并连接,最后用 `status` 检查连接状态。不要把密码写进公开截图。

5. 联网前先输入 `klist` 检查 `anaireEnable`、`ifxEnable` 等云端发布项;若不选择发布,使用 `kset anaireEnable false` 和/或 `kset ifxEnable false` 关闭后再配网。若需公开固定站位置,再用 `sgeoh` 设置 Geohash;不希望公开位置时跳过该操作。

6. CanAirIO 固件仓库当前提示 Android App 暂停服务,但提供签名 APK 发布页;只有在 Android 安装并发现设备后,再按官方 Quick Start 图示的 **Pair → Record Track → Share** 流程记录移动轨迹。分享前检查定位授权和公开范围;若 App 无法安装或配对,保留屏幕本地监测路线。

**完成检查**:传感器连接前升压输出已测得约 5 V;接线后屏幕持续更新、串口 `info`/`status` 可返回信息;配网后状态显示已连接。移动轨迹只在手机实际连接并保存文件后才算完成。

![CanAirIO Bike 显示屏与外观参考](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/221c7871fcf5453ba4efa984f36a02c4.jpg)![CanAirIO Bike 原版移动与固定站指南图](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/e9a156b69e454a0f85f5763fa69c31fb.jpg)[CLI 命令和 I²C 自动检测说明](https://canair.io/docs/cli.html) · [官方 Quick Start 图(手机界面标签来自旧版图示)](https://canair.io/docs/images/canairio_bike_quick_start.jpg) · [官方签名 Android APK 发布页](https://github.com/kike-canaries/canairio_android/releases)。

比较两个安全的日常环境

目标:在不制造烟尘或暴露风险的情况下,记录设备对普通环境变化的响应。

1. 将设备放在通风、干燥且不被遮挡的位置,先在房间内静置数分钟,记录时间、地点类别、屏幕上的 PM 数值和温湿度。

2. 再将设备移到另一个正常生活环境(例如窗边与房间内),保持相近的观察时长和设备朝向,记录相同字段;不要把读数当作经过校准的绝对浓度。

3. 可用手机拍摄屏幕和场景作对照;隐去人脸、精确家庭地址和无线网络密码。不要用香烟、燃烧、喷雾、扬尘或其他人为污染源测试。

4. 首次手持步行体验即可;骑行时先设计并验证可靠的固定支架,设备和手机都应牢固收纳,骑行中不得操作手机或观察屏幕。

**完成检查**:留下两组带时间与场景说明的读数或照片,写明设备位置和通风差异;不从两组数据推导健康风险或法定达标结论。

![CanAirIO Bike 屏幕读数与外观参考](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/221c7871fcf5453ba4efa984f36a02c4.jpg)![CanAirIO Bike 记录移动环境数据的原版指南图](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/12377db9-8106-498a-90de-3a4b460f701b/files/image/e9a156b69e454a0f85f5763fa69c31fb.jpg)[原作者 CanAirIO Bike 项目与记录流程](https://hackaday.io/project/179753/instructions)。

相关科技单元