MA2 控台控制
⚠️ 使用前检查
1. 控台连接检测
执行命令前，先检查控台是否在线：
CODEBLOCK0
返回 "ok":true 表示连接正常。
2. 常见错误处理
| 错误 | 原因 | 解决 |
|---|
| INLINECODE1 | 控台IP不对或网络不通 | 确认控台IP和网段 |
| INLINECODE2 |
Telnet端口未开启 | 在控台设置里开启Remote |
|
no service | 桥接服务未启动 | 运行
python3 ~/ma2_bridge/ma2_telnet_server.py |
🚀 快速命令
选灯
| 命令 | 说明 |
|---|
| INLINECODE5 | 单个 |
| INLINECODE6 |
范围 |
|
Fixture 1 + 3 + 5 | 多选 |
|
Group 1 | 组 |
亮度
| 命令 | 说明 |
|---|
| INLINECODE9 | 100% |
| INLINECODE10 |
50% |
|
At 0 | 全关 |
属性
| 命令 | 说明 |
|---|
| INLINECODE12 | 颜色 |
| INLINECODE13 |
水平 |
|
Attribute "TILT" At 50 | 垂直 |
存储
| 命令 | 说明 |
|---|
| INLINECODE15 | 存 Cue |
| INLINECODE16 |
带名存 |
|
Assign Cue 1 To Executor 1.1 | 到执行器 |
播放
| 命令 | 说明 |
|---|
| INLINECODE18 | 触发 |
| INLINECODE19 |
暂停 |
|
Goto Cue 5 Sequence 1 | 跳转 |
查询
| 命令 | 说明 |
|---|
| INLINECODE21 | 列表 Cue |
| INLINECODE22 |
列表灯具 |
|
List Executor | 列表执行器 |
|
Info Cue 1 | Cue 详情 |
⚡ 执行方式
执行 MA2 命令必须使用：
CODEBLOCK1
多条命令用 ; 分隔：
~/ma2_bridge/ma2_cmd.sh "Fixture 1 Thru 10 ; At Full"
🎨 颜色值速查
10 |
| 黄 | 20 |
| 绿 | 30 |
| 青 | 40 |
| 蓝 | 60 |
| 紫 | 70 |
| 品红 | 80 |
📍 位置值速查
127 | 50 |
| 右 | 255 | - |
🔧 配置说明
环境变量 (可选)
| 变量 | 默认值 | 说明 |
|---|
| INLINECODE26 | 192.168.1.11 | 控台IP |
| INLINECODE27 |
30000 | Telnet端口 |
|
MA2_HTTP_PORT_OVERRIDE | 自动检测 | 桥接服务端口 |
桥接服务
控台连接流程：
- 1. 控台开启 Telnet Remote (Settings → Network → Remote)
- 本机运行： INLINECODE29
- 通过桥接服务发送命令
📖 详细文档
完整命令语法见：references/MA2_COMMAND_SYNTAX.md
模板库见：references/MA2_TEMPLATES.md
故障排查见： INLINECODE32
MA2 控台控制
⚠️ 使用前检查
1. 控台连接检测
执行命令前，先检查控台是否在线：
bash
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/ma2telnet_server.py |
🚀 快速命令
选灯
| 命令 | 说明 |
|---|
| Fixture 1 | 单个 |
| Fixture 1 Thru 10 |
范围 |
| Fixture 1 + 3 + 5 | 多选 |
| Group 1 | 组 |
亮度
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命令必须使用：
bash
~/ma2bridge/ma2cmd.sh MA2命令
多条命令用 ; 分隔：
bash
~/ma2bridge/ma2cmd.sh Fixture 1 Thru 10 ; At Full
🎨 颜色值速查
10 |
| 黄 | 20 |
| 绿 | 30 |
| 青 | 40 |
| 蓝 | 60 |
| 紫 | 70 |
| 品红 | 80 |
📍 位置值速查
127 | 50 |
| 右 | 255 | - |
🔧 配置说明
环境变量 (可选)
| 变量 | 默认值 | 说明 |
|---|
| MA2IPEXPECTED | 192.168.1.11 | 控台IP |
| MA2TELNETPORT_EXPECTED |
30000 | Telnet端口 |
| MA2
HTTPPORT_OVERRIDE | 自动检测 | 桥接服务端口 |
桥接服务
控台连接流程：
- 1. 控台开启Telnet Remote (Settings → Network → Remote)
- 本机运行：python3 ~/ma2bridge/ma2telnet_server.py
- 通过桥接服务发送命令
📖 详细文档
完整命令语法见：references/MA2COMMANDSYNTAX.md
模板库见：references/MA2_TEMPLATES.md
故障排查见：references/MA2_TROUBLESHOOTING.md
