{"id":98407,"date":"2020-07-29T20:42:43","date_gmt":"2020-07-29T20:42:43","guid":{"rendered":"https:\/\/randomnerdtutorials.com\/?p=98407"},"modified":"2020-07-29T20:42:52","modified_gmt":"2020-07-29T20:42:52","slug":"esp8266-nodemcu-static-fixed-ip-address-arduino","status":"publish","type":"post","link":"https:\/\/randomnerdtutorials.com\/esp8266-nodemcu-static-fixed-ip-address-arduino\/","title":{"rendered":"ESP8266 NodeMCU Static\/Fixed IP Address (Arduino IDE)"},"content":{"rendered":"\n

This tutorial shows how to set a static\/fixed IP address for your ESP8266 NodeMCU board. If you\u2019re running a web server or Wi-Fi client with your ESP8266 and every time you restart your board, it has a new IP address, you can follow this tutorial to assign a static\/fixed IP address.<\/p>\n\n\n\n

\"Set<\/figure><\/div>\n\n\n\n

Static\/Fixed IP Address Sketch<\/h2>\n\n\n\n

To show you how to fix your ESP8266 IP address, we\u2019ll use the ESP8266 Web Sever code<\/a> as an example. By the end of our explanation you should be able to fix your IP address regardless of the web server or Wi-Fi project you\u2019re building.<\/p>\n\n\n\n

Copy the code below to your Arduino IDE, but don\u2019t upload it yet. You need to make some changes to make it work for you.<\/p>\n\n\n\n

Note<\/strong>: if you upload the next sketch to your ESP8266 board, it should automatically assign the fixed IP address 192.168.1.184<\/strong>.<\/p>\n\n\n

\/*********\n  Rui Santos\n  Complete project details at https:\/\/RandomNerdTutorials.com\/esp8266-nodemcu-static-fixed-ip-address-arduino\/\n*********\/\n\n\/\/ Load Wi-Fi library\n#include <ESP8266WiFi.h>\n\n\/\/ Replace with your network credentials\nconst char* ssid     = "REPLACE_WITH_YOUR_SSID";\nconst char* password = "REPLACE_WITH_YOUR_PASSWORD";\n\n\/\/ Set web server port number to 80\nWiFiServer server(80);\n\n\/\/ Variable to store the HTTP request\nString header;\n\n\/\/ Auxiliar variables to store the current output state\nString output5State = "off";\nString output4State = "off";\n\n\/\/ Assign output variables to GPIO pins\nconst int output5 = 5;\nconst int output4 = 4;\n\n\/\/ Current time\nunsigned long currentTime = millis();\n\/\/ Previous time\nunsigned long previousTime = 0; \n\/\/ Define timeout time in milliseconds (example: 2000ms = 2s)\nconst long timeoutTime = 2000;\n\n\/\/ Set your Static IP address\nIPAddress local_IP(192, 168, 1, 184);\n\/\/ Set your Gateway IP address\nIPAddress gateway(192, 168, 1, 1);\n\nIPAddress subnet(255, 255, 0, 0);\nIPAddress primaryDNS(8, 8, 8, 8);   \/\/optional\nIPAddress secondaryDNS(8, 8, 4, 4); \/\/optional\n\nvoid setup() {\n  Serial.begin(115200);\n  \/\/ Initialize the output variables as outputs\n  pinMode(output5, OUTPUT);\n  pinMode(output4, OUTPUT);\n  \/\/ Set outputs to LOW\n  digitalWrite(output5, LOW);\n  digitalWrite(output4, LOW);\n  \n  \/\/ Configures static IP address\n  if (!WiFi.config(local_IP, gateway, subnet, primaryDNS, secondaryDNS)) {\n    Serial.println("STA Failed to configure");\n  }\n  \n  \/\/ Connect to Wi-Fi network with SSID and password\n  Serial.print("Connecting to ");\n  Serial.println(ssid);\n  WiFi.begin(ssid, password);\n  while (WiFi.status() != WL_CONNECTED) {\n    delay(500);\n    Serial.print(".");\n  }\n  \/\/ Print local IP address and start web server\n  Serial.println("");\n  Serial.println("WiFi connected.");\n  Serial.println("IP address: ");\n  Serial.println(WiFi.localIP());\n  server.begin();\n}\n\nvoid loop(){\n  WiFiClient client = server.available();   \/\/ Listen for incoming clients\n\n  if (client) {                             \/\/ If a new client connects,\n    Serial.println("New Client.");          \/\/ print a message out in the serial port\n    String currentLine = "";                \/\/ make a String to hold incoming data from the client\n    currentTime = millis();\n    previousTime = currentTime;\n    while (client.connected() && currentTime - previousTime <= timeoutTime) { \/\/ loop while the client's connected\n      currentTime = millis();         \n      if (client.available()) {             \/\/ if there's bytes to read from the client,\n        char c = client.read();             \/\/ read a byte, then\n        Serial.write(c);                    \/\/ print it out the serial monitor\n        header += c;\n        if (c == '\\n') {                    \/\/ if the byte is a newline character\n          \/\/ if the current line is blank, you got two newline characters in a row.\n          \/\/ that's the end of the client HTTP request, so send a response:\n          if (currentLine.length() == 0) {\n            \/\/ HTTP headers always start with a response code (e.g. HTTP\/1.1 200 OK)\n            \/\/ and a content-type so the client knows what's coming, then a blank line:\n            client.println("HTTP\/1.1 200 OK");\n            client.println("Content-type:text\/html");\n            client.println("Connection: close");\n            client.println();\n            \n            \/\/ turns the GPIOs on and off\n            if (header.indexOf("GET \/5\/on") >= 0) {\n              Serial.println("GPIO 5 on");\n              output5State = "on";\n              digitalWrite(output5, HIGH);\n            } else if (header.indexOf("GET \/5\/off") >= 0) {\n              Serial.println("GPIO 5 off");\n              output5State = "off";\n              digitalWrite(output5, LOW);\n            } else if (header.indexOf("GET \/4\/on") >= 0) {\n              Serial.println("GPIO 4 on");\n              output4State = "on";\n              digitalWrite(output4, HIGH);\n            } else if (header.indexOf("GET \/4\/off") >= 0) {\n              Serial.println("GPIO 4 off");\n              output4State = "off";\n              digitalWrite(output4, LOW);\n            }\n            \n            \/\/ Display the HTML web page\n            client.println("<!DOCTYPE html><html>");\n            client.println("<head><meta name=\\"viewport\\" content=\\"width=device-width, initial-scale=1\\">");\n            client.println("<link rel=\\"icon\\" href=\\"data:,\\">");\n            \/\/ CSS to style the on\/off buttons \n            \/\/ Feel free to change the background-color and font-size attributes to fit your preferences\n            client.println("<style>html { font-family: Helvetica; display: inline-block; margin: 0px auto; text-align: center;}");\n            client.println(".button { background-color: #195B6A; border: none; color: white; padding: 16px 40px;");\n            client.println("text-decoration: none; font-size: 30px; margin: 2px; cursor: pointer;}");\n            client.println(".button2 {background-color: #77878A;}<\/style><\/head>");\n            \n            \/\/ Web Page Heading\n            client.println("<body><h1>ESP8266 Web Server<\/h1>");\n            \n            \/\/ Display current state, and ON\/OFF buttons for GPIO 5  \n            client.println("<p>GPIO 5 - State " + output5State + "<\/p>");\n            \/\/ If the output5State is off, it displays the ON button       \n            if (output5State=="off") {\n              client.println("<p><a href=\\"\/5\/on\\"><button class=\\"button\\">ON<\/button><\/a><\/p>");\n            } else {\n              client.println("<p><a href=\\"\/5\/off\\"><button class=\\"button button2\\">OFF<\/button><\/a><\/p>");\n            } \n               \n            \/\/ Display current state, and ON\/OFF buttons for GPIO 4  \n            client.println("<p>GPIO 4 - State " + output4State + "<\/p>");\n            \/\/ If the output4State is off, it displays the ON button       \n            if (output4State=="off") {\n              client.println("<p><a href=\\"\/4\/on\\"><button class=\\"button\\">ON<\/button><\/a><\/p>");\n            } else {\n              client.println("<p><a href=\\"\/4\/off\\"><button class=\\"button button2\\">OFF<\/button><\/a><\/p>");\n            }\n            client.println("<\/body><\/html>");\n            \n            \/\/ The HTTP response ends with another blank line\n            client.println();\n            \/\/ Break out of the while loop\n            break;\n          } else { \/\/ if you got a newline, then clear currentLine\n            currentLine = "";\n          }\n        } else if (c != '\\r') {  \/\/ if you got anything else but a carriage return character,\n          currentLine += c;      \/\/ add it to the end of the currentLine\n        }\n      }\n    }\n    \/\/ Clear the header variable\n    header = "";\n    \/\/ Close the connection\n    client.stop();\n    Serial.println("Client disconnected.");\n    Serial.println("");\n  }\n}\n<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
Setting Your Network Credentials<\/h3>\n\n\n\n
You need to modify the following lines with your network credentials: SSID and password.<\/p>\n\n\n\n
\/\/ Replace with your network credentials\nconst char* ssid = \"REPLACE_WITH_YOUR_SSID\";\nconst char* password = \"REPLACE_WITH_YOUR_PASSWORD\";<\/code><\/pre>\n\n\n\n
Setting ESP8266 Static IP Address<\/h3>\n\n\n\n
Then, outside the setup()<\/span> and loop()<\/span> functions, you define the following variables with your own static IP address and corresponding gateway IP address.<\/p>\n\n\n\n
By default, the next code assigns the IP address 192.168.1.184<\/strong> that works in the gateway 192.168.1.1<\/strong>.<\/p>\n\n\n\n
\/\/ Set your Static IP address\nIPAddress local_IP(192, 168, 1, 184);\n\/\/ Set your Gateway IP address\nIPAddress gateway(192, 168, 1, 1);\n\nIPAddress subnet(255, 255, 0, 0);\nIPAddress primaryDNS(8, 8, 8, 8); \/\/ optional\nIPAddress secondaryDNS(8, 8, 4, 4); \/\/ optional<\/code><\/pre>\n\n\n\n
Important<\/strong>: you need to use an available IP address in your local network and the corresponding gateway.<\/p>\n\n\n\n
setup()<\/h3>\n\n\n\n
In the setup()<\/span> you need to call the WiFi.config()<\/span> method to assign the configurations to your ESP8266.<\/p>\n\n\n\n
\/\/ Configures static IP address\nif (!WiFi.config(local_IP, gateway, subnet, primaryDNS, secondaryDNS)) {\n  Serial.println(\"STA Failed to configure\");\n}<\/code><\/pre>\n\n\n\n
Note:<\/strong> the primaryDNS <\/em><\/strong>and secondaryDNS<\/em> <\/strong>parameters are optional and you can remove them.<\/p>\n\n\n\n
Testing<\/h3>\n\n\n\n
After uploading the code to your board, open the Arduino IDE Serial Monitor at the baud rate 115200, restart your ESP8266 board and the IP address defined earlier should be assigned to your board.<\/p>\n\n\n\n
\"ESP8266<\/figure><\/div>\n\n\n\n
As you can see, it prints the IP address 192.168.1.184<\/strong>.<\/p>\n\n\n\n
You can take this example and add it to all your Wi-Fi sketches to assign a fixed IP address to your ESP8266.<\/p>\n\n\n\n
Assigning IP Address with MAC Address<\/h2>\n\n\n\n
If you\u2019ve tried to assign a fixed IP address to the ESP8266 using the previous example and it doesn\u2019t work, we recommend assigning an IP address directly in your router settings through the ESP8266 MAC Address<\/a>.<\/p>\n\n\n\n
Upload the following code to the ESP8266 board:<\/p>\n\n\n
\/*\n  Rui Santos & Sara Santos - Random Nerd Tutorials\n  Complete project details at https:\/\/RandomNerdTutorials.com\/get-change-esp32-esp8266-mac-address-arduino\/\n  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.  \n  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n*\/\n#ifdef ESP32\n  #include <WiFi.h>\n  #include <esp_wifi.h>\n#else\n  #include <ESP8266WiFi.h>\n#endif\n\nvoid setup(){\n  Serial.begin(115200);\n\n  Serial.print("ESP Board MAC Address: ");\n  #ifdef ESP32\n    WiFi.mode(WIFI_STA);\n    WiFi.STA.begin();\n    uint8_t baseMac[6];\n    esp_err_t ret = esp_wifi_get_mac(WIFI_IF_STA, baseMac);\n    if (ret == ESP_OK) {\n      Serial.printf("%02x:%02x:%02x:%02x:%02x:%02x\\n",\n                    baseMac[0], baseMac[1], baseMac[2],\n                    baseMac[3], baseMac[4], baseMac[5]);\n    } else {\n      Serial.println("Failed to read MAC address");\n    }\n  #else\n    Serial.println(WiFi.macAddress());\n  #endif\n}\n \nvoid loop(){\n\n}\n<\/code><\/pre>\n\t
View raw code<\/a><\/p>\n\n\n\n
In the setup()<\/span>, it prints the ESP8266 MAC Address in the Serial Monitor:<\/p>\n\n\n\n
\/\/ Print ESP MAC Address\nSerial.println(\"MAC address: \");\nSerial.println(WiFi.macAddress());<\/code><\/pre>\n\n\n\n
\"\"<\/figure><\/div>\n\n\n\n
In our case, the ESP8266 MAC Address is B4:E6:2D:97:EE:F1<\/strong>. Copy the MAC Address, because you\u2019ll need it in just a moment.<\/p>\n\n\n\n
Router Settings<\/h3>\n\n\n\n
If you login into your router admin page, there should be a page\/menu where you can assign an IP address to a network device. Each router has different menus and configurations. So, we can\u2019t provide instructions on how do to it for all the available routers.<\/p>\n\n\n\n
We recommend Googling \u201cassign IP address to MAC address<\/strong>\u201d followed by your router name. You should find some instructions that show how to assign the IP to a MAC address for your specific router.<\/p>\n\n\n\n
In summary, if you go to your router configurations menu, you should be able to assign your desired IP address to your ESP8266 MAC address (for example B4:E6:2D:97:EE:F1).<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
After following this tutorial you should be able to assign a fixed\/static IP address to your ESP8266. If you have an ESP32, you can read this guide Set ESP32 Static\/Fixed IP Address<\/a>.<\/p>\n\n\n\n
We hope you’ve found this tutorial useful. If you like ESP8266, you may also like:<\/p>\n\n\n\n