9  Program TDEP : Transmit Data Editing Program


9.1 Introduction

With the program TDEP you can create or edit telegrams and send sequences.

9.1.1 Message buffer (transmission buffer)

A MessageBuffer can take in one telegram that can be later transmitted in the program SIMO.

On the whole 500 buffers  (0-499) are available; they can all be saved in a protocol- specific MessageBuffer-File (*.TDB).  

The user can save several messages in different TDB - files <File | save | Message> and load them again when required.

9.1.2 Send sequence (sequence)

A sequence describes a simple procedure and can take in up to 100 instructions ( line 0-99 ). Several  messages from different TDB-buffers <MessageBuffer> can be linked to a sequence. In order to control the transmission sequence you have a small set of commands at your disposal. A sequence is activated in the programm SIMO with the command <sf>.

The user can save several sequences in different TSB-files <File | save | sequence> and load them again when required. 

Apart from the disadvantage mentioned above, the fact that send buffers can only be edited to a certain extent in the program SIMO, the processing of send buffers and sequences under TDEP has the advantage that any number of send buffers and send sequences can be created in advance and saved in different files. In order to be able to use one of these files under SIMO, it must be loaded via TDEP (menu item <load | message or sequence>.  If you quit TDEP via <Quit>  or the key combination [Alt]-[X], the contents of the loaded file are automatically copied into the specific send buffer file (for transmission buffers) or SIMO.TSB (for transmission sequences = sequences) and is then available in SIMO

9.2 Function keys

[F1] Help on the current menu item.
[Alt]-[X] Quit programm TDEP 

9.3 Assignment of keys

9.3.1 Hotkeys

[F1] Help on the current menu item.
[F2] editing sequence

select send buffer for transmitting within a sequence.

[F3] editing buffer

read contents of the send buffer at the current cursor position

[F4] editing buffer

write the value read with [F3] into the send buffer at the current cursor position

[F5] editing buffer
editing sequence 
copy sequence buffer
copy sequence lines
[insert] editing sequence 

inserts a new line at the cursor position and shifts the following lines to the back.

The last line (99) gets lost!! 

[delete] editing sequence 

deletes the line at the cursor position and shifts the following lines to the front. 

At the end of the list (line 99) a blank line results.

 

9.3.2 Entry mask
[arrow right] Cursor right
[arrow left] Cursor left
[arrow down]
[Tab]
return

  
next field
[arrow up]
[Shift]-[Tab] 

previous field

[Enter]

[Esc]

quit entry mask

quit entry mask

Please note that the settings are subject to a plausbility check, that means only valid values can be set, otherwise the curser does not move. 

9.4 Menu commands

9.4.1 File

Under this menu item you can <load> and <save> <messagebuffer> and <sequence>, view the contents of <directory>, and quit  temporarily <Os-Shell> the program.

9.4.1.1 Load

Facilitates the loading of previously saved or already existing TDB-files <load | Message> or TSB-files <load | sequence>). 

9.4.1.1.1 Message buffer

Facilitates loading of a TDB-file (see <MessageBuffer>).

If you enter a DOS-wildcard ('*') in connection with a certain extension (default: '.TDB') instead of the file name, the TDB-files of the current directory are displayed. With the arrow keys you can select a certain file and load it with the Enter key.

If you want to view or select a directory other than the current one, you can also give a path in front of the file name.

Note:

The extension '.TDB' is not obligatory. However the program SIMO expects a particular file according to the telegram type selected for the respective channel; e.g. the file IECTCP1.TDB for the protocol 'IEC TCP 101'.

If you create different MessageBuffer-files for one protocol they have to be loaded with the program TDEP before running the program SIMO. 

TDB-files for each available protocol are included in the scope of supply.

9.4.1.1.2 Sequence

Facilitates loading of a TSB-file.( see <Sequence> )

If you enter a DOS-wildcard ('*') in connection with a certain extension (default: '.TSB') instead of the file name, the TSB-files of the current directory (KNF) are displayed. With the arrow keys you can select a particular file and load it with the Enter key.

If you want to view or select a directory other than the current one you can also give a path in front of the file name.

Note:

The extension '.TSB' is not obligatory. However the program SIMO expects the file SIMO.TSB. So if you create different sequence files they have to be loaded with the program TDEP before running the program SIMO.

9.4.1.2 Save

Facilitates saving of TDB-files <Save | Message> or TSB-files <Save | Sequences>

9.4.1.2.1 Message buffer

Facilitates saving of TDB-files (see <Messagebuffer>).

