Specifikation av format fr stationsdata                  G.Berg
========================================                  DJ6FM
Fil: DATAFORM.TXT                                         05.06.94

Version 2.0                                               

Beskrivning av formatet fr stationsdata.


1. Allmnt:
==========

1.1 Filer:
------------
- Stationsfiler     *.STN  (fr alla typer av stationer)
- Lnkfiler         *.LNK  (endast fr paketradio)
- Uppdateringsfiler *.UPD


- Alla rader i en fil har samma format.
  (Inga kommentarer etc.).
- Alla rader i en fil har samma antal flt.
- Flten har en bestmd max lngd.




1.2 Flt:
--------
- Flten separeras med kommatecken.
- Kommatecken fr ej slopas ven om flten drefter r tomma.
- Inom ett flt fr inga kommatecken finnas (inte heller i Info-fltet).
- Mellanslag i brjan eller slutet av ett flt fr frekomma.
- Fltets max lngd fr ej verskridas (mellanslag i brjan och slutet rknas ej).
- Flten fr ej fyllas med mellanslag till max lngd.
- ,  och  fr ej anvndas.
- Stora eller sm bokstver kan anvndas fr Call, Lokator och alla
  frkortningar. Stora bokstver rekommenderas.
- Sortering grs oberoende av stora eller sm bokstver
- Rad, datum,band och QRG r numeriska flt. De fr innehlla antingen siffror
  eller mellanslag.
- Saknas information fr vissa flt s lmnas det tomt. Fr numeriska
  flt r vrdet 0 likvrdigt med tomt flt (= info saknas). Fr vriga
  flt kan ocks ett frgetecken '?' anvndas.
- Undantag: Fljande flt fr ej vara tomma:
        Stationsfiler:  Call, rad
        Lnkfiler:      Call1, Call2

Alla frkortningar (Status, Typ, Software, Hardware) bestr av tv bokstver.
Detta r en kompromiss mellan lsbarhet och datavolym.


2. Stationsfiler:
================

Fr varje station (och samma SSID) kan man ange en eller flera rader
(t.ex. om en station har flera anvndarportar med olika QRG, Baud, Sysop etc). 

- Den frsta raden r huvudraden fr en station. Den har radnummer 0.
- Ytterligare rader, tillggsrader,  numreras 1..9
- Tomma flt i en tillggsrad fr samma information som motsvarande flt i
  huvudraden.
- Status och Datum ska, om knda, skrivas in p varje rad.
- Finns flera anvndarportar anges QRG och Baud fr var och en.
- Ytterligare information kan anges p flera tillggsrader.
- I tillggsrader mste flten Sysop, Lokator, QTH och Info vara tomma.
  (I filer fr fyrdata mste fltet Info fyllas i).
- Stationsfilen sorteras efter Call.
- Fr stationer med flera SSID sorteras hela Call-fltet (inkl. SSID) 
  alfabetiskt (1, 10, ..., 15, 2, ..., 9).
- Om det finns flera rader fr samma Call sorteras dessa efter radnummer.


Exempel:

DB0CPU,0,OK,9212,DI,FN,RM,438.425,1200,DJ6II ,JN49FL,Ludwigshafen,AG Mikrocomputer
DB0CPU,1,PL,9211,  ,  ,  ,438.425,9600,      ,      ,            ,
DB0CPU,2,  ,    ,  ,  ,  ,144.650,1200,      ,      ,            ,



Radsyntax:   (allt p en rad)
-------------
Huvudrad:
  call,0,[status],[datum],[typ],[software],[hardware],
    [qrg],[baud],[sysop],[lokator],[qth],[info]

Tillggsrad:
  call,rad,[status],[datum],[typ],[software],[hardware],
    [qrg],[baud],,,,[info*]

* = Endast filer med fyrdata.


Fltinnehll:
------------
Det angivna antalet tecken r max fltlngd (utan mellanslag i brjan eller
slutet).

Call    9 tecken    med SSID (efter bindestreck)
                    Exempel: DB0GE-8
                    Fltet fr ej vara tomt.
                    SSID '-0' behver ej anges.

