Modules#

Network Creator

Network Creator#

API and Callbacks for the Network Creator Component.

This component performs the necessary steps to create a network according to the Base Device Behavior specification. The component performs an active scan followed by an energy scan across a primary channel set to decide which channel(s) are valid candidates for network formation. If the component fails to form a network on any primary channels, it moves to a secondary channel mask. Before every attempt at network formation, this component sets up the stack to use Zigbee 3.0 security.

API#

EmberStatus
emberAfPluginNetworkCreatorStart(bool centralizedNetwork)

Command the network creator to form a network with the following qualities.

void

Stop the network creator process.

EmberStatus
emberAfPluginNetworkCreatorNetworkForm(bool centralizedNetwork, EmberPanId panId, int8_t radioTxPower, uint8_t channel)

Command the network creator to form a centralized network.

Macros#

#define
EMBER_AF_PLUGIN_NETWORK_CREATOR_PLUGIN_NAME "NWK Creator"

API Documentation#

emberAfPluginNetworkCreatorStart#

EmberStatus emberAfPluginNetworkCreatorStart (bool centralizedNetwork)

Command the network creator to form a network with the following qualities.

Parameters
TypeDirectionArgument NameDescription
boolN/AcentralizedNetwork

Whether or not to form a network using centralized security. If this argument is false, a network with distributed security will be formed.

Returns

  • Status of the commencement of the network creator process.


emberAfPluginNetworkCreatorStop#

void emberAfPluginNetworkCreatorStop (void )

Stop the network creator process.

Parameters
TypeDirectionArgument NameDescription
voidN/A

Stops the network creator formation process.


emberAfPluginNetworkCreatorNetworkForm#

EmberStatus emberAfPluginNetworkCreatorNetworkForm (bool centralizedNetwork, EmberPanId panId, int8_t radioTxPower, uint8_t channel)

Command the network creator to form a centralized network.

Parameters
TypeDirectionArgument NameDescription
boolN/AcentralizedNetwork

Indicates whether or not to form a network using centralized security. If this argument is false, a network with distributed security will be formed.

EmberPanIdN/ApanId

The pan ID of the network to be formed.

int8_tN/AradioTxPower

The TX power of the network to be formed.

uint8_tN/Achannel

The channel of the network to be formed.

Commands the network creator to form a centralized or distributed network with specified PAN ID, TX power, and channel.

Returns

  • Status of the commencement of the network creator process.


Variable Documentation#

emAfPluginNetworkCreatorPrimaryChannelMask#

uint32_t emAfPluginNetworkCreatorPrimaryChannelMask

emAfPluginNetworkCreatorSecondaryChannelMask#

uint32_t emAfPluginNetworkCreatorSecondaryChannelMask