Setr.exe

https//www.racom.eu/eng/support/utils/setr.html

Print version

2. Setr.exe

This is a powerful tool for manually or semi-automatically setting parameters, diagnosis and maintenance of the MORSE network. By means of the terminal type menu (MORSE main menu) it can control all CU services. A detailed description is provided in MORSE Firmware Documentation. Button macros and hot keys can also be used to control SETR.

2.1. Macros

A group of Setr commands can be incorporated into a macro and then launched with Setr running using command :

!mname Enter

where name is the name of the file with the macro. For example, below is a macro which sets up the frequency and output and reads the resulting values:

# example of macro xfreq.mac
!l^M
Q^M
Rpe^M
T4264750^M
R4264750^M
lA^M
wY^M
IY^M
SY^M^M

The macro is launched using command !mxfreq Enter. It uses Setr commands supplemented by  ^M meaning Enter. Other symbols used:

^M - Enter
~  - delay 1/2 sec
^S - Net Service Call mode (default)- 
     waits for confirmation of command execution
^D - Net Direct mode - does not wait for confirmation
^X - end of operation and continuation with next address
#  - note

If the name is generated in the following manner the macro may also be launched, for example, using button F1:

#This is an example, how to create a macro for keys CTRL/ALT/SHIFT F1..F10
#Macro file names are generated as follows:
#xxx_af01.mac for key ALT-F1
#xxx_cf10.mac for key CTRL-F10
#xxx_sf03.mac for key SHIFT-F3
#xxx__f04.mac for key F4

The macro – example for return to the local address and into Main menu:

The macro file name    xxx__f01.mac
The content of file    !l^M
                       Q^M
The file location      in the directory, where Setr.exe is
Calling the macro      from running Setr by F1 key

2.2. Default macro

The default macro is designed to set up default parameters in the CU.

Macro xfac.mac

Macro xfac.mac employs the Setr command f(a)ctory setting, which inscribes default parameters in S-RAM memory for all menus (in the case of CU MR25 the parameters are written to FLASH memory). Next the macro sets the middle power level 7 in the menu Rpe and clears Frequency off(s)et. The Art tables and routing tables are cleared. Finally the macro restarts the CU and in this way the default parameters are copied from S-RAM memory into computing memory. The macro is designed first of all for working with the local connection and hence it sets local mode as its first step.

The macro is named xfac.mac and can be found at www.racom.eu, Support>Firmware>Configuration macros or Download>Software Manuals>Utils Default macro. File xfac.mac is located in Setr´s current directory and is launched in Setr using command !mxfac.

Macro xde.mac

Macro xde.mac is more complicated but it offers additional possibilities for modifications. It successively visits all menus and sets them with default parameters and stores them to RAM and to S-RAM. Finally using command sgB it resets the CU. Below is an example of part of the memory:

# Default Ne
#
Q^M       ...return to MORSE Main menu
NfY^M~    ...insert default parameters to RAM
NwY^M~    ...insert default parameters to S-RAM

# Default Rpe # NOT ACTIVE #
#
#Q^M
#Rpe^M~
#fY^M~
#s0^M~
#l7^M~
#wY^M~    ...frequency and power settings remain unchanged

The macro can be modified as required, for example, by removing the six # symbols for menu Rpe it can also be set to default. It is recommended, for a CU without an ETH module, to use the # symbols for blocking the work of the last paragraph of the macro, which presets the ETH module.

Macro xder.mac

In the CU with firmware 9.0.0.0 and higher macro xder.mac can be used. This is a version of the macro xde.mac which uses fewer idle periods and runs much faster.

2.3. Batch files

For simplifying application control, especially upon repeated use, it is possible to prepare batch files. The following example shows the following operations:

  • submission of the prepared mac2.mac file for control

  • storage of the original CU configuration

  • setting of the default parameters in the CU

  • entering of new address

  • starting of setr

Batch file config1.bat :

echo off
echo check the address prepared in the macro mac2.mac
type mac\mac2.mac

echo STOP macro using Ctrl+C
echo storing original configuration in the file
pause 1
netcnf -aU -x

echo entering default parameter
pause 1
setr -cg.\mac\mac1.mac -x

echo entering new address
pause 1
setr -cg.\mac\mac2.mac -x

echo starting Setr for further work
pause 1
setr

rem  you can continue the work with SETR

The macros used in the batch file:

  • File .\mac\mac1.mac

    # entering default parameter except for tables
    Q^M
    ca^M
    Q^M
    sgB^M~~~~~~~~~~
  • File .\mac\mac2.mac

    # entering new address
    Q^M
    Ne^M
    1a690F0004^M
    w^M
    I^M
    Q^M

2.4. Parameters for Setr.exe

  1. Common – see section Section 1.2.4, “Common parameters for all applications”

  2. Special -cg, -df, -dp

    Calling CU group :

    setr -dfnnn -cgxtest.mac

    Setr successively call addresses listed int he file .\net\nnn.txt and at each executes commands of macro xtest.mac.

    setr -df -cgxtest.mac

    If the name of the file is not stated after parameter -df, setr looks for file .\net\anynet.txt and calls the addresses contained in it.

    Example of macro nnn.txt, which calls addresses 02, 03, 07 :

    690F0002
    690F0003
    #690F0005
    690F0007

    Example of file xtest.mac , which reads the version of firmware in individual modems :

    Q^M
    sv^M

    Calling with a path packet:

    setr -dp.\net\ppp.ttt -cgxtest.mac

    Setr calls to the destination address determined by file.\net\ppp.ttt according to the rules for the path packet.

    setr -dpppp.ttt -cgxtest.mac

    Setr uses file ppp.ttt located in the setr directory.

    setr -dp -cgxtest.mac

    Setr uses file path.txt located in the setr directory.

    Example of file ppp.ttt for calling from address 1101 via address 5505 to address 3303 for the case where the connection between these addresses is not configured in routing tables:

    690F1101
    00000000
    690F5505
    00000000
    690F3303
    690F3303

2.5. Shortcuts for pro Setr.exe

With SETR running you may call up help by pressing Alt+Z:

Terminal mode help:
F1...F12 .................. User defined macros
Alt-S .............................. Ascii send
Alt-G .............................. macro list
Alt-I ................... Initialize connection
Alt-O ............................... Pull jack
ALT-A ............................... Save path
Alt-R ............................. Use SerCall
Alt-P .............................. Parameters
Alt-B ............................. Scroll back
Alt-L .......................... Capture toggle
Alt-X .................................... Exit
.............. GUI version only ...............
Alt-C .......................Scroll lock ON/OFF
Alt-M/m .... Mark position before/after current

The meaning of main abbreviations:

Alt+I  initialization of connection PC-SETR
Alt+P  put the parameter into running SETR
Alt+B  displays containing SETR operations done till now
Alt+L  start/stop capture of operations into chosen file
Alt+C  stop/start screen refresh
Alt+X  stop SETR

©  2024 RACOM s.r.o. All Rights Reserved.