Ma2 Control
grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。 用于:选灯、调光、存 Cue、播放、查询等 MA2 操作。 触发条件:用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。 执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。
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 |
📍 位置值速查
| 方向 | PAN | TILT |
|---|---|---|
| 左 | 0 | - |
| 中 | 127 | 50 |
| 右 | 255 | - |
🔧 配置说明
环境变量 (可选)
| 变量 | 默认值 | 说明 |
|---|---|---|
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
- Downloads
- 909All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.1.0
- License
- MIT-0
