BMCLI 基础教程：完成一次可复现的总线操作

本教程不追求堆砌命令，而是建立一条可重复、可审计的最小工作流：确认台架配置，验证硬件，再接收、发送、记录和解析数据。

先确定台架事实

bmcli bench show --format=json
bmcli doctor
bmcli bench validate --hardware --format=json

请记录返回的设备序列号、端口、总线类型和波特率。后续命令使用稳定的 SN/port 或项目逻辑网络名，不依赖可能变化的枚举序号。

查询当前版本的命令契约

bmcli help message recv --format=json
bmcli help message send --format=json
bmcli help logging start --format=json
bmcli help dbc decode --format=json

JSON Help 是安装版本的精确契约；教程负责解释流程，Help 负责给出当前可执行参数。

接收、发送与诊断

bmcli message recv --channel=<SN/port> --duration=60 --format=jsonl
bmcli message send --channel=<SN/port> --id=0x12 --type=master-write --data="01 02 03 04" --bitrate=19200 --format=json
bmcli uds request 22 F1 90 --channel=<SN/port> --request-id=<CAN-ID> --response-id=<CAN-ID> --format=json

发送仅应在已确认安全的台架上进行。文件记录应先查询 logging start Help，再把输出文件、命令、退出码和时间戳一同保留。DBC 应作为受控资源加载，再用 dbc message/signal/decode/encode 处理语义。

验收标准不是“命令运行过”，而是目标通道明确、结果结构化、失败类型可区分、日志可追溯，并清理本次任务启动的记录、回放或周期任务。