Basic RIOT integration of NimBLE, including e.g. More...

Detailed Description

Basic RIOT integration of NimBLE, including e.g.

stack configuration and (auto)initialization code

Files
file	nimble_riot.h
	RIOT specific glue functions for integrating NimBLE.

Macros
#define	NIMBLE_CONTROLLER_PRIO (0)
	Priority used for NimBLE's controller thread.

#define	NIMBLE_CONTROLLER_STACKSIZE (THREAD_STACKSIZE_DEFAULT)
	Stacksize used for NimBLE's controller thread.

#define	NIMBLE_HOST_PRIO (THREAD_PRIORITY_MAIN - 2)
	Priority used for NimBLE's host thread.

#define	NIMBLE_HOST_STACKSIZE (THREAD_STACKSIZE_DEFAULT)
	Stacksize used for NimBLE's host thread.

Enumerations
enum	nimble_phy_t { NIMBLE_PHY_INVALID , NIMBLE_PHY_1M }
	BLE PHY modes. More...

Functions
void	nimble_riot_init (void)
	Setup and run NimBLE's controller and host threads.

Variables
uint8_t	nimble_riot_own_addr_type
	Export our own address type for later usage.

bool	nimble_port_initialized
	Indicates whether Setup NimBLE's controller has been initialized.

Macro Definition Documentation

◆ NIMBLE_CONTROLLER_PRIO

#define NIMBLE_CONTROLLER_PRIO (0)

Priority used for NimBLE's controller thread.

This should be as high as possible.

Definition at line 38 of file nimble_riot.h.

◆ NIMBLE_CONTROLLER_STACKSIZE

#define NIMBLE_CONTROLLER_STACKSIZE (THREAD_STACKSIZE_DEFAULT)

Stacksize used for NimBLE's controller thread.

Definition at line 45 of file nimble_riot.h.

◆ NIMBLE_HOST_PRIO

#define NIMBLE_HOST_PRIO (THREAD_PRIORITY_MAIN - 2)

Priority used for NimBLE's host thread.

Definition at line 59 of file nimble_riot.h.

◆ NIMBLE_HOST_STACKSIZE

#define NIMBLE_HOST_STACKSIZE (THREAD_STACKSIZE_DEFAULT)

Stacksize used for NimBLE's host thread.

Definition at line 67 of file nimble_riot.h.

Enumeration Type Documentation

◆ nimble_phy_t

enum nimble_phy_t

BLE PHY modes.

Enumerator
NIMBLE_PHY_INVALID	PHY mode invalid.
NIMBLE_PHY_1M	legacy 1Mbit PHY mode (always supported)

Definition at line 73 of file nimble_riot.h.

Variable Documentation

◆ nimble_port_initialized

bool nimble_port_initialized

extern

Indicates whether Setup NimBLE's controller has been initialized.

nimble_port_initialized is false by default and is set to true as soon as nimble_port_init has been called by nimble_riot_init, i.e. that the NimBLE stack has been initialized.

The variable can be used to decide whether events from the low-level BLE controller driver should be forwarded to the NimBLE stack. It is necessary to avoid crashes in the case that the higher-prioritized thread of the low-level BLE controller driver starts sending events to the host before the NimBLE stack has been initialized by the lower-prioritized host thread.

Detailed Description

Files

Macros

Enumerations

Functions

Variables