Welcome to Atmosic OpenAir Documentation

Select SDK Version: OpenAir 26.04.0 OpenAir 25.11.0 OpenAir 25.07.0

SDK Release Documentation

OpenAir Latest SDK Release

Current Release: Latest development version

Key Features:

• Latest features and improvements

• Most up-to-date documentation

• Root-level documentation sources

• Recommended for new projects

🚀 Getting Started

Quick start guide for new users

Getting Started Guide

📖 Introduction

Overview of the Atmosic OpenAir SDK

Introduction

📁 SDK Directory & EVK

SDK structure and evaluation kit information

Atmosic SDK Directory and EVK

🔧 Advanced Build & Flash

Advanced building and flashing techniques

Advanced Build and Flash

🐛 Debugging

Debugging tools and techniques

Debugging

🔄 DFU Update

Device Firmware Update procedures

DFU Update

❓ FAQ

Frequently asked questions

FAQ

💾 Flash Split XIP

Flash partitioning and XIP configuration

Flash XIP with Split Images

📌 GPIO Pin Assignment

GPIO configuration and pin assignments

GPIO Pin Assignment

💻 IDE Support

Integrated development environment setup

IDE

⚡ Low Power Design

Power optimization and energy harvesting

Low Power Design and Energy Harvesting

🗂️ Partition Layout

Memory partition configuration

Partition Layout

🔌 Peripheral Devices

Peripheral device drivers and usage

Peripheral Devices

💡 Samples

Code samples and examples

Samples

🔐 SPE/NSPE

Secure and non-secure processing environments

SPE/NSPE Architecture and Advanced Build Options

🛠️ Tools

Development tools and utilities

Tools

OpenAir 26.04.0 - Latest Release

Release Date: April 2026

Key Features:

• Zephyr 4.3.0 kernel

• MCUBoot swap with offset support added as default

• Coin Cell Battery Management (CCBM) driver added

• Google FindHub Spec updates and bug fixes

• Samsung SmartThings upgraded to TagSDK 2.6.0

• Brownout enabled by default and uses hibernation instead of SoC Off

• Watchdog support enabled for deep sleep modes

• Recommended for new projects

Getting Started

• Introduction
• Getting Started Guide
  • Installation
    • Option 1 Follow The Official Zephyr Documentation (macOS, Linux)
      • Creating a Workspace
    • Option 2 Using Atmosic OpenAir Utility (Linux, Windows)
      • Install Prerequisites
      • Download
      • Install Atmosic OpenAir SDK toolchain
  • OpenAir Utility (atmoautil)
    • Commands
      • Basic
      • Manager
• Atmosic SDK Directory and EVK
  • Atmosic SDK Directory
    • openair
  • Atmosic EVK

Development Guide

• Advanced Build and Flash
  • West Build and Flash
    • Building and Flashing
      • A. Non-MCUboot Option
      • B. MCUboot Option
  • Sysbuild and Flash
    • Overview
    • Building with Sysbuild
    • Flashing with Sysbuild
    • Subpages
      • Atmosic Sysbuild Options
        • Table of Contents
        • Basic Structure
        • Common Configuration Options
          • Sysbuild Options
          • Harness Configuration
        • Atmosic-Specific Configurations
          • SPE (Secure Processing Environment)
          • BLE Stack Options
          • Common Extra Configs
          • DTS Extra CPP Flags
        • MCUboot Configurations
          • Basic MCUboot Setup
          • MCUboot Modes
          • Swap with Offset (Default)
          • Swap with Scratch (Legacy)
          • Overwrite Only
          • Signature Types
        • TrustZone Configurations
          • With TrustZone
          • MCUboot without TrustZone (Default)
        • DFU and OTA Configurations
          • Bluetooth OTA
          • Serial DFU
          • Combined BT OTA + Serial DFU
        • Channel Sounding (CS) Configurations
          • Basic Channel Sounding
        • XIP (Execute-in-Place) Configurations
          • Flash XIP
          • Flash XIP with Overwrite
        • ATM Archive Generation
          • Enable ATM Archive Generation
          • ATM Archive with Erase Options
          • Storage Erase (Default)
        • Complete Examples
          • Example 1: Basic Application without MCUboot
          • Example 2: MCUboot with OTA Support
          • Example 3: Multi-Configuration Sample
          • Example 4: ATM Archive Generation
        • Building with Sample.yaml
          • Using Test Items
          • Manual Configuration
          • Building ATM Archive Files
          • Automatic Generation with Sysbuild
  • Configuration Options
    • MCUboot and Secure Boot
      • Overview
      • Building and Using MCUboot
      • MCUboot RRAM Partitioning
      • MCUboot Boot Flow
      • Update Overwrite
      • Secure Boot
        • Key Generation
          • Generating Public & Private Key
          • Public Key
        • Key Configuration
        • Image Signing
        • Image Verification
        • Image Format
          • Image Header
          • TLV (Type-Length-Value)
          • Image Trailer
        • Anti-Rollback
        • Reducing Latency During Hibernate Boot
        • Building with Custom Keys
          • Building MCUboot
          • Building the Application
          • Building with Sysbuild
    • Secure Debug
      • Introduction
        • Supported Hardware and Software
      • Hardware Overview
        • Debug Security Levels
          • Debug Enabled
          • Debug Secured
          • Debug Disabled
      • Software Overview
        • Configuration
          • Compiling in the Public Key
        • Usage
        • Authentication Protocol
          • Authentication Commands
