####################
# TriOS R56 Netzwerk
####################

Einleitung
==========

Dies ist eine Implementierung von Netzwerk-Funktionen in die aktuelle Version
von TriOS (R56). Als erste Anwendungen sind enthalten:
 - Ein FTP-Client, welcher Dateien von einem FTP-Server downloaden und in der
   RAM-Disk im eRAM oder auf SD-Card abspeichern kann. 
 - Ein vollstndiger IRC-Client
Zuknftige Erweiterungen, wie die Integration in Regime und direktes Starten
von Programmen aus dem Netzwerk sind geplant.


Implementierung
===============

Es wurde ein neuer Administra-Code erstellt, welcher direkt geflasht werden
kann oder zur Laufzeit geladen wird. Grundlage ist das originale admflash.spin.
Aus diesem wurden aus Platzgrnden alle Soundfunktionen entfernt und dafr
die unvernderten Netzwerk-Treiber von Harrison Pham integriert.

Fr die Kommunikation ber den Hive-Bus wurden die wesentlichen Funktionen
des Netzwerk-Treibers zur Verfgung gestellt. Die Implementierung weiterer
Funktionen des Original-Treibers ist bei Bedarf mglich.

Die IP-Konfiguration des Hive wird im NVRAM des RTC gespeichert. Das hat
den Vorteil, da der Hive zuknftig auch ganz ohne SD-Card arbeiten kann,
also quasi aus dem Netzwerk bootet. Ist kein RTC vorhanden (wird automatisch
erkannt), erfolgt das Speichern der Konfiguration auf der SD-Card unter
/system/nvram.sav.


Installation
============

Binr:
------

Voraussetzung ist die Installation eines aktuellen TriOS im Flash von
Administra, Bellatrix und Regnatix sowie auf der zugehrigen SD-Card. In das
Verzeichnis "/system" auf der SD-Card werden die Dateien des Verzeichnisses
"system" des vorliegenden Installations-Archives kopiert:

  admnet.adm:   Administra mit Netzwerk-Funktionen, ohne Sound
  ipconfig.bin: IP-Konfigurationsprogramm
  ftp.bin:      FTP-Client
  irc.bin:      IRC-Client

Quellen:
--------

Das Verzeichniss "src" des vorliegenden Archives wird in die vorhandene TriOS-
Struktur (R56) kopiert. Damit werden die folgenden Dateien durch genderte
Versionen ersetzt:

  lib/glob-con.spin
  lib/reg-ios.spin

Wer dort eigene nderungen vorgenommen hat, sollte sich die nderungen in den
beiliegenden Patches (glob-con.spin.diff und reg-ios.spin.diff) ansehen und
selbst einpflegen.

Folgende SPIN-Dateien knnen dann mittels BST bersetzt werden:

  system/administra/admnet/admnet.spin
  system/regnatix/ipconfig.spin
  system/regnatix/ftp.spin
  system/regnatix/irc.spin

Das bersetzte admnet.spin kann direkt in Administra geflasht oder als
"system/admnet.adm" auf die SD-Card kopiert werden. ipconfig.bin und ftp.bin
gehren dann ebenfalls auf die SD-Card ins system-Verzeichnis.

Wer die make.bat benutzt: Damit sollte ipconfig.spin, ftp.spin und irc.spin
automatisch mit bersetzt werden, admnet.spin mte man noch ergnzen.

TriOS-R56-Network-src.tar.bz2 enthlt die zur Entwicklung genutzten kompletten
Sourcen. Hier wurden alle SPIN-Dateien nach UTF-8 gewandelt und auf Linux-
Zeilenumbruch (LF) konvertiert. Auerdem ist ein Build-Script (make.sh) fr
Linux enthalten. In diesem knnen #defines fr Debugging-Ausgaben und
alternative Locales (z.Z. Englisch) gesetzt werden.


Nutzung
=======

Allgemeines
-----------

Der Netzwerk-Stack in Administra wird erst gestartet, wenn er bentigt wird.
Auch danach sollte man sich nicht wundern, da der Hive nicht per Ping
angesprochen werden kann: Aus Platzgrnden enthlt der Netzwerk-Stack keinen
ICMP-Code. Dieser knnte auf Wunsch aber recht einfach hinzugefgt werden.


