The ESP8266 is like a super cheap Arduino with WiFi built in. You can get ESP8266 boards for like $3-5, and they're perfect for IoT projects. If you want to make things that connect to the internet without spending a lot, this is the way to go.

This guide will get you started with your first ESP8266 program. By the end, you'll have it connected to WiFi and serving a web page.

What You'll Need

• An ESP8266 board (NodeMCU or Wemos D1 Mini are popular choices)
• USB cable (usually micro USB)
• Arduino IDE
• WiFi network

That's it. ESP8266 boards are pretty self-contained.

Step 1: Install ESP8266 Support

Like ESP32, you need to add ESP8266 support to Arduino IDE. Go to File → Preferences, and in "Additional Boards Manager URLs", add:

http://arduino.esp8266.com/stable/package_esp8266com_index.json

Then go to Tools → Board → Boards Manager, search for "ESP8266", and install "esp8266 by ESP8266 Community". This takes a few minutes.

Step 2: Select Your Board

Plug in your ESP8266. Go to Tools → Board and select your board (probably "NodeMCU 1.0" or "LOLIN(Wemos) D1 R2 & mini" depending on what you have).

Then select the port (Tools → Port). Some ESP8266 boards need specific drivers - if it doesn't show up, you might need to install CH340 or CP2102 drivers.

Step 3: Your First Program - Blink

Let's start with the classic blink. Most ESP8266 boards have an LED on pin 2 (or GPIO2). Here's the code:

void setup() {
  pinMode(2, OUTPUT);
}

void loop() {
  digitalWrite(2, HIGH);
  delay(1000);
  digitalWrite(2, LOW);
  delay(1000);
}

Upload it. If the LED blinks, you're good!

Step 4: Connect to WiFi

Now let's connect to WiFi. Here's a basic example:

#include <ESP8266WiFi.h>

const char* ssid = "YourWiFiName";
const char* password = "YourWiFiPassword";

void setup() {
  Serial.begin(115200);
  pinMode(2, OUTPUT);
  
  WiFi.begin(ssid, password);
  
  Serial.print("Connecting");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
    digitalWrite(2, !digitalRead(2));
  }
  
  Serial.println("");
  Serial.println("WiFi connected!");
  Serial.print("IP: ");
  Serial.println(WiFi.localIP());
  
  digitalWrite(2, HIGH);
}

void loop() {
  // Your code here
}

Replace the WiFi credentials, upload it, and open Serial Monitor (115200 baud). You should see it connect and print an IP address.

Note: ESP8266 only works with 2.4GHz WiFi, not 5GHz. Make sure your router has 2.4GHz enabled.

Step 5: Create a Web Server

Let's make it serve a web page:

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>

const char* ssid = "YourWiFiName";
const char* password = "YourWiFiPassword";

ESP8266WebServer server(80);

void handleRoot() {
  server.send(200, "text/html", "<h1>ESP8266 Works!</h1><p>Hello from your ESP8266</p>");
}

void setup() {
  Serial.begin(115200);
  
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  
  Serial.println("");
  Serial.print("IP: ");
  Serial.println(WiFi.localIP());
  
  server.on("/", handleRoot);
  server.begin();
}

void loop() {
  server.handleClient();
}

Upload this, wait for connection, then open a browser and go to the IP address. You should see your web page!

ESP8266 vs ESP32

ESP8266 is cheaper and simpler. ESP32 is more powerful (dual core, Bluetooth, more GPIO pins) but costs more. For simple WiFi projects, ESP8266 is perfect. For more complex stuff, ESP32 is better.

Common Issues

• Won't upload: Make sure you selected the right board. Some boards need you to hold a button while uploading.
• Can't connect to WiFi: Check credentials, make sure it's 2.4GHz, check signal strength.
• Board not found: Install drivers (CH340 or CP2102, depending on your board).