Nexus Embedded Platform¶
Note
Language / 语言: Use the language switcher in the sidebar to change language.
New to Nexus? Start with Quick Start or see Documentation Guide for navigation help.
Welcome to the Nexus Embedded Platform documentation. Nexus is a world-class embedded software development platform designed for building reliable, secure, and portable embedded applications.
Documentation
Getting Started
User Guide
- User Guide
- Architecture
- Hardware Abstraction Layer (HAL)
- OS Abstraction Layer (OSAL)
- Log Framework
- Shell Framework
- Config Manager
- Kconfig Configuration System
- Kconfig Tutorial
- Peripheral Configuration Guide
- Platform-Specific Configuration Guide
- OSAL Backend Configuration Guide
- Kconfig Tools Reference
- Build System
- Overview
- Quick Start
- CMake Presets
- Build Script
- Testing
- CMake Structure
- Build Options
- Building the Project
- Cross-Compilation
- Configuration System
- Build Directory Structure
- Advanced Build Features
- Code Coverage
- Continuous Integration
- Best Practices
- IDE Integration
- Troubleshooting
- Summary
- See Also
- Troubleshooting
- See Also
- IDE Integration
- Porting Guide
Tutorials
- Tutorials
- Your First Nexus Application
- GPIO Control Tutorial
- UART Communication Tutorial
- Multi-Tasking with OSAL
- 中断处理教程
- 定时器和 PWM 教程
- SPI 通信教程
- I2C Sensor Integration
- ADC Sampling and Signal Processing
- Example Applications
- Learning Path
- Prerequisites
- Learning Stages
- Additional Resources
- Example Applications
- Getting Help
- Next Steps
- Your First Nexus Application
- Learning Objectives
- Prerequisites
- Step 1: Create Project Structure
- Step 2: Add Nexus as Dependency
- Step 3: Create CMakeLists.txt
- Step 4: Write Your First Application
- Step 5: Build for Native Platform (Testing)
- Step 6: Build for STM32F4
- Step 7: Flash to Hardware
- Step 8: Verify Operation
- Understanding HAL Initialization
- GPIO Configuration Options
- Common Issues and Solutions
- Next Steps
- Additional Exercises
- Best Practices
- Resources
- GPIO Control Tutorial
- UART Communication Tutorial
- Multi-Tasking with OSAL
- 中断处理教程
- 定时器和 PWM 教程
- SPI 通信教程
- Example Applications
Platform Guides
API Reference
Development
- Development Guide
- Contributing
- Development Environment
- Coding Standards
- Architecture Design
- API Design Guidelines
- Testing
- Code Review Guidelines
- Build System
- Porting Guide
- Kconfig Writing Guide
- Build Scripts and Tools
- Debugging Guide
- CI/CD Integration
- Coverage Analysis Workflow
- Static Analysis
- Performance Optimization
- Security Guidelines
- Validation Framework
- Script Validation System
- Contributing to Documentation
- Release Process
- Troubleshooting
- Overview
- Quick Links
- Development Principles
- Development Workflow
- Code Quality Standards
- Tools and Resources
- Getting Help
- Contributing
- Community Guidelines
- Next Steps
- See Also
- Contributing
- Coding Standards
- Testing
- Kconfig Writing Guide
- Build Scripts and Tools
- Validation Framework
- Script Validation System
- CI/CD Integration
- Coverage Analysis Workflow
- Contributing to Documentation
Key Features¶
🔧 Hardware Abstraction Layer (HAL)¶
Unified API for GPIO, UART, SPI, I2C, Timer, ADC with factory pattern and lifecycle management.
⚙️ OS Abstraction Layer (OSAL)¶
Portable RTOS interface supporting FreeRTOS, RT-Thread, Zephyr, and bare-metal.
📝 Log Framework¶
Flexible logging with multiple backends, async mode, module filtering, and color output.
🖥️ Shell Framework¶
Interactive command-line interface with command registration, history, and auto-completion.
⚙️ Configuration System¶
Powerful Kconfig-based configuration with validation, migration, and runtime access.
🏗️ Build System¶
CMake-based build system with cross-platform support, toolchain management, and testing.
🔒 Security & Safety¶
Secure boot and firmware updates
TLS 1.3 and crypto engine
MISRA C compliance
MPU protection and runtime checks
☁️ Cloud Integration¶
Ready-to-use integrations for AWS IoT, Azure IoT, and Alibaba Cloud IoT.
🤖 AI/ML Support¶
TensorFlow Lite Micro and CMSIS-NN for edge AI applications.
Quick Start¶
Get started in 5 minutes:
# Clone repository
git clone https://github.com/X-Gen-Lab/nexus.git
cd nexus
# Build for native platform
python scripts/building/build.py
# Run example
./build/applications/blinky/blinky
Supported Platforms¶
Native - Windows, Linux, macOS (simulation)
STM32 - F4, H7 series
GD32 - GD32F4, GD32F3 series
ESP32 - ESP32, ESP32-S3 (coming soon)
nRF52 - nRF52832, nRF52840 (coming soon)
Learning Path¶
- New Users (Week 1)
Quick Start - Build first example
First Application - Create your app
GPIO Control Tutorial - First tutorial
- Application Developers (Week 2-4)
Hardware Abstraction Layer (HAL) - Hardware peripherals
OS Abstraction Layer (OSAL) - Task management
Tutorials - Complete tutorials
- Advanced Users (Week 5+)
Kconfig Configuration System - Advanced configuration
Porting Guide - Port to new hardware
Contributing - Contribute code
Community & Support¶
📖 Documentation: You’re reading it!
💬 Discussions: GitHub Discussions
🐛 Issues: GitHub Issues
📝 Changelog: CHANGELOG.md
🤝 Contributing: Contributing
Indices and Tables¶
Index - General index
Module Index - Module index
Search Page - Search documentation