MicroZig Embedded Development Framework

Sorcerer is a suite of tools designed for visualizing and generating MicroZig register definitions. It supports multiple formats including SVD, ATDF, Embassy, and TargetDB via regz. It consists of two main components:

1. Sorcerer (GUI): A graphical application for browsing, editing, and searching register definitions, viewing generated Zig code, and managing patch files.
2. sorcerer-cli: A lightweight command-line tool for generating register code without GUI dependencies.

Both tools use embedded Zig compile-time constants for schemas, meaning they do not require runtime file loading or JSON parsing.

The virtual-io module provides a Zig implementation of an I/O interface that simulates a file system entirely in RAM. It is useful for testing or environments where disk access is unavailable or undesirable.

Key Behaviors:

• RAM-backed storage: All I/O operations that would normally touch a physical disk are redirected to RAM, managed via a hash map.
• Directory structure: It maintains a simulated directory structure and file contents in memory.
• Strict isolation: Any I/O operation that is not explicitly handled by the virtual implementation will fail, ensuring no accidental disk access occurs.

The raspberrypi-rp2xxx Board Support Package (BSP) provides examples categorized by chip compatibility and hardware requirements:

• Chip Agnostic: Demos that run on both RP2040 (Pico 1) and RP2350 (Pico 2) without code changes (e.g., blinky, watchdog timer, usb device).
• RP2040 Only: Demos utilizing peripherals or HAL functionality not yet ported to the RP2350 (e.g., adc, i2c bus scan, pwm, spi host).
• CYW43 (Wireless): Specific examples for the Pico W and Pico2 W boards. Because wireless boards drive the LED via the CYW43 chip rather than direct GPIO, these require different implementation logic.

Note: All demos compatible with the standard Pico are also compatible with the RP2040-Plus without modification.

regz is a Zig code generator designed for microcontrollers. It converts vendor-provided register description files—such as ARM's System View Description (SVD) or AVR's ATDF—into a single Zig file. This generated file allows you to interact with hardware registers using a type-safe, structured API in Zig.

const regs = @import("nrf52.zig").registers;

pub fn main() void {
    regs.P0.PIN_CNF[17].modify(.{
        .DIR = 1,
        .INPUT = 1,
        .PULL = 0,
        .DRIVE = 0,
        .SENSE = 0,
    });
    regs.P0.OUT.modify(.{ .PIN17 = 1 });
}

MicroZig provides Hardware Abstraction Layer (HAL) and register definitions for the NXP MCX series microcontrollers.

Supported Hardware:

• Currently, only the MCXA153 is supported.

Source of Truth: Register definitions are derived from the official NXP MCUXpresso SVD files located at: https://github.com/nxp-mcuxpresso/mcux-soc-svd/.