ESP32+MicroPython+Phyphox：自制外挂温度传感器指南

简介：面向物联网与物理实验教学场景，这份资源将ESP32微控制器的MicroPython固件与Phyphox扩展库整合在一起，适合嵌入式开发者、创客及高校师生快速上手。固件版本为20220618-v1.19.1，可直接烧录；配套的Python脚本涵盖蓝牙BLE通信、实验创建、随机数生成、手机端数据获取等模块，为自定义物理实验提供了现成框架。压缩包共8个文件，包含1个bin固件和7个py脚本，整体仅969KB，部署轻量、结构清晰。目前已有1000人学习下载。借助这套工具，用户能编写MicroPython程序驱动ESP32读取各类传感器、控制外设，并通过无线网络或蓝牙与Phyphox联动，实现实时数据展示、远程控制、信号处理和多设备通信，适合课堂演示、课程设计或科创项目落地。例如在物理课堂中，学生可用ESP32采集温度、加速度等数据，并同步到手机Phyphox图表中，直观呈现实验曲线，大幅降低实验门槛，让抽象原理变得可触可感。 先说个场景：你手里刚好有一块吃灰的ESP32，手机上又装了Phyphox这个物理实验App，那你离一个“能测温度、照度、距离的外挂传感器盒子”其实只差两步——刷一套MicroPython固件，再塞一个phyphox的MicroPython库。Phyphox本身很能打，手机内置的加速度计、陀螺仪、磁力计、气压计、麦克风都能直接做实验，可它管不了手机外面的事。想测水温变化、教室不同位置的光照差异、或者一个保温杯的散热曲线，手机内置传感器就无能为力了。这正是ESP32加MicroPython加Phyphox这套组合的用武之地：ESP32负责采集外部传感器数据，通过蓝牙BLE发给手机，Phyphox负责把数据变成实时曲线、表格和可导出的实验记录。这篇文章我会把固件烧录、库文件移植、首个温度实验跑通，以及联调中的坑完整走一遍，适合物理老师、创客和想给实验室省钱的工科生参考。

1. 这套组合到底解决了什么问题

1.1 手机传感器的天花板在哪

Phyphox这类App最大的优势是零成本、零接线，打开手机就能用加速度计做单摆实验、用声学秒表测反应时间。但它有个绕不过去的天花板：传感器种类固定在那，精度也是手机级别。你想测铂电阻的阻值变化、热电偶的温度漂移、光敏电阻在不同遮光条件下的输出电压，手机一个都干不了。更现实的问题在课堂场景里——手机不可能放到沸腾的水杯旁边，也不可能埋进沙堆里测温度。

外部采集设备加手机显示的分离式架构是刚需。市面上确实有现成的蓝牙数据采集器，但一个通道动辄几百上千，而且软件封闭，没法按实验需求自定义采样率和图表。自己用ESP32搭一个，成本能压到几十块钱，数据格式、采样频率、传感器类型全是自己说了算。这个“自己说了算”在实验教学里特别重要，学生能直视数据链路的每一个环节，而不是面对一个黑盒子。

1.2 为什么偏偏是ESP32加MicroPython

选ESP32而不是Arduino Uno或树莓派Zero，理由很直接。Arduino Uno跑C++，想实现BLE GATT服务得翻一堆库文档，还得处理回调、缓冲区、协议栈初始化，大多数人不具备这个精力；树莓派Zero W虽然能跑完整Linux，可启动时间、体积、功耗和价格都不占优势。ESP32自带Wi-Fi和经典蓝牙/BLE，双核240MHz，价格二十多块起，是“传感器采集加无线传输”这个场景里性价比最极端的选择。

固件和开发方式同样关键。MicroPython直接在芯片上跑Python解释器，不需要编译，串口连上就是>>>提示符，写个循环就能读传感器、发蓝牙。这对非嵌入式专业的老师、学生尤其友好：先关注实验逻辑，而不是花两周学配置工程。ESP32的MicroPython固件是官方长期维护的，onewire、ds18x20、bluetooth这些驱动模块都编译在固件里，不用自己装环境。最典型的替代方案是树莓派Pico W，也能跑MicroPython，但论BLE资料数量、社区的现成案例、以及Phyphox相关的现成库，ESP32生态明显更丰富。

