Comms Hub Function Sub GHz#

sl_zigbee_af_comms_hub_function_sub_ghz_start_channel_change_sequence#

sl_zigbee_af_plugin_comms_hub_function_status_t sl_zigbee_af_comms_hub_function_sub_ghz_start_channel_change_sequence (void )

Trigger the sub-GHz channel change sequence.

The sub-GHz CHF channel change comprises several steps:

1. Set the EnergyScanPending Functional Notification flag.

2. Wait until the GSME reads that flag or one GSME wake up period, whichever comes first.

3. Perform an energy scan and determine the new page and channel.

4. Set the ChannelChangePending Functional Notification flag and the ChannelChange attribute.

5. Wait until the GSME reads that attribute or two GSME wake up periods, whichever comes first.

6. Change the channel.

Note 1: The GSME must have completed the registration and allocated a mirror before this function is called.

Note 2: sl_zigbee_af_comms_hub_function_sub_ghz_channel_change_cb() is called at steps 3 and 6 in the above sequence. After step 3, the application must call sl_zigbee_af_comms_hub_function_sub_ghz_complete_channel_change_sequence() to advance to steps 4 and and beyond.

sl_zigbee_af_comms_hub_function_sub_ghz_complete_channel_change_sequence#

sl_zigbee_af_plugin_comms_hub_function_status_t sl_zigbee_af_comms_hub_function_sub_ghz_complete_channel_change_sequence (uint32_t pageChannelMask)

Complete the sub-GHz channel change sequence.

The application may call this function following an energy scan (step 3 in the sequence described above).

If the mask is 0, the sequence is terminated immediately and the channel is not changed.