ESP32 WiFi Library – WiFi.BSSIDstr

Home / References / ESP32 Library / WiFi API / Station

Description

The BSSIDstr method retrieves the MAC address (BSSID) of the currently connected Wi-Fi network Access Point device. This method is useful for identifying the specific access point the ESP32 is connected to.


Syntax and Usage

The BSSIDstr method does not require any arguments and returns the MAC address of the connected access point in string format. Here is how you can use it:

WiFi.BSSIDstr()

Argument(s)

This method does not accept any arguments.


Return Value

The BSSIDstr method returns a String containing the MAC address of the connected Wi-Fi network access point device. If the ESP32 is not connected to a Wi-Fi network, this method will return an empty string.


Example Codes

This code demonstrates how to use the ESP32 WiFi Library’s BSSIDstr() method to retrieve the Basic Service Set Identifier (BSSID) of the currently connected WiFi network. The BSSID is the MAC address of the access point (router) to which the ESP32 is connected. This information is useful for identifying the specific router or access point in use.

To use this code, replace “your_SSID” and “your_PASSWORD” with your WiFi network’s SSID and password. Upload the code to your ESP32 board and open the Serial Monitor at 115200 baud. The code will connect to the WiFi network and display the BSSID as a string. Ensure the ESP32 is within range of the WiFi signal for a successful connection.

/*
 * Author: Avant Maker
 * Date: February 7, 2025
 * Version: 1.0
 * Description: This code demonstrates how to connect an ESP32 to a WiFi network and 
 * retrieve the BSSID (the MAC address) of the connected WiFi access point using 
 * the ESP32's WiFi library. 
 *
 * License: MIT 
 * 
 * Code Source: This example code is sourced from the Comprehensive Guide
 * to the ESP32 Arduino Core Library, accessible on AvantMaker.com. 
 * For additional code examples and in-depth documentation related to 
 * the ESP32 Arduino Core Library, please visit:
 *
 * https://avantmaker.com/references/esp32-arduino-core-index/
 *
 * AvantMaker.com, your premier destination for all things DIY, AI, IoT, 
 * Smart Home, and STEM projects. We are dedicated to empowering makers,
 * learners, and enthusiasts with the resources they need to bring their 
 * innovative ideas to life.
 */

#include <WiFi.h>

const char* ssid = "your_SSID";
const char* password = "your_PASSWORD";

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    Serial.println("Connecting to WiFi...");
    while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
    }
    Serial.println("\nConnected to WiFi!");

    // Retrieve and print the BSSID
    String bssidStr = WiFi.BSSIDstr();
    Serial.print("Current BSSID: ");
    Serial.println(bssidStr);
}

void loop() {
    // Your code here
}

AvantMaker Tutorial Suggestion

If you want to learn more about the ESP32’s WiFi capabilities, we’ve created a beginner-friendly guide that explains them in detail. Just click the link below, and you’ll be teleported to that page. It will clear up any confusion you may have while connecting your ESP32 to WiFi or setting it up as a WiFi access point (AP).

ESP32 Essential Guide – Network Section – WiFi Chapter

ESP32 Library Index

ESP32 Arduino Core Library


FAQ

Ready to experiment and explore more about ESP32? Visit our website’s All About ESP32 Resources Hub, packed with tutorials, guides, and tools to inspire your maker journey. Experiment, explore, and elevate your skills with everything you need to master this powerful microcontroller platform!

error: Content is protected !!