2. 给ESP32刷MicroPython固件

2.1 先弄清楚你手上是哪块板子

ESP32是个大家族，不同型号对刷机的影响不小。经典款ESP32（芯片型号通常是ESP32-D0WD-V3）资料最全，MicroPython官方固件直接支持，BLE协议栈稳定，是玩Phyphox最稳妥的选择。ESP32-S3性能更强、支持USB原生烧录，但BLE行为和老款有些差异，部分Phyphox场景反而要多调。ESP32-C3是RISC-V单核，便宜省电，但性能弱一些，跑高采样率时会吃力。第一次搭这套方案，我建议直接用经典ESP32开发板，比如NodeMCU-32S或ESP32-DevKitC，避开选型带来的额外变量。

固件下载要去MicroPython官网的download页面，找到ESP32分类。页面上会有类似ESP32_GENERIC、ESP32_GENERIC-SPIRAM这样的选项，如果你的板子带8MB PSRAM可以选择SPIRAM版；不确定就选不带SPIRAM的通用版，功能完全够用。固件文件名类似ESP32_GENERIC-20240602-v1.23.0.bin，v是MicroPython版本号，日期是构建日期。如果后续phyphox库有版本要求，比如要求MicroPython 1.20以上，你对号选一个比要求更新的就行。

2.2 刷机命令和最容易翻车的细节

刷机前先确认电脑能识别到板子。ESP32开发板上的USB转串口芯片常见的是CP2102和CH340，Windows系统经常不能自动识别CH340，需要手动装驱动。设备管理器里看到类似COM3的串口号，或者macOS/Linux下出现/dev/ttyUSB0、/dev/cu.usbserial-xxx，才能进入下一步。

然后安装esptool，这是乐鑫官方的烧录工具，用pip装：

pip install esptool

接着擦除整颗Flash，避免旧固件残留导致MicroPython启动异常：

python -m esptool --port COM3 erase_flash

擦除完成后烧录之前下载的固件，注意这里的0x1000是ESP32的引导程序固定偏移地址，不能改：

python -m esptool --chip esp32 --port COM3 --baud 460800 write_flash -z 0x1000 ESP32_GENERIC-20240602-v1.23.0.bin

烧录失败非常常见，大部分情况是三个原因：一是数据线只能充电不能传数据，换线解决；二是Windows下驱动没装好，设备管理器里连串口都没有；三是板子进入了下载模式异常状态，这时候按住开发板上的BOOT键，再插USB，上电瞬间松开BOOT，基本就能刷进去了。

2.3 第一次进入REPL验证固件

烧录完随手验证一下，别急着写代码。推荐用Thonny，它内置MicroPython支持，打开“运行”菜单选择“配置解释器”，解释器选MicroPython(ESP32)，端口选刚才那个串口号。连接成功后，Shell窗口出现>>>，说明固件已经跑起来了，可以先执行一行代码确认版本：

import sys print(sys.implementation)

正常会输出MicroPython的版本信息。如果出现乱码或反复重启，大概率是固件和板子型号不匹配，或者擦除不彻底，回炉再刷一次。

文件传输有两种方式。Thonny左侧“文件”视图可以直接把电脑上的文件拖到ESP32的/lib目录；命令行用户用mpremote更顺手：

pip install mpremote mpremote connect /dev/ttyUSB0 cp phyphox.py : mpremote reset

注意库文件放/lib目录而不是根目录，MicroPython导入包时会优先搜索/lib，这也方便后续管理多个模块。

3. 让ESP32变成Phyphox的外挂传感器

3.1 先搞懂Phyphox和外部设备怎么通信

