III Model session

 

The following model session is to illustrate the operation of the single LIAN-programs. The aim is to transmit a telegram on channel 1, to record the reception data on channel 2 by employing a pre-trigger, and to analyse the reception data afterwards. 

 

In this example we use the protocol IEC 60870-5-101.

 

CDE-adapter settings
Connect channels 1 and 2 and set both CDE switches for PCM.

The setting of the CDE adapter is only possible for the LIAN-DOS variants Large, Siemens oder ABB. For the IEC variant this setting is inapplicable.

 

 LIAN parameterization
1. Setting the data output parameters

Go to menu item <Settings> and press the Enter key. Activate  menu item  <ProtocolFileName>

The default of the file name for the protocol file appears: C:\LIAN\PRO\TEST.PRO. For our example we change the name and enter C:\LIAN\PRO\EXAMPLE.

The file extension pro does not have to be entered, because LIAN adds it by itself. Press [Enter] in order to confirm the entry.

The same is valid for the archive file (ArchivFileName).

Under <ComPort/Channel> we set channel 2 (in this case channel 1 is of no interest, as the following settings concern the handling of the reception data and in our example channel 1 is the transmission channel). If the following parameters Channel enable, DisplayOnScreen, OutputToArcFile and OutputToProFile should happen to be switched for no, please switch them for yes by pressing the Enter key (as our example does not provide for a transmission with extraordinarily high baud rates, it is not necessary to switch off one of these recording modes). Now please press [Esc] in order to quit the menu item again.

 

2. Setting the channel-specific parameters

Set channel 1 under <ComPort> (in our example the transmission channel). Then go to IEC Standard. After confirming the selection, you choose <IEC TCP 101 under the available protocols. The setting possibilities now being offered are of lower importance for this example, they only have to correspond to the parameterization of the reception channel. Now press [Esc] in order to take on the settings.

Set under <ComPort> channel 2, the reception channel. Repeat the same procedure as for the parameterization of the first channel. Return to the main menu by pressing the Enter key twice.

We suggest to check the correspondence of the parameters on channels 1 and 2 via the menu item <Options | Configuration> once again.

 

Program FIPP : Definition of pre-filters and -triggers

 

 

Activate the menu item <Run> and start Program  FIPP. Press character F in order to activate the menu item <Filter>

 

 

Now press the tabulator key until the cursor is on the field Filter unlocked for channel 2 and open the channel by entering 'y'. Then move the cursor to the field Monitoring filter below. Here enter 'y' again. Via the filter mask shown now you can filter the recording for the second channel according to certain criteria. Enter e.g. '=' under function. The field on its right now expects the number of the function to which the recording under SIMO is to be limited, e.g. '03'. Press [F10] in order to leave the filter mask, once again [F10] in order to return to the main menu again, and finally [Q] in order to quit FIPP.

 

 

Program SIMO : Transmission and receipt of telegrams

Transmission of telegrams or the execution of a sequence is done afterwards in the program SIMO. Single telegrams can be send once, multiple or cyclic. Transmission data can be written down into the archive-file when required, to make noticeable the connection between transmitted and received data. 

 

 

Activate again menu item <Run> and start program  SIMO. 

Before SIMO is started, LIAN would like to know, if the recording files already existing are to be deleted. If you do not want this, confirm via n and enter a file name under which the recording is to be continued.

Now set channel 1 under <ComPort>. This channel will then appear as prompt under <Sendmessage>.  Then activate <Format> and set channel 2 under <ComPort / Channel>  (the following settings refer to the output format of the reception data in the zoomed window and are therefore only significant for our reception channel). The single options can be turned on and off via the Enter key.

Under <Sendmessage> we can now change to the actual task of transmitting. After you have activated the menu item, the command window is opened and a prompt appears, i.e. the number of the set channel (in our case it should be 1; if not, simply enter 1 and press [Return]). Now enter 'zoom2' and press [Enter] in order to scale up the output field of the second channel, so that the reception data become visible in the way they were set under <Format>.

Now select a transmission buffer via the command 'sw'. If you know which buffer you want to transmit, e.g. buffer 5, simply enter 'sw5' (you can first take a look at the content to check via 'sq5'). Otherwise you get a list of the 500 message buffers via 'sw'. If you have once selected a buffer, 'sq' displays the content of this buffer.

 

 

When editing the buffer with 'sa' a window with a protocol-dependent editing mask opens. In order not to lose track with 500 editing buffers you can add a comment to the buffer. 

Via 'sz' the telegram is transmitted cyclically. You have the possibility to send up to 28 telegrams within one job if you enter the corresponding buffer numbers : e.g. sz0,2-5,7,9. The buffers 0, 2 till 5, 7 and 9 now are sent cyclically. 

Generate a few errors during transmission (part the adapter or set the CDE switch for PDM), so that entries take place into the protocol file.

Press the [Alt]-key once, while the archive file is slowly being filled. If you press it for about one second, a information line with hot keys appears at the bottom of the screen, e.g. [Alt]-[F10], in order to open the BackScrollWindow. It offers you the possibility to overview the received data of all channels parallel to the recording  The data are sorted after time independent of the channel. 

The recording runs without restriction in the background. With [Alt]-[F10] the window is closed again. 

Enter 'kill' in order to end the transmission process. Make sure that the current channel corresponds to the transmission channel. Press [Esc] to quit the command level and return via Quit [Q] to the program LIAN.

During transmission you can also operate other commands, e.g. edit send buffers or transmission sequences. How to write a transmission sequence (sequence), is described in detail further below (Editing of a sequence or telegram buffers: TDEP).

 

