Releases: Nan0berry-Development-Team/Nan0berryOS
Release list
-- (FATAL ERROR) STABLE V1.1
WARNING! THIS NOT GONNA BOOT, I REVIEWED ALL ERRORS IN LTS BUILD, SEE:
THIS NOT GONNA BOOT
WARNING
--- v1.1
--- STABLE RELEASE -- THIS STABLE RELEASE IS UNSTABLE, LOL
--- tested on Raspberry PI Pico RP2040 - THIS GONNA NOT BOOT
--- 10/08/2026 at 16:35. -- ERRORS
THIS IS WITH MULTIPLE FATAL ERRORS, SEE THE NEW LTS BUILD THAT WE REVISED ALL
---------------------
@Nan0berryOS
----------------------
🍓 Nan0berryOS v1.1 (STABLE)
Nan0berryOS is an ultra-lightweight, preemptive Real-Time Operating System (RTOS) custom-designed for the Raspberry Pi Pico (RP2040 / ARM Cortex-M0+) microcontroller.
Developed to provide a fast, predictable, and self-contained execution environment, it integrates a multitasking kernel with power management, a RAM-based file system (VFS), Mutex synchronization primitives, and a full interactive CLI Shell via USB/Serial.
🚀 Release Highlights (v1.1-STABLE)
- SysTick-based Preemptive Kernel: Efficient multitasking scheduling driven by ARM Cortex-M0+ timer interrupts.
- Command Line Interface (CLI Shell): Interactive terminal accessible directly via the Pico's USB Serial port (115200 baud).
- Virtual File System (VFS): RAM-based file system for fast runtime storage of configuration files.
- Safe Mutex Synchronization: Primitives to prevent race conditions when accessing critical resources.
- Power Management: Intelligent Idle task using the
WFI(Wait For Interrupt) instruction for low CPU power consumption. - Ready-to-Use: Pre-compiled, optimized
.uf2binary file included in the release.
🛠️ Available Shell Commands
Upon connecting your serial terminal to Nan0berryOS, you have access to the following native system commands:
| Command | Description |
|---|---|
help |
Displays the list of all commands and usage help. |
version |
Displays the Kernel version and build details. |
tasks |
Lists active RTOS tasks, priorities, and CPU states. |
ls |
Lists the files contained in the Virtual Storage (VFS). |
cat <file> |
Displays the contents of a file saved in VFS memory. |
sysinfo |
Shows the current CPU clock frequency and hardware status. |
clear |
Clears the serial terminal. |
📦 How to Install on Raspberry Pi Pico
You do not need to compile the source code! Simply use the pre-compiled binary available in the Assets section of this release:
- Download the
Nan0berryOS.uf2file attached to this release. - Hold down the BOOTSEL button on your Raspberry Pi Pico and connect it to your computer via a USB cable.
- The board will mount on your computer as a USB storage device named RPI-RP2.
- Drag and drop the
Nan0berryOS.uf2file onto the board's drive. - The board will automatically reboot and start running Nan0berryOS.
💻 How to Access the Terminal (CLI)
- Open your preferred serial terminal program (VS Code Serial Monitor, PuTTY, Tera Term, minicom, or picocom).
- Select the COM / USB Serial port corresponding to your Raspberry Pi Pico.
- Set the connection speed to 115200 Baud.
- Press the Enter key.
- The system prompt will appear, and you are ready to interact:
Nan0berryOS>
LTS v2.3.2 -- COLD WATERMELON
🚀 Nan0berryOS LTS v2.3.2 -- COLD WATERMELON
We are proud to release Nan0berryOS LTS v2.3.2, a robust, minimalist Real-Time Operating System (RTOS) built from scratch specifically for the Raspberry Pi Pico (RP2040).
🌟 What's New & Core Features
- Low-Level Preemptive Kernel: Custom context-switching implemented via ARM Cortex-M0+
PendSV_Handlerin Assembly, ensuring safe register preservation (R4-R7) and stack alignment[cite: 3, 4, 5]. - Persistent Flash File System (
nano_fs): Integrated non-volatile storage mapping directly to SPI Flash, allowing files to persist across reboots with built-in sector erasure protection and interrupt masking. - Interactive CLI Shell: Built-in serial command-line interface (
nano_cli_process) supporting real-time file management commands (ls,cat,write) over USB CDC[cite: 1, 2]. - Concurrency & Synchronization: Includes cooperative yielding mechanisms, priority-based task scheduling, and atomic mutex primitives for safe resource sharing[cite: 1, 3].
📦 Installation & Usage
- Clone the repository into your workspace.
- Ensure you have the Raspberry Pi Pico SDK configured (
PICO_SDK_PATH). - Build the project using CMake and Ninja:
mkdir build && cd build cmake .. make