Documentation Wiki rss-feed

Workbench Tutorial 6

The Controller Agent allows you to adjust the value of a setting in an agent in your setup from a key on your instrument keyboard. Controllers are used extensively in the factory setups to allow adjustment of parameters such as volume, pan, tempo etc. In this tutorial we will add a Controller Agent to the setup and use it to control the volume of the Console Mixer channels.

The first step is to start EigenD and start Workbench and load the setup you saved at the end of Tutorial 5. Your setup should look something like this.


Select the Create Tool and click on the canvas. Select Controller from the list of agents and click OK. The agent Controller 1 will be created. As was the case with the Talker Agent in the previous tutorial, we need to connect the controller to the keyboard in some way. We can use the same Keygroup Output that we created in the last tutorial. Select the Wiring Tool and, with Keygroup 1 expanded, make a connection between Keygroup Output 3 and the new Controller 1 agent.


Expand the Controller 1 agent and you will see that it has a port named 'Connector' which has a button labelled '+' in the top right hand corner.


The 'Connector' port is somewhat analogous to the 'Key' port on the Talker agent. Click on the '+' button (or click on the 'Connector' port itself with the Create Tool). A dialog is displayed


click OK. Now expand the 'Connector' port and you will see a new port named 'Connector 1' has been created.


With the Edit Tool click on the Connector 1 port and a dialog will be displayed which allows you to set the Key Column and Key Row for this connector.


These parameters define the position of the key which you will be able to press to adjust the volume. We have already used the keys in rows 1,2 and 3 in Column 1 for the talker that we set up in the previous tutorial. We will use the key in Column 2, Row 4 for this connector so that it is easily distinguishable from the talker keys. Once again it is worth noting that we could have used any of the rectangular keys (the round keys won't work for controllers) and it can be easily changed later . Enter 2 in the Key Column box and 4 in the Key Row box and close the dialog.

The next step is simply to connect the 'Connector 1' port to the port whose value you want to control. In this case we have decided to control the volume of channel 1 of the console mixer. So expand Mixer Channel 1 in the console mixer. You will see a port named 'Controls'. Expand that port as well to reveal 'Pan' and 'Volume' ports.


Using the Wiring Tool make a connection between the 'Connector 1' port in the Controller 1 agent and the 'Volume' port in 'Mixer Channel 1'.


It is now possible to test the Controller. With the Edit Tool click on the 'Mixer Channel 1' port of the Console Mixer to display its settings.


Then select Keygroup Output 3 (our control keygroup) by pressing and holding down the mode key (we set this to the round key directly below the strip controller on the pico in the last tutorial) and pressing Key 2 in Column 1.

The first 3 keys in column 1 should be lit in orange (these are the talker keys set up in the last tutorial), but now Key 4 in Column 2 should also be orange. If you press the top of this key, you should see the volume value on the mixer channel 1 dialog decrease. Pressing the bottom of the button causes the volume to increase.

Finally, we can add another connector to Controller 1 to control the volume of Mixer Channel 2. Go back to the Connector port on Controller 1 and click the '+' button to add another connector.


Click with the Edit Tool on the newly created Connector 2 and in the dialog set the Key Column to 2 and the Key Row to 5 so that Connector 2 will use the key directly below the key used by Connector 1. Close the dialog. With the Wiring Tool make a connection between the 'Connector 2' port on the Controller and the 'Volume' port in Mixer Channel 2 on the Console Mixer.

You should now have two control keys working. Enabling you to set and adjust the volume of mixer channels 1 and 2 directly from your instrument.

Save the set up with the short tag Workbench Tutorial 6.

Back To: Building_your_first_setup_from_scratch