robco-industries / pip-os

Personal Information Processor Operating System

Pip OS

This is the repository for the Operating System used in Pip-Boy products. It contains the kernel, an humble implementation of libc, and a tiny user-space environment.

ROM

A ROM is a packaged version of the OS with pre-configured user applications. You will need a ROM for a fully functional OS (in order to get a terminal access at startup for example). ROM developers are responsible of including binaries of this project next to their package when they release their product to the public.

Deitrix

The official ROM developed by Robco Industries is Deitrix, and can be found in our repositories. It's a separated repository to permit people to develop custom environments by themselves. For more informations about Deitrix, please refer to its repository : https://github.com/RobCo-Industries/Deitrix

Supported hardware

The kernel is compatible with the following Broadcom boards, as they share the same underlying architecture :

• BCM2835
• BCM2836
• BCM2837

The model BCM2711 should be supported in the future.

Building from sources

Requirements

• An ARM toolchain compatible to your machine (GNU ARM)
• An emulator to test the OS (we use QEMU)

cd build 
export BCM=2837 # Build for Raspberry Pi 3 board

make clean
make
make run # Requires QEMU installed on your machine

References

• Peripheral manual for BCM2835 ARM chip (useful to get Memory Mapped IO addresses BCM2835 ARM Peripherals

• Circle - A C++ bare metal environment for Raspberry Pi by rsta2 https://github.com/rsta2/circle

• Raspberry Pi 3 tutorial by bztsrc https://github.com/bztsrc/raspi3-tutorial

• Raspberry Pi test environment by mrvn https://github.com/mrvn/test

• Bare metal Raspberry Pi 2 by Rohansi https://github.com/Rohansi/RaspberryPi

• Building an OS for Raspberry Pi by jsandler18 https://jsandler18.github.io/

• OSDev's Raspberry Pi Bare Bones https://wiki.osdev.org/Raspberry_Pi_Bare_Bones

• Learning OS development using Linux kernel and Raspberry Pi by s-matyukevich https://github.com/s-matyukevich/raspberry-pi-os