• SPE/NSPE Architecture and Advanced Build Options
  • Overview
  • SPE/NSPE Architecture
  • Board Variants
  • Building SPE/NSPE Applications
    • Sysbuild
      • Building
      • Flashing
    • Manual Build
      • Build Commands for SPE and NSPE
      • Flash Commands for SPE and NSPE
  • NSC API Development Guidelines
• Atmosic BLE Stack
  • PD50
  • CPD200 for ATM34/e
  • CPD200 for ATM33/e
  • Platform support for different BLE Stack variations
    • ATM34/e
    • ATM33/e
• GPIO Pin Assignment
• Partition Layout
  • Overview
  • Standard Layout Example
  • Flash XIP with Split Images Layout Examples
    • Flash XIP with Split Images and MCUboot Configuration
    • Flash XIP with Split Images without MCUboot Configuration
  • MCUboot Swap Mechanisms
    • Swap-with-Offset (Default)
    • Legacy Swap-with-Scratch
    • Overwrite Only Mode
  • GLOSSARY
  • Storage and Factory Data
    • Atmosic Settings Subsystem (ATM_SETTINGS)
      • ATM_SETTINGS Configuration
      • ATM_SETTINGS Initialization
      • ATM_SETTINGS Factory Data Write Protection
      • ATM_SETTINGS Sample
• Peripheral Devices
  • Atmosic PWM FIFO Mode
    • Overview
    • Key Features
    • Architecture
    • Configuration
    • Device Tree
    • Usage Examples
      • Basic Ringtone Generation
      • DMA Mode Operation
    • Limitations
    • Performance Considerations
    • Troubleshooting
      • Common Issues
      • Debug Tips
• DFU Update
  • MCUmgr DFU/OTA
    • Overview
    • Usage
      • Basic Configuration
      • BLE DFU Security
    • Serial DFU
      • UART Configuration
      • Using mcumgr CLI
      • Performing DFU
    • Building for DFU
