Source Routing APIs#
This file provides routines pertaining to source routing. Source routing is only available for routers and coordinators that have the source routing library included.
See source-route.h for more information.
Variables#
To configure non trust center node to assume a concentrator type of the trust center it join to, until it receive many-to-one route request from the trust center. For the trust center node, concentrator type is configured from the concentrator plugin. The stack by default assumes trust center be a low RAM concentrator that make other devices send route record to the trust center even without receiving a many-to-one route request. The assumed concentrator type can be changed by setting appropriate config value to emberAssumedTrustCenterConcentratorType.
Functions#
initializing the node to act as a concentrator with:
Returns the number of used entries in the source route table.
Returns the size of the source route table.
Returns the number of bytes needed in a packet for source routing. Since each hop consumes 2 bytes in the packet, this routine calculates the total number of bytes needed based on number of hops to reach the destination.
sets source route discovery mode(MTORR scheduling mode) to on/off/reschedule
Legacy API Starts periodic many-to-one route discovery. Periodic discovery is started by default on bootup, but this function may be used if discovery has been stopped by a call to emberConcentratorStopDiscovery().
Legacy API. Stops periodic many-to-one route discovery.
Legacy API. Notes when a packet fails to deliver.
Legacy API. Notes when a route error has occurred.
Variable Documentation#
emberAssumedTrustCenterConcentratorType#
EmberAssumeTrustCenterConcentratorType emberAssumedTrustCenterConcentratorType
To configure non trust center node to assume a concentrator type of the trust center it join to, until it receive many-to-one route request from the trust center. For the trust center node, concentrator type is configured from the concentrator plugin. The stack by default assumes trust center be a low RAM concentrator that make other devices send route record to the trust center even without receiving a many-to-one route request. The assumed concentrator type can be changed by setting appropriate config value to emberAssumedTrustCenterConcentratorType.
106 of file stack/include/source-route.hFunction Documentation#
emberSetConcentrator#
EmberStatus emberSetConcentrator (bool on, uint16_t concentratorTypeParam, uint16_t minTime, uint16_t maxTime, uint8_t routeErrorThresholdParam, uint8_t deliveryFailureThresholdParam, uint8_t maxHopsParam)
initializing the node to act as a concentrator with:
| N/A | on | |
| N/A | concentratorTypeParam | |
| N/A | minTime | |
| N/A | maxTime | |
| N/A | routeErrorThresholdParam | |
| N/A | deliveryFailureThresholdParam | |
| N/A | maxHopsParam |
@params discovery mode on/off concentratorTypeParam min time between MTORRs max time between MTORRs threshodl to react to route error message threshodl to react to delivery failures max number of hops for MTORR
42 of file stack/include/source-route.hemberGetSourceRouteTableFilledSize#
uint8_t emberGetSourceRouteTableFilledSize (void)
Returns the number of used entries in the source route table.
| N/A |
52 of file stack/include/source-route.hemberGetSourceRouteTableTotalSize#
uint8_t emberGetSourceRouteTableTotalSize (void)
Returns the size of the source route table.
| N/A |
56 of file stack/include/source-route.hemberGetSourceRouteOverhead#
uint8_t emberGetSourceRouteOverhead (EmberNodeId destination)
Returns the number of bytes needed in a packet for source routing. Since each hop consumes 2 bytes in the packet, this routine calculates the total number of bytes needed based on number of hops to reach the destination.
| N/A | destination | The destination's short address. |
Returns
uint8_t The number of bytes needed for source routing in a packet.
64 of file stack/include/source-route.hemberSetSourceRouteDiscoveryMode#
uint32_t emberSetSourceRouteDiscoveryMode (EmberSourceRouteDiscoveryMode mode)
sets source route discovery mode(MTORR scheduling mode) to on/off/reschedule
| N/A | mode |
@params: mode: EMBER_SOURCE_ROUTE_DISCOVERY_OFF = 0x00, EMBER_SOURCE_ROUTE_DISCOVERY_ON = 0x01, EMBER_SOURCE_ROUTE_DISCOVERY_RESCHEDULE = 0x02,
74 of file stack/include/source-route.hemberConcentratorStartDiscovery#
void emberConcentratorStartDiscovery (void)
Legacy API Starts periodic many-to-one route discovery. Periodic discovery is started by default on bootup, but this function may be used if discovery has been stopped by a call to emberConcentratorStopDiscovery().
| N/A |
83 of file stack/include/source-route.hemberConcentratorStopDiscovery#
void emberConcentratorStopDiscovery (void)
Legacy API. Stops periodic many-to-one route discovery.
| N/A |
86 of file stack/include/source-route.hemberConcentratorNoteDeliveryFailure#
void emberConcentratorNoteDeliveryFailure (EmberOutgoingMessageType type, EmberStatus status)
Legacy API. Notes when a packet fails to deliver.
| N/A | type | |
| N/A | status |
90 of file stack/include/source-route.hemberConcentratorNoteRouteError#
void emberConcentratorNoteRouteError (EmberStatus status, EmberNodeId nodeId)
Legacy API. Notes when a route error has occurred.
| N/A | status | |
| N/A | nodeId |
94 of file stack/include/source-route.h