# nsx-ble

<!-- nsx:facts -->
Optional app-facing Bluetooth LE convenience API. Ports the legacy neuralSPOT ns-ble wrapper onto NSX, providing simple "define a service + read/write/notify characteristics with callbacks" bring-up on top of the Cordio host stack (nsx-cordio).

- 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, ble_peripheral, gatt_server, ns_ble_api, sdk_component
<!-- /nsx:facts -->

## Add it to an app

```bash
nsx module add nsx-ble
```

## Capabilities

- bluetooth_le
- ble_peripheral
- gatt_server
- ns_ble_api
- sdk_component

## Use cases

- stand up a single BLE GATT service with read/write/notify characteristics
- port existing neuralSPOT ns-ble applications to NSX with minimal source changes
- drive the Cordio stack from a FreeRTOS dispatcher task

## Requires

- [`nsx-core`](https://ambiqai.github.io/neuralspotx/modules/nsx-core/)
- [`nsx-cordio`](https://ambiqai.github.io/neuralspotx/modules/nsx-cordio/)
- [`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`, `ns_ble`, `gatt`, `characteristic`, `notify`

## Source

| Field | Value |
| --- | --- |
| Type | Backend specific |
| Version | 5.2.26 |
| Project | nsx-ambiq-sdk |
| Revision | `v5.2.26` |
| Manifest | `modules/nsx-ble/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/).