• Samples
  • Bluetooth: atm_beacon
    • Overview
      • Button Functionality
      • LED Indication
    • Requirements
    • Building and Running
    • Configuration
      • Beacon Profile Selection
      • Advertising Parameters
      • Hardware Requirements
      • WURX Beacon Configuration
      • Energy Harvesting Configuration
    • Testing
  • ATM BLE Central and Peripheral Sample
    • Overview
    • Applications Included
    • Building and Running
      • Default Mode
      • Periodic Advertising Mode
    • Features
      • Default Mode
      • Periodic Advertising Mode
    • Expected Behavior
      • Default Mode
      • Periodic Advertising Mode
    • Build Options
    • Configurable Options
    • Console Output
      • Default Mode
  • Bluetooth: beacon
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: broadcaster
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: broadcaster_multiple
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: Central HR
    • Overview
    • Requirements
    • Building and Running
    • Testing notes
  • Bluetooth: Central Multilink
    • Overview
    • Requirements
    • Building and Running
    • Configuration
  • Bluetooth: DTM 2-wire
    • Overview
    • Requirements
    • Building and Running
    • Configuration
    • Connection to the Tester
    • Testing
    • Compatibility
    • Troubleshooting
  • Bluetooth: extended_adv_advertiser
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: extended_adv_scanner
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: hci_uart
    • Overview
    • Requirements
    • Default UART settings
    • Building and Running
  • Bluetooth: hci_vendor
    • Overview
    • Requirements
    • Default UART(UART0) Settings
    • Building and Running
    • Debug log(UART1)
  • Bluetooth: High Duty Cycle Directed Advertising
    • Overview
    • Building and Running
      • Sample Output
  • Bluetooth: observer
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
    • Output Format
    • Configuration Options
      • Extended Advertising Support
      • RSSI Filtering
      • Scan Parameters
    • Testing
    • Troubleshooting
    • Related Samples
  • Bluetooth: periodic advertising
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: periodic_adv_conn
    • Overview
    • Key Features
    • Requirements
    • Building and Running
    • Sample Output
    • Configuration Parameters
      • Subevent Configuration
      • Response Slot Configuration
      • Periodic Advertising Parameters
    • Protocol Flow
    • Testing
    • Console Output Analysis
    • Troubleshooting
    • Advanced Configuration
    • Related Samples
  • Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • PAwR Parameters
      • Bluetooth Configuration
      • Device Capacity
    • Testing
      • Expected Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: Periodic Sync
    • Overview
    • Requirements
    • Building and Running
    • Testing notes
  • Bluetooth: Periodic Advertising Connection Procedure (Responder)
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • Sync Parameters
      • Subevent Selection
      • Response Parameters
      • Response Data Format
      • Bluetooth Configuration
    • Testing
      • Expected Behavior
      • Connection Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • GATT Service
      • Bluetooth Configuration
      • PAST Parameters
      • Response Mechanism
    • Testing
      • Multiple Devices
      • Expected Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: peripheral
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: peripheral_accept_list
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: Peripheral DIS
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: Peripheral HR
    • Overview
    • Requirements
    • Building and Running
    • Testing notes
  • Bluetooth: Peripheral Identity
    • Overview
    • Requirements
    • Building and Running
    • Configuration
  • Bluetooth: Scan & Advertise
    • Overview
    • Requirements
    • Building and Running
    • Optional variant
  • Drivers: i2s_output
    • Overview
    • Requirements
    • Building and Running
  • Drivers: uart_passthrough
    • Overview
    • Requirements
    • Building and Running
  • Basic: Hello World
    • Overview
    • Requirements
    • Building and Running
  • Basic: Minimal
    • Overview
    • Requirements
    • Building and Running
    • Configuration
  • Basic: NSC Hello World
    • Overview
    • Building and Running
      • Sample Output
  • Basic: spe
    • Overview
    • Secure Fault Storage
    • Requirements
    • Configuring the Memory Protection Controller (MPC)
      • Defining a Partition as Secure
      • Subpartitions using fixed-subpartitions
    • Build and Run
      • Increasing the Size of the SPE
    • MCUBOOT Usage
    • Note on TF-M
  • Sensor: adt7420
    • Overview
    • Requirements
    • Building and Running
  • Sensor: bme280
    • Overview
    • Requirements
    • Building and Running
    • Configuration
  • Sensor: lis2dh
    • Overview
    • Requirements
    • Building and Running
    • References
  • Subsys: mgmt_mcumgr_smp_svr
    • Overview
    • Requirements
    • Building and Running
  • Subsys: settings
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
  • Sysbuild: hello_world
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
• Atmosic Applications
  • Channel Sounding: Initiator with Ranging Requester
    • Overview
    • Requirements
    • Configuration Options
      • Bluetooth Transmit Power Control
      • RSSI Reading Support
      • BLE PHY Mode Selection
    • Building and Running
  • Channel Sounding: Reflector with Ranging Responder
    • Overview
    • Requirements
    • Building and Running
  • Multimode Consumer Tag
    • Overview
    • Requirements
    • Device State Transitions
    • Buttons and user actions (Summary)
      • FMNA (Apple Find My Network Accessory)
      • FHN (Google Find Hub Network)
      • STF (Samsung SmartThings Find)
      • OTA (Over-The-Air Update)
    • Build items (targets)
      • 1) Default triple-mode (FMNA + FHN + STF)
      • 2) Google only (FHN)
      • 3) Apple only (FMNA)
      • 4) Samsung only (STF, minimal)
      • 5) Dual-mode: Google + Apple
      • 6) Dual-mode: Samsung + Apple
      • 7) Dual-mode: Samsung + Google
      • 8) Triple-mode with MCUboot + OTA over BLE
      • 9) Google only (FHN) with MCUboot + OTA
      • 10) Apple only (FMNA) with MCUboot + UARP
      • 11) Samsung only (STF, minimal) with MCUboot + Native Firmware Update Only
      • 12) Samsung only (STF) with MCUboot + OTA
      • 13) Dual-mode: Google + Apple with MCUboot + OTA
      • 14) Dual-mode: Samsung + Apple with MCUboot + OTA
      • 15) Dual-mode: Samsung + Google with MCUboot + OTA
      • 16) ATM34: MCUboot + Flash XIP (triple-mode) with OTA
      • 17) ATM34: MCUboot + Flash XIP (overwrite-only) with OTA
      • 18) Google only (FHN) with Channel Sounding
      • 19) Dual-mode (Google + Apple) with Channel Sounding
      • 20) Google only (FHN) with Channel Sounding and MCUboot + OTA
      • 21) Dual-mode (Google + Apple) with Channel Sounding and MCUboot + OTA
      • 22) Google only (FHN) with Ranging OOB Data Element (Precision Finding)
    • Storage Size Configuration
    • Google Find Hub Network (FHN) details
      • Adoption and approval
      • Model ID and Anti-Spoofing key
      • Secure Journal support
      • Pairing and provisioning procedure
      • Precision Finding (FHPF) with Ranging OOB Data Elements
        • Supported Ranging Technologies
        • Configuration for Precision Finding
        • Usage with Google Find My Device App
    • Apple Find My Network Accessory (FMNA) details
      • ADK Integration Guide
        • Option1 (recommended)
        • Option2
      • Device Manufacturer Settings
      • FMNA Configuration Settings
        • Custom Bluetooth Device Address
        • FMNA Accessory Information
        • FMNA Firmware Version
    • Samsung SmartThings Find (STF) details
      • SmartThings Find Device SDK integration
      • Build integration notes
      • Flashing
      • Additional Notes
  • Sensor Beacon Application
    • Overview
    • Using with Atmosic DevTools App
      • Monitoring Sensor Data
    • Features
    • Architecture
    • Configuration
    • Beacon Advertising Intervals
    • Sensor Data Format
    • Beacon Advertisement Structure
    • AT Command Interface
      • Prerequisites
      • GATT Service
      • Security — Unlock Mechanism
      • Supported AT Commands
        • Command Syntax
        • Command Reference
          • AT+UNLOCK
          • AT+NAME
          • AT+ADVINT
          • AT+ADVDATA
          • AT+SYSRESET
      • Persistent Storage
      • Typical Usage Sequence
    • Building and Running
      • Production Build (Default)
      • Production Build with MCUboot + Serial DFU
      • Debug Build
      • Programming
      • Configuration Differences
    • Testing
    • Power Management
    • LED and Button Functionality
      • LED Indications
      • Button Functionality
        • Tag Designs (Button Power Control Enabled)
        • EVK Boards (Immediate Beaconing Mode)
    • Supported Boards
      • ATM34 Platforms
      • ATM33 Platforms
    • Compatibility
    • Dependencies
  • ATM BLE Throughput Central Test Application
    • Overview
    • Features
    • Hardware Requirements
      • UART Configuration
    • Building and Running
      • Standard Build
      • Two-Device Auto-Test Build
      • MCUboot + Flash XIP Build
      • MCUboot + Flash XIP Overwrite-Only Build
      • Flash Command
    • Configuration
      • Kconfig Options
    • Custom Shell Commands
      • start_test
      • ack <on|off>
      • set_phy <1M|2M|CODED_S2|CODED_S8>
      • set_conn_interval <interval>
      • set_payload_size <size>
      • show_payload_size
      • set_packet_count <count>
      • show_packet_count
      • set_tx_power <power> (Atmosic Vendor Command)
      • show_tx_power
      • show_tx_power_info
      • set_test_direction <direction>
      • show_test_direction
    • Usage
      • Test Procedure
  • ATM BLE Throughput Peripheral Test Application
    • Overview
    • Features
    • Building and Running
      • Standard Build
      • Two-Device Auto-Test Build
      • MCUboot + Flash XIP Build
      • MCUboot + Flash XIP Overwrite-Only Build
      • Flash Command
    • Usage
      • Test Procedure
    • Connection Events
      • Connection Establishment
      • Parameter Updates
      • Disconnection
  • ATMBTCSTAG-IOT-3405 Applications
    • Supported MIKROE CLICK Boards
      • Weather Click (bme280)
        • Overview
        • Requirements
        • Building and Running
        • References
      • USB UART Click
        • Overview
        • Building and Running
      • PIR Click
        • Overview
        • Requirements
        • Building and Running
        • Sample Output
        • References
      • Buzz 2 Click
        • Overview
        • Requirements
        • Power Supply Selection
        • Building and Running
        • Sample Output
        • Customization
        • API Reference
        • References
