Kenji Arai / mbed-os_TYBLE16

Dependents:   TYBLE16_simple_data_logger TYBLE16_MP3_Air

Embed: (wiki syntax)

« Back to documentation index

lorawan_app_callbacks_t Struct Reference

lorawan_app_callbacks_t Struct Reference

Stack level callback functions. More...

#include <lorawan_types.h>

Data Fields

mbed::Callback< void(lorawan_event_t)> events
 Mandatory.
mbed::Callback< void(uint8_t,
uint8_t)> 
link_check_resp
 This callback is optional.
mbed::Callback< uint8_t(void)> battery_level
 This callback is optional.

Detailed Description

Stack level callback functions.

'lorawan_app_callbacks_t' is a structure that holds pointers to the application provided methods which are needed to be called in response to certain requests. The structure is default constructed to set all pointers to NULL. So if the user does not provide the pointer, a response will not be posted. However, the 'lorawan_events' callback is mandatory to be provided as it contains essential events.

A link check request could be sent whenever the device tries to send a message and if the network server responds with a link check response, the stack notifies the application be calling the appropriate method set using 'link_check_resp' callback. The result is thus transported to the application via callback function provided.

'battery_level' callback goes in the down direction, i.e., it informs the stack about the battery level by calling a function provided by the upper layers.

Definition at line 247 of file lorawan_types.h.


Field Documentation

mbed::Callback<uint8_t(void)> battery_level

This callback is optional.

If the callback is not set, the stack returns 255 to gateway.

Battery level return value must follow the specification for DevStatusAns MAC command:

0 The end-device is connected to an external power source 1 - 254 The battery level, 1 being at minimum and 254 being at maximum 255 The end-device was not able to measure the battery level.

Definition at line 271 of file lorawan_types.h.

mbed::Callback<void(lorawan_event_t)> events

Mandatory.

Event Callback must be provided

Definition at line 251 of file lorawan_types.h.

mbed::Callback<void(uint8_t, uint8_t)> link_check_resp

This callback is optional.

The first parameter to the callback function is the demodulation margin, and the second parameter is the number of gateways that successfully received the last request.

Definition at line 259 of file lorawan_types.h.