[CCF] Cabrillo - kontestilokin rakennuskieli

[Jari Perkiömäki]

CABRILLO - KONTESTILOKIN RAKENNUSKIELI
by Jari OH6BG (kiitos kommenteista Jarille OH6QU ja Jukalle OH6LI)

URL: http://www.uwasa.fi/~jpe/tr/cabrillo.html . Tämä kirjoitus sisältää
dataa, joka vaatii oikein näkyäkseen tasalevyisen (monospace) fontin.
Kirjoituksen WWW-versio näkynee selaimissa oikein.

Cabrillo-muotoinen loki on yksi suositeltavista sähköisistä
lokimuodoista. Se on selvästi vakiinnuttamassa asemaansa: muiden muassa
ARRL:n ja CQ-kilpailuihin se on ehdottomasti suositeltavin. Risto OH3UU on
ansiokkaasti selostanut sähköisten lokien olemusta eri yhteyksissä. Riston
ajatuksia voi kerrata osoitteesta: http://www.qsl.net/ccf/ohforms.htm

Kun puhutaan sähköisistä lokeista, voidaan pitää jo sanomattakin selvänä,
että tiedoston fyysinen tallennus tapahtuu ASCII-muodossa (ASCII, American
Standard Code for Information Interchange). ASCII on avoin ja standardoitu
digitaalisten merkkien tallennustapa, jolla varmistetaan, että näin
tallennettu informaatio olisi mahdollisimman monen eri ohjelman
käytettävissä. Muu, jonkin tietynmerkkisen ohjelman (esim. Word tai
WordPerfect) oma digitaalisten merkkien tallennustapa ei ole suositeltavaa
siksi, että niiden tapa on suljettu eli sellainen jonka yleensä vain
kyseinen ohjelma itse pystyy ymmärtämään. Suljetun tallennusmuodon
ongelmien lievittämiseksi ollaankin moniin ohjelmiin jouduttu vaivalla
rakentamaan ns. tiedostokonverttereita. Näilläkään ei konvertointia saada
välttämättä ihan täydelliseksi, vaikka lähellä ollaan.

Standardoitu fyysinen rakenne (ASCII) ei kuitenkaan yksistään
riitä. Tarvitaan myös standardoitu kuvaus lokin loogisesta
rakenteesta. Cabrillo on yksi tällainen looginen
rakennekuvaus. Cabrillo-määrittely jakautuu karkeasti kahteen osaan:
henkilö- ja kilpailutietoihin (alla kohdat 1-17) sekä QSO-tietoihin (kohta
18).

Jokainen Cabrillo-loki alkaa START-OF-LOG:-rivillä ja päättyy END-OF-LOG:-
riviin. Kaikki muu tieto sijaitsee näiden kahden rivin välissä. Tämä muu
tieto on sidottu riveihin, jotka kaikki alkavat selkeällä rivitunnisteella.
Tunnisteettomia rivejä ei ole. Rivien keskinäisellä järjestyksellä on
merkitystä. Kuten jatkossa huomaamme TR:n generoimasta Cabrillo-tiedostosta
(kohdan 17 ja 18 välissä), pientä horjuntaa on silti havaittavissa.

1) START-OF-LOG: versionumero

Pitää olla lokitiedoston ensimmäisellä rivillä. Nykyinen versionumero on
"2.0".  Uuden TR-version 6.72 tuottamassa Cabrillo-muodossa tosin näkee jo
versionumeroa "2.1".

Esimerkki:

START-OF-LOG: 2.0

2) END-OF-LOG:

Pitää olla lokitiedoston viimeisellä rivillä. Kaksoispisteen jälkeen ei tule
merkkejä.

Esimerkki:

END-OF-LOG:

3) ARRL-SECTION: arrl-section

Mikäli otamme osaa ARRL:n järjestämiin kilpailuihin, lokeihin täytyy
merkitä ARRL-SECTION:-rivi. Amerikkalaisten ja kanadalaisten asemien
lokeissa arrl- section pitää olla osoitteessa
http://www.arrl.org/contests/sections.abv.html mainittu ARRL:n
section-lyhenne. Ulkomaisten asemien lokeissa arrl-section tulee olla
"DX". Tämä tieto vaaditaan kaikissa ARRL:n järjestämissä kilpailuissa,
kuten ARRL-10, ARRL-DX-SSB jne.