If you enter a DOS-wildcard ('*') in connection with a certain extension (default: '.TDB') instead of the file name, the TDB-files of the current directory (KNF) are displayed. With the arrow keys you can select a certain file and load it with the Enter key.

If you want to view or select a directory other than the current one, you can also give a path in front of the file name.

Note:

The extension '.TDB' is not obligatory. However the program SIMO expects a particular file according to the telegram type selected for the respec tive channel; e.g. the file IECTCP1.TDB for the protocol 'IEC TCP 101'.

If you create different MessageBuffer-files for one protocol they have to be loaded with the program TDEP before running the program SIMO. 

TDB-files for each available protocol are included in the scope of supply.

9.4.1.2.2 Sequence

Facilitates saving of a TSB-file. ( siehe auch <Sequence> )

If you enter a DOS-wildcard ('*') in connection with a certain extension (default: '.TSB') instead of the file name, the TSB-files of the current directory (KNF) are displayed. With the arrow keys you can select a particular file and load it with the Enter key.

If you want to view or select a directory other than the current one you can also give a path in front of the file name.

Note:

The extension '.TSB' is not obligatory. However the program SIMO expects the file SIMO.TSB. So if you create different sequence files they have to be loaded with the program TDEP before running the program SIMO.

9.4.1.3 Directory

Gives an overview of the available files in a directory.

The display can be specified with the usual DOS-wildcards. If you want to view a directory other than the current one you can give a path in front of the DOS-wildcards.

9.4.1.4 OS Shell

With this function you can quit TDEP temporarily. Enter EXIT into the command line in order to return.

 

9.4.2 Functions

Under this menu item you can <edit> , <convert> and <print> or view the <display on screen> of MessageBuffers and Sequences.

9.4.2.1 Edit

In principle, editing of the TDB-Buffer <edit | Message> and TSB-Buffer <edit | Sequence> doesn't differ from editing in the program SIMO. (compare Programm SIMO <SendMessage> commands 'sa' and 'If'). To the simplification  of editing more auxiliary functions are implemented over function keys.

9.4.2.1.1 Edit Message

This function corresponds to the command 'sa' in the program SIMO.

It puts out a list of <MessageBuffer>; from this you can select a buffer via the arrow keys. After pressing 'enter' you can select via a menu the telegram mask with which the buffer is to be allocated or edited. Thereby the data format of the mask depends on the type of telegram which has been parameterized for the current channel <Comport> in the program LIAN.

To the simplification of editing more auxiliary functions are implemented over function keys.

[F3]

load buffer for copying

With the arrow keys a message-buffer is selected and loaded with the function key [F3]. A window with the name of the loaded buffer is displayed. Now, a target-buffer, at its position should be set the message, is marked with the arrow keys. With the function key [F4]. The final saving of the loaded buffer is done with [F4].

[F4]

save buffer at a selected position

A buffer loaded before with [F3] is saved with [F4] at the current cursor-position. The saving can be repeated for different buffer- positions several times. This function is ended with the enter key and the message to editing submitted.

[F5]

copy buffer-ranges

With this function you can determine a buffer-range that should be copied to another buffer-position. Therefore a window is opened for entering values "start, end, to". 

Is the value end = 0 set, only one buffer is copied.

9.4.2.1.2 Edit sequence

This function corresponds to the SIMO command 'lf'.

A simple procedure can be defined with a sequence while the send buffers as well as the contained messages will be sent one after the other as a sequence. (e.g. <Function | edit | Message> ) 

The data entry field has the following format:

[line] :  [channel]  [buffer]

[Channel] indicates through which channel the telegram is to be transmitted. The field [Buffer] expects the number of the send buffer (corresponding to the list displayed via the command 'view') containing the desired telegram.

In the send sequence instructions can also be embed that control the run of the sequence. In this case the field [Channel] holds the command code and the field [Buffer] the parameter that might be needed.

[command code] [parameter] [function]
c nnnn

counter load

Loads the internal loop counter with the value 'nnnn'.

l 00zz

loop, jump to line zz

Decrements the internal loop counter and jumps to line 'zz'.

d nnnn

delay

Program run delay ( nnnn = 1 corresponds to 100 ms ).

g 00zz

go to line zz

Unconditional jump to line 'zz'.

s 00zz

call subroutine at line zz

Jump instruction to a subprogram beginning in line 'zz'. Subprograms cannot be nested.

r  

return

Jumps back to main program.

e  

end program

Ends transmission sequence.

The transmission sequence is saved and is available again, when you call next 'If'.

example:

00: c   0002
01: 1   0003
02: d   0005
03: l    0001
04: e   0000
05:

