Nano-X Mas Plugin by gutemine

[besir]

================================================== =
Nano-X for Dreambox 7025 Version 0.9.1 r1
by gutemine from 26. December 2006
================================================== =
!!!!! Happy X-Mas !!!!!
================================================== =
You can find more infos on Nano-X
(the former Microwindows project) on
[Değerli Ziyaretci, linki görmeniz icin bu mesaja cevap yazmanız gerekiyorÜye olmak icin burayı tıklayınız]

This kit for the DMM 7025 can be downloaded
from [Değerli Ziyaretci, linki görmeniz icin bu mesaja cevap yazmanız gerekiyorÜye olmak icin burayı tıklayınız] in the gutemine's
kitchen section of the forum or from [Değerli Ziyaretci, linki görmeniz icin bu mesaja cevap yazmanız gerekiyorÜye olmak icin burayı tıklayınız]

Thanks to BoxMan and OoZooN for supporting the
Nano-X Project on the DMM 7025 !!!!
================================================== =
Release infos
================================================== =
r0 This is the first Version of the Nano-X Port
to the Dreambox 7025
It is based on version 9.1 of the Nano-X
code which was enhanced by gutemine
r1 Kit update to support Pixil PDA Software addon
================================================== =
Englischer Text ist unterhalb des Deutschen Text !
The English text is below the German text !
================================================== =

1) Voraussetzungen
------------------

Nano-X setzt direkt auf dem Linux der Dreambox 7025 auf.
Damit sollte es in jedem Image für die 7025 lauffähig
sein. Das Nano-X Enigma2 Plugin dient nur dazu,
um den Nano-X Server und die jeweiligen nNano-X
Applikationen aus dem Enigma2 GUI der Dreambox
starten zu können.

Nano-X wird in ein /nano-X directory auf der
Dreambox installiert.

Folgende Möglichkeiten bestehen, wie man Nano-X
installieren kann:

a) Installation im Flash

Da das Base Package von nano-X bereits fast
4 MB Speicherplatz benutzt ist es nur
begrenzt empfehlenswert Nano-X direkt
im Flash zu installieren.

Es ist aber problemlos möglich, sofern nicht
bereits zu viele anderen Plugins installiert wurden,
und man keine weiteren Addon-Packs zum Nano-X
mehr installieren will.

In diesem Fall sind keine weiteren Vorbereitungen
mehr nötig.

b) Installation auf der Harddisk, CF Karte
oder USB Stick

Das jeweilige Device muss bereits online
(ggf. das Laden der USB Driver beachten) und
gemountet sein.

Einfach vor der installation von Nano-X im
Telnet einen entsprechenden Link des /nano-X
Directories zum jeweiligen Device anlegen:

cd /
mkdir /media/hdd/nano-X
ln -sfn /media/hdd/nano-X /nano-X

ggf. bei obigen Befehl das /media/hdd
durch /media/cf oder /media/usb zu
ersetzen.

c) Installation im Multiboot.

Wenn Multiboot verwendet wird, so wird empfohlen
es auf CF Karte zu installieren.

Wenn man Mano-X in mehereren Multiboot Images
verwenden will, so ist es evt. empfehlenswert
/media/mbX als Lokation zu verwenden und den Link
Ansatz von b) zu benutzen.

Ansonsten beim enablen von Multiboot die
Defaultpartitionsgröße von 80MB evt. erhöhen
(z.B. /tmp/multiboot.sh enable c 6 0 0 120 -
gibt 6 Partitionen zu je 120MB z.B. auf
einer 1GB CF Karte).

Da damit dann bereits mehr Platz für das Image
zur Verfügung steht, ist wenn man dann vom Multiboot
Image bootet, kein weiter Link wie unter b) nötig
um /nano-X auf ein anderes Device auszulagern.

Weiters benötigt Nano-X um zu funktionieren
für die JPEG und PNG Grafik File unterstützung
die entsprechenden Libraries im Image installiert:

libpngi12-0
libpng3
libjpeg62 (evt. mit install -force-overwrite)
libz1

Wenn Nano-X in einem aktuellen DMM Standardimage
oder einem entsprechend aktuellen CVS Image installiert
wird, so sollten falls ein ipkg update vorher erfolgt
ist, obige evt. fehlenden Libraries automatisch
heruntergeladen und gemeinsam mit dem nanox-base
ipk file installiert werden.

Sollte die Dreambox dafür nicht online sein, oder
man ein Image verwenden das nicht mit den
Standard DMM ipkg upgrade server verbunden ist,
bitte die entsprechenden ipk Files selber herunter
zu laden und per FTP auf /tmp zu kopieren und
dann zu installieren

