Home

Command Builder Manual v3.6.1

1. SSS SSS SS SS SS SS SSS SS SS SS SS SS SS SS SS SS SSS gt 2 cmd ael d Ctrl Surfl GPI Out bus42 off turn lamp off Recall On Functionality Description Launches vSnapshot Recall Mode and recalls settings to the console s RAM The command is sent to the specified Audio Engine Components This function has an ON button pressed Trigger for the specified button On Trigger Recall ON button gt Turn on reserved bus to launch vSnapshot Recall Mode gt Turn button s lamp on Off Triggers Off Triggers for these buttons are activated when the Done button is clicked on the vSnapshot Recall Page Further Information gt Bus On Off Page 55 Script Examples trigger ael d Ctrl Surfl GPI In bus43 on N SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE vSnapshot Recall ON OFF REVISED 1 February 2007 DATA ID AE1 Port1 StA Wide Softkey SCENE 12 DESCRIPTION Activate vSnapshot Recall Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS 2 2 A AAA wee AAA AAA AA A AAA AAA cmd ael device02 bus202 on turn on vSnapshot Recall Mode cmd ael d Ctrl Surfl GPI Out bus43 on turn lamp on trigger ael device02 bus202 off N SSS SSS SS SS SS SS SS SS
2. Record Start with Tally Functionality Description This function is used to start a device recording It utilizes a record tally back from the device to update the status of the button which is a Record Stop toggle If the device is put into record locally the button will illuminate and change into a stop function Likewise is the device is put into record from the remote button but stopped locally the lamp will turn off and button state reset Components This function uses an On Trigger when the button is pressed to execute the commands GPI Triggers from the device update the lamp status and button state When the record tally goes high the lamp changes from flashing set by the button to solid to indicate the recording did start Trigger Toggle State 1 Record Start gt Send pulses to MiniDisc gt Flash lamp in button Toggle State 2 Record Stop gt Send pulses to MiniDisc gt Turn off lamp in button GPI On Tally High gt Reset toggle state on button trigger device has gone into record change button to stop gt Tally lamp ON solid GPI Off Tally Low gt Reset toggle state on button trigger device stopped recording change button to record gt Tally lamp OFF Further Information If Toggle Page 146 Relay Pulse Page 70 Lamp Flash Page 57 Bus On Off Page 55 Set Toggle State Page 74 VVVV WV Script Examples trigger ael surfl c
3. TIP When the Artisan surface first starts up it labels the meters for Aux 1 4 and Submasters 1 8 Then when Supervisor starts up it looks to see if there are any aliases for every source on the system and if there is no alias it sends out a blank string for every device with an alias This means that once Supervisor starts all of the labels for Aux 1 4 and Submasters 1 8 on the Artisan are overwritten by the blank aliases The following example contains the neccessary commands for inclusion in an Init Trigger or Procedure called from the Init Trigger or Surface Reset Trigger to ensure that meter text labels are written to the Master Screen on an Artisan connected to Audio Engine 1 cmd ael s Sub 1 Pre Fdr Out set alias Sub 1 cmd ael s Sub 2 Pre Fdr Out set alias Sub 2 cmd ael s Sub 3 Pre Fdr Out set alias Sub 3 cmd ael s Sub 4 Pre Fdr Out set alias Sub 4 cmd ael s Sub 5 Pre Fdr Out set alias Sub 5 cmd ael s Sub 6 Pre Fdr Out set alias Sub 6 cmd ael s Sub 7 Pre Fdr Out set alias Sub 7 cmd ael s Sub 8 Pre Fdr Out set alias Sub 8 cmd ael s Aux 1 Pre Fdr Out set alias Aux 1 cmd ael s Aux 2 Pre Fdr Out set alias Aux 2 cmd ael s Aux 3 Pre Fdr Out set alias Aux 3 cmd ael s Aux 4 Pre Fdr Out set alias Aux 4 For further details see the Artisan Manual Artisan Monitor Screen The Artisan Monitor Module MTK MON has one screen This screen does not
4. Numix II Softkeys Screen Text These commands are used to write text selections to the Numix II ne Screen cmd ae surf surface text softkey line 1 15 pos 1 51 insert Up to 51 characters cmd ae surf surface text softkey lines 1 15 Not Used clear Not Used cmd ae surf surface text softkey numix2 Not Used clear all Not Used The Softkeys Screen will display 15 lines of 51characters each The text command must contain the keyword SOFTKEY to send text to the Softkeys Screen Normal Mode erases the entire line before displaying the specified text Insert Mode overwrites the text at the LINE and POS given without erasing the entire line first This allows the user to change only one word or part of a line if necessary The keyword INSERT is used to specify Insert Mode otherwise Normal Mode is assumed An entire line of text on the Softkeys Screen can be erased or cleared by using the keyword CLEAR The POS keyword and a quoted text string are not required gt The entire Softkeys Screen can be cleared at one time by using the keyword ALL instead of a specified LINE number Specify the type of surface with the required keyword NUMIX2 when using the keyword ALL YYYY Vv The following are examples of text lines written to the Softkeys Screen in Normal Mode cmd ael surface2 text softkey line3 posl Text For Line 3 cmd ae3 surfacel text softkey line5 posl2 Second Text The following
5. A The Artisan introduces many new surface text functions and therefore some commands requiring destination addresses will be affected by the Artisan layout your surfaces use Please contact Logitek Electronic Systems or your reseller to obtain the latest information Artisan Fader Screen The Artisan Fader Module MTK FADER contains one screen shared between two faders that allows an Alias to be written The Alias is an 8 character string in large font as shown below Digital S5 S6 S7 S8 EQ DYN In RIDIN Left Figure 36 Fader Screen Artisan Label Text This command is used to write a label to an a on a Fader Screens cmd ae surfff surface chan channel text label 1234567890123456 cmd ae surf surface fader text label 1234567890123456 The label is large font text displayed in a label space directly above the fader information This label may have a maximum of 8 characters The command must contain the CHANNEL number and the keyword LABEL The LINE or POS keywords are not required for this type of text To clear the label write a blank string The label may be replaced by flashing text PENDING if a WHEN OFF command is used The label is replaced if a SET ALIAS command is issued to the source device on that fader The label is cleared when a route is performed on that fader To center a label you must manually pad the text string with spaces VVVVVVV VV The following
6. 123456789012 cmd ae Not Used d DeviceName route3 text label default 123456789012 gt With Surface Addressing use a Surface number and Channel number gt Channel number is 1 3 for the first Route 3 on a Port 4 6 for the second and so on gt With Output Addressing the device number is required gt This command supports the d Destination Device notation gt Required keywords are ROUTE3 TEXT and LABEL or DEFAULT gt The screen display in Normal Mode is divided into three columns of two lines each gt The upper line in each column is the Source Device name for the Route 3 channel gt When a new Source Device is selected this line changes automatically to the new Source Device name This upper line can not be changed in any other way The lower line in each column is a user defined text label for that channel This label may have up to 12 characters and is left justified Leading blanks are required to center short labels The user defined text label can be permanently stored as the default label within the Route 3 Whenever a new Source Device is selected for a channel that channel s default label is displayed on the lower line overwriting the current label gt When the default label is permanently stored it is also displayed on lower line for the specified channel Use the keyword DEFAULT in place of LABEL to set default text VVVV The following are examples of temporarily changing the label on a Ro
7. 2 2 2 2 cmd ael surfl chan13 bus40 off turn off Delay On lamp in this studio cmd ael asm 02 04 B1 17 29 05 fast flash Delay Off lamp in this studio cmd ael surfl chan13 bus43 off turn off Dump lamp in this studio cmd ael device2C linel35 text pos49 Delay EXIT procedure DelayTally StA Off PROCEDURE Delay Text Tally REVISED 21st February 2005 DATA ID Studio A StA Delay Off DESCRIPTION Updates delay status on Mosaic surfaces NOTES DEPENDENCIES DEBUG STATUS N SSS SSS SS SS SS SS SSS 0 222 eS eee cmd ael surfl chan13 bus41 on turn on Delay Off lamp in this studio cmd ael device2C linel35 text pos97 Delay OFF Delay Exit Method B Hard Cut Functionality Description This function turns off Talk Delay When the operator wishes to exit delay they will first press the Post Mon button to hear the delay empty At the appropriate point in time they press the Delay Off When the operator presses Delay Off button the delay is instantly killed and they are live At this time the lamps and text are also updated This method provides a fairly simple control method for operators Components The Delay Exit button has an On Trigger which performs these tasks plus a Procedure to update display tallies Button On Trigger gt Check the value of a variable if 1 then continue This prevents
8. A quoted string is not required and will be ignored if present The keyword INSERT is used to insert the temperature display text into an existing line The display is continuously updated until a TEMPERATURE CLEAR command is used The Temperature Clear command must contain the same Audio Engine Surface line and position numbers as the original Temperature command VVVV The following are examples of how to display and clear the temperature cmd ael surface2 cmd ae3 surfacel cmd ael surface2 mperature softkey insert line3 pos6 mperature big channel linel posl mperature clear softkey line3 pos6 ct ct ct TIP The clock and temperature display can be written to the Softkeys Screen if desired Logitek CommandBuilder 3 6 Reference Manual 87 PAN Y Lo gitek Numix II Screens The Numix II has one large color screen on the Selector Wedge shown on the right and a color screen per Fader Wedge left two wedges below The user can display text in certain areas of the Selector Wedge screen or on the screen of the Fader Wedge Text can be displayed in white on the top half of the Fader Wedges A label can be displayed in white at the top of each fader information section In addition a colored Message Arrow can be displayed above each fader Figure 12 Numix II Surface 88 Logitek CommandBuilder 3 6 Reference Manual ES Y Lo gitek Numix II Selector Wedge Screens The Numix II has one la
9. cmd ael surfacel 1 device28 cmd ael surfacel 1 xi device28 xi Mosaic Wide Softkey Route Select This command is described in full later in this chapter When using the Route Select command the selection can be written to the screen next to the relevant button using these locations Button 1 Button 2 Button 3 Button 4 Button 5 Button 6 108 device28 line2 pos1 device28 line6 pos1 device28 line10 pos1 device27 line2 pos1 device27 line6 pos1 device27 line10 pos1 line2 pos1 This is Text line6 posi Logitek CommandBuilder 3 6 Reference Manual Mosaic Monitor Screen The Mosaic Monitor Module MLX 34 MLX MON has one screen It does not support user text Aux 1 Program Headehones Monitor Program Program Post Diy Post Dly al a l Figure 25 Mosaic Monitor Screen Mosaic Meter Bridge Screens The Mosaic Wide Meter Bridge MLX WBRIDGE has six screens as shown below SCENE 1 Default Figure 26 Mosaic Wide Meter Bridge CommandBuilder does not have any keywords to address these screens directly Each screen has 8 lines of text available which must be addressed using the following channel 8 line numbers Mosaic Wide Meter Bridge Screens Screen 2 Usertext devicezo chan s 6572 Screen 3 Usertext devicezo chan s 129 136 ines 7 amp 8 below the monitor meter Screen Timer devicezalchan a 6572 OOOO O OOOO SO ines 7 amp
10. surface clock big chan channel _ line os clear insert cmd ae surf surface clock big fader line os clear insert gt This command is similar to the text command but uses the keyword CLOCK instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers A quoted string is not required and will be ignored if present The keyword INSERT can be used to insert the time display text into an existing line The display is continuously updated until a CLOCK CLEAR command is used The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command VVV WV The following are examples of how to display and clear the clock cmd ael surface2 clock softkey insert line3 pos6 cmd ae3 surfacel clock big channel linel posl cmd ael surface2 clock clear softkey line3 pos6 Numix Temperature This command is used to write a as ae to the a or Fader a Screens cmd ae surf surface temperature Not Used softkey line pos clear insert cmd ae surf surface temperature big chan channel _ line pos clear insert cmd ae surf surface temperature big fader line pos clear insert gt This command is similar to the text command but uses the keyword TEMPERATURE instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers
11. A quoted string is not required and will be ignored if present The keyword INSERT is used to insert the temperature display text into an existing line The display is continuously updated until a TEMPERATURE CLEAR command is used The Temperature Clear command must contain the same Audio Engine Surface line and position numbers as the original Temperature command VVVV The following are examples of how to display and clear the temperature cmd ael surface2 cmd ae3 surfacel cmd ael surface2 mperature softkey insert line3 pos6 mperature big channel linel posl mperature clear softkey line3 pos6 ct ct ct TIP The clock and temperature display can be written to the Softkeys Screen if desired 96 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Remora Screens The Remora has one large color screen for each wedge Though there are not separate Selector and Fader Wedges in the Remora it can still perform the Selection and Question Screen functions Text and labels can be displayed in white on these screens In addition a colored Message Arrow can be displayed Remora Selector Screens The Remora has a small section of the Selector Wedge Remora 4 module devoted to selector screens These are the Selections Screen and the Question Screen Each of these screens has different capabilities and requires different style text commands Due to its smaller profile the Remora does not have a separate Softke
12. DEVICE Audio Engine Device number DISCONNECT Removes a serial port connection DUMP ENDDEF ENDIF ENDWHEN EXIT FADER FLAG FLASH FRIDAY FUNCTION GREEN HOUR IF INIT INSERT LABEL LAMP LEFT LEVEL LINE LIST LIGHT Used to dump the time in a Talk Delay Defines the end of a define section Defines the end of an IF section of commands Defines the end of a WHEN section of commands Stops processing of any further commands in the current trigger same as QUIT Refers to a console Fader same as CHANNEL Sets large arrow above fader with optional text message Same as blink Day of the week used in Schedule Event trigger Refers to the function screen on the console A color used for text on Numix II color display Used in the repeat interval of a Schedule Event Trigger Begins a Conditional Trigger or Test Statement A Trigger that is executed whenever Supervisor is started Sets the insert mode for user text strings the line is not erased before the text is displayed Text to the screen above a Fader on a console Refers to the Lamp in a Button same as LIGHT Used in setting Fader pan Used to set console Fader level Line number for user text strings displayed on a console A mode of the selection screen alternate to the message mode Refers to the Lamp in a Button same as LAMP MAGENTA MAX MESSAGE MINUTES MIX MINUS MIX MONDAY NONE NORMAL NOTACTIVE NOT NUMIX1 NUMIX2 OFF ON ONEWAY
13. Supervisor checks the event to see if it has a matching trigger for that command If a trigger exists Supervisor processes the logic and commands of the trigger If the trigger contains Audio Engine commands Supervisor sends these to the Engine The Audio Engine executes the commands or for lamp text displays sends it to the surface The Surface executes the commands Soe AS Surface Audio Engine Supervisor Control surface Audio Engine executes and Supervisor logs command and Supervisor checks for a matching Sends compaua sends a copy to updates Audio trigger for that to Audio Engine Supervisor Engine status command Surface executes E Speni son sends Supervisor command commands and elos P RER trigger sends to surface audio none Figure 2 Trigger execution Logitek CommandBuilder 3 6 Reference Manual Lo gitek 3 Installing CommandBuilder This chapter describes the first time installation of CommandBuilder If you are upgrading CommandBuilder to this version certain aspects of this chapter are also relevant Software Installation The Logitek CommandBuilder software will be supplied via Email or download from the Logitek website Logitek software is developed without reliance on components that are not standard in Windows Upon first execution CommandBuilder will setup default registry keys and make configuration
14. The types of text that can be displayed include user defined text strings a continuously updated time display and a continuously updated temperature display generated by an external device The time display is obtained and formatted from the Supervisor PC s current Windows time format The temperature is formatted in the System Administrator gt External Devices tab in Supervisor A number of menu based text display commands is also available for obtaining user selections ROC Screens The ROC5 and ROC10 Surfaces are early generation Logitek consoles As these were designed and sold before the existence of Supervisor their text display capabilities are limited The ROC5 and ROC10 have a small screen that supports a clock display Figure 10 ROC Clock ROC Clock This command is used to write a clock display to the ROC5 or ROC10 cmd ae Not Used clock d Device Name line1 pos clear insert cmd ae surf surface clock chan channel line1 post clear insert gt This command requires the keyword CLOCK gt CHAN30 LINE1 POS1 is used for the ROC clock display gt The channel can also be specified as d Ctrl Surfl GPI In orsimilar gt Large size text is not supported on the ROC Surface gt A quoted string is not required and will be ignored if present gt The keyword INSERT is supported but not required for the ROC5 display space gt The display is continuously updated until a CLOCK CLEAR command is used
15. cmd ae surf surface text chan channel insert line pos 52 chars cmd ae surf surface text fader insert line pos 52 chars gt Large text is displayed on the upper half of the screen as 4 lines of 52 characters gt Large text can be displayed as 1 line of 52 characters in conjunction with small text below gt The command must contain a CHANNEL or FADER number of the Fader Wedge the keyword BIG and can be written to LINE 1 LINE 2 LINE 3orLINE 4 Use CHANNEL 1 for the first wedge CHANNEL 7 for the second and so on gt gt To clear a line write a single space string to that line without the INSERT keyword gt Use the keyword INSERT to replace only the written text and keep other text on the line The following are examples of large font text commands written to the Fader Wedge ji cmd ael surfacel tex cmd ael surfacel tex big channel big channel linel posl This is Text line3 pos21 cd ct o Logitek CommandBuilder 3 6 Reference Manual 93 Logitek Numix II Label Text This command is used to write a label to an os on the Fader i Screens cmd ae surfff surface chan channel text label 12345678 cmd ae surf surface fader text label 12345678 gt The label is large font text displayed in a label space directly above the fader information gt This label may have a maximum of 8 characters gt The channel label text line
16. gt Any Procedure can call other Procedures within itself The following is an example of the Call Procedure command call SurfacelAllFadersOff See Chapter 11 for more information on writing Procedures Logitek CommandBuilder 3 6 Reference Manual 73 Lo gitek Set Trigger Active Not Active Controls whether an an nin will be executed s uiaiia cmd set trigger active notactive TriggerDefinition TriggerDefinition gt When a General Trigger has been set not active it will not execute the specified action commands when the Trigger event occurs It can be enabled again by using the Set Trigger Active command gt The required keywords are SET TRIGGER and either ACTIVE or NOTACTIVE gt The definition of the General Trigger that is to be set active or not active should follow the keywords The General Trigger should exist before using the Set Trigger Active Not Active command The optional parenthesis around the General Trigger definition increases user readability If the specified General Trigger that has been set not active is a Toggle Trigger it may still have it s toggle state changed using a Set Toggle State command and its Toggle state tested using an If Toggle Equal statement YYY The following are examples of the Set Trigger Active Not Active command cmd set trigger notactive ae3 d Portl Fader 4 In bus0 off cmd set trigger notactive ael surface2 device 0105 bus0 on cmd set trigg
17. medium fast artisan tally cmd ae Not Used diDevice Name chon set color RGB151515 slow medium fast artisan tally gt The Channel On buttons on the Artisan support a variety of colors and flash rates gt To set fixed colors for specific faders use the Init Trigger and send the color command using a SURFACE and CHANNEL or FADER DEVICE number or d Device notation gt To change colors based on a particular input establish a Route Trigger and send the appropriate color command using the s Source notation gt The color value is set with individual Red Green and Blue values from 0 15 gt Values higher than 15 for each color are not allowed and will result in an error gt Due to the inherent properties of the three colored LEDs many color combinations may be dull or unattractive The values below are a recommended starting point gt The keyword ARTISAN must be used gt The keyword TALLY must be used This allows the setting of color based on a High ON or Low OFF tally gt An optional keyword SLOW MEDIUM or FAST can be used to set a flash rate on the lamp gt A flash rate of O is assumed if the keyword is omitted and equates to solid illumination gt The lamp can be set to flash even when its current state is off gt It is not possible to set the flash rate without setting color values Colors and flash rates are stored in the lamp and apply when it next comes on Turning the lamp or switch off does not reset the s
18. test condition statement ON OFF ROUTE NOT ROUTE then If the conditions are true then the command block is executed The Action Commands for a specified set of conditions must appear between the IF STATE Test Statement and its corresponding required ENDIF keyword The required state keyword must be ON OFF ROUTE or NOT ROUTE The keyword THEN is optional but recommended for improved code readability The EQUALS sign is not required The parentheses are optional when there is only one test condition The parentheses are required for multiple sets of conditions see following Vv VVVVV The following are examples of the If State statement with only one test condition if state ael surface3 channel3 bus0 on then cmd ael surface3 route s ISDN 2 to d Portl Fader3 In endif if state ael surface2 route device 010C to channel 6 then cmd ael surface2 d Portl Fader3 In bus0 off endif if state ae3 surface2 not route s CD 1 to d Port2 Fader5 In then cmd ae3 surface2 d Portl Fader5 In bus0 on endif If State And Tests the state of a conditions in a a Audio ale All must evaluate to true if state first test condition AND second test condition then The If State Test Statement can be combined with itself to test multiple states If all of the individual Test Statements are true the block of commands is executed Each separate statement must be enclosed in parenthesis and joine
19. 8 135 amp 136 below the delay tally LCD Main meter label device2b chan43 16 16 characters available Mosaic Narrow Meter Bridge Screens Screen Notes Left Monitor meter amp usertext device2b chan 3 18 Right Monitor meter amp user text devicezo chan a 18 T6 characters available Studio A Pst e TX Studio A Pst 11 18 EXCH TX A SCENE 1 SDN Studio A PGM 09 AM Default Figure 27 Mosaic Wide Meter Bridge Screens 1 3 Mosaic Clock This command is used to write a clock display to the Meter Bridge Screens cmd ae surf surface clock chan channel line clear This command enables a large clock display on screen 1 of the Mosaic Meter Bridge For the Mosaic Wide Meter Bridge use CHAN33 LINE15 to set the clock A standard text clock can also be written to other screens if desired The display is continuously updated until a CLOCK CLEAR command is used The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command VVVVV The following are examples of how to display and clear the clock cmd ael surfacel clock chan33 linel5 cmd ael surfacel clock clear chan33 linel5 Mosaic Meter Bridge Text This command is used to write text to the Meter Bridge Screens cmd ae surf surface text device insert line pos See below 18 chars cmd ae surf surface text chan insert lines pos See below 18
20. Guest 1 cmd ael surfacel text selection linel0 posl Guest 2 The following is an example of placing the Selections Screen into the Message Mode and then displaying several lines of text Note that none of the lines will be displayed until line 6 is sent to the surface cmd ael surfacel selection message mode cmd ael surfacel text selection linel posl Assign Studio 2 To cmd ael surfacel text selection line2 posl Spare Tx cmd ael surfacel text selection line6 posl Yes No See Chapter 9 for more information on Conditional Triggers for button presses Logitek CommandBuilder 3 6 Reference Manual gt Y Lo gitek Logitek CommandBuilder 3 6 Reference Manual 81 Lo gitek Numix I Softkeys Screen Text These commands are used to write text selections to the Numix eee Screen cmd ae surf surface text softkey line 1 pos 1 21 insert One to 21 characters 6 cmd ae surf surface text softkey line 1 Not Used clear Not Used 6 cmd ae surf surface text softkey numix1 Not Used clear all Not Used gt The Softkeys Screen will display six lines of 21 characters each gt The text command must contain the keyword SOFTKEY to send text to the Softkeys Screen gt Normal Mode erases the entire line before displaying the specified text This provides a fast way to erase any old text and be sure that only the specified text is displayed on the line gt Insert
21. NOTES DEPENDENCIES DEBUG STATUS N SSS SSS SS SS SS SS SSS 2 2 2 2 2 eee cmd ael surfl chanl3 bus41 on turn on Delay Off lamp in this studio cmd ael device2C linel35 text pos97 Delay OFF Delay Exit Method C Next Event Functionality Description This function turns off Talk Delay When the operator presses Delay Off monitoring is changed to Post Delay and tallies are updated to show Exit Ready This arms all of the fader ON buttons and the next ON button that is pressed will activate the cut to live program This method is well suited to stations that will fire an event eg CD track or hard disk replay from a GPI activated source It provides a very tight and definite cut over point whilst still being easy to use Components The Delay Exit button has an On Trigger which performs tally amp status updates and a Procedure to exit delay In addition a Trigger is required for every fader BUSO ON event on that surface These will check the status of the delay variable and execute the exit procedure if required Button On Trigger Check the value of a variable if 1 then continue This prevents exiting delay again Update delay status variable 2 delay exit ready this arms the fader exit routine Set toggle state on Post Swap button see Post Swap function above Update Post Swap variable optional t
22. Update a previous installation whose Supervisor program is version 3 6 This installation will NOT copy the previous Supervisor profile data and Registry entries Exit setup and manually copy files to my PC 28 May 2009 Figure 3 Setup3 6 Installation Type Choice The CommandBuilder program doesn t require any auxiliary or special files to run The program creates user named trigger table files that are read or stored as ASCII text files with the file extension txt Some features of the CommandBuilder program require data available only in the aec al6 and nco files created by the AEConfig program For this reason it is recommended that the Trigger Tables be in the same folder as the AEConfig configuration files Logitek CommandBuilder 3 6 Reference Manual 19 Logitek 4 Working with Trigger Table files This chapter outlines how to create save read and upload Trigger Table files You do not need to be familiar with Trigger programming to use these functions The files are standard ASCII txt files with the addition of trigger and line numbers throughout the file Whilst the files can be viewed and edited in a standard text editor care should be taken not to disrupt the structure of the file in particular no lines should be deleted or added CommandBuilder provides the ability to copy and paste blocks of Triggers and Procedures to allow for faster duplication of similar code Advanced users can also directly e
23. UserName notation or ip 100 100 1 1 address bracket notation gt The destination port number is specified using the required keyword PORT gt The data to send must be enclosed in quotes The following are examples of the Text to UDP Port command cmd udp ip 192 100 67 1 port 10300 Text to 192 100 67 1 Port 10300 cmd udp u PC 12345 port 10600 Hello World Logitek CommandBuilder 3 6 Reference Manual e Lo gitek Text to Com Port Sends an ASCII text aa out the a ee Com Port cmd port Data enclosed in Quote marks Hex Bytes within lt gt marks The Com Port is assumed to have been configured and opened in Supervisor The required keyword is PORT The destination port must be included This is the Com Port number assigned in Windows The data to send should be enclosed in quotes lt 00 gt Numbers enclosed in lt gt are treated as hex bytes Common ASCII code shortcuts can also be used as listed below VVVVVV Hex ASCH Code nis fo The following are examples of the Text to Com Port command 22 This is Text to Port 22 16 Hello World cmd port cmd port This command can be used to send text to a BetaBrite scrolling LED panel This has been used at a number of Logitek sites around the world The following example will send text to a BetaBrite sign cmd port 3 lt nul gt lt nul gt lt nul gt lt eot gt lt 1c gt lt 2d gt G Day Fellas For more information on th
24. bus61 on A ll a PROCEDURE CD Play Tally v1 1 for DENON DN C635 REVISED 9th May 2006 DATA ID CD1 Play ON DESCRIPTION Fader label in response to tally GPI NOTES DEPENDENCIES The if state prevents pulsing Play GPI from overwriting EON on fader with the DENON DN C635 DEBUG STATUS if state ae1 d Ctrl Surf1 GPI In bus 62 off is EOM Tally Off cmd ae1 surfi s 458 CD 1 text label PLAY label fader endif Figure 9 CommandBuilder Edit Triggers page Logitek CommandBuilder 3 6 Reference Manual 31 Le a Logitek Navigation Buttons A group of buttons is provided to move quickly between items in the table without going back to the list view Many of these buttons also have keyboard shortcuts listed at the end of this chapter The First button will display the first Trigger or Procedure in the file The Prev button will go the previous Trigger or Procedure in the list This item will be displayed even if it is blank The Next button will go to the next Trigger or Procedure in the list This item will be displayed even if it is blank The Last button will display the last Trigger or Procedure that has a name that is not blank The Go To button allows an item number to be entered in the box Pressing the Go To button or Enter will display the numbered Trigger or Procedure even if it is blank Function Buttons The Edit Triggers and
25. cmd ael s St731 Mic 2 text label MUTE tally label to fader cmd ael d St731 Guest 1 H P bus13 on guest mute lamp on endif trigger ael d St731 Guest 1 H P bus33 off N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSE PROCEDURE Cough Mute REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic Mute OFF DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS cmd ael s St731 Mic 2 bus8 off cough mute off cmd ael s St731 Mic 2 text label tally label to fader cmd ael d St731 Guest 1 H P bus13 off guest mute lamp off Lamp Tallies Functionality Description Tallies the microphone on off lamps on the GST 22 panel when the console operator turns the mic on or off The microphone input can be on any fader of a surface the command is registered whenever a matching instance of the mic input is changed on any Surface of the specified Audio Engine Even if you do not give the guest control of their mic on off you should include these Triggers to provide the guest with tally status when their mic is turned on or off by the console operator Components This function has an ON mic turned on and an OFF mic turned off Trigger for the mic channel On Trigger Scan surface
26. cmd ael surfl chan13 bus37 on turn lamp on cmd ael device0001 bus03 on GPI on cmd set active trigger ael surfl chanl4 bus37 off endif trigger ael surfl chanl4 bus37 off PROCEDURE CD Preview REVISED 18th May 2005 2 DATA ID CD1 Preview OFF DESCRIPTION Puts CD on off cue Sends GPI to CD NOTES DEPENDENCIES DEBUG STATUS 2 2 2 cmd ael surfl s StA CD 1 bus02 off Cue off cmd ael surfl chan13 bus37 off turn lamp off cmd ael device0001 bus03 off GPI off cmd set notactive trigger ael surfl chan14 bus37 off Quick Record Functionality Description This function will change desired faders eg microphones and telephone channels to a record bus and change the monitoring to suit Pressing the button again will restore the channels to PGM and monitoring back to original state Optionally this function could also be used to send a GPI to put a device into record mode Components This is a toggle two state button function Toggle State 1 go into Quick Record gt gt gt VV V Flash the Quick Record button lamp Check if Mic 1 4 are off If Off turn off PGM bus and turn on AX1 bus Check if Tel 1 is off If Off turn off PGM bus and turn on AX1 bus set mix minus to AX1 label the Tel 1 fader to show the return path Repeat previous step for Tel 2 Store the current Monitor Operator and Guest Headphone device routes into variables Route AX1 to the Monitor Operator and Guest Headpho
27. e a Logitek Copy Trigger Procedure Block Once you have selected a block click the Copy Trigger Block or Copy Procedure Block button to copy that block into the clipboard These functions are used to duplicate Trigger and Procedure blocks Cut Trigger Procedure Block You can also cut a block of Triggers or Procedures to the clipboard using the Cut Trigger Block or Cut Procedure Block functions In addition to putting the block into memory you will be asked whether you wish to move the remaining Triggers or Procedures up to fill the cut block This is useful for moving an entire set of Triggers or Procedures to another location Paste Trigger Block The Paste Trigger Block button when clicked will pop up an option screen From this screen you can choose to Insert Before Insert After Overwrite or Cancel The first two options will insert the selected block from the clipboard to the list just before or after the item that is currently highlighted The Overwrite option will insert the selected block from the clipboard in place of the item or items that are currently highlighted The Cancel option will cancel the Pasting of the block Once you have pasted a block it is discarded from the clipboard Paste Procedure Block The Paste Procedure Block button inserts the selected block from the clipboard to the list just before the item that is currently highlighted Once you have pasted a block it is discarded from the clipboard 30 Logite
28. message To set an alias for an input see the Set Device Alias command in Chapter 12 Logitek CommandBuilder 3 6 Reference Manual 101 f Lo gitek Remora Message Arrow This command is used to a an above an a on the Fader a Screens cmd ae Not Used device dest message See on off flash pulse 12345678 cmd ae Not Used device source message List on off flash pulse 12345678 cmd ae surf surface faderk message Below on off flash pulse 12345678 cmd ae surfff surface chan channel message For on off flash pulse 12345678 cmd ae Not Used d DeviceName message Color on off flash pulse 12345678 cmd ae Not Used d LastRoute message Key on off flash pulse 12345678 C md ae Not Used s DeviceName message Words on off flash pulse 12345678 gt gt gt gt gt gt VV VVVV V v v 102 A special Message Arrow can be displayed above a fader to display an alert to the user An 8 character user defined text string is displayed above the Message Arrow More than one Message Arrow can be displayed at a time on a Remora Surface The Message Arrow will temporarily clear all but the top text line from the screen All text lines will be restored when the Message Arrow is turned off This command must include the Audio Engine number Surface number
29. small and large font text to the upper half of the screen and large font text to the label section of a fader This screen will also display a special Message Arrow in the upper half of the screen The Supervisor computer clock and an external temperature device can also be displayed Each Fader Wedge can display two text sizes but the sizes can not be mixed on the same screen When the size of text is changed all text of the other size is cleared from the screen CITIES The Biggest 69 00 69 00 Trin 8d6 Pon A RCS A RCS HKY 3 Figure 10 Numix Fader Screen Mene P on E Phone CODY CD 2 f Prod Ne Figure 11 Numix Fader Screen showing clock Logitek CommandBuilder 3 6 Reference Manual 83 Lo gitek Numix I Small Font Text This command is used to write a small font text to the sens half of the Fader in Screens cmd ae surf surface text chan channel insert line pos 36 chars cmd ae surf surface text fader insert line os 36 chars Small text is displayed on the upper half of the screen as 12 lines of 36 characters This text is divided into two columns of six lines each There are two lines for each channel on the surface The first three channels are the left column the second three channels are the right column Channels 1 6 are on the first wedge 7 12 on the second and so on The command must contain the CHANNEL or FADER number
30. surface clock big chan channel _ line os clear insert cmd ae surf surface clock big fader line os clear insert gt This command is similar to the text command but uses the keyword CLOCK instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers A quoted string is not required and will be ignored if present The keyword INSERT can be used to insert the time display text into an existing line The display is continuously updated until a CLOCK CLEAR command is used The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command VVV WV The following are examples of how to display and clear the clock cmd ael surface2 clock softkey insert line3 pos6 cmd ae3 surfacel clock big channel linel posl cmd ael surface2 clock clear softkey line3 pos6 Numix II Temperature This command is used to write a as ae to the a or Fader a Screens cmd ae surf surface temperature Not Used softkey line pos clear insert cmd ae surf surface temperature big chan channel _ line pos clear insert cmd ae surf surface temperature big fader line pos clear insert gt This command is similar to the text command but uses the keyword TEMPERATURE instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers
31. to d Portl Headphones In route AX2 to headphones cmd ael route s Portl Aux 2 Out to d Portl Studio In route AX2 to guest headphones endif Toggle Off if toggle 2 cmd ael bridge lamp05 off if state ael cmd ael sur cmd ael sur cmd ael sur endif Fh FH Fh if state ael cmd ael sur cmd ael sur cmd ael sur endif Fh FH Fh if state ael cmd ael sur cmd ael sur cmd ael sur endif Fh FH Fh if state ael cmd ael sur cmd ael sur cmd ael sur endif Fh Fh Fh if state ael cmd ael sur cmd ael sur cmd ael sur cmd ael set cmd ael sur endif Fh FH Fh Fh if state ael cmd ael sur cmd ael sur cmd ael sur cmd ael set cmd ael surf endif Fh FH Fh 1 cmd recall ael cmd recall ael cmd recall ael endif scan surfl L s S sur sur sur s Stl Mic 1 bus01 off is Mic 1 off PGM tl Mic 1 bus01 on PGM on tl Mic 1 bus03 off AX1 off tl Mic 1 bus00 off channel off surfl s Stl Mic 2 bus01 off is Mic 2 off PGM tl Mic 2 bus01 on PGM on tl Mic 2 bus03 off AX1 off tl Mic 2 bus00 off channel off surfi s Stl Mic 3 bus01 off is Mic 3 off PGM tl Mic 3 bus01 on PGM on tl Mic 3 bus03 off AX1 off tl Mic 3 bus00 off channel off surfl s Stl Mic 4 bus01 off is Mic 4 off PGM tl Mic 4 bus01 on PGM on tl Mic 4 bus03 off AX1 off tl Mic 4 bus00 off channel off surfl s Stl Telephone 1 bus01 off is Tel 1 off PGM tl Tel
32. 0 SharcAttack REVISED 22nd February 2005 DATA ID AE1 Portl StA Narrow Softkey BIG 12 DESCRIPTION If on send a dump to delay If off do nothing 2 NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS if timer 112 wait 3 then cmd ael device2C linel37 text endif Post Monitor Functionality Description This function allows the operator to switch to post delay monitoring temporarily to verify they are correctly in delay The button is a toggle function and will flash while active This example also updates the Mosaic s hotkey buttons this can be omitted on Remora and Numix surfaces Components The Post Mon has an On Toggle Trigger which performs these tasks Button On Toggle Trigger State 1 Checks toggle state 1 normal 2 toggle Updates variable optional this may be referenced by other triggers Stores current Monitor and Headphones routes to variables Routes Post Delay Crosspoint output to Monitor and Headphones Flashes the Post Monitor button lamp Call procedure to update Mosaic monitor hotkey lamps see Chapter 18 for more info VVVVV V Button On Toggle Trigger State 2 Checks toggle state 1 normal 2 toggle Updates variable optional this may be referenced by other triggers Restores routes to Monitor and Headphones from variables Turns the Post Monitor button lamp off Call procedure to update Mosaic monitor hotke
33. 3 screen to Normal Mode cmd ael d MiniDisc Record route3 set normal mode Figure 37 Route 3 in Message Mode Route 3 Message Mode Text This command is used to nnn a or i to a Route 3 cmd ae surf surface chan channel route3 text line 40 characters cmd ae Not Used d DeviceName route3 text line 40 characters With Surface Addressing use a Surface number and a Channel number Channel number is 1 3 for the first Route 3 on a Port 4 6 for the second and so on With Output Addressing the device number is required This command does not support the d Destination Device notation Required keywords are ROUTE3 TEXT and LINE1 or LINE2 The line always starts at the far left so leading blanks are required to center short text lines Use an If Trigger for the CH1 and CH2 buttons to get responses to desired questions This button press can only be detected when the Route 3 is in Message Mode Normal Mode is automatically restored when the CH1 or CH2 button is pressed VVVVVVV VV The following is an example of sending two lines of text to a Route 3 display after setting it to Message Mode A response is expected by pressing CH1 or CH2 Adding an If Timer statement so that the message display times out to a No CH2 response improves usability trigger ael d Port 1 Fader 1 In route any cmd ael d Port 1 Fader 1 In route3 set message mod cmd ael d Port 1 Fader 1 In route3 text linel Send I
34. Bridge Text command detailed on the previous page Mosaic Timer The Mosaic Timer is controlled automatically on the surface There are currently no Trigger commands to alter the timer functionality When running in auto mode the timer will reset and display the source name each time a new fader is started provided that input is set to timer reset enabled Mosaic Delay Display The Talk Delay display will automatically show on Screen 6 on a Mosaic Wide Meter Bridge when the SharcAttack Talk Delay is turned on The time display and bar graph are sent by Supervisor when this function is enabled in Supervisor Lines 7 8 are available for additional delay text tally as shown above The standard Mosaic Meter Bridge Text command can be used for this See page 72 for the Talk Delay command set Artisan Screens The Artisan has color LCD screens for each fader which can be used to show fader information and labels In addition the Meter Bridge Monitor module and Wide Softkey module have screens that support user defined text All screens on the Artisan are color The Artisan has user screen space similar to a Mosaic console Like the Mosaic the Artisan is designed to be used in conjunction with a new software application vScreen to show additional user defined information including clocks meters and text j IS AA onan SS AS ooo oe oo AE PEPE ARE A O O Figure 29 Artisan Surface
35. Description This function dumps the Talk Delay chain but keeps Talk Delay ON The delay will then rebuild Components The Delay Dump button has an On Trigger which performs these tasks plus an Off Trigger which handles status updates when the button is released Button On Trigger gt Check the value of status variable This prevents dumping when not in delay gt Send Dump command twice to dump full delay 2 lots of 4 seconds gt Write text to screen Button Off Trigger gt Sets a timer that will clear the text display 3 seconds after the button is released Further Information gt If Variable Page 147 gt Talk Delay Dump Page 72 gt Text Chapter 13 gt If Timer Page 48 Script Examples trigger ael surfl chan14 bus43 on Mosaic Narr Softkey Butt 12 press PROCEDURE Delay Dump v2 0 SharcAttack REVISED 22nd February 2005 DATA ID AE1 Portl Stl Narrow Softkey BIG 12 DESCRIPTION If on send a dump to delay If off do nothing NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS eee if vDelayStAOn 1 we are on delay at the moment cmd ael d Portl Delay CP1 In talk dump send dump to delay PGM cmd ael d Portl Delay CP1 In talk dump send dump to delay PGM cmd ael device2C linel37 text pos49 Delay DUMP endif trigger ael surfl chan14 bus43 off Mosaic Narr Softkey Butt 12 release PROCEDURE Delay Dump v2
36. Edit Procedures screens have a text editing window in which commands are created and edited The edit window works like most text editors and may be scrolled left or right and up or down Blocks of text may be highlighted by clicking and dragging the mouse over the desired text The Run Translation button will cause CommanaBuilder to scan the text and attempt to compile it Commands are not checked as you write but only when the Run Translation button is pressed The Show Translation button will display an additional Machine Hex window that shows the commands translated into Logitek hex code This window is intended for advanced debugging and error message display purposes If there is a problem translating commands to hex code the error message will be displayed in red in the Machine Hex window During debugging if you have changed the trigger you must press the Run Translation button again to retranslate the commands to hex code The Machine Hex window can be hidden by pressing the Hide Translation button The Find button finds the first Trigger or Procedure that contains the word or phrase that has been entered in the text box The Find function always scans from the first Trigger or Procedure The Find Next button finds the next Trigger or Procedure that contains the word or phrase in the Find edit box The Cut Copy and Paste buttons act like standard Windows text editing functions allowing for manipulation of highlighted text 32 Logite
37. GPI In bus88 on N gt SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Intercom On REVISED 17th February 2005 DATA ID AE1 Portl StA Wide Softkey TALK1 DESCRIPTION Routes intercom audio turns return bus on lights tally lamps NOTES DEPENDENCIES Off trigger is set active only if this trigger runs to ensure an OFF can t happen without an ON DEBUG STATUS if vIcomInUse_Edl 0 cmd cancel timerl cancel timer to allow restart in off trigger cmd cancel timer13 cancel timer from dest to prevent source lamp cancel cmd active trigger ael d Ctrl Surfl GPI In bus88 off set off trigger active cmd ae2 route s StA Micl to d Portl TalkbackRtn In route audio to talk rtn input call IcomRxOn Edl talk rtn audio on call IcomDestLampsOn_Ed1 tally destination lamps cmd ae2 surfl bridge lamp01 flash continuous flash source lamp endif trigger ael d Ctrl Surfl GPI In bus88 off N SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Intercom Off REVISED 17th February 2005 DATA ID AEl Portl StA Wide Softkey TALK1 DESCRIPTION Turns return bus off turns off tally lamps NOTES DEPENDENCIES This trigger is set active only if ON trigger runs to ensure an OFF can t happen without an ON DEBUG STATUS call IcomRxOff Edl talk rtn audio off call IcomDestLa
38. Mode overwrites the text at the LINE and POS given without erasing the entire line first This allows the user to change only one word or part of a line if necessary gt The keyword INSERT is used to specify Insert Mode otherwise Normal Mode is assumed gt An entire line of text on the Softkeys Screen can be erased or cleared by using the keyword CLEAR The POS keyword and a quoted text string are not required gt The entire Softkeys Screen can be cleared at one time by using the keyword ALL instead of a specified LINE number Specify the type of surface with the required keyword NUMIX1 when using the keyword ALL The following are examples of text lines written to the Softkeys Screen in Normal Mode cmd ael surface2 tex cmd ae3 surfacel tex softkey line3 posl Text For Line 3 softkey line5 pos12 Second Text The following are examples of text lines written to the Softkeys Screen in Insert mode This Line Base cmd ael surface2 tex cmd ae3 surfacel tex softkey line3 pos10 insert softkey line5 pos19 insert EY T The following are examples of clearing all or part of the Softkeys Screen cmd ael surface2 tex cmd ae3 surfacel tex numixl softkey clear all softkey line 5 clear A 82 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Numix I Fader Wedge Screens The screen on the Numix I Fader Wedge is capable of displaying three types of text These include
39. Reference Manual Lo gitek Applications The Init Trigger is useful for setting up various parts of your Triggers upon startup of Supervisor It can also be used to reset the state of variables toggles lamp indicators etc to a known good scenario This is particularly important if your Trigger Table performs logic tests that disable functions based on certain situations Some examples of applications for the Init Trigger are Reset Not Active Triggers Reset User Variables used for tracking statuses Write text labels to Surfaces Setup clock and temperature display on Surfaces Set maximum delay time for Profanity Delay Update lamp indicators from variables VVVVVV A Before writing an Init Trigger carefully evaluate the logic of your Trigger Table to determine what needs to be setup and reset in the Init Trigger The Init Trigger should not perform tasks that could have a detrimental effect to your on air operation Logitek CommandBuilder 3 6 Reference Manual 45 ES Logitek 9 Trigger Types Conditional Triggers Introduction A Conditional Trigger is a Trigger that is set to respond the next time the conditional event occurs A General Trigger is used to set a Conditional Trigger There are three types of Conditional Triggers IF TRIGGER IF BUTTON and IF TIMER Any Conditional Trigger can be cleared by a CMD CLEAR action command in another General Trigger A Conditional Trigger is useful for setti
40. SS yj SS SS SS SS SS SS SSS gt PROCEDURE vSnapshot Recall ON OFF REVISED 1 February 2007 DATA ID AE1 Portl DESCRIPTION Activate vSnapshot Recall Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS N SSS SSS SS SS SS SS SSS SS SS SS SS SS SS SS SS SS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS 2 cmd ael d Ctrl Surfl GPI Out bus43 off turn lamp off Edit On Functionality Description Launches vSnapshot Edit Mode The command is sent to the specified Audio Engine Components This function has an ON button pressed Trigger for the specified button On Trigger Edit ON button gt Turn on reserved bus to launch vSnapshot Edit Mode gt Turn button s lamp on Off Triggers Off Triggers for these buttons are activated when the Done button is clicked on the vSnapshot Edit Page Further Information gt Bus On Off Page 55 Script Examples trigger ael d Ctrl Surfl GPI In bus40 on A N gt SS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE vSnapshot Edit ON OFF REVISED 1 February 2007 DATA ID AE1 Portl StA Wide Softkey SCENE 9 DESCRIPTION Activate vSnapshot Edit Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS g a SS
41. Some beta versions of CB 3 may contain incorrect translations and should not be used The release version does not have this issue IF STATE and IF STATE SCAN test statements were not translating correctly if the device name contained CHAN This has been resolved IF STATE SCAN test statement now validates the device name and will warn of an invalid device name ROUTE SELECT command now validates the device name and will warn of an invalid device name MESSAGE FLAG command now validates the device name and will warn of an invalid device name ROUTE3 TEXT commands now fully support the use of d Device notation VARIABLES now allow the text IF to appear in the variable name Previously this would attempt to translate as an IF test statement September 2005 The following updates apply only to CommandBuilder3 exe Mosaic Set Color command can now be sent to a source device using the s Device notation November 2005 The following updates apply only to CommandBuilder3 exe Mosaic Set Color command now supports the v2 x fader module format in Mosaic This version and future updates should not be used with Mosaic v1 x if using the Set Color command for fader On Off buttons The new format allows a flash rate to be specified see Mosaic manual for more information January 2009 The following updates apply only to CommandBuilder3 5 exe Fixes a bug with TIMERS contained within IF VARIABLE and IF STATE test statem
42. TIMER Sets a Trigger that will occur after the time expires Set an event to occur after a specified time 46 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Conditional Trigger Format If Trigger Sets a Conditional Trigger that will fire when the specified Trigger action occurs if trigger TriggerDefinition then TriggerDefinition The specification of the Trigger is the same as a General Trigger The On Trigger Off Trigger or Route Trigger may be used as a Conditional Trigger Commands must appear between the IF TRIGGER and a corresponding ENDIF keyword This Conditional Trigger can be canceled using the CMD CLEAR TRIGGER command The keyword THEN and parenthesis are optional V V VV V See Chapter 7 for more information on General Trigger syntax The following is an example of the If Trigger Conditional Trigger if trigger ae2 surface2 route s Cass 1 to d Port 2 Fader 3 In then cmd ae2 surface2 d Port 1 Fader 2 In bus0 on endif If Button Sets a Conditional mains that will fire when the i button is a or released If ae surf surfaces function softkey bridge button on off delay then If ae surf surfaces accept cancel button on off delay then gt The allowable button keywords are FUNCTION BUTTON SOFTKEY BUTTON BRIDGE BUTTON ACCEPT BUTTON and CANCEL BUTTON A button number can be used with the keywords FUNCTION SOFTKEY amp BRIDGE The action keywords for
43. above the fader information This label may have a maximum of 8 characters The command must contain the CHANNEL number and the keyword LABEL The LINE or POS keywords are not required for this type of text To clear the label write a blank string The label may be replaced by flashing text PENDING if a WHEN OFF command is used The label is replaced if a SET ALIAS command is issued to the source device on that fader The label is cleared when a route is performed on that fader To center a label you must manually pad the text string with spaces VVVVVV VV V The following are examples of channel label text commands written to the Fader Screen label MUTE label cmd ael surfacel chanl text cmd ael surfacel chan6 text CY El To set an alias for an input see the Set Device Alias command in Chapter 12 106 Logitek CommandBuilder 3 6 Reference Manual Lo e Mosaic Wide Softkey Screen 30 CANCEL TAKE CANCEL TAKE SELECT The Mosaic Wide Softkey Module MLX 40 MLX WSOFT has two screens for user text Each screen MAN son MA oa ci has three buttons to the left for initiating Triggers II W reo as E a Both screens can display user defined text In aux 2 5 Aux 3 addition they can be used with Route Select or oo _ Variable Select Triggers to present menu or router choices to the user The options are selected by the user with the Select knob and Cancel and Take buttons W
44. activate however could easily be adapted to be triggered from an external GPI eg external cough mute panel Components This function has an ON button pressed and OFF button released Trigger Button On Trigger pressed gt Check if the Mic 1 fader is turned On if Off no more code will be executed gt Turn Bus 8 Cough Mute Bus On for that source gt Label the fader with the text MUTE gt Turn the button lamp on Button Off Trigger released gt Turn Bus 8 Cough Mute Bus Off gt Clear the label from the Fader gt Turn the lamp off Note the Off Trigger does not check to see if the fader is off therefore will execute whenever the button is released As it is just clearing the label and turning off the mute Bus 8 there is no need to check if the fader is on Further Information gt Bus On Off Page 55 gt If State Scan Page 150 gt Set Fader Label Page 61 Script Examples trigger ael d Ctrl Surfl GPI In bus86 on Mosaic Wide Softkey Misc Button 2 PROCEDURE Cough Mute REVISED 22nd February 2005 2 DATA ID AE1 Surfl StA Mic 1 Mute ON DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS if state scan ael surfl s StA Mic 1 bus0 on then cmd ael s StA Mic 1 bus8 on cough mute on cmd ael s StA Mic 1 text label MUTE tal
45. call AE1Surface2Al11FadersOff cmd ael surface2 route s CD 2 to d Port 2 Fader 6 Following is an example of a Trigger that needs to turn all faders on all Surfaces off when a particular Bridge Button on the Surface is pressed trigger ael surface2 bridge button 8 on cmd ael surface2 bridge lamp8 on call AE1A11SurfacesAllFadersOff cmd ael surface2 route s CD 2 to d Port 2 Fader 6 cmd ael surface2 route s ISDN 3 to d Port 2 Fader 1 Logitek CommandBuilder 3 6 Reference Manual 53 Lo gitek 12 Action Commands Introduction Action Commands are any of the actions or events that an Audio Engine or Supervisor is capable of performing Each Action Command must start with the keyword CMD and must be completed on one line Action Commands can be used in both Triggers and Procedures The Action Commands are the events that are to happen when the Trigger fires or a Procedure is called Each of the listed commands includes a reference table listing the available options and usages of the command Generally alternative keywords are shown however there are some equivalent keywords that are not shown The following keywords are equivalent and can be used interchangeably Keyword Alternative s bus relay delay wait timeout exit quit fader chan channel lamp light surf surface For maximum readability we suggest using the same keyword consistently throughout your Trigger Table In some situations you might want to u
46. channel cmd clear when off ae surf surfaces chan channel range cmd clear when off ae surfff surfaces fader cmd clear when off ae surf surfaces faderHf range cmd clear when off ae Not Used diDevice Name gt The When Off statement stores commands as Pending if a fader is on gt Use Clear When Off to cancel a prior When Off command before setting another gt The required keywords are CLEAR WHEN OFF gt The CHANNEL or FADER keywords may include a range of channels to be cleared gt The Destination Device can be specified using the d Destination Device notation gt The optional parenthesis can be used to enclose the specification of the When Off test statement gt It is not an error to clear a fader that is not Pending The following are examples of the Clear When Off command cmd clear when off ae3 d Portl Fader 4 In cmd clear when off ael surface2 channel 1 6 cmd clear when off ae2 surfacel fader 6 See Chapter 16 for more information about the When Off Test Statement 76 Logitek CommandBuilder 3 6 Reference Manual Lo gitek 13 Surface Text Commands Introduction Logitek Surfaces have the ability to display user generated text on their LCD screens The type size and amount of text varies widely between different generations of console The methods for displaying text are similar but due to small differences each method is detailed below in a separate section
47. chars channel Text is displayed on Screens 1 6 as 8 lines of 18 characters See page 109 for the screen addresses amp lines This command can also be used to set the text on the LCD display below the main meter The command must contain the DEVICE or FADER number and LINE number To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT with a position reference to overwrite written text occupying that position and keep exisitng text on the line The text color can be specified by adding a predetermined value to the postion value White is assumed if no value is added to the postion value VVVVV WV Vv Mosaic Text Color values The following values are added to the postion value to give the text a specific color White 0 Blue 16 Green 32 Red 48 Cyan 64 Magenta 80 Yellow 96 50 Gray 112 The following are examples of small font text commands written to the Meter Bridge chan33 line66 pos33 This is Text chan33 linel posi cmd ael surfacel tex cmd ael surfacel tex ct ct Figure 28 Mosaic Wide Meter Bridge Screens 4 6 Mosaic Monitor Meter The Monitor Meter is set to follow the Monitor source or depending on your Audio Engine configuration another source device This is set by the Audio Engine and is not dependent upon CommandBuilder Lines 7 amp 8 on Screen 4 can be used for additional text displays as per the Mosaic Meter
48. clock big channel linel posl cmd ael surface2 clock clear softkey line3 pos6 Remora Temperature This command is used to write a temperature display to the Softkeys or Fader Wedge Screens cmd ae _surf surface temperature big chan channel _ line pos clear insert cmd ae surf surface temperature big fader line pos clear insert gt This command is similar to the text command but uses the keyword TEMPERATURE instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers The keyword SOFTKEY can not be used with a Remora as it has no Softkey Screen A quoted string is not required and will be ignored if present The keyword INSERT is used to insert the temperature display text into an existing line The display is continuously updated until a TEMPERATURE CLEAR command is used The Temperature Clear command must contain the same Audio Engine Surface line and position numbers as the original Temperature command VVVV WV The following are examples of how to display and clear the temperature cmd ael surface2 cmd ae3 surfacel cmd ael surface2 mperature softkey insert line3 pos6 mperature big channel7 linel posl mperature clear softkey line3 pos6 ct ct ct 104 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Mosaic Screens The Mosaic has color LCD screens for each fader which can be used to show fader information and labels In addi
49. have mic on off control either omit these Triggers or disable them in CommandBuilder You could also customize the Triggers using Variables and If Statements to only permit the functionality during certain scenes Components This function has an ON button pressed Trigger for the mic ON and OFF buttons On Trigger Mic ON button Turn on microphone Turn GST 22 ON lamp on Turn GST 22 OFF lamp off Turn GST 22 Relay Tally on Turn GST 22 timer on Run GST 22 timer Reset GST 22 timer to zero VVVVVVV On Trigger Mic OFF button gt Turn off microphone gt Turn GST 22 ON lamp off gt Turn GST 22 OFF lamp on gt Turn GST 22 Relay Tally off gt Reset GST 22 timer to zero gt Stop GST 22 timer Off Triggers Off Triggers for these buttons are not required an Off Trigger occurs when a button is released The stubs for these can be included if desired and are shown at the bottom of the examples Further Information gt Bus On Off Page 55 Script Examples trigger ael d St731 Guest 1 H P bus31 on PROCEDURE Guest Mic ON OFF REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic ON DESCRIPTION Activate Mic if On button pressed Cancel Mic if Off button pressed NOTES DEPENDENCIES Activates Deactivates Main bus for Mic input DEBUG STATUS cmd ael s St731 Mic 2 bus0 on Mic on cmd ael d St731 Guest 1 H P busl1 on On lamp on cmd ael d St731 Guest 1 H P bus
50. in the list the list displays but you can t select anything A workaround is to not use the first variable in the variable list for Variable Select commands Variable Select does not support Select in the variable name gt A space is required before and after any variable name The phrases vUserVariable 1 and vUserVariable 1 do not work They should be stated as vUserVariable lor vUserVariable 1 gt The Route 3 Button Trigger trigger ael device006e route3 button1 on does not support the d Destination Device notation gt The Route 3 Button Trigger does not function with a Destination Device the Trigger is uploaded to the wrong Bus number and will not function The If Trigger Conditional Trigger does not support the Route 3 Buttons A Variable Select command sends the title to the wrong line of a Remora or Numix When using a Route Select command the destination tally text AE comes from the Route Select command not what is listed in the command This is generally not a problem but prevents a tally being sent to another Audio Engine gt The text tally destination does not support the SOFTKEY keyword DEVICE28 must be used to write to the Softkey screen on a Numix II The text tally does not support channel numbers use the channel s device number to write to the Numix and Remora fader screens Some Mosaic Keywords are still under development Talk Delay Triggers and Test Statements are currently under dev
51. or duplicated Procedure names When the checking is complete a grid below the progress bar will display a summary of the number of duplicate invalid active and total Triggers and Procedures If there are no errors or duplicates and Supervisor is connected the log will indicate that the Trigger Table may be uploaded Click the Upload Trigger Table button to transfer the compiled Trigger Table to Supervisor A yellow progress bar in the log shows the status of the upload as it progresses The progress bar will turn green when the Trigger Table has been successfully uploaded and accepted by Supervisor Logitek CommandBuilder 3 6 Reference Manual 23 RE CommandBuilder 3 6 UPLOAD TRIGGER TABLE Edit Trigger Read Save New Upload Table Edit Triggers List Trigger Table Trigger Table TriggerT able to Supervisor Procedures Trigger Table 4RK_TRIGS_1 C 04 txt m Supervisor A 10200 ws088059 Check Checking all triggers and procedures CO IP Address Trigger 5 Server Port Table Total Not Active Active Number Active Not Valid Duplicate Computer Name Triggers 2342 1778 o o Status Upload Procedures 202 0 0 0 Trigger Table This trigger table may be uploaded to Primary Supervisor Supervisor B IP Address Server Port Computer Name Trigger Type Tatio Size Status Current Current Max B2 On General 458
52. row Lit destinations cannot be de selected Unlit destinations can be pre selected flashing if allowed Once pre selected to a destination you have a lock on that pre select The button will flash Press TAKE to accept or press the flashing pre select again to cancel Press the source to clear all To view you can press the source you are interested and see which destinations it feeds Routes can also be tallied to text screens VVVVVV V Requirements 1 Output or DSP Crosspoint amp Output per path DSP provides gain control and mono mix If using DSP Crosspoints a virtual Router surface is required on an available port 1 Button panel per studio 1 Button on panel per source plus 1 TAKE button 12 suggested using top row of BTN24 1 Button on panel per destination 12 suggested using bottom row of BTN24 VVVV WV 22 Device Control Examples The Logitek system can interface to a variety of external devices using serial or IP based control This chapter shows examples of commonly used device control BetaBrite Signs BetaBrite manufacture scrolling LED signs that can be used to display messages from Supervisor For more information on BetaBrite signs see the company s website at http www betabrite com For this example you will require gt A BetaBrite message board gt Supervisor gt An unused RS 232 port on your Supervisor PC When you setup the sign program a static message into the display usi
53. surfacel remora vCurrentShow set selection mode cmd text selection title Scene cmd text selection 1 Brekky cmd text selection 2 Morning cmd text selection 3 Arvo if accept selection 1 then cmd ael surfacel route s Host Mic to d Portl Fader 1 In cmd ael surfacel route s Guest Mic 1 to d Portl Fader 3 In cmd ael surfacel route s Guest Mic 2 to d Portl Fader 4 In endif if accept selection 2 then cmd ael surfacel route s Host Mic to d Port 1 Fader 4 In endif if accept selection 3 then cmd ael surfacel route s Host Mic to d Port 1 Fader 1 In endif if cancel delay 30 then cmd ael surfacel bridge lamp4 off endif The following is a complete example of a Variable Select function for consoles designed after Summer 2013 ROC second generation Mosaic cmd ael surfacel vCurrentShow set selection mode display device 27 screen 2 cmd text selection title Scene cmd text selection 1 Brekky cmd text selection 2 Morning cmd text selection 3 Arvo if accept selection 1 then cmd ael surfacel route s Host Mic to d Portl Fader 1 In cmd ael surfacel route s Guest Mic 1 to d Portl Fader 3 In cmd ael surfacel route s Guest Mic 2 to d Portl Fader 4 In endif if accept selection 2 then cmd ael surfacel route s Host Mic to d Port 1 Fader 4 In endif if accept selection 3 then cmd ael surfacel route s Host Mic to d Port 1 Fader 1 In endif if cancel delay 30 th
54. the buttons are ON and OFF ON is the default if not specified The optional keywords TIMEOUT or DELAY followed by a number of seconds can be used to automatically fire the If Button Conditional Trigger gt Commands must appear between the IF BUTTON and a corresponding ENDIF keyword gt This Conditional Trigger can be canceled using the CMD CLEAR BUTTON command V V Vv The following are examples of the If Button Conditional Trigger if ael surfl button cancel delay30 cmd ael surfl question text clear all endif See Page 75 for more information on the Clear Trigger command Logitek CommandBuilder 3 6 Reference Manual 47 Lo gitek If Timer Sets a Conditional nin that will fire when a a time Aslan iaa if timer wait then The required keyword WAIT is used to specify the time in seconds before the timer fires Each timer must have a unique user defined number This number is used in the CMD CANCEL TIMER action command that is used to cancel the timer and prevent its commands from executing The If Timer requires a unique timer number The timers are not specified for a given Audio Engine or Surface Commands must appear between the IF TRIGGER and a corresponding ENDIF keyword The keyword THEN is optional Vv VVVV The following are examples of the If Timer Conditional Trigger if timer 3 wait 25 then cmd ael surface2 d Port 1 Fader 2 bus 0 on cmd ael surface2 bridge button 3 off endif If Timer Tal
55. to ensure microphone channel is ON at this surface Turn GST 22 ON lamp on Turn GST 22 OFF lamp off Turn GST 22 Relay Tally on Turn GST 22 timer on Run GST 22 timer Reset GST 22 timer to zero VVVVVV oV Off Trigger Scan surface to ensure microphone channel is OFF at this surface Turn GST 22 ON lamp off Turn GST 22 OFF lamp on Turn GST 22 Relay Tally off Reset GST 22 timer to zero Stop GST 22 timer VVVVV WV Further Information gt If State Scan Page 150 gt Bus On Off Page 55 Script Examples trigger ael s St731 Mic 2 bus0 on Ness SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Mic ON OFF REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic Mute OFF DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS N SSS SSS SSS SS SS SS SS 0 SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSE 2 if state scan ael surfl s St731 Mic 2 bus0 on then cmd ael d St731 Guest 1 H P bus11 on On lamp on cmd ael d St731 Guest 1 H P bus12 off Off lamp off cmd ael d St731 Guest 1 H P bus20 on Tally Output on cmd ael d St731 Guest 1 H P bus21 on timer on cmd ael d St731 Guest 1 H P bus22 on timer run cm
56. use CLEAR ALL to clear the Question Screen when ACCEPT or CANCEL is pressed otherwise the screen will not clear The following is an example of placing the Question Screen into the Question Mode and then displaying several lines of text cmd ael surface2 set question mode cmd ael surface2 text question linel posl Assign Studio A to air if ael surfl button cancel delay30 cmd ael question text clear all endif See Chapter 9 for more information on Conditional Triggers to accept or cancel Remora Selections Screen Text The Selections Screen can be used to display a menu of options to the user These can be a user defined list or a list of inputs for a router Crosspoint e g record source selector This command is available on the Numix I Numix II and Remora and therefore is documented in a separate section See Text Selection Screens at the end of this chapter for more information Arvo Program Program Studio Studio Post Diy E E Post Diy Headphone D L 18 Mic 1 Mic2 Ter 1 Post Diy D L 1S Mic 1 Mic2 Ter 1 Post Diy Figure 23 Remora Selections screen Figure 22 Remora Question Screen Logitek CommandBuilder 3 6 Reference Manual Lo gitek Remora Fader Screens The fader section of the screen on the Remora is capable of displaying three types of text These include small and large font text to the upper half of the screen and large font text to the label section of a fader This screen w
57. we are on delay at the moment call DelayTally StA_Exit update lamps and text cmd set toggle 2 ael d Ctrl Surfl GPI In bus87 reset toggle to on state cmd set vDelayStAPostSwap 1 set post swap mode cmd store ael d Portl Monitor In route to vMonStAMonAmp store Monitor Amp source device cmd store ael d Portl Headphones In route to vMonStAOprHP store Opr Headphones source device cmd route ael s Portl Delay CP1 Out to d Portl Monitor In route post delay to Monitor Amp cmd route ael s Portl Delay CP1 Out to d Portl Headphones In route post delay to Opr Headphones call MosaicMonitor StA Monitor update monitor hotkey lamps call MosaicMonitor StA Headphones update monitor hotkey lamps cmd ael d Ctrl Surfl GPI Out bus87 flag flash continuous flash lamp FUNC3 if ael timer 111 talk d Portl Delay CP1 In then call DelayTally StA Off update lamps and text cmd set vDelayStAOn 0 update variable cmd set vDelayStASafe 0 update variable cmd ael d Portl Delay CP1 In talk off force off to clear delay PGM endif endif procedure DelayTally StA Exit NSSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSE PROCEDURE Delay Text Tally REVISED 21st February 2005 DATA ID Studio A StA Delay Exit DESCRIPTION Updates delay status on Mosaic surfaces NOTES DEPENDENCIES DEBUG STATUS
58. 01 Li ea a Figure 17 Numix II Fader Screen with clock amp temperature Logitek CommandBuilder 3 6 Reference Manual Lo gitek Numix II Small Font Text This command is used to write a small font text to the sens half of the Fader in Screens cmd ae surf surface text chan channel insert line pos 36 chars cmd ae surf surface text fader insert line os 36 chars Small text is displayed on the upper half of the screen as 12 lines of 36 characters This text is divided into two columns of six lines each There are two lines for each channel on the surface The channel number prefaces the text The first three channels are the left column the second three channels are the right column Use CHANNEL 1 6 for the first wedge CHANNEL 7 12 for the second and so on The command must contain the CHANNEL or FADER number and LINE1 or LINE2 To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT to replace only the written text and keep other text on the line VVVVVV VV The following are examples of small font text commands written to the Fader Wedge cmd ael surfacel tex cmd ael surfacel tex channell linel posl This is Text channel6 line2 posi o Numix II Large Font Text This command is used to write a ma font text to the wa half of the Fader nie Screens
59. 119 122 Mosaic Wide Softkey Text 107 118 A A smitsom 87 Numbel Function Screen TexLlasiinadinic 79 Numix I Label Text 85 Numix Large Font extasis 84 Numix Message AITOW scsccsicsscnsvistesenstinteess 86 Numix Selections Screen TeXt oooocococco 80 Numix Small Font Tesco 84 Numix Softkeys Screen Text eee 82 Numix Temperature isis 87 NunclClaal asnicar 96 Numix Il Label Texl oooconorrisinsari cr 94 Numix Il Large Font excssinssanuicaids 93 Numix Il Message AO Wins 95 Numix IlI Question Screen TeXt ccoonnnncinn 90 Numix II Selections Screen Text 90 Numix II Small Font Text oooooocnoncccnonccooo 93 Numix ll Softkeys Screen TeXt ooooooinccioncco 91 Numix ll TeMpPErature evsoiitorianniacais 96 2 irsti naa 40 PP ikain 39 POC aa 52 QUIE 73 Remora Clot ar 104 Remora Label Text csccesssseesssrteeeees 101 Remora Large Font Tecos 100 Remora Message AMO Wisconsin 102 Remora Questions Screen Text 008 98 Remora Selections Screen Text 06 98 Remora Small Font Tetonas 100 Remora Temperature ana 104 A A 77 Route 3 Button Tesis 40 Route 3 Message Mode TeXt ooooociioccccooos 126 Route 3 Normal Mode TeXtocooooooocccccccooo 124 Route 3 Set Message MOdB ooocooocccocnccconoss 125 Route Recallua as 145 Route Select lA arena 134 Route Select If Cancel oooooonoccccncnnoncccnooo 135 Route Select Set MoOde ooooooooccccoccccconnncn
60. 2 To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT to replace only the written text and keep other text on the line VVVVVVV oV The following are examples of small font text commands written to the Fader Wedge channell linel posl This is Text channel6 line2 posi cmd ael surfacel text cmd ael surfacel tex Remora Large Font Text This command is used to write a ais font text to the coms half of the Fader aie Screens cmd ae surf surface text chan channel insert line pos 52 chars cmd ae surf surface text fader insert line pos 52 chars gt Large text is displayed on the upper half of the screen as 4 lines of 52 characters on a REM6 module On a REM4 module each line can display 35 characters gt Large text can be displayed as 1 line of 52 or 35 characters in conjunction with small text below gt The command must contain a CHANNEL or FADER number of the Fader Wedge the keyword BIG and can be written to LINE 1 LINE 2 LINE 3orLINE 4 gt Use the first channel number of the desired Remora wedge to access that screen gt To clear a line write a single space string to that line without the INSERT keyword gt Use the keyword INSERT to replace only the written text and keep other text on the line The following are examples of large font text commands written to the Fader Wedge big channe
61. 2 remora artisan mosaic keyword as follows display device 27 screen 2 Use the screen number that corresponds with the console module as described in the console manual See example command at the end of this section Variable Select Text This command is used to enter selection text for the Variable Select mode on a surface cmd text selection line 12345678 gt This command is used to set the title and selection text lines for the list gt The Audio Engine number and Surface are not required in these commands and are assumed to be those specified in the SET SELECTION MODE command The keywords TEXT SELECTION TITLE are required for the title line of the selection list The keywords TEXT SELECTION and the line number are required for each line in the list gt gt Variable Select If Accept This Test Statement is used to test for an as selection from the user if accept selection then gt This Test Statement tests for the selection that is accepted by the user and contains the Action Commands to be executed There is usually one group of commands for each value of selection line in the list The keywords IF ACCEPT SELECTION and the selection line value are required The keyword THEN is optional VV WV VV Vv The Audio Engine and Surface numbers are not required and are assumed to be those specified in the above SET SELECTION MODE command The commands to be executed must contain the require
62. 2 Fader 2 In cmd ae3 surfacel route s Outside Phone 1 cmd ae3 surfacel fader2 bus0 on endif if vPhoneLine s CD 2 and zSupervisorASerialFail 0 then cmd ae3 surfacel route s Outside Phone 2 to d Port 3 Fader 4 In endif If Variable Or A variation of If Variable for an tests of which one must evaluate as true to execute code block if VariableName lt gt lt gt lt gt Value OR optional then The If Variable Test Statement can be combined with itself to test values of many variables If one of the individual Test Statements is true the block of commands is executed Each separate statement must be enclosed in parenthesis and joined using the keyword OR Spaces are required either side of any Variable name to ensure the variable is found Individual Test Statements follow the same rules as the If Variable Test Statement above The keywords AND and OR can t be mixed in the same multiple Test Statement VVVVVV The following are examples of the If Variable statement using multiple OR test conditions if vPhoneLine 1 or vAirStudio 3 or vScene 4 then cmd ae3 surfacel route s Outside Phone 1 to d Port2 Fader 2 In cmd ae3 surfacel fader2 bus0 on endif if vPhoneLine s CD 2 or zSupervisorASerialFail 0 then cmd ae3 surfacel route s Outside Phone 2 to d Port 3 Fader 4 In endif If State Tests the state of a set of conditions in a specified Audio Engine if state
63. 59 196680 B2 On Conditional 0 65536 B3 Off General 3131 8192 B3 Off Conditional 1432 65536 nee B4 Route General 1006 32768 B4 UnRoute o 8192 UE SLE B4 Route Conditional 0 2048 Password Init Trigger 3688 12288 Timer 298 24576 Procedures 22455 98304 Variable Select 325 32768 Route Select 123 24576 _ User Variable 0 65536 System Variable 0 65536 Schedule 0 98304 10200 L i CB V Remember Password Figure 5 CommandBuilder Upload page After Uploading Click the Press to Disconnect button to disconnect from Supervisor The connection is automatically closed when the CommandBuilder program is terminated Logitek CommanaBuilder 3 6 Reference Manual ES Logitek 5 Creating amp Editing Trigger Tables This chapter explains the tools required to setup a new Trigger Table and edit an existing one The editing tools follow most Windows conventions and provide many functions for streamlining the process Page System Page System The System Page is used to setup information about a Trigger Table and the associated Audio Engine configuration files The current Trigger Table file name and its associated project folder are displayed in the upper right hand portion of the screen TIP The Trigger Table files associated with a set of Audio Engine configuration files should be kept in the same folder You may wish to create new project fo
64. 6 ES Triggers List Trigger Table Trigger Table TriggerT able to Supervisor Page Procedures List TRIGGER LIST Trigger Table File 4RK_TRIGS_1E D4t O Last Trigger Total Commands 0 CTI 100 CI A EEES Count 2 Summary of Triggers NOT NOT Trigger 3 Summary of Timers NOT NOT 4 Init Trigger trigger init 510 5 All Lamps ON Test Trigger trigger init 558 NOT Trigger Block 6 All Lamps OFF Test Trigger trigger init 558 NOT ra Clear Mosaic PSU Init Trigger trigger init 2 NOT 8 9 10 1 AE1 Surf 1 Reset Refresh trigger ael device02 bus225 on 18 _ Copy Trigger Block 12 AE1 Surf 2 Reset Refresh trigger ael device02 bus226 on 13 AE1 Surf 3 Reset Refresh trigger ael device02 bus227 on NOT PE T 14 AE1 Surf 4 Reset Refresh trigger ael device02 bus228 on NOT a 15 AE1 Surf 5 Reset Refresh trigger ael device02 bus229 on NOT 16 AE1 Surf 6 Reset Refresh trigger ael device02 bus230 on NOT A 17 Trigger Block 18 19 20 21 AE2 Surf 1 Reset Refresh trigger ae2 device02 bus225 on 18 22 AE2 Surf 2 Reset Refresh trigger ae2 device02 bus226 on 23 AE2 Surf 3 Reset Refresh trigger ae2 device02 bus227 on NOT 24 AE2 Surf 4 Reset Refresh trigger ae2 device02 bus228 on NOT UngperiEist 25 AE2 Surf 5 Reset Refresh trigger ae2 device02 bus229 on NOT 26 AE2 Surf 6 Reset Refresh trigger ae2 device02 bus230 on NOT 27 28 Figure 7 CommandBuilder Trigger List Logitek CommandBuilder 3 6 Reference Manual 27 Lo gitek Trigg
65. B091500 RGB150015 S Qes BSSB Figure 48 Mosaic Fader lamps colors Artisan Mosaic Set Lamp Intensity Sets the intensity of a Mosaic small button lamp cmd cmd cmd VVVVV V VV Vv ae surf surfaces chan channel bus setintensity 0 15 DIM MID DLE BRIGHT lamp artisan mosaic ae Not Used device bus set intensity 0 15 DIM MID DLE BRIGHT artisan mosaic ae Not Used d Device Name bus set intensity 0 15 DIM MID DLE BRIGHT artisan mosaic The small and large softkey buttons on the Artisan Mosaic support 16 brightness levels Brightness levels are stored by the lamp and do not change until a new value is set or the Surface is power cycled All lamps default to maximum brightness on Surface power up This command uses the required keywords SET INTENSITY This command must include the Audio Engine number Device or Destination and the required keyword LAMP or BUS The Device can be specified using the d Destination notation If using keyword LAMP a Mosaic specific lamp address must also be used This command applies to the lamp in the button not the button itself The keyword ARTISAN or MOSAIC must be used The keyword BUTTON must NOT be used The intensity level is set with a value from 0 15 or the keywords DIM 0 MIDDLE 8 or BRIGHT 15 Only one intensity keyword should be used The difference in value between adjacent brightness levels is quite s
66. C linel35 text pos97 Delay OFF 2 t trigger ael surfl chan01 bus00 on U SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS PROCEDURE Kill Cue amp TB Delay Exit on next REVISED 27th April 2005 DATA ID AEl Portl StA Fader 1 DESCRIPTION Turns off Cue bus BUSO2 and TB bus BUS14 on fader when fader goes on BUSOO Also checks for Delay Exit Ready status and runs delay off procedure if necessary NOTES DEPENDENCIES DEBUG STATUS N SSS SS SS SS SSS SSS SS SSS SS SS SS SS SS SS SS SSS 2 2 2 2 cmd ael surfl chan01 bus02 off cmd ael surfl chan01 bus14 off if vDelStlOnDelay 2 call DeloffDelay StA endif Repeat this fader trigger for every fader on surface Delay Exit Method D Ramp Down Functionality Description This function turns off Talk Delay When the operator presses Delay Exit the delay will begin to ramp down This may take a number of minutes The delay time will eventually reach 0 0 but the display will stay on Monitoring will remain on pre delay during this time This method provides simple operation however does not provide a quick exit It would usually be offered in conjunction with another form of quick exit Methods A B or C Components The Delay Exit button has an On Trigger which performs these tasks plus a Procedure to update display tallies Button On Trigger gt Check the value of a va
67. Channel Fader or Device number and the required keyword MESSAGE One of the keywords CHANNEL FADER or DEVICE is required The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the DEVICE keyword The special system destination d LastRoute will use the Destination Device number of the last Route command that was executed on the specified Audio Engine If the Device Number is a Source Device number or a named s Source Device the command will affect all instances of that Source Device on the specified Audio Engine Unlike the On Off command a Message Arrow is not directed at a particular Surface when using a Source Device The Message Arrow may be turned on or off set to flash continuously or made to flash once only One of the keywords ON OFF PULSE or FLASH is needed to set the mode of operation If the mode keywords are missing the message will default to ON The keyword PULSE will cause the Message Arrow to go on and off only once The keyword FLAG is no longer required but will not cause harm if present Since the Remora has a color screen the color of the Message Arrow and text can be set by using one of the optional keywords WHITE RED YELLOW GREEN AQUA or MAGENTA If no color keyword is selected the Message Arrow and text are displayed in white Logitek CommandBuilder 3 6 Reference Manual f Lo gitek The following are examples of Mess
68. E EE ZZ NOON E a A AAA A A ateeceeadts Lie 78 Nurmik STO Wedge E diners cctit ie cited anita catobanmoniiaabiaanteie 78 Numix e AAA A IIA 83 Nanik SG A E clea sadseaMeadioeaacad ves 88 Numix Il Selector Wedge a E ERI A A ate ancien dad ae A 89 Kimi H Fider WES CECENE ri 92 E E 5 ee ee E E eee E et eee E ee ere 97 A le A 97 AAA fader A ainia delia aerea 99 A o e io 105 6 Logitek CommandBuilder 3 6 Reference Manual Logitek Moac a RA 106 fasai e MA 107 Mosaic MODO SORBED coi AAA wi dots win Wa tei dal i A oda stoke ast 109 Mosaic Meter Bridee AA 109 AR EE ana 113 Arisan AAA 114 Arsan ENOT SCEN A A RN NIN 116 AUS A is is 116 Artisan Monitor Cree ass 117 Artisan Wide Soltkey A a A A ii 118 Artisan Meter Bridge SCEE dd A A AS A A aa a ieai eA i 120 TOO A aAA a A 123 Text Select Functions eee ee i eT ee ere i Serer nn 127 14 Additional Surface Comm ii 136 AAA E AEA PEE OEE A E ET IAN 136 E a CAN 143 ERA RARA RA 143 PEE AM AAA A 165 a AAA 167 A IIA 169 Mosaic Monitor OR ii vehi aia 172 Es AA 176 Pe OA AR VIE E AEAEE NANE RR E RARA 178 Deny at AA 180 Delay Exit Method B Hard Cut iio 182 Delay Exit Method C Nest Even o ie 184 Logitek CommandBuilder 3 6 Reference Manual 7 pos a Logitek Dely Pot Mehod D Ramo DOn e a ii 186 TA Eam eSa 188 Logitek Intercom with calling station display nnnnenneserennrnrnesinersrererrenrirerenesene 188 21 On
69. EO MONO PHASE LL RR Lx xR d Device Name set mode STEREO MONO PHASE LL RR Lx xR device set mode STEREO MONO PHASE LL RR Lx xR gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword MODE gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation The Fader Mode may be set to the following values STEREO For stereo source Left source to Left Right source to Right For mono source Left Right source average to Left and Right MONO Left Right source average to Left and Right PHASE Left source to Left minus Right source to Right LL Left source to Left and Right RR Right source to Left and Right Lx Left source on Left silence on Right xR Silence on Left Right source on Right The following are examples of the Set Fader Mode command cmd cmd cmd cmd ael ae2 ae3 ael surfacel set fader2 mode mono surface2 channel6 mode stereo set d Portl Fader4 In mode LL d Portl Fader2 In mode xR Logitek CommandBuilder 3 6 Reference Manual Lo gitek Set Fader Trim Sets the Fader mode of a a fader or Destination Device Same as sana fader trim on surface cmd ae surf surface chan channel set trim 10 to 10 dB none
70. EVICE keyword gt If using a Source Device the Surface number is not required and will be ignored if present the Trigger will be fired no matter which Surface on the Engine causes the Bus On event If using the BRIDGE or SOFTKEY Device keyword use BUTT or BUTTON number There are two types of On Triggers the Single State Trigger and the Toggle Trigger Single state On Triggers are like momentary contact switches when they are pressed the commands are executed each time gt A Toggle Trigger will switch between two different states like a push on push off button Different sets of Action Commands can be associated with the two states Each time the Toggle Trigger fires only the action commands associated with the current state are executed and then the state is changed to the opposite value ready for the next execution VV Vv The following are examples of Single State On Triggers trigger ae3 surfacel device 000B bus0 on trigger ae4 d Port 2 Fader 1 In on trigger ael surface2 softkey button2 on The following are examples of Toggle State On Triggers trigger ae3 surfacel device 000B bus0 on toggle trigger ae4 d Port 2 Fader 1 In on toggle trigger ael surface2 softkey button2 on toggle TIP Toggle Triggers are useful for push on push off function buttons for example a button that changes monitoring to post delay and restores it when pressed again See Chapter 16 for more details on using the If To
71. GPI Out bus33 off update Softkey Scene Lamp 2 cmd ael d Ctrl Surfl GPI Out bus34 off update Softkey Scene Lamp 3 cmd ael d Ctrl Surfl GPI Out bus35 off update Softkey Scene Lamp 4 cmd ael d Ctrl Surfl GPI Out bus36 off update Softkey Scene Lamp 5 cmd ael d Ctrl Surfl GPI Out bus37 off update Softkey Scene Lamp 6 cmd clear when ael surfl chan01 10 clear when pending Faders 1 to 12 cmd ael device2b text big line69 posl SCENE 1 set text on Bridge screen 2 cmd ael device2b text big line70 posl Default set text on Bridge screen 2 if state ael surfl chan01 bus0 off cmd ael surfl chan01 busl on Fader 01 PGM on if channel is off endif if state ael surfl chan02 bus0 off cmd ael surfl chan02 busl on Fader 02 PGM on if channel is off endif if state ael surfl chan03 bus0 off cmd ael surfl chan03 bus1 on Fader 03 PGM on if channel is off endif if state ael surfl chan04 bus0 off cmd ael surfl chan04 busl on Fader 04 PGM on if channel is off endif if state ael surfl chan05 bus0 off cmd ael surfl chan05 busl on Fader 05 PGM on if channel is off endif if state ael surfl chan06 bus0 off cmd ael surfl chan06 busl on Fader 06 PGM on if channel is off endif if state ael surfl chan07 bus0 off cmd ael surfl chan07 busl on Fader 07 PGM on if channel is off endif if state ael surfl chan08 bus0 off cmd ael surfl chan08 busl1 on Fader 08 PGM on if chann
72. In route post delay to Opr Headphones cmd ael d Ctrl Surfl GPI Out bus87 flag flash continuous flash lamp FUNC3 call MosaicMonitor StA Monitor update monitor hotkey lamps call MosaicMonitor StA Headphones update monitor hotkey lamps endif if toggle 2 toggled state cmd set vDelayStAPostSwap 0 set post swap mode off cmd recall ael d Portl Monitor In from vMonStAMonAmp recall Monitor Amp cmd recall ael d Portl Headphones In from vMonStAOprHP recall Opr Headphones cmd ael d Ctrl Surfl GPI Out bus87 off lamp FUNC3 off call MosaicMonitor StA Monitor update monitor hotkey lamps call MosaicMonitor StA Headphones update monitor hotkey lamps endif Delay Exit Method A Timer Based Functionality Description This function turns off Talk Delay When the operator presses Delay Off their monitoring is changed to Post Delay and a timer is set based on the current delay time The Delay Off button lamp will flash and once the delay has emptied the delay is turned off At this time the lamps and text are also updated This method provides a fairly simple control method for operators Components The Delay Exit button has an On Trigger which performs these tasks plus two tally Procedures to update display tallies Button On Trigger Check the value of a variable if 1 then continue This prevents exiting delay again Set toggle state on Post Swap button see Post Swap function above Update Post Sw
73. JE Triggers List Trigger Table TriggerT able to Supervisor Page Procedures List SYSTEM PAGE Project Folder L Sites ABC Rockhampton 4RK 4RK Rev 1C 4 EGH gt Trigger Table File Name 4RK__TRIGS_1C 04 txt Audio Enone Number Network Config File Name 4RK__NET_NC1C nco Source Devices Destination Devices User Variables Network AE List Hex Unique Name a Hex Unique Name a Num Name A OOBE Port Program Out E 000B Porti Faderl In E 1 DelMasterPath2 E n Configuration File Name OOBF Portl Aux 1 Out 000C Port Fader2 In 2 DelMasterPath3 1 4RK_AE1_CFIC al6 DOCO Portl Aux 2 Out 000D Port Fader3 In 3 DelMasterPath4 2 4RK_AE2_CFI1C a16 00C1 Port Aux 3 Out 000E Porti Fader4 In 4 DelMasterPath5 00C2 Port Studio Out OOOF Port Fader5 In 5 DelMasterPath6 00C3 Port Monitor Out 0010 Porti Fader6 In 6 DelMasterPath 00C4 Port Headphones Out 0011 Porti Fader In 7 DelMasterPath8 O00C5 Port Talkback 1 Out 0012 Port Fader8 In 8 DelMasterPath9 O0C6 Port Talkback 2 Out 0013 Port Fader3 In 9 DelMasterPath10 DOC7 Port Mix Minus 1 0014 Porti Fader10 In 10 DelMasterPath11 00C8 Port Mix Minus 2 0015 Port Fader11 In 11 DelPreSelPath2 D0C9 Port Mix Minus 3 0016 Port Fader12 In 12 DelPreSelPath3 OOCA Port Mono Program 0017 Port Fader13 In 13 DelPreSelPath4 OOCB Port Mono Aux 1 0018 Porti Fader14 In 14 DelPreSelPath5 DOCC Porti Cue Out 0019 Porti Fader15 In 15 DelPreSelPath6 OOCD Portl Phones PF Out 001A Porti Fader16 In 16 DelPreSelPat
74. Logitek Logitek Electronic Systems ommandBuilder 3 6 eference Manual Logitek CommandBuilder 3 5 EDIT PROCEDURES Procedure Number 14 Status VALID we Save Trigger Table TriggerT able Upload Table to Supervisor System Edit Page Procedures Procedure List Trigger Table File Name Procedure Title Scene Stl Simulcast 1 On Air 198 Local AE Protocol Script 2WIN_TRIGS_2N 07 txt Run Translation Show Translation Find Find Next procedure Go_St1_Sim1_i98Loc PROCEDURE Load Scene U2 4 PD DEBUG STATUS cmd ae1 surf1 chan19 bus16 cmd ae1 surf1 chan19 bus17 cmd ae1 surf1 chan19 bus18 cmd ae1 surf1 chan19 bus19 cmd ae1 surf1 chan19 bus28 cmd ae1 surf1 chan19 bus21 cmd ae1 surf1 chan19 bus22 cmd ae1 surf1 chan19 bus23 cmd ae1 surf1 chan19 bus25 cmd ae1 surf1 chan19 bus26 cmd ae1 surf1 chan19 bus36 cmd ae1 surf1 chan19 bus31 cmd ae1 surf1 chan19 bus32 off off off off off off off off off on off off off DATA ID 198 FM Studio 1 St1 Simulcast Scene 5 DESCRIPTION Loads scene to console Delays fader change Bus assignment unchanged if fader BUSO is NOTES DEPENDENCIES Monitoring is updated cmd clear when ae1 surf1 chan61 18 if it is on pending A1 A2 am
75. ON button pressed Trigger for the specified button On Trigger Capture ON button gt Turn on reserved bus to launch vSnapshot Capture Mode gt Turn button s lamp on Off Triggers Off Triggers for these buttons are activated when the Done button is clicked on the vSnapshot Capture Page Further Information gt Bus On Off Page 55 Script Examples trigger ael d Ctrl Surfl GPI In bus42 on N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS PROCEDURE vSnapshot Capture ON OFF REVISED 1 February 2007 DATA ID AE1 Port1 StA Wide Softkey SCENE 11 DESCRIPTION Activate vSnapshot Capture Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS N SSS SSS SS SS SSS SSS SN SS SS SS SS SS SS SS SS SS SSS gt 2 2 cmd ael device02 bus201 on turn on vSnapshot Capture Mode cmd ael d Ctrl Surfl GPI Out bus42 on turn lamp on trigger ael device02 bus201 off N gt SSS SSS SS SS C SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE vSnapshot Capture ON OFF REVISED 1 February 2007 DATA ID AE1 Portl DESCRIPTION Activate vSnapshot Capture Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS N
76. PAN PORT POSITION PROCEDURE PULSE QUESTION QUIT RADIO RECALL RED RELAY RELEASE REMORA REPEAT RIGHT ROC ROUTE A color used for text on Numix II console Used to set the maximum delay in a Talk Delay function A mode of the selection screen alternate to the list mode Used in the repeat interval of a Schedule Event Trigger Sets the Mix Minus in effects commands Same as Mix Minus Day of the week used in a Schedule Event Trigger Equivalent to a O setting for Fader Trim User text string that is not highlighted Used to set a trigger to the inactive mode Negates Specifies Numix version 1 control surface Specifies Numix version 2 control surface Not on usually a button or talk delay Not off usually a button Com port communicates from source to destination only Sets a Fader pan value Reference to a Com Port with a number to identify Position in a line of text Used in naming a procedure or subroutine Sends a pulse command to a relay in the Audio Engine or a Surface Sends text to the Question display area on a console Stops processing of any further commands in the current Trigger same as EXIT Sets the Function Button on the console to radio push button mode Retrieve a value that has been stored in a User Variable A color used for text on Numix II console Refers to a relay in Audio Engine or Surface with number to identify Used to set release time with Set Fader Limiter and Set Fader Compressor commands Spe
77. R or CHANNEL or using the d Destination Device notation Device number is not supported gt The use of the TO keyword is optional If omitting the TO keyword place the Source Device first for improved readability gt If no Source Device is specified the Trigger will fire whenever any source is routed to the specified Destination Device gt If no Destination Device is specified the Trigger will fire whenever the specified source is routed to any Destination Device gt The optional keyword ANY can be used to improve the readability in these scenarios The following are examples of a Route Trigger trigger ael surfacel route device 0103 channel2 trigger ae3 route s Portl Aux 1 Out to d Portl Fader 7 In trigger ael surfacel chan25 route any trigger ael d MD 1 Record route any TIP If using a Route Trigger on a Route 3 device or similar which is configured to use a Direct Route address e g 6E or higher you cannot specify a Route Trigger using the Device Number Surface Number or Channel Number In this case you will need to use the d Destination Device notation Logitek CommandBuilder 3 6 Reference Manual 41 Lo gitek Unroute Trigger Fired when a a Source Device is ee ne ona a Destination Device trigger trigger ae surf surface route device from chan channel fader ae Not Used route s Device Name from d Device Name gt gt This Trigger must include the Audio Engi
78. Route bus on off ae surf surface s DeviceName bus on off This command must include the Audio Engine number Surface number Device or Fader number Bus number and the required keyword ON or OFF One of the keywords CHANNEL FADER or DEVICE is required The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the DEVICE keyword The special system destination d LastRoute will use the Destination Device number of the last Route command that was executed on the specified Audio Engine The keywords BUS and RELAY can be used interchangeably however for readability RELAY should only be used when the command is directed at an actual relay If the Device Number is a Source Device or a named s Source Device the command will scan faders on the specified surface from left to right until the Source Device is found The specified Bus for that fader is then turned on or off If the Source Device appears more than once on the Surface only the first matching fader will be changed The following are examples of this command with a Source Device cmd ael surfacel device 0103 bus0 on cmd ae3 surfacel s CD 1 bus2 off The following are examples of this command using a Destination Device cmd ael device 000b bus0 on cmd ae3 surfacel fader2 bus2 on cmd ae4 surface2 channel3 busl on cmd ael d Port2 Fader 4 In bus0 off cmd ael d LastRoute bus3 off Logitek Comman
79. S SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SS SSS SS SS SS SSS SSS SSS SS SS SS r SS SS SS SS SS cmd ael device02 bus203 on turn on vSnapshot Recall Mode cmd ael d Ctrl Surfl GPI Out bus40 on turn lamp on trigger ael device02 bus203 off A N SSS SS SSS SSS SS SS SS SS SS SS SS SS SS SSS SSS SSS PROCEDURE vSnapshot Edit ON OFF REVISED 1 February 2007 DATA ID AE1 Portl DESCRIPTION Activate vSnapshot Edit Mode if On button pressed NOTES DEPENDENCIES Tally Lamp is turned off when Done is clicked in vSnapshot DEBUG STATUS cmd ael d Ctrl Surfl GPI Out bus40 off turn lamp off Appendix A Release Notes What s New in CommandBuilder gt Designed for Trigger Table compatibility with Supervisor 3 gt Support for 8 amp 16 character Audio Engines from August 2005 versions Release Notes The following notes details known issues version history and current releases of CommandBuilder Known Issues The following issues have been reported and confirmed by Logitek As these issues do not affect many users they have not been assigned development priority If any of these issues affect your installation please contact Logitek Electronic Systems for possible workarounds or further information Known Issues as at May 2009 see release notes for info on fixed issues gt Variable Select doesn t work when you use the first variable
80. S SS SSS SSS SS SSS SSS SSS SSS SSS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SSE 2 2 2 cmd route ael s Portl Program Out to d Portl Headphones In routes PGM to announcer h p trigger ael d Portl Monitor In route any N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Monitor Route Change with Tally REVISED 27th April 2005 DATA ID AE1 Port 1 DESCRIPTION Updates Monitor Hot Key Lamps NOTES DEPENDENCIES DEBUG STATUS 2 2 2 2 2 call MosaicMonitor StA Monitor Call Monitor Tally external route was performed procedure MosaicMonitor StA Monitor PROCEDURE Mosaic Monitor Hotkey Update REVISED 27th April 2005 2 DATA ID StA Monitor DESCRIPTION Updates monitor hotkey lamps based on current route NOTES DEPENDENCIES DEBUG STATUS cmd ael d Portl Monitor In busl6 off turn off lamps for Supervisor cmd ael d Portl Monitor In bus17 off turn off lamps for Supervisor cmd ael d Portl Monitor In bus18 off turn off lamps for Supervisor cmd ael d Portl Monitor In bus19 off turn off lamps for Supervisor cmd ael d Portl Monitor In bus20 off turn off lamps for Supervisor if state ael route s Portl Program Out to d Portl Monitor In then Hotkey Source 1 is selected cmd ael d Portl Monitor In bus16 on Tur
81. SDN return audio cmd ael d Port 1 Fader 1 In route3 text line2 CHl yes CH2 no if timer 1 wait 20 cmd ael d Port 1 Fader 1 In route3 set normal mode cmd ael d Port 1 Fader 1 In route3 text label No ISDN TB endif The following is an example of a Trigger and Commands that could be associated with the CH1 button press after the message was displayed trigger ael d Port 1 Fader 1 In route3 buttonl on cmd cancel timer 1 cmd ael route s ISDN 1 to d Port 1 Fader 1 In cmd ael d Port 1 Fader 1 In route3 text label channel 1 ISDN TB Set The following is an example of a Trigger and Commands that could be associated with the CH2 button press after the message was displayed trigger ael d MD 1 Record route3 button2 on cmd cancel timer 1 cmd ael d Port 1 Fader 1 In route3 text label channel 1 No ISDN TB See Chapter 7 for information on Route 3 Button Triggers Text Select Functions These functions are special implementations of the Selection Screen commands They allow the user to select options from the Selection Screen The Route Select function can also be used to present a list of inputs for a particular router Crosspoint e g a record selector The functions are available on the Numix II Remora Artisan amp Mosaic Surfaces Variable Select gt This set of commands allows the value of a User Variable to be set by selecting from a list This value can then be immediately tested to execute sets of Action C
82. SSSSHSE cmd port2 lt nul gt lt nul gt lt nul gt lt nul gt lt nul gt lt soh gt Z00 lt stx gt A0 lt esc gt b lt sub gt 90n Air lt eot gt trigger ael device01 bus01 off AEl GPI Input 1 NSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SSS S55 PROCEDURE BetaBrite Message REVISED 14th June 2005 DATA ID AEl GPI 1 OFF DESCRIPTION Sends clears message text to Beta Brite sign on COM2 NOTES DEPENDENCIES COM port must be active in Supervisor as AUX port DEBUG STATUS fp 25555 4 222252222 gt cmd port2 lt nul gt lt nul gt lt nul gt lt nul gt lt nul gt lt soh gt Z00 lt stx gt A0 lt eot gt 23 Guest Panel Examples This chapter includes some examples of using Trigger functions with Logitek s guest headphone panels These Triggers allow the guest to control their mic on off mute functions receive tally information and control the guest panel timer display These examples are for a GST 22 panel however also apply to a GST 20 See the Logitek Utility Panel User s Manual for how to set up guest panels Mic On Off Functionality Description Allows the guest to turn their microphone on and off from the guest panel The microphone input can be on any fader of a surface the command is sent to the first matching instance of the mic input on any Surface of the specified Audio Engine If you do not wish the guest to
83. TalkRtnl bus or crosspoint level NOTES DEPENDENCIES DEBUG STATUS e u U U 2 cmd ael d Portl Monitor In bus03 off monitor dim and TB receive enable OFF cmd ael route s AE1 Silence to d Portl TalkbackRtn In route silence to be sure no audio continues cmd set vIcomInUse StA 0 lockout status OFF 21 On air Switching Examples The Logitek system can be used to build flexible on air delegation switchers These can be customized to suit station requirements and provide for almost any switching scenario As the design of a delegation switcher can be complex in many cases we suggest engaging Logitek Electronic Systems or your local reseller to consult on the design and programming Examples of different on air switchers from real life customer sites are provided below The script examples for these are not included due to the size and number of Triggers required Please contact Logitek Electronic Systems or your reseller for more information on these Assignment Mixer The Assignment Mixer allows studios to mix into the final output A studio may assign itself to a particular on air path with multiple studios assigned at the same time if desired This facilitates seamless studio changeovers and allows news booths to directly assign to air if required An available Mixer Surface port is required on an Audio Engine This is a virtual surface so no physical console is required The size of this virtual surface depen
84. age Arrow command written to the Fader Wedge cmd ael cmd ae4 cmd ae4 cmd ae6 cmd ae2 cmd ae2 cmd ae2 surfacel channell message green on On Air surface2 d Portl Fader 2 In message off surface2 d LastRoute message off surface3 fader7 message aqua flash On Air s CD1 message red flash On Air device0100 message yellow pulse On Air device000b message green on On Air Logitek CommandBuilder 3 6 Reference Manual 103 Lo gitek Remora Clock This command is used to write a clock aller to the ae or Fader alach Screens cmd ae surf surface clock big chan channel line pos clear insert cmd ae surf surface clock big fader line os clear insert gt This command is similar to the text command but uses the keyword CLOCK instead of the keyword TEXT See Fader Wedge and Softkeys commands for line pos numbers The keyword SOFTKEY can not be used with a Remora as it has no Softkey Screen A quoted string is not required and will be ignored if present The keyword INSERT can be used to insert the time display text into an existing line The display is continuously updated until a CLOCK CLEAR command is used The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command V VVV V The following are examples of how to display and clear the clock cmd ael surface2 clock softkey insert line3 pos6 cmd ae3 surfacel
85. air Switching ExXamples sonrie a 193 Annen PR dn aa at aks ali rite RO A A A 193 Network Source Switcher Direct Access Version uunaia 194 Network Source Switcher XY VerSlOD ecccccccccccascseccnsesssnnsessnsnscssscnscsssanvassnensessacsuassactuasdees 196 22 Device Control Example 197 DN aa E A a 2 a ee 197 NUC NANE A A ides nde A emcee 202 E E AAA REE 204 TS EI ER ci eae ian aed aai 206 ELISA 206 O oe asi s 207 o 208 Appendix A Release Notes cccccccceccsescescssscescsssssssessscssscscscnsesssscsssssccsscecessscccececseeessees 210 What s New in Connie a cs 210 A O PORRA RE RT RT RAI 210 8 Logitek CommandBuilder 3 6 Reference Manual Command Index Assembly Comm nncssevssustouasinnssiaasiiencscns 71 A AAA iei 55 Button Cit OMT sonia ala 56 Call Procede ia 73 Cancel menos 75 Clear Trigger corintios tcs 75 Clear When Ola 76 Lf ULL A 47 A teense eee 149 PSEA AG snieni ao RER 149 O ienne kaaas 150 He Sia S AA 150 A ese 48 If Timer Tal 48 o A A 146 A 47 lie Vain A A 147 If Variable Ad 148 If Variable Orina 148 lf Variable Talk Time nominas 151 A A oerien 44 Input RoOUSnssossaaciaa na cita 59 Lamp Flair acia 58 Lamp A 57 Mosaic Clos oa 110 121 Mosaic Label Text 106 114 116 Mosaic Meter Bridge Text 110 121 Mosaic Set Channel Color 136 139 Mosaic Set Lamp Intensity coco 141 Mosaic Wide Softkey Route Select 107 108 111
86. al grouping of commands Another advantage of Procedures is that the set of commands can be changed in one place in a Procedure instead of changing it in many different Triggers When the commands in a Procedure are completed the Trigger that called the Procedure will execute the next command after the CALL ProcedureName command TIP Itis good programming practice to use Procedures for code centralization and re use This reduces the number of lines of code and makes future debugging and changes easier General Rules The keyword PROCEDURE must be the first word on the first line The name of the Procedure should follow after the PROCEDURE keyword The Procedure name cannot contain any spaces The first line can t be a comment line A Procedure need not contain Action Commands it can be a definition only VVVV V Declaring Procedures A Procedure is defined by placing the appropriate Procedure command on the first line of an available Procedure in the Procedure List page Once you have found the Procedure you wish to define double click that row to edit the Procedure text The Procedure definition is then the first line in the edit box The Procedure must be marked active for Supervisor to process the Action Commands that follow it Logitek CommandBuilder 3 6 Reference Manual 51 f Lo gitek Procedure Format Procedure Used to group a set of commands together to be called in one unit from other Triggers or Proc
87. an08 device s StA Mic 3 SS endwhen endif if state not ael surfl chan09 route device s StA DAW 1 when ael surfl chan09 off cmd ael route surfl chan09 device s StA DAW 1 endwhen endif no if state not for telephone we want this to run every time to when ael surfl chanl0 off cmd ael route surfl chanll device s StA Telephone 1 cmd ael set surfl mix 4 bus1 cmd ael surfl chanl0 text label Rtn PGM endwhen Fader 01 Fader 02 Fader 03 Fader 04 Fader 05 Fader 06 Fader 07 Fader 08 Fader 09 update the Fader 10 set MM4 to Network if not already selected Edit 2 PGM if not already CD 1 if not already selected CD 2 if not already selected MD 1 if not already selected Mic 1 if not already selected Mic 2 if not already selected Mic 3 if not already selected DAW 1 if not already selected MM even if already selected Telephone 1 if not already PGM Mosaic Monitor Hotkeys Functionality Description This function is designed for the Mosaic s Monitor hotkeys It routes the selected source and updates the lamp statuses In addition we have a function that will respond to a route change and update the Mosaic hotkey button lamps This is necessary in case the route was changed externally e g by another Trigger Components This function has an On Trigger when the button is pressed plus a Procedure and a Route Trigger The lat
88. and If Statements to only permit the functionality during certain scenes Components This function has an ON button pressed and an OFF button released Trigger for the mic mute Button On Trigger pressed gt Scan surface to see if microphone channel is on gt Turn on Cough Mute function BUS8 on microphone channel gt Tally text MUTE to microphone channel on surface so operator sees mute is active gt Turn GST 22 MUTE lamp on Button Off Trigger released gt Turn off Cough Mute function BUS8 on microphone channel gt Clear tally text to microphone channel on surface so operator sees mute is not active gt Turn GST 22 MUTE lamp off Further Information gt If State Scan Page 150 gt Bus On Off Page 55 gt Text Label Page 94 Script Examples trigger ael d St731 Guest 1 H P bus33 on N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Cough Mute REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic Mute ON DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS N SSS SS SS SS SS SS SS SS SSS SS SS SS SS SS SS SS SS SS 2 if state scan ael surfl s St731 Mic 2 bus0 on then cmd ael s St731 Mic 2 bus8 on cough mute on
89. and LINE1 or LINE2 To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT to replace only the written text and keep other text on the line VVVVVVV oV The following are examples of small font text commands written to the Fader Wedge channell linel posl This is Text channel6 line2 posi cmd ael surfacel tex cmd ael surfacel tex Numix Large Font Text This command is used to write a ais font text to the coms half of the Fader aie Screens cmd ae surf surface text chan channel insert line pos 36 chars cmd ae surf surface text fader insert line pos 36 chars gt Large text is displayed on the upper half of the screen as 4 lines of 52 characters gt The command must contain a CHANNEL or FADER number of the Fader Wedge the keyword BIG and can be written to LINE 1 LINE 2 LINE 3 o0rLINE 4 gt Use Channel 1 for the first wedge Channel 7 for the second and so on gt To clear a line write a single space string to that line without the INSERT keyword gt Use the keyword INSERT to replace only the written text and keep other text on the line The following are examples of large font text commands written to the Fader Wedge Eh big channel big channel linel posl This is Text line3 pos21 cmd ael surfacel tex cmd ael surfacel tex Ad o 84 Logitek CommandBuild
90. ap variable optional this may be referenced by other triggers Store current Monitor and Headphones routes to variables Route Post Delay Crosspoint output to Monitor and Headphones Call procedure to update Mosaic monitor hotkey lamps see Chapter 18 for more info Flash the Post Monitor button lamp Set timer based on current delay time When that time expires o Call a procedure a to update lamps and text o Update variables to track status o Send Delay Off command to Talk Delay VVVVVVV V Tally Procedures gt Turn on appropriate lamps in the studio gt Write text to screen gt Can also be used to display status lamps elsewhere in the facility gt Send assembler command to active fast lamp flash to be replaced by Fast Flash command Further Information If Variable Page 147 Call Procedure Page 53 Set Toggle State Page 74 Device Store Recall Page 144 Route Page 59 Lamp Flash Page 57 If Timer Page 48 Talk Delay Off Page 72 VVVVVV VV Script Examples trigger ael surfl chan14 bus41 on Mosaic Narr Softkey Button 10 PROCEDURE Delay Timer Exit v2 0 SharcAttack REVISED 27th April 2005 DATA ID AE1 Portl StA Narrow Softkey Big Button 10 DESCRIPTION Change monitoring to Post Delay Set timer to switch off delay when delay time expires NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS if vDelayStAOn 1
91. are examples of channel label text commands written to the Fader Screen label MUTE label cmd ael surfacel channell text cmd ael surfacel channel6 text FE ct To set an alias for an input see the Set Device Alias command in Chapter 12 Artisan Effects Screen The Artisan Effects Module MTK EFFECTS contains one screen This screen does not support user text For further details see the Artisan Manual Artisan Master Screen The Artisan Master Module MTK MASTER contains two screens that allow Aliases to be written The Alias is an 8 character string in small font Artisan Master Text This command is used to write a label to the Artisan Master Screen ae Not Used device dest set ae Not Used d Device Name dest alias 12345678 Set alias 12345678 cmd cmd The label is small font text displayed for each meter directly below the meter This label may have a maximum of 8 characters The command must contain the SOURCE number and the keyword SET ALIAS The LINE or POS keywords are not required for this type of text To clear the label write a blank string To center a label you must manually pad the text string with spaces VVVVV WV The following are examples of meter text labels written to the Master Screen cmd ael s Sub 1 Pre Fdr Out cmd ael s Aux 1 Pre Fdr Out alias Sub 1 alias Aux 1 se se ct ct
92. are examples of text lines written to the Softkeys Screen in Insert mode cmd ael surface2 tex cmd ae3 surfacel tex softkey line3 posl0 insert This Line softkey line5 pos19 insert Base The following are examples of clearing all or part of the Softkeys Screen cmd ael surface2 text numix2 softkey clear all cmd ae3 surfacel text softkey line 5 clear LARES O 2 STUDIO DELEGATION MST rie Adi STUDIOS E LB A DELAY E E AA ISTUDIO1 gt ISTUDIO Figure 15 Numix II Softkeys Screen Logitek CommandBuilder 3 6 Reference Manual 91 Lo gitek Numix II Fader Wedge Screens The screen on the Numix II Fader Wedge is capable of displaying three types of text These include small and large font text to the upper half of the screen and large font text to the label section of a fader This screen will also display a special Message Arrow in the upper half of the screen The Supervisor computer clock and an external temperature device can also be displayed Each Fader Wedge can display two text sizes Four lines of large text or twelve lines of small text can be displayed When in small text mode one line of large text can be displayed at the top of the screen Whilst the Numix II has color screens the majority of text functions will write text in white only However the Message Arrow function is able to display messages in a number of colors 01 132 i i i AD 1
93. ation There is no separate Command Builder command to achieve this Logitek CommandBuilder 3 6 Reference Manual 67 Lo gitek Set Mix Minus Sets the en bus for a Mix Minus on a surface These mals are not available on the surface cmd ae surf surface set mix minus set mix bus always addmic stereo This command overrides the default operation of the mix minus system for a particular engine and surface The default mix minus settings are entered on the system page of the AEConfig program gt This command must include the Audio Engine number Surface number keywords SET MIX MINUS or SET MIX and the desired Mix Minus output number gt The keyword BUS is used to change the mix bus used as the source of the mix minus gt Ifthe keyword BUS is omitted the feature keywords ALWAYS ADDMIC amp STEREO are used gt The Set Mix Minus command sets all three features if the BUS keyword is not used If the keyword is present the feature is turned on If the keyword is absent the feature is turned off gt The keyword ALWAYS causes the Mix Minus output to be active even when the Source Devices allocated to it are not in use If ALWAYS is omitted the output is silent unless an appropriate Fader is turned on gt The keyword ADDMIC routes the talkback microphone to the Mix Minus output when the Fader allocated to the Mix Minus output is turned off gt The keyword STEREO switches the mix minus output to ster
94. ation on Aux Ports see the Supervisor User s Manual Functionality Description In this example we will use the Priority Message command in the BetaBrite to display alert messages to operators When the BetaBrite receives a Priority Message it interrupts whatever the sign was displaying and switches to the text sent with the priority command until it receives a command to stop and return to the previous message routine Components In this example we have used an Audio Engine GPI as the ON amp OFF Triggers to display the message on the BetaBrite sign To activate the message we need to send a serial string to the Aux port Please note the required space between the lt ESC gt and the lowercase letter that follows it In this example we will send On Air to com 2 GPI On Trigger gt Send text On Air to BetaBrite GPI Off Trigger gt Send clear command to BetaBrite if you do not issue this command the alarm display will never turn off Further Information gt Text to Com Port Page 70 If you would like further assistance with BetaBrite signs please visit the Logitek Tech Forum at http www logitekaudio com Further examples are available here and you can communicate with other Logitek users who have implemented BetaBrites Some additional BetaBrite protocol information follows Font Size Effects You can adjust the mode effect and character set font size by adjusting two characters in the stri
95. ay Text Tally REVISED 21st February 2005 DATA ID Studio A StA Delay Off DESCRIPTION Updates delay status on Mosaic surfaces NOTES DEPENDENCIES DEBUG STATUS N SSS SSS SSS SS SS SS SS SSS SS SS SS SS SS SS SS SSS 2 2 2 2 2 cmd ael surfl chanl3 bus41 on turn on Delay Off lamp in this studio cmd ael device2C linel35 text pos97 Delay EXIT 20 Intercom Examples You can use your Logitek system to create sophisticated Intercoms between studios Setting up an Intercom is as simple as routing the appropriate source e g a microphone to the Talkback Rtn input of the appropriate surface However with a little more programming you can create a more powerful version that your operators will love to use Logitek Intercom with calling station display Functionality Description This Intercom system uses the internal Logitek Fiber Network and Triggers to create a slick user interface It is designed to make use of fibre linked Audio Engines with all possible Intercom mics already shared across all Engines If not you need to set this up in AEConfig first It can also interface with external units although for best results each external station should provide a GPI closure to indicate each destination it calls If this is not possible you can use the External Cue input on the surface however without a CPI interface external stations will not be able to acti
96. ble The New Trigger Table button allows you to create a new empty Trigger Table New TriggerT able TriggerT able A warning message will be displayed if you attempt to make a new Trigger Table after editing the current Trigger Table without saving Any changes to the current file are not saved unless explicitly done so by the user Save Trigger Table Save Trigger Table Save Trigger Table The Save Trigger Table button allows you to save the current Trigger Table in CommandBuilder to a file Clicking the Save Trigger Table button displays a standard Windows Save As dialog box Select an existing file name or enter a new file name and press Save to write the file to disk Select Cancel to go back to the program without saving A warning message will be displayed if you attempt to make a new Trigger Table read an existing Trigger Table or exit the program after editing the current Trigger Table without saving it Any changes to the current Trigger Table are not saved unless explicitly done so by the user Although not required it is a good idea to save the current Trigger Table before uploading it to Supervisor TIP As with any configuration editing and development it s a good idea to save different revisions of the file when you make major changes This gives you an easy rollback path if your changes don t work as intended or you need to review previous code You can use any naming convention that wo
97. cept selection from the user if accept selection text device d DeviceName This Test Statement contains commands to be executed when Accept is pressed The Source Device that is highlighted when the Accept button is pressed will be routed to the Destination Device specified in the SET ROUTE SELECTION MODE command The keyword THEN is optional The Audio Engine and Surface numbers are not required and are assumed to be those specified in the above SET SELECTION MODE command The commands to be executed must contain the required Audio Engine and Surface The commands to be executed must be followed by the required ENDIF line The selected Source Device number is stored in the User Variable specified in the SET ROUTE SELECTION MODE command The selected Source Device name can also be displayed tallied on the surface by using the optional keyword TEXT followed by the desired location The text tally destination can be specified by Device number or d Destination Device notation The text tally destination does not support the SOFTKEY keyword Use DEVICE28 to write to the Softkey screen on a Numix II The text tally does not support channel numbers use the channel s Device Number to write to the Numix Remora Artisan and Mosaic fader screens Route Select If Cancel This Test Statement is used to test for a cancel selection from the user if VVVV WV VV WV cancel delay seconds then This Test Statement co
98. cific Input routed to fader a specified device UNROUTE An UNROUTE Trigger is fired when a specified route is Other Input routed to fader regard de USER VARIABLE A USER VARIABLE Trigger is fired when there is a change User Variable value change AAA APA Y SYSTEM VARIABLE A SYSTEM VARIABLE Trigger is fired when there is a System Variable value change change to the value of a system variable The General Triggers are described in more detail on the following pages 38 Logitek CommandBuilder 3 6 Reference Manual Lo gitek General Trigger Format On Trigger Fires when the specified Bus On event occurs trigger ae Not Used trigger ae Not Used device dest bus device source bus toggle toggle trigger ae surf surface fader bus bus toggle trigger ae surf surface chan channel on toggle trigger ae Not Used d DeviceName bus on toggle trigger ae surf surface s DeviceName bus on toggle trigger ae surf surface bridge softkey butt button on toggle gt This Trigger must include the Audio Engine number Surface number Device or Fader number Bus number and the required keyword ON gt One of the keywords CHANNEL FADER DEVICE BRIDGE or SOFTKEY is required gt The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the D
99. cifies Remora control surface Used to make a Schedule Event Trigger repeat on a given interval Used in setting Fader pan Refers to the ROC 5 or ROC 10 consoles Assigns a Source Device number to a Destination Fader or Channel SATURDAY SCAN SCHEDULE SELECT SET SOFTKEY SOURCE START STATE STEREO STOP STORE SUNDAY SURFACE SWITCH TALK Day of the week used in a Schedule Event Trigger Checking for state or Fader input Used to denote Schedule Event Triggers Used in selection routines Used to set User Variables and Trigger States Refers to the Softkey Buttons on Numix console Com port that receives incoming data stream Used to begin the Talk Delay function Used in if state of engine equals tests Sets Mix Minus bus to stereo Used to remove a clock text display from a console or stop the Talk Delay function Saves a value to a User Variable Day of the week used in a Schedule Event Trigger Port number of console Same as BUS or RELAY Used to set a Talk Delay function TEMPERATURE Sets the temperature sensor parameters TEXT THURSDAY TIME TIMEOUT TIMER TITLE TOGGLE TRIGGER TRIM TUESDAY UDP UNROUTE v WAIT WEDNESDAY WHITE WHEN YELLOW Defines a line of text for console Day of the week used in Schedule Event Trigger Used to set the time of a Schedule Event Trigger Sets the number of seconds before which a timer will fire Same as DELAY or WAIT Numbered timer for system use Sets the title in show s
100. cmd ae surf surface fader set trim 10 to 10 dB none cmd ae Not Used d Device Name set trim 10 to 10 dB none cmd ae Not Used device set trim 10 to 10 dB none gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword TRIM gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation gt The allowable range of trim values is from 10 dB to 10 dB where 0 indicates O dB gt The plus sign and the keyword dB are optional gt The keyword NONE may be used to set O dB trim The following are examples of the Set Fader Trim command cmd ael surfacel channel2 set trim 10 db cmd ae3 d Port2 Fader6 In cmd ae2 surface2 fader7 set cmd ae3 d Port3 Faderl In Logitek CommandBuilder 3 6 Reference Manual trim 0 trim 3 trim none 63 AS Lo gitek Set Fader Pan Sets the a value of a ie fader or Destination Device Same as all fader sal on surface cmd ae surf surface chan channel set pan 20 to 20 center left right cmd ae surf surface fader set pan 20 to 20 center left right cmd ae Not Used d Device Name set pan 20 to 20 center left right cmd ae Not Used device set pan 20 to 20 center l
101. cmd ael d Ctrl Surfl GPI out bus43 flash fast new format cmd ael surfl chan13 bus44 flash medium new format 58 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Fader Commands This group of commands is used to manipulate faders including routes levels trim mode alias and effects Input Route Te a aeaa Source Device to a Destination Device Same as 7 Tati on surface cmd ae surf surface route device to chan channel fader cmd ae Not Used route s Device Name to d Device Name gt This command must include the Audio Engine number Surface number Source Device number Destination Device number and the required keyword ROUTE gt The Source Device can be specified using keyword DEVICE or using the s Source Device notation gt The Destination Device can be specified by using the keywords FADER or CHANNEL or usingthe d Destination Device notation gt The use of the TO keyword is optional gt The last routed Destination Device number is automatically stored in a special system Destination Device that can be referenced with the d LastRoute notation The following are examples of the Route command cmd ael surfacel route device 0103 to channel2 cmd ae3 route s Portl Program Out to d Portl Fader In Logitek CommandBuilder 3 6 Reference Manual 59 Lo gitek Set Device Alias penitus an 8 character alias to a Source Device for Sada on Surfaces cmd ae d
102. cond generation released summer 2013 console substitute the display keyword for the surface numix1 numix2 remora artisan mosaic keyword as follows display device 27 screenl Use the screen number that corresponds with the console module as described in the console manual See example command at the end of this section gt The keyword SET is optional gt The selected Source Device value is saved in the required User Variable specified with vUserVariable notation gt The User Variable is required and must be uniquely assigned The User Variable cannot be used by another Variable Select or Route Select Trigger or unpredictable results will occur Route Select Text This command is used to enter the title for the Route Select mode on a surface cmd gt gt text selection title 1234567890123 13 characters This command is used to set the title for the list The Audio Engine number and Surface are not required in these commands and are assumed to be those specified in the SET SELECTION MODE command The keywords TEXT SELECTION TITLE are required for the title line of the selection list The items in the selection list will be the available Source Device names for the specified Destination Device An IF CANCEL statement is required In May 2005 versions and later an error will be generated if no IF CANCEL follows a Route Select command Route Select If Accept This Test Statement is used to test for an ac
103. d Audio Engine and Surface The commands to be executed must be followed by the required ENDIF line The selection is stored in the User Variable from the SET SELECTION MODE command Variable Select If Cancel This Test Statement is used to test for a cancel selection from the user if cancel delay seconds then VVVV WV VV WV This Test Statement contains commands to be executed when Cancel is pressed This is required even if there are no commands to be executed when Cancel is pressed The keywords IF CANCEL are required The keyword THEN is optional The Audio Engine and Surface numbers are not required and are assumed to be those specified in the SET SELECTION MODE command The commands to be executed must contain the required Audio Engine and Surface The commands to be executed must be followed by the required ENDIF line The statement contains an internal timer that will execute the specified commands when it expires The delay time is set using the keyword DELAY followed by the number of seconds The IF CANCEL automatically sets its timer to 60 seconds When the Cancel button is pressed or the internal timer expires the value of the User Variable is not changed and the Selection Mode display on the surface is cleared The following is a complete example of a Variable Select function for consoles designed before Summer 2013 Artisan Numix1 Numix2 Mosaic first generation Remora cmd ael
104. d ael d St731 Guest 1 H P bus23 on timer reset endif trigger ael s St731 Mic 2 bus0 off ASSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Mic ON OFF REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic Mute OFF DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS 2 g 2 2 2 if state scan ael surfl s St731 Mic 2 bus0 off then cmd ael d St731 Guest 1 H P bus11 off On lamp off cmd ael d St731 Guest 1 H P bus12 on Off lamp on cmd ael d St731 Guest 1 H P bus20 off Tally Output off cmd ael d St731 Guest 1 H P bus23 on timer reset cmd ael d St731 Guest 1 H P bus22 off timer stop endif 24 vSnapshot Examples This chapter includes some examples of using Trigger functions with Logitek s vSnapshot application These Triggers allow the user to perform Capture Recall and Edit functions from the Mosaic Artisan surface These examples are for a MLX WSOFT panel but also apply to any panel with user programmable buttons See the Logitek vTools User s Manual for how to set up vSnapshot Capture On Functionality Description Launches vSnapshot Capture Mode and captures settings in the console s RAM The command is sent to the specified Audio Engine Components This function has an
105. d for a Bridge Lamp or a Softkey Lamp The Destination Device can be specified using keyword DEVICE or using the d Destination Device notation gt When using a Device name number or Channel number BUS must used instead of LAMP gt The number of times followed by the optional keyword TIMES is used to specify how long the lamp flashes for The timeframe depends on flash speed The keyword continuous is assumed if the flash time is not specified On Artisan Mosaic and COM12 hardware a flash time of SLOW MEDIUM or FAST can be used If the rate is not specified MEDIUM is assumed This is the rate supported by older hardware SLOW flash is on for 1 second then off for 1 second MEDIUM flash is on for 1 2 second then off for 1 2 second FAST flash is on for 1 4 second then off for 1 4 second To flash for a certain amount of time use this formula based on flash speed and number seconds on seconds off No of Flashes The keyword FLAG is no longer required but is retained for compatibility The keyword CONTINUOUS is no longer required but is retained for compatibility Do not use the keyword PULSE with regard to lamp commands VVVVV VV VV Vv VV V The following are examples of the Lamp commands cmd ae4 surface2 bridge lamp2 flash once old format cmd ae2 surfl chan13 bus33 flash once 5 old format cmd ael device27 busl flash continuous 3 times old format cmd ael device27 busl flash 3 times new format
106. d using the keyword AND Individual Test Statements follow the same rules as the If State Test Statement above The keywords AND and OR can t be mixed in the same multiple test statement The EQUALS sign is not required VVVVV WV Following is an example of the If State test with multiple test conditions using the AND condition if state ael surf3 chan3 bus0 on and ael surf3 chan4 bus0 on then cmd ael surf3 route s ISDN 2 to d Portl Fader 3 In endif If State Or Tests the state of a conditions in a ae Audio ate One must evaluate to true if state first test condition OR second test condition then The If State Test Statement can be combined with itself to test multiple states If one of the individual Test Statements is true the block of commands is executed Each separate statement must be enclosed in parenthesis and joined using the keyword OR Individual Test Statements follow the same rules as the If State Test Statement above The keywords AND and OR can t be mixed in the same multiple test statement The EQUALS sign is not required VVVVV WV Following is an example of the If State test with multiple test conditions using the OR condition if state ae2 chanl bus0 off or ae2 chan2 bus0 off then cmd ae2 route s CD 2 to d Port 1 Fader 4 In endif If State Scan Tests the state of a Source Device wherever it a ina aa Audio n if state scan ae surf surface s Device bus ON OFF then
107. dBuilder 3 6 Reference Manual 55 Lo gitek Button Bridge or Softkey On Off Turns a Bridge or Softkey button not lamp on or off cmd ae surf surface bridge softkey button butt on off gt The Bridge or Softkey button on a given Surface may be turned on or off gt This command applies to the button itself not to the lamp in the button gt This command must include the Audio Engine number Surface number and the required keyword BRIDGE or SOFTKEY and BUTTON gt The keyword LAMP must NOT be used gt One of the keywords ON or OFF is also required The following are examples of the Bridge or Softkey button commands cmd ael surfacel bridge buttonll on cmd ae3 surfacel softkey button2 off TIP You can also set a Bridge or Softkey Button on or off using its Device Number and Bus Number however it is much easier to use the notation above 56 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Lamp On Off Turns a bridge or softkey lamp on or off cmd ae surf surface bridge softkey lamp on off cmd ae surf surface channel bus on off cmd ae Not Used device bus on off cmd ae Not Used diDevice Name bus on off gt The Lamp in a specified Bridge Button Softkey Button or other Destination Device may be turned on or off gt This command applies to the lamp in the button not the button itself gt This command must include the Audio Eng
108. dge supports a clock a timer and text on any of the 2 LCD screens You cannot send auxiliary meter displays to the bridge in an Artisan configuration as those meters are already displayed on the Master module by default The screens of a Wide Bridge are shown below Logitek Figure 32 Artisan Meter Bridge In the above example the clock and the timer are shown on LCD 1 and LCD 5 respectively They can however be located on any other screen through the use of triggers Therefore any screen not being used for a clock or a timer may also be used for text Each screen has 8 lines of text available which must be addressed using the following channel amp line numbers Artisan Wide Meter Bridge Screens Screen 1 Clock device 3B Screen 2 Usertext____ devices3 6572 Screen 3 User text devices3 129 386 Screen 5 Timer device 6572 Screen 6 User text device54 1299386 Artisan Narrow Meter Bridge Screens Notes let Monitor meter amp userre devices is J OCOC CSC lt lt CS SCS S S CSC Rig Monitor meter amp user text devices3 is J O Oo oOo T6 characters available Studio A Pst A TX Studio A Pst 11 18 ce Hust SCENE 1 SDN Studio A PGM Default 09 i Figure 33 Artisan Meter Bridge Screens 1 3 Artisan Clock This command is used to write a clock display to the Meter Bridge Screens cmd ae surf surface clock chan channe
109. dit the Trigger file in a text editor provided the above warnings are heeded When you first open CommanaBuilder you will see a number of buttons across the top These are used to access core functions of the program Logitek CommandBuilder 3 6 Z i Edit Trigger Read A Save EA EXA Table EA ME a Triggers List Trigger Table Ea Trigger T able EA able to EXA EA ME a EDIT TRIGGERS Trigger Number E Status Trigger Active Trigger Title NEW TRIGGER AE Protocol Script Trigger Table File Name Figure 4 CommandBuilder main page Logitek CommandBuilder 3 6 Reference Manual rots Y Lo gitek Read Existing Trigger Table Read Read The Read Trigger Table button allows you to read an existing file into CommandBuilder A Trigger Table must be read before it can be edited or uploaded to Supervisor Clicking the Read Trigger Table button displays a standard Windows Open File dialog box Select the appropriate file and press Open to read the file Choose Cancel if you accidentally click the button A warning message will be displayed if you attempt to read an existing Trigger Table after editing the current Trigger Table without saving The last file that was read or saved is automatically loaded the next time CommandBuilder is started The Edit Triggers screen is automatically displayed after the Trigger Table file is read Create New Trigger Ta
110. ds on the assignment mixer size One fader input is required per studio additional studio Mix Minus or Network Cleanfeeds will also require a fader each One Mix Bus e g PGM AUX1 8 is required per destination path If using AUX4 8 as destination paths the virtual surface must be on Port 1 In larger facilities we suggest using a dedicated MCR Audio Engine for the Assignment Mixer In some cases custom DSP tables can be provided to re allocate other Audio Engine resources to gain additional destination paths If using SharcAttack DSP cards each input to the delegation mixer can have EQ and dynamics settings applied providing basic protection limiting and compression prior to link paths The DSP table for this Audio Engine Port will be customized to set fader inputs to unity gain by default with the relevant BUS settings The mixer is then controlled by Triggers Panel Example Below is an example of a 12 button panel This could be a Numix Bridge Remora Bridge vertical or a Mosaic MLX 42 MLX NSOFT modules mounted in a compatible Wide Meter Bridge assembly Network Network Network Network 5 6 7 8 Functionality Press the Enable button to turn the panel lock off It will flash Use the On air Master to turn your studio on or off air in on action When on air press any of the paths to add your studio into that mix Press again to remove When off air press any of the paths to pre select flashing Press again to remo
111. dures into a Trigger Table that is later uploaded to Supervisor Uploading Existing Triggers and Procedures Regardless of the origin of your Trigger Table it needs to be uploaded to Supervisor to be executed If your station uses a third party to provide Trigger Tables you ll only need to read and upload the Triggers and Procedures with CommandBuilder What are Triggers and Procedures A Trigger is an event hook that tells Supervisor what to do when something inside an Audio Engine happens Triggers contain two primary parts 1 The first line which tells Supervisor what to trigger on e g a particular button press 2 Anumber of lines of code to execute when that Trigger event occurs For example if you have a Numix Button24 Wedge a panel with 24 buttons lamps you have a trigger for each button on that panel that you assign a function to Often you might have Triggers assigned only to the ON function i e to run a function when the button is pressed In some cases you will also have a corresponding OFF trigger that runs when the button is released e g a push to talk type function Procedures are reusable code blocks that can be called by Triggers or other Procedures These are useful for reducing code repetition for frequently used functionality Logitek CommandBuilder 3 6 Reference Manual 15 EA 7 Logitek The exact format of Trigger and Procedure commands is covered in Part B of
112. e then if ae Not Used d Device Name talk time As Above then gt Talk Delay time can be compared as equal not equal lt gt less than lt greater than gt less than or equal lt or greater than or equal gt gt Ifthe comparison is true the enclosed block of Action Commands is executed gt The Action Commands to be executed if true must appear between the If Talk Time statement and its corresponding required ENDIF keyword gt A valid Audio Engine and Destination Device is required along with the keywords TALK TIME gt The Destination Device may be in DEVICE d Destination Device or SURF CHAN notation gt The delay time in tenth of seconds is multiplied by ten delay time 1 1 seconds 11 gt The keyword THEN is optional but recommended for improved code readability gt This Test Statement cannot be combined with other Test Statements using AND OR The following examples illustrate the use of the If Talk Time statement if ael d Portl Delay CP1 In talk time 70 then cmd ael surfacel bridge lamp12 on endif if ael surfacel chan38 talk time lt 70 then cmd ael surfacel bridge lamp12 off endif When Off Executes a set of commands when a vil fader is turned off when off ae surf surface chan channel when off ae surf surface fader when off ae Not Used d Device Name when off ae Not Used device gt The When Off statement tests a specif
113. e BetaBrite signs see http www betabrite com or see Chapter 22 for more detailed information 70 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Relay Pulse Used to ai a ai on an Audio n or Control Surface cmd ae device relay bus pulse cmd ae d Device Name relay bus ulse gt This command must include the Audio Engine number the Destination Device number and requires keywords RELAY and PULSE gt The Destination Device can be specified using the d Destination Device notation gt The Relay number is equivalent to the Bus number The two keywords can be interchanged gt This command will also accept the Destination in the Surface and Channel Fader notation however for improved readability this usage is not recommended The following are examples of the Relay Pulse command cmd ael device0001 relay5 pulse cmd ael d Ctrl Surfl GPI out relay12 pulse See the On Off command on Page 55 to turn a relay on or off instead of pulse it Assembly Command Used to send Audio ats Protocol command ia to an Audio a for advanced users cmd ae asm O2 XX XX XX XX gt This command sends a command to an Audio Engine using the Audio Engine Protocol gt This command must include the Audio Engine number and the required keyword ASM gt The command should follow as a hex code string with one space between each hex byte gt See the Audio Engine Protocol or contact Logitek for mo
114. e nested to provide very powerful and complex logic tests See Chapter 16 for more details on Test Statements User Variables User Variables can contain user defined integer numeric values and Device numbers assigned to a Faders and Routes There can be a maximum of 320 user defined variables The variables are not assigned to a particular Audio Engine and are accessible from all Triggers and Procedures The changing or setting of the User Variable value is itself a General Trigger See Chapter 7 for more details on using a User Variable set in a General Trigger System Variables System Variables store numeric values generated by Supervisor itself The values of these variables are read only and can only be changed by Supervisor in response to certain events They are intended to provide the ability to respond to status and error events in the system The changing or setting of a System Variable value by Supervisor is itself a General Trigger See Chapter 7 for more details on using a System Variable set in a General Trigger Defining Variables User Variables are defined on the System Page in CommandBuilder program The variable name can contain a maximum of 30 alphanumeric characters Spaces are not allowed in variable names A User Variable is referred to using the vMyVariableName notation This notation is the User Variable name with the prefix v The v prefix is not part of the variable definition See Chapter 5
115. e select again to cancel Routes can also be tallied to text screens VVVVVV Requirements gt 1 Output or DSP Crosspoint amp Output per path DSP provides gain control and mono mix gt If using DSP Crosspoints a virtual Router surface is required on an available port gt 1 Button panel per studio gt 1 Button on panel per source destination combo Network Source Switcher XY Version The Network Source Switcher XY Version provides the same functionality as the Direct Access Version but allows for more source destination combinations The disadvantage is that current routes are less visible on the panel itself and surface or virtual text screens must be used to tally routing information Like the Direct Access NSS the XY version uses DSP Crosspoints on a virtual surface or Output Routes Panel Example Below is an example of a 24 button panel This could be a Numix NW24 wedge Remora BTN24 module or two Mosaic MLX 42 modules mounted in a compatible Wide Meter Bridge assembly The top row of 12 buttons is for sources and the TAKE button The bottom row of 12 buttons is for destinations creating up to an 11x12 router Studio A Studio B Studio B Edit Bth Edit Bth Network TAK In this example Studio A Post Delay TX A TX B and TAKE buttons are lit ISDN path is flashing Functionality gt Press source button top row If allowed in this studio it will display the current destination routes on the bottom
116. ed The purpose of the Init Trigger is to perform one off setup commands for example writing text labels to surfaces The user can fire the Init Trigger at any time by pressing the Execute Init Triggers button on the Audio Engine Log page of the Supervisor Care should be taken in selecting the commands in an Init Trigger since these items will be executed every time Supervisor is started The Init Trigger is not required to be active or even exist General Rules The keyword INIT TRIGGER must be the first line of the Trigger The first line can t be a comment line There is no Audio Engine or Surface numbers for the Init Trigger it is a global event The Init Trigger is usually listed first in the Trigger list but may be inserted at any position The Init Trigger is not required it is optional There can only be one Init Trigger per Trigger Table V VVV V V Declaring the Init Trigger The Init Trigger is defined by placing the keywords INIT TRIGGER on the first line of an available Trigger in the Trigger List page Once you have found where you wish to place the Init Trigger double click that row to edit the Trigger text The Init Trigger definition is then the first line in the edit box Init Trigger Format Init Trigger Occurs on wi sup and when ane activated from penha trigger Init gt The Init Trigger must be marked active for Supervisor to process the Action Commands that follow 44 Logitek CommandBuilder 3 6
117. ed it out Lamps Off Procedures one per destination station gt Turn OFF that destination lamp at each station except itself where there is no button gt For consistency and code copying we have kept the source to source line but commented it out Receive On Procedure one per destination station gt Turn ON the Talkback Return bus at the destination bus numbers may vary on older DSP gt Set the lockout variable to 1 Receive Off Procedure one per destination station gt Turn OFF the Talkback Return bus at the destination bus numbers may vary on older DSP gt Route silence source to Talkback Return bus just to be sure no audio continues optional gt Restore the lockout variable to 0 Options These scripts can be customized to suit your requirements For example Talkback Rtn can be routed to Cue Speaker Headphones including selectable mute when Mics on Monitor speakers and Guest Studio send These functions are set by various bus switches on the monitoring inputs and are usually pre set in your AEConfig DSP tables If you wish to send talkback to an external location you can omit the Talkback Rtn bus on off lines in the procedure If you wish to receive talkback from an external location write a Trigger that is activated by a GPI ON and OFF instead of a button it will have no lamp tallies obviously Timers Each Intercom source destination set needs a unique timer number allocated to it It is important
118. edures procedures ProcedureName no spaces allowed gt See General Rules on previous page Writing Procedures All of the commands and statements that can be used in General Triggers can be used in Procedures Procedures look very much like General Triggers with the exception of the first line which must contain the required keyword PROCEDURE followed by a user defined unique ProcedureName The following is an example of a procedure that is used to turn off all the faders of a 6 channel console on Audio Engine 1 Surface 2 procedure AElSurface2AllFadersOff cmd ael surface2 channell bus0 off cmd ael surface2 channel2 bus0 off cmd ael surface2 channel3 bus0 off cmd ael surface2 channel4 bus0 off cmd ael surface2 channel5 bus0 off cmd ael surface2 channel bus0 off If there were similar procedures for other surfaces the following procedure could be used to turn off all the faders on all the surfaces procedure AE1A11SurfacesAllFadersOff call AElSurfacelAllOff call AElSurface2A110ff call AElSurface3Alloff 52 Logitek CommandBuilder 3 6 Reference Manual AS Lo gitek Using Procedures The following is an example of a Trigger that needs to turn all faders on a given Surface off when a particular Bridge Button on the Surface is pressed Other commands can occur before and after the Procedure call trigger ael surface2 bridge button12 on cmd ael surface2 bridge lamp12 on
119. eft right gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword PAN gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation gt The allowable range of pan values is from 20 for full pan left to 20 for full right pan gt A pan value of O indicates the channel center gt The plus sign is optional gt The keyword LEFT may be used for full pan left values and the keyword RIGHT may be used for full pan right values gt The keyword CENTER may be used to set the pan value to the center of the channel The following are examples of the Set Fader Pan command ael ae3 ae2 ae3 ael cmd cmd cmd cmd cmd surfacel channel 2 set pan 20 d Port2 Fader6 In pan center surface2 fader 7 pan right 18 d Port 3 Fader 1 In set pan 0 d Port 1 Fader 1 In pan left 10 Logitek CommandBuilder 3 6 Reference Manual f Lo gitek Set Fader Limiter Sets the limiter USE of a dan fader or Destination Device Same as surface controls cmd cmd cmd cmd ae surf surface chan channel set limiter threshold ratio release ae surf surface fader set limiter threshold ratio release ae Not Used d Device Name set limiter threshold ratio release ae Not Used device s
120. el is off endif if state ael surfl chan09 bus0 off cmd ael surfl chan09 bus1 on Fader 09 PGM on if channel is off endif if state ael surfl chanl0 bus0 off cmd ael surfl chanl0 busl on Fader 10 PGM on if channel is off endif if state not ael surfl chan01 route device s Sat Net when ael surfl chan01 off cmd ael route surfl chan01 device s Sat Net gt endwhen endif if state not ael surfl chan02 route device s Ed2 PGM St N when ael surfl chan02 off cmd ael route surfl chan02 device s Ed2 PGM St N selected endwhen endif if state not ael surfl chan03 route device s StA CD1 when ael surfl chan03 off cmd ael route surfl chan03 device s StA CD1 endwhen endif if state not ael surfl chan04 route device s StA CD2 when ael surfl chan04 off cmd ael route surfl chan04 device s StA CD2 endwhen endif if state not ael surfl chan05 route device s StA MD1 when ael surfl chan05 off cmd ael route surfl chan05 device s StA MD1 endwhen endif if state not ael surfl chan06 route device s StA Mic 1 when ael surfl chan06 off cmd ael route surfl chan06 device s StA Mic 1 endwhen endif if state not ael surfl chan07 route device s StA Mic 2 when ael surfl chan07 off cmd ael route surfl chan07 device s StA Mic 2 endwhen endif if state not ael surfl chan08 route device s StA Mic 3 when ael surfl chan08 off cmd ael route surfl ch
121. election routines Defines an on Trigger as the Toggle Type Define trigger event line Sets the Fader input trim Day of the week used in Schedule Event Trigger Specifies UDP socket address for text data destination Refers to a route that is replaced by a new route Lower case as a prefix designates a User Variable name Sets the number of seconds before which a timer will fire same as DELAY or TIMEOUT Day of the week used in Schedule Event Trigger A color used for text on Numix II color display Specifies command to execute when channel goes off A color used for text on Numix II color display Lower case as a prefix designates a System Variable name
122. elopment The CommanaBuilder paste function works correctly only if the file is saved and reloaded after every time the paste button is used Files damaged with the paste button can be fixed with Notepad or WordPad The bug makes Trigger titles or scripts seem to disappear gt Text To UDP commands are not currently supported VV V VV V Version History Dec 2004 Service Release Jan 2005 Corrected issues with IF VARIABLE tests using device numbers and variable comparisons April 2005 Problems with COMPRESSOR GAIN commands corrected May 2005 16 character version CommandBuilder16 exe release Service release of CommandBuilder2002 exe compiled in Delphi 7 Prevents VARIABLE SELECT without corresponding IF CANCEL which can freeze Supervisor June 2005 The following updates apply only to CommandBuilder2002 exe New flash rates now supported Keyword ONCE for flash is no longer supported Fixes incorrect error message on incomplete SET SELECTION MODE Fixes TEXT TO COM PORT problem with lt 1C gt hex byte being sent For 16 character systems the June 2005 fixes have been incorporated into CommanaBuilder 3 August 2005 CommandBuilder3 merges recent fixes and support for 8 amp 16 character Audio Engines in the one executable TIMERS were incorrectly translating to support tenths of seconds prior to Supervisor support being added CB 3 amp Supervisor 3 will ultimately support tenths of seconds
123. em It allows you to program the various buttons and GPls on the Audio Engine and Surfaces and write triggers that react to almost anything that occurs In CommandBuilder the user writes Audio Engine action commands that are executed when a trigger occurs in the Audio Engine Triggers are basically events for example a button is pressed a GPI is activated or a fader source is changed Triggers are built in CommandBuilder and stored in text format The Trigger Table is compiled into proprietary format and uploaded to Supervisor The true power of Triggers is unleashed in multi engine systems Supervisor can control interactive events among multiple Audio Engines such as an intercom between studios or on air switching How to Use This Manual The primary purpose of this manual is to introduce the reader to the Logitek Scripting Language and to provide a useful starting point for developing your own Triggers The manual is divided into three main parts These can be read in isolation to suit the level of knowledge the reader requires Part A Using CommandBuilder The first section of the manual provides an introduction to the application and how to navigate your way around it CommandBuilder operates like most Logitek applications so these topics are quick summaries Part B Logitek Scripting Language The majority of the manual is devoted to a Logitek Scripting Language reference providing detailed explanations of al
124. em utilizing the Supervisor and vTools applications CommandBuilder is used to design macros or triggers that perform advanced functionality The Logitek Scripting Language is a simple programming language that provides a level of control over your Logitek system that is limited only by your imagination It is assumed that the person responsible for installing and configuring Supervisor has a solid understanding of Microsoft Windows desktop operating systems or has ready access to IT support Users wishing to develop complex Trigger functionality will benefit from any programming experience Manual Conventions The following conventions are used in this manual This text indicates a menu choice to be made with an arrow separating a multi level selection e g Control Panel gt Users amp Passwords This can be a menu choice in a Logitek application or within Windows Indicates a see also section in this manual or another Logitek manual AN The exclamation symbol signifies an important note or critical information This text represents a command script block example instruction to be typed or directory path TIP A useful tip from our knowledge base This page is intentionally left blank Logitek CommandBuilder 3 6 Reference Manual 11 j gt a Logitek About CommandBuilder The CommanaBuilder program is a special text editor developed by Logitek to add advanced functionality to your Logitek syst
125. en cmd ael surfacel bridge lamp4 off endif Route Select gt The Route Select function is similar to the Variable Select function gt The user selects a Source Device from a displayed list gt The items in the selection list will be the available Source Device names for a specified Destination Device set in AEConfig similar to a Fader input select gt The Select Knob is used to move the highlight bar to the desired Source Device and then the Accept button is pressed to make that selection gt The Cancel button can be pressed to exit Selection Mode without making a selection The examples for the individual Route Select commands follow the command descriptions Figure 39 Route Select menu Remora shown Route Select Set Mode This command is used to set the Route Select mode on a surface cmd ae surfff surface numix1 numix2 vUserVariabl set route selection mode diDeviceName remora artisan e mosaic gt This command sets the surface display to Route Selection Mode gt The Audio Engine number Surface number and type and the keywords ROUTE SELECTION MODE are required gt The surface type must be NUMIX1 NUMIX2 REMORA ARTISAN or MOSAIC gt If no surface type is given then NUMIX1 is assumed The selection list appears in slightly different displays on each type of surface so it is important that the correct type is given gt When using a ROC 2013 or newer console or Mosaic se
126. en a Conditional event occurs for example a timer A General trigger must be used to set a Conditional Trigger After being started by a General Trigger the firing of the timer is the Conditional Trigger event See Chapter 9 for more details on Conditional Triggers Logitek CommandBuilder 3 6 Reference Manual 35 Lo gitek Procedures Procedures are sets of action commands that can be called by name in other Triggers and Procedures They are like subroutines in programming or macros in word processing and allow a repetitive group of action commands to be stored in one place and used many times Each Procedure is given a unique user defined name A simple call of the procedure name replaces typing many lines of action commands in a Trigger The use of Procedures reduces the overall size of the stored Trigger Table by avoiding the duplication of frequently used code They also improve the manageability of the Trigger Table by reducing the number of places where changes might need to be made We strongly encourage the use of Procedures for code blocks that are used in many Triggers Unlike full programming languages Procedures in the Logitek Scripting Language cannot accept any arguments or return values to the calling function However through the smart use of User Variables similar functionality can be achieved See Chapter 11 for more details on Procedures Action Commands Action Commands are direct commands to the Audio E
127. ents Previously TIMERS contained within these statements would start regardless of whether the conditions being tested for were true or not and the ensuing commands would execute This bug fix remedies the problem so that TIMERS contained within these test statements do not start unless the test conditions are true This has been fixed in both the Trigger and Procedure sections of CommandBuilder August 2009 The following updates apply only to CommandBuilder3 6 exe Anew Remember Password tickbox has been included as of CommandBuilder v3 6 2 0 This is ticked by default however if you are remotely managing multiple sites it is a good idea to untick the Remember Password box This can greatly assist in preventing the accidental uploading of an incorrect Audio Engine Config to a site Appendix B Keyword Summary Introduction This is the list of keywords which are recognized by CommandBuilder and which cause actions to occur or are a part of a command statement Words not on this list can be added to improve the readability of the Trigger scripts but will be ignored The parameters required by certain keywords should not be separated from them by other keywords Usually a keyword and its parameter are separated only by spaces Keywords di 1 Destination Device name si Source Device name ul UDP address ipl IP address Equal sign also used to connect a variable or keyword to a parameter value lt gt Not equal lt Less t
128. eo if your configs support it The Bus number may be set to the following values BUS1 PGM mix bus BUS2 CUE mix bus BUS3 AUX1 mix bus BUS4 AUX2 mix bus BUS5 AUX3 mix bus BUS6 AUX4 mix bus available on Surface 1 only BUS9 AUX5 mix bus available on Surface 1 only BUS10 AUX6 mix bus available on Surface 1 only BUS11 AUX7 mix bus available on Surface 1 only BUS12 AUX8 mix bus available on Surface 1 only The following are examples of the Set Mix Minus command cmd ael surfacel set mix minus 3 bus 1 cmd ae2 surface3 set mix minus 4 cmd ae2 surface2 set mix minus 4 always cmd ae4 surfacel set mix minus 2 addmic cmd ae2 surfacel set mix minus 1 stereo cmd ael surfacel set mix minus 3 always addmic stereo 68 Logitek CommandBuilder 3 6 Reference Manual Lo gitek External Communications Supervisor has the capability to act as a serial data router as well as control external devices through serial and TCP IP commands CommandBuilder uses the following commands to control serial routing and send commands via serial IP and CPI to external devices Text to UDP Port Sends an ASCII text string to a specified UDP destination port from the local port set in Supervisor cmd udp ip 0 0 0 0 port Data enclosed in Quote Marks cmd udp u ComputerName port Data enclosed in Quote Marks gt The required keyword is UDP gt The destination IP address must be specified in the command using the u
129. ephone bus01 on PGM on tl Telephone bus03 off AX1 off tl Telephone bus00 off channel off mix 4 busl set MM4 to PGM tl Telephone text label Rtn PGM surfl s Stl Telephone 2 bus01 off is Tel 2 off PGM tl Telephone 2 bus01 on PGM on tl Telephone 2 bus03 off AX1 off tl Telephone 2 bus00 off channel off mix 5 busl set MM5 to PGM tl Telephone 2 text label Rtn PGM f1 d Portl Monitor In from vMonSt1MonAmp recall Monitor Amp f1 d Portl Headphones In from vMonSt1lOprHP recall Opr Headphones f1 d Portl Studio In from vMonSt1GstHP recall Gst Headphones lamp tally off Route Select Functionality Description This function is used to select a route from a list It is commonly used for record selection on a surface The Mosaic surface Wide Softkey module contains two text screens which support up to 6 Route Select buttons The Numix and Remora surfaces do not have button specifically designed for Route Selects but do support the command Components This function is contained within a single Trigger however sets If Accept and If Cancel Conditional Triggers The Route Select will Set selection mode using a variable the Source Device is stored to this variable Turns the button lamp on Labels the screen with the selection options If accepted then perform the route and label the screen with the selected source If cancelled or no action after 30 seconds then turn the lamp of
130. ephone channels Label these with Rtn PGM VVVVVV Whilst this Trigger appears quite long it is mostly just the same commands repeated for each fader with the relevant sources for that fader Note the check as to whether a source is already routed is not absolutely necessary However this prevents an on air fader being labeled PENDING when it would not actually be changed Further Information Set Variable Equals Page 144 Bus On Off Page 55 Clear When Off Page 76 Text Chapter 13 see commands for specific surface If State If State Not Page 149 When Page 151 Route Page 59 VVVVVVV Script Example trigger ael d Ctrl Surfl GPI In bus32 on N SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS PROCEDURE Load Scene V2 4 PD REVISED 29th April 2005 DATA ID AE1 Portl StA Wide Softkey Scene Button 1 DESCRIPTION Loads scene to console Delays fader change if it is on pending Al A2 amp A3 assignments unchanged PGM assignment unchanged if fader BUSO is turned on NOTES DEPENDENCIES Monitoring unchanged in scenes delegation delay does this 2 2 DEBUG STATUS at E EEN E E AA PAP eds o e do dora cto oo rr rn dede cd cmd set vSceneStA 1 update current scene cmd ael d Ctrl Surfl GPI Out bus32 on update Softkey Scene Lamp 1 cmd ael d Ctrl Surfl
131. er amp Procedure Lists ETT Trigger Procedure Use the buttons at the top of CommandBuilder to access the List Trigger List and Procedure List screens These screens provide a summary of the Triggers and Procedures in the Trigger Table The functions on both screens are similar Each screen contains a grid that displays the Trigger or Procedure number along with its descriptive title the number of commands whether it is valid and whether it is active The Procedure List also shows the name of the Procedure whilst the Trigger List shows the Main Trigger it will fire on Both screens also show the file name of the Trigger Table you are currently working with as well as a percentage bar showing the amount of available space occupied by Triggers and Procedures CommandBuilder has been tested on very large systems with thousands of triggers so it is unlikely you will run out of internal memory for Triggers and Procedures The grid can be scrolled to view all Triggers and Procedures Use the arrows on the scroll bar to move through the list slowly and the page up down function of the scroll bar to move quickly Double clicking on a desired Trigger or Procedure line will open the edit window detailed in the next section This will occur even if the line is blank Planning Trigger amp Procedure Allocation Like any programming language it pays to keep associated functionality in groups and leave room for the addition of future Trigge
132. er 3 6 Reference Manual Lo gitek Numix I Label Text This command is used to write a label to an os on the Fader i Screens cmd ae surfff surface chan channel text label 12345678 cmd ae surf surface fader text label 12345678 gt The label is large font text displayed in a label space directly above the fader information gt This label may have a maximum of 8 characters gt The channel label text lines must contain the CHANNEL number on the Fader Wedge and the keyword LABEL The LINE or POS keywords are not required for this type of text To clear the label write a blank string of 8 characters The label may be replaced by flashing text PENDING if a WHEN OFF command is used The label is replaced if a SET ALIAS command is issued to the source device on that fader The label is cleared when a route is performed on that fader To center a label you must manually pad the text string with spaces VVVVV V The following are examples of channel label text commands written to the Fader Wedge label Active 2 abel cmd ael surfacel channell texi cmd ael surfacel channel6 text ct ct fo Logitek CommandBuilder 3 6 Reference Manual 85 f Lo gitek Numix I Message Arrow This command is used to ee an above an a on the Fader ne Screens Cc Cc md md ae Not Used device dest message on off flash pulse ae Not Used device so
133. er active ae3 d Portl Fader 4 In bus0 off cmd set trigger active ael surface2 device 0105 bus0 on Set Toggle State aan sets the state of a nis nis cmd set toggle 1 2 TriggerDefinition TriggerDefinition The specified General Trigger must be a Toggle Trigger The allowable Toggle states are 1 normal or 2 toggle The required keywords are TOGGLE the equal sign and the desired toggle state 1 or 2 The keyword SET is optional The specification of the General Trigger should follow the keywords The General Trigger should exist before the Set Toggle State command is written The optional parenthesis around the General Trigger increases user readability The current state of a Toggle Trigger can be tested using the If Toggle Equal statement VVVVVVV V The following are examples of the Set Toggle State command ae3 d Portl Fader 4 In bus0 on ael surface2 bridge button6 on cmd set cmd set togg toggl t 1 t 2 Le Le 74 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Cancel Timer Cancels a Conditional nin that was ae started s an If Timer statement cmd cancel timer gt The required keywords are CANCEL and TIMER followed by the number of the Timer from specification of the If Timer statement gt Itis not an error to cancel a timer that is not running The following is an example of the Cancel Timer command cmd cancel timer 2 Clear Button Clears a Conditio
134. et limiter threshold ratio release gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword LIMITER The keyword SET is optional and can be used for improved code readability The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation This command can change one or more of the limiter parameters values by using the appropriate keywords THRESHOLD RATIO or RELEASE Any parameters omitted are not changed The attack value of the limiter is fixed at 100 microseconds and can not be changed The following are examples of the Set Fader Limiter command cmd ael surfacel channel2 set limiter threshold 8 ratio 3 release 20 cmd ae3 d Port2 Fader6 In set limiter threshold 8 ratio 4 release 30 cmd ae3 surface2 fader2 set limiter ratio 6 TIP To programmatically turn the limiter compressor dynamics on or off send the appropriate bus on off command to BUS22 of the appropriate destination There is no separate Command Builder command to achieve this Logitek CommandBuilder 3 6 Reference Manual 65 AS Lo gitek Set Fader Compression Sets the ene aan ofa ne fader or Destination Device Same as surface controls cmd ae surf surface chan channel set compression threshold ratio attack release cmd ae surf surface faderst set compression th
135. etting the Toggle State manually If Variable A the current value of a User or Variable to another value variable or device if vUserVariable zSystemVariable equal vUserVariable then lt gt not equal zSystemVariable lt less than gt greater than ae s DeviceName lt less equal ae d DeviceName gt greater equal ae device gt Variable values can be compared as equal not equal lt gt less than lt greater than gt less than or equal lt or greater than or equal gt gt Ifthe comparison is true the enclosed block of Action Commands is executed gt The Action Commands to be executed if true must appear between the If Variable statement and its corresponding required ENDIF keyword A System Variable is specified using the zSystemVariableName notation A User Defined variable is specified using the vMyVariableName notation The Variable value can be compared to integer values the current value of other Variables Source Device numbers using the DEVICE keyword or s Source Device notation or Destination Devices using the keywords AE SURF and CHANNEL or FADER or the d Destination Device notation gt The keyword THEN is optional but recommended for improved code readability VV WV The following example illustrates the use of the If Variable statement if vPhoneLine 1 then cmd ae3 surfacel route s Outside Phone 1 to d Portl Fader 1 In cmd ae3 sur
136. evice set alias i 8 characters cmd ae s Device Name set alias 4 8 characters gt Each Source Device can have a user defined Alias name assigned to it For example the source OB Remote venue of an ISDN line could be assigned as an alias name gt Alias names are automatically displayed on all Surfaces in the label position above all Faders to which the Device is assigned The displayed alias is changed anytime a Route is changed or the Alias itself is changed Alias names are limited to a maximum of eight characters This command must include the Audio Engine number Source Device number and the required keyword ALIAS gt The keyword SET is optional and can be used for improved code readability gt The Source Device can be specified using DEVICE or s Source Device notation YYY The following are examples of the Set Alias command with 8 character strings cmd ael device 0103 set alias Game 1 cmd ae3 s ISDN 1 set alias Ready TIP The Device Alias is an 8 character string on both 8 amp 16 character Audio Engines ele Logitek CommandBuilder 3 6 Reference Manual AS Lo gitek Set Fader Level Sets the Fader level of a canes fader or Destination Device Same as ani fader on surface cmd ae surf surface chan channel set level O to 255 INFINITY to 10dB OFF INF cmd ae surf surface fader set level O to 255 INFINITY to 10dB OFF INF c
137. exiting delay again gt Call a procedure a to update lamps and text gt Update variables to track status gt Send Delay Off command to Talk Delay Tally Procedures gt Turns on appropriate lamps in the studio gt Writes text to screen gt Can also be used to display status lamps elsewhere in the facility Further Information gt If Variable Page 147 gt Call Procedure Page 53 gt Talk Delay Off Page 72 Script Examples trigger ael surfl chan14 bus41 on Mosaic Narr Softkey Button 10 A SS ESS SS SS SS SS SS SS SS PROCEDURE Delay Hard Exit v2 0 SharcAttack REVISED 27th April 2005 DATA ID AE1 Portl StA Narrow Softkey Big Button 10 DESCRIPTION Switch off delay immediately and update tallies NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS A if vDelayStAOn 1 we are on delay at the moment call DelayTally StA Off update lamps and text cmd set vDelayStAOn 0 update variable cmd set vDelayStASafe 0 update variable cmd ael d Portl Delay CP1 In talk off force off to clear delay PGM endif procedure DelayTally StA Off N SSS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSE PROCEDURE Delay Text Tally REVISED 21st February 2005 DATA ID Studio A StA Delay Off DESCRIPTION Updates delay status on Mosaic surfaces
138. f VVVVV If the same route is to be controlled elsewhere in the system you will need some form of Route Trigger to update the text on the surface screen otherwise they will be out of sync Further Information gt Bus On Off Page 55 gt Route Select Page 132 Script Examples trigger ael d Ctrl Surfl GPI In bus81 on Mosaic Wide Softkey Text Button 3 N SSS SS SS SS SSS SSS SS SS SS SS SS SS SSS SSS SS SSS PROCEDURE Route Select v1 0 REVISED 24th February 2005 DATA ID AE1 Portl StA Wide Softkey TEXT3 DESCRIPTION Turn on Route Select Mode NOTES DEPENDENCIES DEBUG STATUS N SSS SSS SS SSS SSS SSS SS SS SS SS SS SS SS SS SS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS 2 2 cmd ael remora vRoute_StA_ MD1 set route selection mode d StA MD1 turn on route select mode cmd ael d Ctrl Surfl GPI Out bus81 on turn on lamp 3 cmd text route selection title MD 1 display text title to route screen if accept selection text ael device28 linel0 posl display routed source to route screen cmd ael d Ctrl Surfl GPI Out bus81 off turn off lamp 3 endif if cancel delay 30 then after 30 seconds of inactivity cmd ael d Ctrl Surfl GPI Out bus81 off turn off lamp 3 endif Mic Mute Functionality Description This function can be used to mute a microphone The example uses a console button to
139. f no value is added to the postion value Artisan Text Color values The following values are added to the postion value to give the text a specific color White 0 Blue 16 Green 32 Red 48 Cyan 64 Magenta 80 Yellow 96 50 Gray 112 The following are examples of small font text commands written to the Meter Bridge cmd ael surfacel 1 cmd ael surfacel 1 device53 line66 posl green This is Text device53 linel posl Figure 34 Artisan Meter Bridge Screens 4 6 Artisan Master 1 2 Meter The Master 1 2 Meter is set to follow the Master 1 2 source or depending on your Audio Engine configuration another source device This is set by the Audio Engine and is not dependent upon CommandBuilder Lines 7 amp 8 on Screen 1 amp 4 can be used for additional text displays as per the Artisan Meter Bridge Text command detailed on the previous page Artisan Timer The Artisan Timer is controlled automatically on the surface There are currently no Trigger commands to alter the timer functionality When running in auto mode the timer will reset and display the source name each time a new fader is started provided that input is set to timer reset enabled Route 3 Text The Route 3 display screen has two modes of operation in which text can be displayed Normal Mode and Message Mode Normal Mode is used to display labels below a route selection for example to label a record device name T
140. facel faderl bus0 on endif if vPhoneLine lt gt vCurrentStudio then cmd ae3 surfacel route s Outside Phone 1 to d Port2 Fader 2 In cmd ae3 surfacel fader2 bus0 on endif if vPhoneLine s Outside Phone 1 then cmd ae3 surfacel route s Outside Phone 1 to d Portl Fader 3 In cmd ae3 surfacel fader3 bus0 on endif if zSupervisorANetworkFail 1 then cmd ae3 surfacel route s Outside Phone 1 to d Portl Fader 7 In endif if zSupervisorASerialFail 0 then cmd ae3 surfacel route s Outside Phone 1 to d Port2 Fader 12 In endif If Variable And A variation of If Variable for ae tests which must all evaluate as true to execute code block if VariableName lt gt lt gt lt gt Value AND optional then The If Variable Test Statement can be combined with itself to test values of many variables If all of the individual Test Statements are true the block of commands is executed Each separate statement must be enclosed in parenthesis and joined using the keyword AND Spaces are required either side of any Variable name to ensure the variable is found Individual Test Statements follow the same rules as the If Variable Test Statement above The keywords AND and OR can t be mixed in the same multiple Test Statement VVVVV WV The following are examples of the If Variable statement using multiple AND test conditions and vScene 4 then if vPhoneLine 1 and vAirStudio 3 to d Port
141. fied Audio Engine Unlike the On Off command a Message Arrow is not directed at a particular Surface when using a Source Device The Message Arrow may be turned on or off set to flash continuously or made to flash once only One of the keywords ON OFF PULSE or FLASH is needed to set the mode of operation If the mode keywords are missing the message will default to ON The keyword PULSE will cause the Message Arrow to go on and off only once The keyword FLAG is no longer required but will not cause harm if present Since the Numix II has a color screen the color of the Message Arrow and text can be set by using one of the optional keywords WHITE RED YELLOW GREEN AQUA or MAGENTA If no color keyword is selected the Message Arrow and text are displayed in white The following are examples of Message Arrow commands written to the Fader Wedge d ael surfacel channell message green on On Air d ae4 surface2 d Portl Fader 2 In message off d ae4 surface2 d LastRoute message off cmd ae6 surface3 fader 7 message aqua flash On Air d d d ae2 s CD1 message red flash On Air ae2 device0100 message yellow pulse On Air ae2 device000b message green on On Air Logitek CommandBuilder 3 6 Reference Manual 95 f Lo gitek Numix II Clock This command is used to write a clock aller to the ae or Fader a Screens cmd ae surf surface clock Not Used softkey line pos clear insert cmd ae surf
142. files in the program directory It is possible to use the software without running an installer package However an installer package Setup3 6 exe will do all the installation tasks for you To upgrade or install using Setup3 6 exe 1 Create a new folder on your PC such as C Temp 2 Download all of the new applications to that folder including Setup 3 6 3 Launch Setup 3 6 4 Select the option that fits your situation The first option when you are installing the apps for the first time Use the second option when you are upgrading a previous installation where Supervisor is dated before 2007 This will not copy profile data and Registry entries Use the third option when you are upgrading a previous installation where Supervisor is dated after 2007 This will copy profile data and Registry entries 5 The setup program will prompt you for the location of your existing Logitek files Point it to the existing folder usually this is c Logitek but may be different at your site 6 The setup program will prompt you for the location of the new files The default is c Logitek3 6 Adjust this if you use a different folder or drive letter 7 The setup program will also give you a choice of setting up a folder called Logitek Programs in the Windows Start menu and creating Desktop shortcuts 8 Launch AEConfig 3 6 read each config file aec or a16 and save it without making any changes to ensure that any new formatting is correc
143. for more information on defining User Variables Setting User Variables Set Variable This command is used to set a User Variable cmd gt gt gt set wariableName integer vOtherVariable zSystemVariable The value of a User Variable may be set in any Trigger or Procedure The variable value is set using the keywords CMD SET followed by the variable name using the vMyVariableName notation followed by the equal sign The value of the variable may be set equal to a number or set equal to the current value of another User Variable or System Variable The following are examples of setting the value of User Variables cmd set vstudio5Phone 3 cmd set vStudio5Phone vStudio3Phone Set Variable Talk Time This command is used to set a User Variable from the current delay time of a Talk Delay Crosspoint cmd cmd cmd set wariableName ae Not Used device talk time set wariableName ae surf surfaces chanzf channel talk time set vVariableName ae Not Used d Device Name talk time The value of a User Variable may be set in any Trigger or Procedure The variable value is set using the keywords CMD SET followed by the variable name using the vMyVariableName notation followed by the equal sign The value of the variable may be set equal to the current time of a Talk Delay Crosspoint The keywords TALK TIME are required for this command A valid Audio Engine and Destination Device is required a
144. ggle Equals Test Statement Logitek CommandBuilder 3 6 Reference Manual 39 Lo gitek Off Trigger Fires when the specified Bus Off event occurs trigger trigger trigger trigger trigger trigger trigger gt ae ae Not Used Not Used device dest bus device source bus ae surf surface fader bus bus ae surf surface chan channel ae Not Used d DeviceName ae surf surface s DeviceNamel surf surfaces bridge softkey bus bus butt button ae This Trigger must include the Audio Engine number Surface number Device or Fader number Bus number and the required keyword OFF One of the keywords CHANNEL FADER DEVICE BRIDGE or SOFTKEY is required The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the DEVICE keyword If using a Source Device the Surface number is not required and will be ignored if present the Trigger will be fired no matter which Surface on the Engine causes the Bus Off event If using the BRIDGE or SOFTKEY Device keyword use BUTT or BUTTON number The Off Trigger does not have a Toggle State it only has a Single State The following are examples of an Off Trigger trigger ae3 surfacel device 000B bus0 off trigger ae4 d Port 2 Fader 1 In off trigger ael surface2 softkey button 2 off TIP When writing bu
145. gt The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command The following are examples of how to display and clear the clock on the ROC Screen cmd ael surface2 clock softkey insert line3 pos6 cmd ael surface2 clock clear softkey line3 pos6 Logitek CommandBuilder 3 6 Reference Manual I PEN Y Lo gitek Numix I Screens The Numix I has four monochrome screens on the Selector Wedge and a large monochrome screen on each Fader Wedge Time or temperature text may be displayed on the Softkeys Screen or the top of a Fader Wedge User generated text and menus can be displayed on screens on the Fader and Selector wedges The Fader Wedge screens accept user generated text in two different sizes Numix I Selector Wedge Screens The Numix Selector Wedge has three screens that can display user generated text These are labeled as the Function Screen the Selections Screen and the Softkeys Screen Each of these screens has different capabilities and requires different style text commands 78 Logitek CommandBuilder 3 6 Reference Manual AS Lo gitek Numix I Function Screen Text These commands are used to write text to the Numix I Function Screen cmd ae surf surface function radio mode cmd ae surf surface text function line 1 13 os 1 8 12345678 gt The Function Screen will display 13 lines of 8 characters each gt This scree
146. h DOCE Port Mixer A Out 0018 Porti Fader17 In 17 DelPreSelPath8 DOCF Porti Delay CP1 Out 001C Portl Fader18 In 18 DelPreSelPath9 00D0 Port Router 2 Out 001D Porti Fader139 In 19 DelPreSelPath10 00D1 Portl Router 3 Out 001E Port Fader20 In 20 DelPreSelPath11 00D2 Porti MM 4 5 Out OO1F Port Fader21 In 21 DelPreSelSet_450 00D3 Porti MM 677 Out 0020 Port Fader22 In 22 DelPreSelSet_451 00D4 Porti MM 879 Out 0021 Port Fader23 In 23 DelPreSelSet_Ed1 00D5 Port MM 10 11 Out 0022 Porti Fader24 In 24 DelPreSelSet_Ed2 00D6 Port MM 12 13 Out 0023 Port Studio In 25 DelPreSelSet_MCR 00D7 Port MM 14 15 Out 0024 Porti Monitor In 26 DelGroupASet_450 00D8 Port MM 16 17 Aux4 0025 Portl Headphones In 27 DelGroupASet_451 00D9 Port MM 18 19 Aux5 X 0026 Portl Talkback Mic 28 DelGroupASet_Ed1 Figure 6 CommandBuilder System Page 26 Logitek CommandBuilder 3 6 Reference Manual f Lo gitek Triggers amp Procedures The uses of Triggers amp Procedures are covered in detail in the Language Reference chapters of this manual In short gt Triggers are events that contain commands to be executed when something happens in your Logitek System gt Procedures are reusable code blocks that can be called by Triggers or other Procedures These are useful for reducing code repetition for frequently used functionality Logitek CommandBuilder 3
147. h while Message Mode displays six lines of 21 characters each Before text can be written to the Selections Screen it must be placed in either List Mode or Message Mode Specify List Mode by using the keywords SELECTION LIST MODE Specify Message Mode by using the keywords SELECTION MESSAGE MODE Placing the Selections Screen into either mode clears all existing text from the screen Text commands in the List Mode are displayed immediately when received by the surface Text commands in the Message Mode are buffered by the surface and displayed all at once when a text command for line 6 is received The text command to line 6 acts as a strobe and must be present for the other text commands to be made visible The text command must contain the keyword SELECTION to send text to the Selections Screen The following is an example of placing the Selections Screen into the List Mode and then displaying several lines of text Note that lines 1 4 are displayed in the left hand column and lines 8 10 are displayed in the right hand column cmd ael surfacel selection list mode cmd ael surfacel text selection linel posl On air cmd ael surfacel text selection line2 posl Phone 1 cmd ael surfacel text selection line3 posl Phone 2 cmd ael surfacel text selection line4 posl Phone 3 cmd ael surfacel text selection line8 posl Host Mic cmd ael surfacel text selection line9 posl
148. han gt Greater than lt Less than or equal to gt Greater than or equal to Minus sign Used to set fader trim or pan Plus sign Same as using no sign ACCEPT The accept button on the console ACTIVE Sets a Trigger to active state ADDMIC Adds talkback mic to Mix Minus AE Audio Engine number ALL Refers to all lines in a text commands ALWAYS Used to set the Mix Minus Bus always on ANY Optional keyword for use with a Route Trigger AQUA A color used for text on Numix II color display BIG Sets user text string displayed on a console to large size BRIDGE Refers to the Bridge buttons on console BUS Bus number in engine BUTTON Refers to Softkey Bridge or other buttons on console CANCEL CALL CENTER CHAN CHANNEL CHANGE CLOCK CLEAR CMD CONNECT DATE DAY DEFINE DELAY Used to cancel a Timer or other command Calls a named Procedure set of commands Used in pan setting commands Shortened form of CHANNEL Refers to a Fader on a console same as FADER Used in show selection commands Used to display a system time string on the console Used to clear displayed text from a console Indicates the beginning of a command line Makes a serial port connection Used to set the date of a Schedule Event Trigger Used in the repeat interval of a Schedule Event Trigger Used to define a group of commands Sets the number of seconds before which a timer will fire DESTINATION Sets the destination com port for outgoing serial data
149. han14 bus34 on toggle 2 PROCEDURE Remote record with tally REVISED 27th April 2005 DATA ID MD1 Record ON DESCRIPTION Sends Record GPI to MD1 NOTES DEPENDENCIES Relies on a record tally GPI from device to update lamp and toggle state DEBUG STATUS if toggle 1 then do this if the button was off cmd ael d Ctrl Surfl GPI Out bus07 pulse set MiniDisc 1 to record record GPI cmd ael d Ctrl Surfl GPI Out bus05 pulse set MiniDisc 1 to record play GPI cmd ael surfl chanl3 bus34 flag flash continuous flash lamp endif if toggle 2 then do this if the button was on cmd ael d Ctrl Surfl GPI Out bus06 pulse set MiniDisc 1 to stop stop GPI cmd ael surfl chanl3 bus34 off turn off lamp endif trigger ael d Ctrl Surfl GPI In bus07 on gt SSS SSS SS SSS SSS SS SS SSS SSS SS SSS SSS SSS SSS SS SS SS SSS SSS SS SS SS SSS SSS SSS PROCEDURE Record Tally REVISED 28th February 2005 DATA ID MD1 Record ON DESCRIPTION Updates status of record button lamp NOTES DEPENDENCIES DEBUG STATUS 2 2 2 2 2 cmd set toggle 2 ael surfl chan14 bus34 on set toggle state cmd ael surfl chan13 bus34 on turn lamp on trigger ael d Ctrl Surfl GPI In bus07 off N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Record Tally REVISED 28th February 2005 DATA ID MD1 Record OFF DESCRIPTION Upda
150. he given time on any day of the week by using the keywords SUNDAY MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY or SATURDAY gt The Triggers will begin responding from the date specified by the DATE keyword if it is used Logitek CommandBuilder 3 6 Reference Manual 49 f Lo gitek The following are examples of the Schedule Event Trigger for a specific date and time only trigger schedul dat trigger schedul dat 15 JUNE 2008 time 15 30 00 22 SEPTEMBER 2008 time 09 00 00 The following are examples of the Schedule Event Trigger with repeat intervals trigger schedule dat trigger schedule dat trigger schedule dat trigger schedule dat trigger schedule dat 15 JUNE 2008 time 15 30 00 repeat 10 minutes 22 SEPTEMBER 2008 time 09 00 00 repeat 2 hour 01 MAY 2008 time 22 30 00 repeat 1 day 09 AUGUST 2008 time 15 00 00 repeat SUNDAY 01 MAY 2008 time 08 00 00 repeat MONDAY FRIDAY Logitek CommandBuilder 3 6 Reference Manual Lo gitek 11 Procedures Introduction Procedures are groups of commands that are used like macros in word processing or subroutines in programming Instead of repeating the same sets of commands in many different general triggers the commands can be placed in a procedure This procedure can then be called by a simple CALL ProcedureName command in many different Triggers Procedures can also call other Procedures allowing for even further function
151. he label is displayed on the bottom line with the top line showing the selected route Message Mode is used to prompt the user for a response with the CH1 and CH2 buttons on the Route 3 s front panel When in Message Mode the route displays are temporarily hidden Before you can send text to a Route 3 you need to know its surface addressing Addresses are set with thumbwheels on the back of the unit There are two ways that Route 3 units can be addressed 1 Using a standard Surface Address with the thumbwheels set to 01 04 07 10 etc multiple units can be daisy chained on one Audio Engine Port and will use three channels per unit 2 Using an Output Address under DSP v3 and higher with the thumbwheels set to the first of three sequential output routes to be controlled by the Route 3 These device addresses are allocated by AEConfig in the Output Settings page and will be hex 6E or higher In this scenario it doesn t matter which port the Route 3 is connected to or where it is in a chain The recommended address style depends on the Port usage of Control Surfaces at your facility TIP Older Route 3 units may require a firmware update to support Output Addressing Logitek Route 3 Remote Source Selector o CH2 CH3 SELECT CONFIRM Figure 35 Route 3 Route 3 Normal Mode Text This command is used to write a label underneath a router selection on the Route 3 cmd ae surf surface chan channel route3 text label default
152. hen using Route Select the selected route can tallied next to the button as shown on the right e Figure 23 Route Select Figure 24 Route Select Mosaic Wide Softkey Text tally en This command is used to write text to the Fader Screens cmd ae surf surface text device27 insert line ___pos See below 14 chars cmd ae surf surface text device28 insert line pos See below 14 chars gt Text is displayed on as 11 lines of 14 characters gt Device 28 is the top screen device 27 is the bottom screen for surface on Port 1 Use device 50 and 4f for surface on Port 2 Channel number is not supported The command must contain the DEVICE or FADER number and LINE number To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT with a position reference to overwrite written text occupying that position and keep exisitng text on the line gt The text color can be specified by adding a predetermined value to the postion value White is assumed if no value is added to the postion value VV V Mosaic Text Color values The following values are added to the postion value to give the text a specific color White 0 Blue 16 Green 32 Red 48 Cyan 64 Magenta 80 Yellow 96 50 Gray 112 Logitek CommandBuilder 3 6 Reference Manual 107 Lo gitek The following are examples of small font text commands written to the Wide Softkey Screen
153. his may be referenced by other triggers Store current Monitor and Headphones routes to variables Route Post Delay Crosspoint output to Monitor and Headphones Call procedure to update Mosaic monitor hotkey lamps see Chapter 18 for more info Flash the Post Monitor button lamp VVVVVVV V Exit Tally Procedure gt Sends off command to delay gt Turns on appropriate lamps in the studio gt Writes text to screen Fader On Triggers one per fader on surface gt Turns off CUE amp TB on that channel unrelated optional extra gt If delay status 2 then call procedure to exit Further Information If Variable Page 147 Call Procedure Page 53 Set Toggle State Page 74 Set Variable Page 144 Device Store Recall Page 144 Lamp Flash Page 57 Talk Delay Off Page 72 Bus On Off Page 55 VVVVVV VV Script Examples trigger ael surfl chan14 bus40 on Mosaic Narr Softkey Button 10 N gt gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Delay Exit Next Event v2 0 SharcAttack REVISED 27th April 2005 DATA ID AE1 Portl StA Narrow Softkey BIG10 DESCRIPTION If on enter exit mode flash lamp Next event triggers Delay Off GPI NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS if vDelayStAOn 1 we are on delay at the moment cmd set vDelStAOn 2 upda
154. ied Surface Channel or Destination Device to determine if its Bus 0 main on off switch is currently off gt If Bus 0 is off the Action Commands associated with the When Off Test Statement are executed immediately gt If Bus 0 is not off the Action Commands are stored and executed when Bus 0 does go off gt This Test Statement is often used to route a new Source Device to a Fader when the Fader is turned off preventing it the source from changing while the Fader is on air or in use gt While the commands are stored the flashing text Pending is displayed over the Fader gt One of the keywords CHANNEL FADER or DEVICE is required gt The required Device or Fader number may be given using the d Destination Device notation instead of using the DEVICE keyword gt The keyword BUS is not used since the Test Statement always checks Bus 0 gt The Action Commands to be executed must appear between the WHEN OFF Test Statement and its corresponding required ENDWHEN keyword gt The stored commands and Pending text can be cleared using the Clear When command The following examples illustrate the use of the When Off statement when off ael surfacel d Portl Fader2 In cmd ael route s Phone 1 to d Portl Fader 2 In endwhen when off ae2 surface2 fader4 cmd ae2 surface2 fader4 route s Phone 1 endwhen Part C Examples and application notes The final section of the manual contains example Triggers and application notes t
155. if state scan ae surf surface device bus ON OFF _ then gt If State Scan is a special case of If State which includes a Source Device gt The faders on the specified Surface are checked from left to right until the specified Source Device is found If the Source appears more than once only the first instance is evaluated If the condition is true for that fader then the commands in the code block are executed The Source Device may be specified by device number or s Source Device notation The Action Commands for a specified set of conditions must appear between the IF STATE SCAN Test Statement and its corresponding required ENDIF keyword gt The required action keyword must be ON or OFF gt The keyword THEN and parentheses are optional gt Only one set of conditions may be specified in a single If State Scan Test Statement VV WV The following are examples of the If State Scan Test Statement if state scan ael surface3 s CD 1 bus0 on then cmd ael surface3 route s ISDN 2 to d Portl Fader3 In endif if state scan ae2 device0104 busl off then cmd ae2 route s CD 2 to d Portl Fader4 In endif If Variable Talk Time an the current a time value of a Talk ae ina sael Audio M n if ae Not Used device talk time equal then lt gt not equal lt less than gt greater than lt less equal gt greater equal if ae surf surfaces chan channel talk time As Abov
156. ignore button press NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS if vDelayStAOn 0 no one is on delay cmd set vDelayStAPostSwap 0 set post swap mode off cmd ael d Ctrl Surfl GPI Out bus87 off lamp FUNC3 off cmd set toggle 1 ael d Ctrl Surfl GPI In bus87 reset toggle to off state cmd ael d Portl Delay CP1 In talk off force off to clear delay PGM cmd route ael s Portl Program Out to d Portl Monitor In route Program to Monitor Amp cmd route ael s Portl Program Out to d Portl Headphones In route Program to Opr Headphones call MosaicMonitor StA Monitor update monitor hotkey lamps call MosaicMonitor StA Headphones update monitor hotkey lamps cmd ael d Portl Delay CP1 In talk start start delay PGM call DelayTally StA On update lamps and text cmd set vDelayStAOn 1 update variable cmd set vDelayStASafe 0 update variable endif procedure DelayTally StA On PROCEDURE Delay Text Tally REVISED 21st February 2005 DATA ID Studio A StA Delay On DESCRIPTION Updates delay status on Mosaic surfaces NOTES DEPENDENCIES DEBUG STATUS cmd ael surfl chan13 bus40 on turn on Delay On lamp in this studio cmd ael surfl chan13 bus43 on turn on Dump lamp in this studio cmd ael surfl chanl3 bus41 off turn off Delay Off lamp in this studio cmd ael device2C linel35 text pos33 Delay ON Delay Dump Functionality
157. ill also display a special Message Arrow in the upper half of the screen The Supervisor computer clock and an external temperature device can also be displayed Each Fader Wedge can display two text sizes Four lines of large text or twelve lines of small text can be displayed When in small text mode one line of large text can be displayed at the top of the screen Whilst the Remora has color screens the majority of text functions will write text in white only However the Message Arrow function is able to display messages in a number of colors RS ee ee RA Figure 24 Remora Fader Screen showing small text a Logitek CommandBuilder 3 6 Reference Manual 99 Figure 25 Remora Fader Screen showing large text Lo gitek Remora Small Font Text This command is used to write a small font text to the sens half of the Fader in Screens cmd ae surf surface text chan channel insert line pos 36 chars cmd ae surf surface text fader insert line os 36 chars Small text is displayed on the upper half of the screen as 12 lines of 36 characters This text is divided into two columns of six lines each There are two lines for each channel on the surface The first three channels are the left column the second three channels are the right column Channels 1 6 are on the first wedge 7 12 on the second and so on The command must contain the CHANNEL or FADER number and LINE1 or LINE
158. ine number Surface number and the required keyword LAMP or BUS The keyword BUTTON must NOT be used The keyword BRIDGE or SOFTKEY must be used for a Bridge Lamp or a Softkey Lamp The Destination Device can be specified using keyword DEVICE or using the d Destination Device notation gt When using a Device name number or Channel number BUS must used instead of LAMP gt One of the keywords ON or OFF is also required gt Do not use the keyword PULSE with regard to lamp commands YYY The following are examples of the Lamp commands cmd ael surfacel bridge lamp11 on cmd ae3 surfacel softkey lamp2 off See the Relay Pulse command on page 70 to pulse a relay Logitek CommandBuilder 3 6 Reference Manual 57 Lo gitek Lamp Flash Flashes a lamp with variable rate cmd ae surf surfaces bridge softkey lamp cmd ae surf surface channel bus flash continuous times cmd ae Not Used device bus flash continuous times cmd ae Not Used diDevice Name bus flash continuous times slow medium fast slow medium fast slow medium fast flash continuous times gt This command applies to the lamp in the button not the button itself gt This command must include the Audio Engine number Surface number and the required keyword LAMP or BUS The keyword FLASH is required The keyword BUTTON must NOT be used The keyword BRIDGE or SOFTKEY must be use
159. is Mic 2 off cmd ael surfl s Stl Mic 2 bus01 off PGM off cmd ael surfl s Stl Mic 2 bus03 on AX1 on endif if state ael scan surfl s Stl Mic 3 bus00 off is Mic 3 off cmd ael surfl s Stl Mic 3 bus01 off PGM off cmd ael surfl s Stl Mic 3 bus03 on AX1 on endif if state ael scan surfl s Stl Mic 4 bus00 off is Mic 4 off cmd ael surfl s Stl Mic 4 bus01 off PGM off cmd ael surfl s Stl Mic 4 bus03 on AX1 on endif if state ael scan surfl s stl Telephone 1 bus00 off is Tel 1 off cmd ael surfl s Stl Telephone 1 bus01 off PGM off cmd ael surfl s Stl Telephone 1 bus03 on AX1 on cmd ael set surfl mix 4 bus4 set MM4 to AX2 cmd ael surfl s Stl Telephone 1 text label Rtn AX2 endif if state ael scan surfl s Stl Telephone 2 bus00 off is Tel 2 off cmd ael surfl s Stl Telephone 2 bus01 off PGM off cmd ael surfl s Stl Telephone 2 bus04 on AX2 on cmd ael set surfl mix 5 bus4 set MM5 to AX2 cmd ael surfl s Stl Telephone 2 text label Rtn AX2 endif cmd store ael d Portl Monitor In route to vMonSt1MonAmp store Monitor Amp crosspoint setting cmd store ael d Portl Headphones In route to vMonStlOprHP store Opr Headphones crosspoint setting cmd store ael d Portl Studio In route to vMonSt1GstHP store Gst Headphones crosspoint setting cmd ael route s Portl Aux 2 Out to d Portl Monitor In route AX2 to Monitor cmd ael route s Portl Aux 2 Out
160. it must be placed in Question Mode using the keywords QUESTION MODE gt Placing the Question Screen in this mode clears all existing text from the Question Screen gt Text commands in Question Mode are displayed immediately when received by the surface gt Use the IF BUTTON CANCEL and IF BUTTON ACCEPT Conditional Triggers to react to the user selection gt You must use CLEAR ALL to clear the Question Screen when ACCEPT or CANCEL is pressed otherwise the screen will not clear The following is an example of placing the Question Screen into the Question Mode and then displaying several lines of text cmd ael surface2 set question mode cmd ael surface2 text question linel posl Assign Studio A to air if ael surfl button cancel delay30 cmd ael question text clear all endif Assign Studio A to Air Figure 14 Numix II Question Screen See Chapter 9 for more information on Conditional Triggers to accept or cancel Numix II Selections Screen Text The Selections Screen can be used to display a menu of options to the user Scene These can be a user defined list or a list of inputs for a router Crosspoint e g Brekky f Morning record source selector This command is available on the Numix I Numix II Arvo and Remora and therefore is documented in a separate section See Text Selection Screens at the end of this chapter for more information Logitek CommandBuilder Lo gitek
161. ith the application and commands first and then use the examples in Part C to help you develop and test Triggers to suit your needs System Integrators Value Added Resellers System Integrators and VARs should also read this manual from cover to cover In particular we encourage you to thoroughly evaluate the example Triggers in Part C as these provide comprehensive examples of how to perform complex tasks Logitek CommandBuilder 3 6 Reference Manual 18 Lo gitek System Requirements CommandBuilder is designed to run on Microsoft Windows NT based operating systems including Windows 2000 amp Windows XP The application will also run on non NT based systems such as Windows 95 98 and ME but these are not recommended due to their instability and less robust networking features Recommended PC Specification Although CommandBuilder can run under a lower specification the following is provided as the recommended minimum under new or recent hardware Processor Pentium 4 Memory 512MB System Windows NT based 2000 XP Server 2003 or newer Screen Size 1024x768 or greater High Color modes recommended Disk Space Minimal disk space required CommandBuilder does not have to be executed on your Supervisor machine It is designed to run on your local machine and upload to Supervisor over a TCP IP network Compatibility This manual is for CommandBuilder 3 designed for use with Supervisor 3 CommandBuilder 3 is a release that sup
162. ition and keep exisitng text on the line gt The text color can be specified by adding a predetermined value to the postion value White is assumed if no value is added to the postion value VV Vv Artisan Text Color values The following values are added to the postion value to give the text a specific color White Blue Green Red Cyan Magenta Yellow 50 Gray 0 16 32 48 64 80 96 112 The following are examples of small font text commands written to the Wide Softkey Screen Artisan Wide Softkey Route Select cmd ael surfacel device52 cmd ael surfacel ct ct device5l line2 posl This is Text line6 posl This command is described in full later in this chapter When using the Route Select command the selection can be written to the screen next to the relevant button using these locations Button 1 Button 2 Button 3 Button 4 Button 5 Button 6 device52 line2 pos1 device52 line6 pos1 device52 line10 pos device51 line2 pos device51 line6 pos device51 line10 pos1 Artisan Meter Bridge Screens The Artisan Wide Meter Bridge MLX WBRIDGE has six screens The Artisan Wide Bridge supports a clock a timer and text on any of the 6 LCD screens You cannot send auxiliary meter displays to the bridge in an Artisan configuration as those meters are already displayed on the Master module by default The Artisan Narrow Meter Bridge MLX BRIDGE has two screens The Artisan Narrow Bri
163. k CommandBuilder 3 6 Reference Manual Editing Triggers amp Procedures Edit E The Edit Triggers and Edit Procedures buttons open an editing screen where the respective Trigger or Procedure can be created or edited The editing interface is very similar between both Triggers and Procedures Only the Edit Triggers page is shown below the same functions are available in the Edit Procedures page In each edit window the current Trigger Table file name is displayed for reference The file name will be blank for a new table The Trigger or Procedure number and its current valid or invalid status are also displayed When making a new item a description should be entered in the Name Title box This is displayed in the list summary view and should briefly describe the function and relevant information A check box allows the Trigger or Procedure to be made active or not active Items that are unchecked not active will not be uploaded to Supervisor and therefore will not respond to events a CommandBuilder 3 6 En Na Eas LEA EA Exa Table Ea Ea En Na Eas Table LEA Table EA able to Exa Ea Ea Ea EDIT TRIGGERS Trigger Table File Name TRIGS_1C 04 txt Trigger Number 201 201 Status VALID MV Trigger Active if o e ie ae Trigger Title 450 Surface GPI 1 ON CD1 PLAY Tally HIGH AE Protocol Script Run Translation Show Translation Find Finanex J cory J cu Paste Clear trigger ae1 d Ctrl Surf1 GPI In
164. k CommandBuilder 3 6 Reference Manual EA 7 Lo gitek The Clear button completely erases everything in the text edit window The Clear button will not erase the contents of the clipboard Logitek CommandBuilder 3 6 Reference Manual 33 Lo gitek Keyboard Shortcuts The following keyboard shortcut keys can be used to assist with text editing Home Go to the beginning of the current line End Go to the end of the current line CTRL Home Go to the beginning of the current trigger CTRL End Go to the end of the current trigger ALT D Display the source and destination device lists ALT K Delete from cursor to end of line ALT L Highlight entire current line ALT V Display User Defined Variable list Del Delete next character or highlighted lines Keypad Copies current line or highlighted lines to Clipboard Keypad Cuts current line or highlighted lines to Clipboard Insert Same as Paste button CTRL C Same as Copy button CTRL X Same as Cut button CTRL V Same as Paste button PageUp Same as Prev button PageDown Same as Next button 34 Logitek CommandBuilder 3 6 Reference Manual Pare Y gt Logitek Part B Logitek Scripting Language This section of the manual covers the Logitek Scripting Language starting with an overview of the summary followed by a command reference 6 Language Overview The Logitek Scripting Language allows the user to write Triggers and action commands that contro
165. k Delay Sets a Conditional nin that will fire when a time AE la to a Talk aa if timer talk d DeviceName then gt Instead of specifying a WAIT time the If Timer can be tied to a Talk Delay to set a Timer equal to the current delay time of a Talk Delay This function is useful when you need to delay a command to match an audio delay When the Timer is set the current delay for the specified Destination Device is used If the Destination Device is not a Talk Delay device or the Talk Delay is off the wait time is set to zero and the enclosed commands execute immediately The resolution is 0 1 seconds ensuring commands match delayed audio very closely The If Timer Talk Delay requires a unique timer number Commands must appear between the IF TRIGGER and a corresponding ENDIF keyword The keyword THEN is optional VV V VVVV The following is an example of the If Timer Talk Delay Conditional Trigger if ael timer 102 talk d Portl Router 1 In then cmd port 8 MC1EVT1 endif 48 Logitek CommandBuilder 3 6 Reference Manual rots Y a gt Logitek 10 Trigger Types Schedule Event Triggers Introduction A Schedule Event Trigger is a special Trigger that responds at a user designated date and time Schedule Event Triggers can be made to be activated just once or can be repeated at a specified interval These Triggers can also be made to repeat on given days of the week General Rules gt The keyword
166. l line clear gt This command enables a large clock display on screen 1 of the Artisan Meter Bridge gt For the Artisan Meter Bridge use DEVICE53 LINE15 to set the clock gt A standard text clock can also be written to other screens if desired gt The display is continuously updated until a CLOCK CLEAR command is used gt The Clock Clear command must contain the same Audio Engine Surface line and position numbers as the original Clock command The following are examples of how to display and clear the clock cmd ael surfacel clock device53 linel5 cmd ael surfacel clock clear device53 linel5 Artisan Meter Bridge Text This command is used to write text to the Meter Bridge Screens cmd ae surf surface text device insert line pos See below 18 chars cmd ae surf surface text chan insert lines pos See below 18 chars channel gt Text is displayed on Screens 1 6 as 8 lines of 18 characters gt See page 109 for the screen addresses amp lines gt This command can also be used to set the text on the LCD display below the main meter gt The command must contain the DEVICE or FADER number and LINE number gt To clear a line write a single space string to that line without the INSERT keyword gt Use the keyword INSERT to replace only the written text and keep other text on the line gt The text color can be specified by adding a predetermined value to the postion value White is assumed i
167. l keywords and functions It is not necessary to read these chapters completely but we suggest you skim read the topic summaries and read the detail for any areas of interest Part C Trigger Applications The last section provides real world Trigger examples to help you achieve common functions quickly These include intercoms on air switching and console scenes These examples are based on the best Triggers users integrators resellers and Logitek itself has designed and implemented worldwide 12 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Which Parts to Read This manual can be read from cover to cover but not all users will need to do so System Administrators If you are a System Administrator responsible only for uploading new Trigger tables supplied by other engineers at your station Logitek or resellers then you only need to read the first few chapters of Part A stopping at the end of Chapter 4 Maintenance Engineers If you need to maintain or modify existing Trigger Tables we suggest you read all of Part A to learn your way around the entire application You can then use Part B as a reference looking up only the commands and Trigger types used by your station Part C may be of interest to get ideas for future changes or additions System Engineers If you are designing and configuring a Logitek System you ll probably want to read this manual from cover to cover We suggest you become familiar w
168. l the operation of Audio Engines These events and commands are written in the CommandBuilder program and uploaded to the Supervisor program The Audio Engine only understands its own Audio Engine Protocol This Protocol is published and available to the user if required The Logitek Scripting Language allows control of the Audio Engine using commands that are more user friendly than those of the Audio Engine Protocol itself Triggers Triggers are user defined events in the Audio Engine or control surface For example an event may be a button press or release the opening or closing of a relay or even a routing assignment When Supervisor detects the trigger event any associated action commands from a Trigger are executed There are three types of triggers General Triggers the Init Trigger and Conditional Triggers General Triggers General Triggers are Audio Engine events that Supervisor watches for at all times General Triggers can be the turning ON or OFF of a button or relay the route or unroute of an input assignment or the change in the value of a variable See Chapter 7 for more details on General Triggers Init Trigger The Init Trigger is a special Trigger that occurs each time the Supervisor program starts and whenever the user clicks the Execute Init Triggers button in Supervisor See Chapter 8 for more details on the Init Trigger Conditional Triggers A Conditional Trigger is a Trigger that responds wh
169. l2 off Off lamp off cmd ael d St731 Guest 1 H P bus20 on Tally Output on cmd ael d St731 Guest 1 H P bus21 on timer on cmd ael d St731 Guest 1 H P bus22 on timer run cmd ael d ST731 Guest 1 H P bus23 on timer reset trigger ael d St731 Guest 1 H P bus32 on PROCEDURE Guest Mic ON OFF REVISED 12th July 2005 DATA ID AE1 Port5 731 GST 22 1 Mic OFF DESCRIPTION Activate Mic if On button pressed Cancel Mic if Off button pressed NOTES DEPENDENCIES Activates Deactivates Main bus for Mic input DEBUG STATUS cmd ael s St731 Mic 2 bus0 off e Mo OEE cmd ael d St731 Guest 1 H P busl1 of On lamp off cmd ael d St731 Guest 1 H P bus12 on Off lamp on cmd ael d St731 Guest 1 H P bus20 of Tally Output off cmd ael d St731 Guest 1 H P bus23 on timer reset cmd ael d St731 Guest 1 H P bus22 of timer stop trigger ael d St731 Guest 1 H P bus31 off not required trigger ael d St731 Guest 1 H P bus32 off not required Mic Mute Functionality Description Allows the guest to mute their microphone from the guest panel The microphone input can be on any fader of a surface the command is sent to the first matching instance of the mic input on any Surface of the specified Audio Engine The mic input should be on ONE fader only If you do not wish the guest to have mic mute control either omit these Triggers or disable them in CommandBuilder You could also customize the Triggers using Variables
170. lders for major revisions of your Configurations and or Triggers this can help keep the number of files in the directory manageable and provides a rollback path when revisions do not work as intended The System Page is used to create a link between the Trigger Table and the Audio Engine Configuration files This allows CommandBuilder to reference Audio Engine resources by name rather than by Device Number The friendly name of an input or output is not only easier to read and work with but is less likely to change during configuration changes In addition Trigger programming for large networked systems is greatly aided as the same input name will almost certainly have different Device Numbers across each Engine By referencing the input by name only the Audio Engine number needs to be changed The Trigger Table is linked to the Audio Engines Network Configuration nco file This file tells CommandBuilder where to find each of the Engine Configuration aec files needed to read the inputs outputs and resources for each Audio Engine For this reason the nco aec and Trigger Table files should all be in the one directory Selecting a Network Config File The Browse button allows you to select a Network Config file name to be associated with the current Trigger Table This only needs to be entered on the System Page once The appropriate file is read at startup and whenever a different Trigger Table is loaded so recent changes i
171. ldup of delay and turns on the Surface display Ramps down to zero delay time Immediately turns off delay dumps any remaining delay and turns off the Surface display Dumps 4 seconds from the delay buffer 0 Sets the maximum delay time from 0 to 25 5 seconds in 0 1 second increments The DSP card may impose a shorter delay maximum depending on number of delays used and available memory The following are examples of the Talk Delay command cmd ael d Portl Router 1 In talk start cmd ael d Portl Router 1 In talk stop cmd ael d Portl Router 1 In talk off cmd ael d Port2 Router 1 In talk dump cmd ael d Portl Router 2 In talk max 9 9 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Execution Control These statements are used for controlling the execution of Triggers and Procedures Quit Exit B ARAN from an su further commands in the current mis cmd quit exit gt The keyword QUIT or EXIT is required gt This command is useful in Triggers that contain conditional test statements where a value has been changed earlier in the Trigger The following are examples of the Quit and Exit commands cmd quit cmd exit i EN Call Procedure Calls a Procedure from within a an or another Procedure cmd ProcedureName gt This command requires the keyword CALL followed by the name of the Procedure gt All commands in the Procedure are executed before control returns to the calling code
172. le channel or fader number in decimal notation The console channel or fader number is translated by CommandBuilder to the proper destination device number in hexadecimal You can also directly enter the hex device number if known although for code readability this is not recommended Source Devices can also be referred to using the s bracket notation the device name is enclosed in square brackets prefixed with the letter s For example a device named Host Mic could be referred to as s Host Mic in a trigger or action command Destination Devices can be referred to using the d bracket notation the device name is enclosed in square brackets prefixed with the letter d For example a device named Fader 1 could be referred to as d Fader 1 in a trigger or action command The bracket notation is not dependent on knowing device numbers and is automatically looked up by CommandBuilder when triggers are uploaded This greatly simplifies the use of Device Numbers over previous versions of CommandBuilder Pressing the Alt D key combination will display a pop up window from which Source and Destination Devices can be selected and inserted into the code using the bracket notation Logitek CommandBuilder 3 6 Reference Manual 37 Lo gitek 7 Trigger Types General Triggers Introduction General Triggers are Audio Engine or Surface events that Supervisor watches for at all times When the event occ
173. les the name must be an internally declared Supervisor System Variable gt Appending the optional keyword CHANGE to the Trigger will cause the trigger to fire only if the new value is different from the previous value gt Otherwise this Trigger is fired each time a value is assigned even if the value is unchanged gt System Variables are read only variables that can only be set by Supervisor itself The following Trigger will fire every time a value is assigned to the user variable Studio50nAirSource regardless of if that value has actually changed trigger v Studio50nAirSource The following Trigger will fire only if the new value of the variable is different from the previous value of the User Variable Studio50nAirSource trigger v Studio50nAirSourcel change The following Trigger will fire every time a new value is assigned to the System Variable SupervisorANetworkFail trigger z SupervisorANetworkFail The following Trigger will fire only if the new value of the variable is different from the previous value of the System Variable SupervisorANetworkFail trigger z SupervisorANetworkFail change See Chapter 14 for more details on using User amp System Variables Logitek CommandBuilder 3 6 Reference Manual 43 7 N Lo gitek 8 Trigger Types Init Trigger Introduction The Init Trigger is a special Trigger that is run each time that Supervisor starts and when the Execute Init Triggers button is click
174. les Post Swap mode turn off Post Swap Lamp and reset toggle see later in this chapter Send Delay Off command to Talk Delay just to be sure Route Program to Monitor Amp and Headphones Call procedure to update Mosaic monitor hotkey lamps see Chapter 18 for more info Send Delay On command to Talk Delay Call a procedure a to update lamps and text Turn on Dump lamp Update variables to track status VVVVVV WV Tally Procedure gt Turns on appropriate lamps in the studio gt Writes text to screen gt Can also be used to display status lamps elsewhere in the facility Further Information If Variable Page 147 Set Variable Page 144 Bus On Off Page 55 Set Toggle State Page 74 Talk Delay Off Start Page 72 Route Page 59 Call Procedure Page 53 VVVVVV V gt Text Chapter 13 Notes This function uses a variable to track delay status Because of this the vDelay application should not be used to activate the delay or the studio functions will not be in sync However you may choose not to use variables in which case vDelay can be used but the lamps in the studio will still be out of sync if vDelay starts or stops the delay Script Examples trigger ael surfl chan14 bus40 on Mosaic Narr Softkey Button 9 PROCEDURE Delay Start v2 0 SharcAttack REVISED 27th April 2005 DATA ID AE1 Portl StA Narr Softkey BIG9 DESCRIPTION If off send start to SharcAttack Delay If on
175. ll influence the allocation of Triggers For example the Numix II surface has a Softkey panel whereas the Remora does not The Mosaic Surface has many different button panels depending on the modules ordered Consult the relevant Surface manual for more information on available buttons Logitek CommandBuilder 3 6 Edit Read Save New Triggers Trigger Table Trigger Table TriggerT able JE System Edit Procedure Page Procedures List TRIGGER LIST Trigger Table File 4RK_TRIGS_1C 04 txt Last Trigger Total Commands 0 CT 100 Num Title Main Trigger Cmd Valid Active Count 731 450 Hor2 Softkey BIG1 OFF trigger ael surfl chan18 bus43 off NOT Trigger 732 450 Hor2 Softkey BIG2 OFF trigger ael surfl chan18 bus42 off NOT 733 450 Hor2 Softkey BIG3 OFF trigger ael surfl chan18 bus41 off NOT 734 450 Hor2 Softkey BIG4 OFF trigger ael surfl chan18 bus40 off NOT Tagger Block 735 450 Hor2 Softkey BIG5 OFF trigger ael surfl chan18 bus39 off NOT 736 450 Hor2 Softkey BIG6 OFF trigger ael surfl chan18 bus38 off NOT 737 450 Hor2 Softkey BIG OFF trigger ael surfl chan18 bus37 off NOT 738 450 Hor2 Softkey BIG8 OFF trigger ael surfl chan18 bus36 off NOT 739 450 Hor2 Softkey BIG9 OFF trigger ael surfl chan18 bus35 off NOT 740 450 Hor2 Softkey BIG10 OFF trigger ael surfl chan18 bus34 off NOT 741 450 Hor2 Softkey BIG11 OFF trigger ael surfl chan18 bus33 off NOT 742 450 Hor2 Softke
176. ll linel posl This is Text big channel6 line3 pos21 cmd ael surfacel texi cmd ael surfacel texi or 100 Logitek CommandBuilder 3 6 Reference Manual Logitek Remora Label Text This command is used to write a label to an os on the Fader i Screens cmd ae surfff surface chan channel text label 12345678 cmd ae surf surface fader text label 12345678 gt The label is large font text displayed in a label space directly above the fader information gt This label may have a maximum of 8 characters gt The channel label text lines must contain the CHANNEL number on the Fader Wedge and the keyword LABEL The LINE or POS keywords are not required for this type of text To clear the label write a blank string of 8 characters The label may be replaced by flashing text PENDING if a WHEN OFF command is used The label is replaced if a SET ALIAS command is issued to the source device on that fader The label is cleared when a route is performed on that fader To center a label you must manually pad the text string with spaces VVVVV V The following are examples of channel label text commands written to the Fader Wedge cmd ael surfacel channell text label Active cmd ael surfacel channel6 text label A LOC NEWS E E Trim 806 33 Trim 0dB E E Pe Network Edit 2 Studio Figure 20 Remora Fader Screen showing label amp
177. long with the keywords TALK TIME The Destination Device may be in DEVICE d Destination Device or SURF CHAN notation The delay time in tenth of seconds is multiplied by ten delay time 1 1 seconds 11 The following is an example of setting the value of User Variables from a Talk Delay time cmd set vStudio5SDelayTime ael d Portl Delay CP1 In talk time Route Variables A User Variable can also be used to store and recall a Source Device route This function is useful for copying Source Devices from one Destination Device to another It can be combined with a TRIGGER ROUTE ANY to copy a route to a User Variable and other devices Route Store This command is used to store a current route to User Variable cmd store route ae surf surface chan channel to vVariableName cmd store route ae surf surface fader to vVariableName cmd store route ae Not Used device to vVariableName cmd store route ae Not Used d DeviceName to vVariableName gt The Source Device number is saved in the variable using the keywords CMD STORE ROUTE followed by the Audio Engine number and destination then the User Variable name using the vMyVariableName notation gt The parenthesis and the keyword TO are optional Route Recall This command is used to recall a route value from a User Variable cmd store route ae surf surface chan channel to
178. ly label to fader cmd ael d Ctrl Surfl GPI Out bus86 on mute lamp on endif trigger ael d Ctrl Surfl GPI In bus86 off Mosaic Wide Softkey Misc Button 2 PROCEDURE Cough Mute REVISED 22nd February 2005 DATA ID AE1 Surfl StA Mic 1 Mute OFF DESCRIPTION Activate Mic Mute if Mute button pressed Cancel Mic Mute if Mute button released NOTES DEPENDENCIES Activates Deactivates Mute bus for Mic input DEBUG STATUS N SSS SSS SSS SS SSS SSS SSS SS SS SS SS SS SS SS SSS SSS SS SSS SSS SS SS SS SS SS SS SSS SSS SSS SSE cmd ael s StA Mic 1 bus8 off cough mute off cmd ael s StA Mic 1 text label tally label to fader cmd ael d Ctrl Surfl GPI Out bus86 off mute lamp off 12 x 1 Router Functionality Description This function uses a group of buttons to control a destination output making the panel a 12x1 router It could easily be adapted to any other number of buttons e g to make the bottom row of a COM72 panel a 6x1 router Components This function uses an On Trigger when the button is pressed to execute the command A Procedure is used to turn all lamps in the group off rather than repeat that code for each button This makes it easier to change the buttons in the group in the future Button On Trigger gt Call procedure to turn OFF all lamps in group gt Turn appropriate lamp ON gt Route audio Procedure gt Turn OFF all lamps in group Fu
179. md ae Not Used d Device Name set level 0 to 255 INFINITY to 10dB OFF INF cmd ae Not Used device set level O to 255 INFINITY to 10dB OFF INF gt This command must include the Audio Engine number Surface number the fader or destination device number and the required keyword LEVEL gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation gt The Fader Level value may be expressed in dB or in internal Audio Engine units 0 255 gt Avalue of 195 is equal to unity gain or O dB gt The keyword dB is required for levels expressed in dB units gt The allowable range of levels in dB is INFINITY off to 10 dB gt The keywords INF or OFF may be used to set the fader level to infinity The following are examples of the Set Fader Level command cmd ael surfacel set fader2 level 195 cmd ae2 surface2 channel6 level 10 db cmd ae3 set d Portl Fader4 In level 0 db cmd ael d Portl Fader2 In level off Logitek CommandBuilder 3 6 Reference Manual 61 f Lo gitek Set Fader Mode Sets the Fader mode of a an fader or Destination Device Same as a mode on surface cmd ae surf surface chan channel cmd ae surf surface faderst cmd ae Not Used cmd ae Not Used set mode STEREO MONO PHASE LL RR Lx xR set mode STER
180. mpsOff Edl tally off destination lamps if timerl wait4 7 cmd ae2 surfl bridge lamp01 off turn off source lamp after delay endif cmd notactive trigger ael d Ctrl Surfl GPI In bus88 off set off trigger not active again procedure IcomDestLampsOn_StA N SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS PROCEDURE Intercom Destination Lamps on off REVISED 17th February 2005 DATA ID ABC Renmark Studio A StA DESCRIPTION Turns intercom destination lamps on or off at all stations NOTES DEPENDENCIES Commented lines not used but included for possible future use DEBUG STATUS N SSS SSS SS SS SS SS SSS SSS SSS SS SS SS SS SS SS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS cmd ael d Ctrl Surfl GPI Out bus on Dest Lamp ON at stn Studio A Not used cmd ae2 surfl bridge lamp01 on stn Edit 1 Bridge Lamp 1 cmd ae2 surf2 bridge lamp01 on stn Edit 2 Bridge Lamp 1 cmd ae2 d ER Intercom Send bus31 on stn Equip Room COM 12 Lamp 1 2 ju oO a a kE Q Z w a 2 y un y 3 2 w x ju oO a EE E O Z w C procedure IcomDestLampsOff StA N SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS lfl PROCEDURE Intercom Destination Lamps on off REVISED 17th February 2005 DATA ID ABC Renmark Studio A StA DESCRIPTION Turns in
181. n configurations will be reflected The Network Config file name must be chosen before source and destination device names can be used Once an appropriate Network Config file has been selected the list of Source Devices and Destination Devices will be populated for each Audio Engine You can browse the lists for each Engine using the Audio Engine Number scrollbars In addition the Network AE List section will show the Configuration files for each Audio Engine in your system Logitek CommandBuilder 3 6 Reference Manual 25 f Lo gitek User Variables The System Page is also used to declare the names of variables used in the Trigger Table A variable must be declared on this page before you can use it You will receive an error when you translate a Trigger or try to upload the table if a variable has been used but not declared To enter a new variable name or edit an existing variable double click the appropriate cell in the list You can also use the up and down arrows to navigate the list the F2 key to edit a name and enter to accept Using variables in Triggers is covered in later Language Reference chapters TIP User Variables are prefixed with a small v when they are referenced in a Trigger or Procedure Do not enter the v when naming variables on the System Page Logitek CommandBuilder 3 6
182. n is often used to present a list of choices of which one can be selected by pressing the corresponding selection button gt Only lines 2 13 have selection buttons The first line is usually used to display a title only gt The text command must contain the keyword FUNCTION gt Before text can be written to the Function Screen it must be placed in the Radio mode using the keywords FUNCTION RADIO MODE The following is an example of placing the Function Screen into the Radio mode and then displaying several lines of text cmd ael surfacel function radio mode cmd ael surfacel text function line 1 pos 1 On air cmd ael surfacel text function line 2 pos 1 Phone 1 cmd ael surfacel text function line 3 pos 1 Phone 2 cmd ael surfacel text function line 4 pos 1 Phone 3 See Chapter 9 for more information on Conditional Triggers for button presses Logitek CommandBuilder 3 6 Reference Manual 79 f Lo gitek Numix I Selections Screen Text These commands are used to write text selections to the Numix I Selections Screen cmd cmd ae surf surface selection list mode message mode ae surf surface text selection linex 1 12 os 1 6 123456 cmd Yv Y v VVVVV ae surf surface text selection line 1 6 pos 1 12345678901 2345678901 21 The Selections Screen displays text in one of two modes List Mode displays two columns of six lines eac
183. n lamp 1 on endi if state ael route s Portl Aux 1 Out to d Portl Monitor In then Hotkey Source 2 is selected cmd ael d Portl Monitor In bus17 on Turn lamp 2 on endif if state ael route s Port3 CP1 TXA Stereo to d Portl Monitor In then Hotkey Source 3 is selected cmd ael d Portl Monitor In bus18 on Turn lamp 3 on endif if state ael route s 5MV 1062 Rx to d Portl Monitor In then Hotkey Source 4 is selected cmd ael d Portl Monitor In bus19 on Turn lamp 4 on endif if state ael route s Portl Delay CP1 Out to d Portl Monitor In then Hotkey Source 5 is selected cmd ael d Portl Monitor In bus20 on Turn lamp 5 on endif 19 Delay Control Examples CommandBuilder can be used to build sophisticated delay control logic to assist operators get in and out of delay The examples in this chapter us the Logitek SharcAttack internal delay however could be easily adapted to external profanity delay units using GPI control There are many different ways to enter and exit delay These examples show methods that have been used at different stations around the world Delay Start Functionality Description This function starts the internal Talk Delay Components The Delay Start button has an On Trigger which performs these tasks plus a Procedure to update display tallies Button On Trigger gt Check the value of a variable if 0 then continue This prevents going into delay again gt Disab
184. nal Trigger previously set using the If Button statement cmd clear button TriggerDefinition TriggerDefinition gt The required keywords are CLEAR and BUTTON followed by the definition of the Conditional Trigger gt The optional parenthesis around the Conditional Trigger increases user readability gt Itis notan error to clear a Conditional Trigger that has not been set The following are examples of the Clear Button command cmd clear bu cmd clear bu ton ae3 surfacel softkey button3 on ton ae2 surface2 bridge button6 off ETET Clear Trigger Clear a Conditional Trigger previously set using the If Trigger statement cmd clear trigger TriggerDefinition TriggerDefinition gt The required keywords are CLEAR and TRIGGER followed by the definition of the Conditional Trigger gt The optional parenthesis around the Conditional Trigger increases user readability gt Itis notan error to clear a Conditional Trigger that has not been set The following are examples of the Clear Trigger command cmd clear trigger ae3 surfacel d Portl Fader 3 In on cmd clear trigger ae2 surface2 route device 0102 to channel3 See Chapter 9 for more information on Conditional Triggers Logitek CommandBuilder 3 6 Reference Manual 75 AS Lo gitek Clear When Off Clears a commands that were stored s a ac When Off statement cmd clear when off ae surf f surfaces chan
185. ne number Surface number Source Device number Destination Device number and the required keyword UNROUTE The Source Device can be specified using keyword DEVICE or using the s Source Device notation The Destination Device can be specified by using the keywords FADER or CHANNEL or using the d Destination Device notation Device number is not supported The use of the FROM keyword is optional If no Source Device is specified the Trigger will fire whenever any source is replaced on the specified Destination Device If no Destination Device is specified the Trigger will fire whenever the specified source is replaced on any Destination Device The optional keyword ANY can be used to improve the readability in these scenarios The following are examples of an Unroute Trigger trigger ae2 surfacel unroute device 0105 channel4 trigger ae8 unroute s Port2 Aux 1 out from d Port2 Fader 3 In trigger ael surfacel chan25 unroute any Logitek CommandBuilder 3 6 Reference Manual Lo gitek Variable Change Trigger Fired when a value is ea to a User or dam Variable trigger v UserVariable z SystemVariable change trigger v UserVariable z SystemVariable change gt This Trigger must contain the name of a User Variable using the v UserVariableName notation or a System Variable using the z SystemVariableName notation gt For User Variables the name must be declared in the System Page gt For System Variab
186. ne of the example cmd ael vFaderlRoute set route selection mode d Portl Fader 1 In display device27 screen 3 14 Additional Surface Commands Introduction Some Logitek Surfaces have additional features to enhance the operation and usability This section details Surface specific feature commands Artisan Mosaic Features The Artisan and Mosaic consoles are fitted with a variety of different button lamps All programmable Softkey buttons support 16 brightness levels which can be used to give the operator further feedback for example an Intercom lamp may glow brightly when the station is calling but dimly when it is in use from another studio The on amp off lamps in the faders no off button for the Artisan can be changed to many different colors using an RGB color value This can be used to denote ready or EOM states on a particular source or the main microphone color could be changed to make it easy to find In addition all lamps support a three speed flash which can be used to denote different events o rr Figure 40 Mosaic Surface Artisan Set Channel Color Sets the color of an Artisan Channel On lamp cmd ae surf chan channel chon set color RGB000015 slow medium fast surface fader artisan tally cmd ae surf s Device Name chon set color RGB001500 slow medium fast surfaces artisan tally cmd aer Not Used device chon set color RGB000015 slow
187. nes Toggle State 2 exit Quick Record gt gt gt gt gt Turn off the Quick Record button lamp Check if Mic 1 4 PGM is Off If Off turn on PGM bus and turn off AX1 bus turn off channel Check if Tel 1 PGM is Off If Off turn on PGM bus turn off its AX1 bus turn off channel set mix minus to PGM label the Tel 1 fader to show the return path Repeat previous step for Tel 2 Recall the previous Monitor Operator and Guest Headphone routes from their variables Further Information VVVV WV If Toggle Page 39 Bus On Off Page 55 If State Scan Page 150 Set Fader Label Page 61 Device Store Recall Page 144 Script Examples trigger ael surfl chan14 bus35 on toggle lt put your required button here PROCEDURE Remote record with tally REVISED 18th May 2005 2 DATA ID Quick Record ON DESCRIPTION Puts mics and tel on to AX1 ON AX1 OFF Change Tel mix minus to AX1 Monitoring to AX1 NOTES DEPENDENCIES Toggle function all changes reversed on toggle Faders on PGM are not touched DEBUG STATUS N M if toggle 1 cmd ael bridge lamp05 flash continuous lamp tally on if state ael scan surfl s Stl Mic 1 bus00 off is Mic 1 off cmd ael surfl s Stl Mic 1 bus01 off PGM off cmd ael surfl s Stl Mic 1 bus03 on AX1 on endif if state ael scan surfl s Stl Mic 2 bus00 off
188. ng In the command below the b character makes the message hold on screen The 2 preceding the text sets the font size These characters can be substituted to provide other effects cmd port2 lt nul gt lt nul gt lt nul gt lt nul gt lt nul gt lt soh gt Z00 lt stx gt A0 lt esc gt b lt sub gt 90n Air lt eot gt Command _ Name Command Roll Down Previous Message is pushed down by a new message Roll Left Previous Message is pushed left by a new message Wipe Up New message wipes over old from bottom to top Wipe Down New message wipes over old from top to bottom Wipe Left New message wipes over old from leftto right k Seven Shadow Fancy Wipe Right New message wipes over old from right to et Few CAutomode Sign picks modes at random To Seven Wide f Seven Fancy Wide Wide Stroke Fe gt a b c Roll Up Previous Message is pushed up by a new message e f 8 h i 7 2 3 4 5 6 7 8 9 Wide Stroke Seven Fancy Contact BetaBrite for further information on the sign protocol Script Examples trigger ael device01 bus01 on AE1 GPI Input 1 PROCEDURE BetaBrite Message REVISED 14th June 2005 DATA ID AE1 GPI 1 ON DESCRIPTION Sends clears message text to Beta Brite sign on COM2 NOTES DEPENDENCIES COM port must be active in Supervisor as AUX port DEBUG STATUS N aa r SSH SHSSSHSSSHSHSSSS
189. ng either the remote control or the supplied PC software It s best to not overwhelm the operators with text and flashy displays so it will be more obvious to the operator when an alarm condition exists We suggest setting one message with the time of day only or a single period mark set to Hold This will give you a static display that lets you know the sign is turned on Once that is stored in the BetaBrite connect it to the available RS 232 port on your Supervisor computer A Current BetaBrite signs that are commonly available use USB instead of serial BetaBrite signs using the older serial protocol are still available as the BetaBrite Classic although they are difficult to find Configuring Supervisor To configure Supervisor to support the external device 1 Click on the Com Port Control tab 2 Look in the Auxiliary Ports box In the Lowest Aux Ports box put the port number the sign is connected to In the Number of Aux Ports box put 1 3 In the grid inside the Auxiliary Ports box you will now see the new Aux port and it will be highlighted in blue Right click on this line You will now be able to set the port s parameters You must set the port as follows to communicate with the BetaBrite Baud Rate 9600 Data Bits 7 Stop Bits 2 Parity Even 4 Click Accept once you have set the parameters and then check the Aux Ports Active box 5 Close and re open Supervisor to open the required Com Ports For more inform
190. ng up Trigger events that will occur within or after a specified delay time TIP Itis easy to confuse General and Conditional Triggers General Triggers are defined as an action that will run each and every time a specified event occurs General Triggers are declared as the first line of a Trigger Conditional Triggers are declared on the fly inside General Triggers These can be set to run upon a particular event occurring but can be later cancelled so they no longer occur General Rules gt Conditional Triggers are declared inside General Triggers gt There can only be one Conditional Trigger for a particular event e g timer number setting the same event Conditional Trigger a second time will replace the first set of commands Declaring Conditional Triggers A Conditional Trigger is declared inside a General Trigger using one of the three Conditional Trigger types detailed below A Conditional Trigger cannot be declared on its own The Conditional Trigger IF statement must have a corresponding ENDIF Conditional Trigger Types There are three types of Conditional Triggers as follows Type Description Example Scenarios IF TRIGGER Declares a Trigger on the fly which can later be A Trigger needs to set temporarily or the replaced or cancelled actions of a Trigger changed depending on circumstances IF BUTTON Similar to IF TRIGGER but uses button keywords and can Setup an event to occur if the ACCEPT or IF
191. ngines or to Supervisor that are executed when their Trigger event or Procedure occurs Action Commands make the things happen that we want to occur in an event These commands can be entered in both Triggers and in Procedures and follow the Trigger or Procedure definition See Chapter 12 for more details on Action Commands General Syntax All Triggers event declarations and Action Commands must be completed on one line Triggers and action commands can not be continued on a second or subsequent line The tilde character is used to denote the beginning of documentation comment All words to the right of the tilde character are ignored Thus if the first character in a line is the tilde character the entire line is considered a comment The tilde character may be used to temporarily comment out certain lines for testing These lines can then be restored to service by removing the tilde character saving you from re typing the entire line The tilde character is not allowed on the first line of a Trigger or Procedure This line is reserved for the definition of the Trigger event or the Procedure name All comments are stored in the Trigger Table and are available for future reference A documentation banner near the beginning of a Trigger or Procedure with further descriptions throughout the command listing is considered good practice 36 Logitek CommandBuilder 3 6 Reference Manual Lo gitek The scripting language decodes the ke
192. noos 132 Route Select TeXb oooocooococonocconoonncccoconcnnnnoos 134 Route MO tassisin 145 Route IMP 41 Schedule Event Tere ondaa 49 SEU D vice Allande 60 Set Fader COMPpression csi cscsiesessiancvactdoanets 66 Set Fader EQUAIZALOM isssstsssesncnsaisnnnsedssontss 67 Set Fader LEVEL adan 61 Set Fader Lie as 65 Set Fader Mode canas 62 Set Fader A 64 Logitek CommandBuilder 3 6 Reference Manual 9 so Logitek SEL Fader aa 63 Text to UDP Pot 69 S t Mix MINUS pa 68 Unro te TBO CN crac tii 42 Set Toggle sl 74 Variable Change These 43 Set Trigger Active Not Active 74 Variable Select If ACCept ooooooonnnccnnnniccnnn 128 Set Variable 144 Variable Select If Cancel 130 Set Variable Talk Time asrnransjnaes 144 Variable Select Set Mode oooooooccccocccoccncnnn 128 O PP arene eee tear ert es 72 Variable Select TEX aciesnnusiuaresncesonedunnsinasens 128 Text to Com Potes ini 70 Wheh Officiis s 152 10 Logitek CommandBuilder 3 6 Reference Manual ES Logitek Part A Using CommandBuilder This section provides an overview of the CommandBuilder program and how to use it to design create load save and upload Logitek Trigger Tables 1 Introduction About this Manual This manual describes the installation and operation of the Logitek CommandBuilder application Intended Audience This manual is almed at Engineers and Technical Operators responsible for installing configuring and supporting a Logitek Console Router Syst
193. nt Engine or Surface e g Audio Engine GP ONs at 101 then Audio Engine GPI OFFs at 121 This layout and spacing makes it very easy to find related Triggers Example Stub Triggers Allocation Following is a suggested Trigger layout for a system with one Audio Engine and one Surface with a Button Wedge 01 Site Information documentation no active code 02 Summary of Triggers documentation no active code 03 Summary of Timers documentation no active code 04 Init Trigger 11 100 Audio Engine Triggers if used 101 115 Audio Engine GPI On Triggers 121 135 Audio Engine GPI Off Triggers repeat this sequence for each Audio Engine 201 212 Surface GPI On Triggers use 201 225 for Mosaic 221 232 Surface GPI Off Triggers use 231 255 for Mosaic repeat this sequence for each Surface 301 312 Surface Bridge Button On Triggers 321 332 Surface Bridge Button Off Triggers repeat this sequence for each Surface 401 412 Surface Softkey Button On Triggers 421 432 Surface Softkey Button Off Triggers repeat this sequence for each Surface 501 524 Surface Button Wedge On Triggers 531 554 Surface Button Wedge Off Triggers repeat this sequence for each Surface Button Wedge 601 Miscellaneous Triggers e g fader input route etc Each block should be adjusted to the next available block of one hundred where more Audio Engines and Surfaces are required Different Surfaces have different buttons and wi
194. ntains commands to be executed when Cancel is pressed This is required even if there are no commands to be executed when Cancel is pressed The keywords IF CANCEL are required The keyword THEN is optional The Audio Engine and Surface numbers are not required and are assumed to be those specified in the SET SELECTION MODE command The commands to be executed must contain the required Audio Engine and Surface The commands to be executed must be followed by the required ENDIF line The statement contains an internal timer that will execute the specified commands when it expires The delay time is set using the keyword DELAY followed by the number of seconds The IF CANCEL automatically sets its timer to 60 seconds if no time is specified When the Cancel button is pressed or the internal timer expires the value of the User Variable is not changed and the Selection Mode display on the surface is cleared The following is a complete example of the Route Select function cmd ael surfacel bridge lamp 3 on cmd ael numix2 vFaderlRoute set route selection mode d Portl Fader 1 In cmd text route selection title Fader 1 if accept selection cmd ael surfacel bridge lamp 3 off cmd ael surfacel d Port 1 Fader 1 In bus 0 on endif if cancel delay 30 then cmd ael surface 1 bridge lamp 3 off endif If using a ROC select panel summer 2013 or later or Mosaic second generation summer 2013 or later substitute this line for the second li
195. o help you achieve more complex tasks These examples are based on some of the best Trigger applications used at Logitek sites around the world 17 Trigger Layout The layout of Triggers is entirely up to the user and does not affect the way Supervisor operates However a logical layout will greatly aid future maintenance and additions to the table The recommended layout is to allocate a stub Trigger for every possible Trigger Event and then code against the Triggers that are to be used This makes it easy to find Triggers in the list and see which buttons GPls and other events are allocated In addition this layout also makes it easy to add Triggers in place in the future A stub Trigger is essentially a placeholder It contains the Trigger definition and description without any code It is left Not Active until code is added If required Logitek can supply example Trigger files to assist with your file layout and design Allocating Stub Triggers We suggest allocating blocks of Triggers for related Trigger Events The following blocks are suggested Summary documentation amp Init Triggers Audio Engine GPls Surface GPls Surface Bridge Buttons Surface Softkey Buttons Surface Button Wedge Buttons Surface Miscellaneous Triggers VVVVVV V For maximum readability each block should start at the next hundred e g 101 201 etc Within each block allocate the ON and OFF Triggers for each releva
196. om route when that particular station set it in the first place This prevents another station accidentally killing a conversation that is already in place Button On Trigger press gt Check lockout variable to ensure it is equal to zero destination not currently in use gt Cancel the timer that the destination Off Trigger sets restart when the button is released gt Cancel the timer that the destination sets for this source prevents the lamp being turned off when this studio replies Set the Off Trigger Active ensures the off only happens after the on successfully executes Route the source Mic to the Talkback Return at the destination Call Procedure to turn Talk Return audio on Call Procedure to turn on all lamps for that destination so all surfaces see it is in use Set the calling station lamp to flash at destination VVVV WV Button Off Trigger release Call Procedure to turn Talk Return audio off Call Procedure to turn off all lamps for that destination so all surfaces see it is free Set appropriate timer with 4 seconds delay This timer will turn off the flashing source lamp when the time expires Disable this Off Trigger so it won t run until the next On Trigger enables it VVVV WV Lamps On Procedures one per destination station gt Turn ON that destination lamp at each station except itself where there is no button gt For consistency and code copying we have kept the self to self line but comment
197. ommands gt The displayed selection list text is also user defined gt The Select Knob is used to move the highlight bar to the desired line and then the Accept button is pressed to make that selection gt The Cancel button can be pressed to exit Selection Mode without making a selection The examples for the individual Variable Select commands follow the command descriptions Figure 38 Variable Select menu Remora shown Variable Select Set Mode This command is used to set the Variable Select mode on a surface cmd ae surf surface numix1 numix2 remora vUserVariabl set selection mode artisan mosaic e gt This command sets the surface display to Selection Mode gt The Audio Engine number Surface number and type and the keywords SELECTION MODE are required gt The surface must be NUMIX1 NUMIX2 REMORA ARTISAN or MOSAIC gt If no surface type is given then NUMIX1 is assumed gt The keyword SET is optional gt The selection value is saved in the User Variable specified with vUserVariable notation gt The User Variable is required and must be uniquely assigned The User Variable cannot be used by another Variable Select or Route Select Trigger or unpredictable results will occur gt An IF CANCEL statement is required gt When using a ROC 2013 or newer console or Mosaic second generation released summer 2013 console substitute the display keyword for the surface numix1 numix
198. p A3 assignments unchanged turned on LLISTAR update update update update update update update update update update update update update l cmd ae1 route s Off Air Receiver 1 to d Port1 Studio In cmd ae1 route s Off Air Receiver 1 to d Port1 Monitor In cmd ae1 route s Off Air Receiver 1 to d Port1 Headphones In NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 NW24 Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp Lamp ONNEN 10 15 16 17 REVISE 27th March 2009 Guest H P Off Air Annoucer HZP Off Air Monitor Off Air clear when pending Faders 1 to 18 m i Revision 3 6 1 May 2013 Logitek Electronic Systems Inc 5622 Edgemoor Drive Houston Texas 77081 USA Tel 1 713 664 4470 Fax 1 713 664 4479 Email support logitekaudio com Web www logitekaudio com Contents O 2013 Logitek Electronic Systems Inc Notice Every effort has been made to supply complete and accurate information However Logitek Electronic Systems Inc assumes no responsibility for its use nor any infringement of patents or other rights of third parties which would result Worldwide rights reserved Except for your own personal use no part of this publication may be stored in a retrieval system transmitted or reproduced in any way including but not limited to photocopy photograph magnetic or other record without the p
199. ports both 8 character and 16 character Audio Engine configuration files It also contains some updates and bug fixes from previous versions A compatible version of Supervisor 3 is required CommandBuilder and Supervisor are inter related when it comes to Trigger compilation The version of both applications should be the same and the build dates should also match This is because the compiled Trigger Table file format must match between both applications 14 Logitek CommandBuilder 3 6 Reference Manual Po Logitek 2 Trigger Concepts You can use Supervisor without making use of any of the Trigger functionality of CommandBuilder However most recent Logitek installations now make use of Triggers in some way If you have any button panels on your surfaces you will almost certainly need CommandBuilder to program those buttons Numix II Remora Artisan and Mosaic surfaces all include programmable buttons in their basic configurations Additional panels may be added if more buttons are needed CommandBuilder do I need it If you want to make use of the advanced macro programming functionality offered by Supervisor you will need CommandBuilder There are two primary uses for the application Developing Triggers and Procedures Depending on your situation you may be developing triggers and procedures or using a third party such as Logitek a reseller or a systems integrator CommandBuilder is used to develop Triggers and Proce
200. ps ON IFB REM1 IcomDestLampsOn_IFB_REM1 8 13 Cut 14 Procedure Block 15 16 Paste 17 Procedure Block 18 19 20 21 Intercom Dest Lamps OFF Studio 450 IcomDestLampsOff_450 8 22 Intercom Dest Lamps OFF Studio 451 IcomDestLampsOff_451 8 23 Intercom Dest Lamps OFF Edit 1 IcomDestLampsOff_Ed1 8 24 Intercom Dest Lamps OFF Edit 2 IcomDestLampsOff_Ed2 Procedure List 25 Intercom Dest Lamps OFF TYE IcomDestLampsOff_TVE E 26 Intercom Dest Lamps OFF PA1 IcomDestLampsOff_PA1 8 27 Intercom Dest Lamps OFF WS2 IcomDestLampsOff_WS2 8 28 Intercom Dest Lamps OFF CER IcomDestLampsOff_CER 9 Figure 8 CommandBuilder Procedure List page Insert New Trigger Procedure This function will insert a new Trigger or Procedure directly above or below the line that is selected If you wish to enter a Trigger or Procedure against a blank line you do not need to use the Insert function you can just double click the line you wish to use Selecting a block of Triggers or Procedures To select a block of Triggers or Procedures click on the desired first Trigger or Procedure and drag to the desired last item in the list Alternatively you can click the first item then shift click the last item to select the desired block This allows you to scroll through the item list to select a large block A highlighted block can be cut copied or pasted using the buttons described below Logitek CommandBuilder 3 6 Reference Manual 29
201. re information on hex commands The following is an example of the Assembly command cmd ael asm 02 03 b2 Ob 03 Logitek CommandBuilder 3 6 Reference Manual 71 Lo gitek Other Functions This section covers some useful commands not listed in previous sections Talk Delay Controls the Audio Engine Talk Delay when using SharcAttack DSP cards cmd cmd cmd gt gt gt chan channel talk start stop off dump max d Device Name talk start stop off dump max device talk start stop off dump max ae surf surface ae Not Used ae Not Used This command must include the Audio Engine number Surface number Destination Device and required keyword TALK One of the following commands is required START STOP OFF DUMP or MAX seconds The value following MAX must be between O and 25 5 seconds in increments of 0 1 seconds An error will occur if the value is omitted or outside this range The Destination Device can be specified by using the keyword CHANNEL or by using the d Destination Device notation The Destination Device is usually d Port1 Router 1 In ord Port2 Router 1 In but some configurations are set for multiple delays on Port 1 and Port 2 The Surface display for the Talk Delay is linked to the Router 1 Crosspoint on Port 1 amp 2 The following commands can be sent to the Talk Delay START STOP OFF DUMP MAX 0 Begins bui
202. reshold ratio attack release cmd ae Not Used d Device Name set compression threshold ratio attack release cmd ae Not Used device set compression threshold ratio attack release gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword COMPRESSION gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation gt This command can change one or more of the compressor parameters by using the appropriate keywords THRESHOLD RATIO ATTACK or RELEASE gt Any parameters omitted are not changed The following are examples of the Set Fader Compression command cmd ael surfacel channel2 set compression threshold 8 attack 10 cmd ae2 d Portl Fader6 In set compression threshold 10 ratio 4 cmd ae3 surface2 fader2 set compression ratio 6 release 1500 TIP To programmatically turn the limiter compressor dynamics on or off send the appropriate bus on off command to BUS22 of the appropriate destination There is no separate Command Builder command to achieve this 66 Logitek CommandBuilder 3 6 Reference Manual Lo gitek Set Fader Equalization Sets the ar a ofa dan fader or Destination Device Same as surface controls cmd ae surf
203. rge color screen with three functional areas where text commands can be displayed These are the Selections Screen bottom right the Softkeys Screen bottom left and the Question Screen not shown In addition the Numix II supports a delay status display top right which is turned on automatically when using the appropriate Talk Delay on a SharcAttack card Each of these screens has different capabilities and requires a different style of text commands detailed on the following pages Fader 10 Hish Mid Fres Hish Mid Gain Hish nia Bandi a rrr Low Frea Low Gain 100 100 0 Ratio Coneress Gain Release Tine Y I J0 0 el 100 out a Scale 10 RADIO 2 STUDIO DELEGATION MST LOCIPATH Sti s09 1510 1 1911 1912 a EJE STUDIOS MST sti Logitek CommandBuilder 3 6 Reference Manual Figure 13 Numix II Selector Screen showing all screens Lo gitek Numix Il Question Screen Text These commands are used to write text to the Numix II Question Screen cmd ae surf surface set question mode cmd ae surf f surface text question linez 1 2 pos 1 29 characters 29 cmd ae surf surface text question clear all gt The Question Screen will display 2 lines of 29 characters each gt This screen is used to ask a question answered with the ACCEPT or CANCEL buttons gt Before text can be written to the Question Screen
204. riable if 1 then continue This prevents exiting delay again gt Calla procedure a to update lamps and text gt Update variables to track status gt Send Delay Exit command to Talk Delay Tally Procedures gt Turns on appropriate lamps in the studio gt Writes text to screen gt Can also be used to display status lamps elsewhere in the facility Further Information gt If Variable Page 147 gt Call Procedure Page 53 gt Talk Delay Off Page 72 Script Examples trigger ael surfl chan14 bus41 on Mosaic Narr Softkey Button 10 A N gt SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Delay Ramp Down v2 0 SharcAttack REVISED 27th April 2005 DATA ID AE1 Portl StA Narrow Softkey Big Button 10 DESCRIPTION Switches delay into ramp down and update tallies NOTES DEPENDENCIES Variable status determines whether we are in delay or not DEBUG STATUS if vDelayStAOn 1 we are on delay at the moment call DelayTally StA Off update lamps and text cmd set vDelayStAOn 2 update variable cmd set vDelayStASafe 0 update variable cmd ael d Portl Delay CP1 In talk stop force ramp down to exit delay PGM endif procedure DelayTally StA Off N gt SS SSS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSE PROCEDURE Del
205. rior agreement and written permission of Logitek Electronic Systems Inc Logitek is a trademark of Logitek Electronic Systems Inc All other trademarks acknowledged All specifications are subject to change without notice Logitek CommandBuilder 3 6 Reference Manual 3 Document Revisions May 2009 Ben Hietbrink First release of CommandBuilder 3 5 manual August 2009 Ben Hietbrink First release of CommandBuilder 3 6 manual May 2013 Addition of commands to support second generation Mosaic and ROC consoles 4 Logitek CommandBuilder 3 6 Reference Manual Contents Document REVON AAA AAA 4 Contents _5 Comand WOU pciiini aaia 9 Part A Using CA 11 E AAAA 11 Anou A a A eats 11 How to Use O AA AERE EEEE REE 12 A A Ta PET FET ERT EO ENU RE AOAIT TaT 13 TEA OU A AA AA AA E a aa aa 14 2 TIRE ContepiS is 15 CommandBuilder do I need ci rr 15 What are TOS and PAC a i 15 Logitek CommandBuilder 3 6 Reference Manual 5 TLPR OCCU iia sacs ec anceps gee dale dada eed ea end eemeanoed 51 PM OR AO ARA NAAA ARTO AT TAN 51 Gte iia 5i Tecaro a ea ates td atl is 51 O A TO OO 52 Whtne e is 52 AA a a 53 12 Action A a 54 A LEU ACLS 3 RRS ee ea a Oe Fae RTE one ede ere Sc ESR ea Re re een nee Rae ee ee eee 54 On OF amp Hash Commands daa 55 aa o A 59 a Mr AR 69 Other Funci ns O ta tage ea once O 72 ii dd dsd Za 13 Surace Ted Commands cevenau aa 77 a AO AAA SA Z7 LO O E RENEE A TS A AE
206. rks for you Logitek CommandBuilder 3 6 Reference Manual 21 Lo gitek Upload Table to Supervisor Upload Trigger Table Upload Table Trigger Tables must be uploaded to Supervisor to be put into to Supervisor use on your Logitek System You do not need to be familiar with Trigger programming to upload to Supervisor In many cases Triggers may be supplied by Logitek a value added reseller or a systems integrator and uploaded by the on site system administrator The upload process The Upload Table to Supervisor screen contains three basic functions as follows 1 Connects to Supervisor via the IP network 2 Checks all active Triggers and Procedures for errors and compiles them 3 Uploads the compiled Trigger Table to Supervisor The checking of the current Trigger Table for errors may be performed at any time even if CommandBuilder is not connected to Supervisor Before you upload In order to upload the Trigger Table CommandBuilder must be connected to Supervisor via the IP network Data fields on the right side of the System Page must be filled in correctly In the Supervisor Primary box either the IP Address or Computer Name must be entered as it appears in the System Administrator screen in the Primary Supervisor The Server Port number must also contain the Server Port number found on the same System Administrator screen The default Server Port number is 10200 In the User Profile screen in the Primary Supervi
207. rs and Procedures Experience has shown that the most logical layout of your Trigger list is to keep the related Triggers together i e setup the Audio Engine GPI on and off triggers ordering them by GPI input number It also pays to leave some blank lines between each group See the Trigger Examples later in the manual to get a feel for a logical Trigger layout 28 Logitek CommandBuilder 3 6 Reference Manual y Logitek CommandBuilder 3 6 E E amp Edit Read Save New Upload Table System Edit Procedure Triggers Trigger Table Trigger Table TriggerT able to Supervisor Page Procedures List PROCEDURE LIST Trigger Table File Name 4RK_TRIGS_1C 04 txt Total Procedures Total Commands 5342 0 ky 100 mf tte ES a vot oat Insert New 2 Intercom Dest Lamps ON Studio 451 IcomDestLampsOn_451 8 Procedure 3 Intercom Dest Lamps ON Edit 1 IcomDestLampsOn_Ed1 8 4 Intercom Dest Lamps ON Edit 2 IcomDestLampsOn_Ed2 5 Intercom Dest Lamps ON TVE IcomDestLampsOn_TVE 7 Procedure Block 6 Intercom Dest Lamps ON PA1 IcomDestLampsOn_PA1 8 Delete 7 Intercom Dest Lamps ON WS2 IcomDestLampsOn_WS2 8 Procedure Block 8 Intercom Dest Lamps ON CER IcomDestLampsOn_CER 9 9 Intercom Dest Lamps ON ISDN Orderwire IcomDestLampsOn_ISOW 8 10 Intercom Dest Lamps ON IFB ISDN IcomDestLampsOn_IFB_ISDN 10 1 Intercom Dest Lamps ON IFB REM2 IcomDestLampsOn_IFB_REM2 8 Copy Procedure Block 12 Intercom Dest Lam
208. rs based on a particular input establish a Route Trigger and send the appropriate color command using the s Source notation The color value is set with individual Red Green and Blue values from 0 15 Values higher than 15 for each color are not allowed and will result in an error Due to the inherent properties of the three colored LEDs many color combinations may be dull or unattractive The values below are a recommended starting point The keyword MOSAIC must be used An optional keyword SLOW MEDIUM or FAST can be used to set a flash rate on the lamp A flash rate of O is assumed if the keyword is omitted and equates to solid illumination The lamp can be set to flash even when its current state is off It is not possible to set the flash rate without setting color values The flash rate option is only supported in Mosaic v2 0 and above CHOFF refers to the lower button and CHON the upper button even if their function has been swapped using a Mosaic feature command Colors and flash rates are stored in the lamp and apply when it next comes on Turning the lamp or switch off does not reset the stored values VVVVVV WV VV Vv v Red Green Blue White Crimson Blue White Purple Light Aqua Dark Aqua Orange Yellow Magenta The PDF version of this manual shows each of the above colors from left to right RGB150000 RGB001500 RGB000015 RGB151515 RGB040000 RGB041215 RGB030015 RGB021411 RGB000915 RGB151200 RG
209. rther Information gt Call Procedure Page 53 gt Bus On Off Page 55 gt Route Page 59 Script Examples trigger ael d PA Monitor Amp bus62 on gt SSS SSS SS SS SS SS SS SS SSS SS SS SS SSS SSS SSS SSS SS SSS SS SSS PROCEDURE 12x1 Router REVISED 23rd May 2005 DATA ID AE1 Port4 PA COM 12 Button 12 DESCRIPTION Routes audio lights tally lamps NOTES DEPENDENCIES DEBUG STATUS call COM12 PA LampsOff procedure to turn off Lamps 7 12 cmd ael d PA Monitor Amp bus42 on turn on lamp 12 cmd ael route s Sat Net NERR to d PA Monitor Amp routes NERR to PA Intercom procedure COM12_PA_LampsOff PROCEDURE PA COM12 Lamps Off REVISED 23rd May 2005 DATA ID PA COM12 Lamps DESCRIPTION Turns off all lamps on Production Assistant COM12 NOTES DEPENDENCIES DEBUG STATUS cmd ael d PA Monitor Amp bus31 off turn off lamp 1 cmd ael d PA Monitor Amp bus32 off turn off lamp 2 cmd ael d PA Monitor Amp bus33 off turn o 3 cmd ael d PA Monitor Amp bus34 off turn o 4 cmd ael d PA Monitor Amp bus35 off turn o 5 cmd ael d PA Monitor Amp bus36 off gt CUE O 6 cmd ael d PA Monitor Amp bus37 off turn o h cmd ael d PA Monitor Amp bus38 off EUA o 8 cmd ael d PA Monitor Amp bus39 off turn o 9 cmd ael d PA Monitor Amp bus40 off turn o cmd ael d PA Monitor Amp bus41 off turn o cmd ael d PA Monitor Amp bus42 off turn o
210. s TRIGGER SCHEDULE must be the first words on the first line gt The date for the Trigger to fire must follow the keyword DATE in DD MONTH YYYY format gt The time for the Trigger must follow the keyword TIME with the time in HH MM SS 24 hour format gt Other date and time formats including the use of AM amp PM will result in an error gt The first line can t be a comment line Declaring Schedule Triggers A Schedule Trigger is defined by placing the appropriate command on the first line of an available Trigger in the Trigger List page Once you have found the Trigger you wish to define double click that row to edit the Trigger text The Trigger definition is then the first line in the edit box The Trigger must be marked active for Supervisor to process the Action Commands that follow it Schedule Trigger Format Schedule Event Trigger Sets a nin to occur at a nn date and time with a ne schedule trigger schedule date DD MONTH YYYY time HH MM SS repeat minutes hour day trigger schedule date DD MONTH YYYY time HH MM SS repeat DAY see below gt Any action commands can follow in the scheduled event just like a General Trigger gt The Schedule Event Trigger can be repeated at a desired time interval by using the keyword REPEAT gt The time interval for the repeat can be specified by using a number followed by the keywords MINUTES HOURS or DAYS gt The Schedule Event Trigger may also be repeated at t
211. s executed on the specified Audio Engine If the Device Number is a Source Device number or a named s Source Device the command will affect all instances of that Source Device on the specified Audio Engine Unlike the On Off command a Message Arrow is not directed at a particular Surface when using a Source Device The Message Arrow may be turned on or off set to flash continuously or made to flash once only One of the keywords ON OFF PULSE or FLASH is needed to set the mode of operation If the mode keywords are missing the message will default to ON The keyword PULSE will cause the Message Arrow to go on and off only once The keyword FLAG is no longer required but will not cause harm if present The monochrome display of the Numix I doesn t support different color Message arrows The following are examples of Message Arrow commands written to the Fader Wedge 3 000000 Q 3 2000000 po ael surfacel channell message on ae4 surface2 d Portl Fader 2 In message off ae4 surface2 d LastRoute message off ae6 surface3 fader7 message flash ae8 surface2 channell0 message puls ae2 s CD1 message flash ae2 device0100 message flash ae2 device000b message on Logitek CommandBuilder 3 6 Reference Manual f Lo gitek Numix I Clock This command is used to write a clock aller to the ae or Fader a Screens cmd ae surf surface clock Not Used softkey line pos clear insert cmd ae surf
212. s must contain the CHANNEL number on the Fader Wedge and the keyword LABEL The LINE or POS keywords are not required for this type of text To clear the label write a blank string of 8 characters with quote marks The label may be replaced by flashing text PENDING if a WHEN OFF command is used The label is replaced if a SET ALIAS command is issued to the source device on that fader The label is cleared when a route is performed on that fader To center a label you must manually pad the text string with spaces VVVVV V The following are examples of channel label text commands written to the Fader Wedge cmd ael surfacel channell text label Active cmd ael surfacel channel6 text label A LOC NEWS E Trim 94B 2 Trim 0dB MDI Studio A E E Pe Network Edit 2 Figure 18 Numix II Fader Screen showing alias amp message To set an alias for an input see the Set Device Alias command in Chapter 12 94 Logitek CommandBuilder 3 6 Reference Manual f Lo gitek Numix Il Message Arrow This command is used to an above an a on the Fader a Screens cmd ae Not Used device dest message See on off flash pulse 12345678 cmd ae Not Used device source message List on off flash pulse 12345678 cmd ae surf surface faderk message Below on off flash pulse 12345678 cmd ae surfff s
213. se an alternative word for clarity e g using relay instead of bus when pulsing or changing the state of a relay You will also note some command descriptions have different order of words In most cases the order of keywords is not important we suggest using the recommended order as per examples See B for a full list of allowed keywords and their equivalents Commands that are directed at a Source and or Destination Device number can be written using the bracket notation s Source Device and d Destination Device The use of this notation is strongly encouraged as it is easier to read and allows more flexibility for future changes Hard coded Device numbers can make it more difficult to manage your Trigger Table in the future See Chapter 6 for more information on the bracket notation for Device numbers 54 Logitek CommandBuilder 3 6 Reference Manual AS Lo gitek On Off amp Flash Commands This group of commands turns channels faders devices and lamps on or off Bus Channel Fader Relay On Off Turns the bus of a ae channel fader or device on or off Can be used to set bus ee cmd cmd cmd cmd cmd cmd cmd gt ae Not Used device dest bus relay on off ae surf surface device source bus on off ae surf surface fader bus on off ae surf surface chan channel bus on off ae Not Used d DeviceName bus relay on off ae Not Used d Last
214. sing and input meters are also available Commonly the DSP Crosspoints could be allocated to a Port 3 virtual surface The stereo Crosspoints on Port 3 will allow a mono mix from a stereo source if required As Port 3 is often unused the outputs can be duplicated on two Audio Engines for redundancy This also removes the need for a separate Audio Engine just for MCR switching and is therefore quite suitable for smaller facilities Panel Example Below is an example of a 24 button panel This could be a Numix NW24 wedge Remora BTN24 module or two Mosaic MLX 42 MLX NSOFT modules mounted in a compatible Wide Meter Bridge assembly For each destination a number of sources are available These lights will be shown in each studio providing an overview of the delegation at all times Pre selects flashing also show in each studio TX A E a EXCH OB RETURN Prod Bth Bth Prod Bth Studio A Prod Bth TAKE Post Delay Mix Minus Poe Minus E Prod Bth Prod Bth NewsBth Mix Minus Post Delay Mix Minus Mix Minus EE gt AA AAA IIA Studio A Post Delay is selected to TX A TX B EXCH amp ISDN TX A is pending to ISDN Functionality Press the desired source to destination button Lit destinations cannot be de selected Unlit destinations can be pre selected flashing if allowed Once pre selected to destination you have a lock on that pre select The button will flash Press TAKE to accept or press the flashing pr
215. sor a valid user name and password must be entered in the proper fields with the checkbox for CommandBuilder ticked This data only needs to be entered once and is usually setup when your system is installed A new Remember Password tickbox has been included as of CommandBuilder v3 6 2 0 This is ticked by default however if you are remotely managing multiple sites it is a good idea to untick the Remember Password box This can greatly assist in preventing the accidental uploading of an incorrect Trigger Table to a site Uploading to Supervisor Click the Press to Connect button to attempt to connect to Supervisor When successfully connected the red status Not Connected bar will change to a green status Connected bar and 22 Logitek CommandBuilder 3 6 Reference Manual EA Lo gitek the button title will change to Press to Disconnect The log is cleared and the Check Trigger Table button is also reset at this time Click the Check Trigger Table button to check all active Triggers and Procedures for errors If any errors are found the Trigger Table can not be uploaded to Supervisor The Check Trigger Table button can be used at any time you want to verify the entire table even when there is no connection to Supervisor A green progress bar at the top of the log window shows the status and any problems are listed below Possible errors include mistakes in Triggers or Procedures duplicated Trigger events
216. support user text For further details see the Artisan Manual Artisan Wide Softkey Screen R S CANCEL TAKE SELECT SELECT The Artisan Wide Softkey Module MLX WSOFT has two screens for user text Each screen has three femme Ml ee buttons to the left for initiating Triggers aran Ej dl Edit 2 Patch 2R Program Both screens can display user defined text In Em aux 2 addition they can be used with Route Select or oo m S Variable Select Triggers to present menu or router choices to the user The options are selected by the user with the Select knob and Cancel and Take buttons When using Route Select the selected route can tallied next to the button as shown on the right A A Figure 30 Route Select Figure 31 Route Select Artisan Wide Softkey Text tally ae This command is used to write text to the Fader Screens cmd ae surf surface text device52 insert line _ pos See below 14 chars cmd ae surf surface text device51 insert line pos See below 14 chars gt Text is displayed on as 11 lines of 14 characters gt Device 52 is the top screen device 51 is the bottom screen for the surface Channel number is not supported The command must contain the DEVICE or FADER number and LINE number To clear a line write a single space string to that line without the INSERT keyword Use the keyword INSERT with a position reference to overwrite written text occupying that pos
217. surface chan channel set eq high high mid low mid low freq gain db bandwidth cmd ae surf surface faderst set eq As above cmd ae Not Used d Device Name set e As above cmd ae Not Used device set e As above gt This command must include the Audio Engine number Surface number the Fader or Destination Device number and the required keyword EQ gt The keyword SET is optional and can be used for improved code readability gt The Destination Device can be specified by using the keywords FADER or CHANNEL or by using the d Destination Device notation gt The equalization can be set in one of four bands that are designated using the keywords HIGH HIGH MID LOW MID and Low gt The frequency and gain can be set in any of the four bands using the keywords FREQ and GAIN gt The bandwidth can be set only in the High Mid and Low Mid bands using the keyword BANDWIDTH gt Gain values are assumed to be in dB gt The dB keyword is optional The following are examples of the Set Fader Equalization command cmd ael surface2 faderl set eq high freq 17000 gain 12 cmd ael surfacel channel2 set eq high mid freq 1000 gain 10 cmd ae3 d Port2 Fader 6 In set eq low freq 1400 gain 10 cmd ae3 surface2 fader2 set eq low mid freq 2000 gain 12 bandwidth 1000 TIP To programmatically turn the equalization on or off send the appropriate bus on off command to BUS23 of the appropriate destin
218. te delay status to exit ready 2 call DelayTally StA Exit update lamps and text cmd set toggle 2 ael d Ctrl Surfl GPI In bus87 reset toggle to on state cmd set vDelayStAPostSwap 1 set post swap mode cmd store ael d Portl Monitor In route to vMonStAMonAmp store Monitor Amp source device cmd store ael d Portl Headphones In route to vMonStAOprHP store Opr Headphones source device cmd route ael s Portl Delay CP1 Out to d Portl Monitor In route post delay to Monitor Amp cmd route ael s Portl Delay CP1 Out to d Portl Headphones In route post delay to Opr Headphones call MosaicMonitor StA Monitor update monitor hotkey lamps call MosaicMonitor StA Headphones update monitor hotkey lamps cmd ael d Ctrl Surfl GPI Out bus87 flag flash continuous flash lamp FUNC3 endif procedure DelOffDelay StA 2 PROCEDURE Send Delay Off Commands amp Text Tally REVISED 27th April 2005 DATA ID StA Delay Off DESCRIPTION Sends off commands to delay Updates delay status on Mosaic surfaces NOTES DEPENDENCIES DEBUG STATUS 0 2 2 2 cmd set vDelayStAOn 0 update variable cmd set vDelayStASafe 0 update variable cmd ael d Portl Delay CP1 In talk off force off to clear delay PGM cmd ael surfl chan13 bus41 on turn on Delay Off lamp in this studio cmd ael device2
219. ter two allow for a source to be changed externally with the appropriate tally Button On Trigger gt The button on Trigger performs the route Procedure gt The Procedure is used to check the existing route and update the lamps if the route matches a known preset button gt This is called from a Route Trigger or any other Trigger that updates the monitor routing remember Triggers do not cascade so the Route Trigger will be called if we do a route from inside another Trigger Route Trigger gt Calls the procedure to check the current route gt Note this Trigger will not execute if a Trigger performs a route to this destination prevents endless loops Further Information gt Bus On Off Page 55 gt Input Route Page 59 gt Call Procedure Page 51 gt If State Page 149 Notes The Mosaic has a function called Follow Monitor for the Headphones and Guest Studio sends This function is automatically turned off when a Monitor Hotkey is updated from a Trigger An improvement to this function would first check whether Follow Mon is selected and if so ignore the change Script Examples trigger ael surfl chan27 bus16 on Mosaic Monitor Hotkey 1 PROCEDURE Monitor Rouen REVISED 22nd February 2005 2 DATA ID AE1 Port1 StA Phones USER 1 DESCRIPTION If on route source to announcer headphones NOTES DEPENDENCIES DEBUG STATUS NSSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS S
220. tercom destination lamps on or off at all stations NOTES DEPENDENCIES Commented lines not used but included for possible future use DEBUG STATUS N gt 0 SS LOLLOS cmd ael d Ctrl Surfl GPI Out bus off Dest Lamp OFF at stn Studio A Not used cmd ae2 surfl bridge lamp01 off Dest Lamp OFF at stn Edit 1 Softkey Lamp 1 cmd ae2 surf2 bridge lamp01 off Dest Lamp OFF at stn Edit 2 Bridge Lamp 1 cmd ae2 d ER Intercom Send bus31 off Dest Lamp OFF at stn Equip Room COM 12 Lamp 1 procedure IcomRxOn StA N SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE Intercom Receive Bus on off REVISED 17th February 2005 DATA ID ABC Renmark Studio A StA DESCRIPTION Turns intercom receive bus on at station either TalkRtn1 bus or crosspoint level NOTES DEPENDENCIES DEBUG STATUS N SSS SS SS SS SS SS SS SS SSS SS SS SS SS SS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSE cmd ael d Portl Monitor In bus03 on monitor dim and TB receive enable ON cmd set vIcomInUse StA 1 lockout status ON procedure IcomRxOff StA see ey PROCEDURE Intercom Receive Bus on off REVISED 17th February 2005 DATA ID ABC Renmark Studio A StA DESCRIPTION Turns intercom receive bus off at station either
221. tes status of record button lamp NOTES DEPENDENCIES DEBUG STATUS 2 cmd set toggle 1 ael surfl chan14 bus34 on set toggle state cmd ael surfl chanl3 bus34 off turn lamp off Console Scenes A scene is a way of quickly assigning certain sources to a set of faders This is useful in many situations such as a studio changeover from one program to another Functionality Description Instead of the operator having to change the sources on every fader a button can be programmed to complete a series of events in one snapshot In the example given below the commands written into this Trigger can reassign 6 faders with the push of just one button Components A scene in usually programmed to a single button in a group or from a menu activated by a button In our example a button within a group is used This On Trigger will Set a variable to track active scene useful for other functions that reference current scene Updates lamp group to turn selected scene lamp ON and all others OFF Clear Pending routes stored by previous scenes so new pending routes can be set Write text to display scene number and name to one of the surface screens Turn PGM bus ON for all faders except any faders that are turned ON Perform specific routes for each fader unless the route is already active If the fader is currently ON the WHEN OFF is used to store that route as PENDING gt Set the Mix Minus bus to PGM on Tel
222. these timers are not shared or unpredictable results may occur with source lamp flashing To allocate the timer numbers we suggest you make a matrix of all studios stations down the page with 12 columns for timer numbers across the page 12 is the normal number to use as most Logitek button panels have groups of 12 buttons It doesn t matter if you don t use all the buttons tc Studio A 1 Studio B 1 When allocating the timers first start at the source and locate the destination you are calling E g for Studio A calling Studio B timer 2 will be used to set the source lamp flash Then find the reverse direction in this case timer 13 This timer must be cancelled in the On Trigger otherwise if Studio A promptly replies to Studio B the lamp would be turned off by the previously set timer from Studio B This may sound a little cryptic If so try some Intercoms without the second timer being cancelled You will notice if you have a two way conversation with a particular station you will often end up with the lamp going off unexpectedly on the button you are pressing This timer logic prevents that situation Further Information If Variable Page 147 Cancel Timer Page 75 Set Trigger Active Notactive Page 74 Route Page 59 Call Procedure Page 53 Lamp Flash Page 57 If Timer Page 48 Bus On Off Page 55 Set Variable Page 144 VVVVVVV VV Script Examples trigger ael d Ctrl Surfl
223. this manual Logitek CommanaBuilder 3 6 Reference Manual Lo gitek Where are Triggers stored Like standard software development there are two parts to Trigger Tables the original source code used to develop them and the compiled code to be executed The process below outlines the various stages of Trigger development and execution The Trigger source code is stored in text format by CommandBuilder The actual source files are editable in a text editor provided the line numbers and trigger numbers are not upset When you upload a Trigger Table to Supervisor CommandBuilder compiles the table into commands that Supervisor understands and uploads the compiled table to Supervisor Supervisor then stores the compiled file in memory and on disk The disk file is only replaced when you upload a new copy of the Trigger Table CommandBuilder Supervisor Triggers eee a Compiled Triggers developedin gt gt gt gt stored by CommandBuilder format source uploaded to Supervisor code Supervisor Figure 1 Trigger storage Where are Triggers executed The trigger execution process is generally as follows 1 An event is originated by a control surface this step is skipped if the event originates in the engine The Audio Engine receives this event and sends a copy of the command to Supervisor Supervisor logs the event and updates its Audio Engine State and Log pages
224. tion the Meter Bridge Monitor module and Wide Softkey module have screens that support user defined text All screens on the Mosaic are color The Mosaic has less user screen space than a Numix or Remora console However the Mosaic is designed to be used in conjunction with vScreen to show additional user defined information including clocks meters and text See the vTools Reference Manual for further information on configuring vScreen Figure 21 Mosaic Surface A The Mosaic introduces many new surface text functions and therefore commands requiring destination addresses will be affected by the Mosaic layout your surfaces use Please contact Logitek Electronic Systems or your reseller to obtain the latest information Logitek CommandBuilder 3 6 Reference Manual 105 Lo gitek Mosaic Fader Screen The Mosaic Fader Module MLX 20 MLX FADER contains one screen shared between two faders that allows an Alias to be written The Alias is an 8 character string in large font as shown below Tr a JB EQ DYN null Mic 2 Mic 3 Figure 22 Mosaic Fader Alias 8 character Mosaic Label Text This command is used to write a label to an input on a Fader Screens cmd ae surf surface cmd ae surf surface chan channel text label 12345678901 23456 fader text label 12345678901 23456 The label is large font text displayed in a label space directly
225. tions around the world CD Preview Functionality Description This is a hotkey function to put the CD fader on CUE and send a GPI to the CD player to preview the start of the cued track It requires a CD player that supports a GPI to provide this function either GPI held high when in preview or GPI to start and GPI to recue The example may need to be adjusted to suit the equipment you use Components This function has an ON button pressed and OFF button released Trigger Button On Trigger pressed Check if CD player is OFF don t execute function while it is playing to air Turn CUE channel ON for CD Turn button lamp ON Turn GPI ON to CD player Enabled OFF trigger so the OFF component only runs following a successful ON VVVVV Button Off Trigger released gt Turn CUE channel OFF for CD gt Turn button lamp OFF gt Turn CPI OFF to CD player Further Information gt If State Scan Page 150 gt Bus On Off Page 55 gt Set Trigger Active Page 74 Script Examples trigger ael surfl chan14 bus37 on N SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS PROCEDURE CD Preview REVISED 18th May 2005 DATA ID CD1 Preview ON DESCRIPTION Puts CD on off cue Sends GPI to CD NOTES DEPENDENCIES DEBUG STATUS if state ael scan surfl s StA CD 1 bus00 off 18 CD 1 off cmd ael surfl s StA CD 1 bus02 on Cue on
226. tly done 9 Launch Supervisor 3 6 and set up the COM ports for the engines if necessary In Supervisor 3 6 you can change COM port assignments without having to restart the program 10 Launch CommandBuilder 3 6 read your trigger table from c Logitek3 6 or the directory you have stored your configs in if you did not use the defaults save it and upload it to Supervisor 11 Configure and launch any other PC applications that you use at your facility Do not try using older versions of our software with version 3 6 as it will not be compatible 18 Logitek CommandBuilder 3 6 Reference Manual a Logitek The setup program will copy the required files to the program directory establish a folder called Logitek Programs in the Windows Start menu if ticked and create desktop shortcuts if ticked These tasks can also be done manually by copying the program file to an appropriate directory a m Setup 3 6 Logitek Software Installation Installation Type Which type of Logitek Version 3 6 software installation do you wish Install Logitek software on this PC for the first time Update a previous installation whose Supervisor program is aversion BEFORE Supervisor 3 5 This installation will NOT copy the previous Supervisor profile data or Registry entries Update a previous installation whose Supervisor program is version 3 5 This installation WILL copy the previous Supervisor profile data and Registry entries
227. tored values Red RGB150000 Purple RGB030015 Green RGB001500 Light Aqua RGBO21411 Blue RGB000015 Dark Aqua RGB000915 White RGB151515 Orange RGB151200 Crimson RGB040000 Yellow RGB091500 Blue White RGB041215 Magenta RGB150015 The following is an example of an Artisan Set Channel Color command to change the lamp color to GREEN for the low OFF tally trigger ael device0b bus0 off cmd ael surfl device0b artisan set color chon RGBO01500 tally The following is an example of an Artisan Set Channel Color command to change the lamp color to RED for the high ON tally trigger ael device0b bus0 on cmd ael surfl device0b artisan set color chon RGB150000 tally Mosaic Set Channel Color Sets the color of a Mosaic Channel On or Channel Off sua cmd ae surf chan channel choff chon set color RGB000015 slow medium fast surface fader mosaic cmd ae surf s Device Name choff chon set color RGB001500 slow medium fast surface mosaic cmd ae Not Used device choff chon set color RGB000015 slow medium fast mosaic cmd ae Not Used diDevice Name choff chon set color RGB151515 slow medium fast mosaic gt The Channel On and Off buttons on the Mosaic support a variety of colors and flash rates gt To set fixed colors for specific faders use the Init Trigger and send the color command using a SURFACE and CHANNEL or FADER DEVICE number or d Device notation gt To change colo
228. tton Triggers an Off Trigger is only required if commands should occur when the button is released otherwise you only need an On Trigger Route 3 Button Trigger A variation of the On Trigger for use with Route 3 CH1 and CH2 button presses trigger gt gt gt gt gt ae Not Used _ device dest butt button on The Route 3 must be in Message Mode for this Trigger to occur This command only supports a hard coded Destination Device number It does not support the SURFACE or CHANNEL It does not support the d Destination Device notation The CH1 button uses the keyword BUTTON1 The CH2 button uses the keyword BUTTON2 There is only an On Trigger for the Route 3 buttons There is no Off Trigger TIP You will need a Logitek Device Reference table to determine the correct Device Logitek CommandBuilder 3 6 Reference Manual Lo gitek Route Trigger Fired when a specified Source Device is routed assigned to a specified Destination Device e g fader trigger ae device to chan channel fader any trigger ae s Device Name to diDevice Name fem gt This Trigger must include the Audio Engine number Surface number Source Device number Destination Device number and the required keyword ROUTE gt The Source Device can be specified using keyword DEVICE or using the s Source Device notation gt The Destination Device can be specified by using the keywords FADE
229. ubtle particularly on the brighter higher values Values 0 11 are pictured below The following are examples of the Set Intensity commands cmd ael device27 bus88 artisan set intensity 0 cmd ael surfl chan13 bus44 mosaic set intensity dim cmd ael d Ctrl Surfl GPI out bus99 mosaic set intensity bright Figure 41 Mosaic Small Lamp intensity 0 11 Artisan Mosaic Variable Lamp Flash This command is the same as is used with other hardware and as such is detailed on page 58 SOURCENAME This command displays the source that is routed to a destination The destination may be referenced either by device number or by d destination notation This command is valid for Mosaic first generation and second generation Artisan Numix and ROC You will need to know the device number and line number of the display The keyword display as well as the parentheses and spacing are required cmd ael sourcename d Portl Fader 3 display device 27 line 7 pos 6 cmd ael device 6e display device 27 line 4 pos 1 15 User amp System Variables Introduction Variables are memory places in Supervisor to store numeric values User Variables can be set inside Triggers System Variables are internal to Supervisor and are set upon certain system events occurring CommandBuilder has Test Statements that allow the value of both types of variables to be tested similar to most programming languages These Test Statements can b
230. urce message on off flash pulse E md ae surf surface faderk message on off flash pulse Cc C md md ae surf surface chan channel message on off flash pulse ae Not Used d DeviceName message on off flash pulse C G md md ae Not Used d LastRoute message on off flash pulse ae Not Used s DeviceName message on off flash pulse gt gt gt gt gt gt gt Yv Y Vv VVVVV A special Message Arrow can be displayed above a fader to display an alert to the user The fixed text string EOM End of Message is displayed above the Message arrow Only one Message Arrow can be displayed at a time on a Numix I Surface A second Message Arrow will automatically clear the first Message Arrow The Message Arrow will temporarily clear text lines from the upper half of the screen All text lines will be restored when the Message Arrow is turned off This command must include the Audio Engine number Surface number Channel Fader or Device number and the required keyword MESSAGE One of the keywords CHANNEL FADER or DEVICE is required The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the DEVICE keyword The special system destination d LastRoute will use the Destination Device number of the last Route command that wa
231. urface chan channel message For on off flash pulse 12345678 cmd ae Not Used d DeviceName message Color on off flash pulse 12345678 cmd ae Not Used d LastRoute message Key on off flash pulse 12345678 cmd ae Not Used s DeviceName message Words on off flash pulse 12345678 gt gt gt gt gt gt VV v VVVV V gt A special Message Arrow can be displayed above a fader to display an alert to the user An 8 character user defined text string is displayed above the Message Arrow More than one Message Arrow can be displayed at a time on a Numix II Surface The Message Arrow will temporarily clear all but the top text line from the screen All text lines will be restored when the Message Arrow is turned off This command must include the Audio Engine number Surface number Channel Fader or Device number and the required keyword MESSAGE One of the keywords CHANNEL FADER or DEVICE is required The required Device or Fader number may be given using the s Source Device or d Destination Device notation instead of using the DEVICE keyword The special system destination d LastRoute will use the Destination Device number of the last Route command that was executed on the specified Audio Engine If the Device Number is a Source Device number or a named s Source Device the command will affect all instances of that Source Device on the speci
232. urs Supervisor responds by executing the action commands listed for the General Trigger The basic form of a General Trigger is TRIGGER DEVICE ACTION where TRIGGER is the required keyword DEVICE is where the action will occur and ACTION is what happens The DEVICE description includes items such as Audio Engine and Surface numbers Device number Bus number button names variable names and Source or Device names The ACTION item includes things like ON OFF ROUTE UNROUTE SET and CHANGE General Rules gt The keyword TRIGGER must be the first word on the first line gt The first line can t be a comment line gt A Trigger need not contain Action Commands it can be a definition only Declaring General Triggers A Trigger is defined by placing the appropriate Trigger command on the first line of an available Trigger in the Trigger List page Once you have found the Trigger you wish to define double click that row to edit the Trigger text The Trigger definition is then the first line in the edit box The Trigger must be marked active for Supervisor to process the Action Commands that follow it General Trigger Types There are six types of General Triggers as follows An ON Trigger is fired when a channel ON event occurs Button pressed GPI input goes high An OFF Trigger is fired when a channel OFF event occurs Button released GPI input goes low ROUTE A ROUTE Trigger is fired when a specified route occurs to Spe
233. ute 3 display cmd ael surface2 route3 text label channell Temp 1 cmd ael surface2 route3 text label channel2 Temp 2 cmd ael surface2 route3 text label channel3 Temp 3 cmd ael d OutputName text line5 Temp 3 The following are examples of changing the stored default labels and at the same time changing the lower line on a Route 3 display cmd ael surface2 route3 text default channell Chan 1 cmd ael surface2 route3 text default channel2 Chan 2 cmd ael surface2 route3 text default channel3 Chan 3 TIP The recommended location to set Route 3 labels is in the Init Trigger Figure 36 Route 3 Normal Mode text Route 3 Set Message Mode This command is used to set the text mode of a Route 3 cmd ae surf surface chan channels route3 set message mode normal mode cmd ae Not Used d DeviceName route3 set message mode normal mode gt With Surface Addressing use a Surface number and Channel number gt With Output Addressing the d Destination Device notation is recommended gt This command does not support a Destination Device number gt Channel number is 1 3 for the first Route 3 on a Port 4 6 for the second and so on gt Required keywords are ROUTE3 SET NORMAL MODE or ROUTE3 SET MESSAGE MODE The following is an example of setting the Route 3 screen to Message Mode cmd ael surfl channell route3 set message mod The following is an example of restoring the Route
234. vVariableName cmd store route ae surf surface fader to vVariableName cmd store route ae Not Used device to vVariableName cmd store route ae Not Used diDeviceName to vVariableName gt The Source Device number can be recalled from a User Variable and assigned to a Destination Device The Destination Device does not need to be the same as the device used to store the route The route is recalled from the variable using the keywords CMD RECALL ROUTE followed by the Audio Engine number and destination then the User Variable name using the vMyVariableName notation The parenthesis and the keyword FROM are optional Device numbers are usually different across Audio Engines even when the inputs are named the same For this reason a Route Recall should only be performed from a User Variable that had a matching Route Store on the same Audio Engine Vv Vv The following is an example of storing and recalling a route in a User Variable cmd store route ael d Portl Fader 1 In to vPortlFaderlRoute cmd recall route ael d Portl Fader 1 In from vPortlFaderlRoute 16 Test Statements Introduction Test Statements provide a means to execute different sets of Action Commands depending on the outcome of the Test Statement The available Test Statements include If Toggle Equals If Variable If State Equals If State Scan and When Off The use of Test Statements allows for very powerful Trigger logic If you ha
235. vate Monitor or Headphones dimming upon talkback being activated When an Intercom destination is in use a Procedure is called to light up the appropriate buttons for that station at all other stations This provides the operators with an indication that station is in use A lockout feature then prevents other stations from breaking in when one station is receiving talkback At the called station the calling station will flash to indicate who is speaking The lamp will continue flashing for a few seconds longer in case the operator was not watching the console at the time they were called This also provides a good visual cue of which button to press to respond To build this Intercom system first allocate appropriate buttons for each studio and the stations it can call It is important to allocate these first Components The Intercom system makes use of a number of Trigger and Procedure components Procedures are used to cut down on code repetition and centralise updates In each studio an ON and OFF Trigger set is required for each button that calls another location This Trigger will call upon the required procedures to turn ON or OFF the destination lamps and assist with routing You will notice that two timer numbers are referenced in each Trigger set These timers allow the flashing source lamp to stay on for a number of seconds after a station called The logic is also structured so that a button release can only turn off an Interc
236. ve Routes can also be tallied to text screens VVVVV Requirements gt Virtual surface port available on Audio Engine gt 1 Fader per input to Assignment Mixer gt 1 Mix Bus per output to destination paths gt 1 button per path in each studio plus a master on off button Network Source Switcher Direct Access Version The Network Source Switcher provides simple cut based switching between sources On a 24 button panel this switcher works well for up to 5 outputs with 3 5 sources each One button is required per source destination combination e g Studio A Post Delay to transmitter 1 If more source destinations combinations are required the XY version of this switcher can be used see following section This panel allows an operator to preselect a number of sources which will indicate with a flashing lamp in all studios The TAKE button will execute all these pre selected routes in one action The Network Source Switcher provides easy to use operation with visibility of the current routes on the button panel in each studio A TAKE operation is a cut from one source to another there is no capacity to mix two sources simultaneously One DSP Crosspoint or Output Route is required per output path Any number of inputs can be routed limited only by button capacity on the panel DSP Crosspoints are recommended if gain control or mono mixing is required If using DSP Crosspoints on a SharcAttack DSP card proces
237. ve prior programming experience you will no doubt be familiar with IF END IF type tests The Logitek Scripting Language has two primary types of Test Statements IF and WHEN The group of Action Commands enclosed in a Test Statement must be completed with a corresponding ENDIF or ENDWHEN Like most programming languages CommandBuilder supports the nesting of IF statements This allows for even further depth to the logic tests that can be performed If Toggle Tests the current state of a mii Me if toggle 1 2 then If the Toggle State is equal the commands enclosed in the If Toggle block are executed This Test Statement can be used only with Toggle Triggers Appropriate sets of commands can be executed depending on the current state The desired commands for a specified state must appear between the IF TOGGLE statement and its corresponding required ENDIF keyword Toggle Triggers start in Toggle State 1 and alternate between 1 and 2 on each execution The keyword THEN is optional but recommended for improved code readability VVVV Vv The following example illustrates the use of the If Toggle Equals statement if toggle 1 then cmd ae3 surfacel fader2 bus2 on cmd ae4 surface2 channel3 busl on cmd ael d Port2 Fader 4 In bus 0 on endif if toggle 2 then cmd ae3 surfacel fader2 bus 2 off cmd ae4 surface2 channel3 bus 1 off cmd ael d Port 2 Fader 4 In bus 0 off endif See Chapter 12 for information on s
238. y BIG12 OFF trigger ael surfl chan18 bus32 off NOT n 743 450 Hor2 Softkey SML1 OFF trigger ael surfl chan18 bus48 off NOT Trigger Block 744 450 Hor2 Softkey SML2 OFF trigger ael surfl chan18 bus46 off NOT 745 450 Hor2 Softkey SML3 OFF trigger ael surfl chan18 bus44 off NOT Paste 746 450 Hor2 Softkey SML4 OFF trigger ael surfl chan18 bus49 off NOT Trigger Block 747 450 Hor2 Softkey SML5 OFF trigger ael surfl chan18 bus47 off NOT 748 450 Hor2 Softkey SML6 OFF trigger ael surfl chan18 bus45 off NOT Trigger List Figure 42 Trigger List showing stub triggers The above screenshot shows a section of stub Triggers following our suggested layout Trigger Naming The naming of Triggers is entirely up to the user Examples from the recommended naming are AE1 Engine GPI 1 ON St1 Surface GPI 1 ON St1 Bridge BUTT1 ON Scene 1 Talk St1 Softkey BUTTS OFF Stl NW24 BUTT1 ON VVVVV In each case add a short description of the Trigger where relevant e g gt AE1 Engine GPI 15 ON Stl Comm Break Pulse gt Stl Bridge BUTT1 ON Scene 1 Talk A Trigger must not have the word Trigger as the first word in its name otherwise CommandBuilder will delete its name from the table 18 Basic Examples This chapter includes some examples of basic Trigger functions that perform useful functions These are based on popular functions used by Logitek sta
239. y lamps see Chapter 18 for more info VVVVV Further Information If Toggle Page 146 Set Variable Page 144 Device Store Recall Page 144 Lamp Flash Page 57 Call Procedure Page 53 VVVVV Notes If you use this function you need to consider the implications of changing the monitor sources from other Triggers For example our Delay On and Delay Exit Triggers will update the monitor source and therefore these Triggers also update the toggle state and button lamp These updates ensure the operation of the console is consistent and predictable and avoids operator confusion Script Examples trigger ael d Ctrl Surfl GPI In bus87 on toggle Mosaic Wide Softkey Function Button 3 PROCEDURE Pre Post swap REVISED 27th April 2005 DATA ID AE1 Portl StA Wide Softkey FUNC3 DESCRIPTION Swaps delay between pre post monitoring Swaps between prior setting and PostDelay NOTES DEPENDENCIES Toggle and restore can also be done in the delay direct trigger DEBUG STATUS if toggle 1 normal state cmd set vDelayStAPostSwap 1 set post swap mode cmd store ael d Portl Monitor In route to vMonStAMonAmp store Monitor Amp source device cmd store ael d Portl Headphones In route to vMonStAOprHP store Opr Headphones source device cmd route ael s Portl Delay CP1 Out to d Portl Monitor In route post delay to Monitor Amp cmd route ael s Portl Delay CP1 Out to d Portl Headphones
240. y words that it finds on each line Keyword entries in the scripting language are not case sensitive They may be entered in upper lower or mixed case as desired All keywords must be separated by at least one blank space on either side All words that are not defined or recognized by the scripting language are treated as spaces Since extra spaces and words are ignored they may be used to improve the readability of command lines Unless noted the keywords may be in any order on the line The recommended order shown in examples is for the most logical readability See B for a complete list of keywords Device Numbers All signals in the Audio Engine are referenced by an internal number called a Device Number Each input signal is assigned a unique Device Number by the AEConfig program Each output signal is assigned a Device Number defined by the DSP table associated with a configuration file or assigned by an output in AEConfig Input Device Numbers are called Source Devices and the output Device numbers are called Destination Devices Most commands sent from Supervisor to the Audio Engine refer to a specific Source or Destination Device Number Source Devices are referred to using the keyword DEVICE followed by the device number in hexadecimal notation For example DEVICE 010B could refer to a Source Device for an input on a given Audio Engine Destination Devices are referred to using the keywords CHANNEL or FADER followed by the conso
241. ys Screen for displaying text The main module of a Remora console the REM4 has four faders plus some additional space for monitoring selections amp menus as shown below Fader 9 Phones CEE odao Meter igen a seda a j 100 Program Cue ii F 10 Program D L 18 Mic 1 ews Program Out Monitor Mt Figure 19 Remora REM4 screen TIP The Logitek vScreen program can be used on a PC in the studio to display text messages from Triggers This can be used to emulate a Surface Softkey Screen Logitek CommandBuilder 3 6 Reference Manual 97 Lo gitek Remora Questions Screen Text These commands are used to write text to the Remora Question Screen cmd ae surf surface set question mode cmd ae surf surface text question linez 1 2 pos 1 29 characters 29 gt The Question Screen will display 2 lines of 29 characters each gt This screen is used to ask a question with the user able to select the ACCEPT or CANCEL buttons gt Before text can be written to the Question Screen it must be placed in Question Mode using the keywords QUESTION MODE gt Placing the Question Screen in this mode clears all existing text from the Question Screen gt Text commands in Question Mode are displayed immediately when received by the surface gt Use the IF BUTTON CANCEL and IF BUTTON ACCEPT Conditional Triggers to react to the user selection gt You must

Command Builder Manual v3.6.1

Contents

Download Pdf Manuals

Related Search

Related Contents