Welcome to Atmosic OpenAir Documentation
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
Development Guide
- Advanced Build and Flash
- West Build and Flash
- Sysbuild and Flash
- Overview
- Building with Sysbuild
- Flashing with Sysbuild
- Subpages
- Atmosic Sysbuild Options
- Table of Contents
- Basic Structure
- Common Configuration Options
- Atmosic-Specific Configurations
- MCUboot Configurations
- TrustZone Configurations
- DFU and OTA Configurations
- Channel Sounding (CS) Configurations
- XIP (Execute-in-Place) Configurations
- ATM Archive Generation
- Complete Examples
- Building with Sample.yaml
- Atmosic Sysbuild Options
- Configuration Options
- MCUboot and Secure Boot
- Secure Debug
- SPE/NSPE Architecture and Advanced Build Options
- Atmosic BLE Stack
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- AT Command Set
- AT Command Set — Subsystem Reference
- Overview
- Role-Based Command Bundles
CONFIG_AT_CMD_PERIPHERAL— Peripheral / advertiser roleCONFIG_AT_CMD_CENTRAL— Central / observer roleCONFIG_AT_CMD_GATT_DFT_SERVER— Default GATT server (auto-selected byCONFIG_AT_CMD_PERIPHERAL)CONFIG_AT_CMD_GATT_CLIENT— GATT client (auto-selected byCONFIG_AT_CMD_CENTRAL)- Connection commands — enabled automatically when
CONFIG_PERIPHERALorCONFIG_CENTRALis selected CONFIG_AT_CMD_TAG_SET— Tracking tag role
- Command Groups
- Role-Based Command Bundles
- Typical Two-Device Flow
- Kconfig Summary
- Overview
- AT Command Format
- System Commands
- AT+SYSFUNCPIN — GPIO Function Pin Control
- AT+SYSPM — System Power Mode
- AT+SYSUARTBR — UART Baud Rate
- AT+SYSUARTFC — UART Flow Control
- System Command Error Codes
- AT+SYSBDADDR — Bluetooth Device Address
- AT+SYSRESET — System Reset
- AT+SYSLOCK — Channel Lock
- AT+SYSUNLOCK — Channel Unlock
- AT+SYSSTORAGE — NVS Key-Value Storage
- AT+SYSUARTRAW — Bounded UART/BLE Raw Data Transfer
- Serial DFU Commands
- BLE Peripheral Commands
- AT+BLEGAPDEVNAME — GAP Device Name
- AT+BLEADVENABLE — Start / Stop Advertising
- AT+BLEADVSETID — Assign BT Identity to Advertising Instance
- AT+BLEADVLEGACYPARM — Legacy Advertising Parameters
- AT+BLEEXTADVPARM — Extended Advertising Parameters
- AT+BLEADVDATA — Set Advertisement Payload
- AT+BLESCANRSPDATA — Set Scan-Response Payload
- AT+BLEADVTXPWR — Advertising TX Power
- BLE Central Commands
- BLE Common Commands
- BLE Events
- BLE GATT Server Commands
- BLE GATT Default Server Commands
- sec_prop Reference
- Default Attribute Layout
- AT+BLEGATTDFTSERVER — Enable / Disable Default GATT Server
- AT+BLEGATTDFTSERVICE — Default Service Configuration
- AT+BLEGATTDFTCHAR1 — Characteristic 1 (TRX) Configuration
- AT+BLEGATTDFTCHAR2 — Characteristic 2 (TRX2) Configuration
- AT+BLEGATTDFTCHAR1VAL — Characteristic 1 Pre-set Read Value
- AT+BLEGATTDFTCHAR2VAL — Characteristic 2 Pre-set Read Value
- AT+BLEGATTTOBLE — Send Notification / Indication
- BLE GATT Dynamic Server Commands
- Basic Workflow
- Typical Dynamic GATT Workflow
- Events
- Troubleshooting
- BLE GATT Client Commands
- Tag Commands and Events
- Command Dependencies
- AT+TAGINFO — Tag Information
- AT+TAGMODE — Tag Mode Select / Query
- AT+TAGBATTERY — Battery Level
- AT+TAGSTART — Start Tag BLE Stack
- AT+TAGRANGING — Ranging Technology Gate
- AT+TAGRANGINGCAPUWB — UWB Ranging Capability
- AT+TAGRANGINGCAPCS — BLE CS Ranging Capability
- AT+TAGRESET — Reboot / Factory Reset
- AT+TAGSTFIND — STF Button Simulation
- AT+TAGFMNASN — FMNA Serial Number Lookup
- AT+TAGFMNAMFI — FMNA MFI Token Log
- AT+TAGCSUNPAIR — Channel Sounding Unpair
- AT+TAGGFPIND — GFP Button Simulation
- AT+TAGMOTIONRPT — Host Motion Acceleration Report
- +EVTTAGSTATE — Tag State
- +EVTTAGERROR — Tag Error
- +EVTTAGGFPREVERSERING — GFP Reverse Ringing Status
- +EVTTAGBUZZER — Tag Buzzer Action
- +EVTTAGMOTIONCTL — Motion Sensor Control Event
- AT+TAGADDR — Query Advertising BT Address
- Tag AT Command Error Codes
- Implementation Notes
- Command Dependencies
- Error Code Reference
- AT Command Set — Subsystem Reference
- Samples
- Bluetooth: atm_beacon
- ATM BLE Central and Peripheral Sample
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: Central HR
- Bluetooth: Central Multilink
- Bluetooth: DTM 2-wire
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: High Duty Cycle Directed Advertising
- Bluetooth: observer
- Bluetooth: periodic advertising
- Bluetooth: periodic_adv_conn
- Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
- Bluetooth: Periodic Sync
- Bluetooth: Periodic Advertising Connection Procedure (Responder)
- Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Bluetooth: Peripheral DIS
- Bluetooth: Peripheral HR
- Bluetooth: Peripheral Identity
- Bluetooth: Scan & Advertise
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: Minimal
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: bme280
- Sensor: lis2dh
- Subsys: AT Command Set
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- BLE HID Remote Controller
- ESL (Electronic Shelf Label) Peripheral
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Multimode Consumer Tag
- Overview
- AT Command Interface
- Requirements
- Device State Transitions
- Buttons and user actions (Summary)
- 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) Google only (FHN) with MCUboot + OTA
- 9) Apple only (FMNA) with MCUboot + UARP
- 10) Samsung only (STF, minimal) with MCUboot + Native Firmware Update Only
- 11) Samsung only (STF) with MCUboot + OTA
- 12) Dual-mode: Google + Apple with MCUboot + Flash XIP (swap-using-offset) with OTA
- 13) Dual-mode: Samsung + Apple with MCUboot + Flash XIP (swap-using-offset) with OTA
- 14) Dual-mode: Samsung + Google with MCUboot + Flash XIP (swap-using-offset) with OTA
- 15) MCUboot + Flash XIP (triple-mode) with OTA
- 16) MCUboot + Flash XIP (overwrite-only) with OTA
- 17) MCUboot + Flash XIP (legacy scratch) with OTA
- 18) Dual-mode (FHN + FMNA) Channel Sounding demo
- 19) Dual-mode (FHN + FMNA) Channel Sounding demo with MCUboot + Flash XIP (swap-using-offset) with OTA
- 20) Dual-mode (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 21) Dual-mode v2 (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 22) Google only (FHN) with Ranging OOB Data Element (Precision Finding)
- 23) Google only (FHN) v2 with motion interrupt
- Storage Size Configuration
- Google Find Hub Network (FHN) details
- Apple Find My Network Accessory (FMNA) details
- Samsung SmartThings Find (STF) details
- Sensor Beacon Application
- ATM BLE Throughput Central Test Application
- Overview
- Features
- Hardware Requirements
- Building and Running
- Configuration
- Custom Shell Commands
start_testack <on|off>set_phy <1M|2M|CODED_S2|CODED_S8>set_conn_interval <interval>set_payload_size <size>show_payload_sizeset_packet_count <count>show_packet_countset_tx_power <power>(Atmosic Vendor Command)show_tx_powershow_tx_power_infoset_test_direction <direction>show_test_direction
- Usage
- ATM BLE Throughput Peripheral Test Application
- ATMBTCSTAG-IOT-3405 Applications
- Flash XIP with Split Images
- Low Power Design and Energy Harvesting
- Power Management Unit
- Energy Harvesting and Charging
- Energy Harvesting Meter
- Batteryless Operation
- Hardware and Software Requirements
- Battery model Kconfig options
- Battery monitoring for VBATLI
- Enable VBATLI for ATM33/ATM34
- Enable VBATLI for ATM33e/ATM34e
- Brownout Configuration
- Example configuration for energy harvesting
- IDE
- Debugging
- Tools
- Atmosic Archive Tool
- Atmosic Secure Journal Tool
- Atmosic OTP Tool
- Atmosic Zephyr Settings Generator (ZSG) Tool
- Atmosic Dump Tool
- Atmosic Side-Load Key (SLKEY) Tool
- FAQ
🚀 Getting Started
Quick start guide for new users
📖 Introduction
Overview of the Atmosic OpenAir SDK
📁 SDK Directory & EVK
SDK structure and evaluation kit information
🔧 Advanced Build & Flash
Advanced building and flashing techniques
🐛 Debugging
Debugging tools and techniques
🔄 DFU Update
Device Firmware Update procedures
📡 AT Command Set
UART AT command reference for BLE and tag control
❓ FAQ
Frequently asked questions
💾 Flash Split XIP
Flash partitioning and XIP configuration
📌 GPIO Pin Assignment
GPIO configuration and pin assignments
💻 IDE Support
Integrated development environment setup
⚡ Low Power Design
Power optimization and energy harvesting
🗂️ Partition Layout
Memory partition configuration
🔌 Peripheral Devices
Peripheral device drivers and usage
💡 Samples
Code samples and examples
🔐 SPE/NSPE
Secure and non-secure processing environments
🛠️ Tools
Development tools and utilities
OpenAir 26.09.0
Release Date: October 2026
Key Features:
ATM5/e series introduction
Enhancements to Channel Sounding, multimode_consumer_tag AT commands, and VSCode
Inline PCT Transfer support on ATM5
hid_remote application introduction
peripheral_esl support on ATM34
Recommended for new projects
Getting Started (26.09.0)
Development Guide (26.09.0)
- Advanced Build and Flash
- West Build and Flash
- Sysbuild and Flash
- Overview
- Building with Sysbuild
- Flashing with Sysbuild
- Subpages
- Atmosic Sysbuild Options
- Table of Contents
- Basic Structure
- Common Configuration Options
- Atmosic-Specific Configurations
- MCUboot Configurations
- TrustZone Configurations
- DFU and OTA Configurations
- Channel Sounding (CS) Configurations
- XIP (Execute-in-Place) Configurations
- ATM Archive Generation
- Complete Examples
- Building with Sample.yaml
- Atmosic Sysbuild Options
- Configuration Options
- MCUboot and Secure Boot
- Secure Debug
- SPE/NSPE Architecture and Advanced Build Options
- Atmosic BLE Stack
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- AT Command Set
- AT Command Set — Subsystem Reference
- Overview
- Role-Based Command Bundles
CONFIG_AT_CMD_PERIPHERAL— Peripheral / advertiser roleCONFIG_AT_CMD_CENTRAL— Central / observer roleCONFIG_AT_CMD_GATT_DFT_SERVER— Default GATT server (auto-selected byCONFIG_AT_CMD_PERIPHERAL)CONFIG_AT_CMD_GATT_CLIENT— GATT client (auto-selected byCONFIG_AT_CMD_CENTRAL)- Connection commands — enabled automatically when
CONFIG_PERIPHERALorCONFIG_CENTRALis selected CONFIG_AT_CMD_TAG_SET— Tracking tag role
- Command Groups
- Role-Based Command Bundles
- Typical Two-Device Flow
- Kconfig Summary
- Overview
- AT Command Format
- System Commands
- AT+SYSFUNCPIN — GPIO Function Pin Control
- AT+SYSPM — System Power Mode
- AT+SYSUARTBR — UART Baud Rate
- AT+SYSUARTFC — UART Flow Control
- System Command Error Codes
- AT+SYSBDADDR — Bluetooth Device Address
- AT+SYSRESET — System Reset
- AT+SYSLOCK — Channel Lock
- AT+SYSUNLOCK — Channel Unlock
- AT+SYSSTORAGE — NVS Key-Value Storage
- AT+SYSUARTRAW — Bounded UART/BLE Raw Data Transfer
- Serial DFU Commands
- BLE Peripheral Commands
- AT+BLEGAPDEVNAME — GAP Device Name
- AT+BLEADVENABLE — Start / Stop Advertising
- AT+BLEADVSETID — Assign BT Identity to Advertising Instance
- AT+BLEADVLEGACYPARM — Legacy Advertising Parameters
- AT+BLEEXTADVPARM — Extended Advertising Parameters
- AT+BLEADVDATA — Set Advertisement Payload
- AT+BLESCANRSPDATA — Set Scan-Response Payload
- AT+BLEADVTXPWR — Advertising TX Power
- BLE Central Commands
- BLE Common Commands
- BLE Events
- BLE GATT Server Commands
- BLE GATT Default Server Commands
- sec_prop Reference
- Default Attribute Layout
- AT+BLEGATTDFTSERVER — Enable / Disable Default GATT Server
- AT+BLEGATTDFTSERVICE — Default Service Configuration
- AT+BLEGATTDFTCHAR1 — Characteristic 1 (TRX) Configuration
- AT+BLEGATTDFTCHAR2 — Characteristic 2 (TRX2) Configuration
- AT+BLEGATTDFTCHAR1VAL — Characteristic 1 Pre-set Read Value
- AT+BLEGATTDFTCHAR2VAL — Characteristic 2 Pre-set Read Value
- AT+BLEGATTTOBLE — Send Notification / Indication
- BLE GATT Dynamic Server Commands
- Basic Workflow
- Typical Dynamic GATT Workflow
- Events
- Troubleshooting
- BLE GATT Client Commands
- Tag Commands and Events
- Command Dependencies
- AT+TAGINFO — Tag Information
- AT+TAGMODE — Tag Mode Select / Query
- AT+TAGBATTERY — Battery Level
- AT+TAGSTART — Start Tag BLE Stack
- AT+TAGRANGING — Ranging Technology Gate
- AT+TAGRANGINGCAPUWB — UWB Ranging Capability
- AT+TAGRANGINGCAPCS — BLE CS Ranging Capability
- AT+TAGRESET — Reboot / Factory Reset
- AT+TAGSTFIND — STF Button Simulation
- AT+TAGFMNASN — FMNA Serial Number Lookup
- AT+TAGFMNAMFI — FMNA MFI Token Log
- AT+TAGCSUNPAIR — Channel Sounding Unpair
- AT+TAGGFPIND — GFP Button Simulation
- AT+TAGMOTIONRPT — Host Motion Acceleration Report
- +EVTTAGSTATE — Tag State
- +EVTTAGERROR — Tag Error
- +EVTTAGGFPREVERSERING — GFP Reverse Ringing Status
- +EVTTAGBUZZER — Tag Buzzer Action
- +EVTTAGMOTIONCTL — Motion Sensor Control Event
- AT+TAGADDR — Query Advertising BT Address
- Tag AT Command Error Codes
- Implementation Notes
- Command Dependencies
- Error Code Reference
- AT Command Set — Subsystem Reference
- Samples
- Bluetooth: atm_beacon
- ATM BLE Central and Peripheral Sample
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: Central HR
- Bluetooth: Central Multilink
- Bluetooth: DTM 2-wire
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: High Duty Cycle Directed Advertising
- Bluetooth: observer
- Bluetooth: periodic advertising
- Bluetooth: periodic_adv_conn
- Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
- Bluetooth: Periodic Sync
- Bluetooth: Periodic Advertising Connection Procedure (Responder)
- Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Bluetooth: Peripheral DIS
- Bluetooth: Peripheral HR
- Bluetooth: Peripheral Identity
- Bluetooth: Scan & Advertise
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: Minimal
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: bme280
- Sensor: lis2dh
- Subsys: AT Command Set
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- BLE HID Remote Controller
- ESL (Electronic Shelf Label) Peripheral
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Multimode Consumer Tag
- Overview
- AT Command Interface
- Requirements
- Device State Transitions
- Buttons and user actions (Summary)
- 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) Google only (FHN) with MCUboot + OTA
- 9) Apple only (FMNA) with MCUboot + UARP
- 10) Samsung only (STF, minimal) with MCUboot + Native Firmware Update Only
- 11) Samsung only (STF) with MCUboot + OTA
- 12) Dual-mode: Google + Apple with MCUboot + Flash XIP (swap-using-offset) with OTA
- 13) Dual-mode: Samsung + Apple with MCUboot + Flash XIP (swap-using-offset) with OTA
- 14) Dual-mode: Samsung + Google with MCUboot + Flash XIP (swap-using-offset) with OTA
- 15) MCUboot + Flash XIP (triple-mode) with OTA
- 16) MCUboot + Flash XIP (overwrite-only) with OTA
- 17) MCUboot + Flash XIP (legacy scratch) with OTA
- 18) Dual-mode (FHN + FMNA) Channel Sounding demo
- 19) Dual-mode (FHN + FMNA) Channel Sounding demo with MCUboot + Flash XIP (swap-using-offset) with OTA
- 20) Dual-mode (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 21) Dual-mode v2 (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 22) Google only (FHN) with Ranging OOB Data Element (Precision Finding)
- 23) Google only (FHN) v2 with motion interrupt
- Storage Size Configuration
- Google Find Hub Network (FHN) details
- Apple Find My Network Accessory (FMNA) details
- Samsung SmartThings Find (STF) details
- Sensor Beacon Application
- ATM BLE Throughput Central Test Application
- Overview
- Features
- Hardware Requirements
- Building and Running
- Configuration
- Custom Shell Commands
start_testack <on|off>set_phy <1M|2M|CODED_S2|CODED_S8>set_conn_interval <interval>set_payload_size <size>show_payload_sizeset_packet_count <count>show_packet_countset_tx_power <power>(Atmosic Vendor Command)show_tx_powershow_tx_power_infoset_test_direction <direction>show_test_direction
- Usage
- ATM BLE Throughput Peripheral Test Application
- ATMBTCSTAG-IOT-3405 Applications
- Flash XIP with Split Images
- Low Power Design and Energy Harvesting
- Power Management Unit
- Energy Harvesting and Charging
- Energy Harvesting Meter
- Batteryless Operation
- Hardware and Software Requirements
- Battery model Kconfig options
- Battery monitoring for VBATLI
- Enable VBATLI for ATM33/ATM34
- Enable VBATLI for ATM33e/ATM34e
- Brownout Configuration
- Example configuration for energy harvesting
- IDE
- Debugging
- Tools
- Atmosic Archive Tool
- Atmosic Secure Journal Tool
- Atmosic OTP Tool
- Atmosic Zephyr Settings Generator (ZSG) Tool
- Atmosic Dump Tool
- Atmosic Side-Load Key (SLKEY) Tool
- FAQ
📖 Introduction
Overview of Atmosic OpenAir SDK 26.09.0
🚀 Getting Started
Quick start guide for new developers
📁 SDK Directory
SDK structure and EVK information
🔧 Build & Flash
Advanced build and flashing techniques
📡 BLE Stack
Bluetooth Low Energy stack documentation
🔌 Peripherals
Peripheral device configuration and usage
🔄 DFU Update
Device Firmware Update procedures
📟 AT Commands
UART AT command reference for BLE and tag control
💡 Samples
Code samples and examples
🛠️ Tools
Development tools and utilities
OpenAir 26.06.0
Release Date: June 2026
Key Features:
Zephyr 4.4.0 kernel. Requires Zephyr SDK 1.0.1 or higher
AT Command Set support for BLE and multimode_consumer_tag application
Continued MCUboot OTA enhancements for multimode consumer tag
Additional OTA modes (overwrite, legacy scratch) for dual-mode tags
ATM34 Module Introduction
Getting Started (26.06.0)
Development Guide (26.06.0)
- Advanced Build and Flash
- West Build and Flash
- Sysbuild and Flash
- Overview
- Building with Sysbuild
- Flashing with Sysbuild
- Subpages
- Atmosic Sysbuild Options
- Table of Contents
- Basic Structure
- Common Configuration Options
- Atmosic-Specific Configurations
- MCUboot Configurations
- TrustZone Configurations
- DFU and OTA Configurations
- Channel Sounding (CS) Configurations
- XIP (Execute-in-Place) Configurations
- ATM Archive Generation
- Complete Examples
- Building with Sample.yaml
- Atmosic Sysbuild Options
- Configuration Options
- MCUboot and Secure Boot
- Secure Debug
- SPE/NSPE Architecture and Advanced Build Options
- Atmosic BLE Stack
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- AT Command Set
- AT Command Set — Subsystem Reference
- Overview
- Role-Based Command Bundles
CONFIG_AT_CMD_PERIPHERAL— Peripheral / advertiser roleCONFIG_AT_CMD_CENTRAL— Central / observer roleCONFIG_AT_CMD_GATT_DFT_SERVER— Default GATT server (auto-selected byCONFIG_AT_CMD_PERIPHERAL)CONFIG_AT_CMD_GATT_CLIENT— GATT client (auto-selected byCONFIG_AT_CMD_CENTRAL)- Connection commands — enabled automatically when
CONFIG_PERIPHERALorCONFIG_CENTRALis selected CONFIG_AT_CMD_TAG_SET— Tracking tag role
- Command Groups
- Role-Based Command Bundles
- Typical Two-Device Flow
- Kconfig Summary
- Overview
- AT Command Format
- System Commands
- AT+SYSFUNCPIN — GPIO Function Pin Control
- AT+SYSPM — System Power Mode
- AT+SYSUARTBR — UART Baud Rate
- AT+SYSUARTFC — UART Flow Control
- System Command Error Codes
- AT+SYSBDADDR — Bluetooth Device Address
- AT+SYSRESET — System Reset
- AT+SYSLOCK — Channel Lock
- AT+SYSUNLOCK — Channel Unlock
- AT+SYSSTORAGE — NVS Key-Value Storage
- AT+SYSUARTRAW — Bounded UART/BLE Raw Data Transfer
- Serial DFU Commands
- BLE Peripheral Commands
- AT+BLEGAPDEVNAME — GAP Device Name
- AT+BLEADVENABLE — Start / Stop Advertising
- AT+BLEADVSETID — Assign BT Identity to Advertising Instance
- AT+BLEADVLEGACYPARM — Legacy Advertising Parameters
- AT+BLEEXTADVPARM — Extended Advertising Parameters
- AT+BLEADVDATA — Set Advertisement Payload
- AT+BLESCANRSPDATA — Set Scan-Response Payload
- AT+BLEADVTXPWR — Advertising TX Power
- BLE Central Commands
- BLE Common Commands
- BLE Events
- BLE GATT Server Commands
- BLE GATT Default Server Commands
- sec_prop Reference
- Default Attribute Layout
- AT+BLEGATTDFTSERVER — Enable / Disable Default GATT Server
- AT+BLEGATTDFTSERVICE — Default Service Configuration
- AT+BLEGATTDFTCHAR1 — Characteristic 1 (TRX) Configuration
- AT+BLEGATTDFTCHAR2 — Characteristic 2 (TRX2) Configuration
- AT+BLEGATTDFTCHAR1VAL — Characteristic 1 Pre-set Read Value
- AT+BLEGATTDFTCHAR2VAL — Characteristic 2 Pre-set Read Value
- AT+BLEGATTTOBLE — Send Notification / Indication
- BLE GATT Dynamic Server Commands
- Basic Workflow
- Typical Dynamic GATT Workflow
- Events
- Troubleshooting
- BLE GATT Client Commands
- Tag Commands and Events
- Command Dependencies
- AT+TAGINFO — Tag Information
- AT+TAGMODE — Tag Mode Select / Query
- AT+TAGBATTERY — Battery Level
- AT+TAGSTART — Start Tag BLE Stack
- AT+TAGRESET — Reboot / Factory Reset
- AT+TAGSTFIND — STF Button Simulation
- AT+TAGFMNASN — FMNA Serial Number Lookup
- AT+TAGFMNAMFI — FMNA MFI Token Log
- AT+TAGCSUNPAIR — Channel Sounding Unpair
- AT+TAGGFPIND — GFP Button Simulation
- AT+TAGMOTIONRPT — Host Motion Acceleration Report
- +EVTTAGSTATE — Tag State
- +EVTTAGERROR — Tag Error
- +EVTTAGGFPREVERSERING — GFP Reverse Ringing Status
- +EVTTAGBUZZER — Tag Buzzer Action
- +EVTTAGMOTIONCTL — Motion Sensor Control Event
- Tag AT Command Error Codes
- Implementation Notes
- Command Dependencies
- Error Code Reference
- AT Command Set — Subsystem Reference
- Samples
- Bluetooth: atm_beacon
- ATM BLE Central and Peripheral Sample
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: Central HR
- Bluetooth: Central Multilink
- Bluetooth: DTM 2-wire
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: High Duty Cycle Directed Advertising
- Bluetooth: observer
- Bluetooth: periodic advertising
- Bluetooth: periodic_adv_conn
- Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
- Bluetooth: Periodic Sync
- Bluetooth: Periodic Advertising Connection Procedure (Responder)
- Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Bluetooth: Peripheral DIS
- Bluetooth: Peripheral HR
- Bluetooth: Peripheral Identity
- Bluetooth: Scan & Advertise
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: Minimal
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: bme280
- Sensor: lis2dh
- Subsys: AT Command Set
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Multimode Consumer Tag
- Overview
- AT Command Interface
- Requirements
- Device State Transitions
- Buttons and user actions (Summary)
- 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) Google only (FHN) with MCUboot + OTA
- 9) Apple only (FMNA) with MCUboot + UARP
- 10) Samsung only (STF, minimal) with MCUboot + Native Firmware Update Only
- 11) Samsung only (STF) 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) MCUboot + Flash XIP (triple-mode) with OTA
- 16) MCUboot + Flash XIP (overwrite-only) with OTA
- 17) MCUboot + Flash XIP (legacy scratch) with OTA
- 18) Dual-mode (FHN + FMNA) Channel Sounding demo
- 19) Dual-mode (FHN + FMNA) Channel Sounding demo with MCUboot + OTA
- 20) Dual-mode (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 21) Dual-mode v2 (FHN + FMNA) with Precision Finding, Flash XIP, UARP + OTA
- 22) Google only (FHN) with Ranging OOB Data Element (Precision Finding)
- Storage Size Configuration
- Google Find Hub Network (FHN) details
- Apple Find My Network Accessory (FMNA) details
- Samsung SmartThings Find (STF) details
- Sensor Beacon Application
- ATM BLE Throughput Central Test Application
- Overview
- Features
- Hardware Requirements
- Building and Running
- Configuration
- Custom Shell Commands
start_testack <on|off>set_phy <1M|2M|CODED_S2|CODED_S8>set_conn_interval <interval>set_payload_size <size>show_payload_sizeset_packet_count <count>show_packet_countset_tx_power <power>(Atmosic Vendor Command)show_tx_powershow_tx_power_infoset_test_direction <direction>show_test_direction
- Usage
- ATM BLE Throughput Peripheral Test Application
- ATMBTCSTAG-IOT-3405 Applications
- Flash XIP with Split Images
- Low Power Design and Energy Harvesting
- Power Management Unit
- Energy Harvesting and Charging
- Energy Harvesting Meter
- Batteryless Operation
- 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
- IDE
- Debugging
- Tools
- Atmosic Archive Tool
- Atmosic Secure Journal Tool
- Atmosic OTP Tool
- Atmosic Zephyr Settings Generator (ZSG) Tool
- Atmosic Dump Tool
- Atmosic Side-Load Key (SLKEY) Tool
- FAQ
📖 Introduction
Overview of Atmosic OpenAir SDK 26.06.0
🚀 Getting Started
Quick start guide for new developers
📁 SDK Directory
SDK structure and EVK information
🔧 Build & Flash
Advanced build and flashing techniques
📡 BLE Stack
Bluetooth Low Energy stack documentation
🔌 Peripherals
Peripheral device configuration and usage
🔄 DFU Update
Device Firmware Update procedures
📟 AT Commands
UART AT command reference for BLE and tag control
💡 Samples
Code samples and examples
🛠️ Tools
Development tools and utilities
OpenAir 26.04.0
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
Getting Started (26.04.0)
Development Guide (26.04.0)
- Advanced Build and Flash
- West Build and Flash
- Sysbuild and Flash
- Overview
- Building with Sysbuild
- Flashing with Sysbuild
- Subpages
- Atmosic Sysbuild Options
- Table of Contents
- Basic Structure
- Common Configuration Options
- Atmosic-Specific Configurations
- MCUboot Configurations
- TrustZone Configurations
- DFU and OTA Configurations
- Channel Sounding (CS) Configurations
- XIP (Execute-in-Place) Configurations
- ATM Archive Generation
- Complete Examples
- Building with Sample.yaml
- Atmosic Sysbuild Options
- Configuration Options
- MCUboot and Secure Boot
- Secure Debug
- SPE/NSPE Architecture and Advanced Build Options
- Atmosic BLE Stack
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- Samples
- Bluetooth: atm_beacon
- ATM BLE Central and Peripheral Sample
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: Central HR
- Bluetooth: Central Multilink
- Bluetooth: DTM 2-wire
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: High Duty Cycle Directed Advertising
- Bluetooth: observer
- Bluetooth: periodic advertising
- Bluetooth: periodic_adv_conn
- Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
- Bluetooth: Periodic Sync
- Bluetooth: Periodic Advertising Connection Procedure (Responder)
- Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Bluetooth: Peripheral DIS
- Bluetooth: Peripheral HR
- Bluetooth: Peripheral Identity
- Bluetooth: Scan & Advertise
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: Minimal
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: bme280
- Sensor: lis2dh
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Multimode Consumer Tag
- Overview
- Requirements
- Device State Transitions
- Buttons and user actions (Summary)
- 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
- Apple Find My Network Accessory (FMNA) details
- Samsung SmartThings Find (STF) details
- Sensor Beacon Application
- ATM BLE Throughput Central Test Application
- Overview
- Features
- Hardware Requirements
- Building and Running
- Configuration
- Custom Shell Commands
start_testack <on|off>set_phy <1M|2M|CODED_S2|CODED_S8>set_conn_interval <interval>set_payload_size <size>show_payload_sizeset_packet_count <count>show_packet_countset_tx_power <power>(Atmosic Vendor Command)show_tx_powershow_tx_power_infoset_test_direction <direction>show_test_direction
- Usage
- ATM BLE Throughput Peripheral Test Application
- ATMBTCSTAG-IOT-3405 Applications
- Flash XIP with Split Images
- Low Power Design and Energy Harvesting
- Power Management Unit
- Energy Harvesting and Charging
- Energy Harvesting Meter
- Batteryless Operation
- 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
- IDE
- Debugging
- Tools
- Atmosic Archive Tool
- Atmosic Secure Journal Tool
- Atmosic OTP Tool
- Atmosic Zephyr Settings Generator (ZSG) Tool
- Atmosic Dump Tool
- Atmosic Side-Load Key (SLKEY) Tool
- FAQ
📖 Introduction
Overview of Atmosic OpenAir SDK 26.04.0
🚀 Getting Started
Quick start guide for new developers
📁 SDK Directory
SDK structure and EVK information
🔧 Build & Flash
Advanced build and flashing techniques
📡 BLE Stack
Bluetooth Low Energy stack documentation
🔌 Peripherals
Peripheral device configuration and usage
🔄 DFU Update
Device Firmware Update procedures
💡 Samples
Code samples and examples
🛠️ Tools
Development tools and utilities
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
Development Guide (25.11.0)
- Advanced Build and Flash
- SPE/NSPE Architecture and Advanced Build Options
- Atmosic BLE Stack
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- Samples
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: DTM 2-wire
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: observer
- Bluetooth: periodic advertising
- Bluetooth: periodic_adv_conn
- Bluetooth: Periodic Advertising with Responses (PAwR) Advertiser
- Bluetooth: Periodic Advertising Connection Procedure (Responder)
- Bluetooth: Periodic Advertising with Responses (PAwR) Synchronization
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: bme280
- Sensor: lis2dh
- Shields: Buzz 2 Click
- Shields: PIR Click
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Multimode Consumer Tag
- Overview
- Requirements
- Device State Transitions
- Buttons and user actions (Summary)
- 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
- Apple Find My Network Accessory (FMNA) details
- Samsung SmartThings Find (STF) details
- Flash XIP with Split Images
- Low Power Design and Energy Harvesting
- IDE
- Debugging
- Tools
- FAQ
📖 Introduction
Overview of Atmosic OpenAir SDK 25.11.0
🚀 Getting Started
Quick start guide for new developers
📁 SDK Directory
SDK structure and EVK information
🔧 Build & Flash
Advanced build and flashing techniques
📡 BLE Stack
Bluetooth Low Energy stack documentation
🔌 Peripherals
Peripheral device configuration and usage
🔄 DFU Update
Device Firmware Update procedures
💡 Samples
Code samples and examples
🛠️ Tools
Development tools and utilities
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
Development Guide (25.07.0)
- Advanced Build and Flash
- Atmosic BLE Stack
- Platform support for different BLE Stack variations
- GPIO Pin Assignment
- Partition Layout
- Peripheral Devices
- DFU Update
- Samples
- Bluetooth: beacon
- Bluetooth: broadcaster
- Bluetooth: broadcaster_multiple
- Bluetooth: extended_adv_advertiser
- Bluetooth: extended_adv_scanner
- Bluetooth: hci_uart
- Bluetooth: hci_vendor
- Bluetooth: periodic advertising
- Bluetooth: peripheral
- Bluetooth: peripheral_accept_list
- Drivers: i2s_output
- Drivers: uart_passthrough
- Basic: Hello World
- Basic: NSC Hello World
- Basic: spe
- Sensor: adt7420
- Sensor: lis2dh
- Subsys: mgmt_mcumgr_smp_svr
- Subsys: settings
- Sysbuild: hello_world
- Atmosic Applications
- Apple Find My Network Tag
- Channel Sounding: Initiator with Ranging Requester
- Channel Sounding: Reflector with Ranging Responder
- Find My Combo Tag: Apple & Google Compatible
- Samsung SmartThings Tag
- Google Find My Device Network Tag
- Find My Combo Tag: Apple & Samsung SmartThings Compatible
- Low Power Design and Energy Harvesting
- IDE
- Debugging
- Tools
- FAQ
📖 Introduction
Overview of Atmosic OpenAir SDK
🚀 Getting Started
Quick start guide for OpenAir
📁 SDK Directory
SDK structure and EVK information
🔧 Build & Flash
Advanced build and flashing techniques
📡 BLE Stack
Bluetooth Low Energy stack documentation
🔌 Peripherals
Peripheral device configuration
💡 Samples
Code samples and examples