Rad     1 tecken    0 = Huvudrad fr stationen
                    1...9 = Tillggsrader fr samma station
                    Fltet fr ej vara tomt.

Status  2 tecken    Frkortningar:
                      OK = i drift
                      IS = ostabil
                      TE = test
                      DF = defekt
                      PL = planerad

Datum   4 tecken    Datum fr informationen
                    Format: AAMM
                    Exempel: 9212 = december 92

Typ     2 tecken    Frkortningar:
                      Paket radio:
                        DI = Digipeater
                        MB = Mailbox
                        LN = Lnk nod (utan anvndaringng)
                        GW = Gateway          
                        DX = DX-Cluster
                        WX = Vder nod
                        TI = TCP/IP-Server 
                        UN = Anvndare

                      vriga:
                        RR = RTTY repeater
                        RB = RTTY box
                        AR = AMTOR repeater
                        AB = AMTOR box
                        FR = FM repeater
                        FB = FM box
                        TV = ATV repeater
                        LT = Linjr transponder
                        BE = Fyr
                        EM = EME station
                        MM = Multimode repeater

Software 2 tecken   Frkortningar:
                      Paket radio:
                        FN = FlexNet
                        TH = TheNet
                        RN = ROSE/FPAC
                        TN = ThenetNode
                        KN = Kam-Node
                        WA = Wampes
                        OE = OE5DXL-Node
                        BC = BayCom-Node
                        BM = BayCom-Mailbox
                        DW = DigiWare
                        SN = SNet
                        G8 = G8BPQ-Switch
                        DB = DieBox
                        FB = FBB-Server
                        AK = AK1A
                        DP = Digipoint
                        NL = TCP/IP NETCHL
                        NS = NOS
                        SU = SuperVozelj
                        WN = WX-NET
                        UX = UNIX

                      FM, ATV, EME och fyryr: tomt flt
                      Fr anvndares software finns inga frkortningar.

Hardware 2 tecken   Frkortningar:
                      TN = TNC
                      RM = RMNC
                      FA = FALCON
                      SE = SEPRAN

                      PC = PC
                      ST = Atari-ST
                      T3 = TNC3
                      KA = KAM

                      FM, ATV, EME och fyrar: tomt flt
                      Fr anvndares hardware finns inga frkortningar.

QRG     9 tecken    QRG fr anvndarportar anges i MHz med decimalpunkt.
                    Maximalt tillts tre siffror efter decimalpunkten (ange
                    145.6875 som 145.687).
                    Fr duplexrepeater anges dess sndarfrekvens.
                    Om anvndarport saknas ange : -1.0
                    Exempel: 438.425
                    Fel:     438,425  (Komma i stllet fr punkt)


Baud    6 tecken    Baudrate fr anvndarport (Bits/sec):
                    Endast heltal (t.ex. 45.45 anges som 45).
                    Baudrate ver 999999: ange 999999 
                    Anvndarport saknas : tomt flt
                    FM, ATV, EME och fyrar: tomt flt
                    Exempel: 1200


Sysop   6 tecken    Stationsansvarig/sysops anropssignal.

Lokator 6 Zeichen   IARU WW Lokator.
                    Exempel: JN49HI

QTH     36 tecken   Noggrannare angivelse av QTH (t.ex. med hjdangivelse)
                    Exempel: Moeninger Berg 561 m

Info    48 tecken   Valfritt.



Exempel:

DJ6FM ,0,OK,9212,UN,  ,PC,438.425,1200,DJ6FM,JN49HI,Sandhausen  ,HAMMAP-Autor
DB0CPU,0,OK,9212,DI,FN,RM,438.425,1200,DJ6II,JN49FL,Ludwigshafen,AG Mikrocomputer



3. Lnkfiler:
============

Fr varje lnk finns en rad.

Radsyntax:
---------
call1,call2,[status],[datum],[baud],[typ]


Alfanumeriskt mste Call1 < Call2 .
  Rtt:   DB0AAA,DB0AAB,OK,9301,1200,UF
  Fel:    DB0AAB,DB0AAA,OK,9301,1200,UF

