circuitpython/ports/esp32s2/common-hal/wifi/Radio.c

366 lines
13 KiB
C
Raw Normal View History

2020-07-28 21:23:33 -04:00
/*
* This file is part of the MicroPython project, http://micropython.org/
*
* The MIT License (MIT)
*
* Copyright (c) 2020 Scott Shawcroft for Adafruit Industries
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#include "shared-bindings/wifi/Radio.h"
#include "shared-bindings/wifi/Network.h"
2020-07-28 21:23:33 -04:00
2020-08-05 15:53:35 -04:00
#include <string.h>
2020-08-11 17:50:37 -04:00
#include "common-hal/wifi/__init__.h"
2020-08-05 15:53:35 -04:00
#include "lib/utils/interrupt_char.h"
2020-12-07 11:06:33 -05:00
#include "py/gc.h"
#include "py/runtime.h"
2020-08-05 15:53:35 -04:00
#include "shared-bindings/ipaddress/IPv4Address.h"
#include "shared-bindings/wifi/ScannedNetworks.h"
2020-08-10 20:56:49 -04:00
#include "shared-module/ipaddress/__init__.h"
2020-09-28 18:59:29 -04:00
#include "components/esp_wifi/include/esp_wifi.h"
#include "components/lwip/include/apps/ping/ping_sock.h"
2020-09-28 20:25:09 -04:00
#define MAC_ADDRESS_LENGTH 6
static void set_mode_station(wifi_radio_obj_t *self, bool state) {
2020-08-14 20:03:29 -04:00
wifi_mode_t next_mode;
if (state) {
if (self->ap_mode) {
next_mode = WIFI_MODE_APSTA;
} else {
next_mode = WIFI_MODE_STA;
}
2021-04-24 20:36:11 -04:00
} else {
if (self->ap_mode) {
next_mode = WIFI_MODE_AP;
} else {
next_mode = WIFI_MODE_NULL;
}
}
2020-08-14 20:03:29 -04:00
esp_wifi_set_mode(next_mode);
self->sta_mode = state;
}
static void set_mode_ap(wifi_radio_obj_t *self, bool state) {
wifi_mode_t next_mode;
if (state) {
if (self->sta_mode) {
next_mode = WIFI_MODE_APSTA;
} else {
next_mode = WIFI_MODE_AP;
}
2021-04-24 20:36:11 -04:00
} else {
if (self->sta_mode) {
next_mode = WIFI_MODE_STA;
} else {
next_mode = WIFI_MODE_NULL;
}
}
esp_wifi_set_mode(next_mode);
self->ap_mode = state;
}
2020-07-28 21:23:33 -04:00
bool common_hal_wifi_radio_get_enabled(wifi_radio_obj_t *self) {
2020-08-14 20:03:29 -04:00
return self->started;
2020-07-28 21:23:33 -04:00
}
void common_hal_wifi_radio_set_enabled(wifi_radio_obj_t *self, bool enabled) {
2020-08-14 20:03:29 -04:00
if (self->started && !enabled) {
if (self->current_scan != NULL) {
common_hal_wifi_radio_stop_scanning_networks(self);
}
ESP_ERROR_CHECK(esp_wifi_stop());
self->started = false;
return;
}
if (!self->started && enabled) {
ESP_ERROR_CHECK(esp_wifi_start());
self->started = true;
return;
}
2020-07-28 21:23:33 -04:00
}
mp_obj_t common_hal_wifi_radio_get_mac_address(wifi_radio_obj_t *self) {
2020-09-03 19:32:12 -04:00
uint8_t mac[MAC_ADDRESS_LENGTH];
2020-08-14 20:03:29 -04:00
esp_wifi_get_mac(ESP_IF_WIFI_STA, mac);
2020-09-03 19:32:12 -04:00
return mp_obj_new_bytes(mac, MAC_ADDRESS_LENGTH);
2020-07-28 21:23:33 -04:00
}
mp_obj_t common_hal_wifi_radio_get_mac_address_ap(wifi_radio_obj_t *self) {
uint8_t mac[MAC_ADDRESS_LENGTH];
esp_wifi_get_mac(ESP_IF_WIFI_AP, mac);
return mp_obj_new_bytes(mac, MAC_ADDRESS_LENGTH);
}
2020-07-28 21:23:33 -04:00
mp_obj_t common_hal_wifi_radio_start_scanning_networks(wifi_radio_obj_t *self) {
2020-08-14 20:03:29 -04:00
if (self->current_scan != NULL) {
mp_raise_RuntimeError(translate("Already scanning for wifi networks"));
}
if (!common_hal_wifi_radio_get_enabled(self)) {
mp_raise_RuntimeError(translate("wifi is not enabled"));
}
set_mode_station(self, true);
2020-08-14 20:03:29 -04:00
wifi_scannednetworks_obj_t *scan = m_new_obj(wifi_scannednetworks_obj_t);
scan->base.type = &wifi_scannednetworks_type;
2020-09-03 19:32:12 -04:00
self->current_scan = scan;
2020-08-14 20:03:29 -04:00
scan->start_channel = 1;
scan->end_channel = 11;
scan->radio_event_group = self->event_group_handle;
wifi_scannednetworks_scan_next_channel(scan);
return scan;
2020-07-28 21:23:33 -04:00
}
void common_hal_wifi_radio_stop_scanning_networks(wifi_radio_obj_t *self) {
// Return early if self->current_scan is NULL to avoid hang
if (self->current_scan == NULL) {
return;
}
2020-08-14 20:03:29 -04:00
// Free the memory used to store the found aps.
wifi_scannednetworks_deinit(self->current_scan);
self->current_scan = NULL;
2020-07-28 21:23:33 -04:00
}
2020-10-14 01:41:59 -04:00
mp_obj_t common_hal_wifi_radio_get_hostname(wifi_radio_obj_t *self) {
const char *hostname = NULL;
esp_netif_get_hostname(self->netif, &hostname);
if (hostname == NULL) {
return mp_const_none;
}
return mp_obj_new_str(hostname, strlen(hostname));
}
2020-10-13 04:52:02 -04:00
void common_hal_wifi_radio_set_hostname(wifi_radio_obj_t *self, const char *hostname) {
esp_netif_set_hostname(self->netif, hostname);
}
void common_hal_wifi_radio_start_station(wifi_radio_obj_t *self) {
set_mode_station(self, true);
}
void common_hal_wifi_radio_stop_station(wifi_radio_obj_t *self) {
set_mode_station(self, false);
}
2021-04-25 01:22:08 -04:00
void common_hal_wifi_radio_start_ap(wifi_radio_obj_t *self, uint8_t *ssid, size_t ssid_len, uint8_t *password, size_t password_len, uint8_t channel) {
set_mode_ap(self, true);
wifi_config_t *config = &self->ap_config;
memcpy(&config->ap.ssid, ssid, ssid_len);
config->ap.ssid[ssid_len] = 0;
memcpy(&config->ap.password, password, password_len);
config->ap.password[password_len] = 0;
2021-04-25 01:22:08 -04:00
config->ap.channel = channel;
config->ap.authmode = WIFI_AUTH_WPA2_PSK;
config->ap.max_connection = 4;
esp_wifi_set_config(WIFI_IF_AP, config);
}
void common_hal_wifi_radio_stop_ap(wifi_radio_obj_t *self) {
set_mode_ap(self, false);
}
2021-03-15 09:57:36 -04:00
wifi_radio_error_t common_hal_wifi_radio_connect(wifi_radio_obj_t *self, uint8_t *ssid, size_t ssid_len, uint8_t *password, size_t password_len, uint8_t channel, mp_float_t timeout, uint8_t *bssid, size_t bssid_len) {
if (!common_hal_wifi_radio_get_enabled(self)) {
mp_raise_RuntimeError(translate("wifi is not enabled"));
}
2021-01-17 21:21:31 -05:00
EventBits_t bits;
// can't block since both bits are false after wifi_init
// both bits are true after an existing connection stops
2021-01-17 21:21:31 -05:00
bits = xEventGroupWaitBits(self->event_group_handle,
WIFI_CONNECTED_BIT | WIFI_DISCONNECTED_BIT,
pdTRUE,
pdTRUE,
0);
if (((bits & WIFI_CONNECTED_BIT) != 0) &&
!((bits & WIFI_DISCONNECTED_BIT) != 0)) {
return WIFI_RADIO_ERROR_NONE;
}
// explicitly clear bits since xEventGroupWaitBits may have timed out
xEventGroupClearBits(self->event_group_handle, WIFI_CONNECTED_BIT);
xEventGroupClearBits(self->event_group_handle, WIFI_DISCONNECTED_BIT);
set_mode_station(self, true);
2021-03-15 09:57:36 -04:00
wifi_config_t *config = &self->sta_config;
2020-08-14 20:03:29 -04:00
memcpy(&config->sta.ssid, ssid, ssid_len);
config->sta.ssid[ssid_len] = 0;
2020-09-03 19:32:12 -04:00
memcpy(&config->sta.password, password, password_len);
2020-08-14 20:03:29 -04:00
config->sta.password[password_len] = 0;
config->sta.channel = channel;
2020-09-16 19:25:17 -04:00
// From esp_wifi_types.h:
// Generally, station_config.bssid_set needs to be 0; and it needs
// to be 1 only when users need to check the MAC address of the AP
2021-03-15 09:57:36 -04:00
if (bssid_len > 0) {
2020-09-16 19:25:17 -04:00
memcpy(&config->sta.bssid, bssid, bssid_len);
config->sta.bssid[bssid_len] = 0;
config->sta.bssid_set = true;
2020-09-17 18:04:27 -04:00
} else {
config->sta.bssid_set = false;
2020-09-16 19:25:17 -04:00
}
// If channel is 0 (default/unset) and BSSID is not given, do a full scan instead of fast scan
// This will ensure that the best AP in range is chosen automatically
if ((config->sta.bssid_set == 0) && (config->sta.channel == 0)) {
config->sta.scan_method = WIFI_ALL_CHANNEL_SCAN;
} else {
config->sta.scan_method = WIFI_FAST_SCAN;
}
2020-08-14 20:03:29 -04:00
esp_wifi_set_config(ESP_IF_WIFI_STA, config);
2020-08-21 14:00:02 -04:00
self->starting_retries = 5;
self->retries_left = 5;
2020-08-14 20:03:29 -04:00
esp_wifi_connect();
2020-08-05 15:53:35 -04:00
do {
RUN_BACKGROUND_TASKS;
bits = xEventGroupWaitBits(self->event_group_handle,
WIFI_CONNECTED_BIT | WIFI_DISCONNECTED_BIT,
pdTRUE,
pdTRUE,
0);
} while ((bits & (WIFI_CONNECTED_BIT | WIFI_DISCONNECTED_BIT)) == 0 && !mp_hal_is_interrupted());
if ((bits & WIFI_DISCONNECTED_BIT) != 0) {
2020-08-21 14:00:02 -04:00
if (self->last_disconnect_reason == WIFI_REASON_AUTH_FAIL) {
return WIFI_RADIO_ERROR_AUTH_FAIL;
2020-08-21 14:00:02 -04:00
} else if (self->last_disconnect_reason == WIFI_REASON_NO_AP_FOUND) {
return WIFI_RADIO_ERROR_NO_AP_FOUND;
}
return self->last_disconnect_reason;
2020-08-05 15:53:35 -04:00
}
2020-08-21 14:00:02 -04:00
return WIFI_RADIO_ERROR_NONE;
2020-07-28 21:23:33 -04:00
}
mp_obj_t common_hal_wifi_radio_get_ap_info(wifi_radio_obj_t *self) {
if (!esp_netif_is_netif_up(self->netif)) {
return mp_const_none;
}
// Make sure the interface is in STA mode
2021-03-15 09:57:36 -04:00
if (!self->sta_mode) {
return mp_const_none;
}
2020-10-16 02:45:11 -04:00
wifi_network_obj_t *ap_info = m_new_obj(wifi_network_obj_t);
ap_info->base.type = &wifi_network_type;
2020-09-21 23:56:03 -04:00
// From esp_wifi.h, the possible return values (typos theirs):
// ESP_OK: succeed
// ESP_ERR_WIFI_CONN: The station interface don't initialized
// ESP_ERR_WIFI_NOT_CONNECT: The station is in disconnect status
2021-03-15 09:57:36 -04:00
if (esp_wifi_sta_get_ap_info(&self->ap_info.record) != ESP_OK) {
2020-09-21 23:56:03 -04:00
return mp_const_none;
} else {
2020-12-21 18:32:48 -05:00
if (strlen(self->ap_info.record.country.cc) == 0) {
// Workaround to fill country related information in ap_info until ESP-IDF carries a fix
// esp_wifi_sta_get_ap_info does not appear to fill wifi_country_t (e.g. country.cc) details
// (IDFGH-4437) #6267
2020-12-23 18:37:37 -05:00
// Note: It is possible that Wi-Fi APs don't have a CC set, then even after this workaround
// the element would remain empty.
memset(&self->ap_info.record.country, 0, sizeof(wifi_country_t));
if (esp_wifi_get_country(&self->ap_info.record.country) != ESP_OK) {
return mp_const_none;
2020-12-21 18:32:48 -05:00
}
}
2020-10-16 02:45:11 -04:00
memcpy(&ap_info->record, &self->ap_info.record, sizeof(wifi_ap_record_t));
return MP_OBJ_FROM_PTR(ap_info);
2020-09-21 23:56:03 -04:00
}
}
mp_obj_t common_hal_wifi_radio_get_ipv4_gateway(wifi_radio_obj_t *self) {
if (!esp_netif_is_netif_up(self->netif)) {
return mp_const_none;
}
2020-09-22 00:36:46 -04:00
esp_netif_get_ip_info(self->netif, &self->ip_info);
return common_hal_ipaddress_new_ipv4address(self->ip_info.gw.addr);
}
mp_obj_t common_hal_wifi_radio_get_ipv4_subnet(wifi_radio_obj_t *self) {
if (!esp_netif_is_netif_up(self->netif)) {
return mp_const_none;
}
2020-09-22 00:36:46 -04:00
esp_netif_get_ip_info(self->netif, &self->ip_info);
return common_hal_ipaddress_new_ipv4address(self->ip_info.netmask.addr);
}
2020-08-05 15:53:35 -04:00
mp_obj_t common_hal_wifi_radio_get_ipv4_address(wifi_radio_obj_t *self) {
2020-08-14 20:03:29 -04:00
if (!esp_netif_is_netif_up(self->netif)) {
return mp_const_none;
}
2020-09-22 00:36:46 -04:00
esp_netif_get_ip_info(self->netif, &self->ip_info);
return common_hal_ipaddress_new_ipv4address(self->ip_info.ip.addr);
2020-07-28 21:23:33 -04:00
}
2021-04-23 22:44:34 -04:00
mp_obj_t common_hal_wifi_radio_get_ipv4_address_ap(wifi_radio_obj_t *self) {
if (!esp_netif_is_netif_up(self->ap_netif)) {
return mp_const_none;
}
esp_netif_get_ip_info(self->ap_netif, &self->ip_info);
return common_hal_ipaddress_new_ipv4address(self->ip_info.ip.addr);
}
2020-09-28 19:49:20 -04:00
mp_obj_t common_hal_wifi_radio_get_ipv4_dns(wifi_radio_obj_t *self) {
if (!esp_netif_is_netif_up(self->netif)) {
return mp_const_none;
}
esp_netif_get_dns_info(self->netif, ESP_NETIF_DNS_MAIN, &self->dns_info);
// dns_info is of type esp_netif_dns_info_t, which is just ever so slightly
// different than esp_netif_ip_info_t used for
// common_hal_wifi_radio_get_ipv4_address (includes both ipv4 and 6),
// so some extra jumping is required to get to the actual address
return common_hal_ipaddress_new_ipv4address(self->dns_info.ip.u_addr.ip4.addr);
2020-07-28 21:23:33 -04:00
}
2020-08-10 20:56:49 -04:00
mp_int_t common_hal_wifi_radio_ping(wifi_radio_obj_t *self, mp_obj_t ip_address, mp_float_t timeout) {
esp_ping_config_t ping_config = ESP_PING_DEFAULT_CONFIG();
ipaddress_ipaddress_to_esp_idf(ip_address, &ping_config.target_addr);
ping_config.count = 1;
size_t timeout_ms = timeout * 1000;
esp_ping_handle_t ping;
esp_ping_new_session(&ping_config, NULL, &ping);
esp_ping_start(ping);
uint32_t received = 0;
uint32_t total_time_ms = 0;
2020-09-03 19:32:12 -04:00
while (received == 0 && total_time_ms < timeout_ms && !mp_hal_is_interrupted()) {
2020-08-14 20:03:29 -04:00
RUN_BACKGROUND_TASKS;
esp_ping_get_profile(ping, ESP_PING_PROF_DURATION, &total_time_ms, sizeof(total_time_ms));
esp_ping_get_profile(ping, ESP_PING_PROF_REPLY, &received, sizeof(received));
2020-08-10 20:56:49 -04:00
}
2020-08-14 20:03:29 -04:00
uint32_t elapsed_time = 0xffffffff;
2020-08-10 20:56:49 -04:00
if (received > 0) {
2020-08-14 20:03:29 -04:00
esp_ping_get_profile(ping, ESP_PING_PROF_TIMEGAP, &elapsed_time, sizeof(elapsed_time));
2020-08-10 20:56:49 -04:00
}
esp_ping_delete_session(ping);
2020-08-14 20:03:29 -04:00
return elapsed_time;
2020-07-28 21:23:33 -04:00
}
2020-12-07 11:06:33 -05:00
void common_hal_wifi_radio_gc_collect(wifi_radio_obj_t *self) {
// Only bother to scan the actual object references.
gc_collect_ptr(self->current_scan);
}