1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
### The `maweb` backend
This backend connects directly with the integrated *MA Web Remote* of MA Lighting consoles and OnPC
instances (GrandMA2 / GrandMA2 OnPC / GrandMA Dot2 / GrandMA Dot2 OnPC).
It grants read-write access to the console's playback faders and buttons as well as write access to
the command line buttons.
To allow this backend to connect to the console, enter the console configuration (`Setup` key),
select `Console`/`Global Settings` and set the `Remotes` option to `Login enabled`.
Create an additional user that is able to log into the Web Remote using `Setup`/`Console`/`User & Profiles Setup`.
#### Global configuration
The `maweb` backend does not take any global configuration.
#### Instance configuration
| Option | Example value | Default value | Description |
|---------------|-----------------------|-----------------------|---------------------------------------------------------------|
| `host` | `10.23.42.21 80` | none | Host address (and optional port) of the MA Web Remote |
| `user` | `midimonster` | none | User for the remote session |
| `password` | `midimonster` | `midimonster` | Password for the remote session |
#### Channel specification
Currently, three types of channels can be assigned
##### Executors
Executors are arranged in pages, with each page having 90 fader executors and 90 button executors.
Note that when creating a new show, only the first page is created and active.
A fader executor consists of a fader, two buttons (`upper`, `lower`) above it and one `flash` button below it.
These controls can be adressed like
```
mw1.page1.fader5 > mw1.page1.upper5
mw1.page3.lower3 > mw1.page2.flash2
```
A button executor can likewise be mapped using the syntax
```
mw1.page2.button3 > mw1.page3.button1
```
##### Command line buttons
Command line buttons will be pressed when the incoming event value is greater than `0.9` and released when it is less than that.
They can be mapped using the syntax
```
mw1.<button-name>
```
The following button names are recognized by the backend:
* `SET`
* `PREV`
* `NEXT`
* `CLEAR`
* `FIXTURE_CHANNEL`
* `FIXTURE_GROUP_PRESET`
* `EXEC_CUE`
* `STORE_UPDATE`
* `OOPS`
* `ESC`
* `0`
* `1`
* `2`
* `3`
* `4`
* `5`
* `6`
* `7`
* `8`
* `9`
* `PUNKT`
* `PLUS`
* `MINUS`
* `THRU`
* `IF`
* `AT`
* `FULL`
* `HIGH`
* `ENTER`
* `OFF`
* `ON`
* `ASSIGN`
* `LABEL`
* `COPY`
* `TIME`
* `PAGE`
* `MACRO`
* `DELETE`
* `GOTO`
* `GO_PLUS`
* `GO_MINUS`
* `PAUSE`
* `SELECT`
* `FIXTURE`
* `SEQU`
* `CUE`
* `PRESET`
* `EDIT`
* `UPDATE`
* `EXEC`
* `STORE`
* `GROUP`
* `PROG_ONLY`
* `SPECIAL_DIALOGUE`
* `SOLO`
* `ODD`
* `EVEN`
* `WINGS`
* `RESET`
* `MA`
* `layerMode`
* `featureSort`
* `fixtureSort`
* `channelSort`
* `hideName`
Note that each Web Remote connection has it's own command line, as such commands entered using this backend will not affect
the command line on the main console. To do that, you will need to use another backend to feed input to the MA, such as
the ArtNet or MIDI backends.
#### Known bugs / problems
To properly encode the user password, this backend depends on a library providing cryptographic functions (`libssl` / `openssl`).
Since this may be a problem on some platforms, the backend can be built with this requirement disabled, which also disables the possibility
to set arbitrary passwords. The backend will always try to log in with the default password `midimonster` in this case. The user name is still
configurable.
This backend is currently in active development. It therefore has some limitations:
* It outputs a lot of debug information
* It currently is write-only, channel events are only sent to the MA, not generated by it
* Fader executors (and their buttons) seem to work, I haven't tested button executors yet.
* Command line events are sent, but I'm not sure they're being handled yet
* I have so far only tested it with GradMA2 OnPC
|
