使用 ESP32 IDF（Espressif IoT Development Framework）來掃描附近的 SSID（Wi-Fi 網路名稱）是一項常見的功能。透過 ESP32 的 Wi-Fi 模組，設備可以掃描周圍的 Wi-Fi 網路並取得相關資訊，例如 SSID、訊號強度（RSSI）等。

確保你已經安裝和配置好了 ESP-IDF 開發環境。您也可以參考 ESP32 入門到精通 – 在 VSCode 安裝 ESP-IDF 插件 這篇文章。

選擇一個 ESP32 模組如 ESP32 DevKitC V4。

利用在 VSCode 的 IDF 插件來新建一個 ESP32 專案可參考 ESP32 入門到精通 – 如何用 VSCode 創建 ESP32 專案。

以下是一個使用 ESP-IDF 來掃描 Wi-Fi 網路的程式範例。它將掃描周圍的 Wi-Fi 網路，並列印出它們的 SSID 及訊號強度（RSSI）。

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_wifi.h"
#include "esp_log.h"
#include "nvs_flash.h"

#define DEFAULT_SCAN_LIST_SIZE 20  // Define the number of APs to store

static const char *TAG = "wifi_scan";

void wifi_scan(void *pvParameters) {
    // 1. Initialize Wi-Fi
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    // 2. Set Wi-Fi mode to STA (Station)
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
    ESP_ERROR_CHECK(esp_wifi_start());

    // 3. Configure scan parameters
    wifi_scan_config_t scan_config = {
        .ssid = NULL,
        .bssid = NULL,
        .channel = 0,
        .show_hidden = true
    };

    // 4. Start Wi-Fi scan
    ESP_ERROR_CHECK(esp_wifi_scan_start(&scan_config, true));

    // 5. Get scan results
    uint16_t number = DEFAULT_SCAN_LIST_SIZE;
    wifi_ap_record_t ap_info[DEFAULT_SCAN_LIST_SIZE];
    ESP_ERROR_CHECK(esp_wifi_scan_get_ap_records(&number, ap_info));

    // 6. Get number of scanned networks
    uint16_t ap_count = 0;
    ESP_ERROR_CHECK(esp_wifi_scan_get_ap_num(&ap_count));
    ESP_LOGI(TAG, "Total APs found: %u", ap_count);

    // 7. Print all SSIDs and RSSI (signal strength)
    for (int i = 0; i < ap_count; i++) {
        ESP_LOGI(TAG, "SSID: %s, RSSI: %d", ap_info[i].ssid, ap_info[i].rssi);
    }

    // Stop the Wi-Fi module
    ESP_ERROR_CHECK(esp_wifi_stop());

    vTaskDelete(NULL);  // Delete task
}

void app_main(void) {
    // Initialize NVS
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    // Create Wi-Fi scan task
    xTaskCreate(&wifi_scan, "wifi_scan", 4096, NULL, 5, NULL);
}

在 VSCode 中找到 "ESP32-IDF : Build, Flash and Monitor" ICON 執行和燒錄。

在 ESP32 上執行 Wi-Fi 掃描程式碼後，結果將會透過串口監視器（例如 idf.py monitor）列印出來。以下是你可能在串口監視器上看到的結果範例：

I (2894) wifi_scan: Total APs found: 5
I (2894) wifi_scan: SSID: MyWiFi, RSSI: -55
I (2894) wifi_scan: SSID: CafeNetwork, RSSI: -60
I (2894) wifi_scan: SSID: OfficeWiFi, RSSI: -45
I (2894) wifi_scan: SSID: GuestNetwork, RSSI: -70
I (2894) wifi_scan: SSID: HiddenSSID, RSSI: -80

透過串口監視器你將會看到設備列印出周圍的 Wi-Fi SSID 和對應的訊號強度。
這段程式碼會掃描附近的所有 Wi-Fi 網路，並顯示它們的名稱和訊號強度。