TriOS-alt/doku/6-irc-client.txt

150 lines
5.8 KiB
Plaintext
Raw Permalink Normal View History

IRC
IRC-Client f<>r den Hive
Author: J<>rg Deckert (joergd@bitquell.de)
===============================================================================
Einleitung
==========
Dies ist ein IRC-Client f<>r den Hive (http://hive-project.de). Er sollte auf
jedem Hive mit best<73>cktem Netzwerk-Interface funktionieren.
Die Idee des IRC-Clients stammt von PropIRC, einem Projekt von Harrison Pham,
welches aus einer Propeller-basierten Hardware ausschlie<69>lich f<>r diesen Zweck
besteht (http://classic.parallax.com/tabid/701/Default.aspx). Der Administra-
Netzwerk-Stack nutzt dar<61>ber hinaus die Treiber von Harrison Pham.
Der vorliegende IRC-Client hat mit PropIRC ansonsten nicht viel gemein, sondern
stellt einen ausgewachsenen IRC-Client mit den meisten der <20>blichen
Funktionalit<EFBFBD>ten dar.
Installation
============
Der Hive IRC-Client ist Bestandteil des TriOS Netzwerk-Paketes. Die aktuellste
Version steht immer im ersten Beitrag des zugeh<65>rigen Forum-Threads unter
http://hive-project.de/board/viewtopic.php?f=7&t=968 zur Verf<72>gung.
Die Installation ist wie im Download-Archiv beschrieben vorzunehmen. Dabei wird
auch der IRC-Client in das System-Verzeichnis der TriOS SD-Card kopiert und
kann von dort gestartet werden.
Testserver
==========
F<EFBFBD>r erste Versuche mit IRC steht ein eigener Server zur Verf<72>gung. Dieser kann
wie folgt erreicht werden:
IRC-Server (IP-Adresse:Port): 88.198.147.76:6667
nutzbarer Channel: #hive
Nutzung
=======
Start
-----
Der IRC-Client ben<65>tigt den Netzwerk-Code in Administra. Dieser kann direkt in
Administra geflasht oder durch Eingabe von "admnet" geladen werden. Beim Start
pr<EFBFBD>ft der IRC-Client das Vorhandensein der Netzwerk-Funktionalit<69>ten. Sind
diese nicht vorhanden, wird automatisch versucht, "/system/admnet.adm" von der
SD-Card zu laden.
Au<EFBFBD>erdem mu<6D> der Hive nat<61>rlich an ein Netzwerk mit Internet-Verbindung
angeschlossen sein und mittels "ipconfig" entsprechend konfiguriert werden.
Der Start erfolgt dann einfach durch Eingabe von "irc" am Regime-Prompt. Beim
ersten Start wird automatisch die Konfiguration aufgerufen. Nach Eingabe der
erforderlichen Parameter (s.u.) werden diese gespeichert. Nun kann mittels
Dr<EFBFBD>cken von "F3" die Verbindung zum Server aufgebaut werden.
Bedienung
---------
Der IRC-Client besteht aus 3 Fenstern. Im gro<72>en oberen werden die Chat-
Mitteilungen ausgegeben. Im mittleren erscheinen verschiedene Statusmeldungen.
Im untersten Fenster werden die Mitteilungen und Befehle eingegeben.
Das aktive Fenster wird jeweils hervorgehoben und kann mittels Tabulator-Taste
umgeschalten werden. Im aktiven Fenster kann mittels Cursor hoch/runter
gescrollt werden (au<61>er im Eingabefenster).
Die Bedienung erfolgt durch Bet<65>tigung der Funktionstasten oder die Eingabe
von Befehlen im EingabeFenster (s.u.). Alle Befehle beginnen mit einem
Schr<EFBFBD>gstrich (/).
Beim Erscheinen einer neuen Mitteilung im aktuellen Kanal blinkt die Regnatix-
LED so lange, bis eine beliebige Taste gedr<64>ckt wird. Au<41>erdem wird ein Sound
abgespielt.
Befehls<EFBFBD>bersicht
----------------
Funktionstaste Eingabe
--------------+-------+-------------------------------------------------
F1 Hilfe
F2 /set Alle Einstellungen bearbeiten und abspeichern
F3 Mit Server verbinden, anmelden und Kanal betreten
F4 /join Kanal betreten (/join #<Kanal>)
F5 /part Aktuellen Kanal verlassen (/part <Mitteilung>)
F6 /nick Nicknamen <20>ndern (/nick <neuer Nick>)
F7 /user Username <20>ndern
F8 /pass Pa<50>wort <20>ndern
F9 /quit Verbindung zu Server trennen
F10 Programm beenden
/msg Private Mitteilung (/msg <Empf<70>nger> <Text>)
/srv Mit Server verbinden und anmelden (srv <IP:Port>)
/save Einstellungen speichern
Tab Fenster umschalten, Scrollen mit Cursor hoch/runter
Alle anderen mit '/' beginnenden Eingaben sind Befehle an den Server. Alle
Eingaben, welche nicht mit '/' beginnen, sind eine <20>ffentliche Mitteilung an
den aktuellen Kanal.
Einstellungen
-------------
Durch Dr<44>cken von "F2" oder Eingabe von "/set" werden alle notwendigen
Einstellungen (Server, Pa<50>wort, Nickname, Username, Channel) abgefragt und
gespeichert. Zur Erstkonfiguration sollten in jedem Fall alle Parameter
mittels "F2" oder "/set" gesetzt werden.
Die Einstellungen sind auch einzeln <20>ber die in der Befehls-<2D>bersicht
angegebenen Funktionstasten bzw. Befehle erreichbar. Mittel Eingabe
<EFBFBD>ber Befehle kann die gew<65>nschte Einstellung meist auch als Parameter
mitgegeben werden. Im Gegensatz zu "F2" bzw. "/set" werden hier teilweise
auch gleich online die entsprechenden <20>nderungen vorgenommen ("F6" bzw. "/nick"
<EFBFBD>ndert z.B. sofort den aktuellen Nicknamen).
Da der Hive derzeit keine Namensaufl<66>sung unterst<73>tzt, mu<6D> der Server mit IP-
Adresse und Port angegeben werden. Die IP-Adresse kann an einem PC mittels
Ping oder NSLookup ermittelt werden, der Port ist meist 6667.
Der Nickname ist der Name, unter welchem man aktuell seine Mitteilungen
schreibt. Dieser kann jederzeit ge<67>ndert werden. Demgegen<65>ber ist der Username
der Name, mit welchem man sich beim Server anmeldet. Dessen <20>nderung wirkt sich
nur bei einer erneuten Anmeldung aus. Nickname und Username k<>nnen auch
identisch sein.
Bei der Anmeldung am Server wird auch ein vollst<73>ndiger Name <20>bertragen. Da es
un<EFBFBD>blich ist, hier seinen richtigen Namen anzugeben, wird stattdessen ein Name
in der Form "Hive #<HiveId>" generiert. <HiveId> ist der mittels "ipconfig /i"
definierte Wert.
TODO
====
- offene Eingabefenster blockieren nicht den IRC-Empfang
- Support f<>r mehrere gleichzeitige Channel