从零构建ESP32-C3蓝牙气象站：MicroPython与uBluetooth的实战指南
1. 项目概述与硬件准备
在物联网和智能硬件快速发展的今天，ESP32-C3凭借其出色的性能和丰富的功能，成为创客和开发者的热门选择。这款基于RISC-V架构的微控制器不仅支持Wi-Fi连接，还内置了蓝牙低功耗（BLE）功能，非常适合构建各种无线传感设备。本文将带您从零开始，使用MicroPython和uBluetooth库开发一个完整的蓝牙气象站项目，能够实时监测并传输环境温湿度数据。
所需硬件组件清单：
- ESP32-C3开发板（推荐型号及核心参数对比）：
| 型号 | 处理器 | 闪存 | SRAM | 蓝牙版本 | 特色功能 |
|---|---|---|---|---|---|
| 官方ESP32-C3 | RISC-V 160MHz | 4MB | 400KB | BLE 5.0 | 完善开发支持 |
| Seeed XIAO ESP32C3 | RISC-V 160MHz | 4MB | 400KB | BLE 5.0 | 超小尺寸设计 |
| ESP32-C3 SuperMini | RISC-V 160MHz | 4MB | 400KB | BLE 5.0 | 高性价比 |
- 温湿度传感器（DHT22或BME280）
- 面包板及连接线
- USB Type-C数据线（需支持数据传输）
- 可选：锂电池供电模块（实现移动监测）
提示：选择开发板时需注意GPIO引脚布局，确保与传感器兼容。XIAO ESP32C3等紧凑型板卡可能需要转接板。
2. MicroPython环境配置
在开始编码前，需要为ESP32-C3刷入MicroPython固件并配置开发环境：
- 固件刷写步骤：
# 使用esptool刷写固件（需提前安装Python环境） esptool.py --chip esp32c3 --port /dev/ttyUSB0 erase_flash esptool.py --chip esp32c3 --port /dev/ttyUSB0 \ --baud 460800 write_flash -z 0x0 micropython-firmware.bin开发工具选择：
- Thonny IDE（初学者友好，内置REPL）
- VS Code + Pymakr插件（高级功能支持）
- Mu Editor（轻量级选择）
基础库安装：
import upip upip.install('micropython-ubluetooth') upip.install('micropython-dht')3. BLE服务架构设计
蓝牙气象站的核心是构建符合BLE规范的服务架构。我们需要设计一个自定义服务，包含温湿度数据的特征值：
服务UUID规划：
- 主服务：
0000181A-0000-1000-8000-00805F9B34FB（Environmental Sensing） - 温度特征：
00002A6E-0000-1000-8000-00805F9B34FB（可读、可通知） - 湿度特征：
00002A6F-0000-1000-8000-00805F9B34FB（可读、可通知）
服务注册代码框架：
from micropython import const import ubluetooth # 事件常量定义 _IRQ_CENTRAL_CONNECT = const(1) _IRQ_CENTRAL_DISCONNECT = const(2) _IRQ_GATTS_WRITE = const(3) # UUID定义 ENV_SERVICE_UUID = ubluetooth.UUID('0000181A-0000-1000-8000-00805F9B34FB') TEMP_CHAR_UUID = ubluetooth.UUID('00002A6E-0000-1000-8000-00805F9B34FB') HUMID_CHAR_UUID = ubluetooth.UUID('00002A6F-0000-1000-8000-00805F9B34FB') # 服务定义 env_service = ( ENV_SERVICE_UUID, ( (TEMP_CHAR_UUID, ubluetooth.FLAG_READ | ubluetooth.FLAG_NOTIFY), (HUMID_CHAR_UUID, ubluetooth.FLAG_READ | ubluetooth.FLAG_NOTIFY), ), )4. 传感器数据采集与处理
选择适当的传感器并实现数据采集是项目的关键环节。以下是两种常见传感器的实现方案：
DHT22实现方案：
from machine import Pin import dht import time class DHT22Reader: def __init__(self, pin_num): self.sensor = dht.DHT22(Pin(pin_num)) def read(self): try: self.sensor.measure() return { 'temp': self.sensor.temperature(), 'humidity': self.sensor.humidity() } except Exception as e: print("Sensor read error:", e) return None # 使用示例 dht22 = DHT22Reader(5) data = dht22.read()BME280实现方案（精度更高）：
from machine import I2C, Pin import bme280 class BME280Reader: def __init__(self, sda_pin=8, scl_pin=9): i2c = I2C(0, sda=Pin(sda_pin), scl=Pin(scl_pin)) self.sensor = bme280.BME280(i2c=i2c) def read(self): try: temp, press, hum = self.sensor.read_compensated_data() return { 'temp': temp/100, 'humidity': hum/1024 } except Exception as e: print("Sensor read error:", e) return None注意：BME280需要额外安装驱动库，可通过
upip.install('micropython-bme280')获取。
5. 蓝牙通信全实现
将传感器数据通过BLE服务发布需要完整的蓝牙栈实现：
完整BLE服务类：
class WeatherStationBLE: def __init__(self, name="ESP32-Weather"): self.ble = ubluetooth.BLE() self.ble.active(True) self.ble.irq(self._irq_handler) self._setup_service() self._advertise(name) # 存储连接状态和客户端信息 self._conn_handle = None self._temp_handle = None self._humid_handle = None def _setup_service(self): services = (env_service,) ((temp_handle, humid_handle),) = self.ble.gatts_register_services(services) self._temp_handle = temp_handle self._humid_handle = humid_handle # 设置特征值初始数据 self.ble.gatts_write(temp_handle, b'\x00\x00') # 初始温度0.0 self.ble.gatts_write(humid_handle, b'\x00\x00') # 初始湿度0.0 def _advertise(self, name): # 构建广播数据包 adv_data = bytearray() adv_data.append(0x02) # Flags长度 adv_data.append(0x01) # Flags类型 adv_data.append(0x06) # 通用可发现模式 # 添加设备名称 name_bytes = name.encode('UTF-8') adv_data.append(len(name_bytes) + 1) adv_data.append(0x09) # 完整设备名称类型 adv_data.extend(name_bytes) self.ble.gap_advertise(100_000, adv_data=adv_data) def _irq_handler(self, event, data): if event == _IRQ_CENTRAL_CONNECT: self._conn_handle, _ = data print("Device connected") elif event == _IRQ_CENTRAL_DISCONNECT: self._conn_handle = None print("Device disconnected") self._advertise("ESP32-Weather") # 重新广播 def update_data(self, temp, humidity): """更新传感器数据并通知已连接的客户端""" if self._conn_handle is not None: # 将浮点数转换为16位整数（精度0.01） temp_data = int(temp * 100).to_bytes(2, 'little') humid_data = int(humidity * 100).to_bytes(2, 'little') self.ble.gatts_write(self._temp_handle, temp_data) self.ble.gatts_write(self._humid_handle, humid_data) # 发送通知 self.ble.gatts_notify(self._conn_handle, self._temp_handle) self.ble.gatts_notify(self._conn_handle, self._humid_handle)6. 移动端数据接收方案
完成设备端开发后，需要配套的手机应用来接收和显示数据。以下是Android平台的实现要点：
关键实现步骤：
- 在AndroidManifest.xml中添加蓝牙权限：
<uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>- 服务发现代码片段：
private void discoverServices() { BluetoothGattService envService = gatt.getService( UUID.fromString("0000181A-0000-1000-8000-00805F9B34FB")); if (envService != null) { BluetoothGattCharacteristic tempChar = envService.getCharacteristic( UUID.fromString("00002A6E-0000-1000-8000-00805F9B34FB")); BluetoothGattCharacteristic humidChar = envService.getCharacteristic( UUID.fromString("00002A6F-0000-1000-8000-00805F9B34FB")); gatt.setCharacteristicNotification(tempChar, true); gatt.setCharacteristicNotification(humidChar, true); } }- 数据解析示例（Java）：
private float parseTemperature(byte[] value) { int raw = (value[1] << 8) | (value[0] & 0xFF); return raw / 100.0f; }对于快速测试，可以使用现成的BLE调试工具：
- 推荐APP：nRF Connect、BLE Scanner
- 数据查看技巧：选择"Show as signed integer"查看温度数据
7. 电源优化与部署实践
实际部署时需要考虑电源管理以延长设备续航：
低功耗策略实现：
import machine from micropython import const # 深度睡眠唤醒常量 DEEP_SLEEP_TIME = const(5*60*1000) # 5分钟 def go_to_sleep(): # 配置唤醒源（可选定时唤醒或外部引脚唤醒） machine.deepsleep(DEEP_SLEEP_TIME) # 在主循环中添加条件判断 if battery_level < 20: ble.send_low_battery_alert() go_to_sleep()功耗对比数据：
| 工作模式 | 平均电流 | 估算续航（1000mAh电池） |
|---|---|---|
| 持续工作 | 45mA | 22小时 |
| 10秒间隔 | 15mA | 66小时 |
| 深度睡眠 | 50μA | 833天 |
实际项目中，我发现在使用BME280传感器时，添加适当的延迟能显著降低功耗：
def read_sensor(): sensor.wake() # 唤醒传感器 time.sleep_ms(50) # 等待稳定 data = sensor.read() sensor.sleep() # 使传感器进入低功耗模式 return data8. 进阶优化与问题排查
开发过程中可能会遇到以下典型问题及解决方案：
常见问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 蓝牙无法连接 | 服务注册失败 | 检查UUID格式和权限标志 |
| 数据更新延迟 | 通知间隔过长 | 调整gatts_notify调用频率 |
| 手机收不到数据 | 未启用通知 | 在客户端调用setCharacteristicNotification |
| 频繁断开连接 | 信号干扰 | 检查天线布局，避免金属屏蔽 |
性能优化技巧：
- 使用
ble.gatts_set_buffer()增加特征值缓冲区大小 - 合并温湿度数据到单个特征值减少通信次数
- 实现数据压缩算法（如Delta编码）
扩展功能建议：
- 添加历史数据记录功能
- 实现多设备组网
- 增加Wi-Fi双模传输作为备份
完整项目代码和电路图已托管在GitHub，包含详细的注释和测试案例。通过这个项目，您不仅掌握了ESP32-C3的BLE开发，还构建了一个可扩展的物联网设备框架，可以轻松适配其他传感器类型和应用场景。
