Adafruit Feather HUZZAH with ESP8266 WiFi

Feather is the new development board from Adafruit, and like its namesake it is thin, light, and lets you fly! We designed Feather to be a new standard for portable microcontroller cores....

The ESP8266 based Feather HUZZAH & the HUZZAH ESP8266 breakout are both very popular options for connecting projects to Adafruit IO. In this guide we are going to walk through the setup needed to get your ESP8266 up and running with the Arduino IDE & Adafruit IO. This same basic setup can be used as you progress through our Adafruit IO Basics series of guides.

Before you continue with this guide, you should consider running through the guides for the ESP8266 Feather or the ESP8266 breakout. We will cover all of the basic setup needed for connecting your ESP8266 to Adafruit IO, but the individual guides go into greater detail about each board.

Pros/Cons of the ESP8266

Here are some quick pros & cons if you are considering using the ESP8266 for your Adafruit IO project.


  • Low cost
  • Great support via the ESP8266 Arduino community
  • Can be programmed using Lua & Python (MicroPython), in addition to Arduino
  • Fast Uploads


  • Power hungry
  • Limited number of GPIO pins
  • One analog input pin

Lets get started with assembly.


We ship Feathers fully tested but without headers attached - this gives you the most flexibility on choosing how to use and configure your Feather

Header Options!

Before you go gung-ho on soldering, there's a few options to consider!

The first option is soldering in plain male headers, this lets you plug in the Feather into a solderless breadboard

Another option is to go with socket female headers. This won't let you plug the Feather into a breadboard but it will let you attach featherwings very easily

We also  have 'slim' versions of the female headers, that are a little shorter and give a more compact shape

Finally, there's the "Stacking Header" option. This one is sort of the best-of-both-worlds. You get the ability to plug into a solderless breadboard and plug a featherwing on top. But its a little bulky

Soldering in Plain Headers

Prepare the header strip:

Cut the strip to length if necessary. It will be easier to solder if you insert it into a breadboard - long pins down

Add the breakout board:

Place the breakout board over the pins so that the short pins poke through the breakout pads

And Solder!

Be sure to solder all pins for reliable electrical contact.

(For tips on soldering, be sure to check out our Guide to Excellent Soldering).

Solder the other strip as well.

You're done! Check your solder joints visually and continue onto the next steps

Soldering on Female Header

Tape In Place

For sockets you'll want to tape them in place so when you flip over the board they don't fall out

Flip & Tack Solder

After flipping over, solder one or two points on each strip, to 'tack' the header in place

And Solder!

Be sure to solder all pins for reliable electrical contact.

(For tips on soldering, be sure to check out our Guide to Excellent Soldering).

You're done! Check your solder joints visually and continue onto the next steps

Using Arduino IDE

While the Feather HUZZAH ESP8266 comes pre-programmed with NodeMCU's Lua interpretter, you don't have to use it! Instead, you can use the Arduino IDE which may be more familar. This will write directly to the firmware, erasing the NodeMCU firmware, so if you want to go back to Lua, use the flasher to re-install it

Don't forget to visit esp8266.com for the latest and greatest in ESP8266 news, software and gossip!

In order to upload code to the ESP8266 and use the serial console, connect any data-capable micro USB cable to the Feather HUZZAH and the other side to your computer's USB port.

Don't forget you will also need to install the SiLabs CP2104 Driver:

If you are using Mac OS 10.12.6 (Sierra) and you cannot upload with the latest Mac OS VCP driver, please try the legacy v4 driver below. Note you will need to uninstall the v5 driver using uninstall.sh (in the driver package)

Install the Arduino IDE 1.6.8 or greater

Download Arduino IDE from Arduino.cc (1.6.8 or greater) from Arduino.cc

The latest is usually the best

Install the ESP8266 Board Package

Enter http://arduino.esp8266.com/stable/package_esp8266com_index.json into Additional Board Manager URLs field in the Arduino v1.6.4+ preferences.

 Next, use the Board manager to install the ESP8266 package.

After the install process, you should see that esp8266 package is marked INSTALLED. Close the Boards Manager window once the install process has completed.

Setup ESP8266 Support

When you've restarted, select Adafruit HUZZAH ESP8266  from the Tools->Board dropdown

80 MHz as the CPU frequency

You can keep the Flash Sizeat "4M (3M SPIFFS)

For Upload Speed, select 115200 baud (You can also try faster baud rates, we were able to upload at a blistering 921600 baud but sometimes it fails & you have to retry)

The matching COM port for your FTDI or USB-Serial cable

Blink Test

We'll begin with the simple blink test