• Flash XIP with Split Images
  • Overview
  • External Flash
  • Configuration
    • Device Tree
    • Linker Settings
    • MCUBOOT Configuration
      • Single Split Application
      • SPE with Split NSPE
      • Sizing Partitions
    • Sizing the Image 0 Fast Code Partition
    • Sizing the Image 1 Code partition
  • Building
  • Flashing
  • Version Dependencies
    • Matching Version Criteria
• Low Power Design and Energy Harvesting
  • Power Management Unit
    • PMU Functionality
  • Energy Harvesting and Charging
    • Internal Harvester Only
      • PV Harvesting
      • RF Harvesting
      • PV and RF Combined Harvesting
      • VSTORE Storage Device Considerations
    • External Charging Booster Only
      • External Booster with Diodes
      • External Booster with Inductor
    • Combined Internal Harvesting and External Booster
      • VBATLI Charging Path from VSTORE for Combined Harvesting
      • Cold Start for Combined Harvesting
  • Energy Harvesting Meter
    • How It Works
    • Activation
    • Limitations
  • Batteryless Operation
    • Cold Start
  • Hardware and Software Requirements
  • Battery model Kconfig options
  • Battery monitoring for VBATLI
  • Enable VBATLI for ATM33/ATM34
  • Enable VBATLI for ATM33e/ATM34e
  • Modify Brownout Levels (ATM34)
  • Example configuration for energy harvesting
    • PMU Configuration
      • Battery and supply configuration
      • Harvesting configuration
      • External boost options
      • Harvesting meter
      • SoC-off wakeup configuration
      • 32 kHz crystal load calibration
• IDE
  • Vscode Plugin
    • Installation
    • Environment Setup for New Starter
    • Use existing virtual environment
    • Build OpenAir applications
    • Flash the application to the board
• Debugging
  • Overview
  • Application runtime tools
  • Debug using the GNU Debugger (GDB)
    • GDB command reference
    • Attach debugger to running program
    • Coredump Collection/Analysis
      • The Zephyr Coredump module
      • Collecting a live coredump with GDB
      • Offline analysis of a coredump file
  • Additional Information on Debugging
    • SPE Secure Fault Storage Test
      • Overview
      • Test Components
        • Main Test File (main.c)
        • Test Log Backend (test_log_backend.c)
      • Test Configurations
        • Basic Test
        • Log Panic Variants
      • Requirements
      • Building and Running
        • Basic Test
        • Programming
• Tools
  • Atmosic Archive Tool
    • Overview
    • Python Requirements
    • West atm_arch Commands
    • Generate Archive File with Sysbuild
    • Generate Archive File using individual west build commands (without sysbuild)
      • With Fixed BLE Stack
      • With MCUboot
      • Without MCUboot
      • With Factory or Setting Data
    • Adding Extra Erase or Program Commands
    • Show and Flash Archive File
  • Atmosic Secure Journal Tool
    • Overview
    • Theory of Operation
      • Tag Types
        • Overridable Tags
        • Immutable Tags
      • SDK Tooling
      • Python Requirements
        • Creating a local binary copy of the Secure Journal
        • Dumping Secure Journal
          • Appending a Tag to the Secure Journal
      • Data Format Examples
      • Complete Example
        • Locking Down a Tag
        • Erasing Non-ratcheted Data From the Secure Journal
        • Ratcheting Secure Journal
  • Atmosic OTP Tool
    • Building with Secure Debug
    • Managing the OTP bits
      • Compiling MCUboot with Secure Debug
      • Using the Debug Unlock Script
  • Atmosic Zephyr Settings Generator (ZSG) Tool
    • Before You Begin
      • 1. The YAML file to be converted
      • 2. Ensure ERASE_BLOCK_SIZE / STORAGE_DATA_SIZE / FACTORY_DATA_SIZE are defined
      • 3. An attribute YAML file is required when converting a bin file back to a YAML file
    • West zsg Commands
      • Generate bin and hex file
      • Read bin file and save it to a YAML file
      • Show NVS information from bin file
      • Dump bin file from device
      • Scan ATE information from bin file
  • Atmosic Dump Tool
    • West dump Commands
      • Dump bin file from device
      • Understanding offset_addr Parameter
  • Atmosic Side-Load Key (SLKEY) Tool
    • Before You Begin
      • 1. Private Key Storage Information
      • 2. Key Data Format
      • 3. Partition Information File
    • West slkey Commands
      • Read a Single Private Key
      • Write a Single Private Key
      • Read All Private Keys
      • Write All Private Keys from File
    • Common Use Cases
      • Backup and Restore Keys
      • Update a Single Key
      • Verify Key Write
