Setr.exe

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

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.

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

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:

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