WiFi練習：熱點模式

熱點模式(Access Point)可讓其他裝置透過WiFi連接到 ESP32，也稱為 SoftAP(Software Access Point)模式，常應用於點對點的本地通訊控制。熱點模式開啟的基本範例如下：

// ------------------------------------------------
#include <WiFi.h>             // 引用WiFi函式庫
const char *ssid="SSID";      // 熱點名稱
const char *password="密碼";  // 熱點密碼
// ------------------------------------------------

void setup() {

  Serial.begin(9600);    // 啟用串列埠監看視窗

  // -------------------------------------------------------------------------------------------
  /*
  IPAddress local_ip(192,168,1,1);    // 設定熱點的IP位址
  IPAddress gateway(192,168,1,1);     // 設定熱點的閘道位址
  IPAddress subnet(255,255,255,0);    // 設定熱點的子網路遮罩位址
  WiFi.softAPConfig(local_ip, gateway, subnet); // 設定熱點參數(未設定時，熱點IP位址預設為192.168.4.1)
  */
  while(!WiFi.softAP(ssid, password)) // 若熱點尚未啟動，則每0.5秒印出一個點
  {
    delay(500);
    Serial.print(".");
  }
  Serial.println("\n----------------------------------");
  Serial.println("熱點啟動成功");
  Serial.print("IP Address: ");
  Serial.println(WiFi.softAPIP());    // 印出熱點的IP位址
  // -------------------------------------------------------------------------------------------
}

void loop() {
}

將上述開啟熱點模式寫成副程式startAP()，引用esp_wifi函式庫，透過WiFi事件處理函式，可將連線到ESP32的裝置清單印出，如以下的範例程式：

//-------------------------------------------------------------------------------------------------------------------------
#include <WiFi.h>             // 引用WiFi函式庫
const char *ssid="SSID";      // 熱點名稱
const char *password="密碼";  // 熱點密碼
//-------------------------------------------------------------------------------------------------------------------------
void startAP()  // 啟用熱點
{
  /*
  IPAddress local_ip(192,168,1,1);    // 設定熱點的IP位址
  IPAddress gateway(192,168,1,1);     // 設定熱點的閘道位址
  IPAddress subnet(255,255,255,0);    // 設定熱點的子網路遮罩位址
  WiFi.softAPConfig(local_ip, gateway, subnet); // 設定熱點參數(未設定時，熱點IP位址預設為192.168.4.1)
  */
  while(!WiFi.softAP(ssid, password)) // 若熱點尚未啟動，則每0.5秒印出一個點
  {
    delay(500);
    Serial.print(".");
  }
  Serial.println("\n----------------------------------");
  Serial.println("熱點啟動成功");
  Serial.print("IP Address: ");
  Serial.println(WiFi.softAPIP());    // 印出熱點的IP位址
}
//-------------------------------------------------------------------------------------------------------------------------
#include <esp_wifi.h>         // 引用esp_wifi函式庫
void WiFiEvent(WiFiEvent_t event, arduino_event_info_t info)  // WiFi事件處理函式
{
  uint8_t* mac = nullptr;     // 宣告MAC位址指標
  char macStr[18] = {0};      // 儲存格式化MAC位址的字串緩衝區

  switch (event)
  {
    case ARDUINO_EVENT_WIFI_AP_STACONNECTED:      // 裝置已連線
      // 從事件資訊中提取MAC位址，並將MAC位址格式化為字串(XX:XX:XX:XX:XX:XX)
      mac = info.wifi_ap_staconnected.mac;
      snprintf(macStr, sizeof(macStr), "%02X:%02X:%02X:%02X:%02X:%02X", mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);
      Serial.println("\n[事件] 裝置已連線");
      Serial.print("MAC: ");
      Serial.println(macStr);
      listConnectedStations();  // 更新並顯示當前連線裝置清單
      break;

    case ARDUINO_EVENT_WIFI_AP_STADISCONNECTED:   // 裝置斷開連線
      // 從事件資訊中提取MAC位址，並將MAC位址格式化為字串(XX:XX:XX:XX:XX:XX)
      mac = info.wifi_ap_stadisconnected.mac;
      snprintf(macStr, sizeof(macStr), "%02X:%02X:%02X:%02X:%02X:%02X", mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);
      Serial.println("\n[事件] 裝置已斷開連線");
      Serial.print("MAC: ");
      Serial.println(macStr);
      listConnectedStations();  // 更新並顯示當前連線裝置清單
      break;
  }
}
//-------------------------------------------------------------------------------------------------------------------------
void listConnectedStations()  // 印出已連線裝置清單
{
  wifi_sta_list_t station_list;             // 儲存連線裝置列表的結構
  esp_wifi_ap_get_sta_list(&station_list);  // 獲取當前連接到AP的所有裝置列表
  
  Serial.println("--------- 當前連線裝置清單 ---------");
  Serial.print("連線裝置數量: ");
  Serial.println(station_list.num);
  Serial.println("----------------------------------");
  
  if (station_list.num > 0) {
    Serial.println("編號       MAC 位址       IP 位址");
    Serial.println("----------------------------------");
    
    for (int i = 0; i < station_list.num; i++) {
      wifi_sta_info_t station = station_list.sta[i];
      
      // 取得 MAC 位址
      char macStr[18];
      snprintf(macStr, sizeof(macStr), "%02X:%02X:%02X:%02X:%02X:%02X",station.mac[0], station.mac[1], station.mac[2], station.mac[3], station.mac[4], station.mac[5]);
      
      // 取得 IP 位址 (需要透過 DHCP 租約列表)
      IPAddress ip = WiFi.softAPIP();
      ip[3] = i + 2; // 預設分配從 .2 開始
      
      // 顯示裝置資訊
      Serial.printf("%2d  %s  %s\n", i + 1, macStr, ip.toString().c_str());
    }
  } else {
    Serial.println("目前沒有裝置連線");
  }
  
  Serial.println("----------------------------------");
}
//-------------------------------------------------------------------------------------------------------------------------

void setup() {
  Serial.begin(9600);       // 啟用串列埠監看視窗
  startAP();                // 啟用熱點
  WiFi.onEvent(WiFiEvent);  // 啟用WiFi事件處理
  listConnectedStations();  // 印出已連線裝置清單
}

void loop() {
}