PC-ALE

MMI User Guide

Released xx-xx-15

DRAFT v0.1
Very Rough, little more than notes at present!

PC-ALE
Man Machine Interface (MMI)
User Guide
For v1.08 Build 1.0.0.0
POC for this document is:

N2CKH

Support site:

https://groups.yahoo.com/neo/groups/PCALEDOCS/info

1
PC-ALE
MMI User Guide
Released xx-xx-15

OVERVIEW

The Man Machine Interface (MMI) is a command interpreter that processes structured
scripting commands as single or multiple lines of commands loaded by the application
either automatically or by user direction from specific file types (.DAT, .MAC, .OPS or
.QRG) or user entered single line commands via the multipurpose DataBar. PC-ALE
executes MMI commands to bring about either configuration or operational command
and control.

MMI commands are not case sensitive and when used in the specific system file types
(.DAT, .MAC, .OPS or .QRG) are created or edited using an ASCII editor. An MMI
command can be used to generate a single line or multiple lines of commands. In some
cases, MMI commands can accept one or more arguments on a single line.

There are a number of specific system .DAT files that exist in the same directory as the
PC-ALE .EXE which are used to execute MMI commands at specific points in the
programs execution. However the ALE.DAT is not one them, it is the main database file
for the application which contains all configuration parameters, it is only mean for access
by the application and is in a non-published binary format, subject to change with each
new build of PC-ALE. At program start, if the ALE.DAT file does not exist, one will be
created automatically with default settings for all parameters. If on the other hand one
does exist, but its format differs from that of the build of PC-ALE running, it will be
deleted and overwritten with a new one having all default values.

The MACRO (.MAC) files are optional in that they do not need to exist as they are only
executed by the user and not automatically. A .MAC file can be named anything,
however it is recommended that naming conventions that spell out their purpose be
utilized. All .MAC files must reside in the \MACRO\ sub directory under where MARS-
ALE is installed to be executed using via the DataBar or any Command Line Interface.
The use of the MACRO button when it exists opens in the \MACRO\ directory by default
by allows for navigation to any location containing a .MAC file for execution.

If the user configured and loaded by the user manually (.QRG or other naming
conventions) and commands entered by the user from within the tool via the DataBar
Command Line Interface (CLI) within PC-ALE or via the Telnet interface from an
external Telnet client or 3rd party application as a single line command. It is also planned
to add user configured multi-line macros where the user will assign functions to be
performed on demand.

2
PC-ALE
MMI User Guide
Released xx-xx-15

MMI Commands Added to PC-ALE v1.076 extracted from release notes text file

1. Added MMI RADCMD Command.

Command Syntax: RADCMD [Argument1..Argument5]

To make use of RADCMD the user MUST know the syntax of CAT commands for their
radio.

The RADCMD supports direct user control of radio at program start (using the new
CONFIG.DAT file) to pre-configure the radio for best ALE operating parameters and
program shutdown (using the new SHUTDOWN.DAT file) to exit ALE radio
configuration settings. It also supports adjusting the radio parameters after an ALE link
when going over to a third party follow on protocol or while monitoring single channel
activity to allow for the selection of receiver features not directly supported in normal
PC-ALE operation such as filter selection, passband tuning, RIT etc. at any time by using
the DataBar MMI interface or the new MACRO MMI command to file off user created
MACRO files of MMI commands.

However RADCMD (and HEXRADCMD which follows ) will not support direct user
control of all make/model radios supported by PC-ALE as some require polling and other
aspects that can only be addressed properly via full automation. In addition some radios
that only support the use of radio memory channel operation and do support direct
frequency and or mode chances via PC control will need to controlled via this interface
the same way, memory channel selection.

Also, the user will need to provide for any make/model radio that requires a check sum or
CRC field that is not optional that piece of information as required for the radio to
respond to the command. As PC-ALE is running and is sending any make/model radio
that requires a keep alive signal, said signal, the user need not worry about that aspect for
such radios as the Kachina 505DSP, Harris RF-350K etc. and for such radios the use of
the MMI SET TRANSMIT ON and SET TRANSMIT OFF command rather than the
direct radio PTT commands will also result in sending the appropriate keep alive signal
during PTT ON.

I originally coded RADCMD into MARS-ALE some time ago as an undocumented

command for my personal SIGINT uses of MARS-ALE to allow for control of my
TCI8174 receiver which has no manual interface. For radios that have no manual
interface or are locked out when under PC control this addition to PC-ALE is very useful
for the single channel utility monitor or when engaged in various types of follow on ALE
communications.

PC-ALE DataBar TEXT field use:

3
PC-ALE
MMI User Guide
Released xx-xx-15
The MMI box must be checked on the DataBar.

Then RADCMD is entered in the DataBar TEXT box followed by radio commands either
as one string or with spaces as required for the sending of more than one command word
at a time as long as no termination such as Line Feed or Carriage Return or non printable
characters are required prior to the end of the TEXT entry.

The last Argument to the RADCMD can represent one or two Line Feed characters or
one or two Carriage Return characters or a Line Feed and Carriage Return by the use of
LF1 or LF2, CR1 or CR2 and LFCR.

The RADCMD as it currently exists will not support all radio types as some require
complex data commands and some require ACK/NAK handshaking. However it will
support the bulk of radio make/models that use command syntax that are mostly ASCII
based strings.

Example of sending both Frequency to a Kenwood radio as one message where the semi-
colon termination is used, first the data entered into the TEXT box:

radcmd FA00010000000;

The message displayed to the Engineering Window after executing the command and
argument:

[00:36:27][FRQ 10000000][MMI CHANGE: Sent radio command FA00010000000;]

The entering of FA00010000000; represents a single Argument to RADCMD and the

radio.

Here is the captured data sent to the radio:

FA00010000000;

Example of sending both Frequency and Mode to a Kenwood radio as one message
where the semi-colon termination is used for each command to the radio , first the data
entered into the TEXT box:

