Bare-metal firmware development, simplified.¶

A CLI-first build workflow for Ambiq SoCs — scaffold, build, flash, and stream live output in five commands.

Quick Links¶

Features What is NSX? How it Works Module Catalog Create First App Examples

Features at a Glance¶

5-command lifecycle

Create, configure, build, flash, and live-view from one CLI.
Registry-backed modules

Declarative dependencies with versioned module resolution.
Board-ready targets

Built-in Apollo3, Apollo4, Apollo5, and Apollo510 board coverage.
Standard CMake output

Generated projects stay transparent and fully editable.
Perf and power tooling

PMU profiling, cycle counters, and Joulescope workflows included.
Maintained example apps

Ready-to-run examples for USB, audio, CoreMark, and more.

What is NSX?¶

NSX is a CLI-first firmware workflow for Ambiq SoCs that keeps app projects simple, reproducible, and easy to inspect.

It focuses on source-controlled configuration, reusable modules, and generated vanilla CMake projects so teams can move quickly without hidden build tooling.

How it Works¶

Five commands cover the full firmware lifecycle.

NSX workflow

nsx create-app my_app --board apollo510_evb
nsx configure  --app-dir my_app
nsx build      --app-dir my_app
nsx flash      --app-dir my_app   # J-Link / SWD
nsx view       --app-dir my_app   # live SWO stream

Every generated project is vanilla CMake — inspect, extend, or eject with no vendor lock-in.

Module Ecosystem¶

Declare dependencies in YAML. NSX resolves versioned modules and wires them into your build.

Module ecosystem

Modules are plain Git repos with an nsx-module.yaml descriptor. Adding one is a pull request, not a toolchain project.

Where to Start¶

New to NSX?

Install the toolchain, create your first app, and build it in minutes.

Getting Started →
Deep Dive

App model, module resolution, board definitions, and build workflows.

User Guide →
CLI Reference

Flags, options, and usage for every nsx subcommand.

Commands →
Browse Examples

CoreMark, PMU profiling, power benchmarking, USB serial, and more.

Examples →