单片机与物联网 / 系统课时
接收手机指令
接收手机指令
手机向 ESP32 写入控制指令时,真正落到程序里的入口是 GATT 特征值的写回调。本课用一个可写特征值接收 LED_ON、LED_OFF 和 LED_TOGGLE,解析后直接驱动 GPIO,并通过串口确认手机写入是否被正确执行。
学习目标
- 创建支持
WRITE的 BLE 特征值并注册写回调 - 解析手机发送的文本指令并控制 LED
- 用串口和执行器状态验证写入链路
写入链路如何工作
ESP32 作为 BLE GATT Server 暴露服务和控制特征值。手机连接后对该特征值执行 Write,请求到达 onWrite();程序读取字节内容、校验命令,再更新 GPIO。通信链路中不要把“已连接”误认为“已执行”,最终还要看回调是否收到正确负载。

创建可写控制特征值
下面示例基于 Arduino-ESP32 自带 BLE 库,假设 LED 为高电平点亮并接在 GPIO 2。不同开发板的板载 LED 引脚可能不同,请按实际硬件修改 LED_PIN。
#include <Arduino.h>
#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLEUtils.h>
const uint8_t LED_PIN = 2;
const char* SERVICE_UUID = "7d2e0001-7a2b-4d7e-a8f1-2d3a4b5c6d7e";
const char* CONTROL_UUID = "7d2e0002-7a2b-4d7e-a8f1-2d3a4b5c6d7e";
bool ledOn = false;
// 统一执行器状态,避免不同命令分支重复操作 GPIO。
void applyLed(bool on) {
ledOn = on;
digitalWrite(LED_PIN, on ? HIGH : LOW);
Serial.printf("LED=%s\n", on ? "ON" : "OFF");
}
class ControlCallbacks : public BLECharacteristicCallbacks {
void onWrite(BLECharacteristic* characteristic) override {
String command = characteristic->getValue();
// 去掉手机端可能附带的空格或换行,再做精确命令匹配。
command.trim();
Serial.printf("RX: %s\n", command.c_str());
if (command == "LED_ON") {
applyLed(true);
} else if (command == "LED_OFF") {
applyLed(false);
} else if (command == "LED_TOGGLE") {
applyLed(!ledOn);
} else {
Serial.println("UNKNOWN command");
}
}
};
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
applyLed(false);
// 创建 GATT Server,并让断线后的设备重新进入可发现状态。
BLEDevice::init("ESP32-Control");
BLEServer* server = BLEDevice::createServer();
server->advertiseOnDisconnect(true);
BLEService* service = server->createService(SERVICE_UUID);
BLECharacteristic* control = service->createCharacteristic(
CONTROL_UUID,
BLECharacteristic::PROPERTY_WRITE
);
control->setCallbacks(new ControlCallbacks());
service->start();
BLEAdvertising* advertising = BLEDevice::getAdvertising();
advertising->addServiceUUID(SERVICE_UUID);
BLEDevice::startAdvertising();
Serial.println("BLE ready: write LED_ON / LED_OFF / LED_TOGGLE");
}
void loop() {
delay(100);
}预期输出:手机连接后向控制特征值写入 LED_ON,串口应出现以下内容,同时 LED 点亮。
LED=OFF
BLE ready: write LED_ON / LED_OFF / LED_TOGGLE
RX: LED_ON
LED=ON用手机验证写入
使用任意支持 BLE GATT 的手机客户端即可验证,不依赖特定 App。扫描并连接 ESP32-Control,找到服务 UUID 7d2e0001-7a2b-4d7e-a8f1-2d3a4b5c6d7e,再向控制特征值 UUID 7d2e0002-7a2b-4d7e-a8f1-2d3a4b5c6d7e 写入 UTF-8 文本 LED_ON。
继续写入 LED_OFF 和 LED_TOGGLE,应分别看到 LED 熄灭和状态翻转。若串口出现 UNKNOWN command,先检查手机发送的是文本而不是十六进制字节,并确认没有多余字符;示例中的 trim() 会去掉首尾空白,但不会自动忽略大小写差异。
控制指令的边界
控制执行器时应把“协议解析”和“硬件动作”分开:先判断命令是否合法,再改变 GPIO。生产设备还需要考虑身份认证、命令权限、超时和幂等性,避免任何已连接客户端都能直接控制关键执行器。对于电机、继电器等负载,还应加入硬件级保护,不能只依赖 BLE 指令本身。