ALEAN is an operating system for the Raspberry Pi Zero W (BCM2835 chip)

Since this is written for the BCM2835 chip, it should work on Raspberry Pi 1 Models A, A+, B, B+, the Raspberry Pi Zero, the Raspberry Pi Zero W, and the Raspberry Pi Compute Module 1.

1. Install and configure Rustup

   curl https://sh.rustup.rs -sSf | sh
   rustup override set nightly
   rustup component add rust-src
   

2. Install Arm GNU Toolchain Add the installation path to your PATH environment variable. The installer adds it to the user's path, but put it in the system's path, because some programs might not find it.

3. Clone this repository using Git (--recurse-submodules is important!)

   git clone --recurse-submodules --depth 1 https://github.com/SwanX1/alean.git
   

   • Note: If you've cloned this repository without --recurse-submodules, you can run the following git commands to clone the firmware directory as well.

   git submodule init
   git submodule update --depth=1
   

Compile using ./build.sh The files needed on the SD card are in the build directory.

Note: If you're doing active development, run the script with a --no-release flag, which doesn't optimize the binary (along with Rust's STD).

To use this in a Raspberry PI, just format an SD card with a FAT32 partition (see Raspberry Pi's documentation), place everything from build into that partition. All files necessary for booting are also automatically copied into the build directory.

To use this in QEMU - additionally to the setup before, follow the following steps.

1. Install QEMU This installation varies for different operating systems, so follow QEMU's installation instructions, and make sure to install a "full system emulation" package, if provided. It should install a qemu-system-arm command.
2. Run using the following command

   qemu-system-arm -machine raspi0 -cpu arm1176 -m 512 -kernel ./target/kernel.elf -nographic
   

   Note: CTRL+C (SIGINT) gets passed to the emulated machine. You can terminate QEMU using CTRL+A X

It's as easy as pie! (hehe get it?)

View attribution for more information.

You may contact me about the project via e-mail: karliscern [at] gmail [dot] com.