Instruction manual ENSITE Service Tool

Transcription

1 Instruction manual ENSITE Service Tool September 2007 Part no Rev. 3 Enraf B.V. P.O. Box AV Delft Netherlands Tel.: Fax: Info@enraf.nl Instruction manual ENSITE Service Tool Page 1

2 Copyright Enraf B.V. All rights reserved. Reproduction in any form without the prior consent of Enraf B.V. is not allowed. This instruction manual is for information only. The contents, descriptions and specifications are subject to change without notice. Enraf B.V. accepts no responsibility for any errors that may appear in this instruction manual. The warranty terms and conditions for Enraf products applicable in the country of purchase are available from your supplier. Please retain them with your proof of purchase. Page 2

3 Preface Preface This manual describes how to work with the service tool ENSITE. It has been written for the technicians involved in the commissioning and service of all Enraf equipment for tank gauging. The information in this manual is valid for ENSITE software version 2.2, which corresponds with the version number of this instruction manual (version 2.2). For commissioning and installation details, please refer to the related instruction manuals and installation guides. For an overview, refer to chapter Related documents. Safety and prevention of damage Notes have been used throughout this manual to bring special matters to the immediate attention of the reader. A Note points out a statement deserving more emphasis than the general text. Legal aspects The information in this instruction manual is copyright property of Enraf B.V., Netherlands. Enraf B.V. disclaims any responsibility for personal injury or damage to equipment caused by: Deviation from any of the prescribed procedures; Execution of activities that are not prescribed; Additional information Please do not hesitate to contact Enraf or its representative if you require additional information. Instruction manual ENSITE Service Tool Page 3

4 Table of contents Table of Contents Preface Introduction Changes with respect to software version ENSITE Service Tool - General ENSITE Windows Buttons Pull down menus ENCASE Windows Buttons Pull down menus ENOLE Windows Buttons Pull down menus ENVIEW Window Button Troubleshooting Printing Mouse ENSITE ENCASE ENVIEW Appendix A: Related documents Appendix B: Flow chart Service Tool Appendix C: ASCII table Page 4

5 Introduction Introduction ENSITE is a service tool for - commissioning - remote diagnostics - documentation of Enraf tank gauging equipment. Commissioning Diagnostics Documentation For commissioning, the service tool is equipped with a communication part to communicate with all field instruments. With the same communication part, error codes can be requested. A description of these error codes can be found in the implemented itemhelp. For each field instrument, all (scanned) data is stored in an individual directory, can be backed up and printed. Instruction manual ENSITE Service Tool Page 5

6 Changes with respect to software version 1.1 Changes with respect to software version 1.1 Type HELP as a command from the DOS prompt (e.g. C:\ENSITE>HELP ) to have the changes from version 1.0 to version 1.1. ENSITE modified shut down procedure of Ensite (ENSITE version 2.0) forced a setup mode by adding Comport selection and instrument/interface selection including 829 DataDIP (ENSITE version 2.0) added HART RS232 Adapter (ENSITE version 2.2) ENCASE added LOG script for instrument 829 DataDIP (ENSITE version 2.0) and 973 SmartRadar LT (ENSITE version 2.2) added Error script for instruments 829 DataDIP (ENSITE version 2.0) and 973 SmartRadar LT (ENSITE version 2.2) added support for communication via HART modem for 973 SmartRadar LT updated itemhelp to the latest revision of itemlist (November 2000) ENOLE added support for instruments 829 DataDIP (ENSITE version 2.0) and 973 SmartRadar LT (ENSITE version 2.2) Page 6

7 ENSITE Service Tool - General ENSITE Service Tool - General The service tool consists of five parts: ENSITE ENraf service tool SITE scan utility Use this part to scan the current site for available instruments. ENCASE ENraf Communication And Service Environment Use this part to communicate with the in ENSITE selected field instruments. ENVIEW ENraf service tool VIEWer utility Use this part to have a graphical view on response diagrams, generated by ENCASE. ENOLE ENraf service tool Off-Line Editor Use this part to edit log files, generated by ENCASE. ENPRINT ENraf service tool PRINT utility Use this part to print log files and response diagrams, generated by ENCASE. Windows/buttons Common buttons Save OK Cancel Although the service tool is a DOS operated program, it works with windows. Within these windows are buttons, on which the function is written. One of the characters on a button is highlighted. Throughout the service tool, common buttons are used. Their description is given once: ( Alt + S ) Press the Save -button to set the parameters, save it to hard disk and work with it accordingly. ( Alt + O ) Press the OK -button to set the parameters and work with it accordingly. ( Alt + C ) Press the Cancel -button to terminate the setting. The program returns to the previous window. Activate functions The function of a button can be activated in several ways: - mouse move the mouse pointer to the button and click the left mouse button - Alt -key press the Alt -key simultaneously with the highlighted character key of the text on the button - Tab -key press the Tab -key to scroll over all buttons. When the desired button is reached (highlighted), press the Enter -key Instruction manual ENSITE Service Tool Page 7