Administra
----------

Voraussetzung ist, da Administra mit dem Netzwerk-Code luft. Das geschieht
entweder durch direktes Flashen von admnet.spin oder durch Eingabe von
"admnet" am Regime-Prompt.


IP-Konfiguration
----------------

Mittels "ipconfig" wird die IP-Konfiguration im NVRAM oder als Datei abgelegt.
Folgende Parameter kennt ipconfig:

  /?           : Hilfe
  /l           : Konfiguration anzeigen
  /a <a.b.c.d> : IP-Adresse setzen
  /m <x.x.x.x> : Netzwerk-Maske setzen
  /g <e.f.g.h> : Gateway setzen
  /d <i.j.k.l> : DNS-Server setzen
  /b <m.n.o.p> : Boot-Server setzen
  /i <Id>      : Hive-Id setzen

Aus der Hive-Id wird eine eindeutige Mac-Adresse erzeugt.
DNS-Abfragen werden noch nicht untersttzt, deswegen mu man den DNS-Server
nicht konfigurieren. Der Boot-Server wird derzeit vom FTP-Client als Default-
Server genutzt (s.u.).


FTP-Client
----------

Der FTP-Client ist aktuell eine sehr einfache Implementierung und dient primr
zum Testen der Funktion des Netzwerk-Stacks.

Der Download funktioniert nur, wenn der FTP-Server das Kommando "SIZE"
versteht. Obwohl das kein Standard-Kommando ist, wird es von den meisten
FTP-Servern untersttzt. Auerdem wird nur passives FTP verwendet.

Folgende Parameter kennt der FTP-Client:

  /h <a.b.c.d>    : FTP-Server-Adresse (Host)
                    (default: mit ipconfig gesetzter Boot-Server)
  /d <verzeichnis>: in entferntes Verzeichnis wechseln
                    (default: /hive/sdcard/system)
  /f <dateiname>  : Download <dateiname>
  /u <username>   : Benutzername am FTP-Server
                    (default: anonymous)
  /p <password>   : Pawort am FTP-Server
                    (default: anonymous@hive<Hive-Id>)
  /s              : Datei auf SD-Card speichern

Dabei ist zu beachten, da auf Grund der fehlenden Namensauflsung die IP-
Adresse und nicht der Host-Name des Servers angegeben wird. Weitere
Einschrnkungen ergeben sich durch die maximale Parameter-Lnge von 64
Zeichen in Regime und maximal 12 Zeichen lange Dateinamen in der RAM-Disk.

Ein Beispiel:
Zum Download von ftp://1.2.3.4/verzeichnis/unterverzeichnis/datei.txt
verwendet man folgende Befehlszeile:

  ftp /h 1.2.3.4 /d /verzeichnis/unterverzeichnis /f datei.txt

Dabei erfolgt die Anmeldung wegen der fehlenden Parameter /u und /p als
"anonymous" mit dem Pawort "anonymous@hivexxx" (xxx: mit ipconfig gesetzte
Hive-Id). Die Datei wird in der RAM-Disk gespeichert (s. Kommando "xdir")
und knnte mittels "xsave" auf SD-Card gespeichert werden.

Mit Nutzung aller Default-Werte gengt die Eingabe des folgenden Befehls:

  ftp /s /f ipconfig.bin

Damit wird die Datei "ipconfig.bin" vom FTP-Server mit der IP-Adresse
des mittels "ipconfig" konfigurierten Boot-Servers aus dem Verzeichnis
"/hive/sdcard/system" geladen und im aktuellen Verzeichnis auf der SD-Card
abgespeichert. Von dort knnte sie direkt gestartet werden.

Getestet wurde mit einer lokalen Installation von "pure-ftpd" und den FTP-
Servern der TU Chemnitz sowie des GnuPG-Projektes.

IRC-Client
----------

siehe IRC.README.txt


Schlubemerkung
===============

Fragen knnen im Hive-Forum (http://hive-project.de/board/) gestellt werden
oder direkt an joergd@bitquell.de


Viel Spa - Jrg
