Function esp_idf_sys::esp_mesh_waive_root

source ยท
pub unsafe extern "C" fn esp_mesh_waive_root(
    vote: *const mesh_vote_t,
    reason: c_int,
) -> esp_err_t
Expand description

@brief Cause the root device to give up (waive) its mesh root status - A device is elected root primarily based on RSSI from the external router. - If external router conditions change, users can call this API to perform a root switch. - In this API, users could specify a desired root address to replace itself or specify an attempts value to ask current root to initiate a new round of voting. During the voting, a better root candidate would be expected to find to replace the current one. - If no desired root candidate, the vote will try a specified number of attempts (at least 15). If no better root candidate is found, keep the current one. If a better candidate is found, the new better one will send a root switch request to the current root, current root will respond with a root switch acknowledgment. - After that, the new candidate will connect to the router to be a new root, the previous root will disconnect with the router and choose another parent instead.

        Root switch is completed with minimal disruption to the whole mesh network.

@attention This API is only called by the root.

@param[in] vote vote configuration - If this parameter is set NULL, the vote will perform the default 15 times.

        - Field percentage threshold is 0.9 by default.
        - Field is_rc_specified shall be false.
        - Field attempts shall be at least 15 times.

@param[in] reason only accept MESH_VOTE_REASON_ROOT_INITIATED for now

@return

  • ESP_OK
  • ESP_ERR_MESH_QUEUE_FULL
  • ESP_ERR_MESH_DISCARD
  • ESP_FAIL