Dies kann mit dem Blue Pannel erfolgen sofern das
Image eines hat, oder mit folgenden Befehlen
im Telnet:

cd /
ipkg install -force-overwrite /tmp/lib*.ipk

/boot not found errors bei installation der ipk
Files in Multiboot Parttitionen können ignoriert
werden.

Die im Nano-X Plugin Kit mitgelieferten Nano-X
Libraries werden bei der Installation von Nano-X
nur von /usr/lib auf /nano-X/lib verlinked,
um Platz im Image zu sparen fals /nano-X über
einen Link aus dem Flash ausgelagert wurde.


2) Installation
---------------

Zuerst das nanox-base*.ipk file aus
nanox-base*.zip auf /tmp mit FTP kopieren
(TCP/IP muss dafür im Dreambox Image natürlich
bereits funktionieren).

Wenn Du ein Image im Flash hast, das im
Blue Pannel die Möglichkeit bietet ipkg
Addons Manuell von /tmp zu installiern, so
kannst Du es verwenden um den Kit zu installieren.

Ansonsten den Kit mit folgenden Befehlen im
Telnet installieren:

cd /
ipkg install /tmp/nanox-base*.ipk

Falls das Image die Möglichkeit bietet enigma
vom Menu Interface neu zu starten, so reicht
dies aus, ansonsten die Box nach der obigen
Installation des Kits zu rebooten.

Jetzt kannst Du Nano-X vom Spiele/Erweiterungen
Menu bei laufendem Enigma2 oder durch
entsprechende Shell Scripts im /nano-X directory
(wenn enigma2 gestoppt wurde) bereits starten.

3) Verwendung
-------------

Mehr zur Verwendung von Nano-X und der
Nano-X Applikationen, sowie wie man diese schreibt,
bzw. auf Nano-X portiert kannst Du der Nano-X
Dokumentation auf der Nano-X Webpage
([Değerli Ziyaretci, linki görmeniz icin bu mesaja cevap yazmanız gerekiyorÜye olmak icin burayı tıklayınız]) entnehmen.

Im Prinzip wird auf der Dreambox entweder ein
Applikationscontainer gestartet (ähnlich wie für
Tuxtext) oder enigma2 manuell gestoppt,
der Nano-X Server gestartet, sowie ggf. der
Nano-X Window Manager und die jeweilige(n)
Nano-X Applikation(en)

Einige Beispiel dafür sind im Nano-X Plugin
und den entsprechenden Shell Scripts auf
/nano-X enthalten.

Darüber hinaus gibt es auch einen generischen
Launcher welche auf einfache Weise über eine
Fileschnittstelle die Anpassung der Launchmenus
mit den jeweiligen Applikationen unterstützt
(launcher.cnf im /nano-X/bin Directory).

Im Nano-X Basis Paket sind bereits eine vielzahl
kleiner Applikationen enthalten:

eyes
mines
tetris
chess
Image viewer
Launcher
Screensaver
....

gutemine hat für die einfache Verwendung von Nano-X
den Nano-X Server ein bischen an die
Dreambox 7025 angepasst.

Es wird auf dem TV Schirm Standard VGA Auflösung
unterstützt - also 640x480. Bitte aufpassen,
gerade bei 16:9 Fernsehern kann durch entsprechende
Anzeigemodi (Zoom, immer 16:9, Cinema,...) es zu
Verzerrungen bzw. Streifen kommen, also evt. ein
bischen experimentieren bis man die beste
Einstellung gefunden hat.

Die Fernbedienung ersetzt die Mouse:

Mit den rechts/links/rauf/runter Tasten wird der
Cursor bewegt. Einfaches Drücken der jeweiligen Taste
bewegt 2 Pixel in die jeweilige Richtung, Längeres
Drücken bewegt jeweils 10 Pixel.

Die OK Taste entspricht dem Mouseklick. Benötigt man
Bewegen der Mouse mit gedrückter Mousetaste muss man
den Cursor an die entsprechende Stelle bewegen (z.B.
obere Fensterdekoration um das ganze Fenster zu
bewegen) und die OK Taste länger gedrückt halten,
damit die Mousetaste sozusagen einrastet. Dann kann man
mit den Pfeiltasten wie gewohnt Mouse und das
selektierte Fenster bewegen.

Ein einfacher Druck auf OK entrastet die Mousetaste wieder.

Solange im LCD Display das Nano-X Logo gezeigt wird
ist der Nano-X Server aktiv.

