Wemos D1 Mini

The Wemos D1 Mini is a miniature, stackable board running the same ESP8266 Wi-Fi chip found on the NodeMCU. It is designed for compact IoT smart devices.

Wemos D1 Mini

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Board facts

Board facts
FactValue
Operating voltage3.3 V
FamilyEspressif
Python runtimemicropython
Wi-FiYes
BluetoothNo
Native USBNo

Pinout

Pinout of the Wemos D1 Mini. Select a label to see that pin in the table below.

The Wemos D1 Mini is a miniature, stackable board running the same ESP8266 Wi-Fi chip found on the NodeMCU. It is designed for compact IoT smart devices.


1. Hardware Specifications

  • Processor: Single-core 32-bit Tensilica L106 core running at 80 MHz.
  • Logic Level: 3.3V. All pins operate on 3.3V logic.
  • Memory Limits: 4 MB Flash, 80 KB SRAM.
  • Wireless: Integrated 802.11 b/g/n Wi-Fi. No Bluetooth.

2. Detailed Pinout & GPIO Map (Board Labels vs. GPIO IDs)

Like the NodeMCU, the board labels (D0–D8, RX, TX) do NOT correspond directly to GPIO numbers in code. Use the translation table below when writing logic:

Pins of this board
PinKindFeaturesAlternate functionsNotes
RSTSpecialRESET
A0AnalogADC, Input onlyADC0Analog Input Only. Scales raw 0V–1V chip limit to 0V–3.2V.
D0GPIOPWMGPIO16, NO_INTERRUPTPlain GPIO in OMS — no onboard LED is linked to this pin (the built-in LED is on D4, see below). On real hardware D0 is commonly wired to RST for deep-sleep wake-up, but OMS doesn't model that connection.
D5GPIOPWMGPIO14, SCK, SPISPI Serial Clock.
D6GPIOPWMGPIO12, MISO, SPISPI Master In Slave Out.
D7GPIOPWMGPIO13, MOSI, SPISPI Master Out Slave In.
D8GPIOPWMGPIO15, CS, SPIBootstrap Pin. Must be pulled to GND at startup to boot normally.
3V3Power3.3V
TXGPIOPWMGPIO1, UART0Shares USB upload path; do not use during uploads.
RXGPIOPWMGPIO3, UART0Shares USB upload path; do not use during uploads.
D1GPIOPWMGPIO5, SCL, I2CI2C Serial Clock.
D2GPIOPWMGPIO4, SDA, I2CI2C Serial Data.
D3GPIOPWMGPIO0Bootstrap Pin. Onboard pull-up. Pull to GND to flash.
D4GPIOPWMGPIO2Bootstrap Pin. Onboard LED (active low).
GNDGround
5VPower

3. Stackable Shield Form Factor

The Wemos D1 Mini's double-sided female/male header pins support physical stackable breakout shields (Relay, OLED, DHT22, Buzzer, and more) on real hardware. OMS doesn't model shields as a distinct component category — there's no special "shield" abstraction on the canvas. Using one of these in OMS just means wiring the equivalent generic component (Relay, OLED display, DHT11/22 sensor, Buzzer — all in the regular Parts Library) to whichever pins the real shield uses, exactly like you'd wire it on any other board.


4. Compiler Settings & IDE Properties

When targeting this board, the compiler is intended to use the following parameters:

  • FQBN: esp8266:esp8266:d1_mini
  • Default Flashing Baud Rate: 115200
  • Flash Mode / File Type: esp
  • Flash Memory Offsets: { bootloader: 0x0000, partitions: 0x0000, app: 0x0000 }
  • Programming Runtimes: Supports C++ (Arduino) and MicroPython.

[!WARNING] Known bug: same issue as the ESP32-S2/S3/C3/CAM (Sections 3.6-3.9) — this board's actual internal id (wemosd1) doesn't match any key in the compiler's board-config lookup table (which only has hyphen/underscore forms like wemos-d1), so compiling currently silently falls back to plain ESP32's FQBN instead of the one above. See Known_Bugs.md §2.0.


5. Supported Blockly Board Blocks

All of the generic Board IO blocks from Section 3.2 are available: board_builtin_led (controls D4's diagnostic LED), board_digital_write/board_digital_read, board_analog_read (the single A0 pin), board_attach_interrupt, board_hw_timer, board_deep_sleep. This chip has no DAC, Hall sensor, or touch hardware, so board_analog_out always falls back to a PWM approximation and board_read_touch/board_internal_hall aren't usable. WiFi (wifi_connect and more) requires installing the separate Wi-Fi extension first.


6. Simulator and Flashing Diagnostics

  • Simulator: Digital states and timer logic are simulated. When a shield is dragged onto the canvas, it automatically maps to the corresponding GPIO interface.
  • Flashing Guide: Connect the Wemos via its Micro-USB port. Click Connect Serial, select your CH340 COM port, and upload. If flashing times out, check if you have connected an external device to Pin D3 (GPIO 0). Pin D3 must be allowed to transition low to trigger bootloader mode during upload initialization.

7. Communication Buses & Electrical Capabilities

Beyond the per-pin table above, here's the board's bus-level capability summary (from its own capabilities config) — identical to the ESP8266 NodeMCU (Section 3.10), since it's the same chip:

BusDetails
UART1 hardware bus — TX/RX pins, shared with the USB programming port.
I2CDefault on D2 (SDA) / D1 (SCL).
SPIDefault on MOSI D7, MISO D6, SCK D5, CS D8.
1-WireNo dedicated 1-Wire hardware peripheral. Sensors like the DHT11/DHT22 bit-bang the timing on any regular digital pin instead.
Analog (ADC)1 input-only pin (A0), 10-bit resolution. No hardware DAC, no touch, no Hall sensor.
PWM8 channels, 10-bit resolution, up to ~1 kHz.

Electrical limits: max 12 mA per pin, max 500 mA total across all pins combined.


8. Further Reading

  • Official Pinout & Guide — Wemos's own documentation for the D1 Mini (community board, not an Espressif reference design).

Wemos D1 Mini — OMS Parts