Modules#
Network Find#
API and Callbacks for the Network Find Component.
NOTE: This component is deprecated in Zigbee 3.0, but is still used for Zigbee Smart Energy requirements. See the Network Creator and Network Steering components instead for Zigbee 3.0-compliant implementations of this behavior. This component provides legacy Zigbee Home Automation (pre-3.0) implementation of routines for finding and joining any viable network via scanning, rather than joining a specific network. If the application will be deployed in an environment with potentially a lot of open networks, consider implementing a mechanism for network deny listing. Network deny listing may be accomplished by implementing the emberAfPluginNetworkFindJoinCallback. To extend the functionality to sub-GHz channels, also enable the Network Find (Sub-GHz) component.
API#
Set the channel mask for "find unused" and "find joinable". Permitted pages are 0 and, if Sub-GHz channels are included, then also 28-31.
Return the channel mask for a given page. Only the bottom 27 bits can be set. The top 5 bits are reserved for the page number and are always zero in a returned channel mask. That leaves the value 0xFFFFFFFF free to indicate an invalid page error.
Set the search mode for "find unused" and "find joinable". Mode is a bitmask. Permitted values are set by the FIND_AND_JOIN_MODE_... macros.
Returns the current search mode.
API Documentation#
emberAfSetFormAndJoinChannelMask#
EmberStatus emberAfSetFormAndJoinChannelMask (uint8_t page, uint32_t mask)
Set the channel mask for "find unused" and "find joinable". Permitted pages are 0 and, if Sub-GHz channels are included, then also 28-31.
| N/A | page | |
| N/A | mask |
65 of file app/framework/plugin/network-find/network-find.hemberAfGetFormAndJoinChannelMask#
uint32_t emberAfGetFormAndJoinChannelMask (uint8_t page)
Return the channel mask for a given page. Only the bottom 27 bits can be set. The top 5 bits are reserved for the page number and are always zero in a returned channel mask. That leaves the value 0xFFFFFFFF free to indicate an invalid page error.
| N/A | page |
72 of file app/framework/plugin/network-find/network-find.hemberAfSetFormAndJoinSearchMode#
EmberStatus emberAfSetFormAndJoinSearchMode (uint8_t mode)
Set the search mode for "find unused" and "find joinable". Mode is a bitmask. Permitted values are set by the FIND_AND_JOIN_MODE_... macros.
| N/A | mode |
78 of file app/framework/plugin/network-find/network-find.hemberAfGetFormAndJoinSearchMode#
uint8_t emberAfGetFormAndJoinSearchMode (void )
Returns the current search mode.
| N/A |
82 of file app/framework/plugin/network-find/network-find.h