Skip to content

Latest commit

Β 

History

History
120 lines (89 loc) Β· 4.44 KB

File metadata and controls

120 lines (89 loc) Β· 4.44 KB

Contributors Forks Stargazers

Zig Logo

A minimal Real-Time Operating System (RTOS) designed for embedded applications with targets for x86_64, RISC-V (RV32I, RV64I) and ARM written in Zig.

Built With

Zig NixOS GitHub Actions

Preview

Video demonstration

Getting Started

Prerequisites

Before attempting to build this project, make sure you have Zig and Nix installed on your machine.

Installation

To get a local copy of the project up and running on your machine, follow these simple steps:

  1. Clone the project repository

    git clone https://github.com/Kaweees/kiwiRTOS.git
    cd kiwiRTOS
  2. Install the project dependencies

    nix-shell --max-jobs $(nproc) # Linux / Windows (WSL)
    nix-shell --max-jobs $(sysctl -n hw.ncpu) # macOS
  3. Run the project

    just run <architecture>

Project Structure

.kiwiRTOS/
β”œβ”€β”€ .github/                       - GitHub Actions CI/CD workflows
β”œβ”€β”€ build.zig                      - Zig build file
β”œβ”€β”€ src/                           - Project packages
β”‚   β”œβ”€β”€ arch/                      - Architecture specific code
β”‚   β”‚   β”œβ”€β”€ x86_64/                  - x86_64 architecture specific code
β”‚   β”‚   β”œβ”€β”€ riscv/                   - RISC-V architecture specific code
β”‚   β”‚   └── arm/                     - ARM architecture specific code
β”‚   β”œβ”€β”€ drivers/                   - Device drivers
β”‚   β”œβ”€β”€ kernel/                    - Kernel code
β”‚   β”œβ”€β”€ lib/                       - Library code
β”‚   └── tests/                     - Project tests
β”œβ”€β”€ LICENSE                        - Project license
└── README.md                      - You are here

License

The source code for this project is distributed under the terms of the GNU General Public License v3.0, as I firmly believe that collaborating on free and open-source software fosters innovations that mutually and equitably beneficial to both collaborators and users alike. See LICENSE for details and more information.