Durch Drücken der Tv oder Exit taste wird dieser
Nano-X Server (und alle darauf laufenden Nano-X
Applikationen) beendet und enigma2 kann wieder
starten.

Für die Bedienung der jeweiligen Nano-X Applikationen
verweise ich auch die Nano-X Dokumentation bzw. auf
die Intuitive Benutzung durch den Anwender !

4) Limitierungen
----------------

Im Moment ist weder das DMM Keyboard noch USB Keyboard
und Mouse von Nano-X unterstützt - es war schon Spass
genug den Support für die Dreambox Fernbedienung zu
implementieren. Möglich ist es aber natürlich, später
auch diese Devices zu unterstützen,
entsprechende Beispieldriver sind im
Nano-X Source Kit enthalten.

Im Moment ist Nano-X zwar mit GIF und JPEG Support
compiliert und gelinked, dieser funktioniert aber noch
nicht richtig, Bitmaps und PNG Grafik Files
funktionieren aber bereits.

5) Upgrade und Deinstallation
------------------------------

Wenn einen neue Version von Nano-X rauskommt,
muss man diese eigentlich nur über die vorherige
darüber installieren, bitte beachten
das dadurch ggf. angepasste Konfig Files oder
Skripte überschrieben werden können.

Will man Nano-X loswerden, so reicht ein
ipkg remove:

ipkg remove nanox-base

Anschließend rebooten und die Dreambox sollte
Nano-X frei sein !


6) und was machen wir morgen ?
------------------------------

Auf der Nano-X Homepage und durch Googeln könnt
Ihr leicht herausfinden das es bereits eine Vielzahl
von eigenen Nano-X Applikationen, bzw. auf Nano-X
portierte Applikationen gibt (VNC Client, Mozilla,
Doom,...).

gutemine HOFFT natürlich das diese Basisportierung
von Nano-X EUCH eine Anregung ist, auch diese auf
der Dreambox 7025 verfügbar zu machen, auf das
es bald eine Vielzahl von Addon-Packs für
Nano-X geben wird !

================================================== ==
Viel Spass mit Nano-X auf der Dreambox 7025 !!!
================================================== ==

1) Prerequisites
----------------

Nano-X is implemented on-top of your plain Linux on
the Dreambox 7025. Hence it should be working with
any 7025 image.

The Nano-X Enigma2 Plugin is only for starting the
Nano-X Server and the choosen Nano-X Applikationen
from the Enigma2 GUI of the Dreambox.

Nano-X is installed in a /nano-X directory on
the Dreambox.

You have the following possibilities for
installing Nano-X:

a) Installation in Flash

Because the Base Package of nano-X needs almost
4 MB Storageplace it is recommended to
install Nano-X not in Flash.

It is possible to do so without problems,
if you haven't installed already too many
other plugins and if you don't plan to install
any addon-packs for Nano-X.

In this case no further preparations are needed.

b) Installation on Harddisk, CF Card or USB Stick

The choosen device has to be online (maybe you
have to load the USB drivers) and mounted already.
Simply before you start the installation of Nano-X
create in Telnet a link of the /nano-X directory
to the choosen device:

cd /
mkdir /media/hdd/nano-X
ln -sfn /media/hdd/nano-X /nano-X

Maybe replace the /media/hdd by /media/cf or
by /media/usb in the commands above.

c) Installation in Multiboot.

If Multiboot is used, it is recommended to install
it on CF Card. If you want to use Nano-X in all
Multiboot Images consider to install it at
/media/mbX, the multiboot Exchange Partition and
use the link approach from b).

When you enable Multiboot the default partitionsize
should be increased from 80MB
(e.g. /tmp/multiboot.sh enable c 6 0 0 120
- this gives you 6 partitions with 120MB each
for example on a 1GB CF Card).

Because you then have already more free
Space in the image you don't have to use an
extra link like in b) when bootet from a
Multiboot Image to have /nano-X at a
different device.

To make Nano-X working you will have to
install for the JPEG and PNG graphics support
the following libraries in your image:

libpng12-0
libpng3
libjpeg62 (maybe needs install -force-overwrite)
libz1

When Nano-X is installed in the latest DMM
Standardimage or in an up-to-date CVS Image,
then the ipkg install will download and install
these ipk files automatically (if your dreambox
is online and an ipkg update was done in advance)
together with the nanox-base ipk file automatically.

If the Dreambox is not online or you are using
an Image not using for ipkg update the DMM
Downloadserver, then you have to download the needed
ipkg files yourself and copy them via FTP to /tmp

