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 Library Index
- ESP32 WiFiClient Library
- ESP32 HTTPClient Library
- ESP32 WiFiClientSecure Library
- ESP32 WebServer Library
- ESP32 WiFi Library
- Which ESP32 Boards are Recommended for Learners
- How to Copy Codes from AvantMaker.com
- What is SPIFFS and how to upload files to it?
- What is LIttleFS and how to upload files to it?
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!