rv1106-system

Spec Phase: rv1106-system is in active development. Documentation reflects current build system design.

rv1106-system provides the Linux system infrastructure for RS-1 devices based on the Rockchip RV1106 processor.

Overview

The RV1106 is an application processor that runs the main hardwareOS firmware. rv1106-system provides:

Buildroot configuration — Reproducible Linux builds
Kernel patches — Hardware-specific modifications
Root filesystem — Minimal system for embedded use
OTA infrastructure — Update partition management

Architecture

┌─────────────────────────────────────────────────┐
│                  Build System                   │
├─────────────────────────────────────────────────┤
│  Buildroot                                      │
│    ├── Toolchain generation                     │
│    ├── Package selection                        │
│    └── Image creation                           │
├─────────────────────────────────────────────────┤
│  Kernel                                         │
│    ├── RV1106 device tree                       │
│    ├── Driver configuration                     │
│    └── Security hardening                       │
├─────────────────────────────────────────────────┤
│  Root Filesystem                                │
│    ├── Minimal base system                      │
│    ├── hardwareOS application                   │
│    └── OTA agent                                │
└─────────────────────────────────────────────────┘

Build System

Prerequisites

# Build dependencies (Ubuntu/Debian)
apt install build-essential git wget cpio unzip rsync bc \
    libncurses-dev python3 python3-pip

# Disk space: ~20GB for full build

Building

cd rv1106-system

# Configure for RS-1
make rs1_defconfig

# Build complete system image
make

# Output: output/images/sdcard.img

Build Outputs

File	Description
`sdcard.img`	Complete bootable image
`rootfs.ext4`	Root filesystem
`uImage`	Linux kernel
`u-boot.bin`	Bootloader

Partition Layout

┌────────────┬────────────┬────────────┬────────────┐
│   Boot     │  RootFS A  │  RootFS B  │   Data     │
│   16MB     │   128MB    │   128MB    │  Remaining │
└────────────┴────────────┴────────────┴────────────┘

Boot — U-Boot and device tree
RootFS A/B — Dual root for A/B updates
Data — Persistent configuration

OTA Updates

rv1106-system supports A/B partition updates:

Download new image to inactive partition
Verify checksum
Update boot flag
Reboot to new partition
Rollback on boot failure

Customization

Adding Packages

Edit configs/rs1_defconfig:

BR2_PACKAGE_MY_PACKAGE=y

Kernel Configuration

make linux-menuconfig
make linux-savedefconfig

Device Tree

Device tree source: board/opticworks/rs1/rs1.dts

Development Workflow

Modify — Edit Buildroot config or add packages
Build — make (incremental builds supported)
Test — Flash to device or run in QEMU
Commit — Version control changes
CI — Automated builds verify changes

Source: rv1106-system/README.md, rv1106-system/docs/BUILD.md