KISSINIT Versie 1.00  (20. November 1993)

                 van Ren‚ Stange, DG0FT @DB0KG.DEU.EU

                Vertaling door H.W.Dankmeijer (PE1ECN)


    Inhoud


    1. Algemeen
    2. Programma-oproep en opties
    3. Initialiseringsbestand
    4. Toepassingsvoorbeeld
    5. Copyrights en toepassingsvoorwaarden


    1. Algemeen

    Bij veel TNC'c (bijv. PK232, KAM) moet met speciale opdrachten de
    KISS-mode geactiveerd worden, voor zij met TFPCX gebruikt kunnen
    worden. TFPCX biedt daarvoor zelf geen mogelijkheden. Het programma
    KISSINIT kan naar believen karakter-reeksen over de seriele poort
    aan het TNC afgeven en daarmee de KISS-inschakeling bewerken, even-
    als de de-activering van KISS, wanneer de TNC voor andere doeleinden
    moet worden gebruikt. De toepassing van KISSINIT is overigens niet
    tot TFPCX en KISS beperkt.

    De opdrachten voor activering van de KISS-modes worden uit een tekst-
    bestand (standaard KISS.INI) gehaald. Zij zijn van TNC tot TNC ver-
    schillend en moeten in de TNC handleiding vermeld zijn. KISSINIT
    biedt de mogelijkheid, meerdere initialiserings-reeksen in e e n
    bestand op te slaan en de benodigde varianten bij de start uit te 
    kiezen. Het is zinvol een soort bibliotheek te maken voor de KISS-
    initialisering van de gangbare TNC-typen. Het meegeleverde bestand
    KISS.INI bevat al enige voorbeeld-reeksen, die ik uit verschillende
    mailboxen heb gehaald, maar zelf nog niet hebben kunnen testen.

    Wie tot nu toe met TFPCR heeft gewerkt, kan ook direct het daar ge-
    bruikte bestand AUTOKISS.CFG overnemen (naam in KISS.INI veranderen
    en optie -F gebruiken). Voor het geval daarbij problemen zijn, kan
    het aan de bijzondere betekenis van enige karakter-reeksen bij 
    KISSINIT liggen, die echter zelden in opdrachten zullen optreden.

    Bij oproep van KISSINIT mag TFPCX niet geladen zijn, anders ver-
    schijnt een foutenmelding. De KISS-activering moet voor de start 
    van TFPCX gebeuren. Wanneer meerdere TNC's parallel worden gebruikt
    dan moet KISSINIT voor iedere TNC extra meervoudig opgeroepen wor-
    den.

    De parameters van de seriele poort van het TNC moeten voor KISSINIT
    als volgt worden ingesteld:
     
    - 8 Databits
    - 1 Stopbit
    - geen Pariteitsbit



    2. Programmaoproep en opties

    Bij het oproepen van KISSINIT kunnen bepaalde parameters met behulp
    van commando-regel-opties beinvloed worden. Alle opties beginnen met
    een '-' en worden door spaties van elkaar gescheiden. In een optie
    zijn geen spaties toegestaan. Hoofd-/kleine letters kunnen door el-
    kaar gebruikt worden. Volgende opties zijn mogelijk (met 'KISSINIT
    -H' afroepbaar):

    Opties:                                 Default

    -PCOMn[:xxx]    COM port [address]      COM1
    -Bnnnn          baud rate               9600
    -Dnnn:nnn:nnnn  delay (char/line/exit)  30:300:2000 (ms)
    -F<file>        init file               KISS.INI
    -S<section>     choose section in file
    -K              kiss reset
    -N              no messages

    De opties hebben de volgende betekenis:

    -PCOMn[:xxx] keuze van de seriele poort (n = 1-4)

    Hier moet de seriele poort aangegeven worden waarmee de TNC verbon-
    den is (standaard COM1). Het Portadres van de poort wordt automatisch
    verkregen maar kan naar wens ook direct hexadecimaal aangegeven wor-
    den.

    Voorbeeld:

    KISSINIT -PCOM3:338

    (TNC aan COM3 met Portadres 338H)

    -Bnnnn  Baudrate op de seriele poort (decimaal)
                                       
    Mogelijk waarden zijn 2400, 4800, 9600 (standaard), 19200,  38400  en
    57600 Baud.

    -Dnnn:nnn:nnnn  Vertragingstijden (decimaal in milliseconden)
      ^   ^   ^
      1)  2)  3)

    De meeste TNC's hebben een bepaalde tijd nodig voor de verwerking
    van de ontvangen tekens, voor het uitvoeren van opdrachten (aan het
    eind van een regel) en voor intitialiseringsdoeleinden. Wordt daar-
    mee geen rekening gehouden, dan kunnen karakters verloren gaan of de
    TNC is nog niet in de KISS-mode wanneer TFPCX gestart wordt. 
    KISSINIT wacht daarom na iedere tekenafgifte, aan het eind van een
    regel en aan het eind van een overdracht, een instelbare tijd, voor-
    dat de volgende afgifte gebeurt resp. het programma beeindigd wordt.


    Vertragingstijden        Bereik      Standaard

    1) na ieder teken        0-999  ms     30 ms
    2) na iedere regel       0-999  ms    300 ms
    3) na de overdracht      0-9999 ms   2000 ms

    De standaardwaarden voor 1) und 2) moeten in het algemeen voldoende
    zijn.
    Waarde 3) moet eventueel vergroot worden.

    Voorbeeld:
    
    KISSINIT -D30:300:5000

    Bij TNC2 met The Firmware duurt de KISS-initialisering enige tijd,
    speciaal bij TNC's met een lage klokfrequentie (knipperen van de
    LED's in de gaten houden). Hier wacht KISS daarom 5sec. (=5000 ms)
    voor beeindiging, zodat bij een volgende start van TFPCX uit een
    batch-file de TNC ook in ieder geval in de KISS-mode is.


    -F<bestand>  Naam van het initialiseringsbestand (standaard KISS.INI)

    Wanneer een ander bestand gebruikt moet worden, kan de naam (ook met
    pad) met deze optie aangegeven worden.


    -S<sector>  Initialiseringsreeks (sector) uitkiezen

    Het initialiseringsbestand kan naar wens uit meerdere sectoren be-
    staan, die met '[Name]' beginnen (zie verder). Met deze optie kiest
    men de sectie uit die voor de initialisering toepgepast moet worden.
    Als parameter wordt de naam van de sector aangegeven (zonder []),
    waarbij hoofd/kleine letter niet worden onderscheiden. Standaard
    wordt vanaf het begin van het initialiseringsbestand gelezen.


    -K  KISS-mode uitschakelen

    Moet de TNC alleen uit de KISS-mode teruggezet worden, dan is hier-
    voor geen initialiseringsbestand nodig. Deze optie veroorzaakt het
    zenden van de KISS-reset-reeks aan de TNC. KISS.INI wordt in dit
    geval niet gelezen.


    -N  Meldingen onderdrukken

    Hiermee laten zich de meldingen van KISSINIT en de echo van de ge-
    zonden karakters uitschakelen. Foutenmeldingen verschijnen deson-
    danks.



    3. Initialiseringsbestand

    Het bestand kan de volgende karakterreeksen bevatten:

    \nnn     Stuurteken met dec. ASCII-code nnn (0-255) afgeven.
    \e       Escape-teken (\27) afgeven
    \k       KISS-reset-reeks (\192\255\192) zenden
    \d       1 Seconde pauze
    ^c       Control-teken (c = A-Z) afgeven (bijv, ^X = Ctrl-X)
   
    In de tekenreeks wordt hoofd/kleine letters niet onderscheiden.
    Volgt op het '\' een ander karakter als boven is aangegeven, dan
    wordt een eventuele bijzondere betekenis van dit teken opgeheven
    en alleen het teken afgegegen. Moet bijv. '\' afgegeven worden,
    dan is ook '\\' te gebruiken (resp. '\^' bij het teken '^'). 
    Wanneer een '\' aan het eind van een regel staat, wordt het regel-
    eindteken (CR =\13) niet aan de TNC afgegeven. Een ';' aan het
    begin van een regel leidt een commentaar in. De commentaarregel 
    wordt geheel doorgelezen.

    Het bestand wordt standaard van begin tot einde verwerkt. Wanneer
    men meerdere verschillende intialiseringsreeksen opslaan wil, kan
    men het bestand ook in hoofdstukken of sectoren indelen, waarbij
    met de optie -S (zie boven) gekozen wordt, welke sector gebruikt
    moet worden. Een sector begint met het hoofd '[Name]', die aan het
    begin van een regel moet staan. 'Name' is de benaming die aan de
    optie -S gegeven moet worden.

    Wordt de optie -S toegepast, dan begint de afgifte in de regel die
    volgt na het hoofd van de gekozen sector. Achter ']' in de hoofd-
    regel kan ook commentaar naar wens staan. Onafhankelijk van -S wordt
    de verwerking altijd beeindigd als de volgende sector begint, of als
    het eind van het bestand bereikt wordt.


    4. Toepassingsvoorbeeld


    Een TNC met The Firmware (van NORD><LINK) moet in de KISS-mode ge-
    schakeld worden. De betreffende opdracht luidt '@K' en wordt met 
    een Escape-teken ingeleid. Voor het geven van de opdracht moeten 
    met Control-X eventueel in de regelbuffer van het TNC staande te-
    kens gewist worden. Het bestand KISS.INI bevat volgende regels:

    ^X\e@K

    Wanneer de TNC aan COM1 met 9600 baud is aangesloten, wordt KISSINIT
    bijv. als volgt gestart:


    KISSINIT -PCOM1 -B9600 -D::5000

    Door de optie -D wacht KISSINIT voor het programmaeinde nog 5 sec-
    conden, zodat de TNC de initialisering kan uitvoeren (alleen nodig
    bij langzame TNC's). De vertragingstijden voor tekenafgifte en
    nieuwe regel zijn hier niet aangegeven (de ':' moeten er echter
    zijn), daarvoor worden de standaardwaarden gebruikt. De opties -P
    en -B konden hier eveneens wegvallen, daar COM1 en 9600 baud ook
    standaard zijn. Het beeldscherm ziet er bij dit voorbeeld als volgt
    uit:


  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  ³ KISSINIT v1.00 (Nov 20 1993) by DG0FT ³
  ³     Free for non-commercial usage     ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ COM1 (3F8),  9600 Bd,  30 300 5000 ms ³
  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

  Reading ...

  \24\27@K

    In het onderste deel wordt de seriele poort met Portadres, de baud-
    rate en de vertragingstijden (teken,regel,einde) weergegeven.
    KISSINIT geeft bovendien alle tekens af, die aan de TNC gezonden 
    worden (echo). Niet weer te geven tekens verschijnen als '\nnn' 
    (nnn is de ASCII-code). In het voorbeeld staat '\24' voor '^X' en 
    '\27' voor '\e'. Men kon ook deze voorstelling in het bestand KISS.
    INI gebruiken.

    Voor het afschakelen van de KISS-mode en voor de daarop volgende in-
    stelling van de roepnaam in het TNC kan bijv. de volgende bestands-
    inhoud toegepast worden.

    \k\d\d\d\d\d\
    \eI CALL

    Allereerst vindt een KISS-reset plaats (\k), waarna 5 seconden ge-
    wacht wordt (5 maal \d). Die tijd heeft de TNC nodig om opnieuw te
    starten. Het '\' aan het eind van de regel heeft tot gevolg dat de
    daarnavolgende 'linefeed' niet aan de TNC wordt afgegeven. In de 
    volgende regel wordt met de opdracht 'I' de eigen roepnaam ingesteld.

    Beide initialiseringsreeksen kan men als volgt in  e e n bestand
    combineren:


    ;
    ; KISS inschakelen
    ;
    [KISSON]
    ^X\e@K
    ;
    ; KISS uitschakelen
    ;
    [KISSOFF]
    \k\d\d\d\d\d\
    \eI CALL

    De oproep van KISSINIT vindt dan plaats met (hier zonder -P en -B):

    KISSINIT -SKISSON

    resp.

    KISSINIT -SKISSOFF

    Het bestand bevat bovendien noch commentaarregels. Er moet op gelet
    worden dat dit bestand niet zonder meer zonder de optie -S gebruikt
    kan worden, omdat daarbij vanaf het begin van het bestand tot de
    regel '[KISSON] gelezen wordt en hier alleen commentaren staan.
    Men zou echter voor '[KISSON]' een 'standaard'-reeks in kunnen 
    voegen, die zonder -S toegepast wordt.



    5. Copyrights en toepassingsvoorwaarden

    De auteur van het programma KISSINIT is Ren‚ Stange (DG0FT).
    KISSINIT mag voor toepassing door zendamateurs als copie aan derden
    worden doorgegeven, wanneer hiervoor geen kosten geheven worden. In 
    het bijzonder is het leveren van KISSINIT bij andere hard- en soft-
    ware alleen toegestaan wanneer voor dat eventuele product ook geen
    kosten worden geheven of mijn accoord is verkregen. Het is niet toe-
    gestaan het programma commercieel te gebruiken of te distribueren.

    Een garantie voor de goede werking wordt niet gegeven. De auteur kan
    niet aansprakelijk worden gesteld voor eventuele schade die door 
    het gebruik van KISSINIT kan ontstaan. 
    (Aansprakelijkheidsuitsluiting)

                            ***Einde***