TNC2 @ALLE       de:DB2OS  21.09.94 10:36   0  18721 Bytes
TF2.7: Befehle TheFirmware
*** Bulletin-ID: 219414DB0EAM ***

de DB2OS @ DB0EAM.#HES.DEU.EU
to TNC2 @ ALLE

S TNC2 @ALLE #0 TF2.7: Befehle TheFirmware

                               NORD><LINK
                         ----------------------
                         TheFirmware TF2.7 DAMA
                        ------------------------

                        BESCHREIBUNG DER BEFEHLE


Zusammenfassung der nderungen
------------------------------
Die TheFirmware TF2.7 unterscheidet sich vom Vorgnger im wesentlichen
darin, da der DAMA-Slave einige sprbare Verbesserungen erhalten hat.
Er folgt nun ausnahmslos den Anforderungen des DAMA Protokolls. Auch wird
bei einer Antwort auf den Poll des Masters keine DCD mehr beachtet
(im Normallfall darf ja nur der betreffende User senden), dadurch
ist die TF2.7 auch fr DAMA auf Duplex-Digis volltauglich und es
kommt zu krzeren Antwortzeiten. Achtung: Bei Digis mit langsamer
Rauschsperre muss ggf. TXDELAY experimentell neu ermittelt werden..
Neu ist auch der FrameSammler, der in der vorliegenden Implementation
unter keinen Umstnden zu Datenverlusten fhren kann (es gab Framesammler,
die nicht unbedingt wasserdicht waren).
Weiterhin ist das Verhalten des RoundTrip-Timers verbessert worden.
Ferner sind eine ganze Reihe von Parametern komplett entfallen
(siehe unten). Teils aus Platzgrnden, teils werden Parameter jetzt
automatisch voreingestellt und knnen durch die User nicht mehr
(falsch) konfiguriert werden.
Wie bereits bei der TF2.6 wird der erweiterte Hostmode (XHOST) nach
DG3DBI untersttzt, sowie auch der SMACK-KISS Mode (KISS mit CRC gegen
Fehler auf der RS232-Leitung).
Einige Level2-Routinen wurden beschleunigt. Die aktuelle interne
Verarbeitungsgeschwindigkeit kann mit dem ESC B Paramater in RPS
(Rounds per Seconds) angezeigt werden. Dieser Wert wird jede Sekunde
neu berechnet.
Bei bisherigen Versionen von TheFirmware konnte es u.U. einen Absturz
von Hostmode-Terminalprogrammen geben, wenn im Monitor-Mode berlange
AX.25 Frames von bestimmten TCP/IP Implementationen empfangen wurden.
Daher werden im Monitor-Mode jetzt alle Frames mit mehr als 256 Byte
Datenlnge unterdrckt und stattdessen eine Fehlermeldung im Datenframe
ausgegeben.
Im Terminal-Mode ist die 7-Bit Umwandlung/Maskierung jetzt vollstndig
entfallen. Bis auf wenige Ausnahmen, werden alle Zeichen 8-Bit transparent
ausgegeben. Um im ECHO-Mode Probleme mit Terminalprogrmamen zu vermeiden,
werden nicht-druckbare Zeichen stattdessen mit einem "." ausgegeben.
Lediglich BELL und TAB werden transparent im Echo ans Terminal geschickt.
Im Monitor-Betrieb mit CALL-Filter wird jetzt auf vielfachen Wunsch
die SSID nicht mehr bercksichtigt.
Die Klartextausgabe fr L3/L4-Frames im Monitor-Modes ist entfallen,
sowas gehrt in gute Terminalprogramme hinein..
Die MHEARD-Liste ist aus Platzgrnden entfallen. blicherweise fhren
alle gngigen Hostmode-Terminalprogramme sowieso Ihre eigene MHEARD-Liste.
Die interne Bufferverwaltung wurde von 32-Byte auf 64-Byte Blcke
umgestellt. Aus Kompatibilittsgrnden bleibt die Bufferanzeige
mit ESC @B aber bezogen auf die bisherige Buffergre unverndert,
bzw. wird intern einfach wieder mit 2 multipliziert.
Die Grenze bei der der TNC selbst keine Connects mehr annimmt
liegt bei 64 freien Buffern. Bei weniger als 128 freien Buffern
wird der Monitor-Mode automatisch abgeschaltet.
Ausserdem wurde eine neue Flow-Control (RNR) eingebaut.
*Pro Kanal* knnen jetzt (25356/Anzahl der Kanle) Zeichen gepuffert
werden. Also 2556 Bytes bei der 10-Kanal und 945 Bytes bei der 27-Kanal.
Somit ergibt sich eine gleiche Verteilung auf alle Kanle..
Ist der Puffer fr den jeweiligen Kanal voll, dann geht der TNC
in den RNR-Zustand. Falls jedoch noch weitere Frames empfangen werden
(zB bei groem Maxframe), werde diese selbstverstndlich noch mit
abgespeichert.  Die Flow-Control gilt im HOST-Mode und im Terminal-Mode,
ist aber abhngig vom ESC U Paramater!

        Also:   Wenn ESC U 1 oder ESC U 2, dann KEINE Flow-Control.
                (hier gilt die bisherige Buffer-Verwaltung)

                Wenn ESC U 0, dann ist die Flow-Control aktiviert!
                (hier gilt die neue Buffer-Verwaltung)

