MA2 控台控制#

⚠️ 使用前检查#

1. 控台连接检测#

执行命令前，先检查控台是否在线：

bash

curl -s http://127.0.0.1:40100/health

返回 "ok":true 表示连接正常。

2. 常见错误处理#

错误原因解决timed out控台IP不对或网络不通确认控台IP和网段connection refusedTelnet端口未开启在控台设置里开启Remoteno service桥接服务未启动运行 python3 ~/ma2_bridge/ma2_telnet_server.py

---

🚀 快速命令#

选灯#

命令说明Fixture 1单个Fixture 1 Thru 10范围Fixture 1 + 3 + 5多选Group 1组

亮度#

命令说明At Full100%At 5050%At 0全关

属性#

命令说明Attribute "COLOR1" At 30颜色Attribute "PAN" At 127水平Attribute "TILT" At 50垂直

存储#

命令说明Store Cue 1存 CueStore Cue 1 "名称"带名存Assign Cue 1 To Executor 1.1到执行器

播放#

命令说明Go Executor 1.1触发Pause Sequence 1暂停Goto Cue 5 Sequence 1跳转

查询#

命令说明List Cue列表 CueList Fixture列表灯具List Executor列表执行器Info Cue 1Cue 详情

---

⚡ 执行方式#

执行 MA2 命令 必须使用：

bash

~/ma2_bridge/ma2_cmd.sh "MA2命令"

多条命令用 ; 分隔：

bash

~/ma2_bridge/ma2_cmd.sh "Fixture 1 Thru 10 ; At Full"

---

🎨 颜色值速查#

颜色值红0橙10黄20绿30青40蓝60紫70品红80

📍 位置值速查#

方向PANTILT左0-中12750右255-

---

🔧 配置说明#

环境变量 (可选)#

变量默认值说明MA2_IP_EXPECTED192.168.1.11控台IPMA2_TELNET_PORT_EXPECTED30000Telnet端口MA2_HTTP_PORT_OVERRIDE自动检测桥接服务端口

桥接服务#

控台连接流程：

1. 控台开启 Telnet Remote (Settings → Network → Remote)
2. 本机运行： python3 ~/ma2_bridge/ma2_telnet_server.py
3. 通过桥接服务发送命令

---

📖 详细文档#

完整命令语法见： references/MA2_COMMAND_SYNTAX.md 模板库见： references/MA2_TEMPLATES.md 故障排查见： references/MA2_TROUBLESHOOTING.md