Author Topic: Void Install Guide  (Read 3724 times)

greguu

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 393
    • View Profile
    • http://github.com/greguu
Void Install Guide
« on: May 05, 2018, 07:42:55 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 :  Download (Kexecboot 4.14.18 Voidz)
C3x00 : Download (Kexecboot 3.10 ALARMZ)
C1000 : Download

Code: [Select]
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.  

Cxx00: Download

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

Code: [Select]
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.

Code: [Select]
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.


Code: [Select]
passwd4. Edit /etc/rc.conf and adjust your timezone. (vi or nano)

Code: [Select]
nano /etc/rc.confNote: Leave HOSTNAME and HARDWARECLOCK commented out.

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

Code: [Select]
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.

Code: [Select]
echo "blacklist orinoco_cs" > /etc/modprobe.d/blacklist.conf
Then setup you WiFi connection. The example is for WPA enabled networks:

Code: [Select]
ip link show
    ip link set up
    wpa_passphrase >> /etc/wpa_supplicant/wpa_supplicant-.conf
    iwconfig mode managed
    wpa_supplicant -B -i -c /etc/wpa_supplicant/wpa_supplicant-.conf -Dwext
    udhcpc -i
    ping google.com

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.

Code: [Select]
alsamixer
    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!

Code: [Select]
echo 'repository=https://www.oesf.org/repository/feeds/voidlinux/testing/build8' > /etc/xbps.d/00-repository-main.conf
    xbps-install -Su

9. Start using Void.

https://wiki.voidlinux.eu/

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

THIS GUIDE IS WORK IN PROGRESS AND NOT COMPLETE. ANY ISSUES OR QUESTIONS RELATED TO VOID INSTALLATION, PLEASE POST BELOW. THANKS.
« Last Edit: February 18, 2019, 05:18:06 am by greguu »
Gemini-PDA (Stock Android) / LG Nexus 5 (Sailfish OS) / Nokia N9 (MeeGo/Harmattan)
Sharp Zaurus C3100 (Borzoi) - Void Linux (voidz) Kernel 5.0.0 - Hardware (Buffalo CF LAN, DLink 660 CF WiFi, ASIX AX88772 USB Ethernet)

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #1 on: June 29, 2018, 10:03:57 am »
As pointed out by the user C1000 on IRC, the following link is now broken:

C3x00 : Download (Kexecboot 4.14.18 Voidz)
https://github.com/greguu/voidz-packages/re...execboot.tar.xz

Varti
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!

greguu

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 393
    • View Profile
    • http://github.com/greguu
« Last Edit: May 16, 2019, 02:39:03 am by greguu »
Gemini-PDA (Stock Android) / LG Nexus 5 (Sailfish OS) / Nokia N9 (MeeGo/Harmattan)
Sharp Zaurus C3100 (Borzoi) - Void Linux (voidz) Kernel 5.0.0 - Hardware (Buffalo CF LAN, DLink 660 CF WiFi, ASIX AX88772 USB Ethernet)

greguu

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 393
    • View Profile
    • http://github.com/greguu
Void Install Guide
« Reply #3 on: February 18, 2019, 05:18:44 am »
FYI: RootFS and package feed have been updated to build8.
Gemini-PDA (Stock Android) / LG Nexus 5 (Sailfish OS) / Nokia N9 (MeeGo/Harmattan)
Sharp Zaurus C3100 (Borzoi) - Void Linux (voidz) Kernel 5.0.0 - Hardware (Buffalo CF LAN, DLink 660 CF WiFi, ASIX AX88772 USB Ethernet)

greguu

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 393
    • View Profile
    • http://github.com/greguu
Void Install Guide
« Reply #4 on: May 16, 2019, 02:32:28 am »
The void linux wiki homepage has changed:

https://wiki.voidlinux.org/Main_Page
Gemini-PDA (Stock Android) / LG Nexus 5 (Sailfish OS) / Nokia N9 (MeeGo/Harmattan)
Sharp Zaurus C3100 (Borzoi) - Void Linux (voidz) Kernel 5.0.0 - Hardware (Buffalo CF LAN, DLink 660 CF WiFi, ASIX AX88772 USB Ethernet)

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #5 on: May 16, 2019, 03:40:59 am »
Quote from: greguu
The void linux wiki homepage has changed:

https://wiki.voidlinux.org/Main_Page
Google still lists the old wiki pages on voidlinux.eu, but the domain has been taken over by another person, unrelated to the Void project. The new voidlinux.eu 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.

Varti
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!

cain2pang

  • Newbie
  • *
  • Posts: 24
    • View Profile
Void Install Guide
« Reply #6 on: February 29, 2020, 09:44:32 am »
The Kexecboot 4.14.18 Voidz doesn't work on my C3100, while the Kexecboot 3.10 ALARMZ works well.
« Last Edit: February 29, 2020, 09:48:13 am by cain2pang »
Sharp Zaurus C3100 (Borzoi) running Arch Linux ARM.
GPD MicroPC running Manjaro XFCE.

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #7 on: March 01, 2020, 11:09:15 am »
Quote from: cain2pang
The Kexecboot 4.14.18 Voidz doesn't work on my C3100, while the Kexecboot 3.10 ALARMZ works well.
Is it showing any error, or does it fail to find the OS? Both kexecs work without problems on my C1000.