Durch diese neue Bufferverwaltung wird verhindert, dass der TNC
durch einen S&F-Parnter auf einem Kanal berrollt wird und auf
den anderen Kanlen nur noch "* TNC BUSY - LINE IGNORED *"
erscheint (sowas konnte bisher u.U. auch zu Datenverlusten fhren)!
Dies gilt aber nur, wenn der Unattended-Mode mit ESC U abgeschaltet ist!!
Die Anzahl der Buffer mag jetzt gering erscheinen, ein Hostterminal
wird aber im Normallfall die Daten immer schnell genug vom TNC
abholen, soda der beschriebene Zustand eigentlich nicht auftreten
drfte. Das ganze gilt brigens auch nur fr die Empfgangsrichtung.


Wie man sieht, haben sich neben DAMA noch eine Flle von allgeimeinen
Verbesserungen ergeben, die einen Einsatz der neuen TF2.7 auch
bei nicht-DAMA Betrieb sehr sinnvoll machen.


Parameter
---------
Jede Software ist nur so 'gut' wie die eingestellten Parameter.
Bei der neuen TF2.7 sind eine ganze Reihe von Parametern entfallen, um
die Sache auch fr die User mglichst einfach und berschaubar zu halten..
Da aber Parameter oftmals vom Typ des Digis abhngen, z.B. Duplex-Digi,
Simplex-Digi, DAMA-Digi, usw., knnen Anpassungen an die rtlichen Gegeben-
heiten notwendig sein. Bitte eventuell vorhandene Hinweise im Knoten beach-
ten (Aktuell- und Info-Befehle) und bei Problemen ggf. den Sysop wegen
Parametern befragen. Auch in den Mailboxen sind Infos vorhanden, wie man
Parameter optimieren kann.


ESC A [0|1]    Automatische Einfuegen von LINEFEED-Zeichen <LF> nach einem
               CARRIAGE RETURN <CR> zum Terminal (1=Ja, 0=Nein).
                                                                 Default: 1

ESC B          Anzahl der Hauptschleifendurchlufe in
*NEU*          "Runden pro Sekunde". Diese Zahl erlaubt Rckschlsse
               auf die interne Verarbeitungsgeschwindigkeit der
               TNC-Software (Die Eingabe des ehemaligen DAMA-Timeout
               ist entfallen).

ESC C [Call]   Der 'C'-Befehl  wird fuer den Aufbau einer Verbindung
               (Connect)  benoetigt.  Man  beachte, dass kein 'v' oder
               'via' zwischen der  Empfaengeradresse und den Digipeater-
               Rufzeichen erforderlich ist.
               Ein Connect-Befehl der auf Kanal 0 ausgefuehrt, wird setzt
               den Weg fuer UI-Pakete.

