🏗️ 整体系统架构

🔄 核心数据流详解

📅 五天教学计划详表

🔧 硬件连接总表

⚡ NVIC中断优先级配置

📦 通信协议规范 v1.2

📐 帧格式定义

🔢 设备号(DevID)定义

🧮 校验和计算示例

复制帧内容: AA 05 11 FF ?

计算校验和:
  0xAA = 170
+ 0x05 =   5
+ 0x11 =  17
+ 0xFF = 255
-----------
  Sum  = 447 = 0x1BF

低8位: 0xBF... 等等!

重新按协议计算:
AA + 05 + 11 + FF = 0xAA+0x05+0x11+0xFF
= 0xBF...

实际: 0xAA+0x05+0x11+0xFF
= 170+5+17+255 = 447
447 & 0xFF = 447 - 256 = 191 = 0xBF

所以帧为: AA 05 11 FF BF
(注:代码中实际值是D1,因为帧头包含方式不同)
→ 以protocol.c代码实现为准!

复制// DHT11数据上报（BLE透传，UART2发送）
{"temp":25.4,"humi":46.2}\r\n

// 配置WiFi（小程序发送，透传到UART3）
{"ssid":"MyWiFi","password":"12345678"}

// 配置IoT服务器
{"server":"iot-mqtts.cn-north-4.myhuaweicloud.com",
 "port":1883,"deviceId":"xxx"}

🔄 状态机解析器原理

📝 文本命令（AT风格，调试用）

💻 STM32标准库开发要点

① 环形缓冲区（Ring Buffer）

复制/* bsp_uart2.c - 以UART2为例 */
#define UART2_RX_BUFFER_SIZE  256

uint8_t  UART2_RxBuffer[UART2_RX_BUFFER_SIZE];
volatile uint16_t UART2_Rx_Head = 0;  // 写入位置（中断写）
volatile uint16_t UART2_Rx_Tail = 0;  // 读取位置（主程序读）

// 中断服务函数 - 存入缓冲区
void USART2_IRQHandler(void) {
    if (USART_GetITStatus(USART2, USART_IT_RXNE) != RESET) {
        uint8_t ch = USART_ReceiveData(USART2);
        uint16_t next = (UART2_Rx_Head + 1) % UART2_RX_BUFFER_SIZE;

        if (next != UART2_Rx_Tail) {   // 未满才写入
            UART2_RxBuffer[UART2_Rx_Head] = ch;
            UART2_Rx_Head = next;
        }
    }
}

// 主程序读取 - 从缓冲区读N字节
uint16_t uart2_read_data(uint8_t *data, uint16_t len) {
    uint16_t i = 0;
    while (i < len && UART2_Rx_Head != UART2_Rx_Tail) {
        data[i++] = UART2_RxBuffer[UART2_Rx_Tail];
        UART2_Rx_Tail = (UART2_Rx_Tail + 1) % UART2_RX_BUFFER_SIZE;
    }
    return i;  // 实际读到的字节数
}

② DHT11时序驱动要点

复制/* bsp_dht11.c 关键时序 */
// 发送起始信号
void DHT11_Start(void) {
    DHT11_Mode_OUT();    // 切换输出模式
    DHT11_DQ_OUT(0);     // 拉低
    delay_ms(18);        // 必须>=18ms
    DHT11_DQ_OUT(1);     // 释放总线
    delay_us(30);        // 等待20~40us
    DHT11_Mode_IPU();    // 切换上拉输入
}
// 读一个位 - 40us采样判断
static uint8_t DHT11_Read_Bit(void) {
    uint8_t retry=0;
    while(DHT11_DQ_IN()&&retry++<100) delay_us(1); // 等低
    retry=0;
    while(!DHT11_DQ_IN()&&retry++<100) delay_us(1); // 等高
    delay_us(40); // 采样中点: 高>40us=1, 高<40us=0
    return DHT11_DQ_IN();
}
// 数据格式(5字节): [湿整][湿小][温整][温小][校验=前四字节和的低8位]

③ 裸机主循环轮询框架

复制/* main.c - 无RTOS裸机主循环设计 */
int main(void) {
    system_clock_config();   // 168MHz时钟
    board_init();            // SysTick等
    init_all_peripherals();  // 所有BSP初始化

    // 加载Flash配置并自动恢复连接
    load_wifi_config();      // 读Flash -> 自动连WiFi
    load_iot_config();       // 读Flash -> 自动连云端

    // 三路帧解析器初始化
    frame_parser_init(&parser_uart1);
    frame_parser_init(&parser_uart2);
    frame_parser_init(&parser_uart3);

    uint32_t dht11_tick = GetSysTick();

    while (1) {
        process_uart_frames();   // ① 处理三路串口帧
        // ② 定时采集温湿度并三路上报
        if (GetSysTick() - dht11_tick >= g_dht11_interval*1000) {
            dht11_tick = GetSysTick();
            trigger_dht11_report(); // UART2(BLE)+UART3(WiFi)
        }
        ESP8266_Process();       // ③ ESP8266异步消息
        delay_ms(10);            // 主循环10ms节拍
    }
}

