Border Router#
This module includes functions to manage local network data with the OpenThread Border Router.
Typedefs#
Function pointer callback which is invoked when Network Data (local or leader) gets full.
Functions#
Provides a full or stable copy of the local Thread Network Data.
Add a border router configuration to the local network data.
Remove a border router configuration from the local network data.
Gets the next On Mesh Prefix in the local Network Data.
Add an external route configuration to the local network data.
Remove an external route configuration from the local network data.
Gets the next external route in the local Network Data.
Immediately register the local network data with the Leader.
Sets the callback to indicate when Network Data gets full.
Typedef Documentation#
otBorderRouterNetDataFullCallback#
typedef void(* otBorderRouterNetDataFullCallback) (void *aContext) )(void *aContext)
Function pointer callback which is invoked when Network Data (local or leader) gets full.
| [in] | aContext | A pointer to arbitrary context information. |
173 of file include/openthread/border_router.hFunction Documentation#
otBorderRouterGetNetData#
otError otBorderRouterGetNetData (otInstance * aInstance, bool aStable, uint8_t * aData, uint8_t * aDataLength)
Provides a full or stable copy of the local Thread Network Data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aStable | TRUE when copying the stable version, FALSE when copying the full version. |
| [out] | aData | A pointer to the data buffer. |
| [inout] | aDataLength | On entry, size of the data buffer pointed to by |
64 of file include/openthread/border_router.hotBorderRouterAddOnMeshPrefix#
otError otBorderRouterAddOnMeshPrefix (otInstance * aInstance, const otBorderRouterConfig * aConfig)
Add a border router configuration to the local network data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aConfig | A pointer to the border router configuration. |
See Also
79 of file include/openthread/border_router.hotBorderRouterRemoveOnMeshPrefix#
otError otBorderRouterRemoveOnMeshPrefix (otInstance * aInstance, const otIp6Prefix * aPrefix)
Remove a border router configuration from the local network data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aPrefix | A pointer to an IPv6 prefix. |
See Also
93 of file include/openthread/border_router.hotBorderRouterGetNextOnMeshPrefix#
otError otBorderRouterGetNextOnMeshPrefix (otInstance * aInstance, otNetworkDataIterator * aIterator, otBorderRouterConfig * aConfig)
Gets the next On Mesh Prefix in the local Network Data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [inout] | aIterator | A pointer to the Network Data iterator context. To get the first on-mesh entry it should be set to OT_NETWORK_DATA_ITERATOR_INIT. |
| [out] | aConfig | A pointer to the On Mesh Prefix information. |
106 of file include/openthread/border_router.hotBorderRouterAddRoute#
otError otBorderRouterAddRoute (otInstance * aInstance, const otExternalRouteConfig * aConfig)
Add an external route configuration to the local network data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aConfig | A pointer to the external route configuration. |
See Also
123 of file include/openthread/border_router.hotBorderRouterRemoveRoute#
otError otBorderRouterRemoveRoute (otInstance * aInstance, const otIp6Prefix * aPrefix)
Remove an external route configuration from the local network data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aPrefix | A pointer to an IPv6 prefix. |
See Also
137 of file include/openthread/border_router.hotBorderRouterGetNextRoute#
otError otBorderRouterGetNextRoute (otInstance * aInstance, otNetworkDataIterator * aIterator, otExternalRouteConfig * aConfig)
Gets the next external route in the local Network Data.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [inout] | aIterator | A pointer to the Network Data iterator context. To get the first external route entry it should be set to OT_NETWORK_DATA_ITERATOR_INIT. |
| [out] | aConfig | A pointer to the External Route information. |
150 of file include/openthread/border_router.hotBorderRouterRegister#
otError otBorderRouterRegister (otInstance * aInstance)
Immediately register the local network data with the Leader.
| [in] | aInstance | A pointer to an OpenThread instance. |
See Also
166 of file include/openthread/border_router.hotBorderRouterSetNetDataFullCallback#
void otBorderRouterSetNetDataFullCallback (otInstance * aInstance, otBorderRouterNetDataFullCallback aCallback, void * aContext)
Sets the callback to indicate when Network Data gets full.
| [in] | aInstance | A pointer to an OpenThread instance. |
| [in] | aCallback | The callback. |
| [in] | aContext | A pointer to arbitrary context information used with |
Requires OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL.
The callback is invoked whenever:
The device is acting as a leader and receives a Network Data registration from a Border Router (BR) that it cannot add to Network Data (running out of space).
The device is acting as a BR and new entries cannot be added to its local Network Data.
The device is acting as a BR and tries to register its local Network Data entries with the leader, but determines that its local entries will not fit.
191 of file include/openthread/border_router.h