Events handlers in the Connectivity Chip

nRF5 SDK v15.0.0
Macros | Typedefs | Functions

Events handlers used to process high level events in the connectivity application. More...

Macros

#define SER_CONN_SCHED_QUEUE_SIZE 4u
#define STACK_EVENT_MAX_SIZE MAX( NRF_SDH_BLE_EVT_BUF_SIZE , NRF_SDH_ANT_EVT_BUF_SIZE )
#define SER_CONN_SCHED_MAX_EVENT_DATA_SIZE

Typedefs

typedef void(* ser_conn_on_no_mem_t )(void)
Prototype for function called when there is no free TX buffer and system is blocked.

Functions

void ser_conn_on_no_mem_handler_set ( ser_conn_on_no_mem_t handler)
A function for setting handler which should be called when serialization is blocked waiting for TX buffer. More...
void ser_conn_on_no_mem_handler (void)
A function called when TX buffer allocation failed. Serialization is always allocating TX buffer in main context expecting that it will be freed from interrupt context.
void ser_conn_hal_transport_event_handle ( ser_hal_transport_evt_t event)
A function for processing the HAL Transport layer events. More...
uint32_t ser_conn_rx_process (void)
A function to call the function to process a packet when it is fully received. More...
void ser_conn_ble_event_handle ( ble_evt_t const *p_ble_evt, void *p_context)
A function for processing BLE SoftDevice events. More...
void ser_conn_ant_event_handle ( ant_evt_t *p_ant_evt, void *p_context)
A function for processing ANT SoftDevice events. More...

Detailed Description

Events handlers used to process high level events in the connectivity application.

This file contains functions: processing the HAL Transport layer events, processing BLE SoftDevice events, starting processing received packets.

Macro Definition Documentation

#define SER_CONN_SCHED_MAX_EVENT_DATA_SIZE
Value:
(( CEIL_DIV (MAX( STACK_EVENT_MAX_SIZE , \
sizeof (uint32_t)), \
sizeof (uint32_t))) * \
sizeof (uint32_t))
#define SER_CONN_SCHED_QUEUE_SIZE   4u

Maximum number of events in the application scheduler queue.

#define STACK_EVENT_MAX_SIZE   MAX( NRF_SDH_BLE_EVT_BUF_SIZE , NRF_SDH_ANT_EVT_BUF_SIZE )

Maximum size of events data in the application scheduler queue aligned to 32 bits - this is size of the buffers of the SoftDevice handler, which stores events pulled from the SoftDevice.

Function Documentation

void ser_conn_ant_event_handle ( ant_evt_t * p_ant_evt ,
void * p_context
)

A function for processing ANT SoftDevice events.

ANT events are put into application scheduler queue to be processed at a later time.

Parameters
[in] p_ant_evt A pointer to a BLE event.
[in] p_context A parameter to the handler. Not used.
void ser_conn_ble_event_handle ( ble_evt_t const * p_ble_evt ,
void * p_context
)

A function for processing BLE SoftDevice events.

BLE events are put into application scheduler queue to be processed at a later time.

Parameters
[in] p_ble_evt A pointer to a BLE event.
[in] p_context A parameter to the handler. Not used.
void ser_conn_hal_transport_event_handle ( ser_hal_transport_evt_t event )

A function for processing the HAL Transport layer events.

Parameters
[in] event HAL Transport layer event.
void ser_conn_on_no_mem_handler_set ( ser_conn_on_no_mem_t handler )

A function for setting handler which should be called when serialization is blocked waiting for TX buffer.

Parameters
handler Handler to be called whenever serialization failed to allocate TX buffer
uint32_t ser_conn_rx_process ( void )

A function to call the function to process a packet when it is fully received.

Return values
NRF_SUCCESS Operation success.
NRF_ERROR_NULL Operation failure. NULL pointer supplied.
NRF_ERROR_INTERNAL Operation failure. Internal error ocurred.