There you then can install the library ipk
files either via Blue Pannel, or if your images
doesn't have one with the command below in telnet:

cd /
ipkg install -force-overwrite /tmp/lib*.ipk

/boot not found errors during the ipk installation
in an Multiboot configuration can be ignored.

The in the Nano-X Plugin Kit delivered
nano-X Library files will be only linked from
/nano-X/lib to /usr/lib to save Place in the
Image.

2) Installation
---------------

First copy the nanox-base*.ipk file from
nanox-base*.zip to /tmp with FTP (TCP/IP
must be working already).

If you have flashed an image that offers a
Blue Pannel Manual ipkg Installation, you can
use this functionality to install
the kit.

If not, then install the whole files by
entering the following commands in a
Telnet session:

cd /
ipkg install /tmp/nanox-base*.ipk

If the image offers an enigma2 restart
functionality this is sufficient, if not
simply reboot after extracting the kit.

Now you can start Nano-X from the Plugins
Menu or via the provided example shell
scripts at the /nano-X directory (in this case
enigma2 needs to be stopped manually before).

3) Usage
--------

More about the usage of Nano-X and the
Nano-X applications and about writing and
porting Nano-X applications you can learn
from the Nano-X documentation on the
Nano-X Webpage ([Değerli Ziyaretci, linki görmeniz icin bu mesaja cevap yazmanız gerekiyorÜye olmak icin burayı tıklayınız].

In principle enigma2 will open an application
container (like for Tuxtext) or will be stopped
and the Nano-X server will be started, probably
together with the Nano-X Windows Manager and
the wanted Nano-X application(s).

A few examples for this are pre-built into the
Nano-X Plugin and are included in Shell
scripts at /nano-X.

On top of this there is also a generic
application launcher available which can be
configured over a simple file interface
for customizing the lanchmenu and the
applications started with it
(see launcher.cnf at /nano-X/bin).

In the Nano-X Basis package there are
already lots of small applications included:

eyes
mines
tetris
chess
Image viewer
Launcher
Screen Saver
....

gutemine has enhanced the Nano-X server
a little bit for easier usage on the
Dreambox 7025.

It supports showing on TV screen standard
VGA resolution - meaning 640x480.

But be aware that especially with 16:9
TV's depending on their display modus
(Zoom, always 16:9, Cinema,...) you could
get a tweaked picture or stripes -
do some experimenting to find out the
best display modus.

The Remote Control is replacing the Mouse:

With the left/right/up/down Keys you move
the cursor. Simple pressing of these buttons
moves it 2 Pixel in the appropiate direction,
longer press moves 10 pixels.

The OK button is for emulating the mouse
button click. If there is a pressed
mouse button needed while moving the
mouse (e.g for moving a window over the
screen) you have to move the cursor to the
right place (top of window decoration for
example) and press the OK button longer to
lock the mouse button.

Then with the arrow keys you can move the
mouse as usual together with the selected
window. A single OK button press then
unlocks the mosue button.

As long as in LCD display the Nano-X Logo
is shown the Nano-X Server is active.

By pressing the TV or Exit button at any
time you can terminate the Nano-X server
together with all Nano-X applications running
on top of it and enigma2 can start again.

For operating/usage of the Nano-X
applications check the standard Nano-X
documentation or do it intuitively.

4) Limitations
--------------

At the moment neither the DMM Keyboard nor
USB Keyboard or Mouse are supported
from Nano-X. It was already lots of fun
to implement support for the Dreambox
remote control.

But support of these devices is possible
in the future, and there are example
drivers included in the Nano-X source code.

At the moment Nano-X is compiled and
linked with GIF and JPEG support, but it
doesn't seem to work correctly, but Bitmaps
und PNG graphic Files are working already.

5) Upgrade and Deinstallation
------------------------------

When a new Version from Nano-X comes out,
you simply could install it over your existing
installation, but be aware that your customzed
config files or scripts could be overwritten
by this.

For getting rid of Nano-X you simply
can use ipkg remove:

cd /
ipkg remove nanox-base

Then simply reboot your Dreambox and
Nano-X will be gone !

6) where do we want to go tomorrow ?
------------------------------------

On the Nano-X Homepage and by Googeling
you can find out very easily that there
are already lots of applications available
on, or ported to Nano-X
(VNC Client, Mozilla, Doom,...).

gutemine therefore HOPES that this
Basisport of Nano-X is an inspiration
for YOU to make also these applications
available on the Dreambox 7025, so that
soon there will be lots of Nano-X
addon packs !
============================================
Have lots of Fun with Nano-X
on the Dreambox 7025 !!!!
============================================