• FAQ
  • How to set BLE PHY
  • How to adjust BLE Tx power
    • 1. BLE Advertisement power setting
      • For ATM34xx platform
      • For ATM33xx platform
    • 2. BLE Connection Tx Power setting (ATM33xx, ATM34xx)
  • How to set BP Clock Frequency
  • Using Internal RC Oscillator
  • Use of Watchdog in Applications
    • System Level Watchdog using Hardware Watchdog Timer
    • Task Watchdog for Various Application Threads
    • Additional Resources

📖 Introduction

Overview of Atmosic OpenAir SDK 26.04.0

Introduction

🚀 Getting Started

Quick start guide for new developers

Getting Started Guide

📁 SDK Directory

SDK structure and EVK information

Atmosic SDK Directory and EVK

🔧 Build & Flash

Advanced build and flashing techniques

Advanced Build and Flash

📡 BLE Stack

Bluetooth Low Energy stack documentation

Atmosic BLE Stack

🔌 Peripherals

Peripheral device configuration and usage

Peripheral Devices

🔄 DFU Update

Device Firmware Update procedures

DFU Update

💡 Samples

Code samples and examples

Samples

🛠️ Tools

Development tools and utilities

Tools

OpenAir 25.11.0

Release Date: November 2025

Key Features:

• Enhanced BLE stack performance

• Improved power management

• New peripheral device support

• Updated development tools

Getting Started

• Introduction
• Getting Started Guide
  • Installation
    • Option 1 Follow The Official Zephyr Documentation
      • Creating a Workspace
    • Option 2 Using OpenAir Utility (atmoautil)
      • Install Prerequisites
      • Download
      • Install Atmosic OpenAir SDK toolchain
  • OpenAir Utility (atmoautil)
    • Commands
      • Basic
      • Manager
• Atmosic SDK Directory and EVK
  • Atmosic SDK Directory
    • openair
    • atmosic-private
  • Atmosic EVK

Development Guide (25.11.0)

• Advanced Build and Flash
  • West Build and Flash
    • Building and Flashing
      • A. Non-MCUboot Option
      • B. MCUboot Option
  • Sysbuild and Flash
    • Overview
    • Building with Sysbuild
    • Flashing with Sysbuild
    • Subpages
      • Atmosic Sysbuild Options
        • Options for SPE image
        • Options for west atm_arch
        • Options for BLE Stack
        • Options for DTS_EXTRA_CPPFLAGS
          • Without test item
          • With test item
  • Configuration Options
• SPE/NSPE Architecture and Advanced Build Options
  • Overview
  • SPE/NSPE Architecture
  • Board Variants
  • Building SPE/NSPE Applications
    • Sysbuild
      • Building
      • Flashing
    • Manual Build
      • Build Commands for SPE and NSPE
      • Flash Commands for SPE and NSPE
  • NSC API Development Guidelines
• Atmosic BLE Stack
  • PD50
  • CPD200 for ATM34/e
  • CPD200 for ATM33/e
  • Platform support for different BLE Stack variations
    • ATM34/e
    • ATM33/e
• GPIO Pin Assignment
• Partition Layout
  • Overview
  • Standard Layout Example
  • Flash XIP with Split Images Layout Examples
    • Flash XIP with Split Images and MCUboot Configuration
    • Flash XIP with Split Images without MCUboot Configuration
  • GLOSSARY
  • Storage and Factory Data
    • Atmosic Settings Subsystem (ATM_SETTINGS)
      • ATM_SETTINGS Configuration
      • ATM_SETTINGS Initialization
      • ATM_SETTINGS Factory Data Write Protection
      • ATM_SETTINGS Sample
• Peripheral Devices
  • Atmosic PWM FIFO Mode
    • Overview
    • Key Features
    • Architecture
    • Configuration
    • Device Tree
    • Usage Examples
      • Basic Ringtone Generation
      • DMA Mode Operation
    • Limitations
    • Performance Considerations
    • Troubleshooting
      • Common Issues
      • Debug Tips
• DFU Update
  • Atmosic Zephyr DFU
    • Using the Overlay Files
    • Building for DFU
    • BLE DFU Security
    • Serial DFU
