(02/18)AyIX v1.0

AyIX v1.0

AyIX is a pure Python-based emulated Unix-like OS for Series 60 mobile phones.
It consists of a monolithic kernel which runs in the main UI thread, and
spawns console-based sub-processes in separate threads. In addition, there are
a number of libraries (e.g. termios) which simulate the equivalent Unix-only
Python library of the same name. The goal is to allow any console-based Python
script, which will run on a Unix-like environment, to also run on AyIX.

Limitations
~~~~~~~~~~~

Although the installation SIS file should install on any Series 60 3rd Edition
device, it is of little use without a QWERTY keyboard. It has only been tested
on the Nokia E90 mobile phone, which is the main target platform, but,
theoretically, should work with a wireless keyboard on other platforms.

In addition, there are some POSIX functions which I have been unable to
simulate, most notably os.fork(). Further, it is still very much a
work-in-progrss, and many functions from the 'posix' module have yet to be
implemented.

Installation
~~~~~~~~~~~~

The system is distributed as a single SIS file, which contains all of the
bytecode-compiled scripts which make up the system, and the full Python source
code for those files. The distribution SIS is presently self-signed with the
maximum available capabilites possible for a self-signed SIS (i.e.
NetworkServices, LocalServices, ReadUserData, WriteUserData, UserEnvironment)
so as minimise the limitations for the scripts which it runs.

First of all, you will need to have installed the Python for Series 60 SIS
file, which is available from

http://sourceforge.net/projects/pys60.

When installing the AyIX SIS file, for some reason, it will not work unless
it is installed to the same drive as the PyS60 SIS file.

The file system
~~~~~~~~~~~~~~~

On the S60 device's file system, the SIS installation directory
(e.g. E:\Private\e31f3545) shall be referred to as $INSTALL.

S60 path AyIX path
----------------------------------------------------------------------------
$INSTALL (N/A)
$INSTALL\root /
c:\ /media/phone
c:\resource /lib (read-only)
d:\ /tmp
e:\ /media/sd
z:\ /media/rom (read-only)

File descriptions
~~~~~~~~~~~~~~~~~

A brief description of the most significant files and directories.

Filename Description
----------------------------------------------------------------------------
$INSTALL\default.py Boot script which just calls /boot/kernel
/bin Bytecode-compiled Python scripts
/bin/cc Compiles Python scripts to bytecode
/bin/cp Copies files
/bin/ct A test program for the curses library
/bin/dis Python bytecode disassembler
/bin/edit A very basic text editor
/bin/ls Lists files and directories
/bin/mv Moves (renames) files
/bin/pwd Prints current working directory
/bin/python Python interpreter
/bin/rm Removes files
/bin/sh A simple shell
/bin/stty Prints and resets terminal settings
/bin/wget Downloads files from URLs
/boot Boot directory
/boot/font.png Terminal font
/boot/kernel The OS kernel emulator
/etc System config
/etc/group Group config file (currently unused)
/etc/passwd User config file (currently unused)
/lib Python for Series 60 modules
/media Some mount directories
/media/phone Mounted contents of C:
/media/rom Mounted contents of Z:
/media/sd Mounted contents of E:
/sbin/ifconfig Show information about running network interfaces
/sbin/ifdown Stop a network interface (via an access point)
/sbin/ifup Start a network interface (via an access point)
/sbin/lsif Show information about available network interfaces
/tmp System temp directory
/usr User directory
/usr/lib Bytecode-compiled python modules
/usr/lib/ayix.pyc Deprecated module which handles network interfaces
/usr/lib/curses.pyc Re-implementation of standard Python 'curses' module
/usr/lib/dis.pyc Standard Python 'dis' module
/usr/lib/getopt.pyc Standard Python 'getopt' module
/usr/lib/getpass.pyc Standard Python 'getpass' module
/usr/lib/grp.pyc Re-implementation of standard Python 'grp' module
/usr/lib/posixpath.pyc Standard Python 'posixpath' module
/usr/lib/pwd.pyc Re-implementation of standard Python 'pwd' module
/usr/lib/py_compile.pyc Standard Python 'py_compile' module
/usr/lib/shutil.pyc Standard Python 'shutil' module
/usr/lib/signal.pyc Re-implementation of standard Python 'signal' module
/usr/lib/termios.pyc Re-implementation of standard Python 'termios' module
/usr/lib/trace.pyc Simple trace module used for debugging
/usr/lib/urlparse.pyc Standard Python 'urlparse' module
/usr/src Full source code
/usr/src/commands Source code for commands in /bin and /sbin
/usr/src/kernel Source code for /boot/kernel
/usr/src/lib Source code for libraries in /usr/lib
/usr/src/lib/ayix Source code for re-implemented modules