Tucnak branch 1
Tucnak 1 is obsolete. Look at Tucnak 2 wiki..
Tucnak is a VHF contest logbook. Tucnak is executable on Linux operating system and also for other UNIX like operating systems. Can be run uder MS Windows with Cygwin library too (older version). You can download Tucnak from http://tucnak.nagano.cz.
If you register user of BBS OK0NAG you can read the actual version of this dokument by typing command www tucnak.nagano.cz/tucnak1en.html.
Graphics polar map
Please download Tucnak here http://tucnak.nagano.cz/download.php#ver1.
The most important feature
New features in branch 1
(For working in text mode)
I used use Tucnak program at notebook 486DX/25, 8MB ram, 100MB disk. This configuration is usable for work on one band. If you want to work on more bands you must run Tucnak at more powerful computer. You can run Tucnak also remotelly at faster hardware.
If you want to run the program on Windows system you need more powerful computer (as pentium II 500 Mhz).
Changing of bands is possible by <F9> Bands. CTRL + assigned character for band.
If you want to run Tucnak in the networking is necessary to have filled these items:
I would like to say thanks you to:
The primary URL for tucnak downloading is http://tucnak.nagano.cz.
Download first source code or binary packages of Tucnak. There are maybe binary packages for your distribution but it can be out of date.
Tucnak requires glib 1.2 library. It's probably part of your distribution. If you want to compile Tucnak from source code you must have installed development version of glib library too (devel package - libglib1.2-dev*.deb (Debian), glib-devel*.rpm (RedHat), libglib1.2*.rpm (Mandrake)). The library you can download from www.gtk.org (not glib.org :-)
If you want to use a graphics polar map, it's necessary to have installed SDL library (if you can compile it from source code you must have install devel packages too - libsdl1.2-dev*.deb (Debian), SDL-devel-1.2*.rpm (RedHat), libSDL1.2-devel*.rpm (Mandrake). You must install package tucnak1-data from section download.
Installation from source code
Installation from source code is universal way how to install program. There must be installed developments tools for C language on your PC.
Extracting source code
tar xzf tucnak1-1.13.tar.gz
Program is normally installed into directory /usr/local/bin. Maybe you will add path to Tucnak binary. You can add line export HOME=/usr/local/bin:$HOME to end of file /etc/rc.local in bash shell and then restart rc.local (or restart system).
Configuration files are allways saved in /etc directory.
Install on Debian
Simplest way is to add lines
deb http://ok1zia.nagano.cz/debian/ok1zia binary-i386/
to your /etc/apt/sources.list . After it use
and install selected packages:
apt-get install tucnak1
Download manually and install
Download package tucnak1-1.13*_i386.deb. Install it by command:
dpkg --install tucnak1-1.13*_i386.deb
Download sources and create package
If binary package doesn't present, create them by extracting source code by commnad:
Install on RedHat like distribution
Download package tucnak1-1.13*.i386.rpm, and install it by command:
rpm -i tucnak1-1.13*.i386.rpm
If rpm binary package doesn't exist, create them by extracting source code and execute commnads: (you must install package rpm-build first on Mandrake)
Source package RPM (SRPM) you can create by:
Files are saved in /usr/src/[redhat|RPM|packages|rpm]/* (depending on your distribution). Is necessary to have a write right to this directory.
Remark: Creating packages isn't perfectly tested. If you have any question for function or you know how to fix any mistake then write me, please.
Post install settings
Now is suitable to set Tucnak for specific station. It's good idea to have a few users for different callsigns in operating system. I have two users, ok1krq for a big contest (club callsign OK1KRQ) and for other contests I use my callsign OK1ZIA as user ok1zia.
Log to system as a contest user and run Tucnak. Enter to menu by F10; key. Next progress is described in Setup menu.
Menu Contest defaults
There is possible to set these items in this menu: callsign in contest, club callsign (use only if you can export contest log in EDI format), locator (6 characters), contest QTH (is equal items PAdr1 and PAdr2 in EDI, Optional Exchange and standard proposed reports for SSB and CW.
This submenu contains setting of all bands. Active bands (QRV is checked) are separated from other bands. You can take away bands which are never used (as 220MHz in Europe).
You can enter single band setting by pressing ENTER key. Item `QRV on this band' is usually set for all bands where are permit transmittes.
This setting is the only one which must be set. Other items are better set here too but it isn't necessary. QRV setting in this contest isn't effect on this place.
QRV setting in this contest isn't effect on this place. Cathegory can be one of Multi/Single/Check.
TX and RX Equip settings contains describing of equipments. Power is written with units. ASL and AGL means a height between antenna and sea/ground. Inserted values are in meters, delimiter is semicolon.
Fill operator's callsigns into Operators field delimitely by semicolon. Remark field is assigned for remarks to contest commitee.
There are set information of responsible operator for communication with contest commitee in this dialogue. All items are in free format and don't need commentary.
Tucnak uses for keying and transmitting CW external program cwdaemon.
Interface between cwdaemon and tucnak doesn't still finished. Valid items are only hostname (IP address computer's where running cwdaemon) and UDP port. Other settings are necessary set from command line.
Run cwdaemon as root.
cwdaemon -n -l 0x3bc
Option -n causes writing debug information to console. Option - l change address of parallel port (e.g. on my notebook 0x3bc).
All options of ssbd are setting in Tucnak. You can run ssbd on other computer over the network. This is useful on laptop without soundcard.
Program ssbd needs no commandline parameters except UDP port number. All other settings are done over network. Settings are:
Hostname and UDP port set IP address and UDP port which is connected for ssbd.
Path to DSP describes path to special file which is connected with sound card kernel driver. Typically is /dev/dsp.
Record traffic switches on/off recording band activity on receiving. If this option isn't active then all next options are irrelevant.
Template for recorded filename is template for naming recording files. Description of possible macros you can find in section CQ macros.
Next options describe coding of output file. Supported options are.
PCM coding is suitable for conversion to other formats (MP3, Ogg). GSM coding has low size. One minute of recording have size about 130 kB of disk space. That is less then 200 MB for 24 hours. This coding doesn't have to supported by your favourite player! GSM format replay for example mplayer (with codec) or sdnfile-play distributed with libsndfile.
Option Channel sets number of sound channels. Set it to 1 (mono). You can set it to 2 or 4 it depends on your sound card capability.
Sample rate sets the number of sample per second. `CD' quality has value 44100. This value is needless for radio activity. It's recommended to lower value to half (22050) or quarter (11025) because some programs or sound cards can't work with other values. If SSB CQ or recording don't work properly mail to me, please.
The list of all CW texts are showed after selecting this item. There is showed the key for running the message in brakes. Character `R' means that the message is repeated (CQ). Also is showing start of text.
There are these items in dialoque for setting CQ: text of CQ and repeating of the text one. Item delay determines time between starts of CQ messages (not between end of first and start of second). Last item allows to run message if there is any macro undefined.
See description in previous chapter.
It's possible to define macros in texts of CW CQ and in name of SSB CQ file. Macros are case insesitive.
Macros has not effect in all context.
It sets and saves parameters of QSO to disk. Option `Save to disk after QSO' is recommended set to 1 to save all reports. Fsync option immediately saves QSOs from cache to disk.
Default setting of option Save to floppy after QSO is 4. Zero disables saving to floppy disk. Path to floppy item sets path to floppy's mount point. Tucnak don't test if floppy disk is mounted.
Other items are ignored.
Network & trace
Ignore interfaces - list of network interfaces which would be ignored for searching next copy Tucnaks on the net (transmit broadcasts) as connect to Internet, public IP address from provider, AX.25 interface. The delimiter between interfaces is space character. Broadcasts loads slow nets.
Ignore networks - the purpose this option is the same as Ignore interface option. You can determinate subnet address.
Announce to nets - it's an inverse function of previous options. There is specification of IP address where have been sending broadcasts in this option. The routers usually have disabled forward broadcastings.
Menu Terminal options
This menu is used for setting characteristic of terminal as window frames.
Load cfg from net
It shows addresses of all Tucnaks on the net. If one is selected you can read his complete configuration (tucnakrc).
Load C_W from net
It loads complete C_W database from selected Tucnak and saves it to ~/tucnak/tucnakcw. In database are saved two newest locators for each callsign.
It saves configuration to file ~/tucnak/tucnakrc
WARNING! Using of different versions of Tucnak is NOT recommended because older tucnak doesn't known all configuration options in tucnakrc file and if it saves as configuration in older version of Tucnak then options are lost where old version of Tucnak isn't known. If you use different versions of Tucnak then is recommended to use them under different users. Don't use two diferent versions of Tucnak under one user!
Remark: Character ~ (tilde) is short cut of user home directory (bash# echo $HOME).
Files which are described below are saved in plain text format. Is possible to edit these files but it is necessary to keep format of files. In other case Tucnak shouldn't work properly.
Each contest is saved to differed directory. Name of directories is created from date of contest e.g. ~/tucnak/2003083.1. It is possible to have many contest in one day or one contest on one computer under one user (thought telnet, ssh) with many running Tucnaks. Each contest with the same date has different number behind point.
Files in ~/tucnak/<date>:
Band's label are marked according to EDI format e.g. `50 MHz', `70 MHz', ..... `248 GHz'. All bands has assigned one letter label which is used on place where isn't enough place.
Command line options
You have two choices for creating a new contest log. You may select contest which was defined before by select New contest from wizard in Contest menu or select New and to set parameters of contest manually. You can add contest to tucnakwiz file (manually) fof next using in the future..
Set name of contest on the first place in dialogue New Contest . Callsign, club and locator are probably sets. Optional exchange option isn't implemented yet.
Write date of begin of contest to item Date of contest. This item has effect only for naming contest's directory, not for export contest to EDI format.
Next options determine style of giving points.
Above OK and Cancel buttons are buttons with all bands which are set as QRV. You can set off some bands for actual contest only. Option Read-only prohibits any changes on band. It's suitable for network working.
Next items are described in Band defaults section.
Click on button 'EDI prop' in dialogue New Contest to go to dialogue where you can change name of your QTH. It is possible to set which operator is responsible to send log in Responsible op.
Button Responsible op executes dialog for setting of informations about responsible operator. See section Responsible operator.
Now press <OK>.
For using networking you must keep few rules.
Main window contains windows with various information. Switch between windows is doing by <F4> key or directly by <ALT + number>. In a bottom side of main Tucnak's window is on input line. Above the input line is temporary displayed actual QSO. Main window from the input line is activated by up arrow key. Press <ESC> key to be return in input line.
Callsigns, callsign's suffix, operator's callsign and suffix are highlighted in most of windows. Callsigns between <* and *> the whole line is highlighted (private message from WW convers).
Kinds of windows:
Dialogue for editing QSO is displayed from QSOs window pressing <ENTER> key on select QSO. There isn't checked any control of written items in this dialogue. If You have any good idea how to improve this dialogue, mail me, please
If you change one or booth locators and not change mode, the QSO mode is updated from reports. In other case this dialog is dumb, it makes no validity control.
Option Error signs QSO as bad QSO and Tucnak counts zero points by this QSO. Report is possible sign back as good.
Hotkeys in a contest
Other usefull keys:
Key in graphics window
Program automaticaly recognizes kind of typed items and correctly put it into unfinished QSO where is located above input line.
It is possible to write more items which are delimited by space characters. If any item isn't recognized then it's displayed left above top input line.
Hint: You can return all to QSOs line byAlt+P.
If you write callsign which is saved before then Duplicate QSO dialogue is displayed. You have any choices, see bellow.
If You insert callsign which is known in C_W database, program automatically fill up to two locators. Locators are inverse displayed. If locator on higher row is valid you must confirm it by pressing <Alt+X> key. If second WWL is valid you must swap locators by pressing <Alt+V> key. If callsign isn't contain in database, Tucnak fill a large square with highest activity or Capital City of worked DXCC and calculates aproximate QTF.
Similar situation is if you insert known locator. There'll display two inverted callsign which can swap press <Alt+C> and confirm by press <Alt+D> or shows prefixes of possible DXCC only if isn't known any callsign
Tucnak checks if pair of locator and callsign exists. If Tucnak think that it's invalid then shows at locator some of this characters.
Output from program
Tucnak's outputs are compatible with EDI format and are saved to the .txt files with Tucnak's specific extensions which will be ignored by contest commitee
The export to plain EDI format with command Contest -> Export as EDI. Output is in file e.g. 02OK1KRQ.edi.
It's another output. Output file has suffix txt. This output is generating in OK VHF Activity contest format.
The main format for exporting contest log to general purpose log. If you have some questions to format output files or compatibility with logbook , please mail me
Open/Close graphics window
Opens / closes window with graphics polar worl wide map. Exit from map's window is possible by <q> or <ESC> key.
If contest is opened the map shows QSOs as yellow crosses. The station whitch is the nearest to mouse cursor is hightlighted by red colour. There are information about call, QRB and QTF between QTH and this station at the right window.
Remark.: You must compile Tucnak with support SDL if you want to use the map.
This menu is active only if you begin a contest.
If you already have had unfinished QSO with the station you can mark this QSO as Error QSO and make complete QSO later.
Sets operator's callsign. The callsign is used for talk. It's also saved with each QSO for statistics.
Settings of all bands have a list of operators (items Mope1 and Mope2 EDI format). Each list contains callsigns of all operators which have one or more QSO. This feature is suitable used before you send logs to contest commitee.
Update C_W from contest
Adds pair callsign - locator from all bands to actual tucnakcw database.
Update C_W from band
Adds pair callsign - locator from active band to actual tucnakcw database
Import DL8EBW database
There are all bands which are checked as QRV in the contest in this menu. You can switch active bands by <Alt+B> and by a letter of band. Band's letter corresponds with letter which are in right menu's column.
You can invoke this menu by pressing <Alt+W> keys. All windows which are possible to use are displayed in this menu.
A list of windows, which are supported. The selected window is added as last item of window's list. It isn't possible to save list of windows.
Items Command and Respawn are not used.
Closes actual window.
How to Help?
73! Ladislav Vaiz, OK1ZIA
Appendix A - Time synchronization by NTP protocol
Package ntp you probably have in your distribution. Older version have named xntp. You need programs ntpdate which is used for a single set date and (x)ntp for synchronization time for all time of system running. Ntp daemon has /etc/ntpd.conf configuration file.
In file /etc/ntp.conf should be contained next lines.
If you can then use time server from the Internet.If you can then use time server from the Internet.
The slave computers will have in configure file address master computer.
Next items you have on default setting.
If different between times on computers are highest than few second is better set to clock by ntpdate program if computer boots. This case is possible to use witting master computer address to file /etc/ntp/step-tickers or write command ntpdate <master> on end of /etc/local file.
Hint: ntpd synchronize time after several minute, sometimes you'll have to very patient.