• Samples
  • Bluetooth: beacon
    • Overview
      • Button Functionality
      • LED Indication
    • Requirements
    • Building and Running
    • Configuration
      • Beacon Profile Selection
      • Advertising Parameters
      • Hardware Requirements
      • Energy Harvesting Configuration
    • Testing
  • Bluetooth: broadcaster
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: broadcaster_multiple
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: DTM 2-wire
    • Overview
    • Requirements
    • Building and Running
    • Configuration
    • Connection to the Tester
    • Testing
    • Compatibility
    • Troubleshooting
  • Bluetooth: extended_adv_advertiser
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: extended_adv_scanner
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: hci_uart
    • Overview
    • Requirements
    • Default UART settings
    • Building and Running
  • Bluetooth: hci_vendor
    • Overview
    • Requirements
    • Default UART(UART0) Settings
    • Building and Running
    • Debug log(UART1)
  • Bluetooth: observer
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
    • Output Format
    • Configuration Options
      • Extended Advertising Support
      • RSSI Filtering
      • Scan Parameters
    • Testing
    • Troubleshooting
    • Related Samples
  • Bluetooth: periodic advertising
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: periodic_adv_conn
    • Overview
    • Key Features
    • Requirements
    • Building and Running
    • Sample Output
    • Configuration Parameters
      • Subevent Configuration
      • Response Slot Configuration
      • Periodic Advertising Parameters
    • Protocol Flow
    • Testing
    • Console Output Analysis
    • Troubleshooting
    • Advanced Configuration
    • Related Samples
  • Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • PAwR Parameters
      • Bluetooth Configuration
      • Device Capacity
    • Testing
      • Expected Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: Periodic Advertising Connection Procedure (Responder)
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • Sync Parameters
      • Subevent Selection
      • Response Parameters
      • Response Data Format
      • Bluetooth Configuration
    • Testing
      • Expected Behavior
      • Connection Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
    • Overview
      • Protocol Flow
    • Requirements
    • Building and Running
    • Sample Output
      • Output Format
    • Configuration Options
      • GATT Service
      • Bluetooth Configuration
      • PAST Parameters
      • Response Mechanism
    • Testing
      • Multiple Devices
      • Expected Behavior
    • Troubleshooting
    • Related Samples
  • Bluetooth: peripheral
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: peripheral_accept_list
    • Overview
    • Requirements
    • Building and Running
  • Drivers: i2s_output
    • Overview
    • Requirements
    • Building and Running
  • Drivers: uart_passthrough
    • Overview
    • Requirements
    • Building and Running
  • Basic: Hello World
    • Overview
    • Requirements
    • Building and Running
  • Basic: NSC Hello World
    • Overview
    • Building and Running
      • Sample Output
  • Basic: spe
    • Overview
    • Secure Fault Storage
    • Requirements
    • Configuring the Memory Protection Controller (MPC)
      • Defining a Partition as Secure
      • Nested Partitions
    • Build and Run
      • Increasing the Size of the SPE
    • MCUBOOT Usage
    • Note on TF-M
  • Sensor: adt7420
    • Overview
    • Requirements
    • Building and Running
  • Sensor: bme280
    • Overview
    • Requirements
    • Building and Running
    • References
  • Sensor: lis2dh
    • Overview
    • Requirements
    • Building and Running
    • References
  • Shields: Buzz 2 Click
    • Overview
    • Requirements
    • Power Supply Selection
    • Building and Running
    • Sample Output
    • Customization
    • API Reference
    • References
  • Shields: PIR Click
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
    • References
  • Subsys: mgmt_mcumgr_smp_svr
    • Overview
    • Requirements
    • Building and Running
  • Subsys: settings
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
  • Sysbuild: hello_world
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
• Atmosic Applications
  • Channel Sounding: Initiator with Ranging Requester
    • Overview
    • Requirements
    • Configuration Options
      • Bluetooth Transmit Power Control
      • RSSI Reading Support
      • 1M PHY for Long-Distance Testing
    • Building and Running
  • Channel Sounding: Reflector with Ranging Responder
    • Overview
    • Requirements
    • Building and Running
  • Multimode Consumer Tag
    • Overview
    • Requirements
    • Device State Transitions
    • Buttons and user actions (Summary)
      • FMNA (Apple Find My Network Accessory)
      • FHN (Google Find Hub Network)
      • STF (Samsung SmartThings Find)
    • Build items (targets)
      • 1) Default triple-mode (FMNA + FHN + STF)
      • 2) Google only (FHN)
      • 3) Apple only (FMNA)
      • 4) Samsung only (STF, minimal)
      • 5) Dual-mode: Google + Apple
      • 6) Dual-mode: Samsung + Apple
      • 7) Dual-mode: Samsung + Google
      • 8) Triple-mode with MCUboot + OTA over BLE
      • 9) Google only (FHN) with MCUboot + OTA
      • 10) Apple only (FMNA) with MCUboot + UARP
      • 11) Samsung only (STF, minimal) with MCUboot + OTA
      • 12) Dual-mode: Google + Apple with MCUboot + OTA
      • 13) Dual-mode: Samsung + Apple with MCUboot + OTA
      • 14) Dual-mode: Samsung + Google with MCUboot + OTA
      • 15) ATM34: MCUboot + Flash XIP (triple-mode)
      • 16) ATM34: MCUboot + Flash XIP (overwrite-only)
      • 17) Google only (FHN) with Channel Sounding
      • 18) Dual-mode (Google + Apple) with Channel Sounding
      • 19) Google only (FHN) with Channel Sounding and MCUboot + OTA
      • 20) Dual-mode (Google + Apple) with Channel Sounding and MCUboot + OTA
      • 21) Google only (FHN) with Ranging OOB Data Element (Precision Finding)
    • Google Find Hub Network (FHN) details
      • Adoption and approval
      • Model ID and Anti-Spoofing key
      • Secure Journal support
      • Pairing and provisioning procedure
      • Precision Finding (FHPF) with Ranging OOB Data Elements
        • Supported Ranging Technologies
        • Configuration for Precision Finding
        • Usage with Google Find My Device App
    • Apple Find My Network Accessory (FMNA) details
      • ADK Integration Guide
        • Option1 (recommended)
        • Option2
      • Device Manufacturer Settings
      • FMNA Configuration Settings
        • Custom Bluetooth Device Address
        • FMNA Accessory Information
        • FMNA Firmware Version
    • Samsung SmartThings Find (STF) details
      • SmartThings Find Device SDK integration
      • Build integration notes
      • Flashing
      • Additional Notes
• Flash XIP with Split Images
  • Overview
  • External Flash
  • Configuration
    • Device Tree
    • Linker Settings
    • MCUBOOT Configuration
      • Single Split Application
      • SPE with Split NSPE
      • Sizing Partitions
    • Sizing the Image 0 Fast Code Partition
    • Sizing the Image 1 Code partition
  • Building
  • Flashing
  • Version Dependencies
    • Matching Version Criteria