Phyphox App本身支持连接蓝牙BLE设备。在标准BLE架构里，ESP32是外设端（GATT Server），手机是中心端（GATT Client）。ESP32上跑一个BLE服务，服务里包含若干个特征值，数据就是通过特征值传给手机的。但直接用MicroPython的bluetooth模块手搓GATT服务，你得自己写UUID、配通知开关、处理MTU，非常繁琐，而且Phyphox端还要手动指定服务UUID和特征UUID，两边对不上就白搭。

Phyphox实验文件机制其实是关键。一个.phyphox文件本质是一个ZIP压缩包，里面核心是experiment.json，它描述了实验名称、数据通道、坐标轴、图表布局，以及“数据从哪里来”——如果实验数据来自外部BLE设备，JSON里就写着蓝牙服务UUID、特征UUID、数据格式和通道映射。也就是说，ESP32端要发的数据结构和手机端要收的数据结构，最终必须通过UUID体系精准对接。

这就是phyphox的MicroPython库存在的意义。它不是Phyphox官方App的一部分，而是社区和官方仓库维护的一套MicroPython代码，把“创建BLE GATT Server、广播服务、按Phyphox约定的格式推送数据”全部封装成简单函数。你不需要理解UUID和GATT目录结构，只需要告诉库：“我有一个温度值要发”，库负责把数据塞进对应的BLE特征值里并通知手机。理解这个封装逻辑后，后续自己改通道、加传感器就不会懵。

3.2 把phyphox库装进ESP32

在GitHub搜phyphox加micropython关键词，能找到官方或社区维护的库仓库，下载后一般会有一个phyphox.py文件，可能还带examples目录。把phyphox.py传到开发板的/lib目录下。库的文件名和所在目录保持统一，导入时不踩坑。

然后在REPL里执行：

import phyphox

不报错就是装好了。如果报ModuleNotFoundError，先确认是否传到了/lib，再确认文件名拼写和版本分支是否匹配。如果你下载的库要求MicroPython版本高于当前固件版本，就重新刷一版新固件。

这个库的API不同版本会略有差别，我用的时候会先打开仓库里的examples目录看一遍README再动手，比自己瞎试快很多。核心用法大同小异，无非是“创建实验对象，注册通道，循环写数据”这三步。

3.3 一次跑通：DS18B20温度传感器上传

温度实验是验证整条链路最合适的起点，传感器便宜、接线简单、数据直观。DS18B20是单总线数字温度传感器，三个引脚：VCC接3.3V，GND接GND，DQ数据线接GPIO4。注意DQ和VCC之间要接一个4.7kΩ上拉电阻，不然温度读数会异常甚至读不到。

完整代码思路如下，具体的类和函数名以你下载的库版本为准：

import machine import onewire import ds18x20 import time import phyphox # 创建Phyphox实验对象，name是BLE广播名称 exp = phyphox.Experiment(name="ESP32-Temp") # 注册一个温度通道，单位摄氏度 exp.add_channel("temperature", phyphox.TYPE_FLOAT) # 初始化DS18B20 ow = onewire.OneWire(machine.Pin(4)) ds = ds18x20.DS18X20(ow) roms = ds.scan() print("DS18B20 found:", roms) while True: ds.convert_temp() time.sleep_ms(750) if roms: temp = ds.read_temp(roms[0]) print("temp:", temp) exp.write("temperature", temp) time.sleep_ms(250)

整体逻辑是：创建实验对象并注册通道，初始化DS18B20传感器，然后循环采集数据写入通道。print保留着很有用，可以快速判断当前温度到底采集到没有。跑起来后，用手机扫描蓝牙设备，应该能看到一个名为ESP32-Temp的设备。如果DS18B20没接好，串口会一直打日志但温度值异常，能帮你快速定位问题出在采集端还是蓝牙端。

4. 手机端配置和数据可视化

4.1 在Phyphox里添加自制BLE设备

手机端配置才是这套方案真正打通的关键。Phyphox添加外部设备有两条路：第一种是导入实验文件。如果phyphox的MicroPython库仓库里带了对应的.phyphox文件，直接把这个文件传到手机，用Phyphox打开，App会自动加载实验界面，并按文件里写好的UUID连接ESP32。这种方式最省事，通道和图表都现成。