ESC D          Eine bestehende  Verbindung wird getrennt.
               Sind bei der Eingabe des 'D'-Befehls noch nicht alle In-
               formationen ausgesendet bzw. bestaetigt, dann wird der
               Disconnect erst nach Eingang der Bestaetigung fuer das
               letzte Informationspaket  ausgefuehrt. Durch Wiederholung
               des 'D'-Befehls kann dieser Vorgang abgebrochen werden.
               Wird der 'D'-Befehl waehrend des Aufbaus einer Verbindung
               (Link Setup) oder des Beendens (Disconnect) einer Ver-
               bindung eingegeben, dann kehrt der TNC sofort in den Dis-
               connect-Zustand zurueck und sendet automatisch ein DISC um
               unnoetige Aussendungen zu verhindern, falls der eigene TNC
               die Antworten der Gegenstation nicht gehoert hat.
               Wird der 'D'-Befehl im Disconnected-Zustand  eingegeben,
               dann werden alle Parameter des gerade angewaehlten Kanals
               mit den Parametern vom Kanal initialisiert.

ESC E [0|1]    Das ECHO von Eingabe-Zeichen (Daten oder Befehle) zum Ter-
               minal ein- bzw. ausschalten. 1=Ja, 0=Nein.
                                                                Default: 1

ESC F [<n>]    FRACK ist die Wartezeit zwischen der Aussendung eines Paketes
               und dessen Bestaetigung durch die Gegenstation. Die Zeit kann
               direkt in Sekunden eingegeben werden.  Bei Eingaben <16 wird
               dazu der Wert mit 100 multipliziert und durch den Faktor 2
               dividiert. Bei Eingaben >15 erfolgt die Eingabe direkt in
               Millisekunden (L2-Roundtriptime). FRACK ist bei der
               TheFirmware als dynamischer RoundTrip-Timer realisiert,
               der sich der aktuellen Aktivitt auf dem Kanal anpasst.
                                                                Default: 500

ESC G [0|1]    Abfrage der virtuellen TNC-Kanaele im Host-Mode. Im Ter-
               minal-Modus wird dieser Befehl nicht erkannt und es wird
               eine  Fehlermeldung ausgegeben.

ESC H          Die MHEARD-Liste ist aus Platzgrnden im EPROM
*ENTFALLEN*    komplett entfallen. bliche Terminalprogramme fhren
               sowieso eine eigene MHEARD-Verwaltung.

ESC I [Call]   Eingabe des eigenen Rufzeichens (MYCALL). Nach der ersten
               Inbetriebnahme ist es mit Leerzeichen gefuellt. Fuer jeden
               Kanal kann ein  Rufzeichen eingegeben werden. Nach einem
               DISCONNECT wird das Rufzeichen von Kanal 0 uebernommen.
               ACHTUNG: Der TNC geht nur mit eingegebenem Rufzeichen auf
               Sendung!

ESC JHOST[0|1] Umschaltung zwischen Terminal-Modus und Host-Modus.
               Der Host-Modus ist WA8DED-kompatibel und wird von
               verschiedenen Terminalprogrammen unterstuetzt.

ESC K [<n>]    Aktivierung der STAMP-Funktion und Parametrierung der ein-
               gebauten 24-Stunden-Uhr mit Kalender.
               Beispiele:

                 K            -  Stamp und Datum/Zeit anzeigen
                 K 0          -  Stamp abschalten
                 K 1          -  Stamp Statusmeldungen einschalten
                 K 2          -  Stamp Status- und Monitormeldungen
                                 einschalten
                 K 20.02.88   -  Datum setzen, europaeische Form
                 K 02/20/88   -  Datum setzen, amerikanische Form
                 K 17:36:00   -  Uhrzeit setzen
                                                                Default: 0

