R L M
Free HAM Radio PC based Repeater controller
A product from arandis.se
HOME
Detail description of the RLM system
RLM stands for Repeater Link Mail server.

It's a PC-based, DOS program that operate as an repeater controller with link and voicemail or a stand alone system as simplex voicemail system. RLM is made for amateur radio usage.


Short history
It started in 1993 when I wrote the first version for our repeaters local use.
Tourists who passed became very interested in our system with voicemail and link functions.
As the program were specially written for our repeater and had no configuration possibilities, the program could not be used easily on another system. So this is where I started from the beginning to write RLM as it is today, fully configurable with many features and the possibility to program your own functions in a RLM script language.

Program description
RLM is very flexible and fully configurable to setup a personalized repeater and voicemail system.
RLM can operate as a…
- repeater controller (with or without Link and Voicemail)
- voicemail server to work with an existing repeater controller.
- simplex voicemail server.

Your fantasy is the limit
Things that is possible with RLM
-
Use RLM as burglar alarm for your repeater QTH
- Control an external radio(s) (shortwave/UHF/VHF) or antenna positioning via the I/O interface from RLM
- Remote monitor and administer RLM via its Rs-232 terminal port
- Send out dayly report via packet radio/email or present the repeater informaton on your Clubs homepage.
- Switch the RLM config by a DTMF command to completly change the behaviour for specific events
- Build statistical graph showing repeater, link and command usage and present on Internet


License
RLM is nowadays freeware. You can download the program and use it as much as you like.

Sequences

You configure the repeater in so called sequences. It is an event that happens in different times when the repeaters are operating.
Some examples of sequences are: "Sq Rpt Open", "Sq Rpt Close", "Rpt Closing", "Link channel busy", "If not identifying before sending DTMF tones", "RPT hang-timer timeout"…

There are also sequences for persons who activate the repeater but dosen't identify themselves and sequences for ID timers and Link system.
For example, when the repeater is opening the "Start repeater" sequence is run and it could look like this…
  DELAY 500ms
  CW "SK2RME", SPEED 90, FREQ 700Hz
  DELAY 300mS
  FM SOUND no 1, tone 550


Description of the sequence
When the repeater is activated, (through SQ open, Accesstone or DTMF) the transmitter is starting and RLM wait for 500mS and then starting to key the text "SK2RME" with 90 characters per minute and with 700Hz tone frequency.
There is a 300mS delay and at last does the FM-sound generator on the SoundBlaster card generate a "Bong" with tone frequency 550Hz.
These FM sounds are fully programmable through a menu in RLM.

Link system
RLM handling a repeater but it can also handle a simplex linkradio. This linkradio can be used to link to other repeaters or only as a simplex link channel. The voicemail system can be also being operated from the linkradio. So if you link your repeater to another, the other repeater can use DTMF commands and the mailbox. You can also select channels on the linkradio from RLM. This could be done both with 8 bits parallel ports via the interface, or serial via a Com port on your RLM computer.
The system supports scanning in background and a user of a repeater that your system is linked to can start up your repeater and use the mailbox.
You can set per channel if the DTMF commands will be available from the linked repeater. You can also program a welcome message per channel when it's activated.

Login system and DTMF commands
RLM is based on that every user has a
3-digit login number. (E.g. 643 for SM2UMH)

Statistics
. RLM can log how many times, and the last time a user has logged in. Also repeater usage statistics is logged. RLM has a built in auto-report generator. Also RLM stores all DTMF commands that have been used.

Access to system. You can set DTMF commands access in 4 levels. A-Access for all, L-only those that has been logged in, S-Only for sysop, X-Not available at all.

RLM knows who you are. When you log in, RLM will tell you if you have any new messages or if new, not heard bulletins has arrived. As logged in, you also get your personal system behavior with more or less help while using the system. (EXPERT/NOVIS) status.

New RLM-users can (if the sysop wants) add themselves to the system and record their own callsign.
The sysop/user can set parameters on per user basis that for e.g. control if RLM will repeat a question if you don't answer or how long time RLM waits for a action from you. This is good for different behavior with experienced and not experienced users.
RLM has about 110 DTMF commands. The DTMF number is not changeable. I have done this so you can recognize the commands if you want to use another RLM when visiting another town. Although you can set access and lock commands as I described above. You can also set a "prefix" on your RLM if two RLM systems are in conflict. For example: the command 3 for recording a personal message will be *3 if I set prefix * on my system.
You can also script your own DTMF functions in a file called COMMAND.CFG.
An example of a command could look like this.

