OHHamLogger Files

OHHamLogger - Asennus- ja käyttöohje
Sisältö
1. Yleiskuvaus
2. Vaatimukset
3. Asennus
4. Käyttöönotto
5. Peruskäyttö
6. WWFF-lokitus
7. ADIF-vienti
8. Vianetsintä
Yleiskuvaus
OHHamLogger on radioamatööreille suunniteltu lokiohjelma, joka tukee ADIF 3.1.0 -formaatia ja WWFF-lokien tallennusta. Ohjelma on kehitetty Pythonilla ja se toimii Windows, Linux ja macOS -käyttöjärjestelmissä.
Vaatimukset
Pakolliset vaatimukset:
Python 3.8 tai uudempi
tkinter (tulee yleensä Pythonin mukana)
Tarkista Pythonin asennus:
bash
python --version
# tai
python3 --version
Asenna tarvittaessa Python:
Windows: Lataa  python.org:sta
Linux:  sudo apt install python3 python3-tk
macOS:  brew install python3
Asennus
1. Lataa ohjelma
Lataa  OHHamLogger.py  tiedosto https://sourceforge.net/projects/ohhamlogger/ista tai kopioi koodi tekstitiedostoon nimeltä  OHHamLogger.py
2. Asenna suoraan Pythonilla
Windows:
cmd
# Siirry hakemistoon, jossa OHHamLogger.py sijaitsee
cd polku\hakemistoon

# Suorita ohjelma
python OHHamLogger.py
Linux/macOS:
bash
# Siirry hakemistoon, jossa OHHamLogger.py sijaitsee
cd /polku/hakemistoon

# Tee tiedosto suoritettavaksi
chmod +x OHHamLogger.py

# Suorita ohjelma
python3 OHHamLogger.py
3. Vaihtoehtoinen asennus (batch-tiedosto)
Windows (OHHamLogger.bat):
batch
@echo off
cd /d "%~dp0"
python OHOHHamLogger.py
pause
Linux/macOS (OHHamLogger.sh):
bash
#!/bin/bash
cd "$(dirname "$0")"
python3 OHOHHamLogger.py
Käyttöönotto
1. Ensimmäinen käynnistys
Kun käynnistät ohjelman ensimmäistä kertaa:
Ohjelma luo automaattisesti  ~/hamlog/  hakemiston
Asetustiedosto tallennetaan  ~/hamlog/settings.json
ADI-tiedostot tallennetaan  ~/hamlog/adi/  hakemistoon
2. Perusasetusten määrittäminen
1. Valitse  Asetukset  ?  Radioaseman tiedot
2. Täytä pakolliset kentät:
Oma kutsu: Esim. OH3ENK
Locator: Esim. KP20TH
Oma WWFF: Esim. OHFF-0029 (valinnainen)
Oletusband: Esim. 20m
Oletusmode: Esim. SSB
3. Valitse teema ja kieli
4. Paina  Tallenna
Peruskäyttö
QSO:n syöttö
Syöttöriville kirjoitetaan seuraavassa muodossa:
text
KUTSU RST-LÄHETETTY RST-SAATU KOMMENTTI
Esimerkkejä:
bash
OH2ABC 59 59
OH2XYZ 59 59 Hyvä keskustelu
OH2TEST 57 59 Teemu
OH10N        (Tuottaa raportin OH10N 59 59)
Pikakomennot
Bandin vaihto:
Kirjoita numero:  20  ? 20m
Kirjoita numero + m:  40m  ? 40m
Pilkku + numero:  ,70  ? 70cm
Moden vaihto:
Kirjoita mode:  CW  ? CW-mode
Kirjoita mode:  FT8  ? FT8-mode
Toimintopainikkeet
Tallenna ADI: Tallenntaa koko lokin ADI-tiedostona
Avaa loki: Avaa aiemmin tallennettu ADI-tiedosto
Tallenna ja sulje: Tallentaa muutokset ja sulkee ohjelman
WWFF-lokitus
WWFF-QSO:n syöttö
Tallenna asetuksiin oma wwff-tieto. Ohjelma liittää sen automaattisesti ADI-tiedostoon
	KUTSU     (Tuottaa raportin kutsu 59 59 ja tiedon omasta wwff-alueesta)