run through loop twice
transmit send buffer 3 on channel 1
wait 500 ms
jump to line 1
end

The message buffer 3 will be sent twice on channel 1 with a gap of 500 msec.

[F2]

select a send-buffer within a sequence

A list of <MessageBuffer> is displayed. With the arrow keys you can select a buffer. After pressing 'enter' the corresponding buffer-number is entered into the sequence. The cursor must be set on column "buffer".

[F5]

copy lines within a sequence

With this function you can determine a line-range that should be copied to another line-position. Therefore a window is opened for entering values "start, end, to". Is the value end = 0 set, only one line is copied. The cursor must be set on column "channel".

[insert]

insert line

Inserts a new line at the cursor position and shifts the following lines to the back. The last line of the list (line 99) gets lost with it The cursor must be set on column "channel".

[delete]

delete line

Deletes a line at the cursor-position and shifts the following lines to the front. At the end of the list (line 99) a blank line results. The cursor must be set on column "channel".

9.4.2.2 Convert

With this function, data records can be transferred from the archive into  the editing-buffers for messages.

Before this function can be used, a suitable archive file with data-records must be available. Since an archive contains up to 4 channels simultaneously, the monitoring channel, that means the recording channel-number, must be selected for the conversion.  The protocol must correspondent to the protocol of the current <ComPort>.

The input data  "from, to " refers to the number (1-n) of the data record in the archive.  It is beeing taken into account that the message buffer can store only 500 (0-499) messages. The messages are stored from input  "to" sequential into the following TDB-buffers.

If the archive-entry is activated with the pulse-width-measurement, also the time measurements in the archive are saved.. Consequently, also pulse-width messages PDM, as well as PCM can be loaded over this function.

Because of PC-overburden (measuring error) the archive-entry with the pulse-width-measurement should not be permanently activated. 

9.4.2.3 Print

The contents of the current <MessageBuffer> or  <Sequence> can be output either to <Screen> or to <printer>. 

9.4.2.3.1 Screen message

Displays the content of one or several <MessageBuffer>s being processed at the moment on screen.

The buffers are selected over their number under the determination 'from / til' according to the displayed list with the command <edit | message>.

9.4.2.3.2 Screen sequence

Displays the content of one or several lines of the <Sequence> being processed at the moment on screen.

The range of lines to be output is determined by their number under the determination 'from/til' ( according to the send sequence displayed with the command <edit | sequence>).

9.4.2.3.3 Print Message

Outputs the content of one or several <Messagebuffer>s being processed at the moment on a printer.

The buffers to be output are determined by the buffer number (according to the list displayed with the command <edit | message>).

9.4.2.3.4 Print Sequenz

Outputs the content of one or several lines of the <Sequence> being processed at the moment on a printer.

The range of lines to be output is determined by their number under the determination 'from/til' ( according to the send sequence displayed with the command <edit | sequence>).

9.4.3 ComPort

The data format of the <MessageBuffer> to be edited depends on the telegram type which has been parameterized in the program LIAN for the selected channel selected 

A '*' in the configuration window marks the channel being processed at the moment. 

9.4.4 Format

Here you can set the format of the translated output under <Function|Print>. To which channel the format settings should refer must be set before with <Comport>.

The menu command <Format> is connected with the menu item of the same name in the application SIMO and TRAP, i.e. the settings are always valid for both programs.

The following format options are available:

StatusHeader A status line with time of receipt is put in front of each telegram.
Hexadecimal Additional hexadecimal output of received data.
Decimal Additional decimal output of received data.
ASCII Additional output of received data as  ASCII characters.

 

Binary Additional binary output of received data
LSB
MSB
binary output of received data ( LSB first )
binary output of received data ( MSB first )

 

Plaintext    

Output of the telegram-specific format information. You can distinguish between format 1-3. Only for protocols with long messages (e.g.IEC protocols).

Format 1

Output of the complete message (Header + Information ).

Format 2

Output of header only.

Format 3

Output of information only.

The various options are switched on or off by means of the Enter key.

 

9.4.5 Options

9.4.5.1 Configuration

Indicates with which protocol type and data format each of the four channels is allocated.

An asterisk '*' marks the channel being processed at the moment.

9.4.5.2 Notebook

The notebook is a small editor with which you can make notes of the current session. The file size is fixed at 200 lines and 76 columns. Lines cannot be added or removed. With [F10] you exit the editor and store your input on hard disk in an ASCII file with extension ‘.pin’. The notebook can be called up in all program parts under menu item <Options | Notebook>).

 

9.4.6 Quit program TDEP

The currently processed sequence and send buffers are saved and the program TDEP is quitted.

 


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.