Testing External Controls

1. Open the External Control Systems dialog box by clicking on the Control Systems button toolbar in the processing workspace and click External Controls.
2. In the dialog that opens, click on the Command tab.
3. Open the property dialog for the Command external control by clicking on the hyperlink.
4. Click on the button in the property dialog for the command control. (in the example above, this is the button labeled ‘Command Control’)

5. Observe that the string <C&0> appears in the putty telnet window:

   

   This test tells you that the external control system (PuTTY) is connected and working with the Halogen control server. When you clicked on the Command button, the Halogen control system sent a ‘command’ message informing the external control system that the command with number 0 just fired.

6. Assert the Baseline preset in Halogen and observe that Baseline is now in the priority 1 position in the Active Preset list.

7. Send a ‘command’ message to the Halogen control server by typing <C&0> into the PuTTY window and pressing the Enter key. You should now see that the Command Preset is in priority 1 position in the Active Preset window because the external control system caused that preset to assert. (Remember that the Command external control is linked to the Command Preset Assert button)

   

1. In the External Control Systems dialog click on the Level tab.
2. Open the property dialog for the Level external control and set the level to 50% by typing 50 in the text box and then press the Enter key.

3. Observe that the Level external control and the Level block’s level control both change to be mid-scale and that the string <L&1&500> appears in the putty telnet window:

   

   When you changed the Level external control from within the HAL system, the Halogen control server sent a ‘set level’ message, telling the external control system that the Level control with number 1 is now set to 50.0%.

4. Set a new value for the level control by typing the string <L&1&885> into the telnet window and then press the Enter key. The Halogen control server receives this message and sets the Level external control to a value of 88.5%, which causes the control in the Level block to become 0.5dB. This happens because the external control is linked to the control in the Level block.

   

1. In the External Control Systems dialog click on the Toggle tab.
2. Open the property dialog for the Toggle external control and observe that its state is currently unchecked.
3. Send a ‘get toggle’ message to the Halogen control server for control number 2 by typing the string <T&2> into the telnet window and pressing the Enter key.
4. Observe that <T&2&0> appears in the telnet window, which the Halogen control server sends in response to the ‘get toggle’ message. This tells the external control system that the current value of toggle control number 2 is 0, meaning that the toggle is un-checked.
5. Send a ‘set toggle’ message to the Halogen server to change toggle control number 2 to checked. Do this by typing <T&2&1> into the telnet window and pressing the Enter key.
6. The Halogen control server receives this message and sets toggle control number 2 to the checked state, which also causes the Level block’s Mute toggle to become checked:

1. In the External Control Systems dialog click on the Select tab.
2. Open the property dialog for the Selector external control and observe that the selection is currently set to the first item (Input 1).
3. Send a ‘get selection’ message to the Halogen control server by typing the string <S&3> followed by the Enter key. This asks the Halogen control server to send the current selection value for Selector control number 3.
4. Observe that Halogen responds by sending <S&3&0> to the external control system, indicating that Selector control number has a current selection of 0.
5. Send a ‘set selection’ message to select the third item in the list by typing the string <S&3&2> into the telnet window and pressing the Enter key.
6. Observe that the Halogen control server receives this message and sets the selection to Input 3 on both the Selector external control and the Selector block control. Selections are counted sequentially, starting with 0 for the first item in the list.



7. Ask the Halogen control server for the number of selections in Selector external control number 3 by typing the string <SL&3> into the telnet window and then pressing the Enter key. This is a ‘get selector link’ message.

8. Observe that Halogen responds with the string <SL&3&4>, a ‘set selection link’ message indicating that Selector control number 3 has four selections.

9. Now send a ‘get selection name’ message for each selection by typing in four messages: <SN&3&0> <SN&3&1> <SN&3&2> <SN&3&3> followed by the Enter key. This asks Halogen to send the names of each of the four selection items, which are numbered from 0 to 3.

10. Observe that the Halogen control server responds with four ‘set selection name’ messages: <SN&3&0&Input 1>, <SN&3&1&Input 2>, <SN&3&2&Input 3>, and <SN&3&3&Input 4>. These messages inform the external control system of the display names for each of the four selections in selector control number 3. These are the same strings that appear in the LCD-like text boxed for the Selector external control:

    

note: Even though the Halogen control server sends ‘set selector link’ and ‘set selection name’ messages to the external control system, you can’t change the number of selections or the names by sending these messages to Halogen. They are a one way only type of message, meant to inform an external control system of the state of the selector controls so that it can update its own configuration if desired.