开发者中心

MCP · API 与指令全解

三层接入，任选其一：MCP 服务让 AI 助手直接调用设备能力，HTTP 协议做远程下发与数据上报，串口指令做底层调试。所有指令小写、空格分参、回车执行。

🤖

① MCP 服务

标准 Model Context Protocol 接口，14 个工具覆盖设备状态、指令下发与数据查询。Claude、Cursor 等 AI 客户端填一行配置即可接入，用自然语言控制硬件。

🌐

② HTTP 远程协议

自托管服务端，REST 风格接口下发指令、拉取历史曲线与多设备管理，数据全程留在自己服务器。

⌨️

③ 串口指令台

USB CDC 直连，一条命令一次响应，适合底层调试与自动化脚本嵌入。

指令控制台

基础系统指令 Serial / 远程指令

通过串口（USB CDC）或数据平台远程下发。所有指令小写、空格分参、回车执行。

heap  查看堆内存：空闲总量 / 最大连续块 / PSRAM 状态
sys  系统状态汇总：版本 / 运行时长 / 电池 / 栈水位 / 帧率
page <n>  跳转页面（1~24），如 page 22 进入蓝牙键鼠
tap <x> <y>  模拟单击；tapsim <x> <y> [抖动] [帧] 为真手指模拟
swipe <dir>  滑动翻页：left / right / up / down
rst [reason]  软复位并记录原因（用于取证与自动化测试）

可调电源指令 Serial / 远程指令

控制 XY6509 / SK200W 可调电源。写特征 A8F1，通知特征随型号不同（A8F2/A8F3），量纲 ÷100V、÷1000A。

ps scan  扫描并连接电源设备
ps status  输出 / 设定 / 模式 / 保护 / 帧寄存器完整状态
ps on|off  打开或关闭输出
ps set <V> <A>  设定电压电流，如 ps set 5.0 1.5
ps sim on|off  切换仿真模式（便于无硬件演示）
ps raw  原始寄存器报文十六进制输出

蓝牙键鼠 HID 指令 Serial / 远程指令

将盒子变为标准蓝牙 HID 设备（服务 0x1812）。支持加密配对、多主机、Boot 协议。

hid on|off  开启/关闭 HID 服务与广播
hid status  连接状态 / 配对 / 订阅数 / 广播状态
hid move <dx> <dy>  相对鼠标位移
hid click [n]  左键单击（可带次数）
hid type <text>  键入文本（ASCII）
hid combo <mod>+<key>  组合键，如 hid combo ctrl+alt+delete
hid encperm on|off  强制加密读写（防明文探测）

WiFi 安全检测指令 Serial / 远程指令

仅限合规安全评估：主动探测、取证与风险评分。产品内置合规底线，不提供任何攻击功能。

wsec scan  全信道扫描 AP 与终端
wsec hs on|off  握手帧捕获开关（EAPOL 0x888E）
wsec probe on|off  合规主动探测开关（非阻塞状态机）
wsec pcap  导出标准 pcap 取证文件
wsec report  输出风险评分报告

HTTP API

数据上报与远程指令 HTTP（自托管平台）

设备端与自托管数据平台之间的开放协议。可部署于任意内网服务器，全程不经第三方云。

POST /api/report  设备上报：body 含 {dev, up, sys, metrics...}
POST /api/cmd  远程下发指令：{dev, cmds:["heap","page 3"]}
GET /api/history?dev=BAT-01&limit=2000  查询历史曲线与重启取证记录
GET /api/devices  列出全部在线设备
鉴权  URL 参数 ?k=<访问密钥>，密钥在管理后台设置

扩展 API

私有指令扩展（企业版）固件扩展接口

企业版开放源码后，可注册自定义串口/远程指令、自定义页面与 BLE 服务，完整接入自有生态。

regCmd(name, fn)  注册新指令（注意：同名后写会被静默删除）
addPage()  新增功能页：枚举→宫格→渲染→点击→字体 全链路模板
BLE 自定义服务  创建服务/特征/通知，Report 描述符模板
pcap 导出  DataRecorder 环形缓冲 + 标准 pcap 落盘 API

📌 更多进阶文档

购买后随设备发放：完整指令手册、BLE 报文协议、MCP 工具清单与 AI 技能示例、固件扩展指南与示例代码仓库（企业版含源码）。