ntxbuild 0.3.0

NuttX Build System Assistant

ntxbuild

NuttX Build System Assistant - A Python tool for managing and building NuttX RTOS projects with ease.

ntxbuild is simply a wrapper around the many tools available in the NuttX repository. It wraps around tools such as make, kconfig-tweak, menuconfig and most used bash scripts (such as configure.sh).

This tool provides a command line interface that supports NuttX configuration and building, while also providing a Python API that allows you to script your builds.

Features

• Environment Management: Automatic NuttX workspace detection and configuration
• Python API: API ntxbuild available for building NuttX using Python scripts
• Parallel Builds: Support for multi-threaded builds with isolated workspaces
• Real-time Output: Live build progress with proper ANSI escape sequence handling
• Configuration Management: Kconfig integration for easy system configuration
• Build Cleanup: Automated artifact management and cleanup
• Persistent Settings: Environment configuration saved in .ntxenv files
• Interactive Tools: Support for curses-based tools like menuconfig

Requirements

• Python 3.10+
• NuttX source code and applications
• Make and standard build tools required by NuttX RTOS
• CMake supported but optional

Installation

Using pip

As an user, you can install this tool using pip:

pip install ntxbuild

From Source

If you are a developer or simply wants to install from source, you can clone this repository and install using pip install -e <repo>

git clone <repository-url>
cd ntxbuild
pip install -e .

Use the dev configuration to install development tools and docs to install documentation tools.

pip install -e ".[dev]"

pip install -e ".[docs]"

Quick Start

1. Initialize Your NuttX Environment

# Navigate to your NuttX workspace
cd /path/to/your/nuttx-workspace

# Initialize with board and defconfig
ntxbuild start sim nsh

2. Build Your Project

# Build with default settings
ntxbuild build

# Or, build with parallel jobs
ntxbuild build --parallel 8

3. Configure Your System

# Run menuconfig
ntxbuild menuconfig

# Set Kconfig values
ntxbuild kconfig --set-value CONFIG_DEBUG=y
ntxbuild kconfig --set-str CONFIG_APP_NAME="MyApp"

Contributing

Contributions are always welcome but will be subject to review and approval. Basic rules:

• Testing and documentation are mandatory for new features
• Depedencies should be kept to a minimal
• Code linting using pre-commit is mandatory