Ashet Operating System

A tiny cross-platform operating system, focused on hackability.

Supported platforms are:

• Linux/x86 "Hosted Simulation" (wip)
• RISC-V (wip)
• x86 (wip)
• Arm M-Profile (wip)

The OS is designed to run primarily on 32 bit hardware with "low" memory (measured in 10s of MB). It can obviously also use more memory if available, but it doesn't require more than 16 MB to run stable and fully usable.

Platforms

The following list contains devices for which there is a planned port of Ashet OS.

RISC-V

• ✅ QEMU virt
• ⌛ Ox64
• ⌛ Ashet Home Computer

x86

• ✅ Linux (Yes, you can actually run the OS as an application!)
• ✅ Generic PC platform (486 and newer)
• ⌛ QEMU microvm

Arm

• ✅ Ashet Virtual Home Computer (Custom QEMU Board, Cortex-M33)
• ☠️ [QEMU virt](https://www.qemu.org/docs/master/system/riscv/virt.html, Cortex-A7)
• ⌛ Ashet Home Computer
• ⌛ RaspberryPi 400
• ⌛ RaspberryPi 3 B+

Project Goals

• Portability (Support at least two platforms)
  • qemu virt platform
  • Ashet Home Computer
• Cooperative multitasking
• Desktop OS
  • Open several window-based applications
  • Play games

Planned Applications

Applications

• Media Player (Grammophone)
• Ashet Commander (Shepard)
• Chat (Telegraph)
  • IRC
• Browser (Gateway)
  • Gemini
  • HTTP
  • Gopher
• Hyperlink Document Viewer + Editor (Hyper Wiki)
  • Interactive help
  • Notes / Notebook
• Terminal (Connex)
  • Console Services
  • Serial Ports
  • Netcat/TCP Monitor
• Code Editor (Craftworks)
• Paint (Dragon Craft)
• Direct I/O Access (I/O)
• System Management + Update (SysAdvance)
• Lola Scripting Env (LoLa Run!)
• Dungeon Crawler Game (Dungeon)
• Spreadsheet Software (Calc)

Daemons

• Psi Compiler (Psi)
• LoLa Compiler (LoLa)
• Asm Compiler (Asm)
• Shell Service (Shell)

Contributing

Compiling The Project

The results of the compilation are usually disk images, except for a machine based on the hosted machine.

Compile everything

[user@host] $ zig build
[user@host] $ 

Compile for a single machine

[user@host] $ zig build <machine-name>
[user@host] $ 

Useful Links

• Free & Open RISC-V Reference Card
• Application Binary Interface for the Arm® Architecture1
  • ELF for the Arm® Architecture
  • Procedure Call Standard for the Arm® Architecture
• Arm® Cortex®-M33 Processor Technical Reference Manual
• A Practical guide to ARM Cortex-M Exception Handling
• musl dyynamic linker
• x86 and amd64 instruction reference
• GCC Documentation
  • How to Use Inline Assembly Language in C Code
• Zig
  • Zig 0.13 Language Reference
  • Zig 0.13 StandarD Library Documentation
• QEMU Documentation
• RP2350
  • RP2350 Datasheet
  • W25Q128JV Datasheet
• Arm® v8-M Architecture Reference Manual