Skip to content

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 BinloopX supports configuring the settings of the the network sections shown below in Table 1.

Table 1

Section Network Interface
[network.A] BX-CON1 Network Port

Use these rules:

  • Each network section must contain ip, subnet, and gateway exactly once.
  • Use a contiguous subnet mask, like 255.255.255.0.
  • Do not use the network address or broadcast address for ip or gateway.
  • 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.

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 .ws6 or .ami extension.
  • 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.

  1. If the show is active, stop it.
  2. Remove power from the controller.
  3. Remove the SD card from the controller.
  4. If config.ini already exists, make a backup copy on your computer.
  5. Copy the new or updated config.ini to the root directory of the SD card.
  6. If active_script is present, copy the named script to the root directory of the SD card.
  7. Safely eject the SD card from your computer.
  8. Insert the SD card into the controller.
  9. Restore power to the controller.
  10. 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.