See :download:`Download the extension for Linux/Windows here <_downloads/Atmosic-openair-1.7.3.vsix>`.

See :download:`Download the extension for MAC here <_downloads/Atmosic-openair-1.7.3.vsix>`.

Vscode Plugin
#############

Installation
************

1. Select View->Extensions

.. figure::  readme_images/init_1.png
     :align: center

.. raw:: html

   <br><br>
2. Click on 3 dots to the right and select “Install from VSIX…”

.. figure::  readme_images/init_2.png
     :align: center

.. raw:: html

   <br><br>

.. note::

        Additionally, please install the following extensions individually for macOS:


        1. C/C++ Extension Pack : `Download <https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools-extension-pack>`_

        2. Cortex-Debug : `Download <https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug>`_

        3. Serial Monitor : `Download <https://learn.microsoft.com/en-us/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio>`_

Creating First Workspace
************************

1. Go to Source control tab on the left and click on “Open Folder” and
select folder or create new folder if needed to place your workspace

.. figure::  readme_images/init_3.png
     :align: center


.. raw:: html

   <br><br>

2. Select “Zephyr IDE” plugin icon (last icon on left side tab) and
click on “Workspace”

.. figure::  readme_images/init_4.png
     :align: center

.. raw:: html

   <br><br>

3. Select “Initialize Workspace” and pick “Atmosic OpenAir” from
dropdown menu (Select Default as version on next dropdown menu)

.. figure::  readme_images/init_5.png
     :align: center

.. raw:: html

   <br><br>

4. You should see successful installation message like below

.. figure::  readme_images/init_6.png
     :align: center

.. raw:: html

   <br><br>

Creating First Project
**********************

1. Select **Folder+** icon in PROJECTS tab to create first project

.. figure::  readme_images/build_1.png
     :align: center
.. raw:: html

   <br><br>

2. Select project from dropdown list (e.g. Peripheral project below)

.. figure::  readme_images/build_2.png
     :align: center

.. raw:: html

   <br><br>

3. Now click on “+ Add Build” to specify platform.(Supports ATM33/e and
ATM34/e series)

.. figure::  readme_images/build_3.png
     :align: center

.. raw:: html

   <br><br>

4. Select the "BLE stack type" for the ATM33 series and proceed by
accepting the build arguments that appear in the subsequent steps.

.. figure::  readme_images/build_4.png
     :align: center

.. raw:: html

   <br><br>

Building The Project
********************

1. Click on “Build Pristine” to complete build process

.. figure::  readme_images/build_5.png
     :align: center

.. raw:: html

   <br><br>

Flashing The Project
********************

1. Enter the board's JLINK serial number in the 'Add Runner Arguments'
field.

.. figure::  readme_images/flash_1.png
     :align: center

.. raw:: html

   <br><br>

2. Click “Flash MCUboot” to flash the MCUboot and click “Flash
Application” to flash the selected application.

.. figure::  readme_images/flash_2.png
     :align: center

.. raw:: html

   <br><br>

3. Click “Flash BLE Controller” to flash the BLE stack ELF file (this
option is visible only when "Fixed BLE Controller" is selected for
the ATM33 series).

.. figure::  readme_images/flash_3.png
     :align: center

.. raw:: html

   <br><br>

4. Open the Serial Monitor, select the port, and click 'Start
Monitoring' to view the console logs.

.. figure::  readme_images/flash_4.png
     :align: center

.. raw:: html

   <br><br>

Debug The Project
*****************

1. Open “Run and Debug”, click on “create a launch.json” and choose
“Atmosic IDE” while selecting the debugger.

.. figure::  readme_images/debug_1.png
     :align: center

.. raw:: html

   <br><br>

2. To start debugging, click the 'Debug' button to launch both the debug
server and the GDB client.

.. figure::  readme_images/debug_2.png
     :align: center

.. raw:: html

   <br><br>

3. Use the UI in VS Code to step through your code using controls like
Step Over, Step Into, Step Out, Reset Device, and Restart.

.. figure::  readme_images/debug_3.png
     :align: center

.. raw:: html

   <br><br>

4. This IDE supports debugging of multiple binaries. As a result, the
execution pointer initially starts at the main.c of the SPE.
If you want to debug the application code, set a **breakpoint**
in the application's main.c file and press **Step Over** to
switch context and begin stepping through the application's main
function.


Debug The Threads
*****************

1. Enable CONFIG_DEBUG_THREAD_INFO in the prj.conf file of the sample.
2. Click the Debug button to start the debugging session. The active threads will appear under the CALL STACK section.

.. figure::  readme_images/debug_4.png
     :align: center

.. raw:: html

   <br><br>

Remote Development via SSH Plugin
*********************************
Install the `Remote - SSH plugin <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`_ from the marketplace.
.Establish a connection to the remote system using its IP address and password.Once connected, create a directory on the remote machine for your project. Access the created folder to set up your firmware workspace.

You can perform build, flash, debug operations through this plugin.

.. figure::  readme_images/ssh_1.png
     :align: center

.. raw:: html

   <br><br>
.. figure::  readme_images/ssh_2.png
     :align: center

.. raw:: html

   <br><br>