8 ENSITE Service Tool - General Pull down menus In the top line of all windows are pull down menus. For access of these menus, press function key F10, move with the arrow keys to select the desired pull down menu and press the Enter -key. Or press the Alt -key simultaneously with the highlighted character key of the pull down menu name. Bottom line commands In the bottom line of all windows are commands. Click on the topic with the mouse or press the mentioned function key or key combination to activate them. Page 8

9 ENSITE ENSITE Start ENSITE DOS Windows 3.1(1) Use this part of the service tool to scan the current site for available instruments. ENSITE can be started in the following ways (assumed is that the service tool is installed on drive C: in subdirectory ENSITE): type C:\>CD ENSITE type C:\ENSITE>ENSITE select pull down menu File select Run type in C:\ENSITE\ENSITE.EXE press OK Windows 3.1(1) (assumed: service tool icon is installed) double-click on the ENSITE icon Windows 95 press Start select Run type in C:\ENSITE\ENSITE.EXE press OK Windows 95 (assumed is that the service tool icon is installed) double-click on the ENSITE icon ENSITE start-up screen The following screen is shown: Instruction manual ENSITE Service Tool Page 9

10 ENSITE Select the communication port and press the OK -button to jump to the next screen: Select instrument/interface Select the communication interface and press the OK -button to jump to the next screen: Site scan screen This example site is given to experiment with the program without actual communication. Page 10

11 ENSITE Windows Available instr. This list box contains all available instruments found after a field scan. Each instrument line holds the following information: Interface Transm. Enraf Tank Note file Log file Checksum Checksum address address instr. code identifier prot. lev. 1 prot. lev. 2 x yy zzz TI N L C C XAMPLE - L x Interface address blank or one ASCII digit, from yy Transmission address two ASCII digits, from zzz Enraf instrument code three ASCII digits: 811 SLG, 813 MGT, 829 DataDIP, 854 ATG, 865 MESC, 866 SFPU, 872 RLG, 873 SmartRadar, 874 AIM, 875 FIU, 877 FDI, 894 (854) XTG, 973 SmartRadar LT TI Tank identifier six ASCII characters, copied from item TI. When TI is empty or not available (811, 813, 874 and 875), six dots will be displayed. N Note file one ASCII character: - no note file available N note file available L Log file one ASCII character: - no log file available l modified log file available L log file available C1 Checksum protection one ASCII character: C2 level 1 / 2 checksum not available x checksum in log file is not same as current checksum in instrument checksum in log file is same as checksum in instrument? log file is modified by ENOLE, but modifications are not send to instrument yet The checksum on protection levels is only checked for instruments which are equipped with the XPU-2 board and for the 829 DataDIP. Instruction manual ENSITE Service Tool Page 11

12 ENSITE Instrument display This list box shows the two display lines of the current selected (highlighted) instrument in the Available Instr. -list box. In case an 829 DataDIP is selected, this list box displays level and volume. Selected Instrument(s) This list box contains the selected instrument(s) to work with in ENCASE. Buttons Scan ( Alt + S ) Press the Scan -button to start a field scan. Before the field scan commences, a Scan setup -screen pops up: Scan setup Baudrate Port Interface Select a specific baudrate or select Auto Baud (only when connected to an 858 CIU) to let ENSITE find out. Select a communication port. Default, ENSITE selects the communication port, as selected at start-up. Select a specific address or select All to let ENSITE find out. Select None with communication through an 847 PET and to an XPU RS232 Channel or HART RS232 Adapter. With XPU RS232 communication, item BC (address byte for CIU emulation) can be enabled in the instrument. Then select the address of item BC for the Interface. Page 12

13 ENSITE Timeout Retries Enter here a time-out delay time (for modem and PET connection). Within this time, the field must answer to any request from ENSITE. Enter here the number of retries (for modem communication). Press the OK -button to commence the field scan. ENSITE will now scan the specified interface address(es) and next all connected instruments on the interface(s). After the scan is completed, the information will be saved and a file name (site name; up to 8 characters, no extension), is asked for. Changes like interface address, transmission address (item TA), tank identifier (item TI) or changes in the site configuration require a new site scan. Notes Format Save/print Log edit Add ( Alt + N ) Press the Notes -button to make, read and/or modify a (service) note file for the highlighted instrument in the Available instr. - list. When a note file is opened the first time, there is asked for confirmation. Select Yes, and the program jumps to a text editor. If a note file already exists, the text editor opens the existing note file. The note file has no pre described format, any important information can be written in the file. To save the note file, select from the top line: File and Save. To print the note file, select from the top line: File and Print. Press Alt + X to return to ENSITE. ( Alt + T ) Press the Log edit -button to start the editor program ENOLE where an available log file of the highlighted instrument in the Available instr. -list can be edited. ( Alt + A ) Press the Add -button to copy the highlighted instrument in the Available instr. -list to the Selected instrument(s) -list. Ctrl + A Press Ctrl + A to copy all instruments from the Available instr. -list to the Selected instrument(s) -list. All Press the All -button to copy all instruments from the Available instr. -list to the Selected instrument(s) -list. Ctrl + A Press Ctrl + A to copy all instruments from the Available instr. -list to the Selected instrument(s) -list. Instruction manual ENSITE Service Tool Page 13

