1TLF(1) Ham radio TLF(1)
2
3
4
6 Tlf - amateur radio contest keyer/logging program for Radiosport
7
9 tlf [-dhnrvV] [-f config_file] [-s user:password@host/dir/logfilename]
10
12 Tlf is a console (ncurses) mode general purpose CW keyer, logging and
13 contest program for amateur radio operators. It supports the CQWW, WPX,
14 ARRL-DX, ARRL-FD, STEWPERRY, PACC and EU SPRINT contests as well as a
15 lot more basic contests, general QSO and DXpedition mode. From version
16 1.2.0 onward there is also support for the FOC Marathon. It interfaces
17 with a Morse Code generator, a number of radios via the Hamlib library,
18 and with a DX Cluster via telnet or packet radio. Tlf can project DX
19 cluster data into the excellent Xplanet program, written by Hari Nair.
20
21 Contest operation mimics the popular TR-Log program for DOS, the output
22 file is TR-Log compatible. The log can be exported in ADIF or Cabrillo
23 format.
24
25 The program was written for console mode on purpose, which allows it to
26 run on smaller machines, or remotely via SSH or a modem link.
27
28 Since Tlf version 0.9.21 the cwdaemon 0.9 is fully supported, featuring
29 direct mode for the keyboard and output to parallel and serial ports
30 and speed and weight control from the keyboard, and band info output on
31 the parallel port.
32
33 For users of the K1EL series of “Win Keyers”, the winkeydaemon is
34 available from GitHub ⟨https://github.com/N0NB/winkeydaemon⟩. Setup is
35 the same as for the cwdaemon.
36
37 For radio control Tlf works with Hamlib (version >= 1.2.8), you can
38 find it at www.hamlib.org ⟨https://www.hamlib.org/⟩.
39
40 Tlf provides full TCP/IP networking between Tlf nodes, syncing/dis‐
41 tributing log, packet data, frequency data, local talk, serial numbers,
42 time sync etc.
43
45 Options given to Tlf on the command line.
46
47 -? Show summary of options and exit.
48
49 -f config_file
50 Start with non-default configuration file:
51
52 tlf -f PA0R
53
54 Defaults to logcfg.dat in actual working directory.
55
56 -s user:password@host/dir/logfilename
57 Synchronize log with other node
58
59 tlf -s user:password@host/dir/logfilename
60
61 -V Output version information and exit.
62
63 -v Verbose startup.
64
65 -d Debug rigctl.
66
67 -n Start without packet/cluster.
68
69 -r Start without radio control when user wants to start Tlf without
70 modifying logcfg.dat.
71
72 -i Import an existing CABRILLO file. When Tlf starts, looks for the
73 YOURCALL.cab log, reads the configuration and rule files, and
74 based on the current setup, generates the log(s). If the contest
75 is WAE, and you have QTC's in cabrillo, then Tlf makes the QTC
76 logfiles too. Tlf doesn't write over the existing log(s). The
77 generated import will be IMPORT_CONTEST.log, where the CONTEST
78 is the name of contest in the config. If QTC exists, then the
79 files IMPORT_QTC_sent.log and IMPORT_QTC_recv.log will be cre‐
80 ated.
81
83 Tlf has been written for console mode. If you want to run Tlf from a
84 terminal in X, you will probably get the best results if you set
85 TERM=linux and use a Linux console terminal. Both KDE and GNOME termi‐
86 nals have a facility to start a Linux console in an X terminal as does
87 Xfce-terminal.
88
89 By default, xterm(1) may give unreadable colours. If so, you will have
90 to set different colours in logcfg.dat or prepare $HOME/.Xresources to
91 the preferred colour scheme. One advantage of xterm is that it doesn't
92 consume the F11 key which other terminal emulators reserve for full
93 screen mode nor Ctrl-PgUp/Ctrl-PgDn which may be used for tab switching
94 in other emulators.
95
96 Recent efforts have resulted in improved keyboard handling. If you
97 find keys that do not work, the developers would like to receive your
98 report of which keys and which terminal have the problem. Please send
99 the report to the mailing list shown in the BUGS section below.
100
101 There are excellent results with the latest KDE, GNOME, and Xfce termi‐
102 nal emulators (vi colours are preferred by some). As Tlf uses ncurses
103 to format its display you must use a proper font. (Good choices are
104 the Linux font, Inconsolata, Hack, or any monospace font that dots or
105 slashes the zero character). If you have problems, try the linux text
106 console first and work from there.
107
108 Normally you start or restart Tlf in fast mode with “tlf”. During de‐
109 bugging of a logcfg.dat file you can start in verbose mode, to have a
110 look at the startup messages. From Tlf version 0.9.3 you can load dif‐
111 ferent config files with:
112
113 tlf -f config_file
114
115 If you have the packet cluster enabled you will first see the packet
116 screen (if you are using telnet and you have provided your callsign in
117 logcfg.dat you will be automatically logged in switched to the main
118 logging screen). Log in with your callsign, if needed, and switch to
119 the main logging screen with the ‘:’ command. You can come back to the
120 packet screen later with the :PACket command from the call input field
121 of the main logging screen.
122
123 You can exit and close Tlf with the :EXIt or :QUIt commands or with
124 Ctrl-C, Alt-Q or Alt-X.
125
126 At restart Tlf recalculates the score, which may take some time depend‐
127 ing on the number of QSOs in the logfile and the speed of your system.
128 Tlf takes the points as they are in the log, and calculates the multi‐
129 plier from either callsign or exchange field (depending on the con‐
130 test).
131
133 These commands are entered in the callsign field of the main logging
134 screen. Each command consists of the leading ‘:’ and at minimum the
135 upper case characters of the command name plus any needed parameters
136 separated by ‘Space’.
137
138 :ADIf Writes the log to an Amateur Data Interchange Format (ADIF) file
139 logfile.adif.
140
141 :CHAr Input the number of characters for CW auto-start or ‘m’ for man‐
142 ual start. Possible values are: ‘0’ (off), ‘2’...‘5’ or ‘m’
143 (manual). After typing as many characters in the input field or
144 after pressing the ‘Enter’ key in manual mode Tlf starts sending
145 the callsign without further keystrokes. You can type in the
146 rest of the call (but quickly). As soon as the sending catches
147 your last typed character Tlf automatically sends the exchange
148 and the cursor jumps to the exchange field. ‘Escape’ stops
149 sending. This works only in CW contests in RUN mode.
150
151 :CHEck
152 :NOCheck
153 Turn the dupe check window On|Off.
154
155 :CQDelay
156 Change Auto_CQ delay (in 1/2 seconds, with PageUp/PageDown
157 keys).
158
159 :CLOff No cluster information (non-assisted contest operation).
160
161 :CLUster
162 :MAP Show cluster window or bandmap.
163
164 :CONtest
165 Toggle contest mode On|Off.
166
167 :CTY
168 :ZONe
169 :MULt Show needed country multipliers, zones, multipliers per conti‐
170 nent (depends on the contest).
171
172 :CWMode
173 :SSBmode
174 :DIGimode
175 Switch TRX to CW|SSB|Digimode mode.
176
177 :DEBug_tty
178 Debug routine for rig communication links.
179
180 :EDIt Edit the log with your favourite editor. Be careful!
181
182 :EXIt
183 :QUIt Exit Tlf (synonym to Ctl-C, Ctl-D, Alt-Q, and Alt-X).
184
185 :FILter
186 Filter cluster info (announce, dx-spots, all).
187
188 :FREq Show frequency or band/score information of your other stations.
189
190 :FLDIGI
191 Turn off/on Fldigi communication.
192
193 :HELp Show online help (displays help.txt from working directory or
194 from /usr/share if no local one exists).
195
196 :INFo Show network status.
197
198 :MESsage
199 Edit CW (Morse Code) messages.
200
201 :MODe Toggle TRX mode (CW|SSB|DIG).
202
203 :PACket
204 Switch to the packet terminal. Switch back to the main logging
205 screen with ‘:’.
206
207 :REConnect
208 Re-opens the connection to the DX cluster in case it was discon‐
209 nected.
210
211 :REScore
212 Recalculates the values in the score window (e.g. after deleting
213 or editing QSOs).
214
215 :RITclear
216 Toggle the RIT reset after QSO On|Off.
217
218 :SET
219 :CFG Edit various parameters in logcfg.dat file and reload it.
220
221 :SCAn Enter the SCAN function (return with ‘Escape’).
222
223 :SCOre Toggle the score window On|Off.
224
225 :SCVolume
226 Adjust the soundcard volume for the sidetone (Up|Down). Range:
227 0–99.
228
229 :SIMulator
230 Toggle simulator mode. In simulator mode you can work a com‐
231 plete CQWW CW contest in TR-Log mode. Set CONTEST=cqww.
232
233 :SOUnd The SOUND recorder is a utility to record the voice keyer mes‐
234 sages and enables you to record the complete contest in chunks
235 of 1 hour to the hard drive. It does this in the directory:
236 $HOME/tlf/soundlogs. The sound recorder uses a script called
237 soundlog which has to be located in $HOME/tlf/soundlogs. It can
238 be found in the scripts directory. If your soundcard is differ‐
239 ent from /dev/dsp you can use the SC_DEVICE parameter in the
240 logcfg.dat file. The file extension is .au, the Sun ulaw for‐
241 mat. The recorder produces < 60 MB per hour. This means you
242 can record a complete CQWW in less than 3 Giga Bytes. If your
243 disk cannot handle this, FTP the soundfile to a server every
244 hour.
245
246 F1 ... F12, s, c, ... will record the voice keyer message for
247 that key.
248
249 1: Start contest recording to ddhhmm.au.
250
251 2: Stop contest recording.
252
253 3: List contest recordings.
254
255 4: Play back contest recording ddhh[mm][:xx].
256
257 xx is the offset from the start of the file e.g.:
258
259 2110 will start from beginning of the day 21 hr 10:00
260 file.
261
262 21100013:00 will start from day 21, hh 10, mm 00, + 13
263 minutes: 0 seconds.
264
265 To create a new file every hour add a crontab(1) job to run the
266 following command every hour:
267
268 /usr/bin/pkill -f sox > /dev/null 2> /dev/null
269
270 Running the crontab job at other intervals will create
271 sound recordings of the interval period in length.
272
273 Once started the recorder will run until the lock file
274 $HOME/.VRlock is removed.
275
276 :SYNc Synchronize the logfile of this node with the logfile pointed to
277 by the parameter SYNCFILE=user:password@host/dir/logfile. Tlf
278 will wget(1) the logfile from the relevant node, make a dated
279 backup of your local logfile, and merge the 2 files. The score
280 will be recalculated.
281
282 :TONe [dd]d
283 Set PC sidetone frequency in Hertz. Range: 300–900, 0 = Off.
284
285 :TRXcontrol
286 Toggle rig control On|Off. Default is Off unless RADIO_CONTROL
287 is given in logcfg.dat (only makes sense with rig control capa‐
288 bility).
289
290 :VIEw View the log with less(1).
291
292 :WRIte Write cabrillo file according to specified format (see CABRILLO
293 statement in the RULES section).
294
296 Work has been ongoing to unify the key map between the Linux text con‐
297 sole and the various X terminals. It may be slightly different on cer‐
298 tain X terminals depending on which keys they consume for their own
299 use. Turn off any key recognition by the terminal for its own purposes
300 (menu access, help display, etc.) if possible. Pay special attention
301 to the F1-F12 and Alt-<char> keys. Moreover, on some systems you must
302 set the TERM=linux or TERM=rxvt environment variables. This also works
303 under VNC.
304
305 Certain key combinations will probably not be useable as the Linux con‐
306 sole consumes Alt-F1 through Alt-Fx (often F7, but could be greater)
307 for switching its virtual consoles. Likewise, the various desktop en‐
308 vironments consume key combinations for their own use. Ctrl-F1 through
309 Ctrl-Fx are used to switch desktop workspaces. Alt-Fx combinations are
310 used for various desktop features and are unavailable for Tlf use.
311
312 Some desktop terminal emulators are capable of being configured to al‐
313 low the application running in them to get all of the keys the desktop
314 environment does not consume. In testing good choices seem to be Gnome
315 Terminal, Rox Terminal, or the classic Xterm (although its color repre‐
316 sentation differs from the Linux console and other terminal emulators).
317 Xfce Terminal is known to consume F11 and Ctrl-PageUp and Ctrl-Page‐
318 Down. The Tlf developers have implemented Alt-PageUp and Alt-PageDown
319 as a work-around for the Ctrl counterparts. Reports of success with
320 other terminals are welcome.
321
322 Call Input and Exchange Fields
323 The Call Input and Exchange Fields are the two main entry fields of Tlf
324 where the majority of the keyboard entry takes place. The call input
325 field is active when Tlf completes its initialization and presents the
326 main screen.
327
328 Most key sequences are the same in both fields. Differences are noted
329 as necessary.
330
331 A-Z, 0-9, /
332 Call input: ASCII letters, numerals, and the '/' characters that
333 make up an internationally recognized amateur radio callsign
334 plus temporary location identifiers. Spaces are not allowed.
335
336 Exchange: information provided by the other station possibly
337 separated by spaces, e.g., ARRL Field Day and ARRL Sweepstakes.
338
339 Space Switches from call input to exchange field. Separates exchange
340 field elements when multiple exchange elements must be entered,
341 e.g., ARRL Field Day and ARRL Sweepstakes.
342
343 Tab Switch between call input and exchange fields (jump back to call
344 input from exchange field).
345
346 Enter Smart key depending on contest mode.
347
348 Tlf follows the TR operating style which has two modes, CQ and
349 S&P.
350
351 CQ mode is used for “running”, i.e., staying on one frequency
352 and having other stations answer your call.
353 S&P mode is for tuning up or down the band and answering the
354 calls of other stations.
355
356 In CQ Mode:
357
358 • With the call input field empty, ‘Enter’ sends the F12 message
359 (Auto CQ).
360
361 • With characters in the call input field, ‘Enter’ answers the
362 calling station by sending the F3 message (RST) and moves the
363 cursor to the exchange field.
364
365 • If the exchange field is empty, ‘Enter’ repeats the F3 message
366 (RST).
367
368 • After the exchange information received from the other station
369 is entered, ‘Enter’ sends the CQ_TU_MSG message if defined, or
370 “TU” and your call otherwise. Afterwards it logs the QSO, and
371 returns the cursor to the call input field to answer the next
372 call.
373
374 In S&P Mode:
375
376 • When the call input field is empty, ‘Enter’ sends the
377 S&P_CALL_MSG if defined, or your call otherwise.
378
379 • When the exchange field is empty, ‘Enter’ sends the
380 S&P_CALL_MSG if defined, or your call otherwise.
381
382 • When the call input field has been filled, ‘Enter’ sends the
383 S&P_CALL_MSG if defined, or your call otherwise. Afterwards
384 it moves the cursor to the exchange field.
385
386 • Once the exchange has been received, ‘Enter’ sends the
387 S&P_TU_MSG if defined, otherwise it sends your call followed
388 by the F3 message (RST). Afterwards it logs the QSO and re‐
389 turns the cursor to the call input field to answer the next
390 call.
391
392 Backspace
393 Erases the character to the left of the cursor and moves the
394 cursor one position to the left.
395
396 Escape Stop CW transmission, clears characters, returns to call input
397 field, keyboard off (universal undo).
398
399 As an example, characters have been entered in both the call in‐
400 put and exchange fields, the cursor is in the exchange field,
401 and the transmission of a CW message is in progress. The first
402 press of ‘Escape’ will stop the CW transmission and clear the
403 exchange field and position the cursor to the leftmost position
404 of the exchange field. The second press of ‘Escape’ will move
405 the cursor to the right of the last character in the call input
406 field. The third press of ‘Escape’ will clear the call input
407 field.
408
409 ← (Left-Arrow)
410 Change to next band lower or wrap to highest band if already on
411 the lowest band when callsign field empty.
412
413 Enter edit mode if one or more characters are present and move
414 the cursor to the left of the rightmost character.
415
416 → (Right-Arrow)
417 Change to next band higher or wrap to the lowest band if already
418 on the highest band when call input field is empty.
419
420 F1 In CQ mode, send message F1 (CQ).
421 In S&P mode send message F6 (MY).
422
423 Shift-F1
424 Restore previous CQ frequency from MEM and send message F1 (CQ).
425
426 F2-F11 Send CW, RTTY or VOICE messages 2 through 11.
427
428 F12 Start Auto_CQ (only from call input field). Sends F12 message
429 repeatedly pausing for Auto_CQ delay time between messages.
430 Auto_CQ is cancelled with first character entry into the call
431 input field.
432
433 + (Plus)
434 Toggle between the CQ and S&P modes.
435
436 PgUp Increase CW (Morse Code) speed (from call and exchange fields).
437
438 If the cursor is in the call input field and it is not empty and
439 CHANGE_RST is set: increase his S value (the leftmost of the RST
440 pair).
441
442 If the cursor is in the exchange field and it is not empty and
443 CHANGE_RST is set: increase my S value (the rightmost of the RST
444 pair).
445
446 PgDown Decrease CW (Morse Code) speed (from call input and exchange
447 fields).
448
449 If the cursor is in the call input field and it is not empty and
450 CHANGE_RST is set: decrease his S value (the leftmost of the RST
451 pair).
452
453 If the cursor is in the exchange field and it is not empty and
454 CHANGE_RST is set: decrease my S value (the rightmost of the RST
455 pair).
456
457 Ctrl-PgUp
458 Alt-PgUp
459 Increase Auto_CQ delay pause length (+1/2 sec).
460
461 Set Auto_CQ delay to message length + pause length.
462
463 Ctrl-PgDown
464 Alt-PgDown
465 Decrease Auto_CQ delay pause length (-1/2 sec).
466
467 As some terminals, Xfce Terminal is one such, consume Ctrl-
468 PageUp/Ctrl-PageDown, the Alt-key combinations allow for setting
469 the Auto_CQ delay pause length.
470
471 NB: If neither key combination works try :CQD instead.
472
473 ? (Query)
474 In CW or DIGIMODE sends the partial call followed by “ ?”. In
475 VOICE mode sends recorded message 5 (F5).
476
477 ; (Semicolon)
478 Insert note in log.
479
480 , (comma)
481 Activate Morse Keyboard. Also Ctrl-K.
482
483 " (Double quotation)
484 Send talk message to other Tlf nodes.
485
486 - (Minus)
487 Delete last QSO (Use :REScore to correct scoring afterward).
488
489 ↑ (Up-Arrow)
490 Edit last QSO: Insert, overwrite, and delete; + log view.
491
492 = (Equals)
493 Confirm last call.
494
495 _ (Underscore)
496 Confirm last exchange.
497
498 { (Open brace)
499 In RTTY (DIGIMODE), keyboard mode switch TX on.
500
501 } (Close brace)
502 In RTTY (DIGIMODE), keyboard mode switch TX off (RX).
503
504 \ (Backslash)
505 Log QSO without CW output.
506
507 In RTTY (DIGIMODE), keyboard mode switch controller to command
508 mode (back to operating mode with “K ‘Enter’”.
509
510 # (Hash)
511 Transceiver VFO frequency → MEM, MEM → transceiver VFO fre‐
512 quency.
513
514 $ (Dollar)
515 Pop MEM frequency: MEM → transceiver VFO frequency and clear
516 MEM.
517
518 % (Percent)
519 Swap transceiver VFO frequency and MEM.
520
521 ! (Exclamation)
522 Get a new shell. Come back with “exit”.
523
524 Alt-,
525 . (Period)
526 Change bandmap filter configuration. You can filter to show
527 spots from all or own band only, from all/own mode only and if
528 you want to see dupes or not (see the help (Alt-H) display),
529 only new multiplier or all call (only CQWW).
530
531 Ctrl-A Add a spot to bandmap and broadcast it on the local network.
532
533 Ctrl-B Send a spot to the DX Cluster (a connection to a DX cluster must
534 exit).
535
536 Ctrl-C
537 Ctrl-D Exit Tlf (synonyms to :EXIt, :QUIt, Alt-Q, and Alt-X).
538
539 Ctrl-E Ends modem capture for RTTY mode in QTC window (started with
540 Ctrl-S).
541
542 See /usr/share/doc/README_QTC_RTTY.txt for more information.
543
544 Ctrl-F Set frequency. Use Up/Down-Arrow for 100hz steps and Pg-Up/Pg-
545 Down for 500hz steps. Return to logging with ‘Escape’.
546
547 Ctrl-G Grab next DX spot from bandmap.
548
549 Ctrl-K Keyboard (CW and RTTY).
550
551 Ctrl-L Reset the screen.
552
553 Ctrl-P Maximum Usable Frequency (MUF) display.
554
555 Ctrl-Q Open the QTC window for receiving QTCs if QTC=RECV or QTC=BOTH
556 or sending QTCs if QTC=SEND is set in logcfg.dat. Same as Ctrl-
557 S if QTC=SEND.
558
559 See /usr/share/doc/README_QTC.txt and
560 /usr/share/doc/README_QTC_RTTY.txt for more information.
561
562 Ctrl-R Toggle /dev/lp0 pin 14 (Mic/Soundcard switch | trx1/trx2
563 switch).
564
565 Ctrl-S Open the QTC window for sending QTCs if QTC=SEND or QTC=BOTH in
566 logcfg.dat. Saves QTCs while in QTC window.
567
568 In RTTY mode starts capture from the modem after the window has
569 been opened with Ctrl-Q. End capture with Ctrl-E.
570
571 See /usr/share/doc/README_QTC.txt and
572 /usr/share/doc/README_QTC_RTTY.txt for more information.
573
574 Ctrl-T Show talk messages. In the QTC window shows RTTY lines.
575
576 Ctrl-Z Stop Tlf.
577
578 Alt-0...Alt-9
579 Send CW (Morse code) messages.
580
581 Alt-A Cycle cluster window: NOCLUSTER → CLUSTER → BANDMAP → ...
582
583 Alt-B Band up in TR-Log mode.
584
585 Alt-C Toggle display of checkwindow.
586
587 Alt-E Enter QSO edit mode.
588
589 Alt-G Grab first spot from bandmap which has the characters in the
590 call input field in its call. Allows the operator to selec‐
591 tively grab a specific call from the bandmap.
592
593 Alt-H Show help.
594
595 Alt-I Show talk messages.
596
597 Alt-J Show other local stations frequencies.
598
599 Alt-K Keyboard (CW and RTTY).
600
601 Alt-M Show multipliers.
602
603 Alt-N Add Note to log.
604
605 Alt-P Toggle PTT (via cwdaemon).
606
607 Alt-Q
608 Alt-X Exit Tlf (synonym to :EXIt , :QUIt , Ctrl-C, and Ctrl-D).
609
610 Alt-R Toggle score window.
611
612 Alt-S Toggle score window.
613
614 Alt-T Tune your transceiver (via cwdaemon). Activates PTT and Key
615 output for 6 seconds. Stop tuning by pressing any key.
616
617 Alt-V Band down.
618
619 Alt-W Set CW weight.
620
621 Alt-Z Show zones worked.
622
623 CT Compatible Mode
624 Tlf has limited support for the logging sequence keys used in the once
625 popular CT logging program. Unlike the default Enter Sends Message
626 (ESM) mode, the CT Compatible mode uses the Insert and + keys in the
627 logging sequence and Enter logs a complete QSO. Unlike ESM mode, CT
628 mode does not have separate CQ or S&P modes.
629
630 CT Compatible mode is enabled with the CTCOMPATIBLE keyword in
631 logcfg.dat (see the PREFERENCES section below).
632
633 The following keys differ in behavior in CT Compatible mode.
634
635 Enter Log the complete QSO without sending any message macro.
636
637 If the callsign field is empty, pressing Enter will activate the
638 Auto-CQ function. If the exchange field is empty, pressing En‐
639 ter in either the callsign or exchange field will result in no
640 action.
641
642 Insert Send the RST (F3) macro.
643
644 Since the RST macro includes the other station's callsign by de‐
645 fault, the HIS macro is not sent first. This differs from clas‐
646 sic CT, but is a compromise to use the default Tlf macros.
647
648 + (Plus)
649 Send the TU macro and log the QSO.
650
651 The + key checks if the exchange field is empty and if it is
652 nothing is sent or logged. In rare cases where nothing needs to
653 be entered in the exchange field, e.g. working DX from USA in
654 ARRL 160, simply enter a space to allow the + key to send the TU
655 message and log the QSO.
656
657 Alt-V Change CW speed.
658
660 Tlf can be fully configured by editing the logcfg.dat file. Normally
661 you keep one logcfg.dat file, setting up your callsign, the log file
662 name, the ports and addresses for packet, the radio, the network etc.,
663 and a separate rules file per contest.
664
665 The logcfg.dat file can be edited from within Tlf by the :CFG or :SET
666 commands (or with any other plain text editor before starting Tlf).
667
668 You can set your favourite editor in the logcfg.dat file.
669
670 You connect the rules file by using the statement RULES=con‐
671 test_rules_file_name in logcfg.dat.
672
673 Tlf will first look in the working directory for a logcfg.dat file, and
674 if it cannot find one it will look in /usr/share/tlf for a default one.
675 Make sure you edit the logcfg.dat file at least to hold your call and
676 your preferred system configuration.
677
679 Configuration parameters set in logcfg.dat located in the working di‐
680 rectory (where Tlf is started).
681
682 RULES=contest_rules_filename
683 Name of the rules file to load. It helps if you name the rules
684 file according to the contest you want to describe.
685
686 SYNCFILE=user:password@host/dir/syncfile
687 File on remote host you want to synchronize with (use wget(1)
688 syntax).
689
690 CTCOMPATIBLE
691 Do not use the TR-Log QSO sequence, but use ‘+’, ‘Insert’ and
692 ‘Enter’ to log the QSO.
693
694 The default mode of operation is the TR-Log sequence which uses
695 ‘+’ to switch between CQ and S&P modes, in which ‘Enter’ is the
696 sole key used to call the other station, send the exchange, and
697 log the QSO.
698
699 TLFCOLORn=FG/BG
700 Defaults:
701 TLFCOLOR1=23 (Header and footer)
702 TLFCOLOR2=67 (Pop up windows)
703 TLFCOLOR3=70 (Log window)
704 TLFCOLOR4=57 (Markers/dupe colour)
705 TLFCOLOR5=43 (Input fields)
706 TLFCOLOR6=63 (Window frames)
707
708 The numbers are given in octal, FG/BG or BG/FG (some experimen‐
709 tation likely required).
710
711 You should only specify these if you wish to modify the standard
712 colours of Tlf. In some Terminals you can set a special profile
713 for Tlf with your own colours. Another way is to define the
714 colours via the $HOME/.Xresources file.
715
716 EDITOR=nano | vi[m] | <your_favorite_editor>
717 Editor used to modify the QSO log or logcfg.dat. The command
718 specified receives the file name as an argument.
719
720 When using a GUI editor that runs in the background (e.g. gvim)
721 make sure to exit the editor before logging new stations. You
722 also have to use :RES command to reread the log and correct
723 scoring.
724
725 Best is to force the editor to stay in foreground (e.g. with
726 'gvim -f').
727
728 CALL=PA0R
729 Your call used in messages and used to determine your country,
730 zone and continent.
731
732 TIME_OFFSET=0
733 Used to shift the Tlf time with respect to the computer clock.
734 Normally 0. Range: 0–23.
735
736 TIME_MASTER
737 This node transmits the time over the network (only one master
738 allowed!).
739
740 ADDNODE=Node_address[:Port_number]
741 Adds an IP address (and optionally a port number) to which we
742 broadcast stuff. (WARNING: Only add addresses of other nodes).
743
744 THISNODE=A
745 Node designator (default “A”). If Tlf hears its own node ID on
746 the network it will exit and ask you to pick another one!
747 Range: A–H.
748
749 LAN_PORT=Portnumber
750 Specifies on which portnumber (default “6788”) Tlf is listening
751 for broadcasts from other instances.
752
753 LANDEBUG
754 Switches on the debug function. Dumps all Tlf net traffic re‐
755 ceived on this node into a file named debuglog in the working
756 directory. This log can be used as a backup log for the whole
757 network, as it is easy to retrieve QSO data, cluster messages,
758 gab messages etc. after the contest. Some users have this en‐
759 abled all the time.
760
761 NETKEYER
762 Switches the CW keyer on. Only the IP networked keyer cwdaemon
763 or any other program that emulates cwdaemon such as winkeydaemon
764 is supported. You may also need the keyer for PTT control or
765 band info output.
766
767 NETKEYERPORT=port_number
768 Default port is 6789.
769
770 NETKEYERHOST=host_address
771 Default host is 127.0.0.1 (localhost).
772
773 MFJ1278_KEYER=serial_port
774 Activates support for the MFJ-1278B multi-mode controller. The
775 MFJ-1278 supports CW as well as RTTY contesting. Fixed serial
776 port rate is 9600 bps.
777
778 CWSPEED=speed_in_WPM
779 Range: 4–69.
780
781 WEIGHT=weight_ratio
782 Set the dot to dash ratio. Only for the NETKEYER. Range:
783 -45–50.
784
785 TXDELAY=PTT_delay_in_mS
786 Delay activation of the Push To Talk pin. Range: 0–50.
787
788 KEYER_BACKSPACE
789 Support backspace key in keyer window.
790
791 SOUNDCARD
792 Use soundcard for sidetone output.
793
794 SIDETONE_VOLUME=soundcard_volume
795 Set soundcard sidetone volume (default is 70). A value of 0
796 turns off sidetone output (even for the console speaker).
797 Range: 0–99.
798
799 CQDELAY=Auto_cq
800 Set automatic CQ pause delay in 1/2 seconds increments between
801 message transmissions. Range: 3–60.
802
803 CWTONE=sidetone
804 Set the PC speaker or soundcard frequency. A value of 0
805 switches the sidetone off. Range: 0–999.
806
807 (Due to a bug in cwdaemon it also turns off the Alt-T tune func‐
808 tion. Use SIDETONE_VOLUME=0 instead).
809
810 BANDOUTPUT
811 Outputs band information to pins 2, 7, 8, 9 on the parallel
812 port. Output is 1 (160m), 2 (80m) ... 9 (10m). This format is
813 compatible with the standard interface for antenna switches,
814 band filters etc.
815
816 BANDOUTPUT=124181818
817 Output pin 2 for 160, 30, 17 and 12, pin 7 for 80, pin 8 for 40,
818 and pin 9 for 20, 15 and 10. This comes in handy when you have
819 3 dipoles and a 3-band beam (...).
820
821 NO_BANDSWITCH_ARROWKEYS
822 This will prevent unwanted band switching when you are not using
823 rig control. Band up = Alt-B, band down = Alt-V (TR-Log compat‐
824 ible).
825
826 TELNETHOST=cluster_address
827 Use Telnet to connect to a DX Cluster node using a DNS name or
828 IP address, e.g. claudia.esrac.ele.tue.nl or 131.155.192.179.
829
830 TELNETPORT=telnet_port_of_cluster
831 DX Clusters often use a non-standard port for Telnet, e.g. 8000.
832
833 TNCPORT=serial_port
834 You can use /dev/ttyS0, /dev/ttyUSB1, etc. anything that looks
835 like a tty.
836
837 TNCSPEED=serial_rate
838 Tlf supports 1200, 2400, 4800 and 9600 bps.
839
840 FIFO_INTERFACE
841 The FIFO (First In First Out) interface is used when you want to
842 receive cluster info from the network, or from another source.
843 The FIFO interface uses a special FIFO file in the working di‐
844 rectory called clfile. Anything you dump into this FIFO will be
845 displayed by the packet interface.
846
847 RADIO_CONTROL
848 Switches the radio interface on. The rig interface makes use of
849 the Hamlib library which supports a number of different rigs.
850
851 RIGMODEL=rig_number
852 Look at the Hamlib documentation for the rig_number.
853
854 Hint: rigctl -l and its manual page (rigctl(1)).
855
856 RIGSPEED=serial_rate
857 Speed of the serial port for rig control.
858
859 RIGPORT=serial_port
860 You can use /dev/ttyS0, /dev/ttyUSB1, etc. anything that looks
861 like a tty.
862
863 RPC rig daemon users should use RIGMODEL=1901 and RIGPORT=local‐
864 host. In this case RIGSPEED is ignored (NB: rig model 1901 is
865 deprecated in Hamlib releases 3.0 and later and is replaced by
866 rigctld(8) which is rig model 2).
867
868 RIGCONF=rig_configuration_parameters
869 Send rig configuration parameters to Hamlib.
870 e.g. RIGCONF=civaddr=0x40,retry=3,rig_pathname=/dev/ttyS0
871
872 RIT_CLEAR
873 Clears the RIT after logging the qso. This only works if the
874 rig, and the Hamlib routine supports it (tested on the OMNI 6+).
875
876 RIGPTT Declares that Hamlib CAT PTT capability should be checked at
877 startup and if available use it to activate the radio's PTT for
878 sending voice messages instead of the NetKeyer PTT.
879
880 CWBANDWIDTH=width
881 Sets the CW bandwidth of your rig when changing bands. If unset
882 or 0 the default bandwidth (as determined by Hamlib) is used. (a
883 valid bandwidth for the rig must be used).
884
885 SC_DEVICE=device
886 Sound card device for scan function.
887 e.g. SC_DEVICE=/dev/dsp0
888
889 SSBMODE
890 Start Tlf in SSB mode (default is CW).
891
892 RTTYMODE
893 Start Tlf in RTTY mode (defaul is CW)
894
895 GMFSK=$HOME/gMFSK.log
896 Tell miniterm(1) where to get the data.
897
898 DIGIMODEM=$HOME/gmfsk_autofile
899 Tell Tlf where to send the macros.
900
901 CLUSTER
902 Show cluster window at startup.
903
904 CLUSTERLOGIN=yourcall
905 Automatic login for the telnet client.
906
907 CLUSTER_LOG
908 Write clusterlog to disk.
909
910 BANDMAP
911 Shows cluster bandmap on startup. Use '.' to change bandmap
912 filtering.
913
914 BANDMAP=xyz,number
915 Show cluster bandmap on startup and set start values for filter‐
916 ing.
917 <xyz> string parsed for:
918 “B” - only own band
919 “M” - only own mode
920 “D” - do not show dupes
921 “S” - skip dupes during grab_next (Ctrl-G)
922 “O” - show only multiplier (CQWW only)
923 <number> livetime for new spots in seconds (number >= 30)
924
925 SCOREWINDOW
926 Show the score window (same as Alt-R).
927
928 CHECKWINDOW
929 Show the country/call check window.
930
931 PARTIALS
932 Show a list of possible contest calls.
933
934 USEPARTIALS
935 Use the auto-complete utility (takes some practice...). Tlf
936 will complete the call as soon as it is unique in the database.
937 This can of course lead to strange effects, but in practice
938 there are far more hits than misses. Sometimes you must edit
939 the call because it has locked on a unique call. Try it, and
940 switch it off when you don't like it.
941
942 LOGFREQUENCY
943 Put frequency (kHz) into QSO number to enable logging of fre‐
944 quency (only QSO and dxped mode).
945
946 IGNOREDUPES
947 Enable to allow multiple QSOs in a contest with the same station
948 (considered a good idea these days as contest bots will take
949 care of dupes).
950
951 SUNSPOTS=SSN
952 Set the sunspots value which is used to do a rough calculation
953 of the MUF. If the cluster interface is used the SSN will be
954 updated by WWV or WCY messages.
955
956 SFI=Solar_flux_value
957 Set SFI used to calculate SSN. The SSN value is used to do a
958 rough calculation of the MUF. If the packet interface is used
959 the SSN will be updated by WWV or WCY messages.
960
961 CHANGE_RST
962 If set in logcfg.dat, PgUp and PgDown will change RST instead of
963 CW speed if field is not empty.
964 Default is Off.
965
966 NOB4 Do not send automatic “QSO B4” message.
967 Default is On.
968
969 NOAUTOCQ
970 No automatic CQ when pressing ‘Enter’ or ‘F12’.
971
972 MARKERS=file_name
973 Generate marker file for Xplanet. Xplanet will show the last 8
974 spots on an azimuthal map. See the relevant Xplanet documenta‐
975 tion. Use azimuthal projection and center the map on your QTH.
976
977 POWERMULT=power_multiplier
978 Use this value to multiply the final points. If the contest
979 rule allows one to use the power multiplier (e.g. Stewperry,
980 ARRL-FD), you can pass that here.
981
982 NB: The type of POWERMULT is a float, e.g. POWERMULT=1.5, but
983 the final score will be rounded by the C library floor(3) func‐
984 tion, which gives the largest integer value that is not greater
985 than multiplied score.
986
987 SEND_DE
988 Sends a “DE” word before your callsign, e.g. “DE W1AW”. There is
989 a special case: if SEND_DE is present in logcfg.dat, and Tlf if
990 is in DIGIMODE, then the other station's callsign will be sent
991 before “DE”, e.g. “DL1A DE W1AW”.
992
993 DIGI_RIG_MODE=mode
994 If set with RADIO_CONTROL option, specifies the mode to change
995 the rig to when :DIG mode is selected. mode may be one of “USB”,
996 “LSB”, “RTTY”, or “RTTYR”. If not set, “USB” is used if FLDIGI
997 is set and “LSB” is used otherwise.
998
1000 The contest rules can be put into separate files. Tlf will first look
1001 for a directory called rules/ in the working directory, and a file
1002 named for the contest, e.g. cqww. If Tlf cannot find such a file, it
1003 will look into the directory /usr/share/tlf/rules. A rules file con‐
1004 tains contest specific parameters like multipliers, scoring rules, CW
1005 and voice keyer messages, etc.
1006
1007 NB: The rules file overrides settings from the logcfg.dat file!
1008
1009 WARNING! It is your own responsibility to try these rules well BEFORE
1010 the contest. The authors of Tlf cannot possibly check all rules for
1011 all contests :) and during the contest there is normally no time to fix
1012 it.
1013
1014 CONTEST=xxxxx
1015 Name of the contest (same as the file name contest_name refer‐
1016 enced above). Some contests, like CQWW and WPX, are pre-pro‐
1017 grammed. Look for the relevant rules file in
1018 /usr/share/tlf/rules.
1019
1020 LOGFILE=log_file_name
1021 Mandatory!
1022
1023 CABRILLO=cabrillo_format
1024 Specify the name of the cabrillo format to use (see
1025 doc/README.cab).
1026
1027 CONTEST_MODE
1028 Sets Tlf into contest mode. Do not use this parameter for nor‐
1029 mal QSO logging!
1030
1031 NO_RST Do not use RST in contest, e.g. for CW Open, ARRL Sweepstakes,
1032 or ARRL Field Day. If you want to write a Cabrillo log you must
1033 provide a conforming format definition without RST values.
1034
1035 CQWW_M2
1036 Put the node ID into the logline (just after the QSO number) to
1037 support Multi/2 operation where the station logging the QSO must
1038 be in the Cabrillo file. This can also be used for M/1 and M/M,
1039 to enable post-contest analysis of the nodes.
1040
1041 Macro characters in the messages
1042 % = mycall, @ = hiscall, # = serial number, [ = RST, + = in‐
1043 crease cw speed, - = decrease cw speed, * = AR, = = BT, < = SK,
1044 ( = KN, ! = SN, & = AS, > = BK, ! = his serial (e.g. confirm
1045 exchange of station in DIGIMODE).
1046
1047 F1="cw message 1"
1048 CQ message, (e.g. CQ de PA0R TEST).
1049
1050 F2="cw message 2"
1051 S&P call message, (e.g. @ de %).
1052
1053 F3="cw message 3"
1054 Exchange message, (e.g. @ ++5NN--#).
1055
1056 F4="cw message 4"
1057 TU message, (e.g. TU 73 %).
1058
1059 F5="cw message 5"
1060 Call of the other station (e.g. @).
1061
1062 F6="cw message 6"
1063 Your call (e.g. %).
1064
1065 F7="cw message 7"
1066 QSO B4 message (e.g. @ sri qso b4 gl).
1067
1068 F8="cw message 8"
1069 Again message (e.g. AGN).
1070
1071 F9="cw message 9"
1072 Query message (e.g. ?).
1073
1074 F10="cw message 10"
1075 QRZ message (e.g. QRZ?).
1076
1077 F11="cw message 11"
1078 Please reply message (e.g. PSE K).
1079
1080 F12="cw message 12"
1081 Auto-CQ message (e.g. +++TEST %---).
1082
1083 CQ_TU_MSG="cw message 13"
1084 Auto Exchange message in CQ mode (TR-Log mode), (e.g. TU %).
1085
1086 S&P_TU_MSG="cw message 14"
1087 Auto Exchange message in S&P mode (TR-Log mode), (e.g. TU 5NN
1088 #).
1089
1090 S&P_CALL_MSG="cw message 25"
1091 Custom call message in S&P mode. Allows replacing the auto-gen‐
1092 erated S&P call message.
1093
1094 Alt_0=<...> ... Alt_9=<...>
1095 Up to 10 additional messages.
1096
1097 SHORT_SERIAL
1098 Uses short form for serial number (599=5NN, 001=TT1).
1099
1100 LONG_SERIAL
1101 Uses long form for serial number (default).
1102
1103 VKM1=voice message file name 1 ... VKM12=voice message file name 12
1104 Use F1 ... F12 keys to send recorded messages for phone.
1105
1106 VKCQM=voice_message_file_name
1107 Auto Exchange voice message in CQ mode (TR-Log mode)
1108
1109 VKSPM=voice_message_file_name
1110 Auto Exchange voice message in S&P mode (TR-Log mode)
1111
1112 ONE_POINT
1113 One point per QSO.
1114
1115 TWO_POINTS
1116 Two points per QSO.
1117
1118 THREE_POINTS
1119 Three points per QSO
1120
1121 CWPOINTS=d
1122 Points per CW QSO.
1123
1124 SSBPOINTS=d
1125 Points per SSB QSO.
1126 NB: SSBPOINTS and CWPOINTS need to be set for both to work!
1127
1128 MY_COUNTRY_POINTS=d
1129 Points for working your own DXCC entity (often zero (0)).
1130
1131 MY_CONTINENT_POINTS=d
1132 Points for working countries in your own continent.
1133
1134 DX_POINTS=d
1135 Points for working a station in other continents.
1136
1137 2EU3DX_POINTS
1138 Deprecated. Use MY_CONTINENT_POINTS and DX_POINTS instead.
1139
1140 COUNTRY_LIST_POINTS=d
1141 Points for countries in country list.
1142
1143 USE_COUNTRYLIST_ONLY
1144 Score zero points for countries not in the list.
1145
1146 COUNTRYLIST="comma separated list of prefixes starting with colon"
1147 e.g. Scandinavia:SM,LA,OZ,OH.
1148
1149 COUNTRYLIST=file_name
1150 File with a list of prefixes.
1151
1152 PORTABLE_MULT_2
1153 Multiply points x2 for portable stations (e.g. R1 field day).
1154
1155 LOWBAND_DOUBLE
1156 Double all points for lowband (40, 80, and 160m) QSOs (can be
1157 combined with any other value). (Will be deprecated in future!
1158 Use BANDWEIGHT_POINTS instead.)
1159
1160 WYSIWYG_MULTIBAND
1161 Exchange is multiplier, per band, whatever you enter. Tlf
1162 builds its own list of multipliers.
1163
1164 WYSIWYG_ONCE
1165 Exchange is multiplier, whatever you enter. Counts once for the
1166 whole contest (not per band).
1167
1168 WAZMULT
1169 Multiplier is the CQ zone (per band).
1170
1171 ITUMULT
1172 Multiplier is the ITU zone (per band).
1173
1174 PFX_MULT
1175 Multiplier is prefix (PA0, DA2, VE7, etc.). Counted once per
1176 contest, not per band.
1177
1178 PFX_MULT_MULTIBAND
1179 Same as WPX, but the WPX only used CQ-WW-WPX, and there a single
1180 prefix multiplier only once, not all band. With this option, the
1181 PFX counts as multiplier on all band. This usable on AA-DX.
1182
1183 COUNTRY_MULT
1184 Multiplier is the DXCC entity (per band).
1185
1186 MULT_LIST=file_name
1187 Name of multipliers file (often sections, provinces, states,
1188 counties). May contain comment lines starting with “#” in the
1189 first column. Each multiplier resides on a single line by it‐
1190 self.
1191
1192 Starting from Tlf-1.4 on you can also use aliases for the multi‐
1193 pliers. Define the aliases as
1194
1195 multiplier:alias1,alias2,alias3
1196
1197 If you log a QSO with one of the aliases it will be counted for
1198 as the according multiplier. You can have more than one line for
1199 the same multiplier.
1200
1201 SECTION_MULT
1202 Multiplier is section from multipliers file.
1203
1204 SERIAL+SECTION
1205 Exchange is serial number and section, multiplier is section
1206 from multiplier file. Mults count per band.
1207
1208 SERIAL_OR_SECTION
1209 Exchange is serial number or section. This option is similar to
1210 SERIAL+SECTION, except the exchange could be a serial OR the
1211 section. The options was introduced for HA-DX, where HA sta‐
1212 tions give the shortest form of their county, other stations
1213 give serial.
1214
1215 SERIAL+GRID4
1216 Exchange is serial number and grid (e.g. JO21QI), multipler is
1217 4-character grid (JO21). Mults count per band.
1218
1219 DX_&_SECTIONS
1220 Multiplier is DXCC country or section from multiplier file.
1221
1222 RECALL_MULTS
1223 Exchange can be recycled, will be filled into exchange field
1224 when it is known (see also INITIAL_EXCHANGE).
1225
1226 INITIAL_EXCHANGE=exchanges.txt
1227 The file must contain a comma-separated list of exchanges, if
1228 e.g. the exchange is the name of the operator:
1229 PA0R,rein
1230 PG4I,joop
1231 OK1RR,martin
1232
1233 If RECALL_MULTS is set, Tlf will look in this list for the ex‐
1234 change and fill it in for you. There are various contests which
1235 have a standard exchange, like e.g. the FOC Marathon. The mod‐
1236 ule also recognises embedded calls (CT3/PA0R/QRP).
1237
1238 CALLMASTER=callmaster
1239 Allow to name a different file used as callmaster database (de‐
1240 fault is 'callmaster'). See FILES section.
1241
1242 CONTINENT_EXCHANGE
1243 Exchange is continent (NA, SA, EU, AS, AF, OC).
1244
1245 SERIAL_EXCHANGE
1246 Exchange is serial number (formats exchange field).
1247
1248 MIXED Station can be worked both in SSB and CW.
1249
1250 SSBMODE
1251 Start Tlf in SSB mode.
1252
1253 MYQRA For the “Stewperry” contest, this option is used to set the QRA,
1254 e.g.: JN97, or the full form: JN97OM. In Stewperry, the points
1255 are calculated based on the distance between the stations.
1256
1257 QTC If you want to send or receive QTC's on contest (usually on
1258 WAEDC), put this option to logcfg.dat. This needs a parameter,
1259 which could be one of these: RECV, SEND, BOTH - note, that cur‐
1260 rently just the RECV works. For more information, please see the
1261 README_QTC.txt file.
1262
1263 QTC_CAP_CALLS=list_of_qtc_capable_callsigns.txt
1264 If you want to help yourself to indicate that the station is QTC
1265 capable, you can see it on your bandmap or worked window. Put
1266 the callsign of stations in a file, one callsign per line, and
1267 give it as an argument to this variable.
1268
1269 QTC_AUTO_FILLTIME
1270 If you use QTC feature, and you are on EU station in CW/SSB
1271 modes, then you can only RECEIVE the QTC's. Most sender station
1272 send their QTC's as a most short form, example, after the first
1273 line it doesn't send the first two characters of time field. If
1274 you set this option, then when you fill the first QTC line, then
1275 Tlf will fills the other time fields, only the first two charac‐
1276 ters. Of course, if you change the hour (eg., if there is a
1277 time: 2059, and the next one is 2100), then all next time fields
1278 will be changed.
1279
1280 QTC_RECV_LAZY
1281 If you use QTC feature, and you are on EU station in CW/SSB
1282 modes, then you can use this feature. In normal case, Tlf checks
1283 all received QTC lines: the time field must be 4 characters
1284 long, callsign and serial fields must be non-empty. If you set
1285 up this option, Tlf will ignore this restrictions.
1286
1287 CONTINENTLIST="comma separated list of continents"
1288 Valid values are: SA, NA, EU, AF, AS and OC.
1289
1290 CONTINENT_LIST_POINTS=d
1291 Points for stations from continents in CONTINENTLIST
1292
1293 USE_CONTINENTLIST_ONLY
1294 Score zero points for station from continents not in the list.
1295
1296 BANDWEIGHT_POINTS
1297 Allow a point weighting factor for different bands. E.g.
1298 BANDWEIGHT_POINTS=160:3,80:2,40:1,20:1,15:1,10:2
1299 can be used for AADX contest. It will multiply all QSO points by
1300 3 on 160m, by 2 on 80m and 10m and on all other bands only by 1.
1301
1302 Bands not in list are weighted by 1.
1303
1304 BANDWEIGHT_MULTIS
1305 Allow a weigthing factor for multipliers on different bands.
1306 E.g.
1307 BANDWEIGHT_MULTIS=80:4,40:3,20:2,15:2,10:2
1308 can be used for WAEDC contest. It will multiply the number of
1309 multipliers on 80 by 4, on 40 by 3 and on 20/15/10 by 2.
1310
1311 The multiply operation is executed after any other multiplier
1312 modification.
1313
1314 Bands not in list will be weighted by 1.
1315
1316 PFX_NUM_MULTIS
1317 On WAEDC (and maybe with other contests too) the multipliers are
1318 the different countries, but there are some exceptions where of
1319 certain countries a different prefix number is a different mul‐
1320 tiplier. On WAEDC these countries are: W, VE, VK, ZL, ZS, JA, PY
1321 and RA8/RA9 and RAØ. With this option, you can list the af‐
1322 fected countries: PFX_NUM_MULTIS=W,VE,VK,ZL,ZS,JA,PY,UA9. Tlf
1323 will read these items, make a lookup in a countrylist for a
1324 country code, and that code will be used. If you include the
1325 UA9 prefix and then make a QSO with a station from Asiatic Rus‐
1326 sia, the PFX number will evaulated with a new multiplier, but
1327 European Russia will not.
1328
1329 EXCLUDE_MULTILIST
1330 Some contests have a special multipliers list, which is easier
1331 to write with by excluding a predefined set. For example, the
1332 main set could be COUNTRY_MULT, and you need to exclude from
1333 that list just a few countries, e.g. the SAC contest excludes
1334 the Scandinavian countries as they are not multipliers). In that
1335 case you can use this configuration:
1336 COUNTRY_MULT
1337 COUNTRYLIST=sac:JW,JX,LA,OF1,OF0,OJ1,OJ0,OX,OW,OZ,SM,TF
1338 EXCLUDE_MULTILIST=COUNTRYLIST
1339 Another useful example at WAEDC RTTY contest: then all stations
1340 can work each other, for EU stations only the non-EU stations
1341 are the multi's, and reverse: for non-EU stations only the EU
1342 stations are the multipliers. In that case the EU stations can
1343 use this config:
1344 CONTINENTLIST=EU
1345 COUNTRY_MULT
1346 EXCLUDE_MULTILIST=CONTINENTLIST
1347 Now all country are multi, except the EU stations. In this con‐
1348 test the non-EU stations can use this config:
1349 CONTINENTLIST=SA,NA,AF,AS,OC
1350 COUNTRY_MULT
1351 EXCLUDE_MULTILIST=CONTINENTLIST
1352 In this example all countries are multis, except from SA, NA,
1353 AF, OC and AS continent, so only the EU stations left as multi‐
1354 pliers.
1355
1356 BMAUTOGRAB
1357 If set, with RADIO_CONTROL and BANDMAP (mandatory) options, Tlf
1358 will grab the callsign from bandmap, if the TRX frequency is
1359 equal with bandmap freq.
1360
1361 BMAUTOADD
1362 If set, with RADIO_CONTROL and BANDMAP (mandatory) options, Tlf
1363 will add the callsign from callsign field, if at least 3 charac‐
1364 ter have been entered. Use “S”kip dupes in BANDMAP settings to
1365 control if it should also grab dupes.
1366
1367 SPRINTMODE
1368 If set, Tlf will automatically switch its mode between LOG and
1369 S&P after every QSO.
1370
1371 FLDIGI If you work RTTY (or any other digital modes), you can communi‐
1372 cate with Fldigi through XMLRPC. The FLDIGI keyword will acti‐
1373 vate the interface. By default it connects to
1374 http://localhost:7362/RPC2 ⟨http://localhost:7362/RPC2⟩.
1375
1376 If you run Fldigi's xmlrpc server on an different port use
1377 FLDIGI=http://localhost:port_#/RPC2
1378
1379 MINITEST [=NNN]
1380 Use this option when the contest is a minitest like contest. In
1381 that contests the full contest intervall is divided into shorter
1382 sections (e.g. 6 * 10 minute sections in an hour). Any station
1383 can be worked once in each of the time sections without counting
1384 as dupe. The default length of the sections is 600 seconds (10
1385 minutes), but you can pass another value (in seconds) after the
1386 '=' sign. There must be an integral number of time sections per
1387 hour!
1388
1389 UNIQUE_CALL_MULTI
1390 Multiplier is callsign. You have to pass one of these argu‐
1391 ments: ALL, BAND.
1392
1393 Example:
1394
1395 UNIQUE_CALL_MULTI=BAND
1396
1397 The argument tells Tlf, how to score the callsigns as multipli‐
1398 ers:
1399 ALL means the callsign is a multiplier, independet of band.
1400 BAND means the callsign counts as multiplier on different bands.
1401
1402 DKF1=digi keyer message 1 ... DKF12=digi keyer message 12
1403 Use F1 ... F12 keys to send recorded messages for phone.
1404
1405 DKCQM=message
1406 Auto Exchange TU digi message in CQ mode (TR-Log mode)
1407
1408 DKSPM=message
1409 Auto Exchange TU digi message in S&P mode (TR-Log mode)
1410
1411 DKSPC=message
1412 Auto Exchange call digi message in S&P mode (TR-Log mode)
1413
1415 /usr/share/tlf/logcfg.dat is a recent example of the configuration file
1416 Tlf needs to know what to do. Tlf won't start without one. Copy it
1417 into the working directory and edit it before use. You should do your
1418 experiments well before the contest. It contains, amongst other set‐
1419 tings, your call, name of the log file, info about ports for CW keying,
1420 packet or rig control, contest rules, points, multipliers etc.
1421
1422 /usr/share/tlf/rules/contestname contains the rules of the various con‐
1423 tests. You can easily write one for your favourite contest making use
1424 of the various multiplier and points capabilities. Check it before the
1425 contest and send a message to the Tlf development list ⟨tlf-
1426 devel@nongnu.org⟩ if anything is wrong (or right!).
1427
1428 /usr/share/tlf/cty.dat contains a flat ASCII database of info about
1429 countries. This is the same file as used by CT or TR-Log. Updated
1430 versions from Jim, AD1C, are available from: Country Files
1431 ⟨http://www.country-files.com/⟩.
1432
1433 /usr/share/tlf/callmaster contains a flat ASCII database of known con‐
1434 test callsigns. Updates are available from Super Check Partial
1435 ⟨http://www.supercheckpartial.com/⟩. Save the master.scp file as call‐
1436 master in the working directory (or use CALLMASTER=master.scp to use
1437 that file). It will take precedence over the system installed callmas‐
1438 ter.
1439
1440 Section files contain a flat ASCII database of multpliers like states,
1441 sections, provinces, districts, names, ages, etc. They are invoked by
1442 including MULT_LIST=section_file_name in the rules file.
1443
1445 An operation manual (a little bit outdated) is available in HTML format
1446 at the old Tlf project page
1447 ⟨http://sharon.esrac.ele.tue.nl/pub/linux/ham/tlf/⟩.
1448
1449 An FAQ and other useful tips are installed in the system doc directory
1450 under tlf.
1451
1453 Please send bug reports to the Tlf development list ⟨tlf-
1454 devel@nongnu.org⟩.
1455
1457 Tlf was written by Rein Couperus ⟨pa0r at eudxf.org⟩ aka Rein Couperus
1458 ⟨rein at couperus.com⟩ but maintained from 2009 onward by Thomas
1459 Beierlein ⟨tb at forth-ev.de⟩. Lots of valuable contributions from
1460 PG4I (Joop PA4TU), PA3FWM, LZ3NY, VA3DB, OM4AA, OK1RR, DH5FS, G4KNO and
1461 various other contributors. (See the AUTHORS file for more). Thanks to
1462 all for improving Tlf!
1463
1464 Beta testers and feedback are always welcome!
1465
1466
1467
1468TLF version 1.4.1 TLF(1)