Parent Support#

Handlers#

void
emberChildJoinHandler(EmberNodeType nodeType, EmberNodeId nodeId)

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

Handlers#

The Application Framework implements all handlers, directly calling their associated callbacks. By default, Connect projects declare such callbacks as stubs in flex-callbacks-stubs.c. Hence, to use an enabled Connect feature, applications should replace the stub with their own implementation of the associated callback (typically in flex-callbacks.c). See UG235.04 for more info.

Purge all indirect transmissions from the indirect message queue.

emberSetIndirectQueueTimeout(uint32_t timeoutMs)

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

Functions#

emberFormNetwork(EmberNetworkParameters *parameters)

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

emberGetChildFlags(EmberMacAddress *address, EmberChildFlags *flags)

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

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

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

emberRemoveChild(EmberMacAddress *address)

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

Handlers 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.


Definition at line 615 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/stack-info.h

Handlers Documentation#

emberPurgeIndirectMessages#

EmberStatus emberPurgeIndirectMessages (void )

Purge all indirect transmissions from the indirect message queue.

Parameters
N/A

Returns


Definition at line 299 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/message.h

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
N/AtimeoutMs

The timeout in milliseconds to be set.

Returns


Definition at line 313 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/message.h

Function Documentation#

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.


Definition at line 263 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/network-management.h

emberGetChildFlags#

EmberStatus emberGetChildFlags (EmberMacAddress * address, EmberChildFlags * flags)

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

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.

Note

  • Deprecated, use emberGetChildInfo instead

Returns


Definition at line 493 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/network-management.h

emberGetChildInfo#

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

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

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

  • 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.

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


Definition at line 521 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/network-management.h

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


Definition at line 537 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/network-management.h