Syötä vasta-aseman WWFF-tunnus RST-raportin jälkeen:
text
KUTSU RST-LÄHETETTY RST-SAATU WWFF-TUNNUS KOMMENTTI
Esimerkkejä:
bash
OH2XYZ 59 59 OHFF-1234
OH2TEST 57 52 DLFF-9012 Heikki
OH10N OHFF-1234			(tuottaa raportin 59 59)
ADIF-vienti
Automaattinen nimeäminen
Ohjelma nimeää ADI-tiedostot automaattisesti:
OMAKUTSU@WWFF-ALUE.adi  (jos WWFF on asetettu)
OMAKUTSU@LOCATOR.adi  (jos WWFF ei ole asetettu)
 	ADIF-rakenne
Ohjelma luo ADIF-tiedostot, jotka sisältävät:
xml
<STATION_CALLSIGN:6>OH3ENK
<MY_SIG:4>WWFF
<MY_SIG_INFO:9>OHFF-0029
<SIG:4>WWFF
<SIG_INFO:9>OHFF-1234
<OPERATOR:6>OH3ENK
Osittainen vienti
Voit viedä vain tietyn ajanjakson QSO:ita:
1. Valitse  Tiedosto  ?  Vie osa lokista
2. Valitse alkamis- ja päättymispäivämäärät
3. Tallenna osittainen loki
Vianetsintä
Yleisimmät ongelmat
Ohjelma ei käynnisty:
Tarkista että Python on asennettu:  python --version
Tarkista että tkinter on saatavilla:  python -m tkinter  (avaa testi-ikkuna)
Tiedostoja ei voi tallentaa:
Tarkista käyttöoikeudet hakemistoihin
Varmista että kovalevylle on tilaa
ADIF-tiedostoja ei voi lukea:
Tarkista että tiedosto on validi ADIF-muoto
Kokeile muuntaa tiedosto UTF-8 -enkoodaukseen
WWFF-tunnuksia ei tunnisteta:
Varmista että tunnus on muodossa MAATUNNUSFF-NUMERO
Tarkista että tunnus on RST-raportin jälkeen
Lokitiedostot
Ohjelma luo lokitiedostoja:
~/hamlog/OHHamLogger.log  (sovelluslokit)
~/hamlog/settings.json  (asetukset)
Resursseja
ADIF-standardi
WWFF-ohjelma
Python-dokumentaatio
Tuki
Jos kohtaat ongelmia:
1. Tarkista että käytät uusinta versiota
2. Tarkista asetustiedoston sisältö
3. Kokeile uudelleenkäynnistää ohjelma
4. Ota yhteys kehittäjään
Kehittäjä:  OH3ENK
Versio:  1.1.1

OHHamLogger - Yksinkertainen ja tehokas lokinpito radioamatööreille