Sortering: Frst efter Call1. Sedan efter Call2 om Call1 r lika.
  Exempel:   DB0AAA,DB0AAB,OK,9301,1200,UF
             DB0AAA,DB0AAC,OK,9301,9600,UF
             DB0AAA,DB0AAI,OK,9301,9600,UF
             DB0AAB,DB0AAC,OK,9301,1200,UF
             DB0AAB,DB0AAI,OK,9301,9600,UF
             DB0AAC,DB0AAI,OK,9301,9600,UF


Fltinnehll:
------------
Call1   9 tecken    med SSID (efter bindestreck)
                    Fltet fr ej vara tomt.

Call2   9 tecken    med SSID (efter bindestreck)
                    Fltet fr ej vara tomt.

Status  2 tecken    Frkortningar:
                      OK = i drift
                      IS = ostabil
                      TE = test
                      DF = defekt
                      PL = planerad

Datum   4 tecken    Datum fr informationen
                    Format: AAMM
                    Exempel: 9212 = december 92

Baud    8 tecken    Baudrate fr lnken (Bits/sec):
                    Exempel: 9600
                    Parallel bus: Ange bits

Typ     2 tecken    Typ av lnk:
                      WI = trd lnk
                      BU = intern busfrbindelse
                      NT = Internet lnk
                      HF = HF lnk (kortvg)
                      VF = VHF lnk
                      UF = UHF lnk
                      SF = SHF lnk
                      SL = Satellit lnk



4. Uppdateringsfil:
==================

- Kommandon utfrs i den ordning de str i filen.
- Tomma rader och kommentarrader som brjar med '#' r tilltna.
- I brjan av varje rad (utom kommentarrad) str ett kommando
  som bestr av tv bokstver fljt av ett kolon ':'.


Kommandoformat:
==============

Allt mste st p en rad ven om det hrnedan delats p tv fr lsbarhetens
skull.
     
1. Add Station (Lgg till station)
--------------
AS: call,rad,[status],[datum],[typ],[software],[hardware],
      [qrg],[baud],[sysop],[lokator],[qth],[info]

Lgger till raden i filen.


2. Modify Station (ndra stationsdata).
-----------------
MS: call,rad,[status],[datum],[typ],[software],[hardware],
      [qrg],[baud],[sysop],[lokator],[qth],[info]

I den genom 'call' och 'rad' definierade raden ndras samtliga flt som ej
r tomma i MS kommandot.


3. Delete Station (Ta bort stationen)
-----------------
DS: call[,,datum]

Tar bort samtliga rader och lnkar fr angiven station.


DS: call,rad[,datum]

Tar bort de rader som definieras av 'call' och 'rad'.
'DS: call,0' har samma funktion som 'DS call'.


4. Add Link (Lgg till lnk)
-----------
AL: call1,call2,[status],[datum],[baud],[typ]

Lgger till angiven rad.


5.  Modify Link (ndra lnk).
---------------
ML: call1,call2,[status],[datum],[baud],[typ]

I den genom  'call1' och 'call2' definierade raden ndras samtliga flt
som ej r tomma i ML kommandot.


6. Delete Link (Ta bort lnk)
--------------
DL: call1,call2[,datum]

Tar bort lnken som definieras av 'call1' och 'call2'.


Det finns inget speciellt kommando fr att ta bort enstaka flt.
Denna funktion fr man om man ndrar numeriska flt (datum, baud och QRG) 
till '0' och alla andra till '?'.

                                
ndringar i Version 1.1:
------------------------
- Ytterligere stationstyper:
    FB = FM box
    TV = ATV repeater
- Valfri datum angivelse fr:
    DS = Delete Station
    DL = Delete Link


ndringar i Version 2.0:
------------------------
- Nytt flt fr Typ i lnkdata.
- Sortering efter SSID.
- Lnk baudrate max 8 siffror.
- Info i tillggsrad fr fyrar.
- Ytterligare stationstyper:
    EM = EME station
    MM = Multimode repeater
- Ytterligare hardware:
    T3 = TNC3
    KA = KAM
- Ytterligare software:
    AK = AK1A
    DP = Digipoint
    NL = TCP/IP NETCHL
    NS = NOS
    SU = SuperVozelj
    WN = WX-NET
    UX = UNIX