• Low Power Design and Energy Harvesting
• IDE
  • Vscode Plugin
    • Installation
    • Creating First Workspace
    • Creating First Project
    • Building The Project
    • Flashing The Project
    • Debug The Project
    • Debug The Threads
    • Remote Development via SSH Plugin
• Debugging
  • Overview
  • Application runtime tools
  • Debug using the GNU Debugger (GDB)
    • GDB command reference
    • Attach debugger to running program
    • Coredump Collection/Analysis
      • The Zephyr Coredump module
      • Collecting a live coredump with GDB
      • Offline analysis of a coredump file
  • Additional Information on Debugging
    • SPE Secure Fault Storage Test
      • Overview
      • Test Components
        • Main Test File (main.c)
        • Test Log Backend (test_log_backend.c)
      • Test Configurations
        • Basic Test
        • Log Panic Variants
      • Requirements
      • Building and Running
        • Basic Test
        • Programming
• Tools
  • Atmosic Archive Tool
    • Overview
    • Python Requirements
    • West atm_arch Commands
    • Generate Archive File
      • With Fixed BLE Stack
      • With MCUboot
      • Without MCUboot
      • With Factory or Setting Data
    • Adding Extra Erase or Program Commands
    • Show and Flash Archive File
    • Generate Archive File with Sysbuild
  • Atmosic Secure Journal Tool
    • Overview
    • Python Requirements
    • West secjrnl Commands
      • Dumping Secure Journal
      • Appending a Tag to the Secure Journal
        • Data Format Examples
        • Complete Example
      • Locking Down a Tag
      • Erasing Non-ratcheted Data From the Secure Journal
      • Ratcheting Secure Journal
  • Atmosic Zephyr Settings Generator (ZSG) Tool
    • Before You Begin
      • 1. The YAML file to be converted
      • 2. Ensure ERASE_BLOCK_SIZE / STORAGE_DATA_SIZE / FACTORY_DATA_SIZE are defined
      • 3. An attribute YAML file is required when converting a bin file back to a YAML file
    • West zsg Commands
      • Generate bin and hex file
      • Read bin file and save it to a YAML file
      • Show NVS information from bin file
      • Dump bin file from device
      • Scan ATE information from bin file
• FAQ

📖 Introduction

Overview of Atmosic OpenAir SDK 25.11.0

Introduction

🚀 Getting Started

Quick start guide for new developers

Getting Started Guide

📁 SDK Directory

SDK structure and EVK information

Atmosic SDK Directory and EVK

🔧 Build & Flash

Advanced build and flashing techniques

Advanced Build and Flash

📡 BLE Stack

Bluetooth Low Energy stack documentation

Atmosic BLE Stack

🔌 Peripherals

Peripheral device configuration and usage

Peripheral Devices

🔄 DFU Update

Device Firmware Update procedures

DFU Update

💡 Samples

Code samples and examples

Samples

🛠️ Tools

Development tools and utilities

Tools

OpenAir 25.07.0 - Previous Release

Release Date: July 2025

Key Features:

• Stable BLE stack implementation

• Core peripheral support

• Standard development tools

• Comprehensive documentation

Getting Started

• Introduction
• Getting Started Guide
  • Installation
    • Option 1 Follow The Official Zephyr Documentation (macOS, Linux)
      • Creating a Workspace
    • Option 2 Using Atmosic OpenAir Utility (Linux, Windows)
      • Install Prerequisites
      • Download
      • Install Atmosic OpenAir SDK toolchain
  • OpenAir Utility (atmoautil)
    • Commands
      • Basic
      • Manager
• Atmosic SDK Directory and EVK
  • Atmosic SDK Directory
    • openair
  • Atmosic EVK

Development Guide (25.07.0)

• Advanced Build and Flash
  • West Build and Flash
    • Building and Flashing
      • A. Non-MCUboot Option
      • B. MCUboot Option
  • Sysbuild and Flash
    • Overview
    • Building with Sysbuild
    • Flashing with Sysbuild
    • Subpages
      • Atmosic Sysbuild Options
        • Options for SPE image
        • Options for west atm_arch
        • Options for BLE Stack
        • Options for DTS_EXTRA_CPPFLAGS
  • Configuration Options
• Atmosic BLE Stack
  • PD50 configured via CONFIG_ATMWSTK_PD50=y config choice
  • Full stack configured via CONFIG_ATMWSTK_FULL=y config choice. Only supported on ATM33xx
  • CPD200 configured via CONFIG_ATMWSTK_CPD200=y config choice. Only supported on ATM34xx
• Platform support for different BLE Stack variations
  • ATM34xx
  • ATM33xx
  • ATMx2xx
• GPIO Pin Assignment
• Partition Layout
  • Overview
  • GLOSSARY
  • Storage and Factory Data
    • Atmosic Settings Subsystem (ATM_SETTINGS)
      • ATM_SETTINGS Configuration
      • ATM_SETTINGS Initialization
      • ATM_SETTINGS Factory Data Write Protection
      • ATM_SETTINGS Sample
• Peripheral Devices
• DFU Update
  • Atmosic Zephyr DFU
    • Using the Overlay Files
    • Building for DFU
    • BLE DFU Security
    • Serial DFU
