# nsx-cordio

<!-- nsx:facts -->
Optional Cordio/WSF Bluetooth LE host stack. Vendors the AmbiqSuite third_party Cordio stack (ble-host + ble-profiles + WSF) at AmbiqSuite stable-2026.06.18 (caaf5af860) plus NSX edits, and builds it from source for the active SoC's BLE transport. Low-level stack only; the app-facing convenience API lives in nsx-ble.

- Type: Backend specific
- Version: 5.2.26
- Project: nsx-ambiq-sdk
- Revision: v5.2.26
- Source: https://github.com/AmbiqAI/nsx-ambiq-sdk/tree/v5.2.26
- Capabilities: bluetooth_le, cordio, wsf, ble_host_stack, sdk_component
<!-- /nsx:facts -->

## Add it to an app

```bash
nsx module add nsx-cordio
```

## Capabilities

- bluetooth_le
- cordio
- wsf
- ble_host_stack
- sdk_component

## Use cases

- provide the Cordio BLE host stack (HCI/DM/L2CAP/ATT/SMP/GATT) to higher-level BLE modules
- build the WSF FreeRTOS port for the active SoC
- supply the SoC-specific BLE HCI transport driver (Cooper on Apollo4P, integrated BLE on Apollo3/Apollo3P, EM9305 on Apollo510B)

## Requires

- [`nsx-ambiqsuite`](https://ambiqai.github.io/neuralspotx/modules/nsx-ambiqsuite/)
- [`nsx-ambiq-hal`](https://ambiqai.github.io/neuralspotx/modules/nsx-ambiq-hal/)
- [`nsx-ambiq-bsp`](https://ambiqai.github.io/neuralspotx/modules/nsx-ambiq-bsp/)
- [`nsx-freertos`](https://ambiqai.github.io/neuralspotx/modules/nsx-freertos/)

## Compatibility

:::note[How compatibility is declared]
The boards, SoCs and toolchains listed here are the ones the module manifest declares.
That is the module author's statement of intent, not evidence from hardware. Confirm on your
own target before you depend on it.
:::

| Kind | Declared |
| --- | --- |
| Boards | apollo3_evb, apollo3p_evb, apollo510b_evb, apollo4p_blue_kbr_evb, apollo4p_blue_kxr_evb |
| SoCs | apollo3, apollo3p, apollo510b, apollo4p |
| Toolchains | arm-none-eabi-gcc, atfe, armclang |

## Agent keywords

`ble`, `bluetooth`, `cordio`, `wsf`, `cooper`, `apollo3`, `apollo3p`, `apollo4p`, `apollo510b`, `em9305`

## Source

| Field | Value |
| --- | --- |
| Type | Backend specific |
| Version | 5.2.26 |
| Project | nsx-ambiq-sdk |
| Revision | `v5.2.26` |
| Manifest | `modules/nsx-cordio/nsx-module.yaml` |
| Repository | [nsx-ambiq-sdk](https://github.com/AmbiqAI/nsx-ambiq-sdk/tree/v5.2.26) |

Back to the [module catalog](https://ambiqai.github.io/neuralspotx/modules/catalog/).