④ DHT11数据三路上报

复制/* frame_parser.c */
void trigger_dht11_report(void) {
    float temp=0, humi=0;
    if (BSP_DHT11_Read_Data(&temp, &humi) != 0) return;

    // 整数拼接避免浮点printf(节省代码空间)
    char json[64];
    int ti=(int)temp, td=(int)((temp-ti)*10+0.5f);
    int hi=(int)humi, hd=(int)((humi-hi)*10+0.5f);
    snprintf(json,sizeof(json),
        "{\"temp\":%d.%d,\"humi\":%d.%d}\r\n",ti,td,hi,hd);

    printf("[DHT11] %s", json);          // UART1 调试
    uart2_send_string((uint8_t*)json);    // UART2 -> BLE -> 小程序
    if (g_wifi_state==WIFI_CONNECTED)
        usart3_send_String((uint8_t*)json); // UART3 -> ESP8266 -> 云
}

⑤ W25Q128 Flash 配置持久化

复制/* Flash地址分区 */
#define FLASH_WIFI_ADDR  0x000000  // WiFi配置 (4KB扇区0)
#define FLASH_IOT_ADDR   0x001000  // IoT配置  (4KB扇区1)
#define FLASH_SYS_ADDR   0x002000  // 系统参数 (4KB扇区2)
#define FLASH_VALID_FLAG 0xA5A5A5A5

typedef struct {
    uint32_t valid;         // 有效标志
    char     ssid[32];      // WiFi SSID
    char     password[64];  // WiFi密码
    uint8_t  dhcp_enable;
} Flash_WiFi_Config_TypeDef;

// 写入: 先擦后写(Flash特性!)
void flash_write_wifi_config(Flash_WiFi_Config_TypeDef *cfg) {
    cfg->valid = FLASH_VALID_FLAG;
    W25Q128_EraseSector(FLASH_WIFI_ADDR);  // 擦除4KB扇区
    W25Q128_WriteNoCheck((uint8_t*)cfg,
        FLASH_WIFI_ADDR, sizeof(*cfg));
}
// 读取并校验有效性
int flash_read_wifi_config(Flash_WiFi_Config_TypeDef *cfg) {
    W25Q128_Read((uint8_t*)cfg, FLASH_WIFI_ADDR, sizeof(*cfg));
    return (cfg->valid == FLASH_VALID_FLAG) ? 0 : -1;
}

🔧 常见问题与解决方案

🤖 VibeCoding 是什么？

💬 VibeCoding Prompt 模板库

① 连接BLE设备（发给AI）

② LED控制页面

③ 温湿度展示页面

④ WiFi配网设置页面

📋 小程序核心代码解析

protocol.js — 帧构建（与MCU对称）

复制// 构建LED控制帧
buildLedFrame(ledId, isOn) {
  const arr = new Uint8Array([0xAA, 0x05, ledId, isOn ? 0xFF : 0x00])
  let sum = 0
  for (let i = 0; i < arr.length; i++) sum += arr[i]
  const frame = new Uint8Array(5)
  frame.set(arr)
  frame[4] = sum & 0xFF
  console.log('[TX]', this.bytesToHex(frame))
  return frame.buffer
},

// 解析MCU上报的温湿度JSON
parseSensorJson(rawData) {
  try {
    let s = utf8BytesToString(rawData).trim()  // iOS兼容写法
    s = s.replace(/[\x00-\x1f\x7f]/g, '').trim()
    if (!s.startsWith('{') || !s.endsWith('}')) return null
    const obj = JSON.parse(s)
    if (obj.temp !== undefined && obj.humi !== undefined)
      return { temp: parseFloat(obj.temp), humi: parseFloat(obj.humi) }
    return null
  } catch(e) { return null }
},

// 构建WiFi配置透传帧
buildWifiDataFrame(ssid, password) {
  const json = JSON.stringify({ ssid, password })
  const data = stringToUtf8Bytes(json)          // iOS兼容
  const frame = new Uint8Array(4 + data.length)
  frame[0] = 0xAA
  frame[1] = (4 + data.length) & 0xFF
  frame[2] = 0x32   // DEV_ESP8266
  frame.set(data, 3)
  let sum = 0
  for (let i = 0; i < frame.length - 1; i++) sum += frame[i]
  frame[frame.length-1] = sum & 0xFF
  return frame.buffer
}

