******************************************** Tester for Windows Script Examples (c) Costain Group PLC. 2008 ******************************************** This README file contains the latest information about Tester Script Examples package TABLE OF CONTENTS ----------------- - Introduction - Installation - Scripts - Future Developments - Known Issues - Support & Feedback -------------- INTRODUCTION -------------- The script examples package has been designed to demonstrate Tester's extensive scripting language and allow operators to design their own scripts to automate testing, commissioning or fault diagnosis. Many of Tester's functions already make use of the scripting features making the software very dynamic and expandable. We recommend that anyone interested in designing their own scripts should review the examples. -------------- INSTALLATION -------------- IMPORTANT: Tester 3.40 has to be installed on the target system before proceeding. The script examples package installs automatically from the HA Maintenance Tools CD. To install the package, insert the HA Maintenance Tools CD into the drive and the setup program should launch automatically. If Auto-Run has been disabled, run the setup.EXE from your CD-ROM drive (e.g. D:\setup.EXE). To access the installed scripts, simply run Tester and click "F6" to display a link selection diaglog. Select "Transponder-SIGN Link" to enter Script Mode or "Subsystem-SIGN IP Link" to enter IP Script Mode. Choosing either selection should automatically display a script selection dialog. Once you have selected the script, you may execute or single step through it if no syntax error exists. The Script Viewer can be used to view and debug any loaded script. Please note that scripts can be run in IP Script Mode are prefixed with "ip_" and those can be run in Script Mode are prefixed with "serial_". PLEASE SEE THE USER MANUAL FOR ADDITIONAL DETAILS. --------- SCRIPTS --------- * IP Auto Configuration: Script demonstrates how to configure an IP address at runtime and inform the operator of the changes in IP scirpt mode. * IP Bad Assignments: Script demonstrates how to generate assignment errors and relvant syntax errors at runtime and inform the operator of the changes in IP scirpt mode. * IP Command Expressions: Script demonstrates the use of basic statements with complex expressions in IP scirpt mode. * IP Dialogs: Script demonstrates all the dialogs that can be displayed during script execution for operator input, confirmation and for simple notification in IP scirpt mode. * IP Events & Event Details: Script demonstrates the use of the event viewer by generating every type of event in IP scirpt mode. * IP Expressions: Script demonstrates complex expressions, variables and operator precedence in IP scirpt mode. * IP IF/Then: Script demonstrates the if/then statement using the DISPLAY to output debug data in IP scirpt mode. * IP Logging: Script demonstrates the available logging and printing functions in IP scirpt mode. * IP Operators: Script demonstrates language operators as well as non-trivial expression in IP scirpt mode. * IP Runtime Errors: Script demonstrates all the possible runtime errors can be generated in IP scirpt mode. * IP RX/TX Arrays: Script demonstrates how to access both the transmit and receive arrays in IP scirpt mode. * IP Sequences & No Step: Script demonstrates the use of fast sequence and no step flags for time critical operations in IP scirpt mode. IMPORTANT: Do not use this script under Windows 98. * IP Sign Types: Script demonstrates how to detect sign type configuration in IP scirpt mode. * IP Statistics, Dynamic Arrays and Counters (Variables): Script demonstrates dynamic statistics, arrays and counters in IP scirpt mode. * IP Sub Scripts: Script demonstrates sub script execution including nested script calls in IP scirpt mode. * IP Syntax Errors: Script demonstrates all the possible syntax errors can be generated in IP scirpt mode. * IP Variable Substitution: Script demonstrates variable substitution and associated formatting in IP scirpt mode. * Serial Auto Configuration: Script demonstrates how to configure an address at runtime and inform the operator of the changes in scirpt mode. * Serial Bad Assignments: Script demonstrates how to generate assignment errors and relvant syntax errors at runtime and inform the operator of the changes in scirpt mode. * Serial Command Expressions: Script demonstrates the use of basic statements with complex expressions in scirpt mode. * Serial Comms Test: Script demonstrates user input, runtime serial re-configuration and a time limited routine in scirpt mode. * Serial Dialogs: Script demonstrates all the dialogs that can be displayed during script execution for operator input, confirmation and for simple notification in scirpt mode. * Serial Events & Event Details: Script demonstrates the use of the event viewer by generating every type of event in scirpt mode. * Serial Expressions: Script demonstrates complex expressions, variables and operator precedence in scirpt mode. * Serial IF/Then: Script demonstrates the if/then statement using the DISPLAY to output debug data in scirpt mode. * Serial Logging: Script demonstrates the available logging and printing functions in scirpt mode. * Serial Operators: Script demonstrates language operators as well as non-trivial expression in scirpt mode. * Serial Runtime Errors: Script demonstrates all the possible runtime errors can be generated in scirpt mode. * Serial RX/TX Arrays: Script demonstrates how to access both the transmit and receive arrays in scirpt mode. * Serial Sequences & No Step: Script demonstrates the use of fast sequence and no step flags for time critical operations in scirpt mode. IMPORTANT: Do not use this script under Windows 98. * Serial Sign Types: Script demonstrates how to detect sign type configuration in scirpt mode. * Serial Statistics, Dynamic Arrays and Counters (Variables): Script demonstrates dynamic statistics, arrays and counters in scirpt mode. * Serial Sub Scripts: Script demonstrates sub script execution including nested script calls in scirpt mode. * Serial Syntax Errors: Script demonstrates all the possible syntax errors can be generated in scirpt mode. * Serial Variable Substitution: Script demonstrates variable substitution and associated formatting in scirpt mode. * Additional Scripts: * IP Script 7: Script constantly displays messages in IP script mode to test the pause script function. * Serial Script 7: Script constantly displays messages in script mode to test the pause script function. * Serial Script 11: Script generates 2000 logs in script mode to test that if more logs are added, the old logs will be deleted. * Serial Script 12: Script sets and tests EMI407 on address 001 and sets EMS2x12 on address 002 once in script mode for monitor mode testing. * Serial Script 13: Script sets and tests EMI407 on address 001 and sets EMS2x12 on address 002 in an endless loop in script mode for monitor mode soak testing. --------------------- FUTURE DEVELOPMENTS --------------------- In the next script package release we are hoping to include a great number of additional language examples as well as more complicated commissioning, fault diagnosis and reporting scripts. -------------- KNOWN ISSUES -------------- * Please do not use the "Fast Sequence & No Step" script under Windows 98 as it can cause system instability. -------------------- SUPPORT & FEEDBACK -------------------- However if you experience any problems, usability issues, need help with script authoring or have any comments for future developments please let us know by contacting us: Costain Group PLC Unit 12, Market Industrial Estate Yatton, Bristol, BS49 4RF Tel: (01934) 838803 Fax: (01934) 876202 E-mail: technologysupport@costain.com