14 ENSITE - Del ( Alt + D ) Press the - Del -button to remove the highlighted instrument from the Selected instrument(s) -list. Ctrl + D Press Ctrl + D to remove all instruments from the Selected instrument(s) -list. ENCASE Save C:\ENSITE\DAT ( Alt + E ) Press the ENCASE -button to start the communication program ENCASE to communicate with the instrument(s) from the Selected instrument(s) -list. ( Alt + V ) Press the Save -button to save the site file (again), also after the full site name is written in the text box Site (the length of this site name can be up to 33 ASCII characters). The following changes have been made in the directory structure (assumed is that the service tool is installed in C:\ENSITE): The subdirectory <sitnam>.sit has been created. C:\ENSITE\DAT\<sitnam>.SIT Instrument subdirectories have been created. In each of these directories the log files, error files, note files, and response diagrams of the related instrument are stored. C:\ENSITE\ECS C:\ENSITE\SIT The file ENSITE.BAK is added (back-up file), the file ENSITE.ECS is updated. The ENSITE program will always start up with the latest site information. The files: <sitnam>.bak and <sitnam>.sit have been added. Please observe that all characters, other than alpha-numeric, in file names are changed into an _ (underscore): TNK-01 becomes TNK_01, T+K-!? becomes T_K. Page 14

15 ENSITE Load ( Alt + L ) Press the Load -button to show the following screen: Restore tank list Restore tank list In this list box existing site file names are given. Use the arrow keys to select a file and press the OK -button or press Pull down menus To select a pull down menu, press the F10 -key or the Alt -key simultaneously with the highlighted character. = ( Alt + Space ) Use this menu to change the display settings: - Black and White Black and white monitor. - Monochrome Monochrome monitor. - Color Color monitor. - 25/43 Lines Toggle the size of the window between 25 and 43 lines. - Heap info on/off Toggle the display of the available conventional memory in the lower right corner of the screen (this has to be done each time the program is started). - Clock on/off Toggle the display of the current time in the upper right corner of the screen (this has to be done each time the program is started). Instruction manual ENSITE Service Tool Page 15

16 ENSITE File ( Alt + F ) Use this menu to do file specific things: - View... View the contents of an ASCII, *.DRD, *.Lxx, *.MMD and/or *.RD3 file. Select a *.DRD, *.MMD or *.RD3 file to start the program ENVIEW. - Print... Open a dialog box to select an ASCII, *.DRD, *.Lxx, *.MMD and/or *.RD3 file and to print this file (press the Print -button). - Close ( Ctrl + F4 ) Close the active site box. - Dos shell Leave the program temporarily to perform a DOS command or run another program. To return to ENSITE, type EXIT at the DOS prompt. - Exit ( Alt + F4 ) Exit ENSITE, remove it from memory, and return to DOS (or Windows). Communication ( Alt + C ) Use this menu to set up communication parameters. - Setup A dialog box will be opened where communication settings can be changed: Serial port setup Baudrate Port Select a communication baudrate. Select a communication port. Default, ENSITE selects the communication port, as selected with start-up. Page 16

17 ENSITE Ctrl + U Press Ctrl + U to have access to a wider range of communication and protocol parameters: Communication setup Baudrate Port Parity Databits Stopbit(s) Timeout Select a communication baudrate. Select a communication port. Default, ENSITE selects the communication port, as selected with start-up. Select a communication parity. Select the number of databits. Select the number of stopbits. Program the time in which the instrument should reply on the request. Turn around delay Program the time between the reply from the field and the next request to the field. Retries Prefix Suffix Program the number of times how often the request must be done in case the instrument does not reply. Program what precedes the request message to the instrument. Program what follows the request message to the instrument. - Select Interface This menu option has currently no function. Instruction manual ENSITE Service Tool Page 17

18 ENSITE Help ( Alt + H ) Use this menu to get support. - Contents Select this option to have a screen with the following possibilities: How to Use Help Menus and Hot Keys Editor Commands Errors Command line options Used file types - Index ( Shift + F1 ) The online Help system comes with a comprehensive alphabetic index. - Using help Use the online Help system from the Help menu or via hot keys. Wherever in the Service Tool, press F1 to show a Help screen about the currently active menu command or dialog-box item. - About This dialog gives information about the service tool. Double-click on ENSITE in the lower left corner of the screen to have the same result. Press OK or the Esc -key to go back. Page 18

