Network Find#

Callbacks for Network Find Component.

Callbacks#

void

Finish forming or joining process.

int8_t

Get radio power for a channel.

bool
emberAfPluginNetworkFindJoinCallback(EmberZigbeeNetwork *networkFound, uint8_t lqi, int8_t rssi)

Join a network.

int8_t

Get the energy threshold for a channel.

bool

Get enable scanning all channels.

Callbacks Documentation#

emberAfPluginNetworkFindFinishedCallback#

void emberAfPluginNetworkFindFinishedCallback (EmberStatus status)

Finish forming or joining process.

Parameters
N/Astatus

Ver.: always

This callback is fired when the network-find plugin is finished with the forming or joining process. The result of the operation will be returned in the status parameter.


Definition at line 122 of file app/framework/plugin/network-find/network-find.h

emberAfPluginNetworkFindGetRadioPowerForChannelCallback#

int8_t emberAfPluginNetworkFindGetRadioPowerForChannelCallback (uint8_t pgChan)

Get radio power for a channel.

Parameters
N/ApgChan

Ver.: always

This callback is called by the framework when it is setting the radio power during the discovery process. The framework will set the radio power depending on what is returned by this callback.


Definition at line 132 of file app/framework/plugin/network-find/network-find.h

emberAfPluginNetworkFindJoinCallback#

bool emberAfPluginNetworkFindJoinCallback (EmberZigbeeNetwork * networkFound, uint8_t lqi, int8_t rssi)

Join a network.

Parameters
N/AnetworkFound

Ver.: always

N/Alqi

Ver.: always

N/Arssi

Ver.: always

This callback is called by the plugin when a joinable network has been found. If the application returns true, the plugin will attempt to join the network. Otherwise, the plugin will ignore the network and continue searching. Applications can use this callback to implement a network blacklist.


Definition at line 146 of file app/framework/plugin/network-find/network-find.h

emberAfPluginNetworkFindGetEnergyThresholdForChannelCallback#

int8_t emberAfPluginNetworkFindGetEnergyThresholdForChannelCallback (uint8_t pgChan)

Get the energy threshold for a channel.

Parameters
N/ApgChan

Ver.: always

This callback is called during the energy scan when forming the network. Should the energy level exceed the value returned by this callback, the current channel will not be considered a suitable candidate for forming. Should none of the channels in the channel mask be considered suitable, the scan will fall back on all channels, including those not on the channel mask. The return value is RSSI, in dBm. This callback is called only when the fallback functionality is enabled.


Definition at line 162 of file app/framework/plugin/network-find/network-find.h

emberAfPluginNetworkFindGetEnableScanningAllChannelsCallback#

bool emberAfPluginNetworkFindGetEnableScanningAllChannelsCallback (void )

Get enable scanning all channels.

Parameters
N/A

Returns true is the fallback on scanning all channels is enabled, false if not.


Definition at line 169 of file app/framework/plugin/network-find/network-find.h