TR ei toistaiseksi lisää ko. määritystä ainakaan DX-asemille ARRL:n
kontesteihin, mutta asiasta on ilmoitettu TR:n kehittäjille.

Esimerkki:

ARRL-SECTION: DX

4) CALLSIGN: kutsumerkki

Tällä rivillä määritellään kilpailussa käytetty kutsumerkki.

Esimerkki:

CALLSIGN: OH6BG

5) CATEGORY: operaattorikategoria bandikategoria tehokategoria [modekategoria]

Tällä rivillä määritellään, mihin kilpailuluokkaan
kuulumme. CATEGORY:-rivillä on kolme pakollista osaa (operaattoriluokka,
bandi ja teho) ja yksi valinnainen (mode).

Cabrillon alkuperäinen määrittely kertoo, että HF-kilpailuissa
operaattorikategoria pitää olla yksi seuraavista: SINGLE-OP,
SINGLE-OP-ASSISTED, MULTI-ONE, MULTI-TWO, MULTI-MULTI, SCHOOL-CLUB (vain
ARRL-SS-CW ja ARRL-SS- SSB:ssa), SWL tai CHECKLOG. VHF-kilpailuissa
operaattoriluokka pitää olla yksi seuraavista: SINGLE-OP,
SINGLE-OP-PORTABLE, ROVER, MULTI-LIMITED, MULTI- UNLIMITED tai CHECKLOG.

Kotimaisissa ja skandinaavisissa kilpailuissa operaattorikategorioita voi
olla vähemmänkin.

HF-kilpailuissa bandikategoria pitää olla yksi seuraavista: ALL, 160M, 80M,
40M, 20M, 15M tai 10M. VHF-kilpailuissa bandikategoria pitää olla yksi
seuraavista: ALL tai LIMITED.

Tehokategoria pitää olla HIGH, LOW tai QRP.

Modekategoria pitää olla CW, SSB tai MIXED ja on tarkoitettu käytettäväksi
vain single-operaattorien lokeissa niissä multimode-kilpailuissa, jotka
sallivat yksittäismodet, kuten IARU-HF ja 10 Meter Contest. Tätä yleensä ei
tarvinne käyttää sen takia, että kilpailun nimestä voi ilmetä käytettävä
mode, esim. CQ- WW-CW. Katso alla.

Cabrillo 2.0:n määrittelyssä on puute, sillä RTTY:ä ei ole mainittu, vaikka
QSO- tiedoissa luetellaan CW, PH, FM ja RY!

Esimerkki CQ WW CW-kilpailusta, jossa osallistuin 10M:n LOW-power-luokkaan:

CATEGORY: SINGLE-OP 10M LOW

6) CATEGORY-OVERLAY: [kategoria-tarkenne ...]

Kategoriatarkennetta käytetään lokissa tarpeen mukaan. CQ-WPX-CW- ja
CQ-WPX-SSB- kilpailuissa kategoriatarkenne voi olla mikä tahansa yhdistelmä
seuraavia: ROOKIE, BAND-LIMITED ja TB-WIRES. STEW-PERRY-kilpailussa
kategoriatarkenne voi olla OVER-50. IARU-HF-kilpailussa kategoriatarkenne
voi olla HQ.

Esimerkki:

CATEGORY-OVERLAY: ROOKIE, BAND-LIMITED, TB-WIRES

7) CATEGORY-TIME: aikakategoria

Aikakategoria on käytössä vain RSGB:n IOTA-kilpailussa ja pitää olla joko
12- HOURS tai 24-HOURS.

Esimerkki:

CATEGORY-TIME: 12-HOURS

8) CLAIMED-SCORE: n

Kokonaislukuna annettava kilpailijan laskema pistemäärä, esim. 1217315 tai
19113 tai 12.

Esimerkki:

CLAIMED-SCORE: 131784