第二种是手动添加。如果仓库没给实验文件，或者你想自定义，可以在Phyphox里新建/编辑实验，通过蓝牙设置指定设备的服务UUID、特征UUID和通道映射。这要求ESP32端和手机端填的UUID完全一致，错一位就连接不上。手填UUID一定以ESP32端代码实际定义的为准，别靠猜。

Android手机扫描BLE需要开启定位权限，不是App故意要定位，而是Android系统规定BLE扫描必须伴随位置权限。如果手机一直扫不到设备，去设置里把Phyphox的定位权限打开，再扫描一次。

4.2 数据链路调通后，如何提高效率

如果第一次连上发现数据不动或图表空白，第一步不是怀疑蓝牙，而是看ESP32的串口日志。如果串口温度在正常刷新，说明问题出在BLE或Phyphox配置；如果串口都没数据，就去查传感器接线。日志加蓝牙双路输出这个习惯，帮我省了大量排查时间。

采样间隔调到1秒起步把链路跑通，再加大采样率。BLE传输在不开启流控的情况下，吞吐量有限，温度实验1秒一次已经足够看趋势；如果做声学或震动实验，就要确认数据包长度、发送频率和手机端绘图性能，高采样率下被缓冲区吃掉数据太常见了。

连接不上或者连接后自动断开，先到手机蓝牙设置里把之前配对过的同名设备删掉。Phyphox连接BLE设备后会记住设备MAC地址，ESP32端代码改过广播名称后再连接，旧配对信息常常造成“能扫到但连不上”的假象。数据线和供电也要留意，DS18B20对电压波动不敏感，但ESP32供电不稳会导致蓝牙广播异常，直接用USB供电比电池供电省心。

5. 常见问题和排查技巧实录

5.1 问题速查表

5.2 几个让我记忆深刻的坑

第一个坑是DS18B20的85℃。第一版代码跑起来，手机图表上稳稳显示85.00℃，我开始以为是Phyphox配置问题，折腾了半天。后来串口打日志，发现串口输出也是85℃，才意识到传感器电路有问题。DS18B20上电时寄存器默认输出85℃，如果读取时序不对或传感器未正确响应，就会保持这个值。这个“逻辑陷阱”特别容易让人误判成软件问题，排查时先看串口能少走很多弯路。

第二个坑是设备名冲突。我手上有两块ESP32，都刷了同一份代码，广播名全是ESP32-Temp。手机Phyphox总是自动连到其中一个，另一块怎么扫都“连不上”。当时一度以为是库的BLE状态机有问题，后来在蓝牙设置里删掉旧设备、把其中一块改成不同广播名，彻底解决。多设备调试时，广播名加个后缀，省得自己坑自己。

第三个坑是库版本与固件版本不匹配。有一次从仓库拉了一个新版本phyphox库，往旧固件的ESP32上一放，导入直接报语法错误，因为新库用了老固件不支持的Python语法特性。这种问题看报错信息其实很明显，但我当时习惯性以为是文件传输损坏。遇到类似情况，优先确认固件MicroPython版本是否满足库的要求，直接刷最新稳定版固件通常能兜底。

最后分享一点个人体会

我拿这套组合给学生做过“教室热岛效应”实验，把三块ESP32分别放在窗边、走廊和讲台，每块接一个DS18B20，手机端用Phyphox同时开三个实验界面，一节课下来，三条温度曲线的差异直接投到屏幕上，比任何PPT讲解都直观。这套方案的价值不在于替代专业采集器，而在于它足够开放、足够便宜，能让学生真正理解“数据是怎么从传感器跑到手机图表里的”。如果你准备开始折腾，建议从最简单的DS18B20温度实验入手，跑通后再扩展光照、距离、湿度这些传感器。之后给它加个锂电池、开启休眠模式，还能变成低功耗的长时间环境记录仪。过程中卡住了，把串口日志贴出来一起讨论，比自己埋头试要快得多。

本文还有配套的精品资源，点击获取