ESC L [0..10]  Mit  dem 'L'-Befehl wird der Link-Status eines oder aller
               Kanaele (ohne Parameter) angezeigt. Es werden Informationen
               ueber den Verbindungsweg (Rufzeichen und Digipeaterliste),
               Anzahl empfangener Frames, Anzahl noch nicht gesendeter
               Frames, Anzahl noch nicht bestaetigter Frames und der je-
               weilige Retry-Zaehler angezeigt. Der jeweils benutzte Kanal
               wird durch ein '+' Zeichen markiert.

ESC M [IUSCN+-]Aktivierung und Parametrierung des Monitor-Modus. Mit den
               Parametern wird vorgegeben, welche Frames angezeigt werden
               sollen.
               Beispiele:

                 N        keine
                 I        Informationen
                 U        unprotokollierte Sendungen
                 S        Kontroll Pakete
                 C        Monitor auch an wenn eine Verbindung besteht
                 +        <Liste von bis zu 8 Rufzeichen>: nur Pakete
                                                           dieser Stationen
                 -        <Liste von bis zu 8 Rufzeichen>: keine Pakete
                                                           dieser Stationen

               Die kombinierte Benutzung der '+' und '-' Parameter wird nicht
               unterstuetzt. Sie muessen als letzter Parameter vor dem Ruf-
               zeichen eingegeben werden. Die Eingabe von '+' oder '-' ohne
               Rufzeichen loescht die aktuelle Liste. Es erfolgt keine
               Auswertung der SSID!
                                                                Default: N

ESC N [0..127] Parametrierung des Retry-Zaehlers. Es wird angegeben, wie oft
               die Zustellung eines Paketes versucht werden soll (0= un-
               endlich). Fuer jeden Kanal kann ein eigener Wert angegeben
               werden. Nach RESET oder Disconnect wird jedoch der Wert aus
               Kanal 0 uebernommen. Im unbeaufsichtigten Betrieb den
               Parameter NIEMALS auf 0 einstellen!!!!
                                                                Default: 10

ESC O [1..7]   Maximale Anzahl von ausstehenden und unbeantworteten I-Frames
               (MAXFRAME). Fuer jeden Kanal kann ein separater Wert vorgege-
               ben werden. Nach jedem Disconnet oder RESET wird aber wieder
               der Parameter von Kanal 0 uebernommen.
                                                                Default: 2

ESC P [0..255] P-Persistence Einstellung.
               Ohne Parameter erfolgt die Anzeige der aktuellen Einstellung.
               Bei DAMA wird dieser Wert ignoriert!
                                                                Default: 32

ESC QRES       Neustart der Firmware (Kaltstart) aus dem EPROM.

ESC R [0|1]    Ein- und Ausschalten der Digipeat-Funktion. 1=Ja, 0=Nein.
                                                                Default: 1

ESC S [0..10]  Umschaltung zwischen den Kanaelen (0= Monitorkanal)
                                                                Default: 0

ESC T [0..127] Verzgerung zwischen Hochtasten des Senders und Start der
               Datenaussendung (TXDELAY). Die Einstellung erfolgt in 10 ms-
               Schritten. Bitte experimentell einen moeglichst geringen
               Wert ermitteln und einstellen.
                                                                Default: 25

ESC U [0|1|2]  Mit dem 'U'-Befehl hat man die Moeglichkeit, eine Meldung an
               anrufende Stationen zu senden (CTEXT). Dieser Text bleibt
               auch dann erhalten, wenn dieser Modus wieder abgeschaltet
               wird. Mit 'U2' kann der TNC (nur im Terminal-Mode!) dazu
               veranlasst werden durch den Empfang des Strings "//Q"
               einen Disconnect der laufenden Verbindung einzuleiten.
               Der String "//Q" muss dazu am Anfang eines einzelnen
               Paketes stehen. Im HOSTMODE ist diese Funktion gesperrt.

               Beispiele:

                 U 1 Text          CTEXT eingeben
                 U 1               CTEXT wird ausgesendet
                 U 2 (text)        CTEXT und //Quit-Funktion!
                 U 0               CTEXT wird nicht ausgesendet
                 U                 CTEXT anzeigen
                                                                Default: 0

ESC V          Ausgabe eines Strings, der Informationen ber
               die aktuelle Softwareversionsnummer gibt.