19 ENCASE ENCASE Start ENCASE DOS Windows 3.1(1) Windows 95 Use this part of the service tool to communicate with the in ENSITE selected field instruments. Press the ENCASE -button in ENSITE to start ENCASE or use one of the following ways (assumed is that the service tool is installed on drive C: in subdirectory ENSITE): type C:\>CD ENSITE type C:\ENSITE>ENCASE select pull down menu File select Run type in C:\ENSITE\ENCASE.EXE press OK press Start select Run type in C:\ENSITE\ENCASE.EXE press OK The ENCASE program starts up in the Communication dialog [ENSITE.ECS]: ENCASE start-up screen Instruction manual ENSITE Service Tool Page 19

20 ENCASE Windows Receive Window Request and response Reply too long History Request In the top line of the Receive Window the highlighted instrument from the Selected instrument(s) -list from ENSITE is displayed. With this instrument communication is possible. The requested item is shown before the > and the response behind. At the end of the response line an & is shown to indicate that the command is received by the instrument. It replaces the ok message as was this command given by the PET (Portable Enraf Terminal). If the reply message is too long to fit in the receive window, as can be the case with indexed items, the remaining data can be observed via the following two ways: operate with the mouse the arrow right (and left) key at the lower right (and left) corner of the Receive window press the Tab -key till the Receive window is highlighted. Then press the cursor right (and left) key Move the up/down keys at the right hand side of the Receive window (either by mouse or by the Tab -key as described before) to look back at a maximum of 25 previous received records (this number is adjustable in the file ENSITE.ECS in the \ECS subdirectory). In the Request -box, the cursor blinks. Here, items can be typed in and commands can be executed as if they would be entered on a PET. Commands, other than the PET-commands, can also be given to let the service tool do something, e.g.: -?XX Request itemhelp for item XX. - &BIN Convert ASCII character to binary. - &CALL C:\XXXXXXXX.EXE Run, while ENSITE runs, another program. - &CHGLEVEL Enter a memory protection level (= function key 5 ). - &CLOG Request a response diagram and a log file (= function keys 1' and 3 ). - &EDIT Change, online, the setting of an instrument item. - &ERRMODE Toggle the display of error code descriptions on/off. - &ERROR Request actual error codes of the instrument (= function key 2 ). - &LOG Log all instrument memory settings to file (= function key 3 ). - &LOGEDIT Start off-line editor ENOLE to change instrument items. - &PREFIX Change the communication prefix (address, TOI and TOR). - &RESPONSE Request a reflection diagram from a radar gauge or request a response diagram from a DataDIP (= function key 1 ). - &RUN C:\ENSITE\ESF\xxxxxx.ESF Run script file called xxxxxx.esf. Page 20

21 ENCASE - &STATUS Request actual status of the instrument. - &TA Change the communication address to communicate (temporarily) with another instrument. - &UPDATE Send update script from off-line editor ENOLE back to instrument. Status Send to: This box shows the actual status of the last request or command given in the Request -box. With this selection box, an address selection is made for the request. - All When All is selected, the request will be send to all addresses where ENCASE currently can communicate with (all instruments from the Selected instrument(s) -list in ENSITE). Default, this selection is disabled. - Current When Current is selected, the request will be send to the address where ENCASE currently communicates with (the instrument indicated in the top line of the Receive Window ). Default, this selection is enabled. Itemhelp: With this selection box, the itemhelp to display can be selected. - BSTG When BSTG is selected, press the F2 -key to open the itemhelp for the BSTG instruments (854, 873, etc.). Depending on the in ENSITE selected communication interface, this selection is default enabled. - SSTG When SSTG is selected, press the F2 -key to open the itemhelp for the SSTG instrument (DataDIP). Depending on the in ENSITE selected communication interface, this selection is default disabled. Buttons Function keys A row of function keys, marked 1 to 9, can be found left from the Receive window. The default setting of these function keys is: 1 - Response 2 - Error 3 - L:og 4 - Send Log 5 - ChProtLv Instruction manual ENSITE Service Tool Page 21

22 ENCASE To (re)program these function keys, select pull down menu Setup and select Function keys. 1Response Reflection diagram Response diagram File construction 2Error File construction 3Log Script file File construction ( Alt + 1 ) With function key 1 a response diagram can be made (873 / 973 SmartRadar (LT): reflection diagram, 829 DataDIP: response diagram). A reflection diagram is a graphical display of the actual reflection over the total tank height. The measured data is stored in the instrument s subdirectory with filename TIxx.RD3. A response diagram is a graphical display of the actual capacitances over the total tank height. The measured data is stored in the instrument s subdirectory with filename TIxx.DRD. Both above mentioned files are constructed as follows: TI tank identifier (item TI) xx : the higher the number, the more recent copy of the original file extension: RD3 (Reflection Diagram of an 873 or 973) DRD (DataDIP Response Diagram) ( Alt + 2 ) With function key 2 all current error codes of the selected instrument can be requested (829 DataDIP, 854 ATG/XTG, 873/973 SmartRadar (LT) and 877 FDI only). The error codes are stored in the instrument s subdirectory with filename: TIxx.Enn, in which: TI tank identifier (item TI) xx : the higher the number, the more recent copy of the original file Enn extension: where nn = last two digits of the instrument code, like 54 for 854 ATG ( Alt + 3 ) With function key 3 a log file can be made. In a log file all relevant items of an instrument are automatically requested and stored in the tank subdirectory. As each type of instrument has a different set of items, there is a unique script file for each type of instrument. The correct script file, with the proper set of items, is automatically chosen for the selected instrument shown in the top line of the Receive window. The log file is stored in the instrument s subdirectory with filename: TIxx.Lnn, in which: TI tank identifier (item TI) Page 22

23 ENCASE xx : the higher the number, the more recent copy of the original file Lnn extension: where nn = last two digits of the instrument code, like 54 for 854 ATG 4Send Log ( Alt + 4 ) With function key 4 a previous made log file can be send back to the instrument. 5ChProtLv Script ( Alt + 5 ) With function key 5 any memory protection level can be entered. The program will ask which level to enter. When the answer is given, the program tries the default password to enter the protection level. If the default password is rejected, the program will ask to type in the correct password. Once in a protection level, type EX to return to normal operational level. ( Alt + T ) Press the Script -button to open a communication dialog to select an available script file from the \ESF subdirectory. Press the Esc -key to cancel a running script. Then, the interruption must be confirmed. Depending on the instrument, the following script files are possible: - xxxlog.esf Make a log file (=function key 3 ) from the selected instrument; xxx can be: 811 (811 SLG), 813 (813 MGT), 829 (829 DataDIP), 854 (854 ATG), 865 (865 MESC), 866 (866 SFPU), 872 (872 RLG), 873 (873 SmartRadar), 877 (877 FDI), 894 (854 XTG) or 973 (973 SmartRadar LT). - xxxstat.esf Make a status request from the selected instrument; xxx can be: 829 (829 DataDIP), 854 (854 ATG), 873 (873 SmartRadar), 877 (877 FDI), 894 (854 XTG) or 973 (973 SmartRadar LT) DRD.ESF Make a DataDIP response diagram (= function key 1 ) STRDN.ESF Download a DataDIP strap file (ENSITE -> DataDIP) STRUP.ESF Upload a DataDIP strap file (DataDIP -> ENSITE). - xxxmmd.esf Make a min/max diagram from the selected instrument; xxx can be: 873 (873 SmartRadar) or 973 (973 SmartRadar LT). - xxxrfd.esf Make a reflection diagram (= function key 1 ) from selected instrument; xxx can be: 873 (873 SmartRadar) or 973 (973 SmartRadar LT). - CHGLEVEL.ESF Enter a memory protection level (= function key 5 ). - CLOG.ESF Make a response diagram and log file (= function keys 1 and 3 ). - EDIT.ESF Change, online, the setting of an instrument item. - ERROR.ESF Make an instrument error codes request (= function key 2 ). - MAKECFG.ESF Create file AUTOCFG.SYS in the SYS-directory (which will be called while running an ECS-file). Instruction manual ENSITE Service Tool Page 23

24 ENCASE - MODEM.ESF Dial telephone number for modem communication. - SENDLOG.ESF Download instrument log file (= function key 4 ). - UPDATE.ESF Download update script from off-line editor ENOLE back to instrument. Record Split Restore default Update Log edit Select ( Alt + R ) Press the Record -button to create an ASCII-file that contains the actual communication (request and reply). Press the Record -button again to stop creation of the ASCII file. ( Alt + P ) Press the Split -button to split the Receive window into two parts. Data from a pre-defined file is now shown in the top window. To (re)program this data, select pull down menu Setup and select Instrument display items. Press the Split -button again to change the Receive window to its default size. ( Alt + A ) When back from ENOLE, the log file on the system may differ from the log file in the instrument. Then, the changed items have to be send back to the instrument. To do this, by press the Update -button. ( Alt + D ) Press the Log edit -button to start the editor program ENOLE where an available log file of the current instrument can be edited. ( Alt + L ) Press the Select -button to select one of the selected instrument(s) (from ENSITE) to communicate with. Then a list appears, and with the -cursor keys the required instrument can be selected: Select instrument Page 24

25 ENCASE Instrument(s) Select an instrument to communicate with. Back on the ENCASE desktop (press the OK -button), all communication parameters are set to communicate with the selected instrument. Back ( Alt + C ) Press the Back -button to quit ENCASE and to go back to ENSITE. Press Alt + F4 to have the same result. Close F2 ( Alt + C ) Press the Close -button to quit ENCASE (when ENCASE is started directly and/or not via ENSITE). Press Alt + F4 to have the same result. Press the F2 -key to start the implemented itemhelp (this can also be done from the DOS prompt (e.g. give the command C:\ENSITE\HELP ITEMHELP ). With the ( Shift +) Tab -key, the first character of the desired item can be highlighted, with the Enter -key the selection can be confirmed. Press Alt + F1 to show the previous selected help screen. Press the Esc -key to quit the itemhelp. Item index Next, the desired item can be selected: Instruction manual ENSITE Service Tool Page 25

26 ENCASE Items listed Finally, a description of the selected item is shown: Item description Pull down menus To select a pull down menu, press the F10 -key or the Alt -key simultaneously with the highlighted character. = ( Alt + Space ) Use this menu to change the display settings: - Black and White Black and white monitor. - Monochrome Monochrome monitor. - Color Color monitor. Page 26

27 ENCASE - 25/43 Lines Toggle the size of the window between 25 and 43 lines. - Heap info on/off Toggle the display of the available conventional memory in the lower right corner of the screen (this has to be done each time the program is started). - Clock on/off Toggle the display of the current time in the upper right corner of the screen (this has to be done each time the program is started). File ( Alt + F ) Use this menu to do file specific things: - View... View the contents of an ASCII, *.DRD, *.Lxx, *.MMD and/or *.RD3 file. Select a *.DRD, *.MMD or *.RD3 file to start the program ENVIEW. - Close ( Ctrl + F4 ) Close the active site box. - Change Dir... Bring up the Change Directory -dialog box to change the current directory. - Print... Open a dialog box to select an ASCII, *.DRD, *.Lxx, *.MMD and/or *.RD3 file and to print this file (press the Print -button). - Dos shell Leave the program temporarily to perform a DOS command or run another program. To return to ENSITE, type EXIT at the DOS prompt. - Delete Displays the 'Delete File'-dialog box. In this dialog box the file to delete can be selected. - Exit ( Alt + F4 ) Exit ENSITE, remove it from memory, and return to DOS (or Windows). Instruments ( Alt + I ) - Open... Displays the Open a File -dialog box. In this dialog box an instrument specific ECS-file can be selected. The communication dialog that will be opened by this selection needs those parameters to configure the serial port, predefined buttons, prefix, suffix etc. Options ( Alt + O ) - Files/Path... Opens a dialog box where the subdirectories of the Service Tool can be changed. To keep the changes, press the Save -button. Instruction manual ENSITE Service Tool Page 27

28 ENCASE Setup ( Alt + S ) Use this menu to change the port settings, instrument display items and the function keys: - Port settings A dialog box will be opened where the communication settings can be changed: Serial port parameters Baudrate Port Ctrl + U Select a communication baudrate. Select a communication port. Default, ENCASE selects the communication port, as selected with start-up. Press Ctrl + U to have access to a wider range of communication and protocol parameters: Communication setup Baudrate Select a communication baudrate. Page 28

29 ENCASE Port Parity Databits Stopbit(s) Timeout Select a communication port. Default, ENCASE selects the communication port, as selected with start-up. Select a communication parity. Select the number of databits. Select the number of stopbits. Program the time in which the instrument should reply on the request. Turn around delay Program the time between the reply from the field and the next request to the field. Retries Prefix Suffix Program the number of times how often the request must be done in case the instrument does not reply. Program what precedes the request message to the instrument. Program what follows the request message to the instrument. - Instrument display items In this dialog, up to six continuously scanned items can be programmed: Instrument display set Each item, supported by the current instrument, can be programmed here (also indexed items). Instruction manual ENSITE Service Tool Page 29

30 - Function keys In this dialog, up to nine function keys can be programmed: Function keys setup ENCASE In the left column, Button Text, up to 8 characters can be typed in to indicate the function of the button. In the right column, Command, the actual command can be described which will be activated with the button to match. Help ( Alt + H ) Use this menu to get support. - Contents Select this option to have a screen with the following possibilities: How to Use Help Menus and Hot Keys Editor Commands Errors Command line options Used file types - Index ( Shift + F1 ) The online Help system comes with a comprehensive alphabetic index. - Errors This dialog displays the possible communications errors and their meaning. - Using help Use the online Help system from the Help menu or via hot keys. Wherever in the Service Tool, press F1 to show a Help screen about the currently active menu command or dialog-box item. - About This dialog gives information about the service tool. Double-click on ENCASE in the lower left corner of the screen to have the same result. Press OK or the Esc -key to go back. Page 30

31 ENOLE ENOLE Start ENOLE Use this part of the service tool to edit log files, generated by ENCASE (with function key 3 ). To start this program, press the Log edit -button either in ENSITE or in ENCASE. The program starts up with the contents of the latest log file of the selected instrument: ENOLE start-up screen Windows Item name, Item, Value This window contains a list of all logged items, grouped per subject. The window is divided in three columns: item name, item and value. - Item name This column gives a short description of the item. In front of this description may be one of the following characters: read only item this item cannot be changed in ENOLE read/write item this item can be changed in ENOLE > edited item this item is recently changed in ENOLE - Item This column gives the two character abbreviation of the item. - Value This column gives the current setting of the specific item. Instruction manual ENSITE Service Tool Page 31

32 ENOLE Edit Use this window to change the setting of the item(s). Press the Edit -button or use the mouse to bring the cursor in this window. After this, the value can be overwritten. Buttons Save Cancel Edit ( Alt + S ) Press the Save -button to leave ENOLE and to go back to ENSITE or ENCASE, keep the changes (generates an update script). ( Alt + C ) Press the Cancel -button to leave ENOLE and to go back to ENSITE or ENCASE, not to keep the changes. Press the Esc -key to have the same result. ( Alt + E ) Press the Edit -button to switch from the Item -window to the Edit -window. F2 Press the F2 -key to start the implemented itemhelp (this can also be done from the DOS prompt (e.g. give a command C:\ENSITE\HELP ITEMHELP ). With the ( Shift +) Tab -key, the first character of the desired item can be highlighted, with the Enter -key the selection can be confirmed. Press Alt + F1 to show the previous selected help screen. Press the Esc -key to quit the itemhelp. Item index Page 32

33 ENOLE Next, the desired item can be selected: Items listed Finally, a description of the selected item is shown: Item description Pull down menus To select a pull down menu, press the F10 -key or the Alt -key simultaneously with the highlighted character. = ( Alt + Space ) Use this menu to change the display settings: - Black and White Black and white monitor. - Monochrome Monochrome monitor. - Color Color monitor. Instruction manual ENSITE Service Tool Page 33

34 ENOLE - 25/43 Lines Toggle the size of the window between 25 and 43 lines. - Heap info on/off Toggle the display of the available conventional memory in the lower right corner of the screen (this has to be done each time the program is started). - Clock on/off Toggle the display of the current time in the upper right corner of the screen (this has to be done each time the program is started). File ( Alt + F ) Use this menu to do file specific things: - Open... Displays the Open a File -dialog box. In this dialog box the text file to browse in a file viewer can be selected. - Exit ( Alt + F4 ) Exit ENOLE, remove it from memory, and return to DOS (or Windows). Help ( Alt + H ) Use this menu to get support. - Contents Select this option to have a screen with the following possibilities: How to Use Help Menus and Hot Keys Editor Commands Errors Command line options Used file types - Index ( Shift + F1 ) The online Help system comes with a comprehensive alphabetic index. - Using help Use the online Help system from the Help menu or via hot keys. Wherever in the Service Tool, press F1 to show a Help screen about the currently active menu command or dialog-box item. - About This dialog gives information about the service tool. Double-click on ENOLE in the lower left corner of the screen to have the same result. Press OK or the Esc -key to go back. Page 34

35 ENVIEW ENVIEW Start ENVIEW ENVIEW-command View more diagrams Use this part of the service tool to have a graphical view on response diagrams, generated by ENCASE (function key 1 ). This viewer will automatically start after completion of the script file. Once in the viewer, press the Esc -key to quit. Select an earlier made response diagram (with extension.drd,.mmd or.rd3) via pull down menu File and View in ENSITE and/or ENCASE. To view response diagrams directly from the DOS-prompt, use the ENVIEW-command: locate where the ENSITE-directory is - e.g. C:\ENSITE log in into the ENSITE-directory - type in C:\>CD ENSITE type in C:\ENSITE>ENVIEW [path]\[file].drd or type in C:\ENSITE>ENVIEW [path]\[file].mmd or type in C:\ENSITE>ENVIEW [path]\[file].rd3 To view more response diagrams in one go, use a wildcard instead of a specific file name: type in C:\ENSITE>ENVIEW [path]\*.drd or type in C:\ENSITE>ENVIEW [path]\*.mmd or type in C:\ENSITE>ENVIEW [path]\*.rd3 Instruction manual ENSITE Service Tool Page 35

36 ENVIEW Window A graphical file will be displayed full screen. Reflection diagram Min/max diagram Page 36

37 ENVIEW Button F1 Press the F1 -key to open a help screen with information about the function of some keys: F1 help screen F2 display all (X-axis to maximum data elements) F3 display 0 - tank bottom (equal to default program entry) F4 display actual ullage + and - three units F6 screen mode colour / black and white F7 linear interpolation on/off F8 grid on/off F9 obstruction zones on/off F10 print screen / increase / decrease scale X-axis with one unit / increase / decrease Y-axis with one unit ( Shift +) Tab (decrease) increase offset X-axis with one unit gray + / - zoom in / out Esc quit ENVIEW Instruction manual ENSITE Service Tool Page 37

38 Troubleshooting Troubleshooting Type HELP as a command from the DOS prompt (e.g. C:\ENSITE>HELP ) to have the latest information. Printing - Graphics.com Type C:\ DOS\GRAPHICS DESKJET to make the GRAPHICS.COM file (for HP-printers) resident. - Windows 95 To make graphical printouts might give problems, when ENSITE runs under Windows 95. Therefore it is wise to generate a screen dump (press Alt + PrintScreen ), paste it in a text editor (e.g. WordPerfect, Word, etc.) and print it from there. Mouse - Mouse on COM1 To operate the mouse in ENSITE may give problems. Therefore, change the port setting of the CIU from COM1 to COM2 in ENSITE.ECS in the \ECS subdirectory. ENSITE - Communication If communication with the field is not possible, first the physical connection between the PC and the field should be checked. If the field connection is alright, but communication is still not possible, the communication settings in the setup should be checked. - Modem and With communication through a modem or through the PET interface, PET interface the instrument display may contain strange characters (like <ACK>, <STX> etc.). It is recommended to increase the value behind DisplayTimeout in the file ENSITE.ECS (which can be found in the \ECS subdirectory). Page 38

39 Troubleshooting ENCASE - Communication If communication with the field is not possible, first the physical connection between the PC and the field should be checked. If the field connection is alright, but communication is still not possible, the communication settings in the setup should be checked. - Communication errors 0000 = no error 1060 = not enough label space 0001 = fifo full error 1061 = label not found error 0002 = fifo empty error 1062 = system variable not found 0004 = no command error 1063 = out of range error 1000 = function not allowed error 1064 = no time error 1001 = no direct cmd error 1065 = subroutine stack error 1002 = unknown keyword error 1066 = script handler stack overflow 1003 = null token error 1067 = script handler stack underflow 1004 = unknown operator error 1089 = variable handler stack overflow 1005 = reached maxapplications error 1090 = variable handler stack underflow 1006 = object does not exist error 1068 = max var reached error 1011 = msg buffer overflow 1069 = illegal operation error 1012 = unknown function error 1070 = expression syntax error 1013 = illegal function error 1071 = could not add variable error 1014 = buffer empty error 1072 = divide by zero error 1015 = illegal state error 1073 = stack fault 1016 = msg not ready error 1074 = var not found error 1017 = msg ready error 1075 = could not create var 1018 = response bcc error 1076 = incorrect assignment var 1030 = no request error 1077 = invalid expression 1031 = device not found error 1078 = invalid varname error 1032 = device wrong type error 1079 = invalid execution label 1033 = invalid parameter error 1080 = comm port opening error 1034 = file not found error 1081 = comm port closing error 1035 = script already running error 1082 = max allowed devices reached error 1036 = script already stopped error 1083 = filehandle not found error 1037 = script not running error 1084 = invalid devicehandle error 1038 = invalid filename error 1085 = devicehandle inuse error 1039 = file closing error 1086 = data conversion error 1040 = end of script error 1087 = ready error 1041 = begin of script error 1088 = not ready error 1042 = invalid destination error 1089 = check bcc error 1043 = no message error 1091 = comm port parity error 1044 = file opening error 1092 = comm port frame error 1045 = file io error 1093 = comm port overrun error 1046 = max log files reached error 1094 = comm port commdrv error 1047 = no free file number error 1095 = communication line error 1048 = time out error 1096 = expression islitteral error 1049 = response prefix error 3001 = illegal drive name 1050 = response suffix error 3002 = illegal directory name 1051 = retry request error 3003 = syntax error 1052 = response timeout error 3004 = lifo full error 1053 = script timeout error 3005 = lifo empty error 1054 = illegal environment type 3006 = memory error 1055 = script file opening error 3007 = memory allocating error 1056 = access denied error 3008 = parameter range error 1057 = heap allocation error 3009 = illegal assignment error 1058 = invalid filehandle error 3010 = function parameter error 1059 = begin not found error 5001 = user canceled error Instruction manual ENSITE Service Tool Page 39

40 Troubleshooting 6000 = file rename error 9985 = expression syntax error = wait turnaround 9986 = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = expression syntax error = script iflabelerror 9984 = expression syntax error 15 - Function keys Some function keys run script files. This sometimes results in an error: File access error. This error indicates, that the directory structure on hard disk does not exist (in ENSITE, press the Scan -button). ENVIEW - F10 or PrintScreen To make a printout of the current window, function key F10 will send a command directly to LPT1: to print the current window. With this command, ENVIEW will reverse the contents of the window and then print it. If the GRAPHICS.COM is made resident with the option /R, ENVIEW will reverse the reversed contents of the window and then print it, this will result in a dark to black paper. To avoid this and save the printer cartridge, use the PrintScreen -key instead of function key F10. Page 40

41 Appendix A Appendix A: Related documents Title Installation guide ENSITE service tool Instruction manual 811 servo driven level gauge Instruction manual Mechanical Gauge Transmitter Type U 813 MGT Instruction manual 847 Portable Enraf Terminal Instruction manual series 854 ATG level gauge Instruction manual series 854 XTG level gauge Instruction manual series 858 Communications Interface Unit Instruction manual series 865 Multiplexer Instruction manual series 866 HIMS Instruction manual series 872 RLG radar level gauge Instruction manual 873 SmartRadar Instruction manual series 874 AIM / 875 FIU Instruction manual series 877 FDI Field Display & Interface Instruction manual CIU Prime type 880 (CIU858 emulation) Instruction manual 973 SmartRadar LT Instruction manual ENSITE Service Tool Page 41

42 Appendix B Appendix B: Flow chart Service Tool Page 42

43 Appendix C Appendix C: ASCII table Instruction manual ENSITE Service Tool Page 43

44 _ Page 44