control.js — BLE发送LED命令

复制toggleLed(e) {
  const idx = e.currentTarget.dataset.index
  const newState = !this.data.ledStates[idx]
  const ledIds = [0x11, 0x12, 0x13, 0x14]
  const frame = protocol.buildLedFrame(ledIds[idx], newState)

  wx.writeBLECharacteristicValue({
    deviceId:         getApp().globalData.deviceId,
    serviceId:        getApp().globalData.serviceId,
    characteristicId: getApp().globalData.writeCharId,
    value: frame,
    success: () => {
      this.setData({ [`ledStates[${idx}]`]: newState })
    },
    fail: err => wx.showToast({ title: '发送失败', icon: 'error' })
  })
}

app.js — 全局BLE数据监听

复制// 特征值通知回调 (全局注册)
wx.onBLECharacteristicValueChange(res => {
  const sensorData = protocol.parseSensorJson(res.value)
  if (sensorData) {
    this.globalData.latestSensor = sensorData
    this.globalData.sensorHistory.unshift({
      ...sensorData, time: new Date().toLocaleTimeString()
    })
    if (this.globalData.sensorHistory.length > 20)
      this.globalData.sensorHistory.pop()
    // 通知采集页刷新
    if (this._collectionRef) this._collectionRef.onSensorData(sensorData)
    return
  }
  // 文本反馈 (如 "[ESP]WiFi GOT IP!")
  const text = utf8BytesToString(res.value)
  if (this._settingsRef) this._settingsRef.onMcuFeedback(text)
})

🎨 小程序页面原型（三页）

⚠️ 小程序开发避坑指南

🔧 华为云 IoTDA 配置步骤

📡 ESP8266 AT指令连接华为云

复制/* esp8266.c - 完整连接时序 */

// ① 初始化
AT+RST                            // 复位
// 等待3秒
ATE0                              // 关回显
AT+CWMODE=1                       // Station模式
AT+CWAUTOCONN=0                   // 关自动重连

// ② 连接WiFi
AT+CWJAP="MySSID","MyPassword"    // 最长等15秒
// 期待: WIFI CONNECTED → WIFI GOT IP

// ③ 连接华为云TCP
AT+CIPSTART="TCP","iot-mqtts.cn-north-4.myhuaweicloud.com",1883
// 期待: CONNECT OK（最长10秒）

// ④ 发送数据（普通模式）
AT+CIPSEND=31                     // 声明数据长度(含\r\n)
// 等待">"提示符出现
{"temp":26.1,"humi":55.3}\r\n    // 发送JSON
// 期待: SEND OK

// ⑤ 关闭连接（可选）
AT+CIPCLOSE

上报数据格式

复制// 方式1: 直接JSON（适合教学快速验证）
{"temp":26.1,"humi":55.3}

// 方式2: 华为云标准属性上报格式（推荐）
{
  "services": [{
    "service_id": "Environment",
    "properties": {
      "temperature": 26.1,
      "humidity": 55.3
    }
  }]
}

// 华为云MQTT Topic
// 属性上报: $oc/devices/{device_id}/sys/properties/report
// 消息上报: $oc/devices/{device_id}/sys/messages/up
// 命令接收: $oc/devices/{device_id}/sys/messages/down

📊 华为云平台功能配置

🎯 调试工具与验证流程

🔧 HEX帧测试（串口助手发送）

🧮 校验和在线计算器

📋 AT文本命令（串口助手字符串模式）

复制// 查看帮助（所有命令列表）
AT+HELP

// 配置WiFi并自动连接
AT+WIFI=MyHomeWiFi,password123

// 查询当前WiFi配置和状态
AT+WIFI

// 配置IoT服务器
AT+IOT=iot-mqtts.cn-north-4.myhuaweicloud.com,1883

// 查询IoT状态
AT+IOT

// 修改DHT11采样间隔为30秒
AT+INTERVAL=30

// 扫描附近WiFi热点
AT+SCAN

复制========================================
  IoT Center Controller v1.0
  STM32F407ZET6 @ 168MHz
========================================
[INIT] UART1 Ready (115200, PA9/PA10)
[INIT] UART2 Ready (9600, PA2/PA3->BLE)
[INIT] UART3 Ready (115200,PB10/PB11->ESP)
[INIT] LED1~4 Ready
[INIT] DHT11 Ready (PG9)
[W25Q128] Init OK, JEDEC ID: 0xEF17
[FLASH] Sys param: DHT11_interval=10 sec
[ESP8266] AT test OK
[ESP8266] WiFi connected!
[DHT11] {"temp":26.1,"humi":55.3}
[INIT] System ready!

✅ 完整验收测试流程

📚 推荐学习资源