ESC W [0..127] Parametrierung der Slot-Time (Zeitschlitz) in Millisekunden.
               Ohne Parameter erfolgt die Anzeige der aktuellen Einstellung.
               Bei DAMA wird dieser Wert ignoriert. Der TNC geht immer
               *sofort* auf Sendung.
                                                                Default:  10

ESC X [0|1]    Steuerung der PTT-Leitung des TNC. Falls erforderlich kann
               hiermit das Einschalten des Senders unterdrueckt werden, wenn
               man z.B. die Frequenz beobachten moechte, aber verhindern will,
               dass der TNC bei einer Connect-Anfrage ein Busy-Paket zurueck
               sendet.
                                                                Default: 1

ESC Y [0..10]  Eingabe der maximal zulaessigen Kanaele, bis eine anrufende
               Station "busy" bekommt. Die Ausgabe erfolgt in der Form "max-
               imale Anzahl Kanaele (belegte Kanaele)" (funktioniert nur,
               wenn ueberall gleiche SSID wie im Monitor-Kanal S0 verwendet
               wird).
               Beispiel: "4 (0)"                                 Default:   10

ESC Z [0..3]   Ein- bzw. Ausschalten der Flowsteuerung und des XON/XOFF-Hand
               shaking zum Terminal. Ist die Flowsteuerung eingeschaltet,
               dann sendet der TNC solange keine Zeichen zum Terminal, wie
               Daten oder Befehle eingegeben werden. Bei ausgeschalteter
               Flowsteuerung werden die Zeichen vom TNC sofort zum Terminal
               ausgegeben, egal ob gerade eine Text-Zeile oder ein Befehl
               eingegeben wird.
               Ist die XON/XOFF-Steuerung eingeschaltet, so kann die Ausgabe
               vom TNC zum Terminal mit CONTROL-S gestopt und mit CONTROL-Q
               wieder gestartet werden.
               Beispiele:

                 0             Flow  Aus    , Xon/off  Aus
                 1             Flow  Ein    , Xon/off  Aus
                 2             Flow  Aus    , Xon/off  Ein
                 3             Flow  Ein    , Xon/off  Ein
                                                                 Default: 3


Ueber den '@'-Befehl  sind weitere  Befehle mit Parameteruebergabe moeglich:


ESC @A1        *ENTFALLEN*
ESC @A2        *ENTFALLEN*
ESC @A3        *ENTFALLEN*

ESC @B         Anzeige der freien TNC-Buffer.

ESC @D [0|1]   Ein- und Ausschalten des Vollduplexbetriebes.     Default: 0

ESC @F [0|1]   Flags in den Pausen senden (0=Nein, 1=Ja).        Default: 0

ESC @I [<n>]   Wert fuer max. IPOLL-Framelaenge eingeben, bzw.
               anzeigen (gilt nicht bei DAMA!).                  Default: 60

ESC @K         Einschalten des eingebauten KISS/SMACK-Modus.

ESC @M         *ENTFALLEN*

ESC @T2 [<n>]  Zeitspanne bis zur Bestaetigung eines empfangenen Paketes.
                                                                 Default: 150

ESC @T3 [<n>]  Zeitspanne die der TNC bei einer bestehenden Verbindung auf
               ein Lebenszeichen der Gegenstelle wartet. Nachdem T3 abge-
               laufen ist, wird beim Partner angefragt, ob er noch empfangs-
               bereit ist.
                                                                 Default: 18000

ESC @U [0|1]   UIPOLL aktivieren. (0=UI 1=UI+)                   Default: 0

ESC @V [0|1]   Rufzeichen-Check ein- bzw. ausschalten (1=Ja, 0=Nein).
                                                                 Default: 0


Zusammengestellt aus Beschreibungen von 
DB2OS, DF2AU und DC4OX ........................ DJ1OR September/1992
berarbeitet fr die aktuelle TF2.6 ........... DB2OS Juli/1993
berarbeitet fr die aktuelle TF2.7 ........... DB2OS September/1994

