ESP-IDF: выбор канала точки доступа Wi-Fi | arm

Точка доступа, проект ESP-IDF v5.4.1, микроконтроллер ESP32-S3. Как выбирается радиоканал для точки доступа?

Для точки доступа (SoftAP) на ESP32-S3 в рамках ESP-IDF v5.4.1 радиоканал не выбирается автоматически, если только вы не используете режим AP+STA. Вместо этого канал задается в конфигурации приложения, и у вас есть полный контроль над этим параметром.

Ручная настройка канала. Основной способ выбрать канал — указать его в структуре конфигурации Wi-Fi с помощью функции esp_wifi_set_config().

// 1. Объявляем структуру конфигурации для точки доступа
wifi_config_t wifi_config = {
    .ap = {
        .ssid = "мой_ssid",
        .ssid_len = strlen("мой_ssid"),
        .password = "мой_пароль",
        .channel = 6,  // <-- 1-11="" br="">        // ... другие настройки
    },
};

// 2. Устанавливаем конфигурацию для интерфейса AP
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config));

// 3. Запускаем Wi-Fi
ESP_ERROR_CHECK(esp_wifi_start());

Допустимый диапазон. Канал должен быть в пределах, разрешенных настройками страны (`Wi-Fi Country Code`). Обычно для 2.4 ГГц это каналы с 1 по 11.

Некорректное значение: если указать канал вне допустимого диапазона, драйвер может установить канал по умолчанию (обычно канал 1) или вернуть ошибку.

Особый случай: режим AP+STA. Если ваш ESP32-S3 одновременно работает и как точка доступа (AP), и как клиент (STA), то выбор канала подчиняется другому приоритету:

1. Канал клиента (STA) имеет приоритет. ESP32 подключается к внешней точке доступа на ее канале.

2. Чтобы поддерживать связь со своими клиентами, внутренняя точка доступа автоматически переключается на тот же канал, что и клиент.

3. При смене канала ESP32 уведомит подключенные станции об этом с помощью `Channel Switch Announcement (CSA)`, чтобы они могли переключиться без переподключения.

Пример из практики: если ваш ESP32-S3 настроен как точка доступа на канале 6, но затем подключается к внешнему роутеру на канале 9, его внутренняя точка доступа переключится на канал 9.

Продвинутый режим: автоматический выбор. В последних версиях документации ESP-IDF (например, для v6.0.2) появилось упоминание, что установка `channel = 0` может означать автоматический выбор канала.

Однако в официальной документации для версии v5.4.1 в основном описывается именно ручная настройка. Если вам нужна автоматика, стоит проверить актуальность этого параметра для вашей версии в официальной документации. В этом случае выбор происходит на основе сканирования эфира для поиска наименее загруженного канала, как описано в некоторых исследованиях.

Таким образом, управление каналом в ESP-IDF v5.4.1 по умолчанию полностью определяется разработчиком. Исключением является лишь режим `AP+STA`, где приоритет получает канал внешней сети.

[Как программно определить, какой канал Wi-Fi выбран для точки доступа]

Чтобы программно узнать, на каком канале работает ваша точка доступа, используйте функцию esp_wifi_get_channel. Она напрямую возвращает текущий рабочий канал Wi-Fi.

#include "esp_wifi.h"

uint8_t primary_channel;
wifi_second_chan_t second_channel;

// Получаем текущий канал
esp_err_t err = esp_wifi_get_channel(&primary_channel, &second_channel);

if (err == ESP_OK) {
    ESP_LOGI("TAG", "Текущий канал точки доступа: %d", primary_channel);
    // Параметр second_channel для 2.4 ГГц обычно равен WIFI_SECOND_CHAN_NONE
} else {
    ESP_LOGE("TAG", "Не удалось получить канал: %s", esp_err_to_name(err));
}

Функция esp_wifi_get_channel() заполняет две переменные:

primary_channel: основной номер канала (например, 6).
second_channel: используется для расширенных режимов (40 МГц) и для каналов 2.4 ГГц обычно равен WIFI_SECOND_CHAN_NONE.

Эта функция работает только после инициализации Wi-Fi (вызов esp_wifi_init) и запуска (вызов esp_wifi_start). Если вы используете ESP32-S3 в режиме AP+STA, то канал точки доступа автоматически подстраивается под канал клиента (станции), так как устройство может работать только на одном канале. В этом случае esp_wifi_get_channel вернет актуальное значение, на котором сейчас работает микроконтроллер.

В целом это самый прямой и надежный способ получить текущий канал точки доступа в ESP-IDF.

[Какой диапазон значений для выбора канала точки доступа?]

Для точки доступа (SoftAP) на ESP32-S3 в ESP-IDF диапазон допустимых значений каналов — от 1 до 13.

Но это значение не жесткое — оно зависит от двух основных факторов.

Это самый важный ограничивающий фактор. Вы задаете его через функцию esp_wifi_set_country(), и именно она определяет, какие каналы доступны:

Важное замечание: начиная с ESP-IDF v5.0, если вы не зададите код страны явно, то система использует режим «глобальной безопасности» ("01"), в котором разрешены только каналы 1–11. Это сделано для того, чтобы ваше устройство работало в большинстве стран без нарушения местных норм.

2. Режим AP+STA (одновременная работа). Если ваш ESP32-S3 работает одновременно и как точка доступа (AP), и как клиент (STA), то SoftAP вынужден использовать тот же канал, на котором работает внешняя точка доступа (роутер), к которой вы подключились.

В этом случае ваш программно заданный канал будет проигнорирован, и фактически будет использоваться канал внешней сети.

Важное замечание по каналам 12 и 13. Если вы хотите использовать 12-й или 13-й каналы:

1. Обязательно вручную установите страновой код, например, "RU" или "CN".

2. Не используйте режим WIFI_COUNTRY_POLICY_AUTO — в этом режиме клиентские устройства могут не найти вашу точку доступа, особенно если у неё скрыт SSID.

Рекомендация: всегда сначала вызывайте esp_wifi_set_country() с нужной страной, и только после этого настраивайте и запускайте SoftAP с помощью esp_wifi_set_config() и esp_wifi_start().