9) CLUB: tekstiä

Sen radiokerhon nimi, jonka hyväksi lokin tuoma pistemäärä lasketaan. Käytetään,
jos kisaan liittyy tiimikilpailu.

Esimerkki:

CLUB: Contest Club Finland

10) CONTEST: kilpailun-nimi

Kilpailun-nimen pitää olla yksi seuraavista: AP-SPRINT, ARRL-10, ARRL-160,
ARRL- DX-CW, ARRL-DX-SSB, ARRL-SS-CW, ARRL-SS-SSB, ARRL-UHF-AUG,
ARRL-VHF-JAN, ARRL- VHF-JUN, ARRL-VHF-SEP, ARRL-RTTY, BARTG-RTTY,
CQ-160-CW, CQ-160-SSB CQ-WPX-CW, CQ-WPX-RTTY, CQ-WPX-SSB, CQ-VHF, CQ-WW-CW,
CQ-WW-RTTY, CQ-WW-SSB, DARC-WAEDC-CW, DARC-WAEDC-RTTY, DARC-WAEDC-SSB,
IARU-HF, NAQP-CW, NAQP-RTTY, NAQP-SSB, NA- SPRINT-CW, NA-SPRINT-SSB, NEQP,
OCEANIA-DX-CW, OCEANIA-DX-SSB, RSGB-IOTA, SAC- CW, SAC-SSB, STEW-PERRY tai
TARA-RTTY.

Kotimaisille ja skandinaavisille kilpailuille täytyy määrittää yhteisesti
sovittu kilpailun-nimi, mikäli sitä ei löydy ylläolevasta luettelosta.

Esimerkki:

CONTEST: CQ-WW-CW

11) CREATED-BY: tekstiä

Cabrillo-tiedoston luomiseen käytetyn lokiohjelman nimi ja versio.

Esimerkki:

CREATED-BY: TR Log POST Version 6.72A

12) IOTA-ISLAND-NAME: tekstiä

Tämä on käytössä vain RSGB:n IOTA-kilpailussa saariasemien osalta. Tähän
kirjoitetaan sen saaren nimi, jolta operointi tapahtui (ei IOTA-numeroa).

Esimerkki:

IOTA-ISLAND-NAME: Raippaluoto Island

13) NAME: tekstiä
14) ADDRESS: tekstiä

Nimi ja osoite. Tyypillisesti ADDRESS:-rivejä on niin monta kuin
osoitteessa on rivejä.

Esimerkki:

NAME: Jari Perkiömäki
ADDRESS: Påskvägen 26 K 82
ADDRESS: FIN-65320 VASA
ADDRESS: FINLAND
ADDRESS: EUROPE

15) OPERATORS: kutsumerkki1 [kutsumerkki2 kutsumerkki3...]

Välilyönnein eroteltu luettelo operaattoreiden kutsumerkeistä.

Esimerkki:

OPERATORS: OH6BG

16) OFFTIME: aloitusaika päättymisaika

Single-operaattorit käyttävät tätä WAE-kilpailussa lepotaukojen
merkitsemiseen.  Voisi olla käyttökelpoinen myös WPX:ssä, joskin ko. kisan
järjestäjät sanovat, että lokintarkistusohjelma laskee lepojaksot
QSO-tiedoista

Tiedon rakenne:

         -----alkoi----- ----loppui-----
OFFTIME: päivämäärä aika päivämäärä aika
OFFTIME: vvvv-kk-pp nnnn vvvv-kk-pp nnnn
OFFTIME: 2002-03-22 0300 2002-03-22 0743
0000000001111111111222222222233333333334
1234567890123456789012345678901234567890

Esimerkki:

OFFTIME: 2002-03-22 0300 2002-03-22 0743

17) SOAPBOX: tekstiä

Kilpailuun liittyviä kommentteja. Jokaisen kommenttirivin alussa pitää olla
SOAPBOX:-tunniste.

SOAPBOX: Hauska kilpailu, vaikka antenninkääntöboxista jysähti sulake.
SOAPBOX: Toinen kilpailupäivä mastoa käännettiin käsivoimin.
SOAPBOX: Että sillai.