radcmd FA00010000000;MD2;

The message displayed to the Engineering Window after executing the command and
argument:

[00:36:27][FRQ 10000000][MMI CHANGE: Sent radio command

FA00010000000;MD2;]

4
PC-ALE
MMI User Guide
Released xx-xx-15
The entering of FA00010000000;MD2; represents a single Argument to RADCMD, but
two arguments to the radio as the semi-colon is the termination for the radio.

Here is the captured data sent to the radio:

FA00010000000;MD2;

Example of sending Frequency to a Ten Tec RX-340 where a carriage return termination
is required, the data that is entered into the TEXT box is:

radcmd $1F 10.000000 cr1

The message displayed to the Engineering Window after executing the command and
argument:

[04:11:12][FRQ 10000000][MMI CHANGE: Sent radio command $1F 10.000000 CR1]

The entering of $1F 10.000000 CR1 represents three Argument to RADCMD but just one
to the radio as the termination for the radio is the Carriage Return.

Here is the captured data sent to the radio:

$1F 10.000000#0D

NOTE: It does not matter if the commands and arguments are entered in Upper or Lower
case as all lines without double quotes (") are converted to upper case for execution.

If you need to send a radio commands in mixed case and or with spaces mixed in the
command, for example the TCI series of receivers command set which uses mixed case
then you need to encase the command string for each argument in double quotes (") as
with this example that sets a TCI-8174 to 10Mhz AM

radcmd "{Af10000000 }{AeL1 }"

To set just the TCI8174 frequency to 10Mhz you would send:

radcmd "{Af10000000 }"

To just change the TCI8174 mode, say to LSB you would send:

radcmd "{AeL4 }"

NOTE: User's of a third party program such as an Amateur Digital Mode program which
supports a Telnet interface can access PC-ALE after an ALE link for follow on and
control the radio or other resources using existing MMI commands where all the MMI

5
PC-ALE
MMI User Guide
Released xx-xx-15
commands use via Telnet must be proceeded by "CMD " and CMD must be in Upper
Case for example:

CMD radcmd "{AeL4 }"

Another command of interest when using a third party program for follow on that
supports Telnet connections would be the MMI radio PTT ON/OFF command, for
example:

CMD set transmit on

and

CMD set transmit off

If the third party program allows for the selection of sending a telnet command for PTT
ON and PTT OFF then whatever means of PTT being used by PC-ALE for the radio will
be accessible by the 3rd partly program as long as PC-ALE RESOURCES have not been
released.

NOTE: User's of MARS-ALE should not experiment with the existing release using the
RADCMD as although it is present, the interface differs from what I have detailed herein
as these details are current and will be in the next release of MARS-ALE.

2. Added HEXRADCMD MMI Command.

Command Syntax: HEXRADCMD [Argument1..Argument30]

To make use of HEXRADCMD the user MUST know the syntax of CAT commands for
their radio.

HEXRADCMD supports sending HEX bytes to radios such as ICOM and old TEN-TEC
models, older YAESU models and others.

The process of using HEXRADCMD is similar to the use of RADCMD except that each
byte of the of the radio command must be entered as a HEXRADCMD Argument, which
requires a space character must be inserted between each data byte of the radio command.

HEXRADCMD also supports the sending of command to radios that used a mixture of
printable and non-printable characters, a good example being Cubic receivers which
require one or more start bytes that are non-printable, followed by the receiver address
and command and then a command terminator byte.

To set the frequency on a Cubic R3030 receiver that requires three start bytes mixed of
characters

6
PC-ALE
MMI User Guide
Released xx-xx-15
would like this when sent to the radio where the pound (#) sign represents the two
characters that follows to be a HEX byte:

#02#02#0201F01200000#0D

Broken down there are three start bytes: #02#02#02

The R3030 address: 01

The frequency information: F01200000

The radio command string termination: #0D

The same radio command string represented in HEX would be:

#02#02#02#30#31#46#30#31#32#30#30#30#30#30#0D

To send this to the R3030 you would enter:

hexradcmd 02 02 02 30 31 46 30 31 32 30 30 30 30 30 0D

Here are some examples for ICOM and YAESU models that take into account the actual
ICOM radio model HEX address, when using HEXRADCMD you can substitute 00 for
the actually radio address you are directly sending these commands to the radio. Thus for
the ICOM 746PRO examples below you would change the third byte which is the radio
address from 66 to 00 for the address, 00 is the ICOM universal listener address to send
the same to command to all devices on the bus if you were using more than one radio at a
time.

Set ICOM 746PRO to USB at 14.109Mhz:

hexradcmd FE FE 66 E0 05 00 90 10 14 00 FD FE FE 66 E0 06 01 FD

Set ICOM 746PRO to USB at 14.109Mhz:

hexradcmd FE FE 66 E0 05 00 90 10 14 00 FD

Set ICOM 746PRO to USB:

hexradcmd FE FE 66 E0 06 01 FD

Set ICOM 746PRO to LSB:

hexradcmd FE FE 66 E0 06 00 FD

Set ICOM 746PRO to USB-D:

7
PC-ALE
MMI User Guide
Released xx-xx-15

hexradcmd FE FE 66 E0 06 01 FD FE FE 66 E0 1A 06 01 FD

Set ICOM 7200 to USB-D: (NOTE: USB-D/LSB-D selection differs with 7200 vs. all
previous ICOM models)

hexradcmd FE FE 76 E0 06 01 FD FE FE 76 E0 1A 04 01 01 FD

Set ICOM 746PRO to LSB-D:

hexradcmd FE FE 66 E0 06 00 FD FE FE 66 E0 1A 06 01 FD

Set ICOM 7200 to LSB-D:

hexradcmd FE FE 76 E0 06 00 FD FE FE 76 E0 1A 04 01 01 FD

Set Yaesu FT847 to USB at 14.109Mhz:

hexradcmd 01 00 00 00 07 01 41 09 00 01

Set Yaesu FT847 to 18.106Mhz:

hexradcmd 01 81 06 00 01

Set Yaesu FT847 to USB:

hexradcmd 01 00 00 00 07

Set Yaesu FT847 to LSB:

hexradcmd 01 00 00 01 07

NOTE: User's of MARS-ALE should note that HEXRADCMD does not exist in the
current release.

3. Added MMI Commands in support of the LDG AT200PC ATU.

Command Syntax: LDG {Argument1..Argument3}

The LDG commands for the LDG AT-200PPC ATU are handy for configuring the AT-
200PC for both ALE operation and after an ALE inlink state or when PC-ALE is just
running and you want to make use of the AT-200PC for other communications.

The commands provide for quick control without need of releasing PC-ALE resource and
the use of other software. I use these commands in MARS-ALE all time to control
various parameters of the ATU, such as telling the unit the frequency I am using which is

8
PC-ALE
MMI User Guide
Released xx-xx-15
not an ALE channel so that it automatically tunes from memory or placing the unit in
MANUAL to preclude automatic returning while single channel or placing the unit into
BYPASS on an antenna and frequency where its not needed.

The commands available for use are:

LDG ANT1 ................................> Select Antenna Port 1

LDG ANT2 ................................> Select Antenna Port 2
LDG AUTO ...............................> Select AUTO mode
LDG MANUAL ..........................> Select MANUAL mode
LDG ACTIVE ............................> Select ACTIVE mode
LDG BYPASS ..........................> Select BYPASS mode
LDG LOZ .................................> Select Low Impedance operation
LDG HIZ ..................................> Select High Impedance operation
LDG INDDN .............................> Manually select the next Lowest Inductor value
LDG INDUP .............................> Manually select the next Highest Inductor value
LDG CAPDN ............................> Manually select the next Lowest Capacitor value
LDG CAPUP ............................> Manually select the next Highest Capacitor value
LDG INDSET ...........................> Manually select the current Inductor value
LDG CAPSET ..........................> Manually select the current Capacitor value
LDG STORE ............................> Manually select to store the settings and frequency
LDG RESET .............................> Reset all Relays, L, C and HiLoZ information
LDG MEMTUNE .......................> Select MEMORY TUNE operation
LDG FULLTUNE ......................> Select FULL TUNE operation
LDG ALLUPDATE ....................>
LDG VSWRnn ..........................> Set VSWR Threshold where n is 11, 12, 13, 15 ,17 ,20
,25 ,30
LDG REQ_ARM_CLEAR ...........> Setup to delete all memory
LDG REQ_CLEAR_MEM ...........> Delete all memory
LDG UPDATEON ......................>
LDG UPDATEOFF ....................>
LDG FREQ n ............................> Tune frequency from memory where n = frequency in
hertz, e.g.: 14230000

The AT200PC has the tendency to jump into auto tuning after a tuned state depending on
how critical the tuning of the antenna is at a particular frequency and the modulation
characteristics, this can be handled in single channel operation by selecting the frequency
for use while the ATU is in ACTIVE and AUTO and then placing the unit into
MANUAL. For example, let's say the Fo of interest is 7.385Mhz, enter:

LDG FREQ 7385000

LDG MANUAL

I want to change to another channel, say 3.8470Mhz and still require the AT200PC you
would enter:

9
PC-ALE
MMI User Guide
Released xx-xx-15
LDG AUTO
LDG FREQ 3847000
LDG MANUAL

If you did not need to use the AT200PC as you are switching to say ANT 2 that is
resonant you would enter:

LDG ANT2
LDG BYPASS

NOTE: In PC-ALE when configuring for AT200PC use either ANT1 or ANT2 is
selected as the Scan Antenna and PC-ALE only selects the antenna once at the begining
of scanning. Thus any change to the antenna selection via the MMI ANT1 or ANT2
commands during an ALE inlink state during Scanning will remain as selected when
scanning continues unless the user either issues another MMI ANTx command to return
the Scanning Antenna port as configured or Scanning is stopped and restarted.

To Set the VSWR threshold 1.7:1 enter:

LDG VSWR17

Some users of MARS-ALE, such as KB4BA like to set the AT200PC VSWR threshold
to a higher level upon an ALE link and then back to a lower level after the link for
Sounding transmissions so that during the ALE link any intermittent antenna situations
such as rain, icing etc. or the tendency of the ATU to keep AUTO tuning when on a
challenging to tune frequency do not occur. This is done using the MMI LDG commands
in the LINKED.DAT and UNLINKED.DAT files which have not been added to PC-ALE
and are detailed later herein.

To clear all AT200PC memory enter:

REQ_ARM_CLEAR
REQ_CLEAR_MEM

NOTE: User's of MARS-ALE will note that ANT1 and ANT2 do not exist in the MARS-
ALE LDG support but rather SET ANTn is used when the AT200PC has been selected as
the ANT SW device as MARS-ALE supports numerous antenna selection devices and
radio CAT ANT port selection and devices with up to 10 ports and is based on the device
selected for use in configuration. Should such support by ported to PC-ALE the ANT1
and ANT2 MII commands will be removed.

4. Added MMI Command for MACRO support

Command Syntax: MACRO {Argument}

The MACRO Argument is the file name of the MACRO where .MAC is assumed.

10
PC-ALE
MMI User Guide
Released xx-xx-15

All .MAC files will be located in the \MACRO\ sub directory under where the ALE.EXE
is installed.

There is no limitation to the number of MACRO files that may be created.

A MACRO file can consist of comments on a line or one command followed by its
arguments per line.

There can be no more than 100 MMI commands per MACRO file and no more than 50
arguments per MMI command per line. At present the HEXRADCMD supports the most
arguments per command at 30.

MARCO files can be nested where the MACRO command can be used to call another
MACRO file, however such use is not recommended.

All commented lines start with a pound (#) symbol and will be ignored.

Here is an example MACRO file that can be used to Reset the OWN Address in the
HFlink distribution of .QRG files or any 3rd party .QRG file from whatever OWN
Address exists to that desired when a properly edited "callsign" is provided and the ADD
OWN line is activated.

# Filename: RESETOWN.MAC
#
# RESET OWN below will delete all existing OWN Addresses
# in the ALE.DAT database file.
#
RESET OWN
#
# Edit callsign in the line below to your callsign and remove the # symbol
#
#ADD OWN callsign
#
# END RESETOWN.MAC

Here is an example MACRO file to set a Kenwood radio to WWV at 10Mhz in AM

mode:

# Filename: KNWDWWV10.MAC
#
# Set Kenwood radio to WWV at 10Mhz in AM mode
#
RADCMD FA00010000000;MD5;
#
# END KNWDWWV10.MAC

11
PC-ALE
MMI User Guide
Released xx-xx-15

To execute the KNWDWWV10.MAC file the DataBar MMI interface is again used and
one would simply enter:

macro knwdwwv10

If a MACRO file is not found due a typo or it just does'nt exist in the directly then a
message is displayed in the Engineering window such as:

FILE NOT FOUND C:\Program Files\PC-ALEv107\MACRO\KNWDWWV01.MAC

Here is an example MACRO file to set a TCI8174 receiver to 10Mhz AM for WWV
reception:

# Filename: TCIWWV10.MAC
#
# Set TCI8174 radio to WWV at 10Mhz in AM mode
#
radcmd "{Af10000000 }{AeL1 }"
#
# END TCIWWV10.MAC

Here is an example MACRO file to set a any ICOM radio to 10Mhz AM for WWV
reception:

# Filename: ICOMWWV10.MAC
#
# Set ICOM radio to WWV at 10Mhz in AM mode
#
hexradcmd FE FE 00 E0 05 00 00 00 10 00 FD FE FE 00 E0 06 02 FD
#
# END TCIWWV10.MAC

Here is an example MACRO file to set a Cubic R3030 needing three start bytes to 10Mhz
AM for WWV reception:

# Filename: R3030WWV10.MAC
#
# Set Cubic R3030 radio to WWV at 10Mhz in AM mode
#
# Set Frequency
hexradcmd 02 02 02 30 31 46 31 30 30 30 30 30 30 30 0D
#
# Set Mode
hexradcmd 02 02 02 30 31 4D 41 0D
#

12
PC-ALE
MMI User Guide
Released xx-xx-15
# END R3030WWV10.MAC

If sending a number of commands to a radio and the radio make/model in question only
supports one command at a time it is recommended to use the MMI DELAY command in
between commands to allow for the radio to process the commands, DELAY paces the
sending of commands by the value of time in miliseconds provided with a range from
10..1000ms, an exmaple of using DELAY:

# Set Frequency
RADCMD FA00010000000;
# Wait 50ms
DELAY 50
# Set Mode
RADCMD MD5;

NOTE: If DELAY is used with no argument then the delay will be 10ms, if the value is
less than 10 then the delay will be 10ms, if the value is greater than 10 then the delay will
be 1000. If more than one argument is provided then there will be no delay.

NOTE: It does not matter if the commands and arguments are entered in Upper or Lower
case as all non commented lines are converted to upper case for execution and sub
sections that are bound in double quotes are left in the case entered.

5. Added CONFIG.DAT file to process MMI Commands at program start up.

If no CONFIG.DAT file is present the following message will be displayed at program

start:

FILE NOT FOUND CONFIG.DAT

To eliminate the FILE NOT FOUND CONFIG.DAT message a CONFIG.DAT file is

created with an ASCII editor and must be located in the same subdirectory as the
ALE.EXE with either no contents or with MMI commands which are proper to use at
program start.

One or more .MAC files can be executed from within the CONFIG.DAT file.

If automatic starting of scanning is desired when using the CONFIG.DAT file the
START command must be the last command in the CONFIG.DAT file.

6. Added SHUTDOWN.DAT file to process MMI Commands at program shut down.

The SHUTDOWN.DAT file is created with an ASCII editor and must be located in the
same subdirectory as the ALE.EXE with either no contents or with MMI commands
which are proper to use at program start.

13
PC-ALE
MMI User Guide
Released xx-xx-15
It is NOT recommended to call .MAC files from within the SHUTDOWN.DAT file.

The amount of MMI commands used in SHUTDOWN.DAT must be kept very short,
especially commands having to do with Radio or AT200PC control which must be the
first commands issued.

There will be no display of any execution of MMI commands in the PC-ALE

Engineering window however should PC-ALE be under Telnet terminal control, all
executed commands will display on the telnet terminal prior to the connection lost
message.

7. Added LINKED.DAT file to process MMI Commands after ALE inlink.

If no LINKED.DAT file is present the following message will be displayed when the
ALE inlink clears:

FILE NOT FOUND LINKED.DAT

The LINKED.DAT file is created with an ASCII editor and must be located in the same
subdirectory as the ALE.EXE with either no contents or with MMI commands which are
proper to use at program start.

It is NOT recommended to call .MAC files from within the LINKED.DAT file.

The amount of MMI commands used in LINKED.DAT must be kept very short,
especially commands having to do with Radio or AT200PC control which must be the
first commands issued.

8. Added UNLINKED.DAT file to process MMI Commands after ALE inlink clear.

If no UNLINKED.DAT file is present the following message will be displayed at ALE

inlink:

FILE NOT FOUND UNLINKED.DAT

The UNLINKED.DAT file is created with an ASCII editor and must be located in the
same subdirectory as the ALE.EXE with either no contents or with MMI commands
which are proper to use at program start.

It is NOT recommended to call .MAC files from within the UNLINKED.DAT file.

The amount of MMI commands used in UNLINKED.DAT must be kept very short,
especially commands having to do with Radio or AT200PC control which must be the
first commands issued.

9. Added new MMI Command Help system.

14
PC-ALE
MMI User Guide
Released xx-xx-15

Command Syntax: HELP {Argument}

All .HLP files will be located in the \HELP\ sub directory under where the ALE_32.EXE
is installed.

To use the Help system just type the following in the DataBar TEXT box when MMI is
checked:

help macro

Information on the MACRO command will then appear in the Engineering Window.

If there is no .HLP file for the command entered as the argument to HELP then message
will be display in the Engineering Window such as:

* Help on RADCMD not found

Just entering the command HELP alone will bring up a short list of the most used
commands.

15
PC-ALE
MMI User Guide
Released xx-xx-15

PC-ALE MMI COMMANDS

DATED: NOVEMBER 2009

============================

MMI Commands fall into the following major interface categories:

QRG.....: MMI commands in this category are for modifying GROUPS and NET,
OWN/SELF, OTHER Address databases and for the dissemination of common baselines
among users.

NOTE: When distributing a filename.QRG file users must make sure they edit the OWN
and other data that is not specific to their station.

DataBar: Any MMI command can be used via the DataBar, however some should not be
used via this interface.

Telnet..: Any MMI command can be used via a telnet connection, some should not be
used via this interface. All commands via Telnet need to be proceeded by "CMD ".

-----------------------------

CHANNELS:

CHANNELS > List the channels belonging to the current scan GROUP.

OWN:

OWN > Lists all 20 possible OWN Addresses in the database.

OTHER:

OTHER > Lists all 1,000 possible OTHER Addreses in the database. As OTHER
Addresses are added automatically via intercept, partial addresses are possible.

NET:

NET > Lists all 20 possible NET Addresses

ADD:

16
PC-ALE
MMI User Guide
Released xx-xx-15

ADD OWN [self address] > ADD a new Self Address to the OWN/SELF database.

DELETE:

DELETE CHANNEL [n] > Delete channel n where n is any existing Channel
Number.
DELETE NET [address] > Delete NET address where address is any existing NET
Address.
DELETE OTHER [address] > Delete OTHER address where address is any existing
OTHER Address.
DELETE OWN [address] > Delete OWN address where address is any existing Self
Address. Deleting an existing
OWN Address does not shift the ordering of the remaining
addresses in the database.
DELETE SELF [address] > Delete SELF address where address is any existing Self
Address.

CALL:

CALL [other address] > Initiates a linking call. Must be to an existing OTHER Address
in the database.

CLEAR:

CLEAR [other address] > Clear specific station inlink

CLEAR @?@ > Clear all stations inlink

HELP:

HELP > Lists a number of the most comment MMI commands and details on each.

HELP [mmi command] > TBD - Lists specific detailed help information on the valid
MMI command entered.

SAVE:

SAVE DATABASE > Updates ALE.DAT with any recent changes

LOAD:

LOAD CONFIG [filename] > Loads the file provided in filename where the name can be
anything, with or without a file extension

17
PC-ALE
MMI User Guide
Released xx-xx-15
but where the file must reside in the same directory as the ALE executable unless a full
path is provided. The the loaded file must contain MMI commands that make sense for
execution by the MMI interpreter.

LOAD DATABASE > Loads the ALE.DAT database.

KILL:

KILL > Emergency Kill - Same as clicking the AXE - Can be used to stop LQA calling
and continue scanning if entered when Listing on the channel

GROUP:

SET GROUP [n] > Sets the GROUP indicated by n as the current Scan GROUP.

AMD:

AMD [address <address> " message text within DOUBLE quotes with spaces before 1st
& after last word message "]

> Send station @ address(es) 1..n an AMD message that is provided.

AMD > List all received AMD's in the ALE.DAT database

OPTIONS:

OPTIONS > Lists a number of program configuration parameter settings.

SERRORS:

SET SERRORS n > set the number of sync errors

SVOTES:

SET SVOTES n > set the number of sync votes

FERRORS:

SET FERRORS n > set the number of frame errors

FVOTES:

SET FVOTES n > set the number of frame votes

18
PC-ALE
MMI User Guide
Released xx-xx-15

STOP:

STOP > Will stop Scanning if in progress. Will also stop Sounding, but not as fast as
Kill.

START:

START > Will start Scanning/Sounding

ALLCALL:

GLOBAL ALLCALL n " amd message " > Where n is the legal channel number of the
current scan GROUP. Double quotes > with spaces before and after the option AMD
message must be used.

Note: The radio will change to the channel number if not already there

Note: Sends a Global ALLCALL TIS with optional AMD

ANYCALL:

GLOBAL ANYCALL n " amd message " > Where n is the legal channel number of the
current scan GROUP. Double quotes > with spaces before and after the option AMD
message must be used.

Note: The radio will change to the channel number if not already there

Note: Sends a Global ALLCALL TIS with optional AMD

SELECTIVE:

tbd -

GLOBAL:

GLOBAL ALLCALL n " amd message " > Where n is the legal channel number of the
current scan GROUP. Double quotes > with spaces before and after the option AMD
message must be used.

Note: The radio will change to the channel number if not already there.

Note: Sends a Global ALLCALL TIS with optional AMD.

19
PC-ALE
MMI User Guide
Released xx-xx-15

GLOBAL ANYCALL n " amd message " > Where n is the legal channel number of the
current scan GROUP. Double quotes > with spaces before and after the option AMD
message must be used.

Note: The radio will change to the channel number if not already there.
Note: Sends a Global ALLCALL TIS with optional AMD.

LINKED:

LINKED > List the stations currently inlink, e.g.:

* CURRENTLY LINKED WITH

[N2CKH ]
OK

KEYS:

KEYS > Displays a list of the Link Protection Keys AL0..AL4

Note: Link Protection is not currently supported in PC-ALE.

ENABLE:

ENABLE AQC > Enable AQC on MIL-STA-188-141 dialog

ENABLE AQCBURST > Enable AQC BURST on MIL-STA-188-141 dialog
ENABLE TWX > Enable Linked TWX Orderwire Handshake on MIL-STA-
188-141 dialog
ENABLE TCPECHO > Turns on echo of Engineering and Data window. On by
default at Telnet connection
NOTE: At present a bug some times turns it off unexpectly.
ENABLE ALLCALLS > Enables ALLCALLS on '188-141 dialog
ENABLE ANYCALLS > Enables ANYCALLS on '188-141 dialog
ENABLE LQA > Enables LQA on '188-141 dialog
ENABLE MOTD > Enables MOTD on '188-141 dialog
EMABLE POLL > Enables Polling on '188-141 dialog
ENABLE SOUND > Enables Sounding on '188-141 dialog
ENABLE TIS > Enables TIS Sounding on '188-141 dialog
ENABLE VOICE DETECT > Enables Channel Busy Detect on '188-141 dialog
ENABLE CATMUTE > Enables CAT MUTING instead of DTR/RTS
ENABLE MUTING > Enables any form of receiver MUTING selected
ENABLE CHANNEL > Enable MEMORY CHANNEL operation for radios that
support using
correlated memory channels to scan groups such as SGC2000.

20
PC-ALE
MMI User Guide
Released xx-xx-15
ENABLE LIMITCALLING > Enable the use of SET MINTIMECALLING and
MAXTIMECALLING
ENABLE PTTSTATUS > Enable the RADIO: PTT x messages

DISABLE:

DISABLE AQC > Disable AQC on MIL-STA-188-141 dialog

DISABLE AQCBURST > Disable AQC BURST on MIL-STA-188-141 dialog
DISABLE TWX > Disable Linked TWX Orderwire Handshake on MIL-STA-
188-141 dialog
DISABLE TCPECHO > Turns off echo of Engineering and Data window.
DISABLE ALLCALLS > Disables ALLCALLS on '188-141 dialog
DISABLE ANYCALLS > Disables ANYCALLS on '188-141 dialog
DISABLE LQA > Disables LQA on '188-141 dialog
DISABLE MOTD > Disaables MOTD on '188-141 dialog
DISABLE POLL > Disables Polling on '188-141 dialog
DISABLE SOUND > Disables Sounding on '188-141 dialog
DISABLE TIS > Enables TWS Sounding by disabling TIS on '188-141
dialog
DISABLE VOICE DETECT > Disables Channel Busy Detect on '188-141 dialog
DISABLE CATMUTE > Disables CAT MUTING allowing for DTR/RTS
MUTING to be used.
DISABLE MUTING > Disables any form of receiver MUTING selected
DISABLE CHANNEL > Disables MEMORY CHANNEL operation for
radios that support it.
DISABLE LIMITCALLING > Disable the use of SET MINTIMECALLING and
MAXTIMECALLING

SCLC:

SET SCLC n >

RETRIES:

See SET AMD, DBM and SET DTM

TIMEOUT:

CMD TIMEOUT > List the current time

RESET:

RESET ALECHAN > Resets the radio to the proper ALE channel frequency and mode

21
PC-ALE
MMI User Guide
Released xx-xx-15
RESET MODEM > Resets the modem when hung, same as Tools > Reset Modem
RESET AMD > Delets all AMD messages from ALE.DAT
RESET LQA > Deletes all LQA data
RESET OWN > Deletes all OWN/SELF Addresses

RESET DISPLAY > Among other things it turns off TCP/IP display echo

SET:

CMD SET DBM RETIRES n > Set DBM Retries to max of 30

CMD SET DTM RETRIES n > Set DTM Retires to max of 30
CMD SET CHANNEL n > Supports a channel used in the current GROUP when in
Single Channel
CMD SET GROUP n > Select Scan GROUP 0..15
CMD SET ANT n > For any supported and selected ant sw ports 1..10
CMD SET SERRORS n > set the number of sync errors
CMD SET SVOTES n > set the number of sync votes
CMD SET FERRORS n > set the number of frame errors
CMD SET FVOTES n > set the number of frame votes
CMD SET RADIO w > Selects RADIO TYPE by written name as listed for selection
such as:

CODAN,DX77T,FT600,FT650,FT757GX,FT767GX,FT817,FT817DIG,FT847

CMD SET PTT n > Sets the PTT period on the '188-141 options menu
CMD SET INACT n > Sets the Inactivity Timer (TWA) on the '188-141 options menu

CMD SET NET address >

CMD SET OTHER address >
CMD SET OWN address >
CMD SET SELF address >

CMD SET TXAL n > Set TX Audio Level

CMD SET RXAL n < Set RX Audio Level
CMD SET DCD n > Set DCD Level

CMD SET MOTD "message text" > Sets the MOTD message where text is entered
between double quotes

CMD SET DTM RETRIES n > Where n is in minutes

CMD SET DBM RETRIES n > Where n is in minutes

CMD SET RADIO CHANNEL n > Supports programming a supported radio memory
channel n with the information
as to frequency and mode from Scan Group Channel n for Radio
Memory channel

22
PC-ALE
MMI User Guide
Released xx-xx-15
scanning verses on the fly frequency and mode being sent to the
radio.
If the channel number entered exceeds the number of channels in
the .QRG file
or the number of channels the radio memory supports, an error
message will be
displayed.

CMD SET RESOUND n > Set the Resound period where n is in minutes
CMD SET SOUND n > Set the Sounding period where n is in minutes
CMD SET LQA TIMEOUT n > Set the LQA timeout where n is in minutes

CMD SET AFGAIN n > Set the radio receiver AF GAIN over a range of 0..255

CMD SET EXTMODEM type > Where type is an external TNC/Modem listed on MIL-
STD-188-141 options

KAME;KAMPLUS;KAMXL;KAM98;HK232;PK232;PK900;DSP232;DSP1232;
DSP2232;

SCSPTCI;SCSPTCII;MFJ1276;MFJ1278B;DXP38;DSP4100;GENERIC;

CMD SET MINCALLTIME n > Where n is in seconds

CMD SET MAXCALLTIME n > Where n is in seconds

CMD SET RADIO type > Where "type" is the same as listed in the MIL-STD-188-141
options pulldown for
radio type, such as "KENWOOD" or "FT2000" or "IC746PRO".

CMD SET TRANSMIT {ON|OFF} > In ALE inlink each ON state restarts the ALE
TOT so as not to loose the link.

------------------------------------------------------------------------------------------------------------
----------------

LDG: > Commands for the LDG AT-200PPC ATU and compatiable units

LDG ANT1 ................................> Select Antenna Port 1

LDG ANT2 ................................> Select Antenna Port 2
LDG AUTO ...............................> Select AUTO mode
LDG MANUAL ..........................> Select MANUAL mode
LDG ACTIVE ............................> Select ACTIVE mode
LDG BYPASS ..........................> Select BYPASS mode
LDG LOZ .................................> Select Low Impedence operation

23
PC-ALE
MMI User Guide
Released xx-xx-15
LDG HIZ ..................................> Select High Impedence operation
LDG INDDN .............................> Manually select the next Lowest Inductor value
LDG INDUP .............................> Manually select the next Highest Inductor value
LDG CAPDN ............................> Manually select the next Lowest Capacitor value
LDG CAPUP ............................> Manually select the next Highest Capacitor value
LDG INDSET ...........................> Manually select the current Inductor value
LDG CAPSET ..........................> Manually select the current Capacitor value
LDG STORE ............................> Manually select to store the settings and frequency
LDG RESET .............................> Reset all Relays, L, C and HiLoZ information
LDG MEMTUNE .......................> Select MEMORY TUNE operation
LDG FULLTUNE ......................> Select FULL TUNE operation
LDG ALLUPDATE ....................>
LDG VSWRnn ..........................> Set VSWR Threshold where n is 11, 12, 13, 15 ,17 ,20
,25 ,30
LDG REQ_ARM_CLEAR ...........> Setup to delete all memory
LDG REQ_CLEAR_MEM ...........> Delete all memory
LDG UPDATEON ......................>
LDG UPDATEOFF ....................>
LDG FREQ n ............................> Tune frequency from memoru where n = frequency in
hertz, e.g.: 14230000

The AT200PC has the tendancy to jump into auto tuning after a tuned state depending on
how critical
the tuning of the antenna is at a particular frequency and the modulation characteristics,
this can be
handled in single channel operation by selecting the frequency for use while the ATU is
in ACTIVE and AUTO
and then placing the unit into MANUAL. For example, let's say the Fo of interest is
7.385Mhz, enter:

LDG FREQ 7385000

LDG MANUAL

I want to change to another channel, say 3.8470Mhz and still require the AT200PC you
would enter:

LDG AUTO
LDG FREQ 3847000
LDG MANUAL

If you did not need to use the AT200PC as you are switching to say ANT 2 that is
resonant you would
enter:

LDG ANT2
LDG BYPASS

24
PC-ALE
MMI User Guide
Released xx-xx-15

NOTE: In PC-ALE when configuring for AT200PC use either ANT1 or ANT2 is
selected as the Scan Antenna
and PC-ALE only selects the antenna once at the begining of scanning. Thus any change
to the antenna
selection via the MMI ANT1 or ANT2 commands during an ALE inlink state during
Scanning will remain
as selected when scanning continues unless the user either issues another MMI ANTx
command to return
the Scanning Antenna port as configured or Scanning is stopped and restarted.

To Set the VSWR threshold 1.7:1 enter:

LDG VSWR17

To clear all AT200PC memory enter:

REQ_ARM_CLEAR
REQ_CLEAR_MEM

NOTE: User's of MARS-ALE will note that ANT1 and ANT2 do not exist in the MARS-
ALE LDG support but
rather SET ANTn is used when the AT200PC has been selected as the ANT SW device
as MARS-ALE supports
numerous antenna selection devices and radio CAT ANT port selection and devices with
up to 10 ports and is
based on the device selected for use in configuration. Should such support by ported to
PC-ALE the ANT1
and ANT2 MII commands will be removed.

--------------------------------------------------------------
----------

# CONFIG.DAT - MARS-ALE Start Up Configuration File

#
# If no CONFIG.DAT file is found in the directory of ALE.EXE then the following
message
# will be printed to the Engineering window at program start " FILE NOT FOUND
CONFIG.DAT"
#
# The # sign is for commenting out a line from processing
#
# There can be only 20 words on a line
#
# - - - ERROR MESSAGES - - -

25
PC-ALE
MMI User Guide
Released xx-xx-15
# An error message will be displayed in the engineeing window for each line of the
configuration
# file when the line contains an error:
#
# Any illegal commands will result in SYNTAX ERROR -
#
# Any command that is legal but not in the correct order will generate an AMBIGUOUS
COMMAND -
#
# Any command that requires parameters after will generate NOT ENOUGH
PARAMETERS when
# the arguments are missing.
#
# - - - END ERROR MESSGES - - -
#
# Enter Commands that the MARS-ALE MMI will execute from this point down only if
the
# OPSEC license.dat file is valid.
#
#------------------------------------------------------------
------------------
#
# SET GROUP 10 will select scan GROUP 10 from 0 to 15
#
SET GROUP 10
#
# List the channels of the GROUP for the log as we changed to a new GROUP
#
CHANNELS
#
# Print the date/time of the automatic restart
#
TIME OUT
#
#Enable POLLING LQA in case it was not checked on the MIL-STD-188-141 dialog
#
ENABLE POLL
#
#Enable LQA in case it was not checked on the MIL-STD-188-141 dialog
#
ENABLE LQA
#
#Enable SOUNDING in case it was not checked on the MIL-STD-188-141 dialog
#
ENABLE SOUND
#

26
PC-ALE
MMI User Guide
Released xx-xx-15
#START will start the current Scan GROUP Scanning or Sounding if checked
#
START

-----

# SETUP.DAT - MARS-ALE Start Up Configuration File

#
# The SETUP.DAT file is used to reset system parameters when either
starting with a full install, or
# updating with a new released that requires a new ALE.DAT format or
when the ALE.DAT file is damaged
# or deleted.
#
# The SETUP.DAT file is used to configure beyond the default settings
that are written to the ALE.DAT by
# the MARS-ALE at the first program start when the ALE.DAT file is
missing or corrupt.
#
# The SETUP.DAT file provides control of most settings found at this
time on the MIL-STD-188-141dialog
# as well as your GROUPS, OWN, OTHER and NET Address databases and more
#
# Use of the SETUP.DAT file may be made by renaming it CONFIG.DAT for
one use ONLY and ONLY after
# starting MARS-ALE to allow for the ALE.DAT file to be created with
all its default settings and then shutting
# down tool, renaming SETUP.DAT to CONFIG.DAT and restarting the
tool. Then any parameters that are not
# set by the renanmed SETUP.DAT can be changed manually and then once
again shut down the tool and
# than delete or copy over the CONFIG.DAT file.
#
# Lastly, the the SETUP.DAT file can be used via the use of Fill >
Load QRG File were you specify that the
# SETUP.DAT file be loaded. The SETUP.DAT file can contain all the
information from your .QRG file as well.
#
# The # sign is for commenting out a line from processing
#
# There can be only 20 words on a line
#
# - - - ERROR MESSAGES - - -
# An error message will be displayed in the engineering window for
each line of the configuration
# file when the line contains an error:

27
PC-ALE
MMI User Guide
Released xx-xx-15
#
# Any illegal commands will result in SYNTAX ERROR -
#
# Any command that is legal but not in the correct order will
generate an AMBIGUOUS COMMAND -
#
# Any command that requires parameters after will generate NOT ENOUGH
PARAMETERS when
# the arguments are missing
#
# - - - END ERROR MESSAGES - - -
#
# Enter Commands that the MARS-ALE MMI will execute from this point
down. If this file is being loaded
# by renaming it CONFIG.DAT, it will only be executed if the OPSEC
license.dat file is valid.
#
#----------------------------------
-----------------------------------
---------
#
# The commands below have been provided as the recommended defaults,
for many commands two
# states have been provided with one state active and the other
remarked out. The user can decide
# how they wish this file to affect their configuration by changing
these states.
#
# Delete all all existing OWN Addresses in the database
RESET OWN
# Change your_address to your authorized ALE Address
# Add OWN Address
ADD OWN your_address
#ADD OWN
#
# Display all OWN Addresses to the engineering window
SELF
# Set the TX Audio level
SET TXAL 20
# Set the RX Audio level
SET RXAL 10
#
# Set the DCD level
SET DCD 4
#
# Select radio type, use the exact name from MIL-STD-188-141 radio

28
PC-ALE
MMI User Guide
Released xx-xx-15
type selection pull down
# This selection will cause an immediate reset of the radio.
SET RADIO KENWOOD
#
# Enable LQA
ENABLE LQA
# Disable LQA
#DISABLE LQA
#
# Enable LQA Polling
ENABLE POLL
# Disable LQA Polling
#DISABLE POLL
#
# Enable Sounding
#ENABLE SOUND
# Disable Sounding
DISABLE SOUND
#
# Select TIS Sounding
ENABLE TIS
# Select TWS Sounding
#DISABLE TIS
#
# Disable AllCalls
DISABLE ALLCALLS
# Enable AllCalls
#ENABLE ALLCALLS
#
# Disable AnyCalls
DISABLE ANYCALLS
# Enable AnyCalls
ENABLE ANYCALLS
#
# Disable Voice Detection
DISABLE VOICE DETECT
# Enable Voice Detection
#ENABLE VOICE DETECT
#
# Set the Sounding Period
SET SOUND 60
#
# Set the Resound Period
SET RESOUND 30
#
# Set the amount of time to delete LQA data when a station has not been heard

29
PC-ALE
MMI User Guide
Released xx-xx-15
SET LQA TIMEOUT 121
#
#
# Set the number of DTM retries
SET DTM RETRIES 3
#
# Set the number of DBM retries
SET DBM RETRIES 3
# Set the SCLC value
SET SCLC 4
#
# Set the PTT period
SET PTT 30
# Set inactivity timer timeout (TWA)
SET INACT 180
#
# Enter a string of text no more than 90 characters long as the
Message of the Day (MOTD)
SET MOTD "Please leave message"
#
# Turn on the MOTD message
# ENABLE MOTD
#
# Turn off the MOTD message
DISABLE MOTD
#
# Here you could optionally place information that would normally be
contained in a .QRG file
#
# END OF SETUP.DAT
#

-----

# SHUTDOWN.DAT - MARS-ALE Shutdown Configuration File

#
# The SHUTDOWN.DAT file executes MMI commands at normal program termination
#
# The # sign is for commenting out a line from processing
#
# There can be only 20 words on a line
#
# - - - ERROR MESSAGES - - -

30
PC-ALE
MMI User Guide
Released xx-xx-15
# An error message will not be displayed in the engineeing window for each line of the
configuration
# file when the line contains an error at program shutdown as there is no time to process
and display
# them.
#
# As no illegal commands will result in SYNTAX ERROR being displayed as the
program is terminating,
# it is recommended that SHUTDOWN.DAT files be checked using the Fill > Load QRG
method manually.
#
# - - - END ERROR MESSGES - - -
#
# Enter Commands that the MARS-ALE MMI will execute from this point down
#
#------------------------------------------------------------
------------------
SET ANT 1
LDG AUTO
LDG ACTIVE

-----

31