SD Card Configuration (config.ini)
You can load network and script settings from an SD card on all X-Series show controllers. This allows a unit to automatically assume settings from another unit simply by swapping SD cards between them.
This is done using a configuration file (config.ini) on the SD card. When present, this plain-text file will set the unit's network settings or active script file. If the file is not present, the controller's settings stored locally on the device are loaded as normal.
Note
The controller saves the values from a valid file in its internal memory. After you remove or rename the file, these values remain. The controller does not restore its previous configuration or factory defaults.
Create the File
Create a new file using a plain-text editor like Notepad. Save the file as UTF-8 text with the name config.ini. Make sure you edit the extension to .ini rather than creating config.ini.txt.
Here is an example that specifies the network configuration for interface A and the active script:
[network.A]
ip=192.168.0.254
subnet=255.255.255.0
gateway=0.0.0.0
[script]
active_script=Show.ws6
The following sections outline the details for each setting.
Network
The V16X supports configuring the settings of the the network sections shown below in Table 1.
| Section | Network Interface |
|---|---|
[network.A] |
Network Port A |
[network.B] |
Network Port B |
[network.C] |
Network Port C |
[network.D] |
Network Port D |
Use these rules:
- Each network section must contain
ip,subnet, andgatewayexactly once. - Use a contiguous subnet mask, like
255.255.255.0. - Do not use the network address or broadcast address for
iporgateway. - If no gateway is necessary, use
gateway=0.0.0.0. Otherwise, use a gateway in the same subnet as the IP address. - Use only the network sections in the table.
Note
If you define the settings for one network interface, the other network interfaces will be locked to whatever settings are stored in the device, and you will be unable to change those settings from the device's front panel menu.
Active Script
Every X-Series show controller supports configuring the active script loaded on the device.
Use these rules:
- Use the exact filename, including capitalization and the
.ws6or.amiextension. - Do not include a directory path or quotation marks in the script filename.
- Keep the script filename between 1 and 63 bytes (63 characters for an ASCII filename).
General
For a network-only file, omit the [script] section. For a script-only file, omit the network sections. Omitted network sections leave the saved interface configuration unchanged. Without active_script, the controller keeps the saved script selection.
Other rules:
- Put comments on separate lines that start with
;or#. - Section names and keys are not case-sensitive.
- The parser accepts blank lines.
- Section order does not matter.
- The parser ignores unknown section names and keys.
Install or Update the File
Once your file is written, follow the steps below to install a new configuration file or update an existing file.
- If the show is active, stop it.
- Remove power from the controller.
- Remove the SD card from the controller.
- If
config.inialready exists, make a backup copy on your computer. - Copy the new or updated
config.inito the root directory of the SD card. - If
active_scriptis present, copy the named script to the script directory of the SD card. - Safely eject the SD card from your computer.
- Insert the SD card into the controller.
- Restore power to the controller.
- Make sure that the displayed network values and the active script match the file.
To change the active script, change active_script. Then use this procedure again.
Note
If the IP address changes, the computer may need a different network configuration to connect to the controller.
Troubleshooting
Front Panel Changes
With a valid config.ini, the IP address, subnet mask, and gateway fields for every network on the device become read-only. If you navigate to the Network section of the front panel menu, the screen will display the following:
Edit network configuration in config.ini!
If you try to change the active script, the controller displays:
Edit config.ini file to change script name
Select Back to return without a change.
These restrictions also apply to network-only and script-only files, and to interfaces omitted from the file.
To restore front panel configuration, use steps 1-4 in Install or Update the File.
Invalid File
If the configuration file is invalid or unreadable, the controller does not apply its values or start the show. Instead, it will display:
Error: config.ini could not be loaded
Make sure that the file obeys the rules in Create the File. Then use the installation procedure to apply the corrected file.
Make sure that [script] and active_script are spelled correctly. If the script does not load, make sure that its file exists and is compatible with the controller.