Program SHOW : Display the list of errors

 

 

In order to view the transmission errors entered into the protocol file, activate the application Show. First an entry window is opened, into which you can enter the wanted protocol file. As a default, the name of the current protocol file appears here; confirm it via [Return].

You can now scroll through the file via the Arrow keys or search for a certain time or a certain error via the function <Search>. You can as well limit the display of the complete file to certain parameters.

Note: Press [F1] to activate the Online-help. Read the help text to assignment of keys and protocol-file.  

Assuming you only want the headlines to be put out, activate the menu item <Display> move the cursor down to channel 2 (our reception channel) and enter 'y'. The selection for this channel is activated. Then deactivate all other options except the one you want to keep (H) via 'n'. After pressing the Enter key the selection is done.

Via [Alt]-[X] you can quit SHOW again.

 

Program TRAP : Analysis

As soon as you have started TRAP, a window appears down on the right of the screen; the window informs you how many data records there are in the loaded archive file (TRAP automatically loads the current archive file, which had been entered during the parameterization in LIAN). Press any key in order to get to the main menu.

1. Setting the output format

The menu item <Format> is linked with the menu item <Format>  in the program SIMO,  that means you will find the settings carried out in SIMO in TRAP, too. In the following image plaintext 1 (Header and information) is set. 

 

2. Analysis

Under the menu item <Run> you have several possibilities to carry out the translation or analysis of the archive file. First select the option <Disk> and press [Return]

Now activate the menu item <Show> in the main menu. Confirm the indicated file name via [Return]. You can now view the single data records in the translated archive file. 

The other possibility to view the archive file, namely the command <Run | Screen> has the disadvantage that the file can only be viewed from top to the bottom. 

Press [Alt]-[X] or [q] to quit  TRAP.

 

Program TDEP : Editing of telegrams and creating sequences

The program TDEP is available for creating coupled redcords (telegrams). With it you can edit, copy, save and load or output to screen or printer telegrams and send sequences comfortably. A sequence can be described in a simpe pseudo language and can contain up to 100 program lines. The program run of a sequence contains instructions as e.g. loops with the corresponding loop counter, subroutine calls, delays or send-instructions for the particular channels. 

Return again to the menu item <Run> and start the application TDEP. Aktivate menu item  <Function | Edit | Telegram or sequence>.

Editing of telegrams

A list of all available send buffers appers when selecting  <Function | Edit | Telegram>. Via arrow keys you can select the telegram buffer to be edited. By pressing [Return] a telegram-specific mask opens in which the required data can be entered. 

Create a transmission list

Activate the menu item <Function | Edit | Sequence>. An entry window subdivided by lines is opened. In the following you will see a transmission sequence constructed as an example; each line contains a comment:

line command value description
00 1 0045

send

The send buffer 45 is transmitted on channel 1.

01 2 0004

send

The send buffer 4 is transmitted on channel 2.

02 c 0005

counter

The loop counter is loaded with the value 5. A loop consists of this allocation, a string of instructions and the following repetition of this string from the line in which the command 'l' for 'loop' appears (see below in line 06). You may only once per sequence allocate a value to this counter, as every further allocation replaces this value.

03 1 0046

send

The send buffer 46 is transmitted on channel 1. 

04 2 0006

send

The send buffer 6 is transmitted on channel 2. 

05 d 0010

delay

The execution of the sequence is interrupted for 10 x 100 msec.

06 l 0003

loop

This command is similar to the goto-command 'g'; the sequence is continued in the indicated line (here line 3). Differently from the goto-command, the loop counter 'c' (see above) is reduced by one with each call of the loop command; the loop resulting from this is then so often run through until 'c' has reached the value 0.

07 1 0047

send

The send buffer 47 is transmitted on channel 1. 

08 2 0008

send

The send buffer 8 is transmitted on channel 2. 

09 s 0015

subroutine

This command causes the program to continue the transmission sequence in line 15. The sequence defined there is processed until the command 'r' (return) appears. Afterwards the transmission sequence is continued in the line following the command 's'. These so-called subroutines are especially suitable for making complex transmission sequences clear.

10 d 0050

delay

The execution of the sequence is interrupted for 50 x 100 msec.

11 g 0000

goto

This command carries out an unconditional jump to the indicated line (0). It is suitable e.g. for ignoring certain single sequences of the whole sequence for a short time

12 e 0000

end

This command marks the end of the sequence.

... ... ... Beginning of the SubRoutine
15 2 0005

send

The send buffer 5 is transmitted on channel 2. 

16 2 0007

send

The send buffer 7 is transmitted on channel 2. 

17 2 0009

send

The send buffer 9 is transmitted on channel 2. 

18 r 0000

return

Jumps back to the calling 's'-command.

Via [Esc] you can quit the entry mask again. The sequence is saved automatically. If you now start the program SIMO and enter 'sf' into the command line this sequence is transmitted.

Note

If you want to create several transmission sequences, go to the menu item <File | Save | Sequence> first and press the key [F1]. You will then receive notes on the creation of several sequence buffer files.

 

If there are problems, on-line help (F1-key) is provided for every menu item..

 If you have any further questions, please phone us. We will try to help you in any way we can. And if you have suggestions for improvements - please let us know!

 


MAYR Software

Wuerzburger Ring 39,  D 91056 Erlangen

Manual LIAN DOS


LIAN DOS Protocol Simulator and Analyzer
© Copyright 1991, 1996, 2001, 2006-2010 by Werner Mayr. All Rights reserved.