zhou yang和Claude Opus 5.5
a32fa06c43
- A12 单一命令处理器（cmd*.c）：一行 JSON 进出、seq 全局判重（32 条按值）、
限幅 / 空槽一律拒 / 拒绝记事件；命令号与错误码冻结（进 flash）。新增 power 命令，
fan 改为只抬不压的下限（t_thermal_set_floor）。rail_set_mv 注明不拿锁，调用方包 xact。
- A13 USB-Serial-JTAG 分帧（ulink*.c）：@C / @R 前缀 + CRC-16，日志行首 @ 垫空格，
任意切块可切；关掉 USB 副控制台（它绕开驱动写 FIFO）。PC 端客户端 tools/prlink.py。
- A14 + C1（netcfg / mlink / cmd_net）：topic phonerail/<mac>/{cmd,rsp,tele,state}，
mqtts（evse-ca 编进固件）、1 s 遥测、遗嘱离线；wifi / mqtt 配置只收 USB、存 NVS，
net 永不回显密码。
- 协议定稿写进需求文档 §10.8（A12 / A13 / A14 三节）；N7 撤销改 D7（机架管理前后端）。
宿主机 23 个 ctest / 400 例全绿；板 B 已烧 0.1.0-a14，经 WiFi → 公网 → 8883 TLS 真连网验过。
固件 0xE2220 / 1 MB 分区只剩 12%，C2 前要重排分区表。
Co-Authored-By: Claude Opus 5.5 <[email protected]>
34 行
1.4 KiB
C
34 行
1.4 KiB
C
/* 传输适配器 → 命令处理器的入口（A12 定形状，A13 / A14 是调用方）。**只在 ESP 目标上有**。
|
||
|
||
§10.8：两条链路只是传输，命令处理器只有一个。适配器把切好的一行交到这里，
|
||
由**执行器任务**取出来调 `cmd_handle_line()`（cmd.h「在哪个任务里跑」），
|
||
回应经 `reply` 交还给适配器去发。
|
||
|
||
⚠️ `reply` 是在**执行器任务**里被调的，不是在适配器自己的任务里：
|
||
它必须线程安全、不许阻塞太久（执行器还要按时推状态机，松键靠它）。
|
||
USB-Serial-JTAG 的写与 MQTT publish 都满足；做不到的适配器就在回调里只做入队。 */
|
||
#ifndef CMD_QUEUE_H
|
||
#define CMD_QUEUE_H
|
||
|
||
#include <stdbool.h>
|
||
#include <stddef.h>
|
||
|
||
#include "cmd.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
typedef void (*cmd_reply_fn)(void *ctx, const char *line, size_t len);
|
||
|
||
/* 投递一行（会被拷贝，调用方的缓冲可以立刻复用）。超过 `CMD_LINE_MAX − 1` 的行直接拒收。
|
||
队列满 / 超长 / 还没起来都返回 false —— 适配器应当回一条错误或者丢弃，
|
||
**不许**自己去调 `cmd_handle_line()`（那会绕开「只在执行器任务里跑」这条）。 */
|
||
bool cmd_queue_submit(cmd_link_t link, const char *line, cmd_reply_fn reply, void *ctx);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* CMD_QUEUE_H */
|