• Samples
  • Bluetooth: beacon
    • Overview
      • Button Functionality
      • LED Indication
    • Requirements
    • Building and Running
    • Configuration
      • Beacon Profile Selection
      • Advertising Parameters
      • Hardware Requirements
      • Energy Harvesting Configuration
    • Testing
  • Bluetooth: broadcaster
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: broadcaster_multiple
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: extended_adv_advertiser
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: extended_adv_scanner
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: hci_uart
    • Overview
    • Requirements
    • Default UART settings
    • Building and Running
  • Bluetooth: hci_vendor
    • Overview
    • Requirements
    • Default UART(UART0) Settings
    • Building and Running
    • Debug log(UART1)
  • Bluetooth: periodic advertising
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: peripheral
    • Overview
    • Requirements
    • Building and Running
  • Bluetooth: peripheral_accept_list
    • Overview
    • Requirements
    • Building and Running
  • Drivers: i2s_output
    • Overview
    • Requirements
    • Building and Running
  • Drivers: uart_passthrough
    • Overview
    • Requirements
    • Building and Running
  • Basic: Hello World
    • Overview
    • Requirements
    • Building and Running
  • Basic: NSC Hello World
    • Overview
    • Building and Running
      • Sample Output
  • Basic: spe
    • Overview
    • Requirements
    • Configuring the Memory Protection Controller (MPC)
      • Defining a Partition as Secure
      • Nested Partitions
    • Build and Run
      • Increasing the Size of the SPE
    • MCUBOOT Usage
    • Note on TF-M
  • Sensor: adt7420
    • Overview
    • Requirements
    • Building and Running
  • Sensor: lis2dh
    • Overview
    • Requirements
    • Building and Running
    • References
  • Subsys: mgmt_mcumgr_smp_svr
    • Overview
    • Requirements
    • Building and Running
  • Subsys: settings
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
  • Sysbuild: hello_world
    • Overview
    • Requirements
    • Building and Running
    • Sample Output
• Atmosic Applications
  • Apple Find My Network Tag
    • Overview
    • Requirements
    • ADK Integration Guide
      • Option1 (recommended)
      • Option2
    • Device Manufacturer Settings
    • FMNA Configuration Settings
      • Custom Bluetooth Device Address
      • FMNA Accessory Information
      • FMNA Firmware Version
    • Building and Running
      • Without UARP Support
      • With UARP Support
      • Programming
    • Button Functions
    • PWM Buzzer
    • Mobile Applications
    • Limitations
  • Channel Sounding: Initiator with Ranging Requester
    • Overview
    • Requirements
    • Building and Running
    • Notes and Recommendations
  • Channel Sounding: Reflector with Ranging Responder
    • Overview
    • Requirements
    • Building and Running
  • Find My Combo Tag: Apple & Google Compatible
    • Overview
    • Requirements
    • Device State Transitions
    • Custom Bluetooth Device Address
    • PWM Buzzer
    • Building and Running
      • Programming
  • Samsung SmartThings Tag
    • Overview
    • Requirements
    • Samsung SmartThings Find Device SDK
    • Building and Running
      • Build Without MCUboot
      • Build With MCUboot
      • Programming
  • Google Find My Device Network Tag
    • Overview
    • Requirements
    • Google Fast Pair Adoption Process Guide
      • Approval
      • Model ID and Anti-Spoofing key
    • Pairing and Provisioning Procedure
    • Button2
    • Build Options
      • Fast Pair Discoverable Advertisement
      • OTA Support via BLE
      • PWM Buzzer Support
    • Building and Running
      • Build Without MCUboot
      • Build With MCUboot
      • Specify User-Pair Bluetooth Address
      • Build With OTA Support
      • Build With Serial DFU Support
      • Programming
  • Find My Combo Tag: Apple & Samsung SmartThings Compatible
    • Overview
    • Requirements
    • Samsung SmartThings Find Device SDK
    • ADK Integration Guide
    • Building and Running
      • Build Without MCUboot
      • Build With MCUboot
      • Programming
    • Button Functions
• Low Power Design and Energy Harvesting
• IDE
• Debugging
  • Overview
  • Application runtime tools
  • Debug using the GNU Debugger (GDB)
    • GDB command reference
    • Attach debugger to running program
    • Coredump Collection/Analysis
      • The Zephyr Coredump module
      • Collecting a live coredump with GDB
      • Offline analysis of a coredump file
• Tools
  • Atmosic Archive Tool
    • Overview
    • Python Requirements
    • West atm_arch Commands
    • Generate Archive File
      • With Fixed BLE Stack
      • With MCUboot
      • Without MCUboot
      • With Factory or Setting Data
    • Adding Extra Erase or Program Commands
    • Show and Flash Archive File
    • Generate Archive File with Sysbuild
  • Atmosic Secure Journal Tool
    • Overview
    • Python Requirements
    • West secjrnl Commands
      • Dumping Secure Journal
      • Appending a Tag to the Secure Journal
      • Locking Down a Tag
      • Erasing Non-ratcheted Data From the Secure Journal
      • Ratcheting Secure Journal
  • Atmosic Zephyr Settings Generator (ZSG) Tool
    • Before You Begin
      • 1. The YAML file to be converted
      • 2. Ensure ERASE_BLOCK_SIZE / STORAGE_DATA_SIZE / FACTORY_DATA_SIZE are defined
      • 3. An attribute YAML file is required when converting a bin file back to a YAML file
    • Actions
• FAQ

📖 Introduction

Overview of Atmosic OpenAir SDK

Introduction

🚀 Getting Started

Quick start guide for OpenAir

Getting Started Guide

📁 SDK Directory

SDK structure and EVK information

Atmosic SDK Directory and EVK

🔧 Build & Flash

Advanced build and flashing techniques

Advanced Build and Flash

📡 BLE Stack

Bluetooth Low Energy stack documentation

Atmosic BLE Stack

🔌 Peripherals

Peripheral device configuration

Peripheral Devices

💡 Samples

Code samples and examples

Samples