OHHamLogger - Installation and User Guide
Contents
1. Overview
2. Requirements
3. Installation
4. Getting Started
5. Basic Operation
6. WWFF Logging
7. ADIF Export
8. Troubleshooting
Overview
OHHamLogger is a logging program designed for radio amateurs, supporting the ADIF 3.1.0 format and WWFF log storage. The program is developed in Python and runs on Windows, Linux and macOS operating systems.
Requirements
Required requirements:
Python 3.8 or later
tkinter (usually comes with Python)
Check Python installation:
bash
python --version
# or
python3 --version
Install Python if necessary:
Windows: Download from python.org
Linux: sudo apt install python3 python3-tk
macOS: brew install python3
Installation
1. Download the program
Download the OHHamLogger.py file from https://sourceforge.net/projects/ohhamlogger/ or copy the code to a text file named OHHamLogger.py
2. Install directly with Python
Windows:
cmd
# Go to the directory where OHHamLogger.py is located
cd path\directory
# Run the program
python OHHamLogger.py
Linux/macOS:
bash
# Go to the directory where OHHamLogger.py is located
cd /path/directory
# Make the file executable
chmod +x OHHamLogger.py
# Run the program
python3 OHHamLogger.py
3. Alternative installation (batch file)
Windows (OHHamLogger.bat):
batch
@echo off
cd /d "%~dp0"
python OHOHHamLogger.py
pause
Linux/macOS (OHHamLogger.sh):
bash
#!/bin/bash
cd "$(dirname "$0")"
python3 OHOHHamLogger.py
Getting Started
1. First start
When you start the program for the first time:
The program automatically creates the ~/hamlog/ directory
The settings file is saved in ~/hamlog/settings.json
ADI files are saved in the ~/hamlog/adi/ directory
2. Configuring basic settings
1. Select Settings ? Radio station information
2. Fill in the required fields:
Your callsign: E.g. OH3ENK
Locator: E.g. KP20TH
Your WWFF: E.g. OHFF-0029 (optional)
Default band: Eg. 20m
Default mode: Eg. SSB
3. Select theme and language
4. Press Save
Basic operation
QSO input
The input line is written in the following format:
text
INVITE RST-SENT RST-RECEIVED COMMENT
Examples:
bash
OH2ABC 59 59
OH2XYZ 59 59 Good discussion
OH2TEST 57 59 Teemu
OH10N (Produces report OH10N 59 59)
Quick commands
Band change:
Type number: 20 ? 20m
Type number + m: 40m ? 40m
Comma + number: ,70 ? 70cm
Mode change:
Type mode: CW ? CW-mode
Type mode: FT8 ? FT8-mode
Function buttons
Save ADI: Saves the entire log as an ADI file
Open Log: Opens a previously saved ADI file
Save and Close: Saves changes and closes the program
WWFF logging
WWFF QSO entry
Save your own WWFF data to the settings. The program automatically attaches it to the ADI file
CALL (Produces report call 59 59 and information about your own WWFF area)
Enter the WWFF ID of the opposing station after the RST report:
text
CALL RST-SENT RST-RECEIVED WWFF ID COMMENT
Examples:
bash
OH2XYZ 59 59 OHFF-1234
OH2TEST 57 52 DLFF-9012 Heikki
OH10N OHFF-1234 (produces report 59 59)
ADIF export
Automatic naming
The program automatically names the ADI files:
OMAKUTSU@WWFF-ALUE.adi (if WWFF is set)
OMAKUTSU@LOCATOR.adi (if WWFF is not set)
ADIF structure
The program creates ADIF files that contain:
xml
<STATION_CALLSIGN:6>OH3ENK
<MY_SIG:4>WWFF
<MY_SIG_INFO:9>OHFF-0029
<SIG:4>WWFF
<SIG_INFO:9>OHFF-1234
<OPERATOR:6>OH3ENK
Partial export
You can export only QSOs from a specific period:
1. Select File ? Export Partial Log
2. Select start and end dates
3. Save Partial Log
Troubleshooting
Common Problems
Program will not start:
Check that Python is installed: python --version
Check that tkinter is available: python -m tkinter (open test window)
Cannot save files:
Check permissions on directories
Make sure there is space on the hard drive
Cannot read ADIF files:
Check that the file is in valid ADIF format
Try converting the file to UTF-8 -encoding
WWFF codes are not recognized:
Make sure the code is in the format COUNTRYCODEFF-NUMBER
Check that the code is after the RST report
Log files
The program creates log files:
~/hamlog/OHHamLogger.log (application logs)
~/hamlog/settings.json (settings)
Resources
ADIF standard
WWFF program
Python documentation
Support
If you encounter problems:
1. Check that you are using the latest version
2. Check the contents of the configuration file
3. Try restarting the program
4. Contact the developer
Developer: OH3ENK
Version: 1.1.1

OHHamLogger - Simple and effective logging for radio amateurs