Zaurus Python Image

Upgrading

The Python Zaurus Image and the Python Zaurus IPK are a matched set. Upgrading one will generally require upgrading the other. When upgrading, you must always complete the following steps in the order listed:

1. Use the Add/Remove Software utility on the Zaurus to uninstall python-exe.
2. Copy the python24.img or python24.ex2 file to the Zaurus.
3. Use the Add/Remove Software utility on the Zaurus to install the new python-exe package.

See the Installation instructions below for details on performing the last two steps.

1. Install the python24.img or python24.ex2 file. Make sure you put the file in the correct location!
   • If you're using python24.img you must copy it to the root directory of an SD card or to the Zaurus' "Main_Memory" (/home/zaurus/Documents). Note that the file will take up about 9 MiB of space. The file should not be installed to a CF card or hard disk!.
   • If you're using python24.ex2.gz you must first uncompress it (turning it into python24.ex2) then copy the uncompressed file to one of the following locations (note that the file will take up about 48 MiB of space):
     • the root directory of a CF or SD card
     • the Zaurus' "Main_Memory" (/home/zaurus/Documents)
     • the root directory of one of the Zaurus SL-3000 hard disk partitions
2. Copy the python-exe_2.4.0-1_arm.ipk file to any location on your Zaurus that will allow the Add/Remove Software utility to find it (CF or SD card or /home/zaurus/Documents in internal memory).
3. Run the Add/Remove Software utility and use it to install python-exe to internal memory. Don't worry, this is not the complete Python image ... just the 1.2 MiB executable and some scripts. You must install the python-exe package to internal memory -- it will not work from SD or CF!

1. 1. Type CTRL-D (on non-clamshell Zaurus that's Fn-Shift-D) to exit the Python interpreter.

Please follow the instructions above carefully. We've tried hard to make this installation process as simple as possible, but there are still plenty of places to make mistakes.

Python Zaurus Image

Background

The downside of using Python on the Zaurus is that Python 2.3 is big! We're talking 30+ MiB for a relatively complete Python installation. It is possible to chop that up into different packages and install only the minimum necessary (as the excellent [[][Python on Zaurus]] project has done). However, one of Python's greatest strengths is it's rich set of run-time libraries, and most Python developers are not hesitant to use a broad range of Python features. It's almost inevitable that to support a significant interactive Python application, you'll end up with most of the Python packages installed.

To make matters worse, on a Sharp or Sharp-compatible ROM, you need to install Python into internal memory for everything to work properly (or you need to spend a lot of time manually creating symbolic links to a Python tree on a memory card). Sacrificing 30+ MiB of internal memory is tough for SL-C7X0/SL-C860/SL-6000 owners and it's virtually impossible for other less memory endowed Zaurus models.

What I've come up with is a 50 MiB "image" of a relatively complete Zaurus Python installation that you can actually use directly from a memory card (SD or CF)! Through the magic of Linux loop devices, you can trick the Zaurus into thinking the whole thing is installed to internal memory. What's even better is that since this "image" contains a complete Linux ext2 filesystem, you can use it on SD or CF cards that are formatted FAT16 or FAT32. The whole Python tree will appear as just a (large) single file on your memory card.

Installation

You'll need to download two packages from the downloads page - The Python Zaurus Image and the Python Zaurus Executable. Once you have both packages, follow these steps:

1. Gunzip the python23.img.gz file (it's best to do this on your PC) and copy the resulting python23.img file to the root directory of a CF or SD card. Note that the file will take up about 50 MiB of space on your memory card so you'll need at least a 64 MB card for this. Make sure you put python23.img in the card's root directory!
2. Copy the python_exe.ipk file to any location on your Zaurus that will allow the Add/Remove Software utility to find it (CF or SD card or /home/zaurus/Documents).
3. Run the Add/Remove Software utility and use it to install python_exe to internal memory. You must install the python_exe package to internal memory -- it will not work from SD or CF!
4. When the installation is complete, exit the Add/Remove Software program and then use the Reboot application to do a full reboot of your Zaurus.
   • If you wish to avoid the reboot, you can go to a shell prompt (console), log in as root (su), and issue the command /etc/rc.d/init.d/mntpython start
5. Test your Python installation.
   1. Simply run python from a shell prompt and you should get a Python interpreter prompt.
   2. Enter the command print "hello, world!" and you should see the text "hello, world!" printed.
   3. Type CTRL-D to exit the Python interpreter.

How it Works

Coming soon.

-- DavidKessler - 08 Nov 2004