nor-split-layout: kernel and rootfs in one partition on the GK7205V200 family

[widgetii]

A new page for the split NOR layout on GK7205V200, GK7205V300, GK7202V300 and GK7605V100. It's the user side of OpenIPC/linux#96, OpenIPC/u-boot#18 and #19, OpenIPC/firmware#2617 and #2621, and OpenIPC/defib#154.

The page covers:

• the layout, and how the kernel's mtdsplit divides firmware at boot;
• what it needs: the u-boot-<soc>-nor.bin bootloader and the -split package;
• how to tell which layout a camera is on;
• moving a camera over: the bootloader first, then sysupgrade -k -r;
• how sysupgrade carries the settings across, what -n does, and what it refuses;
• writing firmware.bin from U-Boot, and going back to fixed slots.

It's linked from the README (next to NAND flash layouts), install-goke.md and sysupgrade.md.

The console lines quoted come from the lab GK7205V200 and GK7205V300.

Caveats:

• The -split packages appear in latest with the first nightly after #2621. Until then they're local builds only.
• openipc.org install support isn't done yet, so the page doesn't mention it.

[qodo-free-for-open-source-projects]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can see how risky a PR is at a glance with blast radius labels

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

[qodo-free-for-open-source-projects]

PR Summary by Qodo

Document split NOR layout and migration for the GK7205V200 family

📝 Documentation 🕐 20-40 Minutes

AI Description

• Explain the split NOR layout, supported SoCs, required bootloader, and firmware packages.
• Document migration, settings preservation, recovery, and returning to fixed slots.
• Link the guide from installation, upgrade, and wiki navigation pages.

Diagram

graph TD
  Fixed["Fixed-slot camera"] --> Boot["NOR U-Boot"] --> Upgrade["sysupgrade -k -r"] --> Firmware[("Firmware partition")] --> Split["Kernel mtdsplit"] --> Parts["Kernel and rootfs"] --> Settings["Settings restored"]
  Upgrade -. "stages overlay" .-> Settings

Loading

High-Level Assessment

A dedicated guide linked from existing installation and upgrade pages keeps the migration procedure and its safety caveats together. Duplicating those steps across the existing pages would make them harder to keep consistent.

Files changed (4) +174 / -0

Documentation (4) +174 / -0

README.mdAdd split NOR layout to wiki navigation +1/-0

Add split NOR layout to wiki navigation

• Adds a link to the new guide alongside the NAND flash layout documentation.

README.md

install-goke.mdPoint Goke installation readers to the split layout +4/-0

Point Goke installation readers to the split layout

• Introduces the shared kernel-and-rootfs layout and identifies the required NOR bootloader.

en/install-goke.md

nor-split-layout.mdDocument split NOR layout, migration, and recovery +163/-0

Document split NOR layout, migration, and recovery

• Explains partition discovery, supported hardware, bootloader and package requirements, and how to identify the active layout. Provides migration and U-Boot flashing steps, settings-preservation behavior, upgrade safeguards, and a route back to fixed slots.

en/nor-split-layout.md

sysupgrade.mdClarify split-layout upgrades and fixed-slot offsets +6/-0

Clarify split-layout upgrades and fixed-slot offsets

• Links supported Goke users to the new guide and notes that the existing U-Boot offsets apply to fixed-slot images.

en/sysupgrade.md