Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swanx1/alean
ALEAN is an operating system for the Raspberry PI Zero W (BCM2835 chip)
https://github.com/swanx1/alean
bcm2835 firmware kernel os raspberry-pi
Last synced: about 2 months ago
JSON representation
ALEAN is an operating system for the Raspberry PI Zero W (BCM2835 chip)
- Host: GitHub
- URL: https://github.com/swanx1/alean
- Owner: SwanX1
- License: agpl-3.0
- Created: 2022-10-30T22:10:33.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-10T11:35:11.000Z (5 months ago)
- Last Synced: 2024-08-10T12:46:11.436Z (5 months ago)
- Topics: bcm2835, firmware, kernel, os, raspberry-pi
- Language: Rust
- Homepage:
- Size: 1.7 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### ALEAN
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.
### Workspace Setup
1. Install and configure Rustup
```
curl https://sh.rustup.rs -sSf | sh
rustup override set nightly
rustup component add rust-src
```
2. Install xargo
```
cargo install xargo
```
3. Install [Arm GNU Toolchain](https://developer.arm.com/Tools%20and%20Software/GNU%20Toolchain)
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.
4. Clone the repository using Git *(`--recurse-submodules` is important!)*
```
git clone --recurse-submodules --depth 1 https://github.com/SwanX1/alean.git
```
### Compiling
Compile using [`./build.ps1`](./build.ps1) (raw commands are in the [`build`](./build) file)
The compiled files are in the `target` directory.
To use this in a Raspberry PI, just format an SD card with a FAT32 partition (see [Raspberry Pi's documentation](https://www.raspberrypi.com/documentation/computers/getting-started.html#sd-cards)), place everything from [`firmware`](./firmware/) into that partition as well as the `kernel.img` file you've compiled.
It's as easy as pie! *(hehe get it?)*
### License
View [`attribution`](./attribution/) for more information.
### Contact
You may contact me about the project via e-mail: karliscern [at] gmail [dot] com.