This section covers remote control interfaces for USB devices: game controllers (joysticks/gamepads), and the IO-Warrior and Velleman K8055 I/O boards, which provide digital inputs and outputs, e.g. for GPIO connections to a mixing console.
1 - Joystick
The Joystick/Gamepad remote control lets you trigger remote control commands with the buttons of any game controller recognized by Windows.
This is not limited to actual joysticks: Many USB button boxes and encoder interfaces (often sold for arcade machines or flight simulators) register as game controllers, and are an inexpensive way to build custom button panels.
Configuration
In the configuration app or Control Panel, go to Remote Control and add an interface of type Joystick/Gamepad (USB category).
On the General tab, select the Device from the list of game controllers, or (First available device) to use the first one found.
In the table below, you can enter a command for each button, separately for when the button is Pressed and when it is Released. Click a cell to edit the command. Leave the cell empty if no command should be executed.
2 - IO-Warrior
The IO-Warrior is a family of USB I/O boards by Code Mercenaries, which provide a number of digital I/O pins. mAirList supports the IO-Warrior 24, 28, 28L, 40, 56 and 100.
Each pin can be used as an input, to trigger remote control commands, or as an output, controlled by a script.
Configuration
In the configuration app or Control Panel, go to Remote Control and add an interface of type IO-Warrior (USB category).
Device
On the Device tab, click Select Device… and choose your IO-Warrior from the list of connected devices. This will fill in the Vendor/Product ID, Serial Number and Path fields.
When a Path is set, mAirList will open exactly this device (i.e. the device connected to this particular USB port). Clear the Path field to identify the device by its vendor/product ID and serial number instead, so it is still found when plugged into a different USB port.
Commands
The Commands tab lists all pins of the device. The pins are named P<port>.<bit>, e.g.
P0.3 for bit 3 of port 0, followed by a consecutive number in parentheses.
For each pin, enter the command to execute when the input goes On and Off, respectively. Click a cell to edit the command.
The inputs are active-low: A pin is considered On when it is connected to ground (e.g. through a switch or relay contact), and Off otherwise.
Outputs
The pins can also be used as outputs, e.g. to drive an LED or a relay, from a background script:
IOWarriorRemote(0).SetPin(3, true);
The first parameter of IOWarriorRemote is the index of the IO-Warrior interface
(0 for the first one, if you have more than one configured).
The first parameter of SetPin is the pin number, counted from 0 (P0.0 = 0,
P1.0 = 8, etc.); the second parameter switches the output on (pulled to ground) or off.
While a pin is switched on as an output, it will not trigger any input commands.
3 - Velleman K8055
The Velleman K8055 (and its successor, the K8055N) is a USB experiment board with five digital inputs, eight digital outputs, and two analog inputs and outputs. mAirList can use the digital inputs to trigger remote control commands, and set the outputs from a script.
The required driver library (K8055D.dll) is included with mAirList.
Configuration
In the configuration app or Control Panel, go to Remote Control and add an interface of type Velleman K8055/K8055N (USB category).
Device
- Device address: The address of the board (0 to 3), as set with the jumpers on the board. This allows you to use up to four boards on the same computer.
- Update interval: How often (in milliseconds) mAirList polls the board for changes of the inputs. The default is 50 ms.
Commands
On the Commands tab, enter the command to execute for each of the five digital inputs when it goes ON, and when it goes OFF.
Outputs
The outputs can be controlled from a background script through the following methods:
K8055Remote(0).SetDigitalChannel(1); // switch on digital output 1
K8055Remote(0).ClearDigitalChannel(1); // switch off digital output 1
K8055Remote(0).ClearAllDigital; // switch off all digital outputs
K8055Remote(0).OutputAnalogChannel(1, 255); // set analog output 1 (0..255)
The parameter of K8055Remote is the index of the K8055 interface (0 for the first one,
if you have more than one configured).
The current state of the inputs can be read with ReadDigitalChannel and ReadAllDigital.
4 - Elgato Stream Deck
mAirList can be controlled with an Elgato Stream Deck. The buttons can execute remote control commands, or trigger cart players, with the button color indicating the state of the cart player.
The integration consists of two parts: a remote control interface in mAirList, and a plugin for the Stream Deck software, which connects to mAirList.
Configuration
In the configuration app or Control Panel, go to Remote Control and add an interface of type Elgato Stream Deck (USB category).
Install the Stream Deck software from Elgato, then click Click here to install the plugin in the configuration dialog to install the mAirList plugin.
Advanced Settings:
- HTTP Port: The port that the plugin connects to. The default is 10810.
- Allow connections from other computers: By default, only the Stream Deck software on the same computer can connect. Check this option to allow connections over the network, e.g. when the Stream Deck is connected to a different computer.
Stream Deck Actions
In the Stream Deck software, the plugin provides the following actions:
- Cart Player: Triggers a cart player (enter the Cart Number). The button shows the number of the cart player, colored green when an item is loaded and red while it is playing. By default, the button is only active when the cartwall is ON AIR (or in PFL or voice tracking mode); check Enable button when OFF AIR to change this.
- Execute Command: Executes the entered Command when the button is pressed.
If mAirList runs on a different computer, or uses a different port, enter the Host/IP and Port in the plugin settings.