Parent Support#
Handlers#
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.
Set indirect queue timeout value. The indirect queue timeout is set by default to EMBER_INDIRECT_TRANSMISSION_TIMEOUT_MS.
Functions#
Form a new network by becoming the coordinator. This API requires the parent-support library to be present.
Return an EmberChildFlags bitmask indicating the child flags of the child corresponding to the passed MAC address.
Return info on the child corresponding to the passed MAC 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.
[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. |
601
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/protocol/flex/stack/include/stack-info.h
Handlers Documentation#
emberPurgeIndirectMessages#
EmberStatus emberPurgeIndirectMessages (void )
Purge all indirect transmissions from the indirect message queue.
N/A |
Returns
an EmberStatus value of EMBER_SUCCESS if all indirect messages were purged, or another EmberStatus value indicating the reason of failure.
299
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/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.
N/A | 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.
313
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/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.
[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.
263
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/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.
[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
An EmberStatus value of EMBER_SUCCESS if the child was found in the child table, or another EmberStatus value indicating the reason of failure.
493
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/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.
[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
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.
521
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/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.
[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.
537
of file /mnt/raid/workspaces/ws.Q8qnkBLX2/overlay/gsdk/protocol/flex/stack/include/network-management.h