MSAT User Manual 1460KB Mar 11 2009 04:36:56
Contents
1. Toolbar and Status Bar is displayed by selecting Toolbar and Status Bar from the View menu MSAT OVERVIEW 2 3 CONNES HNG TO FMC OR PIM 5 Applications mav run on a single machine e connected by Windows sockets Satellite 100 Base T x Ethernet Hub waar L J Required for H ues Only EN 1 4 RS232 422 Controller x 3 d Party RAPID 7 N Application S RAPID DLL Figure 2 RAPID MSAT Set up for Satellite Systems 7 D x xe H Ba Applications may run on a single machine Station Pd connected by Windows sockets N Running FMC Ko y 100 Base T Ir i PA Ethernet Hub IMSAT y IE 1 IL J Required for Y EES A Development Only RS232 422 Controller N FC Partv RAPID Ma e x Application H xt _ RAPID DLL MW ad Figure 3 RAPID MSAT Set up for Station or Console Svstems SSM runs PIM 5 and two instances of MSAT Station MSAT 0 connects to FMC Running FMC MSAT 1 piu to PIM 5 100 Base T l En ZS PIM 5 H o en EE NN RS232 422 Controller Figure 4 MSAT PIM FMC Set up for Station or Console Systems USING MSAT 2 4 MSAT communicates with EMC or PIM 5 via TCP IP and must be correctly con figured as described below When MSAT is successfully connected to FMC the On line indicator is displayed at the right of the status bar at the bottom of the MSAT window When no conne2. add the line to the script The GET command reads the specified parameter and stores it in one of the five internal variables These can later be used in a logical comparison with the TEST command The SET command can be used to set a parameter to a fixed value entered in the value field or to a value previously stored in one of the five internal variables The TEST command can be used to perform a logical comparison on the selected 2 10 parameter The parameter can be tested against a fixed value entered in the value field or a value previouslv stored in one of the five internal variables P y Thelogical operators are GT greater than GTE greater then or equal EQ equal LTE less than or equal LT less than NE not equal If the result of the operation is false the script will record an error The script system can be set to Exit On Error or ignore errors See Exit On Error on page 2 11 Time Filter When a script is recorded the time delays between physical actions is recorded and inserted into the script file The time filter button minimises the WAIT times be tween recorded commands to 250 milliseconds in order to optimise script playback Playing Scripts pe i d a To play back a previously recorded script click the drop down list box to select the script name Scripts are be located in either the Global script repository on the in house Fairlight LAN or in a local directory Click the Glb button to select f
3. and recorded in a log file This feature allows third party RAP ID developers to verify the operation of their remote control applications It also provides useful information for fault finding and general testing of DREAM sys tems FMC messages are displayed in the main message window Monitor Start Stop gt Click the start or stop buttons to start or stop monitoring FMC messages Alternatively press the Space bar to quickly toggle message monitoring on or off Monitor Message Masks uo Fr a Click the Message Mask buttons to enable the display of general mes sages system messages or parameter messages General Messages General messages include a range of optional de bug messages that can be generated by EMC To enable de bug messages from EMC hold down the Shift key and press Pause Break on the PC keyboard to display the De bug Switch dialog box Enter the debug switch value at the bottom of the dialog box De bug switch values for each switch are defined in the dialog box when the switch is selected from the drop down list System Messages System messages include messages relating to the operating system including file and memory management events System messages also include events generated by MSAT associated with script playback All Parameter Messages Parameter messages are generated whenever a parameter value changes Parameter changes may be caused by physical actions on the control surface script replay or r
4. similar Edit the copy of the shortcut and add a c1 command line switch to specify channel 1 Change the name of this shortcut to MSAT PIM FMC Command Line Edit the DREAM bat file which is located in the C projects mixers directory On a working DREAM system the DREAM bat file will display the following op tion at the top of the file set MSAT CHANNEL 0 Edit this line as shown above replacing the channel number specified in the MSAT command line On a development system based on the RAPID SDK DREAM bat will only con tain a simple command line A typical command line will look like this C projects mixers fme fme p1 1 1 11 d e s2 c0 Add the c0 option to the end of the line replacing the channel number specified in the MSAT command line PIM 5 Command Line Click on the Start menu and select Programs gt Fairlight ESP Tools and right click on MSAT and select Properties from the context menu Select the Shortcut tab and click in the Target text box Add the c 1 command line switch to the end of the target command line replacing the channel number specified in the MSAT command line Add the h www xxx yyy zzz command line switch to the end of the target command line replace www xxx yyy zzz with the IP ad dress of the machine running MSAT CONNECTING TO FMC OR PIM 5 2 7 MESSAGE MONITORING AND LOGGING MSAT allows the a range of parameter svstem and general messages generated bv FMC to be displayed
5. DREAM MSAT Monitor Svstem and Automated Testing User Manual and Scripting Reference MSAT Version 1 1 161 Part No DMIX208 A Document No 208 i Important Notice COPVRIGHT The material in this document is copvright to Fairlight ESP Ptv Ltd and mav not be quoted or re produced in anv form without written permission from the companv Fairlight is a trademark of Fairlight ESP Pty Ltd All other trademarks are the property of their re spective owners LIMITED WARRANTY POLICY All the software and hardware provided with or purchased especially for Fairlight products has been tested for functionality Fairlight ESP Pty Ltd will make its best efforts to correct reported defects for future releases subject to technical practicabilities Fairlight ESP will also replace any defective media on which software has been delivered provided that the item to be replaced is returned to the dealer who supported the product within 90 days of purchase Fairlight ESP Pty Ltd makes no warranty or representation either expressed or implied with respect to the system s performance or fitness for a particular purpose In no event will Fairlight ESP Pty Ltd be liable for direct or indirect damages arising from any defect in the product or its documentation Further Fairlight ESP Pty Ltd will not accept any liability for any programs sounds audio recording or sequences stored in or used with Fairlight products in cluding the cost of reco
6. IE EE 3 4 AM S zem etant tenute 2 11 All Parameter Messages 2 7 AND s enm de tota SUN EE ER 3 4 ASSIGN 6 3 4 Automated Test Scripts 2 0 C CHANGE CONTROL 3 3 Clero te oc EE Ad 2 7 Command Line 2 4 Comment 2 9 Comments 6 3 2 CONSTANT 3 2 CONTROL ID 3 2 D Delaware 3 6 Directory Path local 2 10 DIV sbie ara 3 4 E ENDLOOP 3 5 E Een 2 10 tert nodu i ge ta 2 11 Executer oie oet EOS ae S 2 9 EXECUTE SCRIPT 3 6 Exit On Error 2 11 F FAST sota ito LL en 3 3 File Functions 2 8 Filename 3 6 FMC engt 2 2 00 de a ie 2 2 FMC Command Line 2 4 G General Messages 22 222 060 2 7 Get Parameter 2 2222 2 9 Gl Bette ds see ens 2 10 Global Sentus ede 402452 2 10 GI TA ny te ege us ces 2 10 GER Lote tou eta Etui 2 10 H Host Name 2 4 l Insert Pause 2 9 EE EE l 2 IP addtess ib aa 2 4 INDEX L Local MSAT iras 2 4 Local scripts isti dawo id 2 10 Log File dia teen 2 7 Logging rcg ous E EEN 2 7 LOOP ec ano 3 5 Loop Counter ev kai 3 5 Loop Counters isa e ads 3 2 PE geia II 2 10 DUE A E 2 10 M VIBE tc a ect D rA 3 4 Message EE 2 7 Message Monitoring 2 7 Messsage Masks 2 7 MOD unsre 3 4 MODUEBESDYPE 000 anota 3 2 MSAT kie rn 2 2 MULA bd 3 4 N NE erae De si l ads 2 10 O Offline Varia Beer 2 4 On
7. NEQ This instruction is used to verify that the mixer has corresponded correctly to the proceeding instructions The specified parameter from the mixer is tested against a value and the execution of the script is stopped if the test is false CHANGE CONTROL control id new value This instruction will cause the selected control surface parameter to take the new value The control id will typically be constants as defined in the DeskC trIViewDefs h READ VIEW view id variable This instruction reads the value of the view element from the mixer and places it in the specified variable TEST VIEW view id condition value Where condition is GT GTE EQ LTE LT or NEQ This instruction is used to verify that the mixer has corresponded correctly to the proceeding instructions The specified view element from the mixer is tested against a value and the execution of the script is stopped if the test is false FAST Changes the default execution speed to approx 5 mS between instructions SLOW Resets the default execution speed to approx 25 mS between instructions MSAT SCRIPT SYNTAX MATH INSTRUCTIONS The five local variables can be assigned values bv reading either a mixer parameter or bv reading the state of a view element Additionallv thev can be preset using the ASSIGN command ASSIGN variable MODULE TYPE PARAMETER CONSTANT control id view id LCx Vx Basic math is supported using the same varia
8. and line Add the h1ocalhost command line switch to the end of the target command line CONNECTING TO FMC OR PIM 5 2 5 UsiNG MSAT Running MSAT on a Remote Machine To run MSAT on a network connected machine first verifv that the two machines are correctly configured You will need to know the IP address of both machines Note that the two machines must be on the same subnet Use the Ping utilitv from a command line window to ensure both machines are communicating For more in formation on Windows networking refer to the Windows Help svstem MSAT Host Name Open the File menu in MSAT and select host name Tvpethe IP address of the machine run ning FMC in the Host Name dialog box Restart MSAT FMC Command Line Use the p command line option when starting FMC FMC is started by executing the DREAM bar file Edit the DREAM bat file which is located in the C projects mixers directory On a working DREAM system the DREAM bat file will display the following op tion at the top of the file set MSAT IPADDRESS 1 1 1 11 Edit this line as shown above replacing the IP address with the address of the ma chine running MSAT On a development system based on the RAPID SDK DREAM bar will only con tain a simple command line A typical command line will look like this C projects mixers fmc fme p1 1 1 11 d e s2 Make sure you remove the c option which is described above Replace the IP ad dress with the address of t
9. aying SCEHIDES S 5d centu seva a red 2 10 Play List Script Picker 242422244244 2 10 Chapter 3 MSAT Script Syntax GENERAL tege bli ali atte ues seen 3 2 OPERANDS aA La L a d Be 3 2 COMMENTS 2t RES E ERE 3 2 PARAMETER ACCESS INSTRUCTIONS 3 3 SET PAR module type module index parameter id new value 3 3 READ PAR module type module index parameter id variable 3 3 TEST PAR module type module index parameter id condition value 3 3 CHANGE CONTROL control id new value 3 3 READ VIEW view id variable 3 3 TEST VIEW view id condition value 3 3 FAST eene A EE 3 3 SLOW te a TUUM M E EET E 3 3 MATH INSTRUCTIONS o 3 4 ASSIGN variable MODULE TYPE PA RAMETER CONSTANT control id view id E e Reel 3 4 ADD variable operand 3 4 SUB variable operand 3 4 MUL variable operand 3 4 DIV variable operand 3 4 MOD variable operand 3 4 AND variable operand 3 4 OR variable operand 3 4 XOR variable operand 3 4 PROGRAM CONTROL INSTRUCTIONS 3 5 LOOP start value end value step value 3 5 ENDEQOB rada vs i ne eu b 3 5 MISCELLANEOUS INSTRUCTIONS 3 6 WAIT delay in milliseconds 3 6 EXECUTE SCRIPT filename 3 6 Index TABLE OF CONTENTS NOTES l 2 Chap
10. ble to supply both destination and one of the source arguments with the second argument being any of the possible oper ands ADD variable operand SUB variable operand MUL variable operand DIV variable operand MOD variable operand AND variable operand OR variable operand XOR variable operand MATH INSTRUCTIONS 3 5 PROGRAM CONTROL INSTRUCTIONS LOOP start value end value step value ENDLOOP MSAT SCRIPT SVNTAX All instructions from the LOOP statement down to the next ENDLOOP are re peated until end value is reached or exceeded Note that the end value is only calculated once at the entry to the loop Also note that the step value is added to the loop counter at the end of the loop Finally please note that the loop is not entered if the start value is equal to or ex ceeds the end value The equivalent C code is as follows LC1 start value while step value 0 LC1 end value LC1 end value LC1 step value Due to this implementation the loop construct can be used as a simple IF state ment Used in conjunction with LOOP see above MISCELLANEOUS INSTRUCTIONS WAIT delav in milliseconds Stalls execution for an amount of time EXECUTE SCRIPT filename 3 6 Calls and executes a script Include the full pathname Avoid recursive scripts MISCELLANEOUS INSTRUCTIONS 3 7 MSAT SCRIPT SVNTAX Index i NOTES INDEX Index ii A KH D
11. ction has been made the Offline indicator is displayed The Tx Rx indicators show a tally of the packets sent between MSAT and FMC or PIM 5 Running MSAT on Local Machine To run MSAT on the same machine as FMC or PIM 5 it is necessary to modify the FMC or PIM 5 command line and set the MSAT Host Name from the MSAT File Menu MSAT Host Name HostName x ed 7 Cancel Open the File menu in MSAT and select host name Type local in the Host Name dialog box Restart MSAT FMC Command Line Use the c command line option when starting FMC FMC is started by executing the DREAM bat file Edit the DREAM bat file which is located in the C projects mixers directory On a working DREAM system the DREAM bat file will display the following op tion at the top of the file set MSAT IPADDRESS LOCAL Edit this line if necessarv making sure that LOCAL is entered in upper case On a development system based on the RAPID SDK DREAM bat will only con tain a simple command line A typical command line will look like this C projects mixers fmc fme d e s2 c Make sure you remove the p option which is only applicable for remote MSAT connection PIM 5 Command Line Click on the Start menu and select Programs gt Fairlight ESP gt Tools and right click on MSAT and select Properties from the context menu Select the Shortcut tab and click in the Target text box Add the c command line switch to the end of the target comm
12. emote control via a RAPID application Tester Messages Tester messages include the control change events associated with the replay of au tomated scripts Clear MSAT Display 7 Click the Clear Window button to clear the message display Log File MSAT records all messages to a log file located at C Projects Mixers MSAT MSAT log txt The file can be viewed with the Notepad text editor but cannot be viewed while MSAT is running To view the log file while MSAT is running use the save as function described below If running multiple MSATs on the same machine the log file name will be appended with the channel number Log File Message Masks EE Click the Log File Message Mask buttons to enable the recording en Sys Para P ster of general messages system messages parameter messages or Test UsiNG MSAT 2 8 er messages as described above Log File Functions D Dg wr Tool bar buttons are available to clear the log file save a copy of the log file to another name and insert a text comment in the log file MSAT PARAMETER MONITOR Each Parameter Monitor provides on screen control and display of four pa rameters Select the signal path or module from the top list box Select the Module or path number from the second list box Finally select the parameter type from the bottom list box Refer to the RAPID reference document for details on all parameters and modules in the DREAM system Note that the parameter names displayed i
13. he machine running MSAT Do not insert a space before the number PIM 5 Command Line Click on the Start menu and select Programs gt Fairlight ESP Tools and right click on MSAT and select Properties from the context menu Select the Shortcut tab and click in the Target text box Add the c command line switch to the end of the target command line Add the h www xxx yyy zzz command line switch to the end of the target command line replace www xxx yyy zzz with the IP address of the machine running MSAT 2 6 Running Multiple MSATs Multiple instances of MSAT may be run on the same machine or network each uti lising a separate communications channel with its respective host application i e FMC or PIM 5 The channel number of each instance of MSAT is displayed in the MSAT window title bar Each instance writes to a separate log file whose file name is appended with the channel number The channel number must be specified in the c command line argument of MSAT FMC and PIM as described below MSAT Command Line Make a copy of the shortcut you are using to run MSAT Right click on the shortcut and select Properties from the context menu Select the Shortcut tab and click in the Target text box Add the cit command line switch to the end of the target command line Replace with the channel number e g MSAT exe c0 The default channel number is 0 Select the General tab and change the name of the shortcut to MSAT FMC or
14. iles from the Global script repository this feature is only for in house applications Local scripts are saved in C Projects Mixers MSAT Scripts This directory may be changed to any other directory In the File menu select Directory Path local En ter a path in the dialogue box and click OK Click the button with green arrow to the left of the drop down list to start script playback Click the button with the yellow bars to pause playback When paused click the button with the footstep to step through the script one line at a time Click the button with the black square to stop playback Script messages are played back and sent to EMC WAIT messages record or simulate the real time delay between performing actions on the control surface Play List Script Picker m To enable a list of scripts to be played back in sequence MSAT includes the script picker interface First select the source directory for scripts by clicking the Glb button or changing the local directory path by selecting Directory Path local from the File menu AUTOMATED TEST SCRIPTS USING MSAT Click the script picker button to displav the script picker window xl O Fridge4Software Mixers Releases Scripts er sn t T 7 Close i nesimake link op txi i o Ka AM Old Onestpateh D i t res Did Onesktitletest tat LI call link arps t t Patch ID bat O Copy of ttletest tat mem Loop Script txt make link grp txt patch 5 1 tst Move Item s Up titletes
15. leases To install the RAPID SDK run the RAPIDSDKI 0 exe self extracting archive MSAT is copied to the following directory C projects mixers msat MSAT VERSION To ensure that you are running a current version of MSAT check the version number by right clicking the filename in Windows Explorer and selecting Proper ties Select the Version tab to display the file version The version number is divid ed into four segments which indicate from left to right major version number minor version number build number and a reserved number ABOUT THIS MANUAL 2 1 NOTES 2 2 Chapter 2 Using MSAT MSAT OVERVIEW MSAT is a monitor system and automated testing application for use in trouble shooting fault diagnosis and system development MSAT exe is located in the C projects mixers msat In a standard DREAM installation there is a short cut to MSAT on the Windows desktop MSAT displays a scrolling list of parameter system and general messages generated by FMC or Plug Ins Manager Messages can also be recorded to a log file for future reference MSAT also provides a script playback system for automated testing and a parameter monitor panel for displaying and controlling individual mixer parame ters RUNNING MSAT MSAT communicates with the mixer application FMC or with Plug Ins Manager 5 via TCP IP MSAT may be run on the mixer PC SSM or another PC running Windows 2000 and connected via an ethernet network Multiple ins
16. line ua 2 4 OPEN i ii QI E hin ha aed 2 0 Operando ees E eris 3 2 OR icai v a 3 4 o uns esee sach a sd ees 2 2 P PARAMETER So te DU RS 3 2 Parameter Access sirios ote 3 3 Parameter Messages ti see es 2 7 Parameter Monitor 2 8 li IL PN ET EN E er 2 9 Play Lista ou dey 3 4 en das ar 2 10 Play Node i sesso tih ex hey ts 2 11 Playing Scripts ange 2 10 Program Control sie 24342424 3 5 R Random ss ne 2 11 RAPID SDR coi age Rees 24 1 2 READ PAR euren 3 3 READ VIEW 2 22 2044 bte 3 3 Recording Scripts cra 2 9 Recursive Scripts zu fa 3 6 Remote MSAT as gas u i ee Sats 2 5 Repeat ars ed be ies 2 11 Running MSAT es decides v kn 2 2 Rx Gon ueea pet ned EI 2 4 S Save Playlist s aan A uS 2 11 Script Picker S erae hood eas 2 10 Scripts iussa age 2 0 Set Parameter 2 9 SEL PAR iii ea 3 3 Single COM NER 2 11 SO Wind Gales 3 3 Status Bar 2 2 SUB tario 3 4 y E IN twal 3 2 System Messages 0 2 7 T TEPAPX e EES 2 2 2 4 Test Parameter 2 9 Test Scriots L 2 9 TEST PAR a bit ib ii es 3 3 FEST VIEW LS Lr ere 3 3 Veste ms Seed robe mem rua 2 7 Time Filter 2 10 Toolbar A Let asus haa ds O 2 2 RT 2 4 V Variables 3 2 NEO Hs ue dett EU ese td 1 2 VIEW ID 3 2 W WALL ini tto es 2 10 3 6 X XOR str A tte e eh 3 4 Index iii INDEX Index iv INDEX
17. n the MSAT Parameter Monitor do not include the R_ prefix that is used when calling RAPID functions uu Use the slider to adjust the parameter in real time or enter a value in the field below the slider and click Set to transmit the parameter to the mixer The Parameter Monitor will also display changes made to mixer parameters via the control surface in real time MSAT Parameter Monitor A MT RET si Mr Ap MSTR MT_CONFIG sl MT_AUTOMATION Module 1 v Module 1 si GP LVL FADER LEVE si Ier SRC SUR CENTR sl MP FRE FADERSET GP M amp ASSIGN y l H Figure 5 MSAT Parameter Monitor Window MSAT PARAMETER MONITOR 2 9 AUTOMATED TEST SCRIPTS UsiNG MSAT Test scripts are used in the production environment for qualitv control and mav also be useful during field servicing or general or regression testing MSAT supports automated test script recording and plavback Scripts mav be re corded from actions made on the control surface Scripts mav also be written with a text editor Refer to MSAT Script Syntax on page 3 2 for details of the scripting commands Recording Scripts ex Bezia wol To record a new script click on the button with the red circle Enter a new file name for the script in the New Test Script dialog box Bv default local scripts are saved to the CWProjectAMixerAMSAT Scripts directory To change the local directory select Di rectorv Path local from the File menu U
18. se the controls on the console surface to perform the functions you wish to record Click the square symbol to stop record ing Insert Pause Click the button with vellow bars to inset a Pause command in the script When plaved back the script will pause when the command is plaved back and wait for the plav button to be pressed Execute Script Click on the script button to insert a call to execute another script within the script which is currentiv being recording Select the script from the dialog box and click the Open button This feature provides a method of creating plavlists of several scripts It is important to avoid recursive scripts that call each other indefinitelv Insert Comment Click the note button to insert a comment into the script Set Get Test Parameter Logical tests mav be performed within scripts Use the Set Par button to displav the GET SET TEST PAR Statement dialog box Insert a GET PAR SET PAR or TEST PAR Statement x Step 1 Choose a parameter r Step 2 Choose Action r Step 3 Choose Value MT TRACK Set Parameter Var Name Vale 2 Get Parameter C Test Parameter GT Module 1 m Close GP LVL FADER LEVEL Select the module type module index and parameter name from the drop down lists at the left Select the action type with the radio buttons in the middle of the dialog box Enter a value or choose the variable name at the right and click Add to
19. t tat Patch ID tat Move Item s Dom O Patch Main Bus D outs tat O Patch Main Bus inserts txt Save Playlist CI tiletest txt O Unpatch Main inserts txt O VC Grouping tat z Play Pause E Stop Exit On Error Plav Mode C Single C Al Repeat Random The left hand panel displays available scripts Click in the check boxes to select the scripts to add to the play list Click the Add Items button to move the selected items into the play list in the right hand panel Double click on a script name in the play list to start playback of that script Select a script in the play list and click Remove Item to remove the script from the play list Use the Move Items Up Down buttons to change the order of the play items in the play list Click Save Playlist and enter a name for the list to save the play list for future use Play lists may be added to a play list Be careful not to make recursive lists Play Mode The script picker play mode options control play list execution Single mode plays the selected script and stops when it reaches the end of the script All mode plays through all the scripts in the play list and stops when it reaches the end of the last script in the list Repeat mode plays through all the scripts in the play list then returns to the top of the list and plays continuously Random mode continuously plays scripts from the list in a random order Play Indica
20. tances of MSAT may be run on the same machine each utilising a separate communications channel with its respective host application i e FMC or PIM 5 To start MSAT click on the short cut on the Windows desktop or click on the Start menu and select Run Type C projects mixers msat msat MSAT should be started before starting FMC as FMC initialises a number of important system functions at start up only Once the mixer application FMC is running hold down the Alt key and press the Tab key to switch to MSAT or the Windows desktop ns File View Help Toolbar gt Meg fan eere my ms mes an Pierre nw De note fii Tl Gen Sys Para Para Gen Sys Para Para m gt amp m itetestoa iem Set Set Get Test es BE ws in e SET PAR T TRACK 7 GP SU CH MUTE l SET PAR T TRACK 0 GP SW EQ IN l SET PAR T TRACK l1 GP SW EQ IN SET PAR T TRACK 2 GP SW EQ IN SET PAR T TRACK 3 GP SW EQ IN ster SET PAR T TRACK 4 GP SU EQ IN SET PAR T TRACK 5 GP SU EQ IN SET PAR T TRACK 6 GP SU EQ IN SET PAR MT TRACK 7 GP SU EQ IN WAIT 1000 fclose the project CHANGE_CONTROL CID_SW_IMPORT_PROJ 1 WAIT 500 CHANGE_CONTROL CID_SW_IMPORT_PROJ O WAIT 500 CHANGE CONTROL CID_SW_SOFTKEY 6 1 WAIT 500 CHANGE CONTROL CID SW SOFTKEY 6 0 Status Bar p Ready Packets Tx 6128 Rx 0 Figure 1 The MSAT Monitor System and Automated Testing Application Make sure the
21. ter 1 Introduction ABOUT THIS MANUAL This manual covers the installation and use of MSAT the Fairlight monitor system and automated testing application for DREAM The DREAM products are a range of digital recording editing and mixing systems for use in a professional audio pro duction environment MSAT is used by Fairlight support personnel test engineers and software developers for use in troubleshooting fault diagnosis and system de velopment MSAT can also be used by third party software developers working with the Fairlight RAPID remote application programming interface for DREAM This manual details the installation process for MSAT basic use of the software and includes a complete scripting reference INSTALLING MSAT MSAT is included with DREAM software releases for DREAM Station and DREAM Console The DREAM software installation places MSAT in the follow ing directory C projects mixers msat MSAT is included with Plug Ins Manager 5 Once PIMS has been installed a short cut to MSAT is located in the Windows START menu under Programs gt Fairlight ESP gt Tools folder MSAT is also included in the RAPID software development kit This includes a cut down DREAM software installation which includes the major software compo nents FMC MSAT ConsCon the RAPID software libraries plus the RAPID and MSAT documentation The RAPID SDK places all the software components in the a directory structure similar to the DREAM software re
22. tor Press the Play button to start playback of the scripts in the play list The play indi cator displays the current playback status Play Pause or Stop The indicator will show if a script has come to a PAUSE command or if playback has stopped Exit On Error The Exit On Error check box causes the playlist to stop when a TEST PAR or TEST VIEW command returns false When not checked MSAT continues to play past the error 2 12 AUTOMATED TEST SCRIPTS 3 1 NOTES 3 2 Chapter 3 MSAT Script Syntax GENERAL A script file is an ASCII text file typically written using an editor such as Windows Notepad Alternatively the script may be entered interactively using the MSAT script recording features described in Recording Scripts on page 2 9 This text file contains a number of instructions each instruction placed on a separate line Instructions exists for setting accessing and testing mixer parameters as well as con trolling the flow of the script using loops and simple IF statements Other instruc tions allow for simple calculations with assignments and basic math functions The scripts are normally executed at a speed of approximately 15 milliseconds per instruction but the execution can be delayed additionally using the WAIT instruc tion The script files reside in Projects MIXERS Msat Scripts or in the local directory specified under the File menu and must use the extension TXT OPERANDS The following
23. types of operands are available MODULE TYPE module types as defined in the RAPID Reference Manual PARAMETER parameter name as defined in the RAPID Reference Manual e CONTROL ID name of a control surface element as defined in the DeskC trlViewDefs h code module These operands are for internal testing purposes only not for use in RAPID applications VIEW ID name ofa control surface display element as defined in the DeskC trlViewDefs h code module These operands are for internal testing purposes only not for use in RAPID applications CONSTANT integer value specified in either decimal or hexadecimal prefix by notation e LC1toLC5 Loop counters with the outermost loop using LC1 the next using LC2 ect e VltoV5 Variables 1 to 5 COMMENTS Blank lines are allowed All lines starting with are treated as comments and are ignored GENERAL 3 3 PARAMETER ACCESS INSTRUCTIONS SET PAR module tvpe module index parameter id new value This instruction will cause the selected parameter in the mixer to take the new value The module index and parameter id will tvpicallv be constants as de fined in the MPD document READ PAR module tvpe module index parameter id variable This instruction reads the value of the parameter from the mixer and places it in the specified variable TEST PAR module type module index parameter id condition value Where condition is GT GTE EQ LTE LT or
24. very of such data Product features and specifications are subject to change without notice Fairlight ESP reserves the right to change any part of this document without notice The warranties remedies and disclaimers above are exclusive and take precedence over all others oral or written express or implied to the extent permitted by law in the geographical area of the product s use No employee of Fairlight ESP agent distributor or employee of an agent or distributor is au thorized to offer any variation from this policy Copyright O 2002 Fairlight ESP Pty Ltd Unit 2 1 Skyline Place French s Forest NSW 2086 AUSTRALIA Telephone 461 2 8897 9999 Fax 61 2 8897 9900 Table of Contents Chapter 1 Introduction ABOUT THIS MANUAL vem 1 2 INSTALLING MSAT 4 2422 42 04220004 1 2 MSAT VERSION e eoe de kx wo oce 1 2 Chapter 2 Using MSAT MSAT OVERVIEW ia card m 2 2 RUNNING MAAT 2 2 CONNECTING TO FMC OR PIM 5 2 3 Running MSAT on Local Machine 2 4 Running MSAT on a Remote Machine 2 5 Running Multiple MSATS 2 6 MESSAGE MONITORING AND LOGGING 2 7 Monitor Start Stop a ero m 2 7 Monitor Message Masks 2 7 Clear MSAT Display o cocida ee 4 2 7 LOPAEH Bu Leia c sem Mri ite PERS wid ay 2 7 Log File Message Maske 2 7 Log File Furict n usar Rem en 2 8 MSAT PARAMETER MONITOR 2 8 AUTOMATED TEST SCRIPTS 2 9 Recording Scripts Si r dr 2 9 Pl
Download Pdf Manuals
Related Search