esp_wifi_mesh.h

Go to the documentation of this file.

/*
 * Copyright (c) 2026 Espressif Systems (Shanghai) Co., Ltd.
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_DRIVERS_ESP_WIFI_MESH_H_
#define ZEPHYR_INCLUDE_DRIVERS_ESP_WIFI_MESH_H_
 
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
#include <zephyr/net/net_if.h>
#include <zephyr/net/net_ip.h>
#include <zephyr/net/wifi.h>


enum esp_wifi_mesh_event {
        ESP_WIFI_MESH_EVENT_STARTED,
        ESP_WIFI_MESH_EVENT_STOPPED,
        ESP_WIFI_MESH_EVENT_PARENT_CONNECTED,
        ESP_WIFI_MESH_EVENT_PARENT_DISCONNECTED,
        ESP_WIFI_MESH_EVENT_CHILD_CONNECTED,
        ESP_WIFI_MESH_EVENT_CHILD_DISCONNECTED,
        ESP_WIFI_MESH_EVENT_NO_PARENT_FOUND,
        ESP_WIFI_MESH_EVENT_FIND_NETWORK,
        ESP_WIFI_MESH_EVENT_ROUTING_TABLE_CHANGE,
        ESP_WIFI_MESH_EVENT_TODS_REACHABLE,
        ESP_WIFI_MESH_EVENT_TODS_UNREACHABLE,
};

struct esp_wifi_mesh_event_info {
        int layer;
        bool is_root;
        int routing_table_size;
        int reason;
};

typedef void (*esp_wifi_mesh_event_cb_t)(enum esp_wifi_mesh_event event,
                                         const struct esp_wifi_mesh_event_info *info);

void esp_wifi_mesh_event_cb_register(esp_wifi_mesh_event_cb_t cb);

struct esp_wifi_mesh_config {
        char ssid[33];
        char password[64];
        char mesh_password[64];
        uint8_t channel;
        uint8_t mesh_id[6];
        enum wifi_security_type authmode;
        uint8_t num_layers;
        uint8_t max_connections;
};

int esp_wifi_mesh_set_config(const struct esp_wifi_mesh_config *config);

void esp_wifi_mesh_get_config(struct esp_wifi_mesh_config *config);

int esp_wifi_mesh_start(void);
 
#if !defined(CONFIG_WIFI_ESP32_MESH_IP)
int esp_wifi_mesh_send(const uint8_t *data, size_t len);

int esp_wifi_mesh_recv(uint8_t *data, size_t *len, int timeout_ms);
#endif /* !CONFIG_WIFI_ESP32_MESH_IP */

struct esp_wifi_mesh_status {
        int layer;
        bool is_root;
        int routing_table_size;
        bool tods_reachable;
};

void esp_wifi_mesh_get_status(struct esp_wifi_mesh_status *status);

struct esp_wifi_mesh_addr {
        uint8_t addr[6];
};

int esp_wifi_mesh_get_routing_table(struct esp_wifi_mesh_addr *macs, size_t max, size_t *count);

void esp_wifi_mesh_set_tods_reachable(bool reachable);

void esp_wifi_mesh_bind_sta_rx(void);

struct net_if *esp_wifi_mesh_netif_get(void);

 
#endif /* ZEPHYR_INCLUDE_DRIVERS_ESP_WIFI_MESH_H_ */