Installation

`Option 1` Follow The Official Zephyr Documentation

Follow the instructions from the official Zephyr documentation on setting up the tooling for your host operating system.

Creating a Workspace

Use west init and west update to create an Atmosic SDK workspace as follows:

west init -m https://github.com/Atmosic/openair.git zephyrproject
cd zephyrproject
west update

`Option 2` Using OpenAir Utility (atmoautil)

Atmosic provides OpenAir Utility (atmoautil) to manage the Zephyr development environment by command line. The following steps install Atmosic OpenAir SDK source code and toolchain. This includes everything that is required by Zephyr’s Getting Started Guide together with additional tools and Python dependencies that Atmosic OpenAir SDK uses.

Install Prerequisites

Depending on your preferred development environment, install the following software tools:

The latest version of atmoautil, a unified command-line utility for the Atmosic OpenAir SDK, is required. Please refer to the list of supported operating systems and download the appropriate installer.
Download SEGGER J-Link from the J-Link Software and Documentation Pack page.

Note

If you encounter permission issues when running atmoautil:

On Linux, navigate to the directory containing the file and run chmod +x atmoautil to grant the file execute permission.
On Windows, simply right‑click atmoautil and select Run as administrator to open it with elevated privileges.

Download

Install Atmosic OpenAir SDK toolchain

1. Open a terminal window and execute atmoautil command.

atmoautil

2. Run the following command to install the toolchain.

(atmoautil) manager> toolchain_list
╔════════════════════════╗
║ Toolchain Version List ║
╚════════════════════════╝
25.01.0
25.02.0
(atmoautil) manager> toolchain_install -v 25.02.0
╔════════════════════════╗
║ Download Toolchain     ║
╚════════════════════════╝
Downloading ════════════════════════════════════════════════ 100% 0:00:00
╔════════════════════════╗
║ Install Toolchain      ║
╚════════════════════════╝
Installing ════════════════════════════════════════════════ 100% 0:00:00
(atmoautil) manager> toolchain_list
╔════════════════════════╗
║ Toolchain Version List ║
╚════════════════════════╝
25.01.0
25.02.0 [Installed]

With the default location to install the toolchain (C:/atmoa/toolchains on Windows, ~/atmoa/toolchains on Linux), your directory structure now looks similar to this:

atmoa
└─── toolchains
      └───<toolchain-installation>

In this simplified structure preview, toolchain-installation corresponds to the version name you installed.

3. Launch development environment through atmoautil by toolchain_launch command. It will pop-up a new Windows command prompt which the title of the window shows “Atmosic Zephyr” for Windows user. Subsequently, go to the atmoa directory and create zephyrproject folder. (For the Windows user, cd C:\atmoa, for the Linux user, cd ~/atmoa)

toolchain_launch -v 25.02.0

4. Checkout source code from GitHub.

west init -m https://github.com/Atmosic/openair.git zephyrproject
cd zephyrproject
west update

5. Build sample - hello_world in Atmosic OpenAir SDK.

west build -p always -b <BOARD>//ns openair/samples/sysbuild/hello_world --sysbuild -T samples.sysbuild.hello_world.atm

For Example:

(25.02.0) C:\atmoa\zephyrproject> west build -p always -b ATMEVK-3330e-QN-7//ns openair/samples/sysbuild/hello_world --sysbuild -T samples.sysbuild.hello_world.atm
-- west build: generating a build system
Loading Zephyr module(s) (Zephyr base): sysbuild_default
-- Found Python3: C:/atmoa/toolchains/25.02.0/python/python.exe (found suitable version "3.10.11", minimum required is "3.10") found components: Interpreter
-- Cache files will be written to: C:\atmoa\zephyrproject/zephyr/.cache
-- Found west (found suitable version "1.3.0", minimum required is "0.14.0")
-- Board: ATMEVK-3330e-QN-7, qualifiers: ATM33xx-5/ns
Parsing D:/Project/zephyr/zephyrproject/zephyr/share/sysbuild/Kconfig
Loaded configuration 'C:\atmoa\zephyrproject/build/_sysbuild/empty.conf'
Merged configuration 'C:\atmoa\zephyrproject/build/_sysbuild/empty.conf'
Merged configuration 'C:\atmoa\zephyrproject/build/zephyr/misc/generated/extra_kconfig_options.conf'
Configuration saved to 'C:\atmoa\zephyrproject/build/zephyr/.config'
Kconfig header saved to 'C:\atmoa\zephyrproject/build/_sysbuild/autoconf.h'
--
   *************************
   * Running CMake for spe *
   *************************

6. [Windows] Install RDI driver if need

7. Program firmware to Atmosic device

west flash --skip-rebuild --device <DEVICE_ID> --jlink --fast_load