An ESP8266 Wi-Fi development board with a built-in 18650 lithium cell holder, USB charging and a power switch, so your projects can run without a power cable.
This WeMos D1 board is built around the Espressif ESP-WROOM-02 module (ESP8266EX, 2 MB flash, 802.11 b/g/n Wi-Fi). The charger, 5 V boost output and battery protection are on the same board as the holder, which suits portable sensors, data loggers and Wi-Fi gadgets. You program it from the Arduino IDE.
Why choose it
- Battery built in — a single 18650 holder sits on the back of the board, with charging at 0.5 A over Micro-USB and a 1 A output.
- Protected — the board has overcharge and over-discharge protection, and a slide switch to turn the battery power on and off.
- Ready for Wi-Fi projects — an ESP-WROOM-02 module with a PCB antenna, a user LED on GPIO16, and RST and FLASH buttons for programming.
Specifications
| Core | |
|---|---|
| Module | ESP-WROOM-02 (integrates the ESP8266EX) |
| CPU | Tensilica L106 32-bit, 80 MHz (up to 160 MHz) |
| Flash | 2 MB SPI flash |
| Wi-Fi | 802.11 b/g/n, 2.4 GHz |
| Antenna | On-board PCB antenna, 2 dBi |
| Module supply voltage | 3.0–3.6 V |
| Power | |
| Battery | 1 × 18650 lithium cell (not included) |
| Charge input | Micro-USB |
| Charge current | 0.5 A |
| Output current | 1 A |
| Protection | Overcharge and over-discharge protection |
| Status LEDs | Red = charging, green = fully charged |
| Power switch | Slide switch for battery power |
| Board | |
| User LED | 1 programmable LED on GPIO16 |
| Buttons | RST and FLASH |
| Pin header | Header strip supplied loose, for you to solder |
Compatibility
| Platform | Works | Notes |
|---|---|---|
| Arduino UNO / Nano (5 V) | ◐ With adapter | The ESP8266 uses 3.3 V logic. Use a level shifter for 5 V signals. |
| ESP32 / ESP8266 (3.3 V) | ✓ Yes | Same 3.3 V logic level. |
| Raspberry Pi | ✓ Yes | 3.3 V logic. Connect over Wi-Fi or serial. |
| Software | ✓ Yes | Arduino IDE with the "esp8266 by ESP8266 Community" board package. |
In the box
- 1 × WeMos D1 ESP-WROOM-02 board with 18650 holder
- 1 × pin header strip
Applications
- Battery-powered Wi-Fi sensor nodes and data loggers
- Portable IoT gadgets that need to run away from a power point
- Learning ESP8266 programming in the Arduino IDE
Tutorial
Part 1 — Set up the Arduino IDE (once only)
Download and install the Arduino IDE for your computer.
Open File → Preferences (Windows/Linux) or Arduino IDE → Settings (macOS). In "Additional boards manager URLs" paste
https://arduino.esp8266.com/stable/package_esp8266com_index.json and click OK. The package is described in the official installation guide.Open Tools → Board → Boards Manager, search for
esp8266, and install "esp8266 by ESP8266 Community".Fit a 18650 cell with the + end matching the + mark on the board, then slide the power switch on. A wrong-way battery can destroy the charging chip, so check twice.
Part 2 — Upload your first sketch
Plug a data-capable Micro-USB cable into the board and your computer. If no port appears, try another cable and install the USB driver for your board.
Tools → Board → esp8266 → "Generic ESP8266 Module". Set Tools → Flash Size to a 2 MB option, Tools → Upload Speed to 115200, and pick your board under Tools → Port.
Paste the code below, click Upload, then open Tools → Serial Monitor at 115200 baud. If the upload does not start, hold the FLASH button, tap RST, release FLASH, and upload again.
▸ Example 1 — Blink the on-board LED (GPIO16)
// Blink the on-board LED (GPIO16) and print a start-up message
const int LED_PIN = 16; // on-board programmable LED
const int BLINK_MS = 500; // you can change this
void setup() {
Serial.begin(115200); // Serial Monitor speed
delay(200);
Serial.println();
Serial.println("OK - epartners.co.nz test"); // printed once at start-up
pinMode(LED_PIN, OUTPUT);
}
void loop() {
digitalWrite(LED_PIN, HIGH); // LED changes state
delay(BLINK_MS);
digitalWrite(LED_PIN, LOW); // LED changes back
delay(BLINK_MS);
}✓ Check: The Serial Monitor (115200 baud) prints "OK - epartners.co.nz test" once, and the small user LED near the module blinks every half second. The LED may light on HIGH or LOW; the blink is the same either way.
Part 3 — First real project: Wi-Fi scanner
Paste the code below and upload it the same way. It uses the ESP8266WiFi library that comes with the board package.
▸ Example 2 — List nearby Wi-Fi networks
// Scan for nearby 2.4 GHz Wi-Fi networks and list them
#include <ESP8266WiFi.h>
void setup() {
Serial.begin(115200);
delay(200);
Serial.println();
Serial.println("OK - epartners.co.nz test"); // printed once at start-up
WiFi.mode(WIFI_STA); // station mode
WiFi.disconnect(); // make sure we are not connected to anything
delay(100);
}
void loop() {
Serial.println("Scanning...");
int n = WiFi.scanNetworks(); // returns the number of networks found
if (n == 0) {
Serial.println("No networks found");
} else {
Serial.print(n);
Serial.println(" networks found:");
for (int i = 0; i < n; i++) {
Serial.print(i + 1);
Serial.print(": ");
Serial.print(WiFi.SSID(i)); // network name
Serial.print(" (");
Serial.print(WiFi.RSSI(i)); // signal strength in dBm
Serial.println(" dBm)");
}
}
Serial.println();
delay(5000); // you can change this
}✓ Check: Every five seconds the Serial Monitor lists the 2.4 GHz networks near you, with their signal strength in dBm. A number closer to 0 means a stronger signal.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| No port appears | Charge-only cable, or the USB driver is missing | Use a data USB cable and install the USB driver for your board. |
| Upload fails or times out | Board is not in upload mode, or the upload speed is too high | Hold FLASH, tap RST, release FLASH, then upload. Set Tools → Upload Speed to 115200. |
| Garbled text in Serial Monitor | Wrong baud rate | Set the Serial Monitor to 115200 baud. |
| Board does not run on battery | Power switch off, or the cell is flat | Slide the power switch on and charge the cell over Micro-USB. |
| LED does not blink | Wrong pin | The user LED is on GPIO16. Make sure LED_PIN is 16. |
Spotted a problem in this tutorial? Email support@epartners.co.nz and we'll check it and update the tutorial.
- Fit the 18650 cell the right way round. If the battery is in the wrong direction, the charging chip will be destroyed.
- GPIO pins on the ESP8266 are 3.3 V logic. Do not feed 5 V signals straight into them.
- Use a 18650 cell that fits the holder.
Datasheet
Key figures from the manufacturer's datasheet for the ESP-WROOM-02, the Wi-Fi module on this board.
| ESP-WROOM-02 Wi-Fi module | |
|---|---|
| Module | ESP-WROOM-02 |
| Integrated chip | ESP8266EX |
| CPU | Tensilica L106 32-bit, 80 MHz (up to 160 MHz) |
| Flash memory | 2 MB SPI flash |
| Wi-Fi standards | 802.11 b/g/n |
| Frequency range | 2.4 GHz to 2.5 GHz (2400 MHz to 2483.5 MHz) |
| Supply voltage | 3.0 V to 3.6 V (3.3 V typical) |
| Operating temperature | −40 °C to +85 °C |
| Antenna | On-board PCB antenna, 2 dBi gain |
| Module size | 18 mm × 20 mm × 3 mm |
| PWM | 4 channels (can be extended to 8) |
| Deep-sleep current | 10 µA (typical) |
Download the ESP-WROOM-02 datasheet (PDF, 1.2 MB)
▸ Preview the datasheet
If the preview does not load on your device, use the download link above.
Source: Espressif Systems, ESP-WROOM-02 Datasheet, version 2.0.
Resources
FAQ
▸ Is the 18650 battery included?
No. The board comes with an empty holder, so you need to supply your own 18650 lithium cell.
▸ Which board do I pick in the Arduino IDE?
Pick "Generic ESP8266 Module" after installing "esp8266 by ESP8266 Community", then set the flash size to a 2 MB option and the upload speed to 115200.
▸ Can I charge the battery from USB?
Yes. The Micro-USB port charges the cell at 0.5 A, with a red LED while charging and a green LED when full.
▸ Can I connect 5 V sensors directly?
No. The ESP8266 pins use 3.3 V logic, so use a 3.3 V sensor or add a level shifter for 5 V signals.
▸ Does it have Wi-Fi and Bluetooth?
It has 802.11 b/g/n Wi-Fi at 2.4 GHz. The ESP-WROOM-02 module does not include Bluetooth.
Technical question about this part? Email support@epartners.co.nz with your board and wiring, and we'll help you get it working.
Shipping: $5.99 urban, $9.99 rural. Free shipping on orders of $100 or more.
Order by 10:30am (NZT), Monday to Friday, and we dispatch the same day. Orders placed after 10:30am, on weekends or on public holidays are dispatched the next business day.
Delivery usually takes 1–2 business days after dispatch (2–3 for rural addresses). See our Shipping Policy for full details.