Linux on the Zipit Z2 – Quantum Lime

I’d like to thank Hunter Davis and Aliosa27 who literally did all the work to make this stuff. I’m just reproducing sections of it as a sort of clearer guide, and for my own reference.

This guide is basically hacked together from hunterdavis.com, from the varous coment threads and instructions that have been posted there, the files hosted by aliosa27 which I’ve mirrored here to not waste his bandwidth, and some photos/screenshots that I’ve taken on my own.

About This GuideThis guide is intended to step through the process of putting a barebones debian installation onto the Zipit Z2 Wireless Messenger, and implementing various hacks and drivers to emulate the functionality of a small computer, on what is essentially a toy for tweens.

There are multiple ways to do this, and there are multiple variants which will yield different results. This page is designed specifically to set up Debian, with a disk image on the MiniSD card that will allow both Windows and Linux computers to drop files into what is essentially the “hard drive” of the device.

Once the installation is complete, you may choose to install optional mouse drivers for the directional pad, and a keymap to emulate the functionality of a more complex keyboard. You will also be able to use apt to download packages from the debian repositories. Instructions on how to do so appear underneath the basic install instructions.

I am not a programmer. I am a nerd who likes to tinker with things. While I have gone through these steps myself and have tried to make sure that the steps are accurate and clear, we are still hacking a device to to something it is not intended to do, and I take no responsibility for you bricking your Zipit or encountering an unresolvable issue with the installation process.

The Setup

Using a Windows Computer for preparation.

To begin, you’ll need the following items:

A Windows Computer
A miniSD card or microSD with adapter
A way to connect the SD card to your Windows Computer
A Zipit Z2 Messenger
The Internet!

You’re going to need to download several files:

Either the 1gb or 2gb disk image from sourceforge (Created by Aliosa27)
Aliosa27’s latest oe userland image
Aliosa27’s keymap.map file and z2mouse-option file (Optional: For mouse emulation)
phsydiskwrite Either version, though the GUI version is easier to use.
The autoflasher script
Windows ext2 filesystem driver (If you can’t see fat partition from Windows)

Using a Linux Computer for preparation.

You will need:

Your zipit z2
A linux computer with an internet connection to download files and gparted installed.
A miniSD card, or microSD in a miniSD adapter.

You will need to download these files:

Either the 1gb or 2gb disk image from sourceforge (Created by Aliosa27)
Aliosa27’s latest oe userland image
Aliosa27’s keymap.map file and z2mouse-option file (Optional: For mouse emulation)
The autoflasher script

The Installation

Using a Windows Computer to set up the Zipit

First, flash the zipit. Extract the autoflasher bundle to a fat16 formatted memory card
Open Aliosa27’s wireless+x+audio.tar.gz file, and copy out the /boot/linux-2.6.29 file to your memory card
Rename this file kernel.bin
Boot the zipit with the SD card inserted. If this does not start the linux flash, go to settings->reset to default and it should soft-reset
Some SD cards are reported to not work, or not always be seen by the zipit. Try both with and without the power cable plugged in
The z2 will boot linux and copy the wifi firmware to the sd card before flashing linux to the Z2.
Copy off the 2 wireless firmware files gspsi.bin and gpspsi_helper.bin to a folder, you will copy these back to the memory card after we write the image
IMPORTANT — rename helper_gspi.bin to be gspi8686_hlp.bin or it will not load later!
Extract the 1/2gb image to a folder
Extract phsydiskwrite to a folder
Insert your microSD card into the computer (adapter, usb stick, etc)
Run phsygui.exe from within the folder you extracted psydiskwrite to (requires .net framework)
right-click on the drive letter for your SD card, select the first menu item, and then select the 1/2gb image you extracted earlier (.img)
After it writes, safely remove the disk then plug it back in. if windows can see the fat partition copy the firmware files to it
If windows cannot see this fat partition, dowload the ext2 filesystem driver, run it, then copy the firmware files over to /lib/firmware/notlibertas/ (yes notlibertas, the fat filesystem is mounted as /lib/firmware/libertas so you can’t use that)
Insert the sd card into the Z2, and boot. Login as root, password debian. Congrats! You’ve got debian on the zipit!
If windows couldn’t see your fat32 partition, copy the firmware files from /lib/firmware/notlibertas to /lib/firmware/libertas. You may need to run fsck if linux can’t see the files.
Reboot, and you should have wireless device when you type iwconfig. Configure the wireless settings, and you’re ready.

Using a Linux Computer to set up the Zipit

First, flash the zipit. Extract the autoflasher bundle to a fat16 formatted memory card
Extract Aliosa27’s wireless+x+audio.tar.gz file, and copy out the /boot/linux-2.6.29 file to your memory card
Rename this file kernel.bin
Boot the zipit with the SD card inserted. If this does not start the linux flash, go to settings->reset to default and it should soft-reset
Some SD cards are reported to not work, or not always be seen by the zipit. Try both with and without the power cable plugged in
The z2 will boot linux and copy the wifi firmware to the sd card before flashing linux to the Z2.
Remove the MiniSD card and connect it to your computer.
Copy off the 2 wireless firmware files gspsi.bin and gpspsi_helper.bin to a folder, you will copy these back to the memory card after we write the image
Rename rename helper_gspi.bin to be gspi8686_hlp.bin
Extract either the 1gb or 2gb disk image from sourceforge, you will end up with an .img file.
Write that .img file to the MiniSD with “dd if=/<folder>/<filename>.dd of=/dev/<deviceid>
Copy the two wireless firmware files gspsi.bin and gspi8686_hlp.bin to /lib/firmware/notlibertas
Remove the MiniSD from the computer and insert into the Z2, then boot the Z2, the OpenZipit logo should appear, followed by a login prompt.
Login: root Password: debian
Copy the firmware files gspsi.bin and gspi8686_hlp.bin from /lib/firmware/notlibertas to /lib/firmware/libertas, ane make them excecutable.
Reboot the device and login, wireless should be working, use iwconfig to connect to an access point.

Mouse Emulation

To get the directional pad working as a mouse, you’ll need to download one of the mouse drivers from the files section

z2mouse-option

This driver works with the keymap.map file to make the directional pad act as a mouse, and the upper row of keyboard keys act as function keys when the Options button at the top of the keypad is pressed.

To install:

Download the driver z2mouse-option and the keymap keymap.map to the device
place z2mouse-option in /bin and chmod 777 it.
place keymap.map in /etc, if there is a file there named keymap.map already, back it up before doing this.
edit “~/.fluxbox/startup” and add “/bin/z2mouse-option &” in the startup section
edit “/usr/bin/startfluxbox” and add “/bin/z2mouse-option &” in the startup section
reboot the device and startx, wait until the desktop has loaded fully then hit the option key to toggle the mouse on/off