typedef struct {
int duration_ms; /* parent weak RSSI monitor duration, if the RSSI continues to be weak during this duration_ms,
will switch to a better parent */
- int cnx_rssi; /* RSSI threshold for keeping a good connection with parent */
+ int cnx_rssi; /* RSSI threshold for keeping a good connection with parent.
+ if set a value greater than -120 dBm, will arm a timer to monitor current RSSI at a period time of
+ duration_ms. if keep the default value(-120 dBm), a timer at a random period(<3minutes) will
+ be armed to switch a better parent if there does have one.
+ The better parent must have RSSI greater than a high RSSI threshold(-78 dBm by default) and a top layer
+ than current one. */
int select_rssi; /* RSSI threshold for parent selection, should be a value greater than switch_rssi */
- int switch_rssi; /* RSSI threshold for action to reselect a better parent */
+ int switch_rssi; /* Disassociate current parent and switch to a new parent when the RSSI is greater than this set threshold */
int backoff_rssi; /* RSSI threshold for connecting to the root */
} mesh_switch_parent_t;
+typedef struct {
+ int high;
+ int medium;
+ int low;
+} mesh_rssi_threshold_t;
+
+/**
+ * @brief mesh networking IE
+ */
+typedef struct {
+ /**< mesh networking IE head */
+ uint8_t eid; /**< element ID */
+ uint8_t len; /**< element length */
+ uint8_t oui[3]; /**< organization identifier */
+ /**< mesh networking IE content */
+ uint8_t type; /** mesh networking IE type */
+ uint8_t encryped : 1; /**< if mesh networking IE is encrypted */
+ uint8_t version : 7; /**< mesh networking IE version */
+ /**< content */
+ uint8_t mesh_type; /**< mesh device type */
+ uint8_t mesh_id[6]; /**< mesh ID */
+ uint8_t layer_cap; /**< max layer */
+ uint8_t layer; /**< current layer */
+ uint8_t assoc_cap; /**< max connections of mesh AP */
+ uint8_t assoc; /**< current connections */
+ uint8_t leaf_cap; /**< leaf capacity */
+ uint8_t leaf_assoc; /**< the number of current connected leaf */
+ uint16_t root_cap; /**< root capacity */
+ uint16_t self_cap; /**< self capacity */
+ uint16_t layer2_cap; /**< layer2 capacity */
+ uint16_t scan_ap_num; /**< the number of scanned APs */
+ int8_t rssi; /**< RSSI of the parent */
+ int8_t router_rssi; /**< RSSI of the router */
+ uint8_t flag; /**< flag of networking */
+ uint8_t rc_addr[6]; /**< root address */
+ int8_t rc_rssi; /**< root RSSI */
+ uint8_t vote_addr[6]; /**< voter address */
+ int8_t vote_rssi; /**< vote RSSI of the router */
+ uint8_t vote_ttl; /**< vote ttl */
+ uint16_t votes; /**< votes */
+ uint16_t my_votes; /**< my votes */
+ uint8_t reason; /**< reason */
+ uint8_t child[6]; /**< child address */
+ uint8_t toDS; /**< toDS state */
+} __attribute__((packed)) mesh_assoc_t;
+
/*******************************************************
* Function Definitions
*******************************************************/
*
* @return
* - ESP_OK
- * - ESP_FAIL
+ * - ESP_ERR_MESH_ARGUMENT
*/
esp_err_t esp_mesh_get_attempts(mesh_attempts_t *attempts);
*
* @return
* - ESP_OK
- * - ESP_FAIL
+ * - ESP_ERR_MESH_ARGUMENT
*/
esp_err_t esp_mesh_set_switch_parent_paras(mesh_switch_parent_t *paras);
*
* @return
* - ESP_OK
- * - ESP_FAIL
+ * - ESP_ERR_MESH_ARGUMENT
*/
esp_err_t esp_mesh_get_switch_parent_paras(mesh_switch_parent_t *paras);
+/**
+ * @brief set RSSI threshold
+ * The default high RSSI threshold value is -78 dBm.
+ * The default medium RSSI threshold value is -82 dBm.
+ * The default low RSSI threshold value is -85 dBm.
+ *
+ * @param threshold RSSI threshold
+ *
+ * @return
+ * - ESP_OK
+ * - ESP_ERR_MESH_ARGUMENT
+ */
+esp_err_t esp_mesh_set_rssi_threshold(const mesh_rssi_threshold_t *threshold);
+
+/**
+ * @brief get RSSI threshold
+ * @param threshold RSSI threshold
+ *
+ * @return
+ * - ESP_OK
+ * - ESP_ERR_MESH_ARGUMENT
+ */
+esp_err_t esp_mesh_get_rssi_threshold(mesh_rssi_threshold_t *threshold);
+
+/**
+ * @brief enable the minimum rate to 6Mbps
+ *
+ * @attention This API shall be called before WiFi start.
+ *
+ * @param is_6m enable or not
+ *
+ * @return
+ * - ESP_OK
+ */
+esp_err_t esp_mesh_set_6m_rate(bool is_6m);
+
/**
* @brief print the number of txQ waiting
*
*/
int esp_mesh_get_passive_scan_time(void);
+/**
+ * @brief set announce interval
+ * The default short interval is 500 milliseconds.
+ * The default long interval is 3000 milliseconds.
+ *
+ * @param short_ms shall be greater than the default value
+ * @param long_ms shall be greater than the default value
+ *
+ * @return
+ * - ESP_OK
+ */
+esp_err_t esp_mesh_set_announce_interval(int short_ms, int long_ms);
+
+/**
+ * @brief get announce interval
+ *
+ * @param short_ms short interval
+ * @param long_ms long interval
+ *
+ * @return
+ * - ESP_OK
+ */
+esp_err_t esp_mesh_get_announce_interval(int *short_ms, int *long_ms);
#ifdef __cplusplus
}