Difference between revisions of "Control Chain"

From MOD Wiki
Jump to navigation Jump to search
 
(8 intermediate revisions by 3 users not shown)
Line 6: Line 6:
  
 
The Control Chain devices are connected to the MOD using a regular Ethernet patch cable and they have two connectors, what allows a next external controller to be connected, creating then a chain. The MOD will provide power supply to the controller via the patch cable.
 
The Control Chain devices are connected to the MOD using a regular Ethernet patch cable and they have two connectors, what allows a next external controller to be connected, creating then a chain. The MOD will provide power supply to the controller via the patch cable.
 
{{note|Control Chain support is available only from version 1.4}}
 
  
 
== How to use Control Chain devices ==
 
== How to use Control Chain devices ==
Line 17: Line 15:
 
Once the controller is connected it will be automatically detected and ready to use. The actuators of each Control Chain device will show up as option to be mapped in the plugin configuration screen. See [[Chapter 2: Web interface#Accessing plugin configuration screen|accessing plugin configuration screen]] for details.
 
Once the controller is connected it will be automatically detected and ready to use. The actuators of each Control Chain device will show up as option to be mapped in the plugin configuration screen. See [[Chapter 2: Web interface#Accessing plugin configuration screen|accessing plugin configuration screen]] for details.
  
[[File:footex-assignment.gif|thumb|none|680px|Control Chain devices list]]
+
[[File:footex-assignment.gif|thumb|none|680px|Assigning a control to a Control Chain actuator]]
  
 
To see a list with all connected Control Chain devices click on the Control Chain icon on the bottom-right of the screen.
 
To see a list with all connected Control Chain devices click on the Control Chain icon on the bottom-right of the screen.
Line 29: Line 27:
 
[[File:cc-device-upgrade-available.jpg|border|510px]] [[File:cc-device-download.jpg|border|510px]]
 
[[File:cc-device-upgrade-available.jpg|border|510px]] [[File:cc-device-download.jpg|border|510px]]
  
=== Upgrading the Footswitch Extension device (FootEx) ===
+
=== Upgrading the MOD Footswitch ===
  
# Disconnect the FootEx device from the Control Chain port
+
# Disconnect the MOD Footswitch from the Control Chain port
# Hold down the footswitch #1 on the FootEx device
+
# Hold down the footswitch #1 on the device
# While the footswitch is pressed, connect the FootEx to the MOD via USB cable
+
# While the footswitch is pressed, connect the MOD Footswitch to the MOD via USB cable
 
# Wait for the "update completed" message
 
# Wait for the "update completed" message
# Disconnect the FootEx from the USB port
+
# Disconnect the MOD Footswitch from the USB port
 
# Connect it to the Control Chain port once again
 
# Connect it to the Control Chain port once again
  
Line 43: Line 41:
  
 
The Arduino based devices have to be updated manually, via Arduino IDE. Please check the [https://github.com/moddevices/cc-arduino-lib cc-arduino-lib] documentation to see how to proceed with the upgrade.
 
The Arduino based devices have to be updated manually, via Arduino IDE. Please check the [https://github.com/moddevices/cc-arduino-lib cc-arduino-lib] documentation to see how to proceed with the upgrade.
 +
 +
=== Troubleshooting ===
 +
 +
If you are having problems trying to upgrade the device via Web GUI for example, the GUI doesn't recognize the device connection, please follow the below instructions in order to manually upgrade the firmware of your device.
 +
 +
==== MOD Footswitch ====
 +
 +
# Disconnect the MOD Footswitch device from the Control Chain port
 +
# Hold down the footswitch #1 on the device
 +
# While the footswitch is pressed, connect the MOD Footswitch to the MOD via USB cable
 +
# Open a terminal and execute the command below
 +
 +
    curl http://download.moddevices.com/releases/cc-firmware/v2/file/mod-footswitch-latest.bin | ssh root@192.168.51.1 "cat > /tmp/mod-footswitch-latest.bin && nxp-usb-isp /tmp/mod-footswitch-latest.bin"
 +
 +
If you see the message ''"Firmware update complete!"'' your device was successfully updated to the latest version.

Latest revision as of 12:40, 25 March 2023

About

Control Chain is an open standard developed by MOD Devices that defines communication protocol, electrical specification, cables and connectors. It's used to interconnect external controllers (a.k.a peripheral devices) as expression pedals and foot-switches extension to MOD devices, for example the MOD Duo.

Comparing to MIDI, Control Chain is way more powerful. For example, instead of using hard-coded values as MIDI does, Control Chain has what is called device descriptor and its assignment (or mapping) message contains the full information about the parameter being assigned, such as parameter name, absolute value, range and any other data. Having all that information on the device's side allows developers to create powerful peripherals that can, for example, show the absolute parameter value on a display, use different LED colors to indicate a specific state, etc.

The Control Chain devices are connected to the MOD using a regular Ethernet patch cable and they have two connectors, what allows a next external controller to be connected, creating then a chain. The MOD will provide power supply to the controller via the patch cable.

How to use Control Chain devices

The external controllers are connected using an Ethernet patch cable coming from the MOD Control Chain port to the Main port of the controller. To connect the next controller the cable should connect the Next port of the previous controller to the Main port of the next controller.

Footswitch-rear.jpg

Once the controller is connected it will be automatically detected and ready to use. The actuators of each Control Chain device will show up as option to be mapped in the plugin configuration screen. See accessing plugin configuration screen for details.

Assigning a control to a Control Chain actuator

To see a list with all connected Control Chain devices click on the Control Chain icon on the bottom-right of the screen.

Control Chain devices list

How to upgrade Control Chain devices

Once a new firmware of a Control Chain device be available the Web interface will warn you. To proceed with the upgrading click on Download button to download the latest firmware and then follow the instructions on the screen that is also replicated here.

Cc-device-upgrade-available.jpg Cc-device-download.jpg

Upgrading the MOD Footswitch

  1. Disconnect the MOD Footswitch from the Control Chain port
  2. Hold down the footswitch #1 on the device
  3. While the footswitch is pressed, connect the MOD Footswitch to the MOD via USB cable
  4. Wait for the "update completed" message
  5. Disconnect the MOD Footswitch from the USB port
  6. Connect it to the Control Chain port once again

Note: The upgrade should only take a few seconds.

Upgrading Arduino based devices

The Arduino based devices have to be updated manually, via Arduino IDE. Please check the cc-arduino-lib documentation to see how to proceed with the upgrade.

Troubleshooting

If you are having problems trying to upgrade the device via Web GUI for example, the GUI doesn't recognize the device connection, please follow the below instructions in order to manually upgrade the firmware of your device.

MOD Footswitch

  1. Disconnect the MOD Footswitch device from the Control Chain port
  2. Hold down the footswitch #1 on the device
  3. While the footswitch is pressed, connect the MOD Footswitch to the MOD via USB cable
  4. Open a terminal and execute the command below
   curl http://download.moddevices.com/releases/cc-firmware/v2/file/mod-footswitch-latest.bin | ssh root@192.168.51.1 "cat > /tmp/mod-footswitch-latest.bin && nxp-usb-isp /tmp/mod-footswitch-latest.bin"

If you see the message "Firmware update complete!" your device was successfully updated to the latest version.