Synaptics ASTRA MCU SDK Logo
Astra_MCU_SDK_v1.4.0
  • Getting Started
    • Getting Started
      • Step 1: Obtain the SDK
      • Step 2: Install SDK Tools (VS Code or CLI)
      • Step 3: Build and Flash
        • SR110
        • SL2610 (Requires Linux)
      • Step 4: Learn More
      • Step 5: Explore SDK Applications
    • Driver User Guide
  • Astra MCU SDK Application User Guide
    • Overview
      • Table of Contents
      • Overview
      • Example Organization
        • Example Structure
        • Configuration Files (defconfigs)
      • Prerequisites
        • Required Tools
        • Environment Variables
      • Directory Structure
      • Build System Architecture
        • Two-Stage Build Process
        • Build Modes
        • SDK Package Options
        • Key Features
      • Building Examples
        • Understanding Build Modes
        • Quick Commands
        • Menuconfig and Custom Defconfigs
        • Using Different Compilers
        • Exported or Separate Application Repository
    • SR110 User Guide
      • Sample Demo Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Optional Configuration
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
      • Person Classification ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
      • Person Detection ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
        • Adapting Pipeline for Custom Object Detection Models
      • Person Segmentation ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
      • Person Pose Detection ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
      • Hand Gesture Detection ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Hardware Requirements
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
        • Supported Hand Gestures
      • Face Identification + Hand Gesture Detection ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
        • Supported Hand Gestures
      • Doorbell ML Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • CLI build outputs
        • Running the Application using VS Code Extension
        • Adapting Pipeline for Custom Object Detection Models
        • Use Case Specific Details
      • Bluetooth Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • Memory Configuration (Important)
        • Logger Interface Configuration
        • Wiring
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • GATT Read/Write Check
        • Expected Logs
      • AUDIO MIC Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • CLI build outputs
      • Clock Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • DMA Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • FATFS Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Expected Logs
      • GPIO Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • I2C Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Connections
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • Pinmux Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • SDIO Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • SPI Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • Mode Configuration (Important)
        • Logger Interface Configuration
        • Wiring
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • UART Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • UART Connections (UART Bridge)
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • WiFi Driver Sample Application
        • Description
        • Supported Boards
        • Hardware Requirements
        • Prerequisites
        • Test Case Selection
        • Wiring
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Expected Logs
      • XSPI Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • Inference Basic Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • Inference Basic Flash Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • Inference Multi-Model Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Optional Configuration
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
      • USB CDC Camera Sensor TX Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
        • Features of Python Script
      • USB CDC Echo Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Features of Python Script
      • USB CDC Image Downloader Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Expected Logs
        • Features of Python Script
      • USB CDC RX Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Features of Python Script
      • USB CDC TX Counter Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Functionality
      • USB CDC TX Sample App
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
        • Features
    • SR2610 User Guide
      • DMA Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • I2C Expander Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • I2S Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • NAND Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Logger Interface Configuration
        • Connections
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • SPWM Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • Watchdog Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • XSPI Driver Sample Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code
        • Building and Flashing the Example using CLI
        • Running the Application using VS Code Extension
      • System Manager Application
        • Description
        • Supported Boards
        • Prerequisites
        • Test Case Selection
        • Building and Flashing the Example using VS Code and CLI
        • Running the Application using VS Code Extension
  • Astra MCU SDK Developer Guide
    • Developer Guide
      • Install Guide - Setup and Install SDK using CLI
        • Table of Contents
        • Prerequisites
        • Get the SDK
        • Install the toolchain (choose one)
        • Install Python tools (for image generation and tooling)
        • Linux USB/serial permissions (recommended)
        • Set required environment variables
        • Verify the environment
        • Next: Build an example
      • Install Guide - Setup and Install SDK using VS Code
        • Table of Contents
        • Prerequisites
        • Get the SDK
        • Install the Synaptics VS Code Extension
        • Install Tools
        • Linux USB/serial permissions (recommended)
        • Import Application/Example and Set SRSDK_DIR
        • Build and Flash (VS Code)
        • Troubleshooting Tips
      • Build and Flash - SR110 with VS Code
        • Table of Contents
        • Prerequisites
        • Build and Deploy Flow
        • Environment Setup
        • Build Configurations (SR110)
        • Image Conversion (SR110)
        • Image Flashing (SR110)
        • Debugging (SR110)
        • Running Examples
        • USB CDC Image Streaming (Windows)
      • Build and Flash - SR110 with CLI
        • Table of Contents
        • Prerequisites
        • CLI Flow (Build + Image Conversion + Flash)
        • Running Examples
      • Build and Flash - SL2610 with CLI
        • Table of Contents
        • Prerequisites
        • CLI Flow (Build + Image Generation + Flash)
        • WSL USB Flashing Flow (usbipd)
        • Notes
      • Build and Flash - SL2610 with VS Code
        • Table of Contents
        • Prerequisites
        • Build and Deploy Flow
        • Environment Setup
        • Build Configurations (SL2610)
        • Image Generation (SL2610)
        • Image Flashing (SL2610)
        • Debugging (SL2610)
        • Running Examples
      • Astra MCU SDK Reference
        • Table of Contents
        • Scope and Audience
        • Supported Platforms and Boards
        • Host Requirements
        • Environment Setup
        • SDK Repository Layout
        • Project Structure and Module Organization
        • Build System Overview
        • CMake Build Details
        • Configuration Model (Kconfig)
        • Build Workflows
        • Build Outputs and Artifacts
        • Image Generation
        • Flashing
        • Where to Run Commands
        • Debugging
        • Applications (Modify or Create)
        • Command Reference
        • Troubleshooting
        • Related References
      • Astra MCU SDK - VS Code Extension User Guide
        • Table of Contents
        • Supported SoCs
        • Prerequisites
        • Install the Synaptics VS Code Extension
        • Install Tools
        • Linux USB/serial permissions (recommended)
        • Standalone Image Flashing (No SDK Import Required)
        • Import SDK and Project
        • Imported Projects
        • Logger
        • Memory Analyzer
        • Debugging UI
        • Video Streamer
        • Register Info Data Base
      • Astra MCU SDK - WSL User Guide
        • Overview
        • Requirements
        • Setup Steps
        • USB/Serial Device Access (WSL)
        • Next Steps
      • Astra MCU SDK Docker Guide
        • Prerequisites
        • Build the Docker image
        • Run the container
        • Build examples (inside the container)
        • SR110 image generation (inside the container)
        • SL2610 image generation (inside the container)
        • Copy outputs to the host
        • Flashing and debugging
  • Subject-Specific Guides
    • Syna Tool Kit Guide
      • Astra MCU SDK Syna Tool Kit User Guide
      • 1.0 Installation
        • 1. Use SynaTool Kit from Release package: <Astra MCU SDK>/tools/
        • 2. Run SynaToolkit installer and follow the instructions:
      • 2.0 Menu Bar
        • 2.1 Main
        • 2.2 Logger Tabs
        • 2.3 Records
        • 2.4 Tools
        • 2.5 Plugins
        • 2.6 Help
      • 3.0 Logger Functionality
        • 3.1 Logger Connect/Disconnect
        • 3.2 Log NameSpaces
        • 3.3 Levels
        • 3.4 Main Log Window
      • 4.0 SynaTool Commands Menu
        • 4.1 ROM
        • 4.2 FW
    • SR110 MIPI Sensor Integration Guide
      • Astra MCU SDK MIPI Sensor Integration Guide
        • Introduction
        • SR110 Capability
        • Sensor Capability
        • Sensor Integration
        • SW Flow
  • Astra Machina Micro Eval Platforms
    • SR110 Evaluation Platform
      • Astra Machina Micro SR100 Series Evaluation Platform Kit RevC
        • Introduction
        • Scope
        • Definition of Board Components
        • Astra Machina Micro Evaluation Platform Overview
      • Astra Machina Board Control/Status & System I/O
        • Bootup Mode
        • LEDs
        • Hardware Manual Button Settings
        • Hardware Manual Slide Switch Settings
        • Hardware Jumper Settings
        • SR110 Machina Micro Platform Connectors
        • Stuffing Options for SR110 Machina Micro Platform Power Measurement
      • Daughter Cards
        • Debug Board
        • Onboard Debug and Programming Interface via Debug IC, SR100 (SWD + UART)
        • M.2 Card
        • Camera Module
        • General Purpose 20-pin Header
        • Pin Demuxing for Standard Interface Configuration
        • GPIO Expanders Over I2C
        • I2C Bus
      • Bringing Up the SR100 Series Evaluation Platform
        • Connecting External Components and Performing Hardware Testing
      • References
  • Astra MCU SDK API Guide
    • Astra MCU SDK API Guide
  • Astra MCU SDK Release Notes
    • SDK Release Notes for SDK 1.1.0
      • Introduction
      • General
      • Supported Peripherals
      • Supported Software Components
      • Supported Power Modes
      • VS Code Extension
      • SynaToolkit Suite
      • Reference Applications
      • Sample Applications
      • Supported Sensors and Configuration
      • Supported Flash List
      • Known Issues
      • Revision History
    • SDK Release Notes for SDK 1.2.0
      • Introduction
      • General
      • Supported Peripherals
      • Supported Software Components
      • Supported Power Modes
      • VS Code Extension
      • SynaToolkit Suite
      • Reference Applications
      • Sample Applications
      • Supported Sensors and Configuration
      • Supported Flash List
      • Known Issues
      • Revision History
    • SDK Release Notes for SDK 1.3.0
      • Introduction
      • General
      • Supported Peripherals
      • Supported Software Components
      • Supported Power Modes
      • VS Code Extension
      • Reference Applications
      • Sample Applications
      • Supported Sensors and Configuration
      • Supported Flash List
      • Known Issues
      • Revision History
    • SDK Release Notes for SDK 1.4.0
      • Introduction
      • General
      • Supported Peripherals
      • Supported Software Components
      • Supported Power Modes
      • VS Code Extension
      • Reference Applications
      • Sample Applications
      • Supported Sensors and Configuration
      • Supported Flash List
      • Known Issues
      • Revision History
