IPv6 Addressing Utilities.
Data Structures |
|
struct | EmberDnsResponse |
Structure for returning information from a DNS lookup. A structure is used to make it easier to add additional values.
|
Macros |
|
#define | EMBER_MAX_IPV6_ADDRESS_COUNT 10 |
The maximum number of IPv6 addresses configured for the device. See
emberGetLocalIpAddress
.
|
|
#define | EMBER_MAX_IPV6_GLOBAL_ADDRESS_COUNT ( EMBER_MAX_IPV6_ADDRESS_COUNT - 2) |
#define | EMBER_MAX_IPV6_EXTERNAL_ROUTE_COUNT ( EMBER_MAX_IPV6_ADDRESS_COUNT - 2) |
#define | EMBER_MAX_LIFETIME_DELAY_SEC (( HALF_MAX_INT32U_VALUE - 1) / 1000) |
We enforce this limit to avoid overflow when converting lifetimes from seconds to milliseconds.
|
|
#define | EMBER_MIN_PREFERRED_LIFETIME_SEC 1800 |
There should be at least half an hour of preferred lifetime remaining to advertise a DHCP server.
|
|
#define | EMBER_MIN_VALID_LIFETIME_SEC 60 |
Renew when we are down to one minute of valid lifetime.
|
|
#define | EMBER_MAX_DNS_NAME_LENGTH 128 |
The maximum length of a domain name that may be passed to
emberDnsLookup()
.
|
|
#define | EMBER_MAX_DNS_QUERY_APP_DATA_LENGTH 64 |
The maximum number of bytes of application data that may be passed to
emberDnsLookup()
.
|
Typedefs |
|
typedef uint16_t | EmberBorderRouterTlvFlag |
typedef uint8_t | EmberDefaultRouteTlvFlag |
typedef uint8_t | LocalServerFlag |
typedef void(* | EmberDnsResponseHandler ) ( EmberDnsLookupStatus status, const uint8_t *domainName, uint8_t domainNameLength, const EmberDnsResponse *response, void *applicationData, uint16_t applicationDataLength) |
Type definition for callback handlers for DNS responses.
|
Functions |
|
bool | emberGetLocalIpAddress (uint8_t index, EmberIpv6Address *address) |
This function fetches one of the device IPv6 addresses into the supplied pointer. Since there may be multiple addresses, an index argument between 0 and
EMBER_MAX_IPV6_ADDRESS_COUNT
must be supplied.
|
|
void | emberGetRoutingLocator (void) |
This function fetches the Thread Routing Locator (RLOC).
|
|
void | emberGetRoutingLocatorReturn (const EmberIpv6Address *rloc) |
This function provides the result of a call to
emberGetRoutingLocator
.
|
|
void | emberSetLocalNetworkData (const uint8_t *networkData, uint16_t length) |
Sets the Network Data that describes the local node's Border Router and server capabilities. This is passed a set of Network Data TLVs that may include Prefix, Has Route, Border Router, Service and Server TLVS.
|
|
void | emberSetLocalNetworkDataReturn ( EmberStatus status, uint16_t length) |
Provides the result of a call to ::emberSetServerNetworkData.
|
|
void | emberConfigureGateway ( EmberBorderRouterTlvFlag borderRouterFlags, bool isStable, const uint8_t *prefix, const uint8_t prefixLengthInBits, uint8_t domainId, uint32_t preferredLifetime, uint32_t validLifetime) |
This function configures the border router behavior, such as whether this device has a default route to the Internet, and whether it have a prefix that can be used by network devices to configure routable addresses.
|
|
void | emberConfigureGatewayReturn ( EmberStatus status) |
This function provides the result of a call to
emberConfigureGateway
.
|
|
void | emberSetNdData (const uint8_t *data, uint16_t length) |
void | emberSetNdDataReturn ( EmberStatus status, uint16_t length) |
This function provides the result of a call to
emberSetNdData
.
|
|
void | emberConfigureExternalRoute ( EmberDefaultRouteTlvFlag extRouteFlags, bool isStable, const uint8_t *extRoutePrefix, uint8_t extRoutePrefixLengthInBits, uint8_t extRouteDomainId) |
This function defines an external route set, a route for a Thread network IPv6 packet that must traverse a border router and be forwarded to an exterior network.
|
|
void | emberConfigureExternalRouteReturn ( EmberStatus status) |
This function provides the result of a call to
emberConfigureExternalRoute
.
|
|
void | emberAddressConfigurationChangeHandler (const EmberIpv6Address *address, uint32_t preferredLifetime, uint32_t validLifetime, uint8_t addressFlags) |
This function is called when a new address is configured on the application.
|
|
void | emberGetGlobalPrefixes (void) |
This function returns the list of global prefixes that we know about.
|
|
void | emberGetGlobalPrefixReturn (uint8_t flags, bool isStable, const uint8_t *prefix, uint8_t prefixLengthInBits, uint8_t domainId, uint32_t preferredLifetime, uint32_t validLifetime) |
This function provides the result of a call to ::emberGetGlobalPrefix.
|
|
void | emberDhcpServerChangeHandler (const uint8_t *prefix, uint8_t prefixLengthInBits, bool available) |
This function is called when the stack knows about a new dhcp server or if a dhcp server has become unavailable.
|
|
void | emberRequestDhcpAddress (const uint8_t *prefix, uint8_t prefixLengthInBits) |
The application can choose to request a new DHCP address when it is informed via
emberDhcpServerChangeHandler
of an available DHCP server.
|
|
void | emberRequestDhcpAddressReturn ( EmberStatus status, const uint8_t *prefix, uint8_t prefixLengthInBits) |
This function provides the result of a call to
emberRequestDhcpAddress
.
|
|
void | emberSlaacServerChangeHandler (const uint8_t *prefix, uint8_t prefixLengthInBits, bool available) |
This function is called when the stack knows about a new SLAAC prefix or if a SLAAC server has become unavailable.
|
|
void | emberRequestSlaacAddress (const uint8_t *prefix, uint8_t prefixLengthInBits) |
The application can choose to request a new SLAAC address when it is informed via
emberSlaacServerChangeHandler
of an available SLAAC prefix.
|
|
void | emberRequestSlaacAddressReturn ( EmberStatus status, const uint8_t *prefix, uint8_t prefixLengthInBits) |
This function provides the result of a call to
emberRequestSlaacAddress
.
|
|
void | emberGetGlobalAddresses (const uint8_t *prefix, uint8_t prefixLengthInBits) |
This function returns the list of global addresses configured on this device.
|
|
void | emberGetGlobalAddressReturn (const EmberIpv6Address *address, uint32_t preferredLifetime, uint32_t validLifetime, uint8_t addressFlags) |
This function provides the result of a call to
emberGetGlobalAddresses
.
|
|
void | emberResignGlobalAddress (const EmberIpv6Address *address) |
This function resigns this IPv6 global address from this node. If this is a DHCP address, then the server is informed about it. If it is a SLAAC address, we remove it locally.
|
|
void | emberResignGlobalAddressReturn ( EmberStatus status) |
This function provides the result of a call to
emberResignGlobalAddress()
.
|
|
void | emberExternalRouteChangeHandler (const uint8_t *prefix, uint8_t prefixLengthInBits, bool available) |
This function is called when the stack knows about a border router that has an external route to a prefix.
|
|
void | emberNetworkDataChangeHandler (const uint8_t *networkData, uint16_t length) |
This function is called when the stack receives new Thread Network Data. The networkData argument may be NULL, in which case
emberGetNetworkData
can be used to obtain the new Thread Network Data.
|
|
void | emberGetNetworkData (uint8_t *networkDataBuffer, uint16_t bufferLength) |
This function is called to obtain the current Thread Network Data.
|
|
void | emberGetNetworkDataReturn ( EmberStatus status, uint8_t *networkData, uint16_t bufferLength) |
This function provides the result of a call to
emberGetNetworkData
.
|
|
EmberStatus | emberDnsLookup (const uint8_t *domainName, uint8_t domainNameLength, const uint8_t *prefix64, EmberDnsResponseHandler responseHandler, uint8_t *appData, uint16_t appDataLength) |
This function initiates a DNS name lookup.
|
Detailed Description
See
network-management.h
for source code.
Macro Definition Documentation
#define EMBER_MAX_DNS_NAME_LENGTH 128 |
#define EMBER_MAX_DNS_QUERY_APP_DATA_LENGTH 64 |
#define EMBER_MAX_IPV6_ADDRESS_COUNT 10 |
#define EMBER_MAX_IPV6_EXTERNAL_ROUTE_COUNT ( EMBER_MAX_IPV6_ADDRESS_COUNT - 2) |
#define EMBER_MAX_IPV6_GLOBAL_ADDRESS_COUNT ( EMBER_MAX_IPV6_ADDRESS_COUNT - 2) |
#define EMBER_MAX_LIFETIME_DELAY_SEC (( HALF_MAX_INT32U_VALUE - 1) / 1000) |
#define EMBER_MIN_PREFERRED_LIFETIME_SEC 1800 |
#define EMBER_MIN_VALID_LIFETIME_SEC 60 |
Typedef Documentation
typedef uint16_t EmberBorderRouterTlvFlag |
typedef uint8_t EmberDefaultRouteTlvFlag |
typedef void(* EmberDnsResponseHandler) ( EmberDnsLookupStatus status, const uint8_t *domainName, uint8_t domainNameLength, const EmberDnsResponse *response, void *applicationData, uint16_t applicationDataLength) |
- Parameters
-
status
A EmberDnsLookupSatus indicating success or failure. domainName
The name that was looked up. domainNameLength
Length of domainName in bytes. response
Response information, NULL if no response was received. applicationData
Application data that was passed to emberDnsLookup . applicationDataLength
Length of applicationData in bytes.
typedef uint8_t LocalServerFlag |
Enumeration Type Documentation
enum EmberDnsLookupStatus |
enum LocalServerFlag_e |
The EMBER_GLOBAL_ADDRESS_AM_ flags are set for a border router that is supplying prefixes.
The rest of the EMBER_GLOBAL_ADDRESS_ flags are set for prefixes that have been administered on other devices.
EMBER_LOCAL_ADDRESS is supplied if this a Thread mesh-local or link-local IPv6 address. No other flags are set in this case.
Function Documentation
void emberAddressConfigurationChangeHandler | ( | const EmberIpv6Address * |
address,
|
uint32_t |
preferredLifetime,
|
||
uint32_t |
validLifetime,
|
||
uint8_t |
addressFlags
|
||
) |
If addressFlags is EMBER_LOCAL_ADDRESS, it means that the address configured is a Thread-local address.
Otherwise, it means that the address assigned is a global address (DHCP or SLAAC).
In either case, if the valid lifetime is zero, then the address is no longer available.
- Parameters
-
address
the address preferredLifetime
the preferred lifetime of the address (in seconds) validLifetime
the valid lifetime of the address (in seconds) addressFlags
address configuration flags (see LocalServerFlag_e)
This function is called when a new address is configured on the application.
If addressFlags is EMBER_LOCAL_ADDRESS, it means that the address configured is a Thread-local address.
Otherwise, it means that the address assigned is a global address (DHCP or SLAAC).
In either case, if the valid lifetime is zero, then the address is no longer available.
- Parameters
-
address
the address preferredLifetime
the preferred lifetime of the address (in seconds) validLifetime
the valid lifetime of the address (in seconds) addressFlags
address configuration flags (see LocalServerFlag_e)
void emberConfigureExternalRoute | ( | EmberDefaultRouteTlvFlag |
extRouteFlags,
|
bool |
isStable,
|
||
const uint8_t * |
extRoutePrefix,
|
||
uint8_t |
extRoutePrefixLengthInBits,
|
||
uint8_t |
extRouteDomainId
|
||
) |
Also de-configures an external route prefix (if it exists), if the extRoutePrefix and extRoutePrefixLengthInBits arguments are specified, and externalRouteFlags equals 0xFF.
- Parameters
-
extRouteFlags
-> See EmberDefaultRouteTlvFlag -> 0xFF to de-configure the specified route. isStable
If true, the route is expected to be available for at least MIN_STABLE_LIFETIME (168) hours. extRoutePrefix
Prefix for the route extRoutePrefixLengthInBits
Prefix length in bits extRouteDomainId
Domain ID
void emberConfigureExternalRouteReturn | ( | EmberStatus |
status
|
) |
This function provides the result of a call to emberConfigureExternalRoute .
void emberConfigureGateway | ( | EmberBorderRouterTlvFlag |
borderRouterFlags,
|
bool |
isStable,
|
||
const uint8_t * |
prefix,
|
||
const uint8_t |
prefixLengthInBits,
|
||
uint8_t |
domainId,
|
||
uint32_t |
preferredLifetime,
|
||
uint32_t |
validLifetime
|
||
) |
Also de-configures a border router prefix (if it exists), if the prefix and prefixLengthInBits are specified, and borderRouterFlags equals 0x00FF.
This triggers an address configuration change on the border router, and the application is informed of this by emberAddressConfigurationChangeHandler .
Note: If the application wants to manually configure an address and not have the stack create one, then it should pass in the entire IPv6 address (in bytes) for the prefix argument, with prefixLengthInBits as 128.
Examples:
SLAAC:
To configure a valid SLAAC border router, use: EMBER_BORDER_ROUTER_SLAAC_FLAG | EMBER_BORDER_ROUTER_DEFAULT_ROUTE_FLAG
The preference of the SLAAC prefix can be set using EMBER_BORDER_ROUTER_HIGH_PREFERENCE or EMBER_BORDER_ROUTER_LOW_PREFERENCE
NOTE: Preferred and valid lifetimes are ignored for SLAAC prefixes.
Configuring a SLAAC prefix will trigger emberAddressConfigurationChangeHandler on other nodes that may choose to configure a SLAAC address.
DHCP:
To configure a valid DHCP border router, use: EMBER_BORDER_ROUTER_DHCP_FLAG | EMBER_BORDER_ROUTER_DEFAULT_ROUTE_FLAG)
Note that this function only informs the network that this device is a DHCP server. The application is responsible for handling all messages send to the DHCP server port.
EMBER_BORDER_ROUTER_CONFIGURE_FLAG may be set if this border router is a DHCP server that supplies other configurationd data, such as the identity of DNS servers.
Configuring a DHCP prefix will trigger emberDhcpServerChangeHandler and other devices may choose to request a DHCP address by calling emberRequestDhcpAddress . If they get an address, they are informed via emberAddressConfigurationChangeHandler .
- Parameters
-
borderRouterFlags
-> See EmberBorderRouterTlvFlag -> 0x00FF to de-configure the specified prefix. isStable
If true, the border router that uses this prefix offers a route that is expected to be available for at least MIN_STABLE_LIFETIME (168) hours. prefix
Prefix for the border router. prefixLengthInBits
Prefix length in bits. domainId
Domain ID. preferredLifetime
Ignored; included for backward compatibility. validLifetime
Ignored; included for backward compatibility.
void emberConfigureGatewayReturn | ( | EmberStatus |
status
|
) |
This function provides the result of a call to emberConfigureGateway .
void emberDhcpServerChangeHandler | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits,
|
||
bool |
available
|
||
) |
"available" means the DHCP server can offer us an address if requested.
- Parameters
-
prefix
dhcp server prefix prefixLengthInBits
length in bits of the prefix available
whether this dhcp server is available
This function is called when the stack knows about a new dhcp server or if a dhcp server has become unavailable.
"available" means the DHCP server can offer us an address if requested.
- Parameters
-
prefix
dhcp server prefix prefixLengthInBits
length in bits of the prefix available
whether this dhcp server is available
EmberStatus emberDnsLookup | ( | const uint8_t * |
domainName,
|
uint8_t |
domainNameLength,
|
||
const uint8_t * |
prefix64,
|
||
EmberDnsResponseHandler |
responseHandler,
|
||
uint8_t * |
appData,
|
||
uint16_t |
appDataLength
|
||
) |
- Parameters
-
domainName
The name to be looked up. domainNameLength
Length of domainName in bytes. prefix64
A 64-bit prefix that specifies the domain in which to perform the lookup. A NULL value will perform a lookup in all available domains. responseHandler
Handler to which the response will be passed. applicationData
Application data to be passed to responseHandler. applicationDataLength
Length of applicationData in bytes.
void emberExternalRouteChangeHandler | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits,
|
||
bool |
available
|
||
) |
- Parameters
-
prefix
External route prefix prefixLengthInBits
Length in bits of the prefix available
Whether this external route is available.
This function is called when the stack knows about a border router that has an external route to a prefix.
- Parameters
-
prefix
external route prefix prefixLengthInBits
length in bits of the prefix available
whether this external route is available.
void emberGetGlobalAddresses | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits
|
||
) |
emberGetGlobalAddressReturn callbacks contain information about these global addresses.
Once all valid entries have been returned, an extra zeroed-out entry is returned to indicate completion.
- Parameters
-
prefix
Address prefix prefixLengthInBits
Length in bits of the prefix
void emberGetGlobalAddressReturn | ( | const EmberIpv6Address * |
address,
|
uint32_t |
preferredLifetime,
|
||
uint32_t |
validLifetime,
|
||
uint8_t |
addressFlags
|
||
) |
- Parameters
-
address
IPv6 global address preferredLifetime
Preferred lifetime (in seconds) validLifetime
Valid lifetime (in seconds) addressFlags
Address configuration flags (EMBER_GLOBAL_ADDRESS_*)
This function provides the result of a call to emberGetGlobalAddresses .
- Parameters
-
address
IPv6 global address preferredLifetime
Preferred lifetime (in seconds) validLifetime
Valid lifetime (in seconds) addressFlags
Address configuration flags (EMBER_GLOBAL_ADDRESS_*)
void emberGetGlobalPrefixes | ( | void |
|
) |
emberGetGlobalPrefixReturn callbacks contain information about the border routers.
Once all valid entries have been returned, an extra zeroed-out entry is returned to indicate completion.
void emberGetGlobalPrefixReturn | ( | uint8_t |
flags,
|
bool |
isStable,
|
||
const uint8_t * |
prefix,
|
||
uint8_t |
prefixLengthInBits,
|
||
uint8_t |
domainId,
|
||
uint32_t |
preferredLifetime,
|
||
uint32_t |
validLifetime
|
||
) |
- Parameters
-
flags
Please ignore this param, it is currently unused. (returns 0) isStable
Stable or temporary prefix prefix
Border router prefix prefixLengthInBits
Prefix length in bits domainId
Provisioning domain ID preferredLifetime
Preferred lifetime (in seconds) validLifetime
Valid lifetime (in seconds)
This function provides the result of a call to ::emberGetGlobalPrefix.
- Parameters
-
flags
Please ignore this param, it is currently unused. (returns 0) isStable
Stable or temporary prefix prefix
Border router prefix prefixLengthInBits
Prefix length in bits domainId
Provisioning domain ID preferredLifetime
Preferred lifetime (in seconds) validLifetime
Valid lifetime (in seconds)
bool emberGetLocalIpAddress | ( | uint8_t |
index,
|
EmberIpv6Address * |
address
|
||
) |
Index 0 contains the mesh-local 64 address of the node. Index 1 contains the link-local 64 address of the node. Index 2 and greater will return any global unicast addresses (GUAs) of this node.
- Returns
- false if no IPv6 address is stored at the given index.
void emberGetNetworkData | ( | uint8_t * |
networkDataBuffer,
|
uint16_t |
bufferLength
|
||
) |
- Parameters
-
networkDataBuffer
Network Data will be copied to here bufferLength
Length in bytes of the buffer
void emberGetNetworkDataReturn | ( | EmberStatus |
status,
|
uint8_t * |
networkData,
|
||
uint16_t |
bufferLength
|
||
) |
The status value is one of:
- EMBER_SUCCESS
- EMBER_NETWORK_DOWN
- EMBER_BAD_ARGUMENT (the supplied buffer was too small)
- Parameters
-
status
networkData
Location of the Network Data dataLength
Length in bytes of the Network Data
This function provides the result of a call to emberGetNetworkData .
The status value is one of:
- EMBER_SUCCESS
- EMBER_NETWORK_DOWN
- EMBER_BAD_ARGUMENT (the supplied buffer was too small)
- Parameters
-
status
networkData
location of the Network Data dataLength
length in bytes of the Network Data
void emberGetRoutingLocator | ( | void |
|
) |
A Thread Routing Locator (RLOC) is an IPv6 address that identifies the location of a Thread interface within a Thread partition. Thread devices use RLOCs internally for communicating control traffic.
NOTE: Using RLOCs for application messaging is NOT recommended since device identifiers used to build these RLOC addresses may change at any time based on the current network state. Please note that message delivery is not guaranteed when an RLOC address is used.
It is recommended that application developers use emberGetLocalIpAddress .
void emberGetRoutingLocatorReturn | ( | const EmberIpv6Address * |
rloc
|
) |
- Parameters
-
rloc
The Routing Locator as a full IPv6 address.
This function provides the result of a call to emberGetRoutingLocator .
- Parameters
-
rloc
The Routing Locator as a full IPv6 address.
void emberNetworkDataChangeHandler | ( | const uint8_t * |
networkData,
|
uint16_t |
length
|
||
) |
- Parameters
-
networkData
Network Data length
Length in bytes of the Network Data
This function is called when the stack receives new Thread Network Data. The networkData argument may be NULL, in which case emberGetNetworkData can be used to obtain the new Thread Network Data.
- Parameters
-
networkData
the Network Data length
length in bytes of the Network Data
void emberRequestDhcpAddress | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits
|
||
) |
The application can also call emberGetGlobalPrefixes to look for DHCP servers that it can request for an address.
When the address is obtained, the application is informed of this via emberAddressConfigurationChangeHandler .
- Parameters
-
prefix
dhcp server prefix prefixLengthInBits
length in bits of the prefix
void emberRequestDhcpAddressReturn | ( | EmberStatus |
status,
|
const uint8_t * |
prefix,
|
||
uint8_t |
prefixLengthInBits
|
||
) |
This call only indicates the status of the request (EMBER_ERR_FATAL if no DHCP server is found, and EMBER_SUCCESS otherwise). The assigned IPv6 address is returned via emberAddressConfigurationChangeHandler
- Parameters
-
status
Status of DHCP Address Request prefix
Prefix requested in emberRequestDhcpAddress prefixLengthInBits
Prefix length in bits requested in emberRequestDhcpAddress
This function provides the result of a call to emberRequestDhcpAddress .
This call only indicates the status of the request (EMBER_ERR_FATAL if no DHCP server is found, and EMBER_SUCCESS otherwise). The assigned IPv6 address is returned via emberAddressConfigurationChangeHandler
- Parameters
-
status
Status of DHCP Address Request prefix
Prefix requested in emberRequestDhcpAddress prefixLengthInBits
Prefix length in bits requested in emberRequestDhcpAddress
void emberRequestSlaacAddress | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits
|
||
) |
The application can also call emberGetGlobalPrefixes to look for SLAAC prefixes that it can use to configure an address.
If the application wants to manually configure an address and not have the stack create one, then it should pass in the entire IPv6 address (in bytes) for the prefix argument, with prefixLengthInBits as 128.
When the address is obtained, the application is informed of this via emberAddressConfigurationChangeHandler .
- Parameters
-
prefix
SLAAC prefix prefixLengthInBits
Length in bits of the prefix
void emberRequestSlaacAddressReturn | ( | EmberStatus |
status,
|
const uint8_t * |
prefix,
|
||
uint8_t |
prefixLengthInBits
|
||
) |
This call only indicates the status of the request (EMBER_ERR_FATAL if no SLAAC server is found, and EMBER_SUCCESS otherwise). The assigned IPv6 address is returned via emberAddressConfigurationChangeHandler
- Parameters
-
status
Status of SLAAC Address Request prefix
Prefix requested in emberRequestSlaacAddress prefixLengthInBits
Prefix length in bits requested in emberRequestSlaacAddress
This function provides the result of a call to emberRequestSlaacAddress .
This call only indicates the status of the request (EMBER_ERR_FATAL if no SLAAC server is found, and EMBER_SUCCESS otherwise). The assigned IPv6 address is returned via emberAddressConfigurationChangeHandler
- Parameters
-
status
Status of SLAAC Address Request prefix
Prefix requested in emberRequestSlaacAddress prefixLengthInBits
Prefix length in bits requested in emberRequestSlaacAddress
void emberResignGlobalAddress | ( | const EmberIpv6Address * |
address
|
) |
void emberResignGlobalAddressReturn | ( | EmberStatus |
status
|
) |
This function provides the result of a call to emberResignGlobalAddress() .
void emberSetLocalNetworkData | ( | const uint8_t * |
networkData,
|
uint16_t |
length
|
||
) |
The stack will set the correct local node ID into the TLVs.
This function is an alternative to the emberConfigureGateway emberConfigureExternalRoute functions that provides full access to Network Data configuration. A call to this function removes any previous configuration, including uses of emberConfigureGateway and emberConfigureExternalRoute .
- Parameters
-
networkData
A pointer to a set of Thread Network Data TLVs that describe the local nodes Border Router and Server capabilities. length
The number of bytes in the supplied network data.
void emberSetLocalNetworkDataReturn | ( | EmberStatus |
status,
|
uint16_t |
length
|
||
) |
Provides the result of a call to ::emberSetServerNetworkData.
void emberSetNdData | ( | const uint8_t * |
data,
|
uint16_t |
length
|
||
) |
void emberSetNdDataReturn | ( | EmberStatus |
status,
|
uint16_t |
length
|
||
) |
This function provides the result of a call to emberSetNdData .
void emberSlaacServerChangeHandler | ( | const uint8_t * |
prefix,
|
uint8_t |
prefixLengthInBits,
|
||
bool |
available
|
||
) |
"available" means we can configure a SLAAC address.
- Parameters
-
prefix
SLAAC prefix prefixLengthInBits
length in bits of the prefix available
whether we can configure an address
This function is called when the stack knows about a new SLAAC prefix or if a SLAAC server has become unavailable.
"available" means we can configure a SLAAC address.
- Parameters
-
prefix
SLAAC prefix prefixLengthInBits
length in bits of the prefix available
whether we can configure an address