Skip to content
DMX Core

Config Utility

Download

Download the latest version of the Config Utility from GitHub releases. Binaries are provided for Windows and macOS. Note that the current version of the config utility is text-based.

Start the application

Launch the application by double-clicking DmxRemapperConfig.exe on Windows (currently only supporting Windows 64-bit; more platforms coming later).

The Config Utility is a text-based, menu-driven application that interacts directly with the Pico 2 Re-Mapper. When launched it will iterate through all serial ports on your computer and query for the Re-Mapper firmware. Once found it will say: Found Pico device, serial ******** on port COM**.

The menu options are:

  • Read DMX
  • Get Mapping
  • Modify Mapping
  • Revert Mapping
  • Write Mapping to Flash
  • Write Mapping to local file
  • Read Mapping from local file
  • Reset Mapping
  • Read Status
  • Quit

Read DMX

Reads the last received DMX frame from DMX port A and outputs it on the screen. The channel number (1–512) is shown in gray and the current value (0–255) in green.

DMX Read screen

Get Mapping

Reads the current running mapping from the Re-Mapper. Note that this doesn’t necessarily match what is stored in flash memory — as you modify the mapping it’s only in volatile RAM until you write it to flash. Get Mapping reads what is currently in RAM.

Modify Mapping

Modify the mapping one channel at a time. Select the output channel you want to modify (1–512), then choose to map it to one of the input channels (1–512) or set it to a fixed value (0–255). Once completed the mapping is immediately sent to the device. It is only written to RAM; write to flash if you want it to be permanent.

Revert Mapping

Re-reads what is in flash memory into RAM — the same as a power cycle. Any mapping modified in RAM will be lost.

Write Mapping to Flash

Writes the current mapping (in RAM) to the device flash memory, making it permanent across power cycles.

Write Mapping to local file

Writes the current mapping to a file named Mapping_*******.yaml in the current directory (the * part is the device serial number). The file can be opened with any text editor for bulk changes. The format is a list of output channels, each mapped to either input-*** or fixed-***.

Example:

configVersion: 1.0
output:
  1: input-1
  2: input-2
  3: input-3
  4: input-4
  5: fixed-5
  6: input-6
  ...

Read Mapping from local file

Lists all *.yaml files in the current directory and lets you select one. The selected mapping is loaded into the device RAM immediately. Remember to write to flash if you want it to be permanent.

Reset Mapping

Resets the mapping in RAM to a straight 1:1 pass-through from input to output.

Read Status

Displays details about the current DMX input stream: how many frames have been received since power-up, and the current frame rate (based on the last second).

Quit

Quits the application. You can also close the window or unplug the device.