#Ham.Fi Speksaa - sekalainen data Rautakankea varten

Versio 2005-03-02.

Datatiedosto koostuu alkumerkistä sekä tietueista. Tiedoston datablokki alkaa rivillä, jossa on yksinään isoilla kirjaimilla DATA sekä rivivaihto. Tätä seuraavat tietueet, joiden määrää ei periaatteessa ole rajoitettu, mutta suuri tietuemäärä saattaa rajoittaa anturilistan näkymistä kokonaan IRC:ssä. Kaikki rivit ennen alkumerkkiriviä, jossa on DATA, jätetään huomiotta. Datablokki jatkuu tiedoston loppuun.

Tietue on muotoa:

<nimi>;<arvo>;<yksikkö>;<aikaleima>;<maidenhead>;<asl>;<kommentit>

Riville mahtuu yksi tietue ja se tulee päättää asianmukaisella rivinvaihdolla.

VAADITUT KENTÄT

Nimi
Tiedon yksilöivä nimi, esim. ulko, parta. Anturin nimessä sallittuja merkkejä ovat ainoastaan pienet kirjaimet, numerot sekä ala- ja väliviiva [a-z0-9_-]
Arvo
Tiedon arvo. Esimerkiksi anturilta saatu mittaustulos.

VALINNAISET KENTÄT

Yksikkö
Esim. anturin mittaaman suureen yksikkö kuten °C tai m/s tai %. Mikäli et osaa tai muusta syystä et saa tehtyä asteen merkkiä tiedostoon, merkintä DEG (isoin kirjaimin yksikkökentässä) korvataan automaattisesti asteen merkillä ja isolla C:llä (°C) tulostettaessa dataa kanavalle.
Aikaleima
Kellonaika, jolloin mittaus on suoritettu. kts. formaatti alempaa.
Maidenhead
Anturin sijainti Maidenhead ruudukossa. 4-12 merkkiä.
ASL
Korkeustieto merenpinnasta metreinä (pelkkä lukuarvo)
Kommentit
Vapaa kenttä kommenteille

KOMMENTIT

Kommenttirivit aloitetaan merkillä # ja tällaisia rivejä ei käsitellä koneellisesti, kuten ei myöskään tyhjiä rivejä. Huomaa myös, että ennen alkumerkkiä olevat rivit jätetään huomiotta, vaikka niissä olisi aidon tietueen näköistä dataa.

VARATUT MERKIT

Tietueen arvoja erottaa puolipiste (";"). Kyseistä merkkiä ei saa käyttää mihinkään muuhun.

Aikaleiman muoto

YYYYMMDDhhmmss 
YYYY = Vuosi
MM   = Kuukausi
DD   = Päivä
hh   = Tunti
mm   = minuutit
ss   = sekunnit
Aikaleima tulee aina esittää UTC:ssä. Esimerkiksi 
$ date -u +%Y%m%d%H%M%S 
20050124144902

Datatiedosto voisi näyttää vaikka tältä

DATA
sisa;17.62;°C;20050301095513;KP20HE71;26.2;pöydän alla oleva ds182s20
ulko;-5.75;°C;20050301095513;KP20HE71;26.2;ikkunalaudalla 3.5 m maasta
sauna;25.69;°C;20050301095513;KP20HE71;26.2;
tuuli;5.0;m/s;20050301095513;KP20HE71;26.2;
url;http://goblet.net/temperature.html;;;KP20HE71;26.2;lämpökäyrä webissä