Jos jatkamme CQ WW CW -kilpailun esimerkkiä, olemme tähän mennessä saaneet
Cabrillo-lokiin seuraavat rivit (tosin TR:n generoima rivitunnisteiden
järjestys hiukan häilyy edellä esitetystä speksin mukaisesta
järjestyksestä):

START-OF-LOG: 2.0
CREATED-BY: TR Log POST Version 6.72A
CALLSIGN: OH6BG
CONTEST: CQ-WW-CW
CATEGORY: SINGLE-OP 10M LOW
CLAIMED-SCORE: 131784
CLUB: Contest Club Finland
NAME: Jari Perkiömäki
ADDRESS: Påskvägen 26 K 82
ADDRESS: FIN-65320 VASA
ADDRESS: FINLAND
ADDRESS: EUROPE
OPERATORS: OH6BG
SOAPBOX: Hauska kilpailu, vaikka antenninkääntöboxista jysähti sulake.
SOAPBOX: Toinen kilpailupäivä mastoa käännettiin käsivoimin.
SOAPBOX: Että sillai.

Tämän jälkeen tulevat QSO-tiedot ja lopuksi END-OF-LOG:-rivi.

18) QSO: QSO-data

QSO-data esitetään kilpailun järjestäjien edellyttämässä muodossa. QSO-
tunnisteella alkavia rivejä on niin paljon kuin lokissa on QSO:ja.

Cabrillon QSO-dataformaatti ei ole kaikista käsityksistä huolimatta
geneerinen - kaikkiin mahdollisiin tilanteisiin soveltuva - vaan on
erittäin sidottu kyseessä olevaan kilpailuun. Tämän takia täytyy olla
huolellinen, että QSO-data esitetään siinä muodossa kuin kilpailun
järjestäjä on sen määritellyt. Täten onkin odotettavissa, että kotimaisiin
kilpailuihin kehitetään yhteistuumin kilpailu kilpailulta Cabrillolle
soveltuvat QSO-dataformaatit. Tällöin myös lokintarkastukseen
tarkoitettujen ohjelmien kehittely tulee helpommaksi - mikä tarkoittaa
lokitarkastuksen helpottumista ja tulosten nopeampaa valmistumista.

Otetaan esimerkiksi CQ WW -kilpailu. He ovat tarkasti määritelleet, millä
tavalla QSO-data täytyy QSO-rivillä asemoida. Esimerkki alla. Huomaa, että
rivipositiossa 81 oleva arvo on tarkoitettu MULTI-2-kategoriaan
osallistuville asemille ja siinä kerrotaan QSO:n pitäneen lähettimen
tunnus.

CQ WW:n QSO-dataformaatti:

                              --------info annettu---- -------info saatu-------
QSO: freq  mo päivämäärä aika kutsu         rst sanoma kutsu         rst sanoma
t
QSO: ***** ** vvvv-kk-pp nnnn ************* nnn ****** ************* nnn ******
n
QSO:  3799 PH 2000-11-26 0711 N6TW          59  03     JT1Z          59  23
0
00000000011111111112222222222333333333344444444445555555555666666666677777777778
8
12345678901234567890123456789012345678901234567890123456789012345678901234567890
1

Alla kaksi QSO-riviä omasta, TR:n generoimasta Cabrillo-tiedostostani,
mistä nähdään että asemointi on speksin mukaista (paitsi uuden position 81
osalta):

QSO: 28000 CW 2002-11-23 0029 OH6BG         599 15     RS0F          599 19
QSO: 28000 CW 2002-11-23 0046 OH6BG         599 15     RA0FN         599 19

Otetaan toiseksi esimerkiksi Jarin OH6QU:n kehittämä NRAU Balticin
Cabrillo-QSO- dataformaatti (ei vielä virallisesti hyväksytetty). HUOM!
TR:n uusin versio ei osaa tuottaa alla näkyvää NRAU:n formaattia.

NRAU Balticin QSO-dataformaatti:

                              --------info annettu---- -------info saatu-------
