Provides interface for user-defined trace handles on important network events
Data Structures | |
struct | EMBENET_TRACE_LinkLayerTelemetry |
struct | EMBENET_NODE_TraceHandlers |
structure describing all callbacks, set to NULL to deactivate More... | |
typedef void(* EMBENET_TRACE_Started) (uint64_t eui) |
Called immediately stack started.
[in] | eui | of node |
typedef void(* EMBENET_TRACE_Synchronized) (uint16_t panid) |
Called immediately after synchronization event.
[in] | panid | of the network, node has joined to. |
typedef void(* EMBENET_TRACE_Desynchronized) (void) |
Called immediately after desynchronization event.
typedef void(* EMBENET_TRACE_PacketNoAck) (uint64_t linkLocalDestinationEui, uint64_t destinationEui, uint8_t attempt) |
Called when transmission was not successful.
[in] | linkLocalDestinationEui | |
[in] | destinationEui | |
[in] | attempt | that was made |
typedef void(* EMBENET_TRACE_ManagedPacketNoAck) (uint64_t linkLocalDestinationEui) |
Called when managed transmission was not successful.
[in] | linkLocalDestinationEui |
typedef void(* EMBENET_TRACE_PacketNotDelivered) (uint64_t linkLocalDestinationEui, uint64_t destinationEui) |
Called when all transmission attempts were unsuccessful and packet was discarded.
[in] | linkLocalDestinationEui | |
[in] | destinationEui |
typedef void(* EMBENET_TRACE_Joined) (uint64_t parentEui) |
Called after connection to target parent is established:
[in] | parentEui |
typedef void(* EMBENET_TRACE_SyncCorrection) (int32_t us) |
Called every time node synchronizes to it's time source.
[in] | us | - time correction expressed in microseconds |
typedef void(* EMBENET_TRACE_ParentSelected) (uint64_t parentEui) |
Called after parent is selected as new parent.
[in] | parentEui | (native endianess) |
typedef void(* EMBENET_TRACE_ParentLost) (uint64_t parentEui) |
Called after parent is considered lost:
[in] | parentEui |
typedef void(* EMBENET_TRACE_NeighborAdded) (uint64_t neighborEui, int8_t rssi) |
Called every time a new neighbor is added to node's registry.
[in] | neighborEui | |
[in] | rssi | averaged |
typedef void(* EMBENET_TRACE_NeighborRemoved) (uint64_t neighborEui) |
Called every time a new neighbor is removed from node's registry. Neighbor may be removed due to long inactivity time or lack of space in registry.
[in] | neighborEui |
typedef void(* EMBENET_TRACE_RankUpdate) (uint16_t rank) |
Called every time node's rank in changed.
[in] | rank | value. |
typedef void(* EMBENET_TRACE_QueueLength) (size_t length) |
Called every time a packet count in packet buffer is changed.
[in] | length |
typedef void(* EMBENET_TRACE_EnmsStatusSent) (void) |
Called every time the ENSM Status Indication Packet was sent.
typedef void(* EMBENET_TRACE_RadioActivity) (bool active) |
Called every time radio is toggled from sleep to active state.
active | - true if radio is turned on, otherwise false |
typedef void(* EMBENET_TRACE_SlotStart) (void) |
Called every time radio is toggled from sleep to active state.
typedef void(* EMBENET_TRACE_LinkLayerEvent) (const EMBENET_TRACE_LinkLayerTelemetry *linkLayerTelemetry) |
Called when frame is TXed or RXed.
void EMBENET_NODE_SetTraceHandlers | ( | const EMBENET_NODE_TraceHandlers * | traceHandlers | ) |
Connects trace handlers.
traceHandlers | EMBENET_NODE_TraceHandlers |
Any question or remarks? Just write us a message!
Feel free to get in touch