Parent Support
Connect Stack API Reference > Network Management

Functions

EmberStatus emberFormNetwork ( EmberNetworkParameters *parameters)
Form a new network by becoming the coordinator. This API requires the parent-support library to be present. More...
EmberStatus emberGetChildFlags ( EmberMacAddress *address, EmberChildFlags *flags)
Return an EmberChildFlags bitmask indicating the child flags of the child corresponding to the passed MAC address. More...
EmberStatus emberGetChildInfo ( EmberMacAddress *address, EmberMacAddress *addressResp, EmberChildFlags *flags)
Return info on the child corresponding to the passed MAC address. More...
EmberStatus emberRemoveChild ( EmberMacAddress *address)
Remove the node corresponding to the passed MAC address from the child table. More...
EmberStatus emberPurgeIndirectMessages (void)
Purge all indirect transmissions from the indirect message queue. More...
EmberStatus emberSetIndirectQueueTimeout (uint32_t timeoutMs)
Set indirect queue timeout value. The indirect queue timeout is set by default to EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS . More...

Handlers

void emberChildJoinHandler ( EmberNodeType nodeType, EmberNodeId nodeId)
Invoked at coordinator, range extender, or mac mode nodes when a new child has joined the device. More...

Function Documentation

◆ emberChildJoinHandler()

void emberChildJoinHandler ( EmberNodeType nodeType,
EmberNodeId nodeId
)

Invoked at coordinator, range extender, or mac mode nodes when a new child has joined the device.

Parameters
[in] nodeType The role of the joining device ( EMBER_STAR_RANGE_EXTENDER , EMBER_STAR_END_DEVICE , EMBER_STAR_SLEEPY_END_DEVICE , EMBER_MAC_MODE_DEVICE or EMBER_MAC_MODE_SLEEPY_DEVICE ).
[in] nodeId The node ID of the joining device.

◆ emberFormNetwork()

EmberStatus emberFormNetwork ( EmberNetworkParameters * parameters )

Form a new network by becoming the coordinator. This API requires the parent-support library to be present.

Parameters
[in] parameters An EmberNetworkParameters value that specifies the network parameters of the network to be formed.
Returns
An EmberStatus value that indicates either the successful formation of the new network or an EmberStatus value indicating the reason of failure.

◆ emberGetChildFlags()

EmberStatus emberGetChildFlags ( EmberMacAddress * address,
EmberChildFlags * flags
)

Return an EmberChildFlags bitmask indicating the child flags of the child corresponding to the passed MAC address.

Note
Deprecated, use emberGetChildInfo instead
Parameters
[in] address A pointer to an EmberMacAddress that specifies the MAC address of the child.
[out] flags A pointer to an EmberChildFlags containing the child flags of the child corresponding to the passed MAC address.
Returns
An EmberStatus value of EMBER_SUCCESS if the child was found in the child table, or another EmberStatus value indicating the reason of failure.

◆ emberGetChildInfo()

EmberStatus emberGetChildInfo ( EmberMacAddress * address,
EmberMacAddress * addressResp,
EmberChildFlags * flags
)

Return info on the child corresponding to the passed MAC address.

Note
For star coordinators, if the input address is short, the corresponding child will also be searched in the list of devices connected through range extender. Long address and additional flags for these devices are not available to the coordinator.
Parameters
[in] address A pointer to an EmberMacAddress that specifies the MAC address of the child (short or long).
[out] addressResp A pointer to an EmberMacAddress that returns the other address (respectively long or short).
[out] flags A pointer to an EmberChildFlags containing the child flags of the child corresponding to the passed MAC address.
Note
Both out parameters are optional. If set to NULL, the API will at least indicate if the child was found in the network.
Returns
An EmberStatus value of EMBER_SUCCESS if the child was found in the child table, EMBER_CHILD_NOT_FOUND if it was not, or another EmberStatus value indicating the reason of failure.

◆ emberPurgeIndirectMessages()

EmberStatus emberPurgeIndirectMessages ( void )

Purge all indirect transmissions from the indirect message queue.

Returns
an EmberStatus value of EMBER_SUCCESS if all indirect messages were purged, or another EmberStatus value indicating the reason of failure.

◆ emberRemoveChild()

EmberStatus emberRemoveChild ( EmberMacAddress * address )

Remove the node corresponding to the passed MAC address from the child table.

Parameters
[in] address A pointer to an EmberMacAddress that specifies the MAC address of the child to be removed.
Returns
An EmberStatus value of EMBER_SUCCESS if the node was successfully removed from the child table, or another EmberStatus value indicating the reason of failure.

◆ emberSetIndirectQueueTimeout()

EmberStatus emberSetIndirectQueueTimeout ( uint32_t timeoutMs )

Set indirect queue timeout value. The indirect queue timeout is set by default to EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS .

Parameters
timeoutMs The timeout in milliseconds to be set.
Returns
an EmberStatus value of EMBER_SUCCESS if the passed timeout was successfully set, or a value of EMBER_BAD_ARGUMENT if the passed value is invalid.