GENADEV/GENADEV_OS

An AArch64 hobbyist OS for the Raspberry Pi 3 B+

CGPL-3.0

GENADEV_OS

An AArch64 hobbyist OS for the Raspberry Pi 3 B+ made with ❤️ by the German Low-Level discord server community written in C and AArch64 Assembly

Screenshots

Emulation on Linux

Packages you need
- Debian based linux distributions:
  - git
  - qemu-system-arm
  - make
  - libncurses5
  - astyle
- Arch based linux distributions:
  - git
  - qemu
  - qemu-arch-extra
  - make
  - ncurses
  - astyle
To run it
- git clone https://github.com/GENADEV/GENADEV_OS.git --recursive
- cd GENADEV_OS
- make setup (untar the cross compiler)
- make run (compile, link and run)
- By default make run will use the uart0 for debugging output, you can change this to use the mini uart aswell via make run_uart1
- Important:
  - We have recently discovered that qemu segfaults when using the framebuffer, this is qemu bug and issues regarding this will be closed.
  - In order to see the display you need to follow these instructions:
```
# In this example we will use vinagre as a VNC client but you can use any software you wish
sudo apt install vinagre # This command may vary based on your distro
make run # GENADEV_OS will start executing
vinagre :5901 # Start the VNC client
# A GUI window should have opened, now click `connect`, enter 127.0.0.1:1 as the host and connect. You should now see the the screen of GENADEV_OS
```

Contributing

For those interested in contributing, please refer to the contributing guidelines.