Home / References / ESP32 Library / WiFi API / Station
Description
The localIP
method retrieves the local IP address of the ESP32 when it is connected to a Wi-Fi network. This IP address is assigned by the router and is used for network communication.
Syntax and Usage
This method returns the local IP address of the ESP32 when it is connected to a Wi-Fi network.
IPAddress localIP = WiFi.localIP();
Argument(s)
This method does not accept any arguments.
Return Value
The localIP
method returns an IPAddress
object that contains the local IP address of the ESP32. If the ESP32 is not connected to a Wi-Fi network, this method will return 0.0.0.0
.
Example Codes
This code demonstrates how to use the ESP32 WiFi Library to connect to a WiFi network and retrieve the local IP address assigned to the device. It uses the WiFi.begin()
method to initiate the connection and the WiFi.localIP()
method to obtain the IP address. Once connected, the code prints the local IP address to the Serial Monitor for verification.
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 attempt to connect to the WiFi network and display the local IP address once connected. Ensure your ESP32 is within range of the WiFi signal for a successful connection.
/*
* Author: Avant Maker
* Date (MM-DD-YY): 02-06-25
* Version: 1.0
* Description: This code demonstrates how to retrieve and prints
* the IP address assigned to the ESP32 by WiFi.localIP().
*
* Code Source: ESP32 Arduino Library Example Code
*
* For more detailed explanation about
* this code please refer to 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 local IP address
IPAddress localIP = WiFi.localIP();
Serial.print("Local IP address: ");
Serial.println(localIP);
}
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!