纸飞机调试助手文档 ComAssistant Docs

命令面板

命令面板

概述

待补充：命令面板整体截图

命令面板用于保存、整理和重复发送常用命令。它既可以作为普通“历史命令列表”使用，也可以把一组初始化、读取状态、参数设置、异常测试等步骤整理成分组命令，减少重复输入。

命令面板中的一行命令由“注释”和“命令内容”组成。内置教程里使用 CMD_1 | 命令内容 的形式说明规则：竖线左侧是注释，右侧是实际发送内容。右击命令或空白处可以配置命令或查看教程，双击命令发送命令，双击组名展开或收起。

基本操作

待补充：命令编辑窗口截图

  • 在菜单栏的功能——命令面板，打开该功能。
  • 右击空白处或已有命令，新增命令或新增分组。
  • 为命令填写注释、发送内容和发送模式。
  • 发送模式可以选择 自动、HEX 或 TEXT。
  • 双击命令发送；双击组名展开或收起。
  • Ctrl + 双击命令可编辑命令，Ctrl + 双击组名可编辑组。
  • 命令列表支持拖拽排序。

    • 自动 模式会根据内容判断发送格式：内容符合 HEX 格式时按 HEX 发送，否则按文本发送。HEX 内容不要写 0x 前缀，建议用空格分隔字节，例如 AA 55 01 00.

    分组命令

    分组适合把一组需要按顺序执行的命令放在一起，例如：

  • 01-进入配置
  • 02-读取参数
  • 03-写入参数
  • 04-保存并重启

    • 组内命令可以设置发送间隔。发送整组时，纸飞机会按组内顺序依次发送，并在命令之间等待对应间隔。需要长时间循环执行时，可以使用分组循环发送；需要停止时使用停止发送入口。

    占位符

    占位符主要用于自由工作区控件绑定命令面板命令。控件触发命令时，纸飞机会把控件当前值替换进命令内容。

    TEXT 模式常用占位符：

  • %d：按整数写入控件值。
  • %2d、%02d：按指定宽度格式化整数。
  • %f、%.1f、%8.2f：按浮点格式写入控件值。
  • %x、%02x、%X：按十六进制文本写入控件值。
  • %ID：写入指令名称。

    • HEX 模式常用占位符：

  • %LE：把控件值按小端字节序写入。
  • %BE：把控件值按大端字节序写入。
  • %ID：写入指令 ID。
  • %%：在 HEX 命令中表示字面量 %。

    • %LE 和 %BE 的字节宽度由控件量程和数据类型决定，不代表固定 1 字节。如果控件绑定的是浮点值，会按浮点值写入；如果绑定的是整数值，会按整数值写入。

    示例

    TEXT 命令示例：

    set_pwm:%d
set_voltage:%.2f
read:%ID

    HEX 命令示例：

    AA 55 %ID %LE CC
AA 55 %ID %BE CC

    当自由工作区滑块当前值为 300，并绑定 HEX 命令 AA 55 %ID %LE CC 时，%ID 会替换为该控件配置的指令 ID，%LE 会替换为控件值的小端字节。

    与 AI / MCP 自动化

    MCP 中命令面板按树结构暴露，根级行号使用 row，组内命令使用 cmd_index。AI agent 可以读取命令树、创建分组、添加命令、调整顺序、发送单条命令或发送整组命令。

    自动化时建议遵守以下规则：

  • 需要模拟用户点击命令时，使用命令面板发送接口。
  • 需要直接发一包数据时，使用设备直发接口。
  • 需要先把内容放到发送区再按发送按钮时，使用发送区接口和发送按钮接口。
  • 对擦除、恢复出厂、写入永久参数等危险命令，命令注释里应明确写出风险。

    • 常见问题

    为什么命令点击后设备没有反应？

    先检查通信连接是否打开，再检查发送模式、换行符、HEX 格式和设备当前状态。自动模式下，如果内容刚好符合 HEX 格式，纸飞机会按 HEX 发送。

    命令会自动录入吗？

    发送过的命令会自动录入命令面板，可在面板下方关闭自动录入或通过 MCP 的命令面板控制接口暂停自动录入。

    分组命令会跟随配置保存吗？

    建议配合配置工程文件使用。这样不同项目可以保留独立命令集，避免把 A 项目的参数命令误发给 B 项目。

    > 本文为 AI 辅助生成内容