Printable Version of Topic

Click here to view this topic in its original format

OESF Portables Forum _ Zaurus - Void Linux support _ Void Install Guide

Posted by: greguu May 5 2018, 03:42 AM

This is a reference guide on how to install Void Linux (armv5tel-musl) on a Sharp Zaurus (C3x00) device.
Please use at your own risk.

Note: C1000 (Akita) is not officially supported, but instructions for Akita are nearly identical. Please use the "Frankenstein" kexecboot kernel and ext3 as rootfs for Akita

01. Install kexecboot kernel

A kexecboot kernel is required to boot Void Linux on your Zaurus. If you do not have already a kexecboot kernel installed, get one from the sources below and follow the instructions.

C3x00 : (Kexecboot 4.14.18 Voidz)
C3x00 : (Kexecboot 3.10 ALARMZ)
C1000 :

1. Extract the tar.gz file to a FAT formatted SD or CF card (SD recommended)
    2. Remove battery and power adapter cable
    3. Wait for a few seconds
    4. Replace battery, close and lock the battery cover
    5. Attach power cable
    6. Push the OK button while pressing on/off switch
    7. The device will enter a menu (Japanese)
    8. From the menu options choose option "4" (Update), next "2" (SD) and confirm "Y"
    8. The device will reboot an present you with a boot-menu

02. Get the root file system

Note: The rootfs is updated regularly and very much experimental at this stage. Each build will feature a build number, eg Build-002. Please use always the latest build available for a fresh install.


Changes (build7) :
- Linux Kernel 4.19.0 - All packages build with GCC 8.2.0
To install the Void Linux rootfs, please follow the instructions below:

02.1. Format a SD memory card with f2fs or ext4 - make sure to set the correct device

mkfs.f2fs /dev/sdx1
    mkfs.ext4 /dev/sdc1 -O^metadata_csum
    mkfs.ext4 /dev/mmcblk0p1 -O^metadata_csum

Note: If using e2fsprogs version >=1.43.9 you will need to exclude the metadata checksum feature upon creation as shown above otherwise the kexecboot kernel will fail to mount it. Keeping the feature enabled (default with newer e2fsprogs) will likely slow things down on the Zaurus.

02.2. Extract the downloaded rootfs tar.xz onto the SD card using the tar command, umount and boot the SD card on the Zaurus.

mount /dev/sdx1 /mnt
    cd mnt
    tar xf /root/void-somelongnameanddate.tar.xz

02.3. Logon as root (default password is "voidlinux") and change root password via the "passwd" command.


4. Edit /etc/rc.conf and adjust your timezone. (vi or nano)

nano /etc/rc.conf

Note: Leave HOSTNAME and HARDWARECLOCK commented out.

5. Enable dropbear (sshd), udhcpc, ntpd and alsa

ln -s /etc/sv/busybox-ntpd /var/service
    ln -s /etc/sv/busybox-udhcpc /var/service
    ln -s /etc/sv/dropbear /var/service
    ln -s /etc/sv/alsa /var/service

Note: This should bring up ethernet (CF or USB) via dhcp automatically and set the correct time as well as enable ssh listening on port 22 as default.

6. Enable WiFi

Make sure the CF or USB WiFi device is connected.

If you have a prism based card, it may be required to blacklist the orinoco_cs module fist. Reboot or "rmmod" the orinoco modules.

echo "blacklist orinoco_cs" > /etc/modprobe.d/blacklist.conf

Then setup you WiFi connection. The example is for WPA enabled networks:

ip link show
    ip link set up <device_name>
    wpa_passphrase <MYSSID> <key> >> /etc/wpa_supplicant/wpa_supplicant-<device_name>.conf
    iwconfig <device_name> mode managed
    wpa_supplicant -B -i <device_name> -c /etc/wpa_supplicant/wpa_supplicant-<device_name>.conf -Dwext
    udhcpc -i <device_name>

Note: An automated WiFi setup on boot can be achieved by using wpa_actiond. This needs to be documented and tested. The above commands were confirmed working with prism based CF card DLINK DWL-660W on WPA2 enabled networks. (Firmware 1.8.2)

7. Set up audio (alsa)

To enable sound output, unmute the headphone or speaker channels via alsamixer and store the settings afterwards. Play a sound file to test.

    alsactl store
    aplay toptune.ogg

8. Set up the package feed

Note: This is an experimental feed that contains packages for build7. If you installed a previous rootfs, you can upgrade to build7 using xbps-install!

echo 'repository=' > /etc/xbps.d/00-repository-main.conf
    xbps-install -Su

9. Start using Void.

Note: Void for Zaurus (voidz) is very basic at this stage does not feature any graphical desktop.


Posted by: Varti Jun 29 2018, 06:03 AM

As pointed out by the user C1000 on IRC, the following link is now broken:

C3x00 : Download (Kexecboot 4.14.18 Voidz)


Posted by: greguu Jun 29 2018, 05:54 PM

Thanks, this has been fixed.



Posted by: greguu Feb 18 2019, 02:18 AM

FYI: RootFS and package feed have been updated to build8.

Posted by: greguu May 15 2019, 10:32 PM

The void linux wiki homepage has changed:

Posted by: Varti May 15 2019, 11:40 PM

QUOTE(greguu @ May 16 2019, 08:32 AM) *
The void linux wiki homepage has changed:

Google still lists the old wiki pages on, but the domain has been taken over by another person, unrelated to the Void project. The new seems to be a generic promotional blog for Linux in spanish...

Too bad they have not put the old forum back online, there used to be some useful information there, now it seems they have moved to Reddit.


Powered by Invision Power Board (
© Invision Power Services (