Enter this into the sketch window (and save since you'll have to)

void setup() {
  pinMode(0, OUTPUT);

void loop() {
  digitalWrite(0, HIGH);
  digitalWrite(0, LOW);

Now you can simply upload! The Feather HUZZAH has built in auto-reset that puts it into bootloading mode automagically

The sketch will start immediately - you'll see the LED blinking. Hooray!

Connecting via WiFi

OK once you've got the LED blinking, lets go straight to the fun part, connecting to a webserver. Create a new sketch with this code:

 *  Simple HTTP get webclient test

#include <ESP8266WiFi.h>

const char* ssid     = "yourssid";
const char* password = "yourpassword";

const char* host = "wifitest.adafruit.com";

void setup() {

  // We start by connecting to a WiFi network

  Serial.print("Connecting to ");
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {

  Serial.println("WiFi connected");  
  Serial.println("IP address: ");

int value = 0;

void loop() {

  Serial.print("connecting to ");
  // Use WiFiClient class to create TCP connections
  WiFiClient client;
  const int httpPort = 80;
  if (!client.connect(host, httpPort)) {
    Serial.println("connection failed");
  // We now create a URI for the request
  String url = "/testwifi/index.html";
  Serial.print("Requesting URL: ");
  // This will send the request to the server
  client.print(String("GET ") + url + " HTTP/1.1\r\n" +
               "Host: " + host + "\r\n" + 
               "Connection: close\r\n\r\n");
  // Read all the lines of the reply from server and print them to Serial
    String line = client.readStringUntil('\r');
  Serial.println("closing connection");

Dont forget to update

const char* ssid     = "yourssid";
const char* password = "yourpassword";

to your access point and password, then upload the same way: get into bootload mode, then upload code via IDE

Open up the IDE serial console at 115200 baud to see the connection and webpage printout!

That's it, pretty easy!

This page was just to get you started and test out your module. For more information, check out the ESP8266 port github repository for much more up-to-date documentation!

Arduino IO Library

Install the Required Libraries

Now we will need to install the Adafruit IO, Adafruit MQTT, and ArduinoHttpClient libraries using the Arduino Library Manager. Navigate to the Manage Libraries... option in the Sketch -> Include Library menu.

Enter Adafruit IO Arduino into the search box, and click Install on the Adafruit IO Arduino library option to install version 2.1.1 or higher.

Enter Adafruit MQTT into the search box, and click Install on the Adafruit MQTT library option to install version 0.16.1 or higher.

Enter ArduinoHttpClient into the search box, and click Install on the ArduinoHttpClient library option to install version 0.2.0 or higher.

Adafruit IO Setup

The first thing you will need to do is to login to your Adafruit IO account and get your Adafruit IO Key if you haven't already. Click the key button on the right hand side of the dashboard window to retrieve your key.

A window will pop up with your Adafruit IO Key. Keep a copy of this in a safe place. We'll need it later.

Example Sketches

In the Adafruit IO Basics series of guides, the examples will be using hardware found in our Adafruit IO starter kit. If you are following along, you might want to consider using the starter kit below.

Huzzah! Adafruit.io Internet of Things Feather ESP8266

OK you've signed up for Adafruit.io and you're ready to build something cool and Internet-connected. All you need is this starter kit which will get you going with lots of parts...

Example Sketch Setup

Now that we have installed all of the dependencies, we can try to run one of the Adafruit IO example sketches. Navigate to the adafruitio_00_publish sketch by opening the File -> Examples -> Adafruit IO Arduino menu.

Click on the config.h tab, and replace the placeholders with your Adafruit IO credentials and WiFi connection info.

Uploading the Sketch

Next we will need to select the Adafruit HUZZAH ESP8266 from the Tools -> Board menu.

Then, select the proper COM port on Windows, or USB device on OS X.

Use the arrow icon (➡) to upload the example sketch to the ESP8266. It might take a while, but you should see a Upload complete. message at the bottom of the window when the process has finished.

You can now click the serial monitor icon to view the output of the sketch. If everything goes as expected, you should see counter values being sent to Adafruit IO. If not, check your WiFi and Adafruit IO credentials in config.h and try uploading your sketch again using the process above.

Viewing Data on Adafruit IO

Now that your ESP8266 is sending data to Adafruit IO, you can view the data stream on io.adafruit.com by adding a stream block to your dashboard. To do this, click on the + icon on the right hand side of the dashboard.

Add a new stream block by selecting it from the modal.

Next, choose the counter feed from the list, and click the Next Step button.

Modifythe stream block options as needed, and click the create block button when you are finished.

You should now see data flowing into your stream block from your ESP8266.

Next Steps

If you would like to continue your educational journey with your ESP8266 & Adafruit IO, check out the Adafruit IO Basics series of guides.