Synaptics ASTRA MCU SDK
  • Build Environment Setup
  • View page source

This document covers the development version of this software, which may differ significantly from previous releases. For older versions, use the version selector in the bottom left corner.

Build Environment Setup

This section provides detailed instructions for setting up the Astra MCU SDK build environment across different operating systems and compilers.

Select your platform and compiler combination:

Linux Environment

  • Setup Guide for Development Environment on Linux for Arm Compiler
  • Setup Guide for Development Environment on Linux for GCC
  • Setup Guide for Development Environment on Linux for LLVM/Clang

macOS Environment

  • Setup Guide for Development Environment on macOS (Apple Silicon + Intel) for GCC
  • Setup Guide for Development Environment on macOS (Apple Silicon + Intel) for LLVM/Clang
  • Setup Guide for Development Environment on MAC x86_64 for GCC
  • Setup Guide for Development Environment on MAC Arm64 for GCC

Windows Environment

  • Setup Guide for Development Environment for Arm Compiler on Windows
  • Setup Guide for Development Environment for GCC on Windows
  • Setup Guide for Development Environment for LLVM/Clang on Windows

© Copyright 2023 - 2026, Synaptics.

Built with Sphinx using a theme provided by Read the Docs.
Synaptics ASTRA MCU SDK main
Versions
main
v1.1.0
v1.2.0
v1.3.0
v1.4.0 (latest)