单片机与物联网 / 系统课时

接收手机指令

接收手机指令

手机向 ESP32 写入控制指令时,真正落到程序里的入口是 GATT 特征值的写回调。本课用一个可写特征值接收 LED_ON、LED_OFF 和 LED_TOGGLE,解析后直接驱动 GPIO,并通过串口确认手机写入是否被正确执行。

学习目标

  • 创建支持 WRITE 的 BLE 特征值并注册写回调
  • 解析手机发送的文本指令并控制 LED
  • 用串口和执行器状态验证写入链路

写入链路如何工作

ESP32 作为 BLE GATT Server 暴露服务和控制特征值。手机连接后对该特征值执行 Write,请求到达 onWrite();程序读取字节内容、校验命令,再更新 GPIO。通信链路中不要把“已连接”误认为“已执行”,最终还要看回调是否收到正确负载。

手机写入指令到 LED 的处理链路

创建可写控制特征值

下面示例基于 Arduino-ESP32 自带 BLE 库,假设 LED 为高电平点亮并接在 GPIO 2。不同开发板的板载 LED 引脚可能不同,请按实际硬件修改 LED_PIN。

cpp
#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 点亮。

text
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 指令本身。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接收手机指令

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通