*********************************************************************
*  Instructions how to create your own functions in RLM 2.2  990224 *
*********************************************************************

In RLM you can make your own DTMF functions.
You edit the text-file COMMAND.CFG and configure how your functions will work.
Use EDIT in DOS or Notepad in Windows to edit the file.

If you writing a new command, it will be automatically added in the DTMF
command access-list with the permission 'A' (All). You must go to the
'D' menu in the RLM setup to change the access for your new function.
 
Follow these instructions exactly when you write your functions.
Do not skip a line or enter wrong values.
In most cases you get an error message but in worst case RLM could hang.

* Your functions must start with DTMF function number. (eg DTMF #220) 
  A command consists of maximum 4 characters and the allowed characters is
  0-9, A, B, C, D, # and *. The functions in COMMAND.CFG do not have to be
  in any particular order.
* You can not use a DTMF number that RLM already has as a built in command.
* All commands and values are separated by a SPACE (" "). 
* You can use upper or lowercase characters as you wish.
* IF you use the CW command, use _ (underscore) as a space in the CW text
  (eg. Peter_Hansson)
* If you want to write a "REMark,  you use '(apostrof)
  ( eg: DTMF 1234 ' This is a good function)

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

Examples of some allowed syntax ------------------------------
CW peter 100 1000       ' Keying "peter" in 100cpm, 1000Hz
CW peter_allan 100 1000 ' Rem comment  Use  _ as a space in CW-text

Examples of not allowed syntax -----------------------------
CW peter 100,1000         Comma not allowed as a separator (use SPC ," ")
CW peter 100              Missed value (frequency)    
CW peter allan 100 1000   Use _ as a space in CW (peter_allan)
CW peter 120 500'Rem row, a space is missing before '

Exampel of a complete function ------------------------
DTMF 1234               ' Dtmf function 1234 start
PLAYHD hello            ' Playback the sound-file "hello.voc" from the HD directory     
MELODY cdef 50          ' Plays the melody "cdef" with 50ms tone length
PLAYUSER 1              ' Playback the user number 1:s call.

Example of a question function ------------------
DTMF 77                 ' Start of command 77
PLAYRAM QUEST1          ' Asking "Is this okay?"
ASK                     ' Wait for DTMF input  (1 or 0)
SPELL OK                ' Spelling "O","K" if the answer is 1
TONE 100 800            ' Send tone
ELSE                    ' IF the answer is 0…
CW noll 100 600         ' Key NOLL in 100 ch/min with 600Hz tone

-----------------------------------------------------------------------
Listing of all functions/commands.
-----------------------------------------------------------------------
PLAYHD filename         Playback a sound-file from the HD-directory
PLAYRAM filename        Playback a sound-file from the RAMDISK-directory
PLAYUSER filename       Playback a sound-file from the WORKFILE-directory
RECORD filename         Playback a sound-file from the WORKFILE-directory

RUN filename            Run a batchfile (.BAT) that is located in the RLM directory
EXIT                    Shutdown RLM.
WARMBOOT                Shutdown and reboot the RLM computer
RUNDTMF func            Run another DMTF function (Only the built in)

ASK                     Wait for DTMF-input.
                        If the answer is = 0 the command-lines after ELSE is processed,
                        If not the lines before ELSE is processed.

IF flag                 Runs a question about status of a RLM flag (variable).
                        If the answer is  = negative, the lines after
                        ELSE is processed, If not the lines
                        before ELSE is proccessed.

                        Flag's ..... The answer is YES if...
                        ---------------------------------------------
                        RPTOPEN    -  repeater is open
                        LINKOPEN   -  repeater and link is open
                        MONITOR    -  the monitor line of the link-radio
                                      receiver is active

                        ALARMACTIV -  burglar alarm is activated
                        ALARMTRIGG -  burglar alarm is trigged

                        COMFLAG    -  If the data from the comport matches the data 
                                      specified in the CHKCOM command
                        ---------------------------------------------

CW text speed freq      Keying "text" with "speed" characters per minute and
                        the frequencey "freq" in HZ
TONE length freq        Sends a tone in "length" milliseconds with "freq" Hz.
FMSOUND bank freq       A FM-synthesizer sound with frequency "freq"
MELODY notes length     Playing melodically notes  eg: MELODY cdeCDE 40 (ms)

SPELL text              Spelling text eg: SPELL abc

DELAY time              Wait for time in milliseconds

SETPORT num             Set the port "num" to ON
RESPORT num             Set the port "num" to OFF

SENDCOM text            Sends text on COM-port for link-radio
                        (Do not use space)
CHKCOM text             Waiting 1sec. for incoming data on COM-port and
                        compare this data with "text".
                        If a match, COMFLAG = YES.
                        See the IF flag section above.

STARTRPT                Starting (opening) repeater
CLOSERPT                Closing the repeater

LINK ALT NOT            On/Off link  BRK=ignore if the channel is busy
     ON  BRK            ALT=Alternate On/Off
     OFF

MONITOR ALT             Off/On link monitor
        ON              ALT=Alternate On/Off
        OFF

LOADCONFIG num          Loading setup (1-5)