Start Projekt Dokumentation

1 files changed, 77 insertions, 0 deletions

diff --git a/projekt_doku.asciidoc b/projekt_doku.asciidoc
new file mode 100644
index 0000000..9db5cd9
--- /dev/null
+++ b/projekt_doku.asciidoc
@@ -0,0 +1,77 @@
+= Philips TV-Remote unter Linux
+:author: Benjamin Franzke
+:lang: de
+:imagesdir: image
+
+== Begriffe
+
+- DirectFB
+- DirectFB Voodoo
+
+== Ablauf der Portierung
+
+Im ersten Schritt ist eine eins-zu-eins Umsetzung der Anzeige einen
+Linux-Screens auf einen Fernseher zu implementieren.
+Im zweiten sollten von einem Rechner mehrere Streams an JointSpace-Fernseher
+gesandt werden.  In diesem Fall 3 Clients.
+
+== Linux Betriebssystem
+Arch Linux
+
+== Verbindungsaufbau
+
+Die DirectFB-Voodoo Platform nutzt als Standardmethode zum Verbindungsaufbau
+einen Broadcast Request, um verfügbare Anzeigegeräte zu finden.
+Dies ist für den Einsatz im Heimnetzwerk gedacht, bei dem der
+Verbindungsaufwand möglich gering gehalten werden soll.
+Sind meherere der Fernseher in einem Netzwerk, so ist nicht eindeutig
+definiert, welcher zuerst auf den Broadcast antworten, und dadurch für die
+Verbindung ausgewählt werden wird. 
+Deshalb ist direkter Unicast nötig.
+
+Die Bibliothek bietet kein direktes API, um die Ziel-Addresse zu verabeiten.
+Die Initialisierungsmethode +DirectFB::Init()+ erwartet einen Argumentzähler
+und -vektor. Dieser Vektor bezieht sich auf die Kommandozeilen Argumente,
+im folgenden beispielhaft dargestellt:
+
+[source,c]
+----
+#include <directfb.h>
+int
+main(int argc, char *argv[])
+{
+	DirectFB::Init(&argc, &argv);
+	return 0;
+}
+----
+
+
+== Verbindungsabbruch
+Schlägt die Verbindung fehl, so wird in der Bibliothek DirectFB dies nicht an
+die Anwendung signalisiert.
+Intern wird der Rückgabewert von +send(2)+ nicht auf einen Verbindungsabbruch
+geprüft.
+
+== HowTo
+
+=== Linux-Installation
+
+Arch installieren?
+
+=== DirectFB
+
+[source,sh]
+----
+make
+----
+
+=== Pluggit
+
+[source,sh]
+----
+DIRECTFB_VOODOO= make
+----
+
+=== Browser
+
+Webkit/Firefox?