Varti
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!

greguu

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 393
    • View Profile
    • http://github.com/greguu
Void Install Guide
« Reply #8 on: March 17, 2020, 03:12:44 am »
Quote from: Varti
Quote from: cain2pang
The Kexecboot 4.14.18 Voidz doesn't work on my C3100, while the Kexecboot 3.10 ALARMZ works well.
Is it showing any error, or does it fail to find the OS? Both kexecs work without problems on my C1000.

Varti

cain2pang, the 4.14.18 voidz kexecboot kernel size is very very close to the max memory limit for the stock kernel size. does your zaurus have any bad blocks in flash ? Otherwise I can not explain it, it works fine on my C3100.
The 3.10 kernel is much smaller and does not occupy that much space.
Gemini-PDA (Stock Android) / LG Nexus 5 (Sailfish OS) / Nokia N9 (MeeGo/Harmattan)
Sharp Zaurus C3100 (Borzoi) - Void Linux (voidz) Kernel 5.0.0 - Hardware (Buffalo CF LAN, DLink 660 CF WiFi, ASIX AX88772 USB Ethernet)

MaBo

  • Newbie
  • *
  • Posts: 19
    • View Profile
Void Install Guide
« Reply #9 on: May 13, 2020, 02:28:44 pm »
Hi all,

Tried to install void, but hit some problems. I followed the instructions above quite accurately. There are two downloads, I chose void-armv5tel-musl-ROOTFS-20190214.tar.xz from https://github.com/greguu/voidz-packages/re...s/tag/build-008

All looks fine.

Kexecboot gives me now two options in addition to the ones I had:
Void linux
Void linux - debugging

Selecting the Void linux one.

Four lines starting with F2FS-fs: can't find valid F2FS filesystem
kernel panic - not syncing.

Then pcmcia, scsi, ata are found.

sda: sda1 sda2 sda3
sd 0:0:0:0: [sda1] attached SCSI disk

<long wait>
then a line appears:
random: crg init done

Further no progress.

Any suggestions?

Kind regards,
Maarten

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #10 on: May 14, 2020, 04:43:58 am »
First things that comes to mind - is the SD card formatted as f2fs or ext4? The "Can't find f2fs" error suggests that you're using an ext4 one, if so, has it been created without the metadata checksum (the -O^metadata_csum parameter)?

Varti
« Last Edit: May 14, 2020, 04:44:12 am by Varti »
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!

MaBo

  • Newbie
  • *
  • Posts: 19
    • View Profile
Void Install Guide
« Reply #11 on: May 14, 2020, 02:00:10 pm »
Thanks for the quick reply,

Quote from: Varti
is the SD card formatted as f2fs or ext4? The "Can't find f2fs" error suggests that you're using an ext4 one
Correct, I made it an ext4 partition

Quote from: Varti
is the SD card formatted as f2fs or ext4? The "Can't find f2fs" error suggests that you're using an ext4 one, if so, has it been created without the metadata checksum (the -O^metadata_csum parameter)?
Yes, I used that parameter with the mkfs.ext4 command. Any way to check it?

I tried both build007 and build008 with same behaviour.

When the system seems to hang, it still responds to the enter key, and suspend also does something: Freezing user space processes.

hmmm... what could be wrong.

But the Zaurus remains a lovely little device ;-)
Maarten

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #12 on: May 15, 2020, 11:37:37 am »
I understood now. You need to change the boot parameters of both VoidLinux and VoidLinux-Debug on the SD card, the file is /boot/boot.cfg, from
Code: [Select]
rootfstype=f2fsto
Code: [Select]
rootfstype=ext4
Varti
« Last Edit: May 15, 2020, 11:37:57 am by Varti »
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!

MaBo

  • Newbie
  • *
  • Posts: 19
    • View Profile
Void Install Guide
« Reply #13 on: May 15, 2020, 01:39:59 pm »
Quote from: Varti
I understood now. You need to change the boot parameters of both VoidLinux and VoidLinux-Debug on the SD card, the file is /boot/boot.cfg, from
Code: [Select]
rootfstype=f2fsto
Code: [Select]
rootfstype=ext4
Varti
that did it! Thanks!

I'm online now. setting up the feed etc

Maarten

Varti

  • Administrator
  • Hero Member
  • *****
  • Posts: 1085
    • View Profile
Void Install Guide
« Reply #14 on: May 16, 2020, 06:39:36 am »
Great! Please let us know any interesting use you'll find for your Zaurus

Varti
Planet Gemini PDA WiFi/LTE with Mediatek x27
SL-C1000 running Arch Linux ARM May2017, K30225 Wi-Fi CF Card, 64GB SDXC card
and many other Zauruses!