QSO: freq  mo päivämäärä aika kutsu         rst nr# pr kutsu         rst nr# pr
QSO: ***** ** vvvv-kk-pp nnnn ************* nnn nnn aa ************* nnn nnn aa
QSO:  3500 CW 2002-12-29 0530 OH6QU         599 001 PO OH6BG         599 001 PO
0000000001111111111222222222233333333334444444444555555555566666666667777777777
1234567890123456789012345678901234567890123456789012345678901234567890123456789

missä:
freq       = taajuus kokonaislukumuodossa (kHz). Jos taajuus ei tiedossa,
             sitten 3500 tai 7000
mo         = lähetysmode: CW tai PH (fone)
päivämäärä = UTC-päivämäärä muodossa vuosi-kuukausi-päivä (vvvv-kk-pp)
aika       = UTC-aika
kutsu      = kilpailussa käytetty kutsumerkki
rst        = RST tai RS moden mukaan
nr#        = sarjanumero, joka alkaa 001:sta kolmella numerolla ilmaistuna
pr         = kaksikirjaiminen maakuntatunnus
             (lyhenteet kilpailusääntöjen mukaan)

Lopuksi tarkastellaan SM3CER:n määrittämää SAC:n QSO-dataformaattia.

SAC:n QSO-dataformaatti:

                              --------info annettu---- -------info saatu-------
QSO: freq  mo päivämäärä aika kutsu         rst sanoma kutsu         rst sanoma
t
QSO: ***** ** vvvv-kk-pp nnnn ************* nnn ****** ************* nnn ******
*
QSO: 14000 CW 2002-09-21 1048 7S3A          599    001 4K6GF         599    116
0
00000000011111111112222222222333333333344444444445555555555666666666677777777778
8
12345678901234567890123456789012345678901234567890123456789012345678901234567890
1

missä:
freq       = taajuus kokonaislukumuodossa kHz:nä (esim. 14212, 28032).
             Jos taajuus ei tiedossa, sitten 3500, 7000, 14000, 21000 tai 28000
mo         = lähetysmode: CW tai PH (fone)
päivämäärä = UTC-päivämäärä muodossa vuosi-kuukausi-päivä (vvvv-kk-pp)
aika       = UTC-aika [esim. 1048]
kutsu      = kilpailussa käytetty kutsumerkki
rst        = RST tai RS moden mukaan
sanoma     = kilpasanoma (sarjanumero) 001:stä alkaen
             [e.g. 1, 01, 001, 0001, 00001 tai 000001]
t          = lähetin-ID-tunnus: 0, 1, 2, 3, 4 tai 5 (Käytössä MULTI-ONE
             [eli M/S]- tai MULTI-MULTI [eli M/M]-kategorioissa. Voi osoittaa
             myös QSO:n pitäneen lähetin-vastaanottimen tunnuksen SO2R
             (Single Operator - 2 radios) -konfiguraatiossa.

Vielä lopuksi ehjä esimerkki omasta CQ WW CW -kilpailulokistani niin kuin TR
näkee sen:

START-OF-LOG: 2.0
CREATED-BY: TR Log POST Version 6.72A
CALLSIGN: OH6BG
CONTEST: CQ-WW-CW
CATEGORY: SINGLE-OP 10M LOW
CLAIMED-SCORE: 131784
CLUB: Contest Club Finland
NAME: Jari Perkiömäki
ADDRESS: Påskvägen 26 K 82
ADDRESS: FIN-65320 VASA
ADDRESS: FINLAND
ADDRESS: EUROPE
OPERATORS: OH6BG
SOAPBOX: Hauska kilpailu, vaikka antenninkääntöboxista jysähti sulake.
SOAPBOX: Toinen kilpailupäivä mastoa käännettiin käsivoimin.
SOAPBOX: Että sillai.
QSO: 28000 CW 2002-11-23 0029 OH6BG         599 15     RS0F          599 19
QSO: 28000 CW 2002-11-23 0046 OH6BG         599 15     RA0FN         599 19
[tässä välissä muutama sata kusoriviä lisää]
END-OF-LOG: