WiFiSTAClass::begin()

名称

WiFiSTAClass::begin()

説明

WiFiのアクセスポイントに接続する。

書式

#include <WiFi.h>

wl_status_t WiFiSTAClass::begin(const char* ssid, const char *passphrase, int32_t channel, const uint8_t* bssid, bool connect);

wl_status_t WiFiSTAClass::begin(char* ssid, char *passphrase, int32_t channel, const uint8_t* bssid, bool connect);

wl_status_t WiFiSTAClass::begin();

この形式は、おそらく、esp_wifi_set_config()や、前半のbegin()を利用して設定した値をそのまま用いるものだと思います。

wl_status_t WiFiSTAClass::begin(const char* wpa2_ssid, wpa2_auth_method_t method, const char* wpa2_identity, const char* wpa2_username, const char *wpa2_password, const char* ca_pem, const char* client_crt, const char* client_key, int32_t channel, const uint8_t* bssid, bool connect);

引数

ssid
接続するSSID。
passphrase
接続するSSIDに接続するためのパスフレーズ。省略した場合は、NULLが設定される。
channel
接続する無線LANチャンネル。省略可。省略した場合は、0が設定される。
bssid
接続する無線LANのBSSID。省略可。省略した場合は、NULLが設定される。
connect
アクセスポイントに接続するかどうか。省略可。省略した場合は、trueが設定される。

戻り値

接続状態。

返却されるのは、以下のenum型。

typedef enum {
    WL_NO_SHIELD        = 255,   // for compatibility with WiFi Shield library
    WL_IDLE_STATUS      = 0,
    WL_NO_SSID_AVAIL    = 1,
    WL_SCAN_COMPLETED   = 2,
    WL_CONNECTED        = 3,
    WL_CONNECT_FAILED   = 4,
    WL_CONNECTION_LOST  = 5,
    WL_DISCONNECTED     = 6
} wl_status_t;

注意

WiFiというWiFiClassのオブジェクトが事前に定義されており、このオブジェクトを利用して操作する。

WiFiClassは、WiFiGenericClass、WiFiSTAClass、WiFiScanClass、WiFiAPClassWiFiを継承したクラスである。

使用例

バージョン

Hardware:ESP-WROOM-32
Software:Arduino core for the ESP32 2.0.4

最終更新日

September 4, 2022

inserted by FC2 system