DTMF A1       ' This function is run when using DTMF comman "A1"
PLAYHD Quest  ' The voicefile Quest is containing "Do you really want to reboot"
ASK           ' Answer 1 or 0
CW Goodbye 100 1500  ' Keying Goodbye if answer is '1'
WARMBOOT      ' Command to shut down RLM and restart the computer
ELSE          ' If answer '0'
SPELL OK      ' Play O.K.
CW puhh 150 1000


There are many scripting functions that you can use in your COMMAND.CFG. Thera are functions for setting ports, checking program flags, such as burglar alarm and if link or rpt is activated, playing an recording files, running external programs and functions for sending and receiving on serial ports.

Voice mail system
RLM has a powerful voice mail system. The users can record personal messages to other users or they can record a bulletin that is active between two dates.
For example you can record a bulletin that that will pop up and announce for a club meeting and it will delete it selves the day after. RLM knows which user who has listen to which bulletins so the user won't have to hear it twice.
There is also a function that is called "the loop". This is a stack with 10 messages and if you record a new msg. then the oldest one is deleted. It is just like a scrapbook on the RLM

Logfiles
You can configure RLM to log in 5 files.
USER logs every timer a user Login. You can see what DTMF commands he has been using.
RPTR logs every time the repeater is activated
LINK logs everytime the linkradio is in use, it logs channel and direction.
TEMP logs in and out door temperature every hour
SYST logs error and systemmesages generated by RLM.
RLM also creates a REPORT file every midnight. It is made up of a template (REPORT.CFG) and this file can be used as a bulletin in a packet radio system so you can check the status of RLM (HD space, Who has mail, Repeater statistics and so on).

Sceduled controlled events
You can set up events that will happen in different times. This can be used to start external DOS programs, sending beacons and other stuff.

Modem / terminal port
RLM has a port where you can connect a telephone modem or other equipment for serial communication. This port can be used to administer and monitor RLM activity.
You must enter a password to get access to the console. Then you can use commands as…
RPT CLOSE Closing repeater
SYSTEM REBOOT Restarting computer
DEBUGToggle the debug mode on and off (Displaying all that happens)
SU Enter the setup menu
UL List user database
RE Show the report file
And more…

List of some major features of RLM
- Over 100 DTMF functions for messages, weather, configuration, statistics…
- You can set access on DTMF functions like All, Only logged, Sysop, Not available and Repeater func.
- Almost all repeater events are fully configurable.
- Message functions: Personal mail, Date controlled bulletins and a message loop.
- You can write your own DTMF functions in a simple "RLM language".
- Programmable scheduled time events.
- Ready for connecting link radio, with up to 30 programmable channels with scanning.
- Many out-ports that you can use for your own functions.
-Ready for 2 SMART TEMP sensors with functions for min/max temp.
- The system can create logfiles for temperature, repeater usage, link usage, mailbox usage and system   messages.
- Daily report file (fully configurable) that for example can be used as a packet-bulletin to inform users about mail,
- Temperature, repeater and mailbox statistics and so on.
- Can send CCIR and DTMF tones.
- Built in CW-tutor.
- Watchdog heartbeat pulse that can be used to restart computer in case of failure.
- Up to 5 system configurations that you can switch between with a DTMF command to change the complete system behavior. For e.g. change DTMF command access on high and low traffic.
-Online help (F-10)
-Real-time debug information always displayed
-Advanced sysop password system.
-Serial terminal port for configuration / management via Modem.


What do I need for my system?
At first you need a PC computer. It runs fine on 486 computer and later. If you want to record and play sounds you need a SoundBlaster compatible soundcard. And naturally you need to install the software. You can get it from the Download page
In simulator mode you can tested and evaluate RLM without the interface connected.
Then you need the RLM interface. This is connected to the parallel port and it include 16 outports, 5 inports and a DTMF decoder.
You build it yourselves.


Some data and system requirements
Written in Borland C++ 4.5 and Assembler, Program (EXE) size 200k. With soundfiles 5Mb.
Running on MS DOS operating system. (Can be run under MS Windows 95/98 but it may affect timing)
Runs fine on a 286 computer and later (Can be problems with a too modern computer not supporting MS-DOS)
For sound it requires a Soundblaster compatible soundcard.
About 110 DTMF commands.
Up to 80 user in database. Up to 30 link channels. Up to 200 sequence rows.
Up to 80 own DTMF commands. Up to 10 scheduled events.
5 online changeable SETUP files.
Using .VOC file format, Wav to Voc converting software available.