- name
- ma2-control
- description
- |
- metadata
- openclaw
- emoji
- 🎛️
- requires
- bins
- [bash, curl, nc]
- scripts
- env
MA2 控台控制
⚠️ 使用前检查
1. 控台连接检测
执行命令前，先检查控台是否在线：
curl -s http://127.0.0.1:40100/health
返回 "ok":true 表示连接正常。
2. 常见错误处理
| 错误 | 原因 | 解决 |
|---|
timed out | 控台IP不对或网络不通 | 确认控台IP和网段 |
connection refused | Telnet端口未开启 | 在控台设置里开启Remote |
no service | 桥接服务未启动 | 运行 python3 ~/ma2_bridge/ma2_telnet_server.py |
🚀 快速命令
选灯
| 命令 | 说明 |
|---|
Fixture 1 | 单个 |
Fixture 1 Thru 10 | 范围 |
Fixture 1 + 3 + 5 | 多选 |
Group 1 | 组 |
亮度
| 命令 | 说明 |
|---|
At Full | 100% |
At 50 | 50% |
At 0 | 全关 |
属性
| 命令 | 说明 |
|---|
Attribute "COLOR1" At 30 | 颜色 |
Attribute "PAN" At 127 | 水平 |
Attribute "TILT" At 50 | 垂直 |
存储
| 命令 | 说明 |
|---|
Store Cue 1 | 存 Cue |
Store Cue 1 "名称" | 带名存 |
Assign Cue 1 To Executor 1.1 | 到执行器 |
播放
| 命令 | 说明 |
|---|
Go Executor 1.1 | 触发 |
Pause Sequence 1 | 暂停 |
Goto Cue 5 Sequence 1 | 跳转 |
查询
| 命令 | 说明 |
|---|
List Cue | 列表 Cue |
List Fixture | 列表灯具 |
List Executor | 列表执行器 |
Info Cue 1 | Cue 详情 |
⚡ 执行方式
执行 MA2 命令必须使用：
~/ma2_bridge/ma2_cmd.sh "MA2命令"
多条命令用 ; 分隔：
~/ma2_bridge/ma2_cmd.sh "Fixture 1 Thru 10 ; At Full"
🎨 颜色值速查
| 颜色 | 值 |
|---|
| 红 | 0 |
| 橙 | 10 |
| 黄 | 20 |
| 绿 | 30 |
| 青 | 40 |
| 蓝 | 60 |
| 紫 | 70 |
| 品红 | 80 |
📍 位置值速查
🔧 配置说明
环境变量 (可选)
| 变量 | 默认值 | 说明 |
|---|
MA2_IP_EXPECTED | 192.168.1.11 | 控台IP |
MA2_TELNET_PORT_EXPECTED | 30000 | Telnet端口 |
MA2_HTTP_PORT_OVERRIDE | 自动检测 | 桥接服务端口 |
桥接服务
控台连接流程：
- 控台开启 Telnet Remote (Settings → Network → Remote)
- 本机运行：
python3 ~/ma2_bridge/ma2_telnet_server.py - 通过桥接服务发送命令
📖 详细文档
完整命令语法见：references/MA2_COMMAND_SYNTAX.md 模板库见：references/MA2_TEMPLATES.md 故障排查见：references/MA2_TROUBLESHOOTING.md
