Build and Run Fuzix OS on a Raspberry Pi Pico – Step‑by‑Step Guide

1. Hardware preparation

Raspberry Pi Pico development board

Micro‑USB cable (power and optional serial debugging)

Standard USB cable (used as the serial console when flashing Fuzix)

2. Software preparation

A Ubuntu system (can run in a VM) is required for building.

2.1 Clone required repositories

git clone [email protected]:raspberrypi/pico-sdk.git

git submodule update --init --recursive lib/tinyusb

Or clone tinyusb directly:

git clone [email protected]:raspberrypi/tinyusb.git

git clone https://github.com/davidgiven/FUZIX.git

2.2 Install build tools

Because the required CMake version is newer than the one in the Ubuntu repositories, download and build CMake 3.12 (or 3.13) manually:

$ tar -zxvf cmake-3.12.4.tar.gz
$ cd cmake-3.12.4
$ ./configure
$ make
$ sudo make install

Install the ARM cross‑compiler and other dependencies:

sudo apt-get install gcc-arm-none-eabi
sudo apt-get update -q
sudo apt-get install -y byacc automake
sudo apt-get install -y lwtools gcc6809 sdcc cc65
sudo apt-get install -y m68k-uclinux-binutils m68k-uclinux-elf2flt m68k-uclinux-gcc

3. Build the Fuzix image

Switch to the Pico‑specific branch: git checkout rpipico Edit Kernel/platform-rpipico/Makefile to point to your local pico‑sdk path, e.g.: export PICO_SDK_PATH = /home/book/pico-sdk/ Then compile:

cd Kernel/platform-rpipico
make world -j
./update-flash.sh

4. Flash the board

Hold the BOOTSEL button while plugging the Pico into USB; it appears as a mass‑storage device. Copy the generated fuzix.elf (or the provided flash image) onto the mounted drive; the board will reboot and program the flash automatically.

5. Run and interact with Fuzix

Connect to the Pico’s serial console (e.g., with MobaXterm) at 115200 baud. On first boot you will be prompted to set the date and time.

FUZIX version 0.4pre1
... (boot messages) ...
Current date is Thu 2021-03-11
Enter new date: 2021-03-11
Current time is 11:34:54
Enter new time: 15:05:00

Log in as root (no password) and you can explore the filesystem:

# cd usr
# ls
games  lib  man
# cd games
# ls
advent  cowsay  lib
# ./cowsay Fuzix
 _______
< Fuzix >
 -------
        \   ^__^
         \  (oo)\_______
            (__)       )\/\
                ||----w |
                ||     ||

Other commands are available under /bin.

6. Optional extensions

You can add an SD‑card filesystem to the system; see the linked article for details:

https://shumeipai.nxez.com/2021/03/03/how-to-get-started-with-fuzix-on-raspberry-pi-pico.html