forked from EmbeddedTeam/app_photomagnetic

zhangyisong 27ae21bbea Add UID management, LED strip debug, and MCUboot signing updates

- Add UID encoding/decoding with flash storage and CRC16 validation
- Add write UID (0x07) and LED strip color (0x08) protocol commands
- Add debug LED strip configuration option
- Switch MCUboot signing from RSA-2048 to ECDSA-P256
- Add SMP serial client for firmware upload over UART
- Add firmware version output on boot
- Update upgrade documentation with ECDSA key generation steps

2026-08-20 21:16:30 +08:00

3.0 KiB

Raw Blame History

串口通信协议设计文档

帧结构：[起始标志：16bit][数据指令类型][数据字节数：8bit][数据][CRC]
- CRC从[数据指令类型]到[数据]结束
- 温度：0x00指令
  - 主板请求：0x[7ee7][00][00][crc16]
  - 小板回：0x[7ee7][00][02][2411][crc16]
    - 主板请求时，小板回复温度
- id：0x01指令
  - 主板发 0x[7ee7][01][00][crc16]
  - 小板发 0x[7ee7][01][03][989680][crc16]
    - 主板请求时，小板回复id
    - 小板在系统上电时，主动发一次id
- 运行状态：0x02指令
  - 主板发 0x[7ee7][02][01][状态值][crc16]
    - 主板在运行状态变化时，主动向小板上报状态
    - 状态值定义：
      - 0x00：待机中
      - 0x01：运行中
      - 0x02：暂停中
      - 0x03：故障中
- 写UID：0x07指令（生产烧录自定义UID，替代MCU芯片UID）
  - 主板发 0x[7ee7][07][0a][uid 10字节][crc16]
    - 将10字节UID写入小板storage分区（flash），掉电不丢失
    - 写入后，0x01读ID指令返回的是该UID
    - UID编码规则见《UID编码规则.md》： [设备类型 1B][产品代次 1B][生产年月 4B][序列号 4B]
  - 主板发 0x[7ee7][07][00][crc16]
    - 清除自定义UID，恢复使用MCU芯片UID
  - 小板回 0x[7ee7][07][01][状态][crc16]
    - 状态值定义：
      - 0x00：成功
      - 0x01：写入失败（flash擦除/写入/校验错误）
      - 0x02：长度错误（UID必须为10字节，或0字节=清除）
    - 说明：UID在storage分区（0x70000，64KB）起始处，记录格式 [magic "UID1" 4B][ver 1B][uid 10B][crc16 2B][pad 7B]，含CRC16-Modbus校验，损坏/未写入时自动回退芯片UID
- 灯带调色(调试)：0x08指令（仅调试固件 CONFIG_APP_DEBUG_LED_STRIP=y 时存在，生产固件不编译此命令）
  - 主板发 0x[7ee7][08][03][R][G][B][crc16]
    - 灯带整体设为该 RGB 颜色（R/G/B 各 0~255）
    - [0,0,0] 即熄灭
    - 用于开发/产线检查灯光颜色是否满足需求

sequenceDiagram
participant S as 小板 (传感器)
participant M as 主板 (控制板)
Note over S: 系统上电
    S ->> M: 【主动】发送 ID 信息 (0x01 指令帧)

    Note over S, M: 周期性温度上报 (每 20ms 一次)
    loop 每 20ms
        S ->> M: 【主动】发送温度数据帧 (0x00 指令)
    end

    Note over M, S: CRC 校验范围：从帧第 3 字节开始至 CRC 前

    Note over M: 主板运行状态变化
    M ->> S: 【主动】发送运行状态 (0x02 指令帧)

    opt 主板查询
        M ->> S: 请求 ID 信息 (0x01 指令帧)
        S -->> M: 回复 ID 序列号

        M ->> S: 请求 温度 信息 (0x00 指令帧)
        S -->> M: 回复 温度 数据
    end

    Note over M, S: 生产烧录 UID (0x07 指令)
    M ->> S: 写入 12 字节 UID (0x07 指令帧)
    S -->> M: 回复状态 (0x00 成功)
    M ->> S: 请求 ID 验证 (0x01 指令帧)
    S -->> M: 回复写入后的 UID

3.0 KiB Raw Blame History Unescape Escape

串口通信协议设计文档

3.0 KiB

Raw Blame History