<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>ESP32 &#8211; Quality RC Parts</title>
	<atom:link href="https://qualityrcparts.com/category/microcontrollers-robotics/mcu-esp32/feed/" rel="self" type="application/rss+xml" />
	<link>https://qualityrcparts.com</link>
	<description>SHIPS FAST FROM NY, USA</description>
	<lastBuildDate>Sun, 22 Nov 2026 03:30:34 +0000</lastBuildDate>
	<language>en-US</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.5</generator>

<image>
	<url>https://i0.wp.com/qualityrcparts.com/wp-content/uploads/2026/09/qrc-logo-6-com-inside-short-512x512-1.png?fit=32%2C32&#038;ssl=1</url>
	<title>ESP32 &#8211; Quality RC Parts</title>
	<link>https://qualityrcparts.com</link>
	<width>32</width>
	<height>32</height>
</image> 
<site xmlns="com-wordpress:feed-additions:1">257527959</site>	<item>
		<title>LVGL ESP32 Display Guide: Setup, Widgets, Touch</title>
		<link>https://qualityrcparts.com/lvgl-esp32-display-guide/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sun, 22 Nov 2026 03:30:34 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[lvgl]]></category>
		<category><![CDATA[spi]]></category>
		<category><![CDATA[tft-display]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/lvgl-esp32-display-guide/</guid>

					<description><![CDATA[LVGL turns a plain TFT display into a real interface: buttons, sliders, gauges, and menus on an ESP32. This guide installs LVGL 9 in the Arduino IDE, binds it to a TFT driver, builds the first screen, adds touch, and fixes the errors that stop most builds.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">LVGL turns a plain TFT display into a real interface. With TFT_eSPI alone, your code draws pixels, lines, and text by hand. With LVGL on top, you get buttons, sliders, gauges, menus, and touch input.</p>



<p class="wp-block-paragraph">Short answer: install the LVGL 9 library in the Arduino IDE, set up TFT_eSPI for your display driver, connect the two with a flush callback or the LVGL TFT_eSPI helper, then build your screen from widgets. The worked example uses the 2.4 inch touch ILI9341 module from the store. This draft is written against LVGL 9.x, verified against the LVGL docs and the Random Nerd Tutorials LVGL 9.2 example.</p>



<h2 class="wp-block-heading">What is LVGL, and when should you use it instead of TFT_eSPI alone?</h2>



<p class="wp-block-paragraph">LVGL stands for Light and Versatile Graphics Library. It is a free and open-source graphics library for microcontrollers, released under the MIT license. It gives you widgets (buttons, labels, sliders, charts, lists, images), layout management, event handling, animations, CSS-like styling, multi-language support with UTF-8, and support for touchpads, mice, keyboards, and encoders. It is written in C. Source: LVGL docs and Random Nerd Tutorials.</p>



<p class="wp-block-paragraph">LVGL does not drive your display. LVGL renders your interface into a memory buffer, then calls a function you provide, the flush callback, to move those pixels to the screen. The display driver, usually TFT_eSPI on an ESP32 SPI display, does the actual SPI transfer.</p>



<p class="wp-block-paragraph">Use TFT_eSPI alone when the screen shows fixed text, a simple readout, or a static gauge. Use LVGL when the screen needs buttons, menus, sliders, or screens the user navigates. If you have not installed TFT_eSPI yet, follow our TFT_eSPI setup guide first.</p>



<h2 class="wp-block-heading">Which LVGL version is this guide written against?</h2>



<p class="wp-block-paragraph">This guide is written against LVGL 9.x. The worked Arduino example follows the Random Nerd Tutorials guide, which installs LVGL version 9.2 from the Arduino Library Manager. The LVGL documentation site currently serves the 9.4 docs.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Item</th>
<th>LVGL 8.x</th>
<th>LVGL 9.x (this guide)</th>
</tr>
</thead>
<tbody>
<tr>
<td>Display driver</td>
<td>lv_disp_drv_t, lv_disp_drv_register</td>
<td>lv_display_t, lv_display_create</td>
</tr>
<tr>
<td>Draw buffer</td>
<td>lv_disp_draw_buf_t</td>
<td>Buffers passed to lv_display_create</td>
</tr>
<tr>
<td>Flush ready call</td>
<td>lv_disp_flush_ready</td>
<td>lv_display_flush_ready</td>
</tr>
<tr>
<td>Input device</td>
<td>lv_indev_drv_t, lv_indev_drv_register</td>
<td>lv_indev_t, lv_indev_create</td>
</tr>
<tr>
<td>Active screen</td>
<td>lv_scr_act()</td>
<td>lv_screen_active()</td>
</tr>
<tr>
<td>Button create</td>
<td>lv_btn_create</td>
<td>lv_button_create</td>
</tr>
<tr>
<td>Main loop call</td>
<td>lv_task_handler</td>
<td>lv_timer_handler</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Source: LVGL 9 docs and the ElectricalFlux LVGL ESP32-S3 guide.</p>



<h2 class="wp-block-heading">What do you need before you start?</h2>



<ul class="wp-block-list">

<li>An ESP32 board. This guide uses the ESP32 DevKit V1, the same board as the TFT_eSPI setup guide, because its hardware SPI pins match the library examples.</li>
<li>A separate SPI TFT module. The worked examples use the 2.4 inch touch ILI9341 module and the 0.96 inch ST7735 module from the store.</li>
<li>The Arduino IDE with the ESP32 board package installed, version 2.x or later.</li>
<li>TFT_eSPI installed and configured for your display, per our TFT_eSPI setup guide. A setup that already passes its Colour_Test sketch is the starting point.</li>
<li>Jumper wires and a breadboard. Keep the SPI wires short: long wires cause signal problems at full SPI speed.</li>

</ul>



<h2 class="wp-block-heading">How do you install LVGL in the Arduino IDE?</h2>



<p class="wp-block-paragraph">Open the Library Manager: Sketch, Include Library, Manage Libraries. Search for &#8220;lvgl&#8221;, find the entry by kisvegabor, and install version 9.2 or later in the 9.x line. Do not install a version 8 release alongside it: one LVGL version per project, and the code in this guide is written for 9.x.</p>



<p class="wp-block-paragraph">Then prepare the LVGL config file, lv_conf.h. LVGL ships with a template file, lv_conf_template.h, inside the library folder. Copy it, rename the copy to lv_conf.h, and place it in your Arduino libraries folder, not inside the lvgl folder.</p>



<p class="wp-block-paragraph">Open lv_conf.h and check two settings: the guard near the top that disables the whole file when it is set to 0 must be set to 1, and color depth LV_COLOR_DEPTH must be 16 (RGB565, the 16-bit color TFT_eSPI sends to the display). Your sketch starts with two lines that tell LVGL to use this config file:</p>



<pre class="wp-block-code"><code>#define LV_CONF_INCLUDE_SIMPLE
#include &lt;lvgl.h&gt;
</code></pre>



<p class="wp-block-paragraph">Source: Random Nerd Tutorials LVGL 9.2 guide and the CircuitDigest LVGL Arduino tutorial. If the sketch fails to compile with errors about lv_conf.h not found, the file is in the wrong folder.</p>



<h2 class="wp-block-heading">How do you wire the display?</h2>



<p class="wp-block-paragraph">Use the same wiring as the TFT_eSPI setup guide. LVGL does not change the wiring: TFT_eSPI still owns the SPI bus, and LVGL only hands it pixels. For an ESP32 DevKit V1 the display wires to the hardware SPI pins: MOSI 23, MISO 19, SCLK 18, CS 15, DC 2, RST 4, with VCC at 3.3V and BLK at 3V3 or a free GPIO for dimming. Connect MISO even if you think you do not need it: the display ID read and the touch controller need it. The full wiring table and the User_Setup.h edit for each driver are in our TFT_eSPI setup guide.</p>



<h2 class="wp-block-heading">Which display drivers does LVGL work with?</h2>



<p class="wp-block-paragraph">LVGL works with any display driver that can move a rectangle of pixels to the screen. For the store TFT modules, the driver is TFT_eSPI: it supports the ST7735, ST7789, ILI9341, ILI9488, and ST7796 chips, per the TFT_eSPI README. The GC9A01 round display needs its own low-level driver code, as in the CircuitDigest LVGL tutorial. The built-in 1.9 inch ST7789 board (ID 17819) works the same way: TFT_eSPI with the ST7789 driver at 170 by 320, CS 5, RST 4, BL 32, and MOSI 23.</p>



<h2 class="wp-block-heading">How do you bind LVGL to your display driver?</h2>



<p class="wp-block-paragraph">Binding means telling LVGL three things: how big the screen is, where to put rendered pixels while they wait, and which function moves them to the display. Route A is the one to use with TFT_eSPI. Route B is the manual route, for other display drivers.</p>



<h3 class="wp-block-heading">Route A: the TFT_eSPI helper (use this first)</h3>



<p class="wp-block-paragraph">LVGL 9 ships a helper that binds TFT_eSPI in one call. The Random Nerd Tutorials LVGL 9.2 example uses it, and it needs no flush callback of your own:</p>



<pre class="wp-block-code"><code>#define SCREEN_WIDTH 240
#define SCREEN_HEIGHT 320

#define DRAW_BUF_SIZE (SCREEN_WIDTH * SCREEN_HEIGHT / 10 * (LV_COLOR_DEPTH / 8))
uint32_t draw_buf[DRAW_BUF_SIZE / 4];

void setup() {
  Serial.begin(115200);
  lv_init();
  lv_display_t * disp;
  disp = lv_tft_espi_create(SCREEN_WIDTH, SCREEN_HEIGHT, draw_buf, sizeof(draw_buf));
  lv_display_set_rotation(disp, LV_DISPLAY_ROTATION_270);
}
</code></pre>



<p class="wp-block-paragraph">lv_tft_espi_create creates the LVGL display, registers the TFT_eSPI flush function behind the scenes, and attaches your draw buffer. The rotation call turns the portrait 240 by 320 panel into landscape. Source: Random Nerd Tutorials.</p>



<p class="wp-block-paragraph">DRAW_BUF_SIZE is one tenth of the screen, in 16-bit pixels: 7,680 pixels, or 15,360 bytes, for a 240 by 320 screen. A bigger buffer means smoother animation but costs RAM. If animations stutter, raise it to one quarter. If the sketch crashes on boot, shrink it.</p>



<h3 class="wp-block-heading">Route B: the manual flush callback</h3>



<p class="wp-block-paragraph">If your display driver is not TFT_eSPI, write the flush callback yourself. LVGL calls it whenever a rectangle of the screen needs updating. The callback receives the display, the rectangle (area), and the pixel data (px_map), sends that rectangle to the screen, then tells LVGL the buffer is free:</p>



<pre class="wp-block-code"><code>void my_disp_flush(lv_display_t *disp, const lv_area_t *area, uint8_t *px_map)
{
  uint32_t w = (area-&gt;x2 - area-&gt;x1 + 1);
  uint32_t h = (area-&gt;y2 - area-&gt;y1 + 1);
  lcd.startWrite();
  lcd.setAddrWindow(area-&gt;x1, area-&gt;y1, w, h);
  lcd.pushColors((uint16_t *)px_map, w * h, true);
  lcd.endWrite();
  lv_display_flush_ready(disp);
}
</code></pre>



<p class="wp-block-paragraph">The area coordinates are inclusive, so both dimensions need plus 1. lv_display_flush_ready(disp) is not optional: without it, LVGL waits forever for a buffer that never comes back, and the screen freezes after the first frame. Register the callback with lv_display_create, lv_display_set_buffers, and lv_display_set_flush_cb. Source: SmartDocs. Two buffers give double buffering; one buffer works too and uses half the RAM.</p>



<h2 class="wp-block-heading">How do you build the first screen?</h2>



<p class="wp-block-paragraph">Once the display is bound, the rest is widgets. This example is adapted from the Random Nerd Tutorials LVGL 9.2 sketch: a label, a button that counts clicks, and a slider that prints its value.</p>



<pre class="wp-block-code"><code>void lv_create_main_gui(void) {
  lv_obj_t * text_label = lv_label_create(lv_screen_active());
  lv_label_set_text(text_label, &quot;Hello, world!&quot;);
  lv_obj_align(text_label, LV_ALIGN_CENTER, 0, -90);

  lv_obj_t * btn1 = lv_button_create(lv_screen_active());
  lv_obj_add_event_cb(btn1, event_handler_btn1, LV_EVENT_ALL, NULL);
  lv_obj_align(btn1, LV_ALIGN_CENTER, 0, -50);
  lv_obj_t * btn_label = lv_label_create(btn1);
  lv_label_set_text(btn_label, &quot;Button&quot;);
  lv_obj_center(btn_label);

  lv_obj_t * slider = lv_slider_create(lv_screen_active());
  lv_obj_align(slider, LV_ALIGN_CENTER, 0, 60);
  lv_obj_add_event_cb(slider, slider_event_callback, LV_EVENT_VALUE_CHANGED, NULL);
  lv_slider_set_range(slider, 0, 100);
}
</code></pre>



<p class="wp-block-paragraph">The event callback reads the event code and acts on it:</p>



<pre class="wp-block-code"><code>static void event_handler_btn1(lv_event_t * e) {
  lv_event_code_t code = lv_event_get_code(e);
  if(code == LV_EVENT_CLICKED) {
    btn1_count++;
  }
}
</code></pre>



<p class="wp-block-paragraph">And the main loop hands time to LVGL. LVGL needs a millisecond tick and regular calls to its handler, or nothing moves: no animations, no touch, no screen updates.</p>



<pre class="wp-block-code"><code>void loop() {
  lv_timer_handler();
  lv_tick_inc(5);
  delay(5);
}
</code></pre>



<p class="wp-block-paragraph">Source: Random Nerd Tutorials. Note that their code calls the handler lv_task_handler, the LVGL 8 name. In LVGL 9 the function is lv_timer_handler. If your loop blocks for more than a few milliseconds, the interface freezes for the same time.</p>



<h2 class="wp-block-heading">Which widgets should you use?</h2>



<p class="wp-block-paragraph">Every widget follows the same pattern: create it on a parent, set its size and position, style it, and add an event callback if it takes input.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Widget</th>
<th>Create call (LVGL 9)</th>
<th>Use it for</th>
</tr>
</thead>
<tbody>
<tr>
<td>Label</td>
<td>lv_label_create</td>
<td>Text, readouts, titles</td>
</tr>
<tr>
<td>Button</td>
<td>lv_button_create</td>
<td>Actions, toggles, navigation</td>
</tr>
<tr>
<td>Slider</td>
<td>lv_slider_create</td>
<td>Brightness, volume, setpoints from 0 to 100</td>
</tr>
<tr>
<td>Bar</td>
<td>lv_bar_create</td>
<td>Progress, battery level, signal strength</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">LVGL also has arcs, charts, images, dropdowns, switches, keyboards, text areas, menus, tabs, tables, and animations; the full list is in the LVGL docs widget section. Two rules apply to all of them. First, every object has a parent: a widget created with no parent goes on the active screen, and a widget created on a button becomes part of that button, like the label inside btn1 above. Second, styles are CSS-like: set colors, fonts, padding, and radius per widget, or per state, such as pressed or checked. Source: Random Nerd Tutorials and the LVGL docs widget examples.</p>



<h2 class="wp-block-heading">How do you add touch input?</h2>



<p class="wp-block-paragraph">A touch display needs a second driver: one for the screen, one for the touch controller. The touch modules in the store use the XPT2046 resistive touch controller. The steps below follow the Random Nerd Tutorials LVGL 9.2 example.</p>



<p class="wp-block-paragraph">Install the XPT2046_Touchscreen library from the Library Manager, then define the touch pins and start a second SPI bus for the touch chip. The touch chip has its own chip select, so it shares MOSI, MISO, and SCK with the display:</p>



<pre class="wp-block-code"><code>#define XPT2046_IRQ 36
#define XPT2046_MOSI 32
#define XPT2046_MISO 39
#define XPT2046_CLK 25
#define XPT2046_CS 33

SPIClass touchscreenSPI = SPIClass(VSPI);
XPT2046_Touchscreen touchscreen(XPT2046_CS, XPT2046_IRQ);
</code></pre>



<p class="wp-block-paragraph">In setup, start the touch SPI, begin the touchscreen, and set its rotation to match the display rotation. Then register the touch input device with LVGL and give it a read callback:</p>



<pre class="wp-block-code"><code>touchscreenSPI.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
touchscreen.begin(touchscreenSPI);
touchscreen.setRotation(2);

lv_indev_t * indev = lv_indev_create();
lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER);
lv_indev_set_read_cb(indev, touchscreen_read);
</code></pre>



<p class="wp-block-paragraph">The read callback checks the touch state, reads the point, and maps the raw touch values to screen pixels:</p>



<pre class="wp-block-code"><code>void touchscreen_read(lv_indev_t * indev, lv_indev_data_t * data) {
  if(touchscreen.tirqTouched() &amp;&amp; touchscreen.touched()) {
    TS_Point p = touchscreen.getPoint();
    x = map(p.x, 200, 3700, 1, SCREEN_WIDTH);
    y = map(p.y, 240, 3800, 1, SCREEN_HEIGHT);
    data-&gt;state = LV_INDEV_STATE_PRESSED;
    data-&gt;point.x = x;
    data-&gt;point.y = y;
  }
  else {
    data-&gt;state = LV_INDEV_STATE_RELEASED;
  }
}
</code></pre>



<p class="wp-block-paragraph">Source: Random Nerd Tutorials. Two warnings. First, the calibration numbers in the map calls, 200 to 3700 on X and 240 to 3800 on Y, are the values for the 2.8 inch touch module in that tutorial, not the 2.4 inch touch module in the store. Read the raw touch values from your own module, then set the map limits to your module. A button that only responds on one side of the screen is almost always a calibration problem. Second, if the touch picture is upside down or mirrored, change the touchscreen rotation value, not the LVGL rotation.</p>



<h2 class="wp-block-heading">How do you use fonts and images?</h2>



<p class="wp-block-paragraph">LVGL ships with built-in fonts, and it can load custom fonts and images.</p>



<p class="wp-block-paragraph"><strong>Built-in fonts.</strong> LVGL includes the Montserrat font in several sizes, enabled in lv_conf.h. A label uses the default font unless you set another one with lv_obj_set_style_text_font. Keep the enabled set small: every font size adds flash use.</p>



<p class="wp-block-paragraph"><strong>Custom fonts.</strong> For a font LVGL does not ship, use the LVGL font converter linked from the LVGL docs. It converts a font file into a C array you add to your sketch. Generate it for LVGL 9, not LVGL 8.</p>



<p class="wp-block-paragraph"><strong>Images.</strong> LVGL shows images from C arrays compiled into the sketch, or from files on a filesystem such as an SD card. The LVGL image converter, also linked from the LVGL docs, turns a PNG or JPG into a C array. A full-screen photo at 240 by 320 in 16-bit color is about 150 kB, so keep images small or load them from a card.</p>



<h2 class="wp-block-heading">What about the ESP-IDF path?</h2>



<p class="wp-block-paragraph">The Arduino path above is the fastest way to a working screen. The ESP-IDF path gives more control, and it is the path Espressif documents for production firmware. The LVGL docs page &#8220;Add LVGL to an ESP32 IDF project&#8221; covers it.</p>



<p class="wp-block-paragraph">The simplest ESP-IDF route is the esp_lvgl_port component, which provides helper functions for installing LVGL and display drivers, plus touch, encoder, button, and USB HID input support:</p>



<pre class="wp-block-code"><code>idf.py create-project my_lvgl_app
cd my_lvgl_app
idf.py add-dependency &quot;espressif/esp_lvgl_port^2.3.0&quot;
</code></pre>



<p class="wp-block-paragraph">The esp_lvgl_port component supports LVGL versions 8 and 9 and is compatible with ESP-IDF v5.2 and above. By default it pulls the latest stable LVGL, so pin a version if your project must stay on one. To add LVGL without the port component, use idf.py add-dependency &#8220;lvgl/lvgl^9.*&#8221;. Then configure LVGL with idf.py menuconfig and add a display driver and a touch driver from the ESP component registry. Source: LVGL docs, &#8220;Add LVGL to an ESP32 IDF project&#8221;.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Mixing LVGL 8 code with LVGL 9.</strong> lv_disp_drv_t, lv_btn_create, lv_scr_act, and lv_task_handler are LVGL 8 names. LVGL 9 uses lv_display_t, lv_button_create, lv_screen_active, and lv_timer_handler. One version per project.</li>
<li><strong>A lv_conf.h from another tutorial.</strong> The config file must match your LVGL version and your display. Copy the template from your own installed library.</li>
<li><strong>Forgetting lv_display_flush_ready in a manual flush callback.</strong> The screen draws one frame, then freezes forever.</li>
<li><strong>No tick and no handler in loop.</strong> LVGL needs lv_tick_inc and lv_timer_handler called regularly. A blocking loop freezes the interface.</li>
<li><strong>A draw buffer that is too small or too big.</strong> Too small and animations stutter. Too big and the sketch crashes on boot. Start at one tenth of the screen, and set LV_COLOR_DEPTH to 16: the store TFT modules use 16-bit color.</li>

</ul>



<h2 class="wp-block-heading">How do you fix an LVGL display that does not work?</h2>



<p class="wp-block-paragraph">Work through the stack from the bottom up: wiring, TFT_eSPI, LVGL config, then your code.</p>



<p class="wp-block-paragraph"><strong>The screen stays white or black after upload.</strong> Check the backlight first, then run Colour_Test without LVGL. If Colour_Test fails, the problem is wiring or User_Setup.h, not LVGL. Source: our TFT_eSPI setup guide.</p>



<p class="wp-block-paragraph"><strong>The screen shows the first frame, then freezes.</strong> The flush callback never told LVGL the buffer was free. Check that lv_display_flush_ready(disp) runs at the end of your flush callback.</p>



<p class="wp-block-paragraph"><strong>The picture is there but the colors are wrong.</strong> Check LV_COLOR_DEPTH is 16, and check the byte swap setting in TFT_eSPI. The SmartDocs guide lists enabling byte swapping with tft.setSwapBytes(true) as the fix for garbled colors. Source: SmartDocs.</p>



<p class="wp-block-paragraph"><strong>Buttons do not respond to touch.</strong> Check lv_indev_create and lv_indev_set_read_cb ran in setup, check the touch CS pin, and check the calibration map limits. Source: SmartDocs and Random Nerd Tutorials.</p>



<h2 class="wp-block-heading">Which route should you pick?</h2>



<p class="wp-block-paragraph">Match the tool to the job. For display selection, see our display buying guide.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Project</th>
<th>Pick</th>
<th>Why</th>
</tr>
</thead>
<tbody>
<tr>
<td>Temperature readout, clock, status text</td>
<td>TFT_eSPI alone</td>
<td>No buttons, no menus, less code</td>
</tr>
<tr>
<td>Thermostat with setpoint buttons</td>
<td>LVGL on TFT_eSPI, Route A</td>
<td>Buttons and a slider, one afternoon of work</td>
</tr>
<tr>
<td>Production firmware</td>
<td>LVGL on ESP-IDF with esp_lvgl_port</td>
<td>Version-pinned components and full control</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified live on qualityrcparts.com on 2026-11-21 through the public Store API. All four items are in stock.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/2-4-inch-spi-tft-lcd-touch-display-module-240x320-ili9341-driver/">2.4 Inch SPI TFT LCD Touch Display Module, 240&#215;320, ILI9341 driver</a> (ID 17813) &#8211; $20.99. The touch module for the worked example: ILI9341 driver, touch panel and pen.</li>
<li><a href="https://qualityrcparts.com/product/0-96-inch-tft-display-module-2-pack-color-ips-lcd-80x160-st7735-spi-for-arduino-esp32/">0.96 Inch TFT Display Module 2-Pack, Color IPS LCD 80&#215;160, ST7735 SPI for Arduino ESP32</a> (ID 19625) &#8211; $13.99. Two ST7735 modules for a small LVGL status screen without touch.</li>
<li><a href="https://qualityrcparts.com/product/esp32-development-board-with-1-9-inch-st7789-tft-lcd-display-16mb-wifi-bluetooth-usb-c/">ESP32 Development Board with 1.9 Inch ST7789 TFT LCD Display, 16MB, WiFi + Bluetooth, USB-C</a> (ID 17819) &#8211; $19.99. The built-in display board: no wiring, LVGL on TFT_eSPI with the ST7789 driver at 170 by 320.</li>
<li><a href="https://qualityrcparts.com/product/2-4-inch-tft-lcd-display-module-320x240-st7789-spi-color-screen-no-touch-for-arduino-esp32-esp8266/">2.4 Inch TFT LCD Display Module, 320&#215;240 ST7789 SPI Color Screen, No Touch, for Arduino ESP32 ESP8266</a> (ID 19630) &#8211; $14.99. The no-touch 2.4 inch module for LVGL status screens and gauges.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/tft-espi-setup-guide/">TFT_eSPI Setup Guide: Install, User_Setup.h, First Sketch</a></li>
<li><a href="/esp32-built-in-display-boards-tft-oled-guide/">ESP32 Boards with Built-In Displays: TFT vs OLED Compared</a></li>
<li><a href="/oled-vs-tft-display/">OLED vs TFT Display: Which Is Best for ESP32 Projects?</a></li>
<li><a href="/which-display-to-buy/">How to Choose the Right Display for Arduino or ESP32</a></li>
<li><a href="/best-esp32-boards-for-robotics-usa/">How to Choose ESP32 Boards for Your Robotics Projects</a></li>
<li><a href="/xiao-esp32-pinout-guide/">XIAO ESP32 Pinout: C3, C6, S3, and C5 GPIO Tables</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>What is LVGL?</strong>
LVGL is the Light and Versatile Graphics Library, a free and open-source graphics library under the MIT license. It provides widgets such as buttons, labels, sliders, charts, and lists, plus layouts, styles, animations, and touch input. Source: LVGL docs and Random Nerd Tutorials.</p>



<p class="wp-block-paragraph"><strong>Can I use LVGL with an ESP32 and a TFT display?</strong>
Yes. Install LVGL 9 in the Arduino IDE, set up TFT_eSPI for your display driver, bind them with the TFT_eSPI helper or a flush callback, then build your screen from widgets. Source: Random Nerd Tutorials LVGL 9.2 guide.</p>



<p class="wp-block-paragraph"><strong>Which LVGL version should I install?</strong>
Install LVGL 9.x for a new project. This guide is written against LVGL 9.2, and the LVGL docs currently serve the 9.4 line. LVGL 9 changed the display, input device, button, and screen function names, so LVGL 8 code will not compile against LVGL 9 without changes. Source: LVGL docs and the ElectricalFlux LVGL ESP32-S3 guide.</p>



<p class="wp-block-paragraph"><strong>Why is my LVGL screen blank after upload?</strong>
Check the backlight first, then run the TFT_eSPI Colour_Test sketch without LVGL. If Colour_Test fails, the problem is wiring or User_Setup.h, not LVGL. If it passes, check lv_conf.h placement and that loop calls lv_timer_handler and lv_tick_inc. Source: our TFT_eSPI setup guide and SmartDocs.</p>



<p class="wp-block-paragraph"><strong>How do I add touch to LVGL on ESP32?</strong>
Use the XPT2046 touch controller on touch TFT modules. Install the XPT2046_Touchscreen library, start a second SPI bus for the touch chip with its own chip select pin, register an LVGL input device with lv_indev_create, and set a read callback that maps raw touch values to screen pixels. Source: Random Nerd Tutorials.</p>



<p class="wp-block-paragraph"><strong>Can I use LVGL with ESP-IDF instead of Arduino?</strong>
Yes. Add the esp_lvgl_port component with idf.py add-dependency &#8220;espressif/esp_lvgl_port^2.3.0&#8221;, or add LVGL directly with idf.py add-dependency &#8220;lvgl/lvgl^9.*&#8221;. Source: LVGL docs, &#8220;Add LVGL to an ESP32 IDF project&#8221;.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>LVGL docs, Adding LVGL to Your Project (LVGL 9.4): <a href="https://docs.lvgl.io/master/details/integration/adding-lvgl-to-your-project/index.html" target="_blank" rel="noopener">https://docs.lvgl.io/master/details/integration/adding-lvgl-to-your-project/index.html</a></li>
<li>LVGL docs, Add LVGL to an ESP32 IDF project: <a href="https://lvgl.io/docs/open/integration/chip_vendors/espressif/add_lvgl_to_esp32_idf_project" target="_blank" rel="noopener">https://lvgl.io/docs/open/integration/chip_vendors/espressif/add_lvgl_to_esp32_idf_project</a></li>
<li>LVGL blog, ESP32 plus LVGL Quick Start Guide: <a href="https://lvgl.io/blog/tutorial-esp32-getting-started" target="_blank" rel="noopener">https://lvgl.io/blog/tutorial-esp32-getting-started</a></li>
<li>Random Nerd Tutorials, LVGL with ESP32 TFT Touchscreen, ILI9341 (Arduino), LVGL 9.2: <a href="https://randomnerdtutorials.com/lvgl-esp32-tft-touchscreen-display-ili9341-arduino/" target="_blank" rel="noopener">https://randomnerdtutorials.com/lvgl-esp32-tft-touchscreen-display-ili9341-arduino/</a></li>
<li>CircuitDigest, Arduino LVGL Tutorial: Build ESP32 GUI Step-by-Step: <a href="https://circuitdigest.com/tutorial/getting-started-with-arduino-lvgl" target="_blank" rel="noopener">https://circuitdigest.com/tutorial/getting-started-with-arduino-lvgl</a></li>
<li>SmartDocs, ESP32 plus TFT_eSPI plus LVGL Complete Guide: <a href="https://smartdocs.solvosync.ca/en/article/arduino-readme-2/" target="_blank" rel="noopener">https://smartdocs.solvosync.ca/en/article/arduino-readme-2/</a></li>
<li>ElectricalFlux, Getting Started with LVGL ESP32 S3: 8048S043 RGB Display Build and Debug Guide: <a href="https://electricalflux.com/mcu-projects/lvgl-esp32-s3-8048s043-rgb-build-debug" target="_blank" rel="noopener">https://electricalflux.com/mcu-projects/lvgl-esp32-s3-8048s043-rgb-build-debug</a></li>
<li>Elecrow Wiki, LVGL Arduino 2.4 inch ESP32 Touchscreen Environment Monitoring and LED Control: <a href="https://www.elecrow.com/wiki/2.4-inch-esp32-dispaly-arduino-tutorial.html" target="_blank" rel="noopener">https://www.elecrow.com/wiki/2.4-inch-esp32-dispaly-arduino-tutorial.html</a></li>
<li>Bodmer TFT_eSPI GitHub repo README: <a href="https://github.com/Bodmer/TFT_eSPI" target="_blank" rel="noopener">https://github.com/Bodmer/TFT_eSPI</a></li>
<li>Quality RC Parts, TFT_eSPI Setup Guide: <a href="https://qualityrcparts.com/tft-espi-setup-guide/">https://qualityrcparts.com/tft-espi-setup-guide/</a></li>
<li>Quality RC Parts, ESP32 Boards with Built-In Displays: TFT vs OLED Compared: <a href="https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/">https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/</a></li>
<li>Quality RC Parts, OLED vs TFT Display: <a href="https://qualityrcparts.com/oled-vs-tft-display/">https://qualityrcparts.com/oled-vs-tft-display/</a></li>
<li>Quality RC Parts, How to Choose the Right Display for Arduino or ESP32: <a href="https://qualityrcparts.com/which-display-to-buy/">https://qualityrcparts.com/which-display-to-buy/</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23589</post-id>	</item>
		<item>
		<title>Low-Power ESP32 Battery Projects: Deep Sleep and Solar</title>
		<link>https://qualityrcparts.com/low-power-esp32-battery-projects/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sun, 22 Nov 2026 02:33:02 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[battery]]></category>
		<category><![CDATA[battery-sizing]]></category>
		<category><![CDATA[deep-sleep]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-c3]]></category>
		<category><![CDATA[esp32-cam]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[esp32-solar]]></category>
		<category><![CDATA[lipo]]></category>
		<category><![CDATA[lipo-battery]]></category>
		<category><![CDATA[lipo-charging]]></category>
		<category><![CDATA[low-power]]></category>
		<category><![CDATA[solar-power]]></category>
		<category><![CDATA[wake-source]]></category>
		<category><![CDATA[xiao]]></category>
		<category><![CDATA[xiao-esp32]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/low-power-esp32-battery-projects/</guid>

					<description><![CDATA[A battery ESP32 project lives or dies on average current, not on the size of the pack. This guide covers every sleep mode, every wake source, battery sizing with worked examples, solar sizing from the worst month, and the board-level drains that kill a pack in days.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">A battery ESP32 project lives or dies on one number: average current. Get it right and a single 3000 mAh cell runs a field sensor for months. Get it wrong and the same cell is dead before dinner.</p>



<p class="wp-block-paragraph">This guide covers the five power modes, every wake source, board-level sleep drain, battery sizing, solar sizing, and the mistakes that drain a pack in days. The sensor node build is covered in <a href="/esp32-battery-sensor-node-deep-sleep/">ESP32 Battery Sensor Node: Deep Sleep and Power Budget</a>, and LiPo wiring in <a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a>.</p>



<h2 class="wp-block-heading">How long can an ESP32 really run on battery?</h2>



<p class="wp-block-paragraph">Battery life in hours equals usable battery capacity divided by average current. Average current is the awake share times the awake current, plus the sleep share times the sleep current. Source: ProjectECH; DroneBot Workshop; Hubble.</p>



<p class="wp-block-paragraph">Take a node that wakes for 20 seconds at 180 mA and sleeps at 15 microamps, on one 18650 cell with a realistic usable capacity of 2400 mAh. Source: ProjectECH.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Report interval</th>
<th>Average current</th>
<th>Battery life from 2400 mAh</th>
</tr>
</thead>
<tbody>
<tr>
<td>Every 10 minutes</td>
<td>(180 x 20 + 0.015 x 580) / 600 = about 6.0 mA</td>
<td>About 400 hours, about 16 days</td>
</tr>
<tr>
<td>Every 60 minutes</td>
<td>(180 x 20 + 0.015 x 3580) / 3600 = about 1.01 mA</td>
<td>About 2376 hours, about 99 days</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Three lessons fall out of that table. First, the interval dominates: 60-minute reports give roughly 6 times the battery life of 10-minute reports. Second, sleep current matters: with a 5 mA sleep the 60-minute column collapses to about 17 days. Third, awake time is the other lever: Wi-Fi can spend 3 to 8 seconds just joining the network, so cut the awake window to 5 seconds. Source: ProjectECH.</p>



<p class="wp-block-paragraph">Radios differ too: Wi-Fi transmit runs about 160 to 260 mA, BLE about 95 to 130 mA, and LoRa about 20 to 120 mA transmit with about 0.2 microamps in sleep. Source: ProjectECH; Hubble.</p>



<h2 class="wp-block-heading">Which sleep mode does your project need?</h2>



<p class="wp-block-paragraph">The ESP32 has five power states. The figures below are chip-level typicals; your board will draw more. Source: DroneBot Workshop; Espressif sleep modes documentation.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Mode</th>
<th>CPU and peripherals</th>
<th>Radio</th>
<th>Typical chip current</th>
<th>What survives</th>
</tr>
</thead>
<tbody>
<tr>
<td>Active</td>
<td>On</td>
<td>On or off</td>
<td>240 mA Wi-Fi transmit peak</td>
<td>Everything</td>
</tr>
<tr>
<td>Modem sleep</td>
<td>On</td>
<td>Off between checks</td>
<td>About 3 to 20 mA</td>
<td>Everything, Wi-Fi association kept</td>
</tr>
<tr>
<td>Light sleep</td>
<td>Paused</td>
<td>Off</td>
<td>About 0.8 mA</td>
<td>RAM and registers, resumes where it stopped</td>
</tr>
<tr>
<td>Deep sleep</td>
<td>Off</td>
<td>Off</td>
<td>About 10 to 25 microamps</td>
<td>RTC memory only, 8 KB slow memory</td>
</tr>
<tr>
<td>Hibernation</td>
<td>Off</td>
<td>Off</td>
<td>About 2.5 microamps</td>
<td>Nothing guaranteed, not even RTC memory</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph"><strong>Active</strong> is the normal running state; the only saving is lowering the CPU clock. <strong>Modem sleep</strong> turns the radios off between transmissions while the CPU keeps running, staying associated with the router by waking the radio on the DTIM interval. <strong>Light sleep</strong> pauses the CPU clock but preserves RAM and registers. <strong>Deep sleep</strong> powers down almost everything; only the RTC domain and optionally the ULP coprocessor stay alive. <strong>Hibernation</strong> is the deepest state: even the 8 MHz RTC oscillator and the ULP coprocessor are off, and RTC memory is not guaranteed. The only wake source is an EXT0 GPIO interrupt. Source: DroneBot Workshop.</p>



<h2 class="wp-block-heading">What wakes the ESP32 from deep sleep?</h2>



<p class="wp-block-paragraph">The wake source defines the whole power profile. Source: ProjectECH; DroneBot Workshop; Hubble.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Wake source</th>
<th>How it works</th>
<th>Best for</th>
</tr>
</thead>
<tbody>
<tr>
<td>Timer wake</td>
<td>RTC timer fires after N microseconds</td>
<td>Periodic sensing: wake, read, send, sleep</td>
</tr>
<tr>
<td>EXT0 wake</td>
<td>One RTC GPIO goes high or low</td>
<td>One event: a PIR motion sensor, a float switch, a door switch</td>
</tr>
<tr>
<td>EXT1 wake</td>
<td>Any of several RTC GPIOs changes</td>
<td>Several events at once</td>
</tr>
<tr>
<td>Touch pad wake</td>
<td>A configured touch pad crosses its threshold</td>
<td>A manual &#8220;report now&#8221; button on a sealed enclosure</td>
</tr>
<tr>
<td>ULP coprocessor</td>
<td>Runs while the main CPUs sleep, about 150 microamps typical</td>
<td>Wake the main CPU only on a threshold</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph"><strong>Timer wake</strong> is the workhorse: call esp_sleep_enable_timer_wakeup(), then esp_deep_sleep_start(). <strong>EXT0 and EXT1</strong> wake on a pin: EXT0 watches one RTC GPIO at one level, ideal for a PIR sensor, and EXT1 watches several. On the standard ESP32, RTC-capable GPIOs are 0, 2, 4, 12 to 15, 25 to 27, and 32 to 39. <strong>Touch wake</strong> uses the capacitive touch pins. <strong>The ULP coprocessor</strong> can poll an ADC channel or a GPIO while the main CPUs sleep and wake the main CPU only on a threshold. Source: ProjectECH; DroneBot Workshop; Hubble.</p>



<p class="wp-block-paragraph">Always configure a wake source first, or the chip sleeps forever. Source: ProjectECH.</p>



<p class="wp-block-paragraph">State survives deep sleep through RTC slow memory: variables declared with RTC_DATA_ATTR survive deep sleep, but not a power loss or a hard reset. Source: ProjectECH; TheLinuxCode; post 23387.</p>



<h2 class="wp-block-heading">Why does your dev board never reach the datasheet sleep current?</h2>



<p class="wp-block-paragraph">The datasheet deep sleep figure is the bare chip. A dev board adds parts that draw current around the clock, and those parts dominate the sleep budget. Source: ProjectECH; DroneBot Workshop; post 23387.</p>



<p class="wp-block-paragraph">A typical 30-pin DevKit board carries an AMS1117-3.3 linear regulator with a quiescent current of about 5 mA typical. With the USB chip, power LED, and pull-ups added, a &#8220;sleeping&#8221; dev board typically draws 5 to 15 mA. At 10 mA, a 3000 mAh cell lasts 300 hours, under two weeks. Source: ProjectECH; DroneBot Workshop.</p>



<p class="wp-block-paragraph">Fix it in one of three ways: power the board through the 3V3 pin from an efficient external regulator; use a bare ESP32 module on a minimal breakout; or use a board designed for battery use. Measure the sleep current yourself first. Source: ProjectECH.</p>



<p class="wp-block-paragraph">The XIAO boards stocked at QRC are the battery-friendly end of this scale, and the figures conflict across sources, so they are stated here as a sourced range, never as a single bench-tested number. Seeed&#8217;s wiki lists the plain XIAO ESP32S3 at 14 microamps in deep sleep, 2 mA in light sleep, and 27 mA in modem sleep. The XIAO ESP32S3 Sense with its expansion board attached is listed at 3 mA in deep sleep: the expansion board costs roughly 200 times the plain board&#8217;s sleep current, so detach it for a battery build and use the detachable camera only when the project needs it. The XIAO ESP32S3 Plus is listed at 33.51 microamps in deep sleep, and the XIAO ESP32C3 at 44 microamps. CircuitDigest measured a plain XIAO ESP32S3 board at 130 microamps in deep sleep, against a bare ESP32-S3 chip rating of 7 to 8 microamps. Plan with the worst figure in the range. Source: Seeed Studio XIAO ESP32S3 wiki; CircuitDigest; Embedded Nerd.</p>



<h2 class="wp-block-heading">How do you size the battery?</h2>



<p class="wp-block-paragraph">Measure the build that will actually run from the battery. Source: UMA Technology; Hubble.</p>



<p class="wp-block-paragraph"><strong>Step 1: measure each operating state.</strong> Record current in each state with a USB power meter, and use a multimeter in series with the battery lead for sleep. Source: UMA Technology; Hubble.</p>



<p class="wp-block-paragraph"><strong>Step 2: calculate the average current.</strong> For each state, multiply current by time in that state, then sum and divide by the cycle time. Example: wake every 15 minutes, transmit for 5 seconds at 150 mA, sleep the other 895 seconds at 15 microamps. Average equals (5 x 150 + 895 x 0.015) / 900, which is 0.85 mA. Source: Hubble.</p>



<p class="wp-block-paragraph"><strong>Step 3: divide capacity by average current, then derate.</strong> A 3000 mAh battery at 0.85 mA average gives about 3,500 hours, about 146 days. Now derate: usable capacity is about 70 to 80 percent of the label after aging, temperature, and self-discharge, so plan on about 2400 mAh usable from a 3000 mAh cell. Source: ProjectECH; Hubble; e-fm.tech.</p>



<p class="wp-block-paragraph"><strong>Step 4: pick the chemistry.</strong> A standard LiPo at 3.7 V is workable for 6 to 12 month projects. A LiFePO4 cell at 3.2 V has low self-discharge around 3 percent per year, so it suits solar recharging. A CR2032 at 220 mAh suits only the lowest-power applications. Source: Hubble.</p>



<p class="wp-block-paragraph">The biggest lever is the awake time: every second of Wi-Fi connect time at 150 mA costs as much as 150 seconds of sleep at 1 mA. Source: post 23387.</p>



<h2 class="wp-block-heading">How do you size a solar panel for an ESP32 project?</h2>



<p class="wp-block-paragraph">A solar panel only has to replace what the board uses, plus the charging losses. Size it from the worst month, not the average: a panel sized for summer sun dies by mid-December. Source: Hubble solar sizing guide; e-fm.tech.</p>



<p class="wp-block-paragraph"><strong>Step 1: daily energy.</strong> Daily energy equals average current times supply voltage times 24 hours. The 0.85 mA node at 3.7 V uses about 76 mWh per day. Source: Hubble solar sizing guide.</p>



<p class="wp-block-paragraph"><strong>Step 2: battery autonomy.</strong> Size for three cloudy days: three days at 76 mWh per day is 228 mWh, or about 62 mAh at 3.7 V. Source: e-fm.tech; post 23188; post 15185.</p>



<p class="wp-block-paragraph"><strong>Step 3: worst-month peak sun hours.</strong> Peak sun hours are the hours per day of full sunlight that would deliver the same energy as the real day. Look it up for your coordinates with PVGIS or NASA POWER, and use the worst month. Source: e-fm.tech.</p>



<p class="wp-block-paragraph"><strong>Step 4: panel watts.</strong> Panel watts are about equal to daily energy divided by (charging efficiency times peak sun hours times a derating factor). The worked example comes out to about 0.021 to 0.11 W. In practice, fit a panel several times larger than the paper minimum. Source: e-fm.tech; Hubble solar sizing guide.</p>



<p class="wp-block-paragraph"><strong>Step 5: charge controller.</strong> A small panel charging a single lithium cell needs a charger that terminates at 4.2 V and a protection circuit. The TP4056 module below charges a single cell from USB or a solar panel at up to 1 A. Standard lithium-ion and LiPo cells should not be charged below about 0 degrees C. Source: ProjectECH; e-fm.tech.</p>



<p class="wp-block-paragraph">No solar panel is stocked at QRC as of 2026-11-21, so no panel is linked in this guide. The BirdBox build in <a href="/birdbox-camera-solar-pir-deep-sleep/">Run a BirdBox Camera for Months on Solar Power</a> shows the same pattern: panel in full sun, short cable, battery sized for three cloudy days.</p>



<h2 class="wp-block-heading">How do you charge and protect the pack?</h2>



<p class="wp-block-paragraph">Charging, protection, and regulation are three separate jobs, and one module does not always do all three. The full wiring chain is covered in <a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a>. Source: post 19087.</p>



<p class="wp-block-paragraph"><strong>The TP4056 load-sharing trap.</strong> The TP4056 has no load sharing: it cannot tell current going into the battery from current drawn by your circuit. With the load on the battery terminals, the charger sees the load current as charge current, never detects the proper termination taper, and can keep pushing current into an already-full cell. Wire battery to B+ and B-, supply to IN+ and IN-, and take system power from OUT+ and OUT-. The proper fix is a load-sharing power-path circuit. Source: ProjectECH; post 19087.</p>



<p class="wp-block-paragraph"><strong>The cutoff voltage has no single agreed number.</strong> Sources disagree on the per-cell cutoff, with figures from 3.0 V to 3.5 V per cell. This guide states that range and does not pick one number. Read the cutoff from the docs for the protection module and the battery you own, and wire the protection so it disconnects the pack from everything. The stocked 3000 mAh pack below has a built-in protection board. Source: post 19087.</p>



<h2 class="wp-block-heading">What mistakes drain a battery pack in days?</h2>



<ul class="wp-block-list">

<li><strong>Trusting the chip sleep figure for the whole board.</strong> The chip sleeps at 10 to 25 microamps; the board sleeps at milliamps. Measure the whole board.</li>
<li><strong>Leaving Wi-Fi on between readings.</strong> A board that idles with Wi-Fi connected draws 35 mA or more. Sleep between readings.</li>
<li><strong>Letting Wi-Fi join slowly, every cycle.</strong> Every awake second at 150 mA costs as much as 150 seconds of sleep at 1 mA. Use a static IP and cap retries at three.</li>
<li><strong>Sizing the solar panel for summer.</strong> The panel must cover the worst month, not the average. Size from worst-month peak sun hours, and test through a cloudy week.</li>
<li><strong>Never measuring the sleep current.</strong> Every battery estimate in this guide is arithmetic from stated inputs. Measure your own board&#8217;s sleep current and redo the math.</li>

</ul>



<h2 class="wp-block-heading">How do you fix a low-power project that dies too soon?</h2>



<p class="wp-block-paragraph"><strong>The board draws milliamps in deep sleep.</strong> Measure the board alone, then the regulator or converter alone. The likely causes are the power LED, the USB-to-serial chip, or a regulator with high standby draw. Power the 3V3 pin directly from a regulated 3.3 V supply, or remove the power LED where the board allows it. Source: DroneBot Workshop; post 23387.</p>



<p class="wp-block-paragraph"><strong>The node boot-loops when the battery gets low.</strong> A nearly empty cell sags under a Wi-Fi transmit burst, and if the sag crosses the brownout threshold the chip resets mid-transmission. Treat 3.2 to 3.3 V under load as the effective empty point. The brownout fix is covered in <a href="/esp32-cam-troubleshooting-brownout-camera-init-failed/">ESP32-CAM Troubleshooting: Brownout and Camera Init Failed</a>. Source: ProjectECH.</p>



<p class="wp-block-paragraph"><strong>The battery voltage falls every week even with solar.</strong> The panel is too small for the worst month, the panel is shaded or flat, or the charge current never tapers. Check the battery voltage after the first week, and add panel size if it keeps falling. Source: post 23188; ProjectECH.</p>



<h2 class="wp-block-heading">Which low-power setup fits your project?</h2>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Project</th>
<th>Wake source</th>
<th>Sleep mode</th>
<th>Battery</th>
<th>Solar</th>
</tr>
</thead>
<tbody>
<tr>
<td>Temperature sensor, hourly reports</td>
<td>Timer</td>
<td>Deep sleep</td>
<td>3000 mAh 1S LiPo pack</td>
<td>Not needed</td>
</tr>
<tr>
<td>PIR wildlife or BirdBox camera</td>
<td>EXT0 on the PIR output</td>
<td>Deep sleep</td>
<td>3000 mAh pack or larger</td>
<td>Yes, worst-month panel</td>
</tr>
<tr>
<td>Always-on display or dashboard</td>
<td>None, it must stay awake</td>
<td>Modem sleep between updates</td>
<td>USB power bank or mains</td>
<td>No, the radio stays too busy</td>
</tr>
<tr>
<td>BLE beacon</td>
<td>Timer, duty-cycled BLE scan</td>
<td>Deep sleep between scans</td>
<td>XIAO board with on-board charging</td>
<td>Optional</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock verified live on 2026-11-21. All four items below are in stock and purchasable.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32s3-development-board-1-pack/">Seeed Studio XIAO ESP32S3 Development Board, 1-Pack</a> (ID 17839) &#8211; $21.49 sale, $25.99 regular. Dual-core 240 MHz ESP32-S3, Wi-Fi and BLE, USB-C, lithium battery charging on board. Seeed lists 14 microamps deep sleep.</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32c3-development-board-1-pack/">Seeed Studio XIAO ESP32C3 Development Board, 1-Pack</a> (ID 17820) &#8211; $13.99 sale, $16.99 regular. RISC-V ESP32-C3, Wi-Fi and BLE, USB-C, lithium battery charging on board. Seeed lists 44 microamps deep sleep.</li>
<li><a href="https://qualityrcparts.com/product/3-7v-3000mah-lipo-battery-1s-jst-1-25-plug-for-esp32-and-arduino-boards-4-pack/">3.7V 3000mAh LiPo Battery, 1S, JST 1.25 Plug, for ESP32 and Arduino Boards, 4-Pack</a> (ID 18961) &#8211; $35.99 sale, $43.99 regular. Single-cell packs with a built-in protection board and JST 1.25 plug.</li>
<li><a href="https://qualityrcparts.com/product/tp4056-5v-micro-usb-1a-lithium-battery-charging-module-1-pack/">TP4056 5V Micro USB 1A Lithium Battery Charging Module (1 Pack)</a> (ID 16875) &#8211; $1.49. Charges a single lithium cell at up to 1 A from 5 V micro USB, terminates at 4.2 V. Bench charging only: no load sharing.</li>

</ul>



<p class="wp-block-paragraph">Also verified live in stock: XIAO ESP32C6 1-Pack (ID 17835) $15.99 sale; XIAO ESP32-C5 1-Pack (ID 18380) $17.99 sale; XIAO ESP32S3 Sense 1-Pack (ID 17842) $32.49 sale, detachable camera; ESP32 DevKit V1, $9.99 sale; USB-C LiPo Module 1200mAh (ID 18959) $14.99 sale; HC-SR501 PIR (ID 14636) $5.99 sale; CellMeter8 (ID 3485) $19.99. No solar panel is stocked at QRC, so none is linked.</p>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-battery-sensor-node-deep-sleep/">ESP32 Battery Sensor Node: Deep Sleep and Power Budget</a></li>
<li><a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a></li>
<li><a href="/lipo-charging-balance-guide/">How to Balance Charge a LiPo Battery With an Adapter Cable</a></li>
<li><a href="/birdbox-camera-solar-pir-deep-sleep/">Run a BirdBox Camera for Months on Solar Power</a></li>
<li><a href="/wildlife-camera-esp32-s3-cam-pir/">How to Build a Wildlife Camera with an ESP32-S3-CAM</a></li>
<li><a href="/xiao-esp32-pinout-guide/">XIAO ESP32 Pinout Guide</a></li>
<li><a href="/esp32-cam-troubleshooting-brownout-camera-init-failed/">ESP32-CAM Troubleshooting: Brownout and Camera Init Failed</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>How long will an ESP32 run on a battery?</strong>
It depends on the average current, not the pack size alone. A node that wakes 5 seconds at 150 mA every 15 minutes and sleeps at 15 microamps averages about 0.85 mA, so a 3000 mAh battery gives about 146 days. Source: Hubble.</p>



<p class="wp-block-paragraph"><strong>Why does my ESP32 use milliamps in deep sleep?</strong>
The datasheet figure is the bare chip. The dev board adds a linear regulator with about 5 mA quiescent current, a USB-to-serial chip, and a power LED. Source: ProjectECH; DroneBot Workshop.</p>



<p class="wp-block-paragraph"><strong>What wakes an ESP32 from deep sleep?</strong>
The RTC timer for periodic work, EXT0 for one pin event such as a PIR sensor, EXT1 for any of several pins, a touch pad for a button, and the ULP coprocessor at about 150 microamps. Source: ProjectECH; Hubble.</p>



<p class="wp-block-paragraph"><strong>How big a battery do I need for an ESP32 sensor?</strong>
Work out the average current first, then divide capacity by average current, then derate to about 70 to 80 percent usable. Source: ProjectECH; Hubble.</p>



<p class="wp-block-paragraph"><strong>Can I run an ESP32 on solar power?</strong>
Yes. Work out the daily energy, size the battery for three cloudy days, look up the worst-month peak sun hours, and divide daily energy by charging efficiency times peak sun hours times a derating factor. Source: Hubble; e-fm.tech.</p>



<p class="wp-block-paragraph"><strong>What is a safe cutoff voltage for a LiPo on an ESP32 project?</strong>
No single cutoff voltage is universal: sources disagree, with figures from 3.0 V to 3.5 V per cell. Use a protected pack or a protection module, read the cutoff from its docs, and wire it so it disconnects the pack from all loads. Source: post 19087.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Quality RC Parts, ESP32 Battery Sensor Node: Deep Sleep and Power Budget (post 23387): <a href="https://qualityrcparts.com/esp32-battery-sensor-node-deep-sleep/">https://qualityrcparts.com/esp32-battery-sensor-node-deep-sleep/</a></li>
<li>Quality RC Parts, How to Power ESP32 and Arduino Projects on LiPo Power (post 19087): <a href="https://qualityrcparts.com/power-esp32-arduino-projects-lipo/">https://qualityrcparts.com/power-esp32-arduino-projects-lipo/</a></li>
<li>Quality RC Parts, Run a BirdBox Camera for Months on Solar Power (post 23188): <a href="https://qualityrcparts.com/birdbox-camera-solar-pir-deep-sleep/">https://qualityrcparts.com/birdbox-camera-solar-pir-deep-sleep/</a></li>
<li>Quality RC Parts, How to Build a Wildlife Camera with an ESP32-S3-CAM (post 15185): <a href="https://qualityrcparts.com/wildlife-camera-esp32-s3-cam-pir/">https://qualityrcparts.com/wildlife-camera-esp32-s3-cam-pir/</a></li>
<li>Quality RC Parts, XIAO ESP32 Pinout Guide: <a href="https://qualityrcparts.com/xiao-esp32-pinout-guide/">https://qualityrcparts.com/xiao-esp32-pinout-guide/</a></li>
<li>Quality RC Parts, SuperMini vs XIAO ESP32: <a href="https://qualityrcparts.com/supermini-vs-xiao-esp32/">https://qualityrcparts.com/supermini-vs-xiao-esp32/</a></li>
<li>Quality RC Parts, ESP32-CAM vs ESP32-S3-CAM Camera Projects Guide: <a href="https://qualityrcparts.com/esp32-cam-s3-cam-camera-projects-guide/">https://qualityrcparts.com/esp32-cam-s3-cam-camera-projects-guide/</a></li>
<li>Quality RC Parts, How to Balance Charge a LiPo Battery With an Adapter Cable: <a href="https://qualityrcparts.com/lipo-charging-balance-guide/">https://qualityrcparts.com/lipo-charging-balance-guide/</a></li>
<li>Quality RC Parts, ESP32-CAM Troubleshooting: Brownout and Camera Init Failed: <a href="https://qualityrcparts.com/esp32-cam-troubleshooting-brownout-camera-init-failed/">https://qualityrcparts.com/esp32-cam-troubleshooting-brownout-camera-init-failed/</a></li>
<li>Quality RC Parts, ESP32-S3 Face Detection Guide: <a href="https://qualityrcparts.com/esp32-s3-face-detection-guide/">https://qualityrcparts.com/esp32-s3-face-detection-guide/</a></li>
<li>Quality RC Parts store listings, checked live 2026-11-21 (IDs 17839, 17820, 18961, 16875, plus 17835, 18380, 17842, 18959, 14636, 3485)</li>
<li>ProjectECH, ESP32 Low-Power Battery Design: Deep Sleep Guide: <a href="https://projectech.in/guides/esp32-low-power-battery-design-guide/" target="_blank" rel="noopener">https://projectech.in/guides/esp32-low-power-battery-design-guide/</a></li>
<li>DroneBot Workshop, ESP32 Low-Power Modes: <a href="https://dronebotworkshop.com/esp32-low-power/" target="_blank" rel="noopener">https://dronebotworkshop.com/esp32-low-power/</a></li>
<li>TheLinuxCode, Maximizing ESP32 Battery Life Utilizing Deep Sleep and Timer Wakeup: <a href="https://thelinuxcode.com/esp32-deep-sleep-wake-up-timer-arduino-ide/" target="_blank" rel="noopener">https://thelinuxcode.com/esp32-deep-sleep-wake-up-timer-arduino-ide/</a></li>
<li>Hubble Network, How to Achieve 2-Year Battery Life with ESP32: <a href="https://hubble.com/community/guides/how-to-achieve-2-year-battery-life-with-esp32/" target="_blank" rel="noopener">https://hubble.com/community/guides/how-to-achieve-2-year-battery-life-with-esp32/</a></li>
<li>Hubble Network, How to Size a Solar Panel for a Remote IoT Sensor: <a href="https://hubble.com/community/guides/how-to-size-a-solar-panel-for-a-remote-iot-sensor/" target="_blank" rel="noopener">https://hubble.com/community/guides/how-to-size-a-solar-panel-for-a-remote-iot-sensor/</a></li>
<li>e-fm.tech, Solar Panel and Battery Sizing for a LoRaWAN Node: <a href="https://www.e-fm.tech/blog/size-solar-panel-battery-lorawan-node" target="_blank" rel="noopener">https://www.e-fm.tech/blog/size-solar-panel-battery-lorawan-node</a></li>
<li>UMA Technology, ESP32 Solar Power: Choose the Right Battery, Panel and Charger: <a href="http://umatechnology.org/how-to-choose-a-battery-and-solar-panel-for-an-esp32-project/" target="_blank" rel="noopener">http://umatechnology.org/how-to-choose-a-battery-and-solar-panel-for-an-esp32-project/</a></li>
<li>Seeed Studio Wiki, Getting Started with Seeed Studio XIAO ESP32-S3 Series: <a href="https://wiki.seeedstudio.com/xiao_esp32s3_getting_started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/xiao_esp32s3_getting_started/</a></li>
<li>CircuitDigest, ESP32 Deep Sleep Mode: Cut Current 99.6% to 130 uA: <a href="https://circuitdigest.com/microcontroller-projects/esp32-active-mode-and-deep-sleep-mode-power-consumption" target="_blank" rel="noopener">https://circuitdigest.com/microcontroller-projects/esp32-active-mode-and-deep-sleep-mode-power-consumption</a></li>
<li>Embedded Nerd, XIAO ESP32S3 Sense: Specs, Pinout and Where to Buy: <a href="https://embeddednerd.com/products/seeed-xiao-esp32s3-sense/" target="_blank" rel="noopener">https://embeddednerd.com/products/seeed-xiao-esp32s3-sense/</a></li>
<li>Espressif, ESP32 Series Datasheet and sleep modes documentation, via posts 23387 and 19087 and the sources above</li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23588</post-id>	</item>
		<item>
		<title>OLED vs TFT Display: Which Is Best for ESP32 Projects?</title>
		<link>https://qualityrcparts.com/oled-vs-tft-display/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sun, 22 Nov 2026 00:00:20 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/oled-vs-tft-display/</guid>

					<description><![CDATA[OLED and TFT displays solve the same job in opposite ways: OLED pixels make their own light, TFT pixels filter a backlight. This guide compares contrast, viewing angle, power, speed, cost, and lifespan, then matches each display to the project it fits.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Pick the display by what the screen has to show. An OLED display makes its own light, pixel by pixel. A TFT display filters light from a backlight that stays on the whole time the screen is on. That one difference decides contrast, viewing angle, power use, speed, cost, and how long the screen lasts.</p>



<p class="wp-block-paragraph">Short answer: buy the OLED for crisp text, sensor readouts, clocks, and battery builds where the screen is mostly dark. Buy the TFT for color menus, graphs, gauges, photos, and touch screens. If your project shows one color of text on a small screen, the OLED wins. If it needs color or a bigger picture, the TFT wins.</p>



<h2 class="wp-block-heading">How does an OLED display work?</h2>



<p class="wp-block-paragraph">OLED means organic light-emitting diode. Each pixel is its own tiny light source. When current passes through the organic layer, that pixel glows. When the pixel is off, it makes no light at all. There is no backlight, no light to filter, and no light leaking through a dark pixel. That is why OLED text looks so sharp: a black background is truly black, and a lit pixel sits next to a fully dark one.</p>



<p class="wp-block-paragraph">The OLED modules in the store use the SSD1306 driver chip, a single-chip CMOS OLED driver with controller for a 128 by 64 dot matrix, with built-in contrast control, display RAM, and an oscillator. The common 0.96 inch module is 128 by 64 pixels, one color, over I2C with four wires: power, ground, SDA, and SCL.</p>



<p class="wp-block-paragraph">Adafruit publishes the power figure for its 128 by 64 OLED breakout: on average the display uses about 20 mA from the 3.3 V supply, and the draw depends on how much of the display is lit. A mostly dark screen with a few lines of text draws less than a mostly lit one.</p>



<p class="wp-block-paragraph">Small mono OLED modules are cheap and common. Bigger OLED panels and color OLED panels cost far more than a TFT of the same size. The organic pixels age with use, and a pixel left on for weeks can leave a permanent ghost image, called burn-in.</p>



<h2 class="wp-block-heading">How does a TFT display work?</h2>



<p class="wp-block-paragraph">TFT means thin-film transistor, and a TFT display is a type of LCD. The liquid crystals in the panel do not make light. They sit in front of a backlight and twist to let that light through, pixel by pixel. A tiny transistor behind every pixel controls how much light passes. Color comes from red, green, and blue filters over the pixels. The backlight is the price of the design: it draws current the whole time the screen is on, no matter what the picture shows.</p>



<p class="wp-block-paragraph">The TFT modules in the store use SPI and one of three common driver chips. The ST7735 drives small color modules such as the 0.96 inch 80 by 160 and the 1.8 inch 128 by 160. The ST7789 drives larger color modules such as the 1.9 inch 170 by 320 board. The ILI9341 drives the 2.4 inch and 2.8 inch 240 by 320 modules, including the touch versions. All three show 65,536 colors (16-bit color).</p>



<p class="wp-block-paragraph">A TFT needs more pins than an I2C OLED. SPI needs five signal wires: clock, data, chip select, data/command, and reset, plus the backlight pin. TFT strengths are color, size, brightness, and lifespan. The weaknesses are backlight power draw, extra wiring, and weaker contrast: a black pixel still lets some backlight through.</p>



<h2 class="wp-block-heading">OLED vs TFT: the full comparison</h2>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Feature</th>
<th>OLED (SSD1306 module)</th>
<th>TFT (ST7735 / ST7789 / ILI9341 module)</th>
</tr>
</thead>
<tbody>
<tr>
<td>How it makes light</td>
<td>Each pixel makes its own light, no backlight</td>
<td>Backlight shines through liquid crystals</td>
</tr>
<tr>
<td>Colors</td>
<td>One color (blue, white, or yellow-blue)</td>
<td>Full color, 65,536 colors</td>
</tr>
<tr>
<td>Typical sizes in the store</td>
<td>0.91 to 1.3 inch</td>
<td>0.96 to 3.2 inch</td>
</tr>
<tr>
<td>Resolution</td>
<td>128 by 64 (0.96 inch), 128 by 32 (0.91 inch)</td>
<td>80 by 160 up to 320 by 240</td>
</tr>
<tr>
<td>Interface</td>
<td>I2C, 2 data wires, 4 wires total</td>
<td>SPI, 5 signal wires plus backlight</td>
</tr>
<tr>
<td>Libraries</td>
<td>Adafruit SSD1306, U8g2</td>
<td>TFT_eSPI, Adafruit ILI9341, Adafruit ST7735</td>
</tr>
<tr>
<td>Contrast</td>
<td>True black, effectively infinite contrast</td>
<td>Black leaks backlight; IPS panels around 1000:1</td>
</tr>
<tr>
<td>Viewing angle</td>
<td>Wide, colors hold off-axis</td>
<td>Narrow on TN panels; IPS is wider but still shifts</td>
</tr>
<tr>
<td>Sunlight readability</td>
<td>Poor in direct sun</td>
<td>Better, backlight fights glare</td>
</tr>
<tr>
<td>Power behavior</td>
<td>Varies with content; dark screens draw less</td>
<td>Near constant; backlight sets the draw</td>
</tr>
<tr>
<td>Published current draw</td>
<td>About 20 mA average (Adafruit)</td>
<td>None published for the store TFT modules</td>
</tr>
<tr>
<td>Response speed</td>
<td>Under 0.1 ms per pixel (panel class)</td>
<td>8 to 25 ms per pixel (panel class)</td>
</tr>
<tr>
<td>Burn-in</td>
<td>Yes, static images can leave a ghost</td>
<td>No</td>
</tr>
<tr>
<td>Lifespan (panel class)</td>
<td>20,000 to 50,000 hours</td>
<td>50,000 to 100,000 hours</td>
</tr>
<tr>
<td>Cost in the store</td>
<td>0.96 inch module $7.49</td>
<td>From $10.99 by size; 2.4 inch module $14.99</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: SSD1306 datasheet; Adafruit OLED guide; Golden Vision; OPL Display. Panel-class figures are industry figures, not measurements of the store modules.</p>



<h2 class="wp-block-heading">Which display has better contrast?</h2>



<p class="wp-block-paragraph">OLED, by a wide margin. An OLED pixel that is off makes no light, so black is truly black and contrast is effectively infinite. A TFT pixel that is supposed to be black still lets some backlight leak through, so black looks dark gray. Golden Vision puts it plainly: an OLED screen reaches infinite static contrast, a VA LCD reaches 3,000:1, and an IPS LCD reaches 1,000:1.</p>



<p class="wp-block-paragraph">That gap shows up in dark rooms. White text on a black OLED background is crisp because the background adds no light at all. The same screen on a TFT has a faint glow across the whole panel. IPS panels are better than older TN panels, but even a good IPS TFT cannot turn a pixel fully off.</p>



<h2 class="wp-block-heading">Which display is easier to read at an angle or in sunlight?</h2>



<p class="wp-block-paragraph">Two different questions, two different winners. At an angle, OLED wins. In sunlight, TFT wins.</p>



<p class="wp-block-paragraph">An OLED pixel makes its own light, so the picture looks the same from the side as from the front. Colors stay stable and brightness holds steady. A TFT passes backlight through liquid crystal layers, and off-axis viewing changes what the eye receives: contrast drops, colors shift, and a dark scene can look gray from the side.</p>



<p class="wp-block-paragraph">In sunlight the result flips. A TFT backlight can be pushed bright enough to fight glare, and a TFT stays readable outdoors. An OLED struggles in direct sun: its pixels cannot reach the same peak brightness without risking damage or rapid aging, and the screen looks washed out. If the project lives outdoors, on a dashboard, or in a bright window, pick the TFT.</p>



<h2 class="wp-block-heading">Which display uses less power?</h2>



<p class="wp-block-paragraph">It depends on what the screen shows. There is no single power winner, and any guide that names one without saying &#8220;it depends&#8221; is guessing.</p>



<p class="wp-block-paragraph">An OLED draws power per lit pixel. A dark screen with a few lines of text draws very little. A bright, mostly white screen draws much more. Adafruit publishes about 20 mA average from the 3.3 V supply for its 128 by 64 OLED breakout, with the note that the draw depends on how much of the display is lit.</p>



<p class="wp-block-paragraph">A TFT draws power near constantly. The backlight stays on at a set level no matter what the picture shows, so a white document and a black menu consume almost the same energy. Lowering the backlight saves power without hurting the picture much indoors, and that makes TFT power budgeting simple: the backlight setting decides the draw.</p>



<p class="wp-block-paragraph">No published current-draw figure exists for the TFT modules in the store, so this guide gives none. For a battery build, the practical rule is: OLED for screens that are mostly dark and update rarely, TFT only when the project genuinely needs color.</p>



<h2 class="wp-block-heading">Which display is faster?</h2>



<p class="wp-block-paragraph">OLED pixels switch faster than liquid crystals can twist. OPL Display lists OLED response under 0.1 ms against 8 to 25 ms for TFT LCD panels.</p>



<p class="wp-block-paragraph">But the panel is not the only speed limit. A standard 128 by 64 OLED over I2C at 400 kHz manages only about 10 frames per second for full-screen updates, because the bus, not the panel, is the bottleneck. An SPI TFT moves far more pixels per second and suits real-time charts and menus. If the project animates, pick the TFT on SPI.</p>



<h2 class="wp-block-heading">Which display lasts longer?</h2>



<p class="wp-block-paragraph">TFT, for always-on and static content. OLED pixels age with use, and the blue organic material ages fastest. A static menu, logo, or status bar left on the same pixels for weeks can leave a permanent ghost image. TFT liquid crystals do not wear unevenly, so a TFT shows fixed content for years without visible burn-in.</p>



<p class="wp-block-paragraph">OPL Display gives panel-class lifespan figures: TFT LCD 50,000 to 100,000 hours, OLED 20,000 to 50,000 hours depending on color and usage. Those are industry figures for the panel classes, not measurements of the store modules. For a wall display, a kiosk, or any screen that shows the same image for months, pick the TFT</p>



<h2 class="wp-block-heading">Which display costs less?</h2>



<p class="wp-block-paragraph">For small mono screens, OLED. For color and larger screens, TFT.</p>



<p class="wp-block-paragraph">The 0.96 inch OLED module is $7.49 in the store. TFT modules start at $10.99 and run to $25.49 by size, with the 2.4 inch module at $14.99. As the screen gets bigger and gains color, TFT takes over: color OLED panels cost far more than a TFT of the same size, and above 1.3 inch TFT is the economical choice for color.</p>



<p class="wp-block-paragraph">A TFT also needs more pins, more code, and more power, which can mean a bigger battery or a bigger board.</p>



<h2 class="wp-block-heading">Which display should you buy?</h2>



<p class="wp-block-paragraph">Match the display to the job, not to the spec sheet. This section is the short pick list. For the full size and price picker, see <a href="/which-display-to-buy/">How to Choose the Right Display for Arduino or ESP32</a>.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Project</th>
<th>Pick</th>
<th>Why</th>
</tr>
</thead>
<tbody>
<tr>
<td>Sensor readout, temperature, humidity</td>
<td>0.96 inch OLED</td>
<td>Crisp text, 4 wires, lowest cost</td>
</tr>
<tr>
<td>Clock, timer, counter</td>
<td>0.96 inch OLED</td>
<td>Dark background, low draw, sharp digits</td>
</tr>
<tr>
<td>Weather station with graphs</td>
<td>2.4 inch TFT</td>
<td>Color graphs need pixels and color</td>
</tr>
<tr>
<td>Color menu or settings screen</td>
<td>1.9 inch TFT board or 2.4 inch TFT module</td>
<td>Full color, room for buttons and icons</td>
</tr>
<tr>
<td>Touch interface</td>
<td>2.8 inch TFT with touch</td>
<td>Resistive touch, needs calibration once</td>
</tr>
<tr>
<td>Battery sensor node</td>
<td>0.96 inch OLED</td>
<td>Dark screen, sleep mode, 4 wires</td>
</tr>
<tr>
<td>Outdoor or bright-room display</td>
<td>TFT</td>
<td>Backlight beats sunlight</td>
</tr>
<tr>
<td>Always-on status screen</td>
<td>TFT</td>
<td>No burn-in on static content</td>
</tr>
<tr>
<td>First display project</td>
<td>0.96 inch OLED</td>
<td>Four wires, Adafruit SSD1306 library, $7.49</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Buying a color OLED when a TFT costs less.</strong> Small mono OLED modules are cheap. Color OLED panels are not.</li>
<li><strong>Assuming OLED always uses less power.</strong> OLED wins on dark screens and loses on bright ones. A mostly white OLED screen can draw more than a TFT at low backlight.</li>
<li><strong>Using the wrong driver chip.</strong> The 0.96 inch module uses the SSD1306. The 1.3 inch OLED looks the same but uses the SH1106 driver. Code written for the SSD1306 shows shifted or noisy pixels on an SH1106, so use a library that supports the SH1106, such as U8g2.</li>
<li><strong>Wiring the OLED power pins backwards.</strong> OLED modules come with VCC and GND in either order.</li>
<li><strong>Leaving a static image on an OLED for months.</strong> Burn-in is permanent.</li>
<li><strong>Expecting a TFT to match OLED contrast.</strong> A TFT black pixel still leaks backlight.</li>
<li><strong>Forgetting the backlight pin on a TFT.</strong> The backlight needs power and, on most modules, a pin to control it.</li>

</ul>



<h2 class="wp-block-heading">How do I troubleshoot a display problem?</h2>



<p class="wp-block-paragraph"><strong>The OLED shows nothing.</strong> Check power first: VCC and GND order varies by module, so read the labels on your module. Then check the I2C address. The SSD1306 address is usually 0x3C</p>



<p class="wp-block-paragraph"><strong>The OLED shows shifted or noisy pixels.</strong> The driver chip is wrong for the library. A 1.3 inch module with the SH1106 chip shows shifted pixels under SSD1306 code. Switch to a library that supports the SH1106, such as U8g2,</p>



<p class="wp-block-paragraph"><strong>The TFT shows a white screen.</strong> The display is powered but never initialized. Check that the driver in the code matches the chip on the module: ST7735, ST7789, and ILI9341 need different init code.</p>



<p class="wp-block-paragraph"><strong>The TFT updates slowly.</strong> The bus is the limit.</p>



<p class="wp-block-paragraph"><strong>The TFT looks washed out from the side.</strong> That is normal for a TN panel. An IPS panel holds color better off-axis, and an OLED holds it best of all.</p>



<p class="wp-block-paragraph"><strong>The OLED fades or ghosts after weeks of the same image.</strong> That is burn-in.</p>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices below were verified live on 2026-11-21 in the step 3 draft for the built-in display boards guide, via the WooCommerce Store API and authed product reads. This draft did NOT re-verify them live: the store returned HTTP 429 on every fetch in this session. Re-verify every price and stock state at publish time.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/0-96-inch-oled-display-module-ssd1306-i2c-128x64-for-arduino-esp32-esp8266/">0.96 Inch OLED Display Module, SSD1306, I2C, 128&#215;64, for Arduino / ESP32 / ESP8266</a> (ID 13571) &#8211; $7.49. 128 by 64 pixels, I2C, 4 pins, 3.3 V to 5 V.</li>
<li><a href="https://qualityrcparts.com/product/hiletgo-esp32-oled-wifi-bluetooth-development-board-0-96-inch-display-esp-wroom-32/">HiLetgo ESP32 OLED WiFi Bluetooth Development Board, 0.96 Inch Display, ESP-WROOM-32</a> (ID 17818) &#8211; $17.99 on sale (regular $21.99). Built-in 0.96 inch SSD1306 display on GPIO 4 and 5, 2 MB flash, micro-USB.</li>
<li><a href="https://qualityrcparts.com/product/esp32-development-board-with-1-9-inch-st7789-tft-lcd-display-16mb-wifi-bluetooth-usb-c/">ESP32 Development Board with 1.9 Inch ST7789 TFT LCD Display, 16MB, WiFi + Bluetooth, USB-C</a> (ID 17819) &#8211; $19.99 (regular $23.99). The TFT board: 1.9 inch ST7789 display at 170 by 320 full color, 16 MB flash, TFT_eSPI library.</li>
<li><a href="https://qualityrcparts.com/product/2-4-inch-tft-lcd-display-module-320x240-st7789-spi-color-screen-no-touch-for-arduino-esp32-esp8266/">2.4 Inch TFT Display Module, no touch</a> (ID 19630) &#8211; $14.99. The separate color TFT in this guide: 240 by 320 full color over SPI, display output only.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-built-in-display-boards-tft-oled-guide/">ESP32 Boards with Built-In Display: TFT vs OLED 2026</a></li>
<li><a href="/which-display-to-buy/">How to Choose the Right Display for Arduino or ESP32</a></li>
<li><a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a></li>
<li><a href="/esp32-supermini-guide/">How to Pick an ESP32 SuperMini Board for Tiny Builds</a></li>
<li><a href="/esp32-s3-cam-guide/">How to Use the ESP32-S3-CAM Board for Camera Projects</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>Is OLED better than TFT?</strong>
Neither is better in every case. OLED wins on contrast, viewing angle, and dark-screen power. TFT wins on brightness, sunlight readability, color at larger sizes, cost for color screens, and lifespan with static content. Source: Golden Vision TFT vs OLED comparison; OPL Display TFT LCD vs OLED guide.</p>



<p class="wp-block-paragraph"><strong>Does OLED use less power than TFT?</strong>
It depends on the image. OLED draws power per lit pixel, so a dark screen draws little and a bright screen draws much more. TFT draws near-constant power because the backlight stays on. Adafruit publishes about 20 mA average for its 128 by 64 OLED breakout. Source: Adafruit monochrome OLED breakouts guide; Golden Vision power comparison.</p>



<p class="wp-block-paragraph"><strong>Does OLED burn in?</strong>
Yes. OLED pixels age with use, and a static image left on the same pixels for weeks can leave a permanent ghost. TFT displays do not burn in. Source: Golden Vision burn-in section; OPL Display head-to-head table.</p>



<p class="wp-block-paragraph"><strong>Which display is best for a first ESP32 project?</strong>
A 0.96 inch SSD1306 OLED. It needs only four wires, shows sharp text, and draws very little power. Source: Medium, Compoden Electronics, Best Display for ESP32 Projects.</p>



<p class="wp-block-paragraph"><strong>Should I choose an OLED or a TFT for an ESP32?</strong>
Choose an OLED for text and simple readouts with minimal wiring. Choose a TFT when you need color, more pixels, graphics, or touch. Source: Medium, Compoden Electronics, Best Display for ESP32 Projects.</p>



<p class="wp-block-paragraph"><strong>What is the difference between the SSD1306 and the SH1106?</strong>
They are different OLED driver chips. The SSD1306 is usual on 0.96 inch modules and the SH1106 on 1.3 inch modules. Code for one shows shifted or noisy pixels on the other, so the library must match the chip. Source: Medium, Compoden Electronics, Best Display for ESP32 Projects.</p>



<p class="wp-block-paragraph"><strong>How many pins does a TFT display need on an ESP32?</strong>
An SPI TFT needs five signal pins: clock, data, chip select, data/command, and reset. A touch layer and a microSD slot each add a chip-select pin. Source: Medium, Compoden Electronics, Best Display for ESP32 Projects.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Solomon Systech SSD1306 datasheet, Rev 1.5 (128 by 64 dot matrix OLED/PLED driver with controller): <a href="https://chiptronicx.b-cdn.net/wp-content/uploads/2024/06/ssd1306-datasheet.pdf" target="_blank" rel="noopener">https://chiptronicx.b-cdn.net/wp-content/uploads/2024/06/ssd1306-datasheet.pdf</a></li>
<li>Adafruit, Monochrome OLED Breakouts guide (wiring, I2C/SPI, power): <a href="https://learn.adafruit.com/monochrome-oled-breakouts/wiring-128x64-oleds" target="_blank" rel="noopener">https://learn.adafruit.com/monochrome-oled-breakouts/wiring-128&#215;64-oleds</a></li>
<li>Golden Vision, Comparison of TFT Display Modules with OLED and LCD Screens: <a href="https://www.goldenvision.com/comparison-of-tft-display-modules-with-oled-and-lcd-screens" target="_blank" rel="noopener">https://www.goldenvision.com/comparison-of-tft-display-modules-with-oled-and-lcd-screens</a></li>
<li>OPL Display, TFT LCD vs OLED: A Comprehensive Guide for Global Sourcing Decisions: <a href="https://www.opldisplaytec.com/article/63900" target="_blank" rel="noopener">https://www.opldisplaytec.com/article/63900</a></li>
<li>Shining Ltd, TFT vs OLED Screen: 5 Critical Differences You Must Know: <a href="https://www.shiningltd.com/difference-between-tft-and-oled-screen/" target="_blank" rel="noopener">https://www.shiningltd.com/difference-between-tft-and-oled-screen/</a></li>
<li>Compoden Electronics, Best Display for ESP32 Projects: OLED vs TFT vs E-Paper (Medium): <a href="https://medium.com/@compodenin/best-display-for-esp32-projects-oled-vs-tft-vs-e-paper-d9ca2ccaf8ce" target="_blank" rel="noopener">https://medium.com/@compodenin/best-display-for-esp32-projects-oled-vs-tft-vs-e-paper-d9ca2ccaf8ce</a></li>
<li>Projectech, LCD vs OLED vs TFT vs E-Paper: Choose a Display: <a href="https://projectech.in/guides/how-to-choose-display-lcd-oled-tft-e-paper-guide/" target="_blank" rel="noopener">https://projectech.in/guides/how-to-choose-display-lcd-oled-tft-e-paper-guide/</a></li>
<li>Quality RC Parts, ESP32 Boards with Built-In Display: TFT vs OLED 2026 (post 18364): <a href="https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/">https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/</a></li>
<li>Quality RC Parts, How to Choose the Right Display for Arduino or ESP32: <a href="https://qualityrcparts.com/which-display-to-buy/">https://qualityrcparts.com/which-display-to-buy/</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>



<h2 class="wp-block-heading">Change log</h2>



<ul class="wp-block-list">

<li>2026-11-21: Draft created. Technology comparison of OLED vs TFT for Arduino and ESP32 projects: how each works, contrast, viewing angle, power, speed, lifespan, cost, decision table, common mistakes, troubleshooting, 7 FAQs. Board selection and board setup are not re-taught; they live in post 18364. The size and price picker is not re-taught; it lives in the which-display-to-buy guide. Product prices carried from the step 3 draft verified 2026-11-21; live re-verification blocked by store HTTP 429 in this session.</li>

</ul>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23533</post-id>	</item>
		<item>
		<title>TFT_eSPI Setup Guide: Arduino, ESP32, User_Setup.h</title>
		<link>https://qualityrcparts.com/tft-espi-setup-guide/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:59:40 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[spi]]></category>
		<category><![CDATA[tft-display]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/tft-espi-setup-guide/</guid>

					<description><![CDATA[TFT_eSPI is fast, but it will not draw anything until its setup file names your driver, your pins, and your screen size. This guide walks through the install, the wiring, the User_Setup.h edit, and the first test sketch, with the exact settings for the ST7735, ST7789, and ILI9341 displays sold in the store.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">TFT_eSPI is the library most ESP32 display projects use, and the one that confuses the most first-time users. It does not ask your sketch which display you wired up. It reads that answer from a setup file at compile time, and if the setup file is wrong, the screen stays white even though the sketch uploads fine.</p>



<p class="wp-block-paragraph">This guide sets up TFT_eSPI from Bodmer&#8217;s GitHub repo for a separate SPI TFT module wired to an ESP32 board: install, wiring, driver pick, the User_Setup.h edit, the first test sketch, and the errors that stop most builds. Every step was checked against the TFT_eSPI README and the User_Setup.h file in the repo.</p>



<h2 class="wp-block-heading">What is TFT_eSPI, and what do you need before you start?</h2>



<p class="wp-block-paragraph">TFT_eSPI is a feature-rich Arduino IDE graphics and fonts library for 32-bit processors, written by Bodmer. The README says it is targeted at 32-bit processors and performance optimised for RP2040, STM32, ESP8266, and ESP32 types, and that it works with Arduino boards as well but will be slower. On the ESP32 it can use Direct Memory Access (DMA) with SPI displays, and it has built-in support for the XPT2046 touch controller.</p>



<p class="wp-block-paragraph">The one fact that shapes this whole guide is in the README: the screen controller, the interface pins, and the library configuration settings must be defined inside the library, not in the Arduino sketch. PlatformIO users can define the same settings in platformio.ini instead, covered below.</p>



<p class="wp-block-paragraph">What you need:</p>



<ul class="wp-block-list">

<li>An ESP32 board. This guide uses the ESP32 DevKit V1 (30-pin WROOM-32), because its hardware SPI pins are the ones in the library&#8217;s own example setup files.</li>
<li>A separate SPI TFT module. The worked examples use the 0.96 inch ST7735 module and the 2.4 inch touch ILI9341 module from the store.</li>
<li>The Arduino IDE with the ESP32 board package installed. The README says the library requires board package 2.x.x or later.</li>
<li>Jumper wires and a breadboard. Keep the SPI wires short: long wires cause signal problems.</li>

</ul>



<h2 class="wp-block-heading">How do you install TFT_eSPI in the Arduino IDE?</h2>



<p class="wp-block-paragraph">Open the Library Manager: Sketch, Include Library, Manage Libraries. Search for &#8220;TFT_eSPI&#8221;, find the entry by Bodmer, and press Install.</p>



<p class="wp-block-paragraph">Two README warnings apply from the first install. First, a library update overwrites your setup: keep custom setup files in a TFT_eSPI_Setups folder in your Arduino libraries folder, pointed at from User_Setup_Select.h. Second, install the ESP32 board package first, at version 2.x or later, or the library may not compile for your board. PlatformIO users install it with one line in platformio.ini:</p>



<pre class="wp-block-code"><code>lib_deps = bodmer/TFT_eSPI
</code></pre>



<p class="wp-block-paragraph">Source: Lopaka TFT_eSPI guide.</p>



<h2 class="wp-block-heading">How do you wire a TFT module to an ESP32 DevKit V1?</h2>



<p class="wp-block-paragraph">The QRC TFT modules wire over SPI with 8 pins: GND, VCC, SCL, SDA, RES, DC, CS, and BLK. SCL is the SPI clock (SCLK), SDA is MOSI, RES is reset (RST), DC is data/command, CS is chip select, and BLK is the backlight. The pin numbers below are from the library&#8217;s own ESP32 example setup (Setup42_ILI9341_ESP32.h).</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Module pin</th>
<th>ESP32 DevKit V1 GPIO</th>
<th>Library name</th>
</tr>
</thead>
<tbody>
<tr>
<td>GND</td>
<td>GND</td>
<td>&#8211;</td>
</tr>
<tr>
<td>VCC</td>
<td>3V3</td>
<td>&#8211;</td>
</tr>
<tr>
<td>SCL</td>
<td>GPIO 18</td>
<td>TFT_SCLK</td>
</tr>
<tr>
<td>SDA</td>
<td>GPIO 23</td>
<td>TFT_MOSI</td>
</tr>
<tr>
<td>MISO / SDO</td>
<td>GPIO 19</td>
<td>TFT_MISO</td>
</tr>
<tr>
<td>RES</td>
<td>GPIO 4</td>
<td>TFT_RST</td>
</tr>
<tr>
<td>DC</td>
<td>GPIO 2</td>
<td>TFT_DC</td>
</tr>
<tr>
<td>CS</td>
<td>GPIO 15</td>
<td>TFT_CS</td>
</tr>
<tr>
<td>BLK</td>
<td>3V3, or a free GPIO for dimming</td>
<td>TFT_BL</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Three wiring rules. <strong>Power the module at 3.3V, not 5V.</strong> The QRC modules run on 3.3V power, and the ESP32 is a 3.3V board, so wire VCC to 3V3. A 5V Arduino Uno needs level shifting; see our logic level shifting guide. <strong>Use the hardware SPI pins for clock and data.</strong> MOSI 23, MISO 19, and SCLK 18 are the DevKit V1 VSPI pins. CS, DC, and RST can be any free GPIO. <strong>Connect MISO even if you think you do not need it.</strong> The screen draws without it, but the display ID read and the touch controller need it, and an SD card on the same bus needs all three SPI pins defined explicitly. <strong>Backlight:</strong> BLK can go straight to 3V3 for always-on backlight. Wire it to a GPIO and define TFT_BL only if the sketch must control it.</p>



<h2 class="wp-block-heading">Which driver do you pick for your display?</h2>



<p class="wp-block-paragraph">The driver is the chip on the display, not the size of the screen. Two modules the same size can need different drivers, and the wrong driver gives a white screen even with perfect wiring. Read the driver chip name from the store listing first.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Size</th>
<th>Resolution</th>
<th>Driver</th>
<th>Touch</th>
<th>Store price</th>
</tr>
</thead>
<tbody>
<tr>
<td>0.96 inch, 2-pack</td>
<td>80 by 160</td>
<td>ST7735</td>
<td>No</td>
<td>$13.99</td>
</tr>
<tr>
<td>1.3 inch</td>
<td>240 by 240</td>
<td>ST7789</td>
<td>No</td>
<td>$11.99</td>
</tr>
<tr>
<td>1.44 inch, 2-pack</td>
<td>128 by 128</td>
<td>ST7735</td>
<td>No</td>
<td>$20.99</td>
</tr>
<tr>
<td>1.8 inch, SD slot</td>
<td>128 by 160</td>
<td>ST7735</td>
<td>No</td>
<td>$10.99</td>
</tr>
<tr>
<td>2.0 inch</td>
<td>240 by 320</td>
<td>ST7789</td>
<td>No</td>
<td>$14.99</td>
</tr>
<tr>
<td>2.2 inch, SD slot</td>
<td>240 by 320</td>
<td>ILI9341</td>
<td>No</td>
<td>From $18.99</td>
</tr>
<tr>
<td>2.4 inch, no touch</td>
<td>320 by 240</td>
<td>ST7789</td>
<td>No</td>
<td>$14.99</td>
</tr>
<tr>
<td>2.4 inch, touch</td>
<td>240 by 320</td>
<td>ILI9341</td>
<td>Yes</td>
<td>$20.99</td>
</tr>
<tr>
<td>2.8 inch, touch</td>
<td>240 by 320</td>
<td>ILI9341</td>
<td>Yes</td>
<td>$24.99</td>
</tr>
<tr>
<td>3.2 inch, touch</td>
<td>240 by 320</td>
<td>ILI9341</td>
<td>Yes</td>
<td>$25.49</td>
</tr>
<tr>
<td>3.5 inch, touch</td>
<td>480 by 320</td>
<td>ILI9488</td>
<td>Yes</td>
<td>$26.99</td>
</tr>
<tr>
<td>4.0 inch, touch</td>
<td>480 by 320</td>
<td>ST7796S</td>
<td>Yes</td>
<td>$29.99</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sizes, resolutions, and drivers follow our TFT LCD displays guide, and prices were verified against the live store on 2026-11-21. The README lists ST7735, ST7789, ILI9341, ILI9488, and ST7796 as supported, and recommends ILI9341 and ST7796 SPI displays as the starting point. If the listing does not name a driver, do not guess: a 2.4 inch module can be ST7789 without touch or ILI9341 with touch.</p>



<h2 class="wp-block-heading">How do you set up User_Setup.h?</h2>



<p class="wp-block-paragraph">This is the step the whole guide exists for. User_Setup.h is the file inside the TFT_eSPI library folder that names your driver, your screen size, your pins, and your fonts. The library reads it at compile time. The default file ships set up for an ILI9341 display, so ST7735 or ST7789 owners must change it. Find the file in your Arduino libraries folder, under TFT_eSPI.</p>



<h3 class="wp-block-heading">1. Pick exactly one driver</h3>



<p class="wp-block-paragraph">In Section 1 of the file, uncomment the line for your driver and leave every other driver line commented out. Only one driver may be defined.</p>



<p class="wp-block-paragraph">For the 0.96 inch module:</p>



<pre class="wp-block-code"><code>#define ST7735_DRIVER      // Define additional parameters below for this display
</code></pre>



<p class="wp-block-paragraph">For a 1.3 inch, 2.0 inch, or 2.4 inch non-touch module:</p>



<pre class="wp-block-code"><code>#define ST7789_DRIVER      // Full configuration option, define additional parameters below for this display
</code></pre>



<p class="wp-block-paragraph">For a 2.2 inch, 2.4 inch touch, 2.8 inch, or 3.2 inch module:</p>



<pre class="wp-block-code"><code>#define ILI9341_DRIVER       // Generic driver for common displays
</code></pre>



<p class="wp-block-paragraph">The default file ships with ILI9341_DRIVER uncommented. If two driver lines are uncommented, the sketch will not compile, or the library will send the wrong init sequence and the screen stays white.</p>



<h3 class="wp-block-heading">2. Set the screen size</h3>



<p class="wp-block-paragraph">Set TFT_WIDTH and TFT_HEIGHT to your panel&#8217;s pixel size: 80 by 160 for the 0.96 inch ST7735 module, 240 by 320 for the 2.4 inch touch ILI9341 module, 240 by 240 for the 1.3 inch ST7789 module.</p>



<pre class="wp-block-code"><code>#define TFT_WIDTH  240
#define TFT_HEIGHT 320
</code></pre>



<p class="wp-block-paragraph">Getting the size wrong does not stop the screen from working, but the drawing will be shifted or cut off.</p>



<h3 class="wp-block-heading">3. Set the pins</h3>



<p class="wp-block-paragraph">Set the pin defines to match your wiring. The ESP32 example values in the file are MISO 19, MOSI 23, SCLK 18, CS 15, DC 2, and RST 4, which match the wiring table above.</p>



<pre class="wp-block-code"><code>#define TFT_MISO 19
#define TFT_MOSI 23
#define TFT_SCLK 18
#define TFT_CS   15  // Chip select control pin
#define TFT_DC    2  // Data Command control pin
#define TFT_RST   4  // Reset pin (could connect to RST pin)
</code></pre>



<p class="wp-block-paragraph">If your module&#8217;s reset pin is tied to the board reset or to 3.3V, set TFT_RST to -1.</p>



<h3 class="wp-block-heading">4. Check the fonts and the SPI speed</h3>



<p class="wp-block-paragraph">Leave the font lines as they are. You need LOAD_GLCD at minimum; without it, basic text drawing will not compile. The default SPI frequency is 27 MHz; the bundled Setup42 uses 40 MHz. If the display shows noise or tearing, drop the speed to 20 MHz or 10 MHz. Save the file, then recompile and upload: the library reads User_Setup.h at compile time, so every edit needs a fresh compile.</p>



<h2 class="wp-block-heading">What are the other ways to configure TFT_eSPI?</h2>



<p class="wp-block-paragraph">Editing User_Setup.h is the standard route, but it is not the only one. There are three, and you should pick one and stick to it. Mixing them is a common cause of &#8220;it worked yesterday&#8221; failures.</p>



<p class="wp-block-paragraph"><strong>Option 1: Edit User_Setup.h.</strong> The route above. Simple, and every example sketch then works without changes. The cost is that a library update overwrites the file, so keep a copy in the TFT_eSPI_Setups folder the README suggests, outside the library folder.</p>



<p class="wp-block-paragraph"><strong>Option 2: Use a bundled setup file.</strong> Open User_Setup_Select.h in the library folder. Comment out the <code>#include &lt;User_Setup.h&gt;</code> line and uncomment the include for a setup file that matches your board. The repo ships Setup42_ILI9341_ESP32.h for an ESP32 with an SPI ILI9341 display (MISO 19, MOSI 23, SCLK 18, CS 15, DC 2, RST 4, 40 MHz), Setup70b_ESP32_S3_ILI9341.h for the ESP32-S3, Setup70c_ESP32_C3_ILI9341.h for the ESP32-C3, and Setup71_ESP32_S2_ST7789.h for the ESP32-S2 with ST7789. Only one setup include may be active at a time.</p>



<p class="wp-block-paragraph"><strong>Option 3: Define the setup in the sketch or in PlatformIO.</strong> If you define USER_SETUP_LOADED before including the library, the library skips User_Setup.h and uses the defines in your sketch instead. The library header TFT_eSPI.h checks for USER_SETUP_LOADED and defines it itself if it is missing, so a sketch that defines it first takes control:</p>



<pre class="wp-block-code"><code>#define USER_SETUP_LOADED
#define ILI9341_DRIVER
#define TFT_WIDTH  240
#define TFT_HEIGHT 320
#define TFT_MOSI 23
#define TFT_MISO 19
#define TFT_SCLK 18
#define TFT_CS   15
#define TFT_DC    2
#define TFT_RST   4
#define SPI_FREQUENCY 40000000
#include &lt;TFT_eSPI.h&gt;
#include &lt;SPI.h&gt;
</code></pre>



<p class="wp-block-paragraph">Source: the USER_SETUP_LOADED check in TFT_eSPI.h and the ElectricalFlux ESP32 graphics guide. PlatformIO users can pass the same defines as build flags instead, which survives library updates. Source: Lopaka TFT_eSPI guide. The in-sketch route keeps the setup with the project, the right choice when two projects use two different displays on one computer.</p>



<h2 class="wp-block-heading">What is the first sketch to upload?</h2>



<p class="wp-block-paragraph">Run the library&#8217;s own test sketch before you write any of your own code. If the test sketch works, the wiring and the setup file are right, and any later problem is in your code.</p>



<p class="wp-block-paragraph">Open File, then Examples, then TFT_eSPI, then Test and diagnostics, then Colour_Test. Select your ESP32 board and port, and upload. A working screen shows clean colour bands with no noise or tearing.</p>



<p class="wp-block-paragraph">If Colour_Test runs but the colours look wrong, run the Read_User_Setup example from the same folder. It prints the setup the library actually compiled with to the serial monitor: driver, pins, and SPI frequency.</p>



<p class="wp-block-paragraph">Once Colour_Test passes, a minimal hello sketch confirms text drawing:</p>



<pre class="wp-block-code"><code>#include &lt;TFT_eSPI.h&gt;

TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  tft.setRotation(1);
  tft.fillScreen(TFT_BLACK);
  tft.setTextColor(TFT_WHITE, TFT_BLACK);
  tft.setTextSize(2);
  tft.drawString(&quot;Hello TFT&quot;, 10, 10);
}

void loop() {
}
</code></pre>



<p class="wp-block-paragraph"><code>tft.init()</code> starts the display with the settings from the setup file. If this sketch shows &#8220;Hello TFT&#8221;, the setup is done.</p>



<h2 class="wp-block-heading">How do you set up the built-in 1.9 inch TFT board?</h2>



<p class="wp-block-paragraph">Short answer: you do not use this guide for it. The built-in 1.9 inch ST7789 board (ID 17819) is covered in full in our ESP32 boards with built-in displays guide: ST7789 driver at 170 by 320, with CS 5, RST 4, BL 32, and MOSI 23. Follow that guide for that board.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Two drivers uncommented:</strong> only one driver define may be active. Two break the compile or send the wrong init sequence.</li>
<li><strong>Editing the setup and not recompiling:</strong> the library reads User_Setup.h at compile time.</li>
<li><strong>Pins in the file do not match the wiring:</strong> file and breadboard must agree on every pin.</li>
<li><strong>Default ILI9341 setup with an ST7735 or ST7789 module:</strong> the default file ships set for ILI9341.</li>
<li><strong>A library update wiping the setup:</strong> keep your setup in a TFT_eSPI_Setups folder outside the library, or use the in-sketch defines.</li>
<li><strong>5V logic on a 3.3V module:</strong> the QRC modules run on 3.3V power. A 5V Uno needs level shifting.</li>
<li><strong>Long jumper wires at full SPI speed:</strong> shorten the wires or drop SPI_FREQUENCY to 20 MHz or 10 MHz.</li>
<li><strong>MISO left unconnected:</strong> the screen draws without it, but the display ID read and touch need it.</li>

</ul>



<h2 class="wp-block-heading">How do you fix a TFT_eSPI display that does not work?</h2>



<p class="wp-block-paragraph">Check the config before you suspect broken hardware: a white screen usually means the driver or pins in User_Setup.h do not match the board.</p>



<p class="wp-block-paragraph"><strong>The screen stays white after upload.</strong> White means the backlight works and the controller never got a valid init sequence. Check the driver line first, then the pins, then the backlight pin, then a lower SPI speed. Sources: Protoship and RoboticsEngineering white screen guides.</p>



<p class="wp-block-paragraph"><strong>The screen stays black.</strong> Check the backlight first. A sketch that never turns it on shows nothing even when the code runs. If BLK is wired to a GPIO, the setup must define TFT_BL and the sketch must drive it.</p>



<p class="wp-block-paragraph"><strong>The colours are wrong or inverted.</strong> The colour order or the inversion setting does not match the panel. User_Setup.h has TFT_RGB_ORDER (TFT_RGB or TFT_BGR) and TFT_INVERSION_ON / TFT_INVERSION_OFF defines. Swap the colour order define and recompile.</p>



<p class="wp-block-paragraph"><strong>The picture is shifted, cut off, or noisy.</strong> The size is wrong, or the SPI speed is too high for the wiring. Check TFT_WIDTH and TFT_HEIGHT, then drop SPI_FREQUENCY to 20 MHz or 10 MHz.</p>



<p class="wp-block-paragraph"><strong>The sketch will not compile.</strong> Read the first error, not the last. Two driver defines active, a missing LOAD_GLCD font define, or a board package older than 2.x are the usual causes. An Arduino forum thread also reports TFT_eSPI sketches failing to compile for the ESP32-C6 board; update the board package and the library before changing the code.</p>



<p class="wp-block-paragraph"><strong>The touch panel does not respond.</strong> TFT_eSPI has built-in XPT2046 touch support on SPI displays, and the touch chip shares the display SPI bus with its own chip select. Define TOUCH_CS with the touch CS pin: the bundled Setup42 file shows TOUCH_CS 5, commented out by default. Run Test_Touch_Controller to check the touch wiring.</p>



<p class="wp-block-paragraph"><strong>The display works but the SD card on the same bus stops working.</strong> The README warns that an SD card on the same SPI bus needs TFT_MISO, TFT_MOSI, and TFT_SCLK defined explicitly in User_Setup.h, even with the default SPI pins. Define all three and recompile.</p>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified live on qualityrcparts.com on 2026-11-21 through the public Store API. All four items are in stock and purchasable.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/0-96-inch-tft-display-module-2-pack-color-ips-lcd-80x160-st7735-spi-for-arduino-esp32/">0.96 Inch TFT Display Module 2-Pack, Color IPS LCD 80&#215;160, ST7735 SPI for Arduino ESP32</a> (ID 19625) &#8211; $13.99. Two ST7735 modules for the worked setup in this guide.</li>
<li><a href="https://qualityrcparts.com/product/2-4-inch-spi-tft-lcd-touch-display-module-240x320-ili9341-driver/">2.4 Inch SPI TFT LCD Touch Display Module, 240&#215;320, ILI9341 driver</a> (ID 17813) &#8211; $20.99. The touch module for the ILI9341 worked example, with touch panel and pen.</li>
<li><a href="https://qualityrcparts.com/product/esp32-development-board-with-1-9-inch-st7789-tft-lcd-display-16mb-wifi-bluetooth-usb-c/">ESP32 Development Board with 1.9 Inch ST7789 TFT LCD Display, 16MB, WiFi + Bluetooth, USB-C</a> (ID 17819) &#8211; $19.99. The built-in display board. Its setup is in the display-boards guide, linked below, not in this guide.</li>
<li><a href="https://qualityrcparts.com/product/esp32-devkit-v1-development-board-30-pin-wroom-32-wifi-bluetooth-dual-core/">ESP32 DevKit V1 Development Board, 30-Pin WROOM-32, WiFi + Bluetooth, Dual-Core</a> (ID 19639) &#8211; $9.99. The example board for the wiring table. Its hardware SPI pins match the library&#8217;s own ESP32 example setup.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-built-in-display-boards-tft-oled-guide/">ESP32 Boards with Built-In Displays: TFT vs OLED Compared</a></li>
<li><a href="/tft-lcd-displays-arduino-esp32-projects/">TFT LCD Displays for Arduino and ESP32 Projects</a></li>
<li><a href="/best-displays-for-arduino-esp32-usa/">How to Choose Displays for Arduino and ESP32 Projects</a></li>
<li><a href="/i2c-oled-display-ssd1306-wiring-guide/">I2C OLED Display Guide: Wire the SSD1306 to Arduino or ESP32</a></li>
<li><a href="/i2c-vs-spi-vs-uart/">I2C vs SPI vs UART: Which Protocol for Your Sensor or Display</a></li>
<li><a href="/logic-level-shifting-5v-3v3-esp32-arduino/">Logic Level Shifting 5V to 3.3V: Safe Wiring for ESP32, Arduino, Sensors, and Displays</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>What is TFT_eSPI?</strong>
TFT_eSPI is a fast Arduino IDE graphics and fonts library for 32-bit processors by Bodmer, optimised for RP2040, STM32, ESP8266, and ESP32. It drives SPI TFT displays and supports the XPT2046 touch controller. Source: TFT_eSPI README on GitHub.</p>



<p class="wp-block-paragraph"><strong>Do I have to edit User_Setup.h to use TFT_eSPI?</strong>
Yes, in the standard route: the driver, size, pins, and fonts must be defined in the library&#8217;s setup file, because the README states they cannot be defined in the Arduino sketch. Alternatives: a bundled setup file, in-sketch defines with USER_SETUP_LOADED, or PlatformIO build flags. Source: TFT_eSPI README.</p>



<p class="wp-block-paragraph"><strong>Which driver do I pick in TFT_eSPI for my display?</strong>
Pick the driver that matches the chip on your display: ST7735 for the 0.96, 1.44, and 1.8 inch modules; ST7789 for the 1.3, 2.0, and 2.4 inch non-touch modules; ILI9341 for the 2.2, 2.4 touch, 2.8, and 3.2 inch modules; ILI9488 for the 3.5 inch touch; ST7796 for the 4.0 inch touch. Only one driver define may be active. Source: TFT_eSPI README and the QRC TFT displays guide.</p>



<p class="wp-block-paragraph"><strong>Why is my TFT screen white after uploading a TFT_eSPI sketch?</strong>
White means the backlight works but the controller never got a valid init sequence. Check the driver first, then the pins, then the backlight pin, then a lower SPI speed. Source: Protoship and RoboticsEngineering white screen guides.</p>



<p class="wp-block-paragraph"><strong>Can I use TFT_eSPI with an Arduino Uno?</strong>
The library targets 32-bit processors and works with Arduino boards but will be slower, per the README. The bigger issue is voltage: the QRC modules run on 3.3V, and a 5V Uno needs level shifting. An ESP32 is the simpler first choice.</p>



<p class="wp-block-paragraph"><strong>Why does my TFT_eSPI setup disappear after a library update?</strong>
A new copy of the library overwrites User_Setup.h inside the library folder. The README suggests a TFT_eSPI_Setups folder outside the library, or the in-sketch USER_SETUP_LOADED defines or PlatformIO build flags, which survive updates. Source: TFT_eSPI README tips section.</p>



<p class="wp-block-paragraph"><strong>How do I know which setup the library actually compiled with?</strong>
Run Read_User_Setup from File, Examples, TFT_eSPI, Test and diagnostics. It prints the compiled driver, pins, and SPI frequency to the serial monitor. Source: TFT_eSPI repo examples listing.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Bodmer TFT_eSPI GitHub repo README: <a href="https://github.com/Bodmer/TFT_eSPI" target="_blank" rel="noopener">https://github.com/Bodmer/TFT_eSPI</a></li>
<li>Bodmer TFT_eSPI User_Setup.h (master): <a href="https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setup.h" target="_blank" rel="noopener">https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setup.h</a></li>
<li>Bodmer TFT_eSPI User_Setup_Select.h (master): <a href="https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setup_Select.h" target="_blank" rel="noopener">https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setup_Select.h</a></li>
<li>Bodmer TFT_eSPI bundled ESP32 ILI9341 setup, Setup42_ILI9341_ESP32.h: <a href="https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setups/Setup42_ILI9341_ESP32.h" target="_blank" rel="noopener">https://github.com/Bodmer/TFT_eSPI/blob/master/User_Setups/Setup42_ILI9341_ESP32.h</a></li>
<li>Makerguides, How to configure TFT_eSPI Library for TFT display: <a href="https://www.makerguides.com/how-to-configure-tft_espi-library-for-tft-display/" target="_blank" rel="noopener">https://www.makerguides.com/how-to-configure-tft_espi-library-for-tft-display/</a></li>
<li>ElectricalFlux, Driving High-Resolution ESP32 Graphics with TFT_eSPI and ILI9341: <a href="https://electricalflux.com/mcu-projects/esp32-graphics-tft-espi-ili9341-setup" target="_blank" rel="noopener">https://electricalflux.com/mcu-projects/esp32-graphics-tft-espi-ili9341-setup</a></li>
<li>Lopaka, TFT_eSPI ESP32 Color Display Guide: <a href="https://lopaka.app/pages/docs/guides/tft-espi" target="_blank" rel="noopener">https://lopaka.app/pages/docs/guides/tft-espi</a></li>
<li>Protoship, ESP32 display not working: white screen, wrong colours, dead touch: <a href="https://protoship.dev/guides/esp32-display-not-working" target="_blank" rel="noopener">https://protoship.dev/guides/esp32-display-not-working</a></li>
<li>RoboticsEngineering, SPI TFT display shows a white screen: <a href="https://roboticsengineering.in/fix/tft-spi-display-white-screen-wrong-driver/" target="_blank" rel="noopener">https://roboticsengineering.in/fix/tft-spi-display-white-screen-wrong-driver/</a></li>
<li>Arduino Forum, Sketches using TFT_eSPI library cannot compile for ESP32-C6 board: <a href="https://forum.arduino.cc/t/sketches-using-tft-espi-library-cannot-compile-for-esp32-c6-board/1378348" target="_blank" rel="noopener">https://forum.arduino.cc/t/sketches-using-tft-espi-library-cannot-compile-for-esp32-c6-board/1378348</a></li>
<li>Quality RC Parts, ESP32 Boards with Built-In Displays: TFT vs OLED Compared: <a href="https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/">https://qualityrcparts.com/esp32-built-in-display-boards-tft-oled-guide/</a></li>
<li>Quality RC Parts, TFT LCD Displays for Arduino and ESP32 Projects: <a href="https://qualityrcparts.com/tft-lcd-displays-arduino-esp32-projects/">https://qualityrcparts.com/tft-lcd-displays-arduino-esp32-projects/</a></li>
<li>Quality RC Parts, How to Choose Displays for Arduino and ESP32 Projects: <a href="https://qualityrcparts.com/best-displays-for-arduino-esp32-usa/">https://qualityrcparts.com/best-displays-for-arduino-esp32-usa/</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>



<h2 class="wp-block-heading">Change log</h2>



<ul class="wp-block-list">

<li>2026-11-21: Draft created. Full TFT_eSPI setup procedure from the Bodmer GitHub repo: install, DevKit V1 wiring, driver-selection table for all 12 store TFT sizes, User_Setup.h walkthrough, two alternate configuration routes, Colour_Test first-sketch walkthrough, common mistakes, troubleshooting. Built-in 1.9 inch board covered only as a pointer to post 18364; size selection cross-linked to posts 17851 and 15484, not re-taught.</li>

</ul>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23532</post-id>	</item>
		<item>
		<title>ESP32 SuperMini vs XIAO: Which Tiny Board Wins?</title>
		<link>https://qualityrcparts.com/supermini-vs-xiao-esp32/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:59:01 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-c3]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[xiao]]></category>
		<category><![CDATA[xiao-esp32]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/supermini-vs-xiao-esp32/</guid>

					<description><![CDATA[Same chip, different board. The SuperMini is cheaper per board and breadboard friendly. The XIAO adds an external antenna, built-in LiPo charging, and a bigger memory option on the S3. This head-to-head compares size, pins, antenna, battery, and price for the C3 and S3.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Pick the XIAO for battery builds, WiFi range, or a board that solders flat onto a carrier PCB. Pick the SuperMini for the lowest price per board, a breadboard-friendly header, or an on-board LED for blink and debugging.</p>



<p class="wp-block-paragraph">The two families share the same chips, so the decision is about the board around the chip: the antenna, the battery circuit, the pins, the mounting, the documentation, and the price per board. Both run the same Arduino, MicroPython, and ESP-IDF code for the same chip once the pin names are changed: the XIAO uses D0 to D10 names and the SuperMini uses GPIO numbers.</p>



<h2 class="wp-block-heading">How big is each board, and how does it mount?</h2>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Board</th>
<th>Size</th>
<th>Mounting</th>
</tr>
</thead>
<tbody>
<tr>
<td>XIAO ESP32C3</td>
<td>21 x 17.8 mm (Seeed wiki)</td>
<td>Castellated, solders flat onto a carrier PCB</td>
</tr>
<tr>
<td>ESP32-C3 SuperMini</td>
<td>About 22.5 x 18 mm (seller listings only)</td>
<td>Through-hole header pins, fits a breadboard</td>
</tr>
<tr>
<td>XIAO ESP32S3</td>
<td>21 x 17.8 mm (Seeed wiki)</td>
<td>Castellated, solders flat onto a carrier PCB</td>
</tr>
<tr>
<td>ESP32-S3 SuperMini</td>
<td>About 23.5 x 18 mm (espboards)</td>
<td>Through-hole header pins, fits a breadboard</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">The XIAO is smaller by about a millimetre and a half in each direction, and its castellated edges let it solder flat onto a carrier board like a module. That suits a finished product, a wearable, or a sensor tag that has to sit flat inside a case.</p>



<p class="wp-block-paragraph">The SuperMini is the breadboard board. Its through-hole header pins plug straight into a breadboard with room to spare, which is why it is the easier pick for a first build, a classroom set, or a prototype you plan to rewire. The trade off is height.</p>



<p class="wp-block-paragraph">Measure your own SuperMini before you design a case around it. There is no single manufacturer, so pin labels, LED color, flash size, and antenna layout can vary between sellers and revisions.</p>



<h2 class="wp-block-heading">Which board has more pins?</h2>



<p class="wp-block-paragraph">The SuperMini breaks out more pins on both chips. The XIAO keeps the same 11-pin header on every board: a feature when a sketch moves between XIAO boards, a limit when the build needs more pins.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th></th>
<th>XIAO C3</th>
<th>SuperMini C3</th>
<th>XIAO S3</th>
<th>SuperMini S3</th>
</tr>
</thead>
<tbody>
<tr>
<td>Broken-out GPIO</td>
<td>11 (D0 to D10)</td>
<td>13 (GPIO0 to GPIO10, 20, 21)</td>
<td>11 (D0 to D10)</td>
<td>13 plus TX/RX</td>
</tr>
<tr>
<td>Analog header pins</td>
<td>4 (D0 to D3)</td>
<td>6 (GPIO0 to GPIO5)</td>
<td>9 (D0 to D5, D8 to D10)</td>
<td>13 (GPIO1 to GPIO13)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: Seeed wiki pin maps; NuttX docs; TeachMeMicro.</p>



<p class="wp-block-paragraph">Three pin differences matter. First, the XIAO bus pins never move: I2C is always D4 and D5, SPI is always D8, D9, and D10, and UART is always D6 and D7 on every XIAO board. The SuperMini has no such promise: the bus pins follow the chip, and the I2C pins on the C3 SuperMini sit on GPIO8 and GPIO9, which are also strapping pins, so the NuttX docs recommend GPIO0 and GPIO1 for I2C instead.</p>



<p class="wp-block-paragraph">Second, the SuperMini gives you more analog pins: 6 ADC-capable pins on the C3 against 4 on the XIAO C3, and 13 on the S3 against 9 on the XIAO S3. The store listing states 4 analog pins for the C3 SuperMini against 6 in the NuttX table; the gap is the ADC2 channel on GPIO5, which reads unreliably while WiFi is running. Use GPIO0 to GPIO4 for analog reads when WiFi is on.</p>



<p class="wp-block-paragraph">Third, strapping pins need care on both families, but on different pins. On the XIAO C3, D0, D8, and D9 decide the boot mode. On the C3 SuperMini, GPIO2, GPIO8, and GPIO9 do. On the XIAO S3, D2 (GPIO3) is the strapping pin on the header. On the S3 SuperMini, GPIO3 is the one to use with care. A sensor that pulls a strapping pin to the wrong level at reset can stop either board from booting. Full pin tables are in <a href="/esp32-supermini-guide/">our SuperMini guide</a> and <a href="/xiao-esp32-pinout-guide/">our XIAO pinout guide</a>.</p>



<h2 class="wp-block-heading">How do the C3 boards compare?</h2>



<p class="wp-block-paragraph">The C3 comparison is the cleanest one, because the chips are identical. The ESP32-C3 datasheet v2.5 is the source for the chip figures.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Feature</th>
<th>XIAO ESP32C3</th>
<th>ESP32-C3 SuperMini</th>
</tr>
</thead>
<tbody>
<tr>
<td>Chip</td>
<td>ESP32-C3, single-core RISC-V, up to 160 MHz</td>
<td>Same chip</td>
</tr>
<tr>
<td>SRAM / flash</td>
<td>400 KB SRAM, 4 MB flash</td>
<td>Same</td>
</tr>
<tr>
<td>Deep sleep, board level</td>
<td>44 uA per the Seeed wiki</td>
<td>No board-level figure published for the generic board</td>
</tr>
<tr>
<td>QRC price</td>
<td>$13.99 for one board</td>
<td>$22.99 for four boards ($5.75 per board)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: Espressif C3 datasheet v2.5; Seeed wiki C3 page; Mischianti; NuttX docs.</p>



<p class="wp-block-paragraph">The C3 decision comes down to two questions. Does the build run on a battery? The XIAO charges a LiPo over USB with no extra parts, and its 44 uA board-level deep sleep figure is published by Seeed. The SuperMini usually has no charging circuit, and no board-level figure is published for the generic board. The bare C3 chip can sleep near 5 uA, but a finished board draws more.</p>



<p class="wp-block-paragraph">Does the build need WiFi range? The XIAO needs its external antenna connected, and with it fitted Seeed states over 100 m line of sight. The SuperMini ceramic antenna needs nothing fitted and works well at short range, but range varies by batch. One user test on the Seeed forum measured the SuperMini at -33 dBm next to a phone against about -60 dBm for a XIAO with no antenna fitted: with its antenna fitted, the XIAO is the stronger board.</p>



<h2 class="wp-block-heading">How do the S3 boards compare?</h2>



<p class="wp-block-paragraph">The S3 comparison is where the memory gap shows up, and it is the biggest spec difference between the two families.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Feature</th>
<th>XIAO ESP32S3</th>
<th>ESP32-S3 SuperMini</th>
</tr>
</thead>
<tbody>
<tr>
<td>Chip</td>
<td>ESP32-S3R8, dual-core Xtensa LX7, up to 240 MHz</td>
<td>ESP32-S3, dual-core Xtensa LX7, up to 240 MHz</td>
</tr>
<tr>
<td>PSRAM / flash</td>
<td>8 MB PSRAM, 8 MB flash</td>
<td>4 MB flash, 2 MB PSRAM on the common FH4R2 version</td>
</tr>
<tr>
<td>Deep sleep, board level</td>
<td>14 uA per the Seeed wiki</td>
<td>About 43 uA per the store listing</td>
</tr>
<tr>
<td>User LED</td>
<td>User LED on GPIO21, plus charge LED</td>
<td>RGB LED, typically WS2812 on GPIO48</td>
</tr>
<tr>
<td>QRC price</td>
<td>$21.49 for one board</td>
<td>$31.99 for five boards ($6.40 per board)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: Seeed wiki S3 page; Espressif S3 datasheets; TeachMeMicro; Lingflux.</p>



<p class="wp-block-paragraph">The memory gap is the whole S3 story. The XIAO ESP32S3 carries the S3R8 chip with 8 MB of PSRAM and 8 MB of flash. The common S3 SuperMini carries the S3FH4R2 chip with 4 MB of flash and 2 MB of PSRAM: four times the PSRAM and twice the flash on the XIAO. PSRAM holds camera frames, display buffers, and audio at runtime, so the XIAO S3 is the board for camera work, displays, and edge AI. The SuperMini S3 still handles bigger sketches, more sensors, and small displays, but with less headroom.</p>



<p class="wp-block-paragraph">Check the chip marking on any S3 SuperMini before you trust a memory figure: FH4R2 means 4 MB of flash and 2 MB of PSRAM. Run the memory check sketch in <a href="/esp32-supermini-guide/">our SuperMini guide</a> to confirm flash size and PSRAM before you write code that needs them.</p>



<p class="wp-block-paragraph">The S3 boards are closer on the other rows: both have a user LED, USB OTG, and battery charging in some form. The XIAO S3 still wins on range, deep sleep, and documentation; the SuperMini S3 on price per board and breadboard use. The Sense version is the XIAO-only option, adding a detachable camera, a digital microphone, and a microSD slot on an expansion board. There is no SuperMini equivalent. Camera projects are covered in our XIAO S3 Sense guide.</p>



<h2 class="wp-block-heading">Which board is better on battery power?</h2>



<p class="wp-block-paragraph">The XIAO is the better battery board on both chips. Every XIAO has a built-in LiPo charging circuit with BAT pads on the back: plug a LiPo in and the board charges it over USB, with no extra module. The Seeed wiki publishes board-level deep sleep figures of 44 uA for the C3 and 14 uA for the S3, and the XIAO C3 has no user LED at all, so nothing drains the cell in deep sleep. The C3 SuperMini usually has no charging circuit, so a battery build needs an external charging module, and no board-level deep sleep figure is published for the generic board. The S3 SuperMini is better here: some S3 boards have battery pads with a charger, and the listing states deep sleep around 43 uA.</p>



<p class="wp-block-paragraph">One safety note: the XIAO C3 charging circuit delivers a fast charge near 370 mA, so use a battery of 370 mAh or larger unless the battery has its own protection circuit. Source: Mischianti XIAO ESP32-C3 guide.</p>



<h2 class="wp-block-heading">How much does each board cost?</h2>



<p class="wp-block-paragraph">Prices below are the live QRC store prices. The SuperMini boards sell as packs, so the per-board price is arithmetic from the pack price.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Board</th>
<th>QRC listing</th>
<th>Pack price</th>
<th>Price per board</th>
</tr>
</thead>
<tbody>
<tr>
<td>XIAO ESP32C3, 1-pack</td>
<td>ID 17820</td>
<td>$13.99</td>
<td>$13.99</td>
</tr>
<tr>
<td>ESP32-C3 SuperMini, 4-pack</td>
<td>ID 19646</td>
<td>$22.99</td>
<td>$5.75</td>
</tr>
<tr>
<td>XIAO ESP32S3, 1-pack</td>
<td>ID 17839</td>
<td>$21.49</td>
<td>$21.49</td>
</tr>
<tr>
<td>ESP32-S3 SuperMini, 5-pack</td>
<td>ID 19649</td>
<td>$31.99</td>
<td>$6.40</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">The SuperMini is far cheaper per board: about $5.75 against $13.99 on the C3, and about $6.40 against $21.49 on the S3. A four-pack of C3 SuperMinis costs less than two single XIAO C3 boards, and a five-pack of S3 SuperMinis costs about one and a half XIAO S3 boards.</p>



<p class="wp-block-paragraph">Prices were verified against the live SuperMini guide (updated 2026-11-21) and the batch 2 verification of the same day. The public Store API returned HTTP 429 at draft time, so re-verify every price live before publishing.</p>



<h2 class="wp-block-heading">Which one should you buy?</h2>



<p class="wp-block-paragraph">Pick by the build, not by the brand.</p>



<p class="wp-block-paragraph"><strong>Buy the XIAO ESP32C3 if</strong> the build is a battery sensor, a wearable, a BLE beacon, or a node that has to sit in another room and stay connected. The charging circuit, the external antenna, and the 44 uA deep sleep are the reasons.</p>



<p class="wp-block-paragraph"><strong>Buy the ESP32-C3 SuperMini if</strong> the build is a set of cheap sensor nodes, a classroom set, or a first ESP32 project, or anything where the lowest cost per board matters most. At $5.75 per board in the 4-pack, it is the cheapest way to put WiFi and Bluetooth on a tiny board, and the blue LED makes Blink work out of the box.</p>



<p class="wp-block-paragraph"><strong>Buy the XIAO ESP32S3 if</strong> the build needs memory: camera work, a display with a frame buffer, audio, edge AI, or a large sketch. The 8 MB of PSRAM and 8 MB of flash are the reasons. Buy the Sense version instead for a camera, a microphone, and a microSD slot.</p>



<p class="wp-block-paragraph"><strong>Buy the ESP32-S3 SuperMini if</strong> the build needs two cores, more pins, and some PSRAM, but does not need 8 MB of it: bigger sensor builds, small displays, and multi-node projects where $6.40 per board beats $21.49. Check the chip marking for FH4R2 before relying on the PSRAM figure.</p>



<p class="wp-block-paragraph">If you are still unsure, buy the C3 SuperMini 4-pack first. It is the cheapest way to learn the setup, and the steps transfer to the other boards.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Running a XIAO with no antenna.</strong> The XIAO has no built-in antenna. WiFi and Bluetooth will barely work until the included external antenna is fitted to the U.FL connector.</li>
<li><strong>Using a SuperMini pinout on a XIAO, or the reverse.</strong> D4 is GPIO6 on the XIAO C3 and GPIO4 on the C3 SuperMini. Use the pin table for your exact board.</li>
<li><strong>Expecting Blink to work on the XIAO C3.</strong> There is no user LED on the XIAO C3, only a charge LED. Wire an external LED before you run Blink.</li>
<li><strong>Assuming the S3 SuperMini has 8 MB of PSRAM.</strong> The common FH4R2 version has 2 MB of PSRAM and 4 MB of flash. Check the chip marking.</li>
<li><strong>Comparing a chip deep sleep figure against a board deep sleep figure.</strong> The bare C3 chip can sleep near 5 uA, but a finished board draws more through its regulator, LEDs, and USB circuitry. Seeed publishes board-level figures for the XIAO (44 uA C3, 14 uA S3). No equivalent figure is published for the generic SuperMini.</li>

</ul>



<h2 class="wp-block-heading">How do I troubleshoot a SuperMini vs XIAO problem?</h2>



<p class="wp-block-paragraph"><strong>The board does not appear as a USB port.</strong> Try a USB-C data cable, not a charge-only cable. Then hold BOOT, connect the cable, release BOOT, and upload Blink. Full steps are in <a href="/esp32-supermini-guide/">our SuperMini guide</a>.</p>



<p class="wp-block-paragraph"><strong>The Serial Monitor is blank but the sketch runs.</strong> Set USB CDC On Boot to Enabled under Tools and re-upload. Full steps are in <a href="/esp32-supermini-guide/">our SuperMini guide</a>.</p>



<p class="wp-block-paragraph"><strong>WiFi will not connect on a XIAO.</strong> Check the antenna first. If the external antenna is not fitted, fit it and test again. If it is fitted, check the connector is fully seated.</p>



<p class="wp-block-paragraph"><strong>WiFi will not connect on a SuperMini.</strong> Move the board closer to the router first. Some batches have weak WiFi that improves when the transmit power is lowered in code.</p>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified against the live SuperMini guide (updated 2026-11-21) and the batch 2 verification of the same day. The public Store API returned HTTP 429 at draft time. Re-verify every price and stock live before publishing.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/esp32-c3-supermini-development-board-4-pack-risc-v-160mhz-wifi-bluetooth-le/">ESP32-C3 SuperMini Development Board 4-Pack, RISC-V 160MHz, WiFi + Bluetooth LE</a> (ID 19646) &#8211; $22.99. Four boards at $5.75 each.</li>
<li><a href="https://qualityrcparts.com/product/esp32-s3-supermini-development-board-5-pack-type-c-dual-core-240mhz-wifi-bluetooth/">ESP32-S3 SuperMini Development Board 5-Pack, Type-C, Dual-Core 240MHz, WiFi + Bluetooth</a> (ID 19649) &#8211; $31.99. Five boards at $6.40 each. Two cores, more pins, 2 MB of PSRAM (FH4R2).</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32c3-development-board-1-pack/">Seeed Studio XIAO ESP32C3 Development Board, 1-Pack</a> (ID 17820) &#8211; $13.99. External antenna, built-in LiPo charging, 44 uA deep sleep.</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32s3-development-board-1-pack/">Seeed Studio XIAO ESP32S3 Development Board, 1-Pack</a> (ID 17839) &#8211; $21.49. 8 MB of PSRAM and 8 MB of flash for camera, display, and edge AI.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-supermini-guide/">How to Pick an ESP32 SuperMini Board for Tiny Builds</a></li>
<li><a href="/xiao-esp32-c3-c6-s3-c5/">XIAO ESP32C3 vs C6 vs S3 vs C5: Pick the Right Board</a></li>
<li><a href="/seeed-xiao-esp32s3-sense-boards-guide/">Seeed XIAO ESP32S3 Guide: Standard Board vs Sense Board</a></li>
<li><a href="/xiao-esp32-pinout-guide/">XIAO ESP32 Pinout: C3, C6, S3, and C5 GPIO Tables</a></li>
<li><a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>What is the difference between an ESP32 SuperMini and a XIAO ESP32?</strong>
Same chip, different board. The XIAO has an external U.FL antenna, a built-in LiPo charging circuit, and no user LED on the C3. The SuperMini has a ceramic antenna, usually no charging circuit, and a blue LED typically on GPIO8. Pick the XIAO for battery sensors and range, the SuperMini for the lowest cost and breadboard work. Source: Mischianti; <a href="/esp32-supermini-guide/">our SuperMini guide</a> FAQ.</p>



<p class="wp-block-paragraph"><strong>Can I use the same code on a SuperMini and a XIAO?</strong>
Yes, with the pin names changed. Both run the same Arduino, MicroPython, and ESP-IDF code for the same chip. The XIAO uses D0 to D10 names and the SuperMini uses GPIO numbers. Source: The Engineering Projects XIAO ESP32-C3 guide.</p>



<p class="wp-block-paragraph"><strong>Which board is better for battery projects?</strong>
The XIAO, on both chips. It charges a LiPo over USB with no extra parts, and Seeed publishes board-level deep sleep figures of 44 uA for the C3 and 14 uA for the S3. The C3 SuperMini usually has no charging circuit and no published deep sleep figure. Source: Seeed wiki C3 and S3 pages; Mischianti XIAO ESP32-C3 guide.</p>



<p class="wp-block-paragraph"><strong>Does the XIAO need an external antenna?</strong>
Yes. The XIAO has a U.FL connector only and no built-in antenna. The antenna ships in the box and must be fitted before WiFi or Bluetooth will work properly. Source: Seeed wiki S3 page; Seeed forum BLE signal thread.</p>



<p class="wp-block-paragraph"><strong>Which S3 board should I buy, the SuperMini or the XIAO S3?</strong>
Buy the XIAO S3 if the build needs memory: camera work, displays, audio, or large sketches. It has 8 MB of PSRAM and 8 MB of flash against 2 MB of PSRAM and 4 MB of flash on the common S3 SuperMini FH4R2 version. Buy the S3 SuperMini for two cores, more pins, and some PSRAM at $6.40 per board in the 5-pack. Check the chip marking for FH4R2 before trusting the memory figure. Source: Seeed wiki S3 page; TeachMeMicro; Lingflux.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Seeed wiki, Getting Started with Seeed Studio XIAO ESP32C3: <a href="https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/</a></li>
<li>Seeed wiki, Getting Started with Seeed Studio XIAO ESP32-S3 Series: <a href="https://wiki.seeedstudio.com/xiao_esp32s3_getting_started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/xiao_esp32s3_getting_started/</a></li>
<li>Espressif ESP32-C3 datasheet v2.5 (linked from the Seeed C3 wiki): <a href="https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf" target="_blank" rel="noopener">https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf</a></li>
<li>Espressif ESP32-S3 datasheet (linked from the Seeed S3 wiki): <a href="https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf" target="_blank" rel="noopener">https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf</a></li>
<li>Mischianti, Seeed Studio XIAO ESP32-C3: high-resolution pinout, datasheet, schema, and specs: <a href="https://mischianti.org/seeed-studio-xiao-esp32-c3-high-resolution-pinout-datasheet-schema-and-specs/" target="_blank" rel="noopener">https://mischianti.org/seeed-studio-xiao-esp32-c3-high-resolution-pinout-datasheet-schema-and-specs/</a></li>
<li>TeachMeMicro, ESP32-S3 Mini Getting Started Guide: Super Mini Pinout, Arduino IDE Setup, PSRAM and RGB LED: <a href="https://teachmemicro.com/esp32-s3-super-mini-getting-started/" target="_blank" rel="noopener">https://teachmemicro.com/esp32-s3-super-mini-getting-started/</a></li>
<li>espboards, ESP32 Super Mini Comparison: C3 vs S3 vs C6 vs H2: <a href="https://www.espboards.dev/blog/esp32-super-mini-comparison/" target="_blank" rel="noopener">https://www.espboards.dev/blog/esp32-super-mini-comparison/</a></li>
<li>Lingflux, Before You Buy: ESP32-S3 Suffixes, Flash, PSRAM and Ballpark Prices: <a href="https://lingflux.com/en/articles/hardware/esp32-s3-flash-psram-storage-guide/" target="_blank" rel="noopener">https://lingflux.com/en/articles/hardware/esp32-s3-flash-psram-storage-guide/</a></li>
<li>ESP32Tutorials, Best ESP32-C3 Development Boards: 12 SuperMini, XIAO, DevKitM-1, OLED and Display Boards Compared: <a href="https://esp32tutorials.com/best-esp32-c3-development-boards-12-supermini-xiao-devkitm-1-oled-and-display-boards-compared-buying-guide/" target="_blank" rel="noopener">https://esp32tutorials.com/best-esp32-c3-development-boards-12-supermini-xiao-devkitm-1-oled-and-display-boards-compared-buying-guide/</a></li>
<li>esp32.co.uk, ESP32-C3 Boards Compared: DevKitC, XIAO, SuperMini and LOLIN: <a href="https://esp32.co.uk/esp32-c3-versions-compared-best-dev-boards-2026/" target="_blank" rel="noopener">https://esp32.co.uk/esp32-c3-versions-compared-best-dev-boards-2026/</a></li>
<li>The Engineering Projects, XIAO ESP32-C3 Library for Proteus: <a href="https://www.theengineeringprojects.com/2026/10/xiao-esp32-c3-library-for-proteus.html" target="_blank" rel="noopener">https://www.theengineeringprojects.com/2026/10/xiao-esp32-c3-library-for-proteus.html</a></li>
<li>Seeed Studio Forum, BLE signal strength xiao esp32-c3 vs super mini: <a href="https://forum.seeedstudio.com/t/ble-signal-strength-xiao-esp32-c3-vs-super-mini/292456" target="_blank" rel="noopener">https://forum.seeedstudio.com/t/ble-signal-strength-xiao-esp32-c3-vs-super-mini/292456</a></li>
<li>NuttX docs, Tenstar Robot ESP32-C3 SuperMini (cited via <a href="/esp32-supermini-guide/">our SuperMini guide</a>): <a href="https://nuttx.apache.org/docs/latest/platforms/risc-v/esp32c3/boards/esp32c3-supermini/index.html" target="_blank" rel="noopener">https://nuttx.apache.org/docs/latest/platforms/risc-v/esp32c3/boards/esp32c3-supermini/index.html</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>



<h2 class="wp-block-heading">Change log</h2>



<ul class="wp-block-list">

<li>2026-11-21: Draft created. Direct SuperMini vs XIAO comparison across the C3 and the S3: size, pins, antenna, battery, memory, and price per board. Overlap checked against live posts 15176 (SuperMini guide, one C3-only comparison section) and 18592 (XIAO four-board comparison, no SuperMini coverage). Batch 2 XIAO pinout draft not live yet at draft time, so no link to it is included. Product prices carried from the live SuperMini guide (updated 2026-11-21) and batch 2 verification of the same day; the public Store API returned HTTP 429 at draft time, so prices and stock must be re-verified live before publishing, and the slug 404 must be re-checked at publish time for the same reason.</li>
<li>2026-11-21: Trimmed from 3,492 to 2,797 publishable words (H1 through FAQ, plain wc -w; 2,969 H1 through Last updated, Sources included). Cut one FAQ, shortened table cells and Sources lines, and trimmed prose across size, pins, C3, S3, battery, price, buy, mistakes, troubleshooting, and parts sections. No facts, prices, or safety notes changed.</li>

</ul>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23531</post-id>	</item>
		<item>
		<title>XIAO ESP32 Pinout: C3, C6, S3, and C5 GPIO Tables</title>
		<link>https://qualityrcparts.com/xiao-esp32-pinout-guide/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:41:31 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-c3]]></category>
		<category><![CDATA[esp32-c6]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[pinout]]></category>
		<category><![CDATA[xiao]]></category>
		<category><![CDATA[xiao-esp32]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/xiao-esp32-pinout-guide/</guid>

					<description><![CDATA[Every XIAO ESP32 board breaks out the same 11 D pins, but the GPIO numbers behind them change with the chip. This guide gives the pin table for the C3, C6, and C5, points to the full S3 pinout, and shows which pins are shared and which are free.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Every XIAO ESP32 board breaks out the same 11 GPIO pins, D0 through D10, on the same 14-pin header with 5V, GND, and 3V3. What changes is the GPIO number behind each D pin, how many pins can read analog voltages, and which pins the chip watches at boot.</p>



<p class="wp-block-paragraph">This guide gives the pin table for the C3, the C6, and the C5 from the Seeed wiki pin map for each board, and points to our full S3 pinout guide for the S3. It also covers shared pins, free pins, and strapping pins. Verify every table against the Seeed wiki page for your board variant before you solder. Pin tables conflict across sources.</p>



<h2 class="wp-block-heading">Which pins do all four XIAO ESP32 boards share?</h2>



<p class="wp-block-paragraph">The header layout is the same on all four boards. The bus positions never move: I2C is always D4 and D5, SPI is always D8, D9, and D10, and UART is always D6 and D7. What moves is the GPIO number and the analog count.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Function</th>
<th>C3</th>
<th>C6</th>
<th>S3</th>
<th>C5</th>
</tr>
</thead>
<tbody>
<tr>
<td>I2C SDA / SCL</td>
<td>D4 / D5</td>
<td>D4 / D5</td>
<td>D4 / D5</td>
<td>D4 / D5</td>
</tr>
<tr>
<td>SPI SCK / MISO / MOSI</td>
<td>D8 / D9 / D10</td>
<td>D8 / D9 / D10</td>
<td>D8 / D9 / D10</td>
<td>D8 / D9 / D10</td>
</tr>
<tr>
<td>UART TX / RX</td>
<td>D6 / D7</td>
<td>D6 / D7</td>
<td>D6 / D7</td>
<td>D6 / D7</td>
</tr>
<tr>
<td>Analog pins on the header</td>
<td>4 (D0 to D3)</td>
<td>3 (D0 to D2)</td>
<td>9 (D0 to D5, D8 to D10)</td>
<td>1 (D0)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: Seeed wiki pin maps; our S3 pinout post for the S3 row. The C3 has a charge LED only, per the Seeed C3 wiki pin map.</p>



<h2 class="wp-block-heading">How do I read a XIAO pinout diagram?</h2>



<p class="wp-block-paragraph">Three names describe the same physical pin, and mixing them up is the most common wiring mistake on these boards.</p>



<ul class="wp-block-list">

<li><strong>D name:</strong> the printed pad name, D0 through D10. Use it in Arduino code, for example <code>digitalWrite(D4, HIGH)</code>.</li>
<li><strong>GPIO number:</strong> the chip pin number, for example GPIO2 or GPIO22. Use it in ESP-IDF code and in datasheets.</li>
<li><strong>A name:</strong> the analog name, A0 through A3 on the C3, A0 through A2 on the C6, A0 on the C5. Use it with <code>analogRead(A0)</code>.</li>

</ul>



<p class="wp-block-paragraph">The Seeed wiki diagram for each board shows the front and the back: the D pins and USB-C port on the front, the battery pads and JTAG test pads (MTDO, MTDI, MTCK, MTMS) on the back. Keep the Seeed wiki page for your board open while you wire. Some third party pages number the same D pads differently, and a table built for the wrong board will compile cleanly and do nothing.</p>



<h2 class="wp-block-heading">What is the XIAO ESP32C3 pinout?</h2>



<p class="wp-block-paragraph">The C3 is the cheapest board of the four, with one catch: three of its header pins are strapping pins, so what you connect to them at reset matters. The table below follows the Seeed wiki C3 pin map.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Pad</th>
<th>GPIO</th>
<th>Main function</th>
<th>Shared with</th>
</tr>
</thead>
<tbody>
<tr>
<td>D0</td>
<td>GPIO2</td>
<td>Analog A0, ADC1_CH2</td>
<td>Strapping</td>
</tr>
<tr>
<td>D1</td>
<td>GPIO3</td>
<td>Analog A1, ADC1_CH3</td>
<td>Wake</td>
</tr>
<tr>
<td>D2</td>
<td>GPIO4</td>
<td>Analog A2, ADC1_CH4</td>
<td>JTAG MTMS, wake</td>
</tr>
<tr>
<td>D3</td>
<td>GPIO5</td>
<td>Analog A3, ADC2_CH0</td>
<td>JTAG MTDI, wake</td>
</tr>
<tr>
<td>D4</td>
<td>GPIO6</td>
<td>I2C SDA</td>
<td>JTAG MTCK</td>
</tr>
<tr>
<td>D5</td>
<td>GPIO7</td>
<td>I2C SCL</td>
<td>JTAG MTDO</td>
</tr>
<tr>
<td>D6</td>
<td>GPIO21</td>
<td>UART TX</td>
<td>Console</td>
</tr>
<tr>
<td>D7</td>
<td>GPIO20</td>
<td>UART RX</td>
<td>Console</td>
</tr>
<tr>
<td>D8</td>
<td>GPIO8</td>
<td>SPI SCK</td>
<td>Strapping</td>
</tr>
<tr>
<td>D9</td>
<td>GPIO9</td>
<td>SPI MISO</td>
<td>Strapping, BOOT</td>
</tr>
<tr>
<td>D10</td>
<td>GPIO10</td>
<td>SPI MOSI</td>
<td>Flash CS</td>
</tr>
<tr>
<td>5V / GND / 3V3</td>
<td>&#8211;</td>
<td>Power</td>
<td>5 V, GND, 3.3 V out (700 mA max per Seeed wiki)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Source: Seeed wiki C3 pin map.</p>



<p class="wp-block-paragraph">D3 is the only ADC2 channel on the header, and ADC2 readings can be unreliable while WiFi is running, so use D0 to D2 (ADC1) for analog sensors when WiFi is on. Source: studiopieters C3 pinout guide. Only D0 to D3 can wake the chip from deep sleep. The C3 has no onboard antenna.</p>



<h2 class="wp-block-heading">What is the XIAO ESP32C6 pinout?</h2>



<p class="wp-block-paragraph">The C6 is the Matter, Thread, and Zigbee board, and the friendliest to wire: none of its header pins is a strapping pin. The table below follows the Seeed wiki C6 pin map.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Pad</th>
<th>GPIO</th>
<th>Main function</th>
<th>Shared with</th>
</tr>
</thead>
<tbody>
<tr>
<td>D0</td>
<td>GPIO0</td>
<td>Analog A0, ADC</td>
<td>LP GPIO, wake</td>
</tr>
<tr>
<td>D1</td>
<td>GPIO1</td>
<td>Analog A1, ADC</td>
<td>LP GPIO, wake</td>
</tr>
<tr>
<td>D2</td>
<td>GPIO2</td>
<td>Analog A2, ADC</td>
<td>LP GPIO, wake</td>
</tr>
<tr>
<td>D3</td>
<td>GPIO21</td>
<td>GPIO</td>
<td>SDIO DATA1</td>
</tr>
<tr>
<td>D4</td>
<td>GPIO22</td>
<td>I2C SDA</td>
<td>SDIO DATA2</td>
</tr>
<tr>
<td>D5</td>
<td>GPIO23</td>
<td>I2C SCL</td>
<td>SDIO DATA3</td>
</tr>
<tr>
<td>D6</td>
<td>GPIO16</td>
<td>UART TX</td>
<td>Console</td>
</tr>
<tr>
<td>D7</td>
<td>GPIO17</td>
<td>UART RX</td>
<td>Console</td>
</tr>
<tr>
<td>D8</td>
<td>GPIO19</td>
<td>SPI SCK</td>
<td>SDIO clock</td>
</tr>
<tr>
<td>D9</td>
<td>GPIO20</td>
<td>SPI MISO</td>
<td>SDIO DATA0</td>
</tr>
<tr>
<td>D10</td>
<td>GPIO18</td>
<td>SPI MOSI</td>
<td>SDIO command</td>
</tr>
<tr>
<td>5V / GND / 3V3</td>
<td>&#8211;</td>
<td>Power</td>
<td>5 V, GND, 3.3 V out</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Source: Seeed wiki C6 pin map. The chip has 7 ADC channels, but only D0, D1, and D2 are broken out as analog header pins.</p>



<p class="wp-block-paragraph">The board carries both a small onboard ceramic antenna and a U.FL connector, and the choice is made in firmware through an RF switch. Pull GPIO3 low to enable the switch, then GPIO14 low selects the built-in antenna (the default) and GPIO14 high selects the external antenna. Neither GPIO is a header pin. Source: Seeed wiki C6 RF switch section. Only the low-power GPIOs, GPIO0 to GPIO7, can wake the chip from deep sleep, and the XIAO breaks out three of them.</p>



<h2 class="wp-block-heading">What is the XIAO ESP32-C5 pinout?</h2>



<p class="wp-block-paragraph">The C5 is the newest board and the only one with dual-band WiFi, 2.4 GHz and 5 GHz. Its GPIO numbers jump around, but the bus positions are the same as the other boards. The table below follows the Seeed wiki C5 pin map.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Pad</th>
<th>GPIO</th>
<th>Main function</th>
<th>Shared with</th>
</tr>
</thead>
<tbody>
<tr>
<td>D0</td>
<td>GPIO1</td>
<td>Analog A0, ADC</td>
<td>LP GPIO, wake</td>
</tr>
<tr>
<td>D1</td>
<td>GPIO0</td>
<td>GPIO</td>
<td>LP GPIO</td>
</tr>
<tr>
<td>D2</td>
<td>GPIO25</td>
<td>GPIO</td>
<td>Strapping</td>
</tr>
<tr>
<td>D3</td>
<td>GPIO7</td>
<td>GPIO</td>
<td>SDIO DATA1, strapping</td>
</tr>
<tr>
<td>D4</td>
<td>GPIO23</td>
<td>I2C SDA</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D5</td>
<td>GPIO24</td>
<td>I2C SCL</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D6</td>
<td>GPIO11</td>
<td>UART TX</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D7</td>
<td>GPIO12</td>
<td>UART RX</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D8</td>
<td>GPIO8</td>
<td>SPI SCK</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D9</td>
<td>GPIO9</td>
<td>SPI MISO</td>
<td>&#8211;</td>
</tr>
<tr>
<td>D10</td>
<td>GPIO10</td>
<td>SPI MOSI</td>
<td>&#8211;</td>
</tr>
<tr>
<td>5V / GND / 3V3</td>
<td>&#8211;</td>
<td>Power</td>
<td>5 V, GND, 3.3 V out</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Source: Seeed wiki C5 pin map. The chip has 5 ADC channels, but only D0 is broken out as an analog header pin.</p>



<p class="wp-block-paragraph">The battery voltage reading is built in: GPIO6 reads the battery and GPIO26 enables the measurement circuit, so you can read the cell voltage in code with no divider to solder. Source: Seeed wiki C5 battery section. The user LED is GPIO27.</p>



<h2 class="wp-block-heading">What is the XIAO ESP32S3 pinout?</h2>



<p class="wp-block-paragraph">The S3 pinout is covered in full in our dedicated guide, <a href="/xiao-esp32s3-pinout/">Seeed XIAO ESP32S3 Pinout: GPIO, Camera, and Power</a>, so this section is a summary only. The S3 breaks out the same 11 D pins: D0 to D5 are GPIO1 to GPIO6, D6 and D7 are GPIO43 and GPIO44 for UART, and D8 to D10 are GPIO7, GPIO8, and GPIO9 for SPI. I2C is D4 and D5, and 9 of the 11 pins can read analog voltages. The boot button is GPIO0. The Sense version adds a detachable camera and a microSD slot on an expansion board on the back, and the microSD chip select is GPIO21.</p>



<h2 class="wp-block-heading">Which pins are shared with other hardware?</h2>



<p class="wp-block-paragraph">A pin that looks free on the header may already have a job. Check this table before you assign pins.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Shared hardware</th>
<th>Board</th>
<th>Pins involved</th>
<th>What it means for your wiring</th>
</tr>
</thead>
<tbody>
<tr>
<td>Antenna RF switch</td>
<td>C6</td>
<td>GPIO3 (power), GPIO14 (select)</td>
<td>Internal, not header pins. GPIO3 low, then GPIO14 low for onboard or high for external. Source: Seeed wiki C6.</td>
</tr>
<tr>
<td>Antenna</td>
<td>C3</td>
<td>U.FL connector only</td>
<td>No onboard antenna. Attach the external antenna or WiFi range will be poor.</td>
</tr>
<tr>
<td>Battery voltage read</td>
<td>C5</td>
<td>GPIO6 (read), GPIO26 (enable)</td>
<td>Built-in divider. Drive GPIO26 high to read the battery on GPIO6. Source: Seeed wiki C5.</td>
</tr>
<tr>
<td>Camera, mic, microSD</td>
<td>S3 Sense only</td>
<td>Board-to-board connector, SD CS GPIO21</td>
<td>On the expansion board, not the D header. See the S3 pinout guide.</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Which pins are free for your project on each board?</h2>



<p class="wp-block-paragraph">Free means no boot-time duty, no bus duty, and no shared hardware.</p>



<p class="wp-block-paragraph">The bus pins are the same on all four boards (D4/D5 I2C, D6/D7 UART, D8 to D10 SPI) and are free whenever that bus is unused.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Board</th>
<th>Free pins, no conditions</th>
<th>Pins that need care</th>
</tr>
</thead>
<tbody>
<tr>
<td>C3</td>
<td>D1 (GPIO3), D10 (GPIO10)</td>
<td>D0, D8, D9 (strapping); D2, D3, D4, D5 (JTAG)</td>
</tr>
<tr>
<td>C6</td>
<td>D0, D1, D2, D3, D4, D5, D8, D9, D10</td>
<td>D6, D7 (UART console)</td>
</tr>
<tr>
<td>C5</td>
<td>D0, D1, D4, D5, D6, D7, D8, D9, D10</td>
<td>D2, D3 (strapping)</td>
</tr>
<tr>
<td>S3</td>
<td>D0, D1, D3, D4, D5, D8, D9</td>
<td>D2 (strapping), D6, D7, D10 (see the S3 pinout guide)</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: Seeed wiki pin maps; the S3 row follows our S3 pinout post.</p>



<h2 class="wp-block-heading">Which pins are strapping and boot pins on each board?</h2>



<p class="wp-block-paragraph">Strapping pins are read by the chip at reset to pick the boot mode. A sensor that pulls one to the wrong level at reset can stop the board from booting or accepting an upload.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Board</th>
<th>Strapping pins on the header</th>
<th>Boot button GPIO</th>
</tr>
</thead>
<tbody>
<tr>
<td>C3</td>
<td>D0 (GPIO2), D8 (GPIO8), D9 (GPIO9)</td>
<td>GPIO9</td>
</tr>
<tr>
<td>C6</td>
<td>None on the header</td>
<td>GPIO9</td>
</tr>
<tr>
<td>C5</td>
<td>D2 (GPIO25), D3 (GPIO7)</td>
<td>GPIO28</td>
</tr>
<tr>
<td>S3</td>
<td>D2 (GPIO3), plus GPIO0 on the BOOT button</td>
<td>GPIO0</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">The C3 pins come from the Seeed wiki C3 strapping section. The Seeed wiki has no strapping section for the C6 or the C5: the C6 list (GPIO4, GPIO5, GPIO8, GPIO9, GPIO15, all internal) comes from the SolderHub C6 guide, and the C5 pins come from the ESP32-C5 datasheet via the espboards C5 page, both secondary sources. Full S3 detail is in the S3 pinout guide.</p>



<p class="wp-block-paragraph">If a board stops appearing as a USB port or refuses uploads after you wire something new, check the strapping pins first. Disconnect the new wiring, confirm the board uploads again, then rewire with the strapping pin left alone at boot.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Using a pin table from the wrong board.</strong> D4 is GPIO6 on the C3, GPIO22 on the C6, GPIO5 on the S3, and GPIO23 on the C5. The D name is the same and the GPIO number is not.</li>
<li><strong>Wiring a sensor to a strapping pin on the C3.</strong> D0, D8, and D9 decide the boot mode. A sensor that pulls one low at reset can leave the board unresponsive.</li>
<li><strong>Expecting analog reads on every D pin.</strong> Only D0 to D3 read analog on the C3, only D0 to D2 on the C6, and only D0 on the C5. The S3 is the analog-rich board with 9 analog header pins.</li>
<li><strong>Running the C3 with no antenna.</strong> The C3 has no onboard antenna. WiFi will barely work without the external antenna on the U.FL connector.</li>

</ul>



<h2 class="wp-block-heading">How do I troubleshoot a XIAO pinout problem?</h2>



<p class="wp-block-paragraph"><strong>The board does not appear as a USB port.</strong> Try a different USB-C cable, one that carries data, not a charge-only cable. Then try bootloader mode: on the C6, hold BOOT, connect the cable, release BOOT, and upload Blink. Source: Seeed wiki C6 bootloader section.</p>



<p class="wp-block-paragraph"><strong>Uploads fail after new wiring.</strong> Disconnect the new wiring and try again. If the upload works, a strapping pin is held at the wrong level. On the C3 check D0, D8, and D9 first. On the C5 check D2 and D3. On the S3 check D2.</p>



<p class="wp-block-paragraph"><strong>analogRead returns 4095 or 0 all the time.</strong> Check that the pin is an analog pin on your board. On the C5 only D0 reads analog on the header. On the C6 only D0 to D2 do. On the C3 only D0 to D3 do. Also check that the sensor output stays inside 0 to 3.3 V.</p>



<h2 class="wp-block-heading">Which pins can I use for my project?</h2>



<p class="wp-block-paragraph">Pick the board first, then the pins. If you have not picked a board, see <a href="/xiao-esp32-c3-c6-s3-c5/">XIAO ESP32C3 vs C6 vs S3 vs C5: Pick the Right Board</a>.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Project</th>
<th>Board</th>
<th>Pins to use</th>
</tr>
</thead>
<tbody>
<tr>
<td>I2C sensor or OLED</td>
<td>Any</td>
<td>D4 SDA, D5 SCL</td>
</tr>
<tr>
<td>SPI display or SD card</td>
<td>Any</td>
<td>D8 SCK, D9 MISO, D10 MOSI, plus a free pin for chip select (on the C3, use D1, not D0)</td>
</tr>
<tr>
<td>Analog sensor</td>
<td>S3 first, C3 second</td>
<td>S3: D0 to D5, D8 to D10; C3: D0 to D2</td>
</tr>
<tr>
<td>Battery-powered sensor node</td>
<td>C6 or C5</td>
<td>C6: D0 to D2 for wake and analog; C5: D0 for wake</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified live on qualityrcparts.com on 2026-11-21 through the public Store API. All four items are in stock and purchasable.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32c3-development-board-1-pack/">Seeed Studio XIAO ESP32C3 Development Board, 1-Pack</a> (ID 17820) &#8211; $13.99. Cheapest board here, for WiFi sensor nodes and battery builds.</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32c6-development-board-1-pack/">Seeed Studio XIAO ESP32C6 Development Board, 1-Pack</a> (ID 17835) &#8211; $15.99. The Matter, Thread, and Zigbee board, with the most carefree pins of the four. WiFi 6.</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32-c5-development-board-1-pack/">Seeed Studio XIAO ESP32-C5 Development Board, 1-Pack</a> (ID 18380) &#8211; $17.99. The only board here with dual-band WiFi, 2.4 GHz and 5 GHz, plus a built-in battery voltage read on GPIO6.</li>
<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32s3-development-board-1-pack/">Seeed Studio XIAO ESP32S3 Development Board, 1-Pack</a> (ID 17839) &#8211; $21.49. The most capable board here, with 8 MB PSRAM and 8 MB flash and 9 analog header pins.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/xiao-esp32s3-pinout/">Seeed XIAO ESP32S3 Pinout: GPIO, Camera, and Power</a></li>
<li><a href="/xiao-esp32-c3-c6-s3-c5/">XIAO ESP32C3 vs C6 vs S3 vs C5: Pick the Right Board</a></li>
<li><a href="/seeed-xiao-esp32s3-sense-boards-guide/">Seeed XIAO ESP32S3 Guide: Standard Board vs Sense Board</a></li>
<li><a href="/power-esp32-arduino-projects-lipo/">How to Power ESP32 and Arduino Projects on LiPo Power</a></li>
<li><a href="/esp32-supermini-guide/">How to Pick an ESP32 SuperMini Board for Tiny Builds</a></li>
<li><a href="/esp32-s3-cam-guide/">How to Use the ESP32-S3-CAM Board for Camera Projects</a></li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>How many GPIO pins does a XIAO ESP32 board have?</strong>
11, named D0 through D10, on all four boards. The header also carries 5V, GND, and 3V3. Source: Seeed wiki pin maps.</p>



<p class="wp-block-paragraph"><strong>Which pins are I2C on the XIAO ESP32 boards?</strong>
D4 is SDA and D5 is SCL on all four boards. Source: Seeed wiki pin maps.</p>



<p class="wp-block-paragraph"><strong>Which pins are SPI on the XIAO ESP32 boards?</strong>
D8 is SCK, D9 is MISO, and D10 is MOSI on all four boards. Source: Seeed wiki pin maps.</p>



<p class="wp-block-paragraph"><strong>Can I use 5 volt sensors with a XIAO ESP32 board?</strong>
No. All four boards run 3.3 V logic, and a voltage above 3.3 V on a GPIO pin can damage the chip. Use a level shifter. Source: Seeed wiki power sections.</p>



<p class="wp-block-paragraph"><strong>Which XIAO pins are strapping pins?</strong>
On the C3, D0 (GPIO2), D8 (GPIO8), and D9 (GPIO9). On the C5, D2 (GPIO25) and D3 (GPIO7). On the S3, D2 (GPIO3). On the C6, none of the header pins is a strapping pin.</p>



<p class="wp-block-paragraph"><strong>Why does my XIAO ESP32C3 not boot after I wire a sensor?</strong>
The usual cause is a strapping pin held at the wrong level at reset. D0, D8, and D9 decide the boot mode on the C3. Disconnect the new wiring, confirm the board boots, then move the sensor to D1 or D10.</p>



<p class="wp-block-paragraph"><strong>Does the XIAO ESP32-C5 have an analog pin?</strong>
Yes, one on the header: D0 (GPIO1). The chip has 5 ADC channels in total, but the others are not broken out on the header. Source: Seeed wiki C5 pin map.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Seeed wiki, Getting Started with Seeed Studio XIAO ESP32C3: <a href="https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/</a></li>
<li>Seeed wiki, Getting Started with Seeed Studio XIAO ESP32C6: <a href="https://wiki.seeedstudio.com/xiao_esp32c6_getting_started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/xiao_esp32c6_getting_started/</a></li>
<li>Seeed wiki, Getting Started with Seeed Studio XIAO ESP32-C5: <a href="https://wiki.seeedstudio.com/xiao_esp32c5_getting_started/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/xiao_esp32c5_getting_started/</a></li>
<li>Seeed wiki, Pin Multiplexing with Seeed Studio XIAO ESP32-S3 (Sense): <a href="https://wiki.seeedstudio.com/xiao_esp32s3_pin_multiplexing/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/xiao_esp32s3_pin_multiplexing/</a></li>
<li>Espressif ESP32-C3 datasheet (linked from the Seeed C3 wiki): <a href="https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf" target="_blank" rel="noopener">https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf</a></li>
<li>Espressif ESP32-C6 datasheet (linked from the Seeed C6 wiki): <a href="https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf" target="_blank" rel="noopener">https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf</a></li>
<li>Espressif ESP32-C5 datasheet (linked from the Seeed C5 wiki): <a href="https://www.espressif.com/sites/default/files/documentation/esp32-c5_datasheet_en.pdf" target="_blank" rel="noopener">https://www.espressif.com/sites/default/files/documentation/esp32-c5_datasheet_en.pdf</a></li>
<li>ESPboards XIAO ESP32C5 pinout (secondary, for C5 strapping pins): <a href="https://www.espboards.dev/esp32/xiao-esp32c5/" target="_blank" rel="noopener">https://www.espboards.dev/esp32/xiao-esp32c5/</a></li>
<li>SolderHub XIAO ESP32C6 pinout guide (secondary, for C6 strapping pins): <a href="https://solderhub.com/articles/xiao-esp32c6-pinout-guide" target="_blank" rel="noopener">https://solderhub.com/articles/xiao-esp32c6-pinout-guide</a></li>
<li>Studiopieters XIAO ESP32C3 pinout (secondary, for ADC2 note): <a href="https://www.studiopieters.nl/xiao-esp32c3-pinout/" target="_blank" rel="noopener">https://www.studiopieters.nl/xiao-esp32c3-pinout/</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>



<h2 class="wp-block-heading">Change log</h2>



<ul class="wp-block-list">

<li>2026-11-21: Draft created. Full C3, C6, and C5 pin tables from the Seeed wiki pin maps; S3 covered as a summary with a link to the dedicated S3 pinout post. Shared-pin, free-pin, and strapping tables added. No live post gives full C3, C6, or C5 pin tables, verified against posts 23363, 22718, and 18592.</li>

</ul>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23525</post-id>	</item>
		<item>
		<title>ESP32-S3 Face Detection Guide: XIAO Sense and S3-CAM</title>
		<link>https://qualityrcparts.com/esp32-s3-face-detection-guide/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:40:47 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp-idf]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-cam]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[project-build]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/esp32-s3-face-detection-guide/</guid>

					<description><![CDATA[The ESP32-S3 can find faces in a camera frame without sending video to the cloud. This guide shows which boards work, the no-code and Arduino routes, and the real limits on resolution, speed, and recognition.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">The ESP32-S3 can look at a camera frame and tell you where the faces are, on the chip itself, with no cloud account and no video leaving the board.</p>



<p class="wp-block-paragraph">This guide covers what the ESP32-S3 can and cannot do with faces, detection vs recognition, which boards work, the no-code and Arduino routes, and the mistakes that waste the most time. Nothing here needs a paid app or a cloud account for the on-device routes.</p>



<h2 class="wp-block-heading">What is face detection on the ESP32-S3, and what can it actually do?</h2>



<p class="wp-block-paragraph">Face detection on the ESP32-S3 means a small neural network model runs on the chip, looks at each camera frame, and returns a box around every face it finds, plus a confidence score for each box. Your code gets the boxes: light an LED, count people, trigger a relay, send an MQTT message, or save a snapshot.</p>



<p class="wp-block-paragraph">It works on the ESP32-S3 and not well on the classic ESP32 because of the hardware. The ESP32-S3 has vector instructions that speed up neural network math, and camera boards built on it carry 8 MB of PSRAM, which holds the frame and the model weights. Source: Espressif edge AI workshop and ESP-WHO docs.</p>



<p class="wp-block-paragraph">Detection runs on small frames. The models are trained on small inputs, so the camera captures at a low resolution for inference even when the sensor can shoot much higher. Espressif&#8217;s workshop lists QVGA (320 by 240) as the typical frame size for face detection and HVGA (480 by 320) for face recognition. Source: Espressif edge AI workshop, Assignment 4.</p>



<h2 class="wp-block-heading">What is the difference between face detection and face recognition?</h2>



<p class="wp-block-paragraph">Detection and recognition are two different jobs, and mixing them up is the most common source of disappointment with these boards.</p>



<p class="wp-block-paragraph">Face detection answers &#8220;is there a face in this frame, and where&#8221;. It returns boxes and confidence scores and knows nothing about who the person is. A doorbell that lights up when someone approaches and a people counter at a doorway need detection only.</p>



<p class="wp-block-paragraph">Face recognition answers &#8220;whose face is this&#8221;. It runs detection first, then turns each detected face into a numerical embedding and compares it against faces you enrolled earlier. You show the board each person&#8217;s face and give it a name, and the board stores the result. A door lock that opens for family members needs recognition.</p>



<p class="wp-block-paragraph">Recognition is harder, slower, and more fragile than detection. It needs the face to be larger in the frame, better lit, and facing the camera more directly. It also stores face data on the board: tell everyone in the household what the camera stores, and do not use recognition to identify people who have not agreed to be enrolled. This guide gives no accuracy percentage for recognition, because no primary source we checked publishes one.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Task</th>
<th>Question it answers</th>
<th>Needs enrollment</th>
<th>Typical use</th>
</tr>
</thead>
<tbody>
<tr>
<td>Face detection</td>
<td>Is there a face, and where</td>
<td>No</td>
<td>Doorbell alert, people counting, intruder alert</td>
</tr>
<tr>
<td>Face recognition</td>
<td>Whose face is this</td>
<td>Yes, one enrollment per person</td>
<td>Door lock for family, attendance</td>
</tr>
<tr>
<td>Person detection</td>
<td>Is there a person in frame</td>
<td>No</td>
<td>Room occupancy, trail camera trigger</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Which ESP32-S3 boards work for face detection?</h2>



<p class="wp-block-paragraph">Any ESP32-S3 camera board with PSRAM can run a face detection model. The classic ESP32-CAM is the exception: on-device face detection models were removed from the Arduino ESP32 core version 3, so the classic board is a poor choice for new on-device face projects. It can still capture a picture and send it to a cloud API for detection. Source: Robojax tutorial.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Board</th>
<th>Chip</th>
<th>Camera</th>
<th>PSRAM</th>
<th>Face detection</th>
</tr>
</thead>
<tbody>
<tr>
<td>XIAO ESP32S3 Sense</td>
<td>ESP32-S3</td>
<td>detachable camera</td>
<td>8 MB</td>
<td>Yes, on device</td>
</tr>
<tr>
<td>ESP32-S3-N16R8 CAM</td>
<td>ESP32-S3</td>
<td>OV5640, 5 MP</td>
<td>8 MB</td>
<td>Yes, on device</td>
</tr>
<tr>
<td>Classic ESP32-CAM</td>
<td>ESP32</td>
<td>OV2640</td>
<td>4 MB</td>
<td>Not recommended on device</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">The XIAO ESP32S3 Sense is the smallest option: an ESP32-S3 dual-core 240 MHz board with 8 MB PSRAM and 8 MB flash, a detachable camera, a digital microphone, a microSD slot, WiFi and Bluetooth 5.0, in a 21 by 17.5 mm footprint. The detachable camera matters: mount the tiny camera where the faces are and keep the board tucked away.</p>



<p class="wp-block-paragraph">The ESP32-S3-N16R8 CAM is the larger, cheaper bench board: a dual-core ESP32-S3 with 16 MB flash plus 8 MB PSRAM and an OV5640 5 MP camera, with two USB-C ports that split OTG and serial duties, so it programs over USB with no adapter. The higher resolution sensor does not make detection better, because detection runs on small frames.</p>



<h2 class="wp-block-heading">Which approach should you pick?</h2>



<p class="wp-block-paragraph">There are four working routes. Pick one row and follow its section.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Approach</th>
<th>Code needed</th>
<th>Toolchain</th>
<th>Best for</th>
</tr>
</thead>
<tbody>
<tr>
<td>SenseCraft AI (Seeed)</td>
<td>None, deploy in a browser</td>
<td>Web platform, USB cable</td>
<td>Fastest first detection</td>
</tr>
<tr>
<td>Arduino IDE with esp-dl models</td>
<td>Arduino sketch</td>
<td>Arduino IDE, ESP32 core 2.0.17</td>
<td>Full control, offline recognition</td>
</tr>
<tr>
<td>ESP-WHO with ESP-IDF</td>
<td>C, ESP-IDF project</td>
<td>ESP-IDF v5.5.x</td>
<td>Espressif reference examples</td>
</tr>
<tr>
<td>Cloud API detection</td>
<td>Arduino sketch plus an API key</td>
<td>Arduino IDE, internet</td>
<td>Classic ESP32-CAM</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">How do I run face detection with SenseCraft AI, with no code?</h2>



<p class="wp-block-paragraph">SenseCraft AI is Seeed&#8217;s edge AI platform. It deploys a prebuilt model to a supported board from a browser, with no machine learning code and no toolchain install. This is the fastest route to a working face detector.</p>



<ol class="wp-block-list">

<li>Plug the XIAO ESP32S3 Sense into your computer with a USB-C data cable. A charge-only cable will power the board but the browser will never see it.</li>
<li>Open the SenseCraft AI model page at <a href="https://sensecraft.seeed.cc/ai/model." target="_blank" rel="noopener">https://sensecraft.seeed.cc/ai/model.</a> Under Pretrained Models, set Task to Detection and Supported Devices to XIAO ESP32S3 Sense, then search &#8220;Face&#8221;.</li>
<li>Pick the Swift-YOLO face detection model. As of July 2025 there were two face models listed, and the Makerguides tutorial reports only the Swift-YOLO one worked.</li>
<li>Click Deploy Model, then Connect Device, pick the COM port the board is on, and confirm. The model downloads to the board in about 1 to 2 minutes. Source: Seeed SenseCraft AI wiki.</li>
<li>The preview starts on its own, with bounding boxes drawn around detected faces in the live feed, each box carrying a confidence score.</li>

</ol>



<p class="wp-block-paragraph">Two settings control what counts as a detection. The confidence threshold filters detections by how sure the model is that something is a face: every detection scores 0 to 100 percent, and anything below the threshold is discarded. A lower threshold catches more faces but also flags more non-faces. The IoU (Intersection over Union) threshold decides which overlapping boxes to keep when the model draws several boxes around one face. Source: Makerguides tutorial.</p>



<p class="wp-block-paragraph">SenseCraft models also offer outputs from the sidebar: a GPIO pin that goes high when a face is detected, serial output over UART, I2C or SPI with the face count and confidence, or MQTT over WiFi for a home automation system. GPIO is enough for a door opener or an alarm; MQTT is for Home Assistant. Source: Makerguides tutorial and Seeed wiki.</p>



<h2 class="wp-block-heading">How do I run face detection with Arduino IDE?</h2>



<p class="wp-block-paragraph">Use the Arduino route when you want the detection inside your own sketch, for example a camera that also drives a relay or serves a web page. The Robojax XIAO face recognition tutorial is the clearest Arduino reference we found, and its settings are strict: get one wrong and the sketch will not compile or will not detect anything.</p>



<ol class="wp-block-list">

<li>Install Arduino IDE and add the ESP32 board package. In Boards Manager, install ESP32 core version 2.0.17. This version matters most: Espressif removed the on-device face detection models in core 3, so the project cannot compile there. Version 2.0.17 is the last 2.x release with both those models and the XIAO_ESP32S3 board definition. Source: Robojax tutorial.</li>
<li>Select the board as XIAO_ESP32S3, not ESP32S3 Dev Module. The board definition carries the right camera pins and PSRAM settings.</li>
<li>Set PSRAM to OPI PSRAM. It is off by default, and nothing works without it. Set Flash Size to 8 MB, Partition Scheme to Default with SPIFFS, USB CDC On Boot to Enabled, and Upload Speed to 921600, dropping to 460800 if uploads fail. Source: Robojax tutorial.</li>
<li>Use the face detection models from the ESP32 core: HumanFaceDetectMSR01 as stage one to find candidate faces, and HumanFaceDetectMNP01 as stage two to refine the boxes and add five facial keypoints. The pipeline captures at 240 by 240 in RGB565, runs both stages, draws the boxes into the frame, then compresses to JPEG for streaming. Source: Robojax tutorial.</li>
<li>Get the camera stream working before adding detection. Flash a plain camera sketch first and confirm the video shows in a browser. If the stream fails, the fault is in the camera setup, not the model. Our <a href="/esp32-s3-cam-guide/">ESP32-S3-CAM setup guide</a> covers the first-stream steps.</li>

</ol>



<h2 class="wp-block-heading">How do I add face recognition, so the board knows who it is?</h2>



<p class="wp-block-paragraph">Recognition adds two steps after detection: enroll faces, then match new faces against them.</p>



<p class="wp-block-paragraph">Enrollment means showing the board each person&#8217;s face and storing the result. In the Robojax offline recognition project, enrollment happens from the board&#8217;s own web page: you type a name into a roster slot, point the camera at the person, and save. The board makes its own WiFi network for this, so no router and no internet are involved, and no face ever leaves the board. The stored data is a numerical embedding, not a photo, but it still identifies a person.</p>



<p class="wp-block-paragraph">Matching means each new detected face is turned into an embedding and compared against every stored embedding. The EloquentEsp32cam docs describe the pipeline: align the face, generate a 512-dimensional embedding, compare it against stored embeddings, and return the best match if the similarity passes a threshold. Recognition typically takes 80 to 150 ms on ESP32-S3 hardware, for the recognition step alone. Source: EloquentEsp32cam DeepWiki docs.</p>



<p class="wp-block-paragraph">The ESP-WHO framework is the Espressif reference route for recognition, with a state machine for ENROLL, RECOGNIZE, and DELETE operations. It targets ESP-IDF v5.5.x and the ESP32-S3 and ESP32-P4 chips. Source: Espressif ESP-WHO get started guide.</p>



<p class="wp-block-paragraph">Do not use recognition as a security lock on its own. A small on-device model can be fooled by a printed photo, and no primary source we checked publishes a spoof resistance claim for these models. Keep a separate lock, code, or key for anything that must stay secure.</p>



<h2 class="wp-block-heading">What are the accuracy and speed limits?</h2>



<p class="wp-block-paragraph">No source we checked publishes one tested accuracy number or one tested frame rate for ESP32-S3 face detection, so this guide gives neither as a universal claim. The limits below are what named sources state on their own setups.</p>



<ul class="wp-block-list">

<li><strong>Resolution for inference is small.</strong> Face detection runs at QVGA (320 by 240) and face recognition at HVGA (480 by 320) in Espressif&#8217;s workshop, and the Arduino recognition pipeline captures at 240 by 240. A face that is small in the frame will not be detected, whatever the sensor&#8217;s maximum resolution is. Source: Espressif edge AI workshop, Robojax tutorial.</li>
<li><strong>Recognition is slower than detection.</strong> The EloquentEsp32cam docs state recognition typically takes 80 to 150 ms on ESP32-S3 hardware, for the recognition step alone, or roughly 7 to 12 recognitions per second before capture and streaming are counted. Source: EloquentEsp32cam DeepWiki docs.</li>
<li><strong>Frame rate depends on resolution and settings.</strong> The Tokay Lite vendor page, for an ESP32-S3 camera board with 8 MB PSRAM, states its face detection model runs at 1 to 10 frames per second depending on resolution and settings. That is a vendor claim for their board, not a measured number for the XIAO Sense or the S3-N16R8 CAM. Source: Maxlab Tokay Lite page.</li>
<li><strong>Lighting and angle matter more than the sensor.</strong> Faces that face the camera, are well lit, and fill a reasonable part of the frame detect reliably. Backlit faces, faces in profile, and faces at a steep angle do not. Test where the camera will live before mounting it permanently.</li>

</ul>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Using Arduino ESP32 core 3 for an on-device face sketch.</strong> The face detection models were removed in core 3. Use 2.0.17. If a sketch fails to compile with a missing face detect header, check the core version first.</li>
<li><strong>Leaving PSRAM off.</strong> OPI PSRAM is off by default on the XIAO board definition, and the face pipeline will not run without it. Set it before the first upload.</li>
<li><strong>Picking the wrong board definition.</strong> XIAO_ESP32S3, not ESP32S3 Dev Module. The wrong definition gives the wrong camera pins.</li>
<li><strong>Running detection at full sensor resolution.</strong> The models are trained on small inputs. Capture small for detection.</li>
<li><strong>Trusting recognition as the only lock.</strong> No spoof resistance claim exists for these small models. Keep a separate lock or code.</li>

</ul>



<h2 class="wp-block-heading">How do I troubleshoot face detection that does not work?</h2>



<p class="wp-block-paragraph">Work through this list in order.</p>



<p class="wp-block-paragraph"><strong>The camera never shows a picture.</strong> Flash a plain camera sketch first. If that fails, the fault is wiring, pins, or power, not the model. Check the USB cable is a data cable and reseat the camera ribbon cable. Our <a href="/esp32-cam-getting-started/">ESP32-CAM getting started guide</a> covers first-stream failures. </p>



<p class="wp-block-paragraph"><strong>The sketch will not compile, missing human face detect headers.</strong> Check the ESP32 core version in Boards Manager. It must be 2.0.17 for the on-device face models. Source: Robojax tutorial.</p>



<p class="wp-block-paragraph"><strong>The board boots but detection never fires.</strong> Check PSRAM is set to OPI PSRAM in the Arduino IDE tools menu, and that the frame size is 240 by 240 or QVGA. Then lower the confidence threshold and test with a face close to the camera, well lit, facing the lens.</p>



<p class="wp-block-paragraph"><strong>Faces are detected but with many false positives.</strong> Raise the confidence threshold until non-faces stop triggering, then check real faces still trigger.</p>



<h2 class="wp-block-heading">Which board should you buy?</h2>



<ul class="wp-block-list">

<li><strong>Buy the XIAO ESP32S3 Sense if</strong> you want the smallest camera that runs face detection or the no-code SenseCraft AI route.</li>
<li><strong>Buy the ESP32-S3-N16R8 CAM if</strong> you want the cheapest bench board, you prefer dual USB-C with no adapter, or you want the extra flash headroom.</li>
<li><strong>Keep the classic ESP32-CAM if</strong> you only need to stream video or send a picture to a cloud API for detection.</li>
<li><strong>Buy neither yet if</strong> you need to identify strangers, read faces at long range, or run a security system. No small on-device model does those jobs well. Our <a href="/arducam-cameras-raspberry-pi-arduino-guide/">Arducam camera guide</a> covers the Pi side.</li>

</ul>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified live on qualityrcparts.com on 2026-11-21. All three items are in stock and purchasable.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/seeed-studio-xiao-esp32s3-sense-development-board-1-pack/">Seeed Studio XIAO ESP32S3 Sense Development Board, 1-Pack</a> (ID 17842) &#8211; $32.49. ESP32-S3 dual-core 240 MHz, 8 MB PSRAM and 8 MB flash, detachable camera, digital microphone, microSD slot. The pick for SenseCraft AI and small enclosures.</li>
<li><a href="https://qualityrcparts.com/product/esp32-s3-n16r8-cam-development-board-with-ov5640-camera-dual-usb-c-wifi-bluetooth-5/">ESP32-S3-N16R8 CAM Development Board with OV5640 Camera, Dual USB-C, WiFi + Bluetooth 5</a> (ID 19636) &#8211; $22.99. 16 MB flash plus 8 MB PSRAM, OV5640 5 MP camera, two USB-C ports, no adapter needed.</li>
<li><a href="https://qualityrcparts.com/product/esp32-cam-development-board-with-ov2640-camera-module-4mb-psram/">ESP32-CAM Development Board with OV2640 Camera Module, 4MB PSRAM</a> (ID 13473) &#8211; $25.99. The classic ESP32-CAM, for the cloud API route and plain streaming only; not recommended for new on-device face detection work.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-cam-s3-cam-camera-projects-guide/">ESP32-CAM vs ESP32-S3-CAM: Which Camera Board to Pick</a> &#8211; compare the two camera boards.</li>
<li><a href="/esp32-s3-cam-guide/">How to Use the ESP32-S3-CAM Board for Camera Projects</a> &#8211; the S3 board setup guide.</li>
<li><a href="/seeed-xiao-esp32s3-sense-boards-guide/">Seeed XIAO ESP32S3 Guide: Standard Board vs Sense Board</a> &#8211; XIAO board differences and camera setup.</li>
<li><a href="/esp32-cam-getting-started/">How to Start with ESP32-CAM for WiFi Camera Projects</a> &#8211; first-time setup for the classic ESP32-CAM. </li>
<li><a href="/esp32-cam-rtsp-streaming/">ESP32-CAM RTSP Streaming: Setup Guide for VLC and NVR</a> &#8211; feed a camera into VLC, Frigate, or an NVR.</li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>Can the ESP32-S3 do face detection?</strong>
Yes. The ESP32-S3 runs small on-device face detection models with no cloud. Detection runs on small frames, typically QVGA (320 by 240) or 240 by 240. Source: Espressif ESP-WHO docs and edge AI workshop.</p>



<p class="wp-block-paragraph"><strong>What is the difference between face detection and face recognition on ESP32-S3?</strong>
Detection finds faces and returns boxes. Recognition identifies whose face it is by comparing it against faces you enrolled earlier. Detection needs no enrollment; recognition needs one per person, stores face embeddings on the board, and is slower and more sensitive to lighting and angle. Source: Espressif ESP-WHO docs, EloquentEsp32cam docs.</p>



<p class="wp-block-paragraph"><strong>Which ESP32 board is best for face detection?</strong>
The XIAO ESP32S3 Sense is the best small board, and the ESP32-S3-N16R8 CAM is the best cheap bench board. Both are ESP32-S3 with 8 MB PSRAM and run the same on-device models. The classic ESP32-CAM is not recommended for new on-device face work. Source: Robojax tutorial, QRC live listings.</p>



<p class="wp-block-paragraph"><strong>Can I do face detection on ESP32-S3 with Arduino?</strong>
Yes, with Arduino IDE and ESP32 core version 2.0.17. Core 3 removed the on-device face detection models, so 2.0.17 is required. Select XIAO_ESP32S3, set PSRAM to OPI PSRAM, and capture at 240 by 240. Source: Robojax tutorial.</p>



<p class="wp-block-paragraph"><strong>Can the ESP32-S3 do face recognition offline?</strong>
Yes. Recognition runs on the board with no internet: the Robojax offline project enrolls faces from the board&#8217;s own web page over its own WiFi network. No face data leaves the board. Source: Robojax tutorial, Espressif ESP-WHO docs.</p>



<p class="wp-block-paragraph"><strong>How far away can the ESP32-S3 detect a face?</strong>
No primary source we checked publishes a detection range in feet or meters. Detection depends on how large the face is in the small inference frame, plus lighting and angle. Test at the real mounting distance.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>Espressif ESP-WHO get started: <a href="https://developer.espressif.com/blog/2026/05/esp-who-get-started/" target="_blank" rel="noopener">https://developer.espressif.com/blog/2026/05/esp-who-get-started/</a></li>
<li>Espressif edge AI with ESP32-S3 workshop, Assignment 4: <a href="https://developer.espressif.com/workshops/edge-ai-with-esp32-s3/assignment-4/" target="_blank" rel="noopener">https://developer.espressif.com/workshops/edge-ai-with-esp32-s3/assignment-4/</a></li>
<li>Espressif ESP-WHO repository: <a href="https://github.com/espressif/esp-who" target="_blank" rel="noopener">https://github.com/espressif/esp-who</a></li>
<li>Espressif esp-dl library: <a href="https://github.com/espressif/esp-dl" target="_blank" rel="noopener">https://github.com/espressif/esp-dl</a></li>
<li>Makerguides, Face Detection with XIAO ESP32-S3-Sense and SenseCraft AI: <a href="https://www.makerguides.com/face-detection-with-xiao-esp32-s3-sense-and-sensecraft-ai/" target="_blank" rel="noopener">https://www.makerguides.com/face-detection-with-xiao-esp32-s3-sense-and-sensecraft-ai/</a></li>
<li>Seeed Studio wiki, Using a model for XIAO ESP32S3 Sense: <a href="https://wiki.seeedstudio.com/sensecraft_ai_pretrained_models_for_xiao/" target="_blank" rel="noopener">https://wiki.seeedstudio.com/sensecraft_ai_pretrained_models_for_xiao/</a></li>
<li>SenseCraft AI model page: <a href="https://sensecraft.seeed.cc/ai/model" target="_blank" rel="noopener">https://sensecraft.seeed.cc/ai/model</a></li>
<li>Robojax, XIAO ESP32-S3 Sense offline face recognition: <a href="https://robojax.com/tutorial_view.php?lang=en&amp;id=854" target="_blank" rel="noopener">https://robojax.com/tutorial_view.php?lang=en&amp;id=854</a></li>
<li>EloquentEsp32cam face recognition docs: <a href="https://deepwiki.com/eloquentarduino/EloquentEsp32cam/5.2-face-recognition" target="_blank" rel="noopener">https://deepwiki.com/eloquentarduino/EloquentEsp32cam/5.2-face-recognition</a></li>
<li>Hackster, Face Recognition Based Attendance System Using XIAO ESP32S3: <a href="https://www.hackster.io/roboattic_Lab/face-recognition-based-attendance-system-using-xiao-esp32s3-05b7d1" target="_blank" rel="noopener">https://www.hackster.io/roboattic_Lab/face-recognition-based-attendance-system-using-xiao-esp32s3-05b7d1</a></li>
<li>Hackster, Lesson 9: Make ESP32 React to Face Detection: <a href="https://www.hackster.io/williamsokol0/lesson-9-make-esp32-react-to-face-detection-f596de" target="_blank" rel="noopener">https://www.hackster.io/williamsokol0/lesson-9-make-esp32-react-to-face-detection-f596de</a></li>
<li>CircuitDigest, ESP32-CAM Face Detection System using CircuitDigest Cloud: <a href="https://circuitdigest.com/microcontroller-projects/esp32-cam-face-detection-using-circuitdigest-cloud" target="_blank" rel="noopener">https://circuitdigest.com/microcontroller-projects/esp32-cam-face-detection-using-circuitdigest-cloud</a></li>
<li>element14 community, Seeed Xiao ESP32S3 Sense: <a href="https://community.element14.com/technologies/sensor-technology/b/blog/posts/seeed-xiao-esp32s3-sense?pifragment-7298=2" target="_blank" rel="noopener">https://community.element14.com/technologies/sensor-technology/b/blog/posts/seeed-xiao-esp32s3-sense?pifragment-7298=2</a></li>
<li>Maxlab Tokay Lite, ESP32-S3 edge AI camera board: <a href="https://maxlab.io/store/tokay-lite/" target="_blank" rel="noopener">https://maxlab.io/store/tokay-lite/</a></li>
<li>Espressif esp32-camera repo: <a href="https://github.com/espressif/esp32-camera" target="_blank" rel="noopener">https://github.com/espressif/esp32-camera</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23524</post-id>	</item>
		<item>
		<title>ESP32-CAM Camera Init Failed and Brownout Fixes</title>
		<link>https://qualityrcparts.com/esp32-cam-troubleshooting-brownout-camera-init-failed/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:13:49 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-cam]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/esp32-cam-troubleshooting-brownout-camera-init-failed/</guid>

					<description><![CDATA[Your ESP32-CAM prints "Camera init failed" or "Brownout detector was triggered" and reboots. This guide reads the error code, then walks the fix order: power first, ribbon cable second, board and PSRAM settings third.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">You upload the CameraWebServer sketch, open the Serial Monitor, and instead of a stream URL you get <code>Camera init failed with error 0x105</code>, or the board prints <code>Brownout detector was triggered</code> and reboots. Both errors are common on the classic ESP32-CAM, and both usually come down to the same two things: the board is not getting clean, steady power, or the camera sensor is not talking to the chip. Work through the checks below in order and most boards start streaming without new hardware.</p>



<p class="wp-block-paragraph">This guide covers the classic AI-Thinker style ESP32-CAM with the OV2640 camera. The power and PSRAM steps also apply to the ESP32-S3-CAM, but that board has a different pin map, so verify pins against your own board variant.</p>



<h2 class="wp-block-heading">What does &#8220;Camera init failed&#8221; mean?</h2>



<p class="wp-block-paragraph">It means the ESP32 ran <code>esp_camera_init()</code> and the sensor did not answer. The driver first talks to the sensor over a small two-wire control bus (SCCB, like I2C) and asks it to identify itself. If nothing answers, setup stops and the sketch prints the error code, and no stream URL appears.</p>



<p class="wp-block-paragraph">The usual reasons are a loose ribbon cable, the wrong camera model or board, or a supply that sags during the camera startup spike.</p>



<h2 class="wp-block-heading">What is an ESP32-CAM brownout?</h2>



<p class="wp-block-paragraph">A brownout is a brief dip in supply voltage below the level the ESP32 needs to run. The chip has a built-in brownout detector that watches the 3.3V rail. When the rail sags too far, even for a moment, the detector resets the chip, and the Serial Monitor prints <code>Brownout detector was triggered</code>, often with <code>rst:0xf (BROWNOUT_RST)</code>.</p>



<p class="wp-block-paragraph">The ESP32-CAM is more prone to brownouts than a bare ESP32 board because the camera and Wi-Fi draw sharp current spikes at the same time. MakerGuides reports the board can draw up to about 500 mA with the camera and Wi-Fi active, and Projectech puts Wi-Fi transmit bursts at 160 to 260 mA with the camera and flash LED adding more on top. A laptop USB port, a thin cable, or a weak adapter cannot always deliver those spikes fast enough. The fix is a better supply, not a code change.</p>



<h2 class="wp-block-heading">Which error are you seeing?</h2>



<p class="wp-block-paragraph">Match your Serial Monitor output to a row first. Starting in the wrong place is the most common way to waste an evening on this board.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>What you see</th>
<th>Most likely cause</th>
<th>Check first</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Camera init failed with error 0x105</code> on every boot</td>
<td>Sensor not found: loose cable, wrong model, wrong pin map</td>
<td>Ribbon cable seating, then camera model in the sketch</td>
</tr>
<tr>
<td><code>Camera init failed with error 0x105</code> sometimes</td>
<td>Power sags during camera startup</td>
<td>5V 2A supply, short thick cable, capacitor across 5V and GND</td>
</tr>
<tr>
<td><code>Camera init failed with error 0x20001</code></td>
<td>Sensor not detected by the driver</td>
<td>Ribbon cable, camera model, then power</td>
</tr>
<tr>
<td><code>Camera init failed with error 0x20004</code> or <code>0x103</code></td>
<td>Frame buffer could not be allocated, or the control bus timed out</td>
<td>PSRAM enabled, lower resolution, one frame buffer</td>
</tr>
<tr>
<td><code>frame buffer malloc failed</code> then <code>Camera init failed with error 0xffffffff</code></td>
<td>PSRAM not enabled or resolution too high</td>
<td>PSRAM enabled, lower resolution, frame buffer count to 1</td>
</tr>
<tr>
<td><code>Brownout detector was triggered</code> or <code>rst:0xf (BROWNOUT_RST)</code>, then reboot loop</td>
<td>Supply sagging under Wi-Fi or camera spikes</td>
<td>5V 2A supply, capacitor, short thick leads</td>
</tr>
<tr>
<td>Camera starts, board reboots when streaming starts or the flash LED turns on</td>
<td>Wi-Fi or flash LED spike collapses the rail</td>
<td>Capacitor across 5V and GND, separate 5V supply, test with flash off</td>
</tr>
<tr>
<td>Works on a wall adapter, fails on a laptop USB port</td>
<td>USB port current limit or thin cable voltage drop</td>
<td>Wall adapter, powered hub, shorter cable</td>
</tr>
<tr>
<td><code>Detected camera not supported</code> with error <code>0x106</code></td>
<td>Newer drivers report a missing sensor this way</td>
<td>Same steps as 0x105; replace the camera module if it persists</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">What do the error codes mean?</h2>



<p class="wp-block-paragraph">The camera driver returns a numeric code from <code>esp_camera_init()</code>. These are the codes builders actually see.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Error code</th>
<th>Meaning</th>
<th>First fix</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>0x105</code></td>
<td><code>ESP_ERR_NOT_FOUND</code>: the camera probe found no sensor on the control bus. The sensor did not answer: no power, cable not seated, or wrong pins.</td>
<td>Reseat the ribbon cable with power off, confirm the camera model in the sketch, check the supply</td>
</tr>
<tr>
<td><code>0x20001</code></td>
<td>Camera not detected by the esp32-camera driver. Same practical meaning as 0x105: the sensor did not answer the probe.</td>
<td>Same as 0x105: cable, camera model, power</td>
</tr>
<tr>
<td><code>0x106</code></td>
<td>Newer drivers report a missing or unrecognised sensor as <code>Detected camera not supported</code>.</td>
<td>Same steps as 0x105; try a known-good camera module</td>
</tr>
<tr>
<td><code>0x20004</code> / <code>0x103</code></td>
<td>Reported by some guides as a PSRAM allocation failure or a control bus timeout. Secondary sources disagree on the exact mapping for these codes.</td>
<td>Enable PSRAM, lower the resolution, check the cable</td>
</tr>
<tr>
<td><code>0xffffffff</code></td>
<td>Frame buffer memory could not be allocated, usually after a <code>frame buffer malloc failed</code> line.</td>
<td>Enable PSRAM, lower the resolution, set frame buffer count to 1</td>
</tr>
<tr>
<td><code>rst:0xf</code></td>
<td>Brownout reset: the brownout detector tripped and reset the chip. This is a reset reason, not a camera error.</td>
<td>Power supply checklist below</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Two notes on the codes. First, 0x105 is confirmed as <code>ESP_ERR_NOT_FOUND</code> by the driver log line itself, <code>Camera probe failed with error 0x105(ESP_ERR_NOT_FOUND)</code>, which appears in Arduino Forum threads and in two of the guides below. Second, one guide maps 0x105 to a power fault while others map it to a probe fault. The log line supports the probe reading, and a weak supply can cause a probe fault too. See the unverified flags at the foot of this post.</p>



<h2 class="wp-block-heading">How do I diagnose it step by step?</h2>



<p class="wp-block-paragraph">Do these in order. Each step rules out a whole category. Do not skip ahead to replacing the camera module until steps 1 to 5 pass.</p>



<ol class="wp-block-list">

<li><strong>Read the exact error.</strong> Open the Serial Monitor at the baud rate your sketch uses (usually 115200) and copy the full line, including the hex code. 0x105 or 0x20001 means cable, model, or power; a malloc failure means PSRAM; a brownout line means power only.</li>
<li><strong>Fix the power first.</strong> Connect a regulated 5V 2A supply to the 5V pin with a short, thick USB cable. Do not use a laptop USB port or an adapter 3.3V output while diagnosing. If the error changes on the wall adapter, the supply was the problem.</li>
<li><strong>Reseat the ribbon cable with power off.</strong> Lift the black locking flap, pull the 24-pin ribbon cable out, push it back in straight and fully, then close the flap. Check the cable is not creased or nicked, then power on and read the error again.</li>
<li><strong>Confirm the board and camera model in the sketch.</strong> In the Arduino IDE, select AI Thinker ESP32-CAM, and check the sketch defines <code>CAMERA_MODEL_AI_THINKER</code> for a classic ESP32-CAM with an OV2640. A generic ESP32 Dev Module board can disable the PSRAM mapping the camera needs.</li>
<li><strong>Enable PSRAM.</strong> Set Tools, PSRAM to Enabled. Then lower the resolution one step (UXGA to SVGA), set the frame buffer count to 1, and test again. If a malloc error clears, memory was the limit.</li>
<li><strong>Remove GPIO0 from ground.</strong> If you jumpered GPIO0 to GND to flash the board, remove that jumper before running the sketch. Held low, GPIO0 keeps the board in flash mode and the camera never initialises.</li>
<li><strong>Test with Wi-Fi and the flash LED off.</strong> If the board resets when streaming starts or the flash turns on, the current spike is collapsing the rail. Add the capacitor and retest.</li>
<li><strong>Swap one part at a time.</strong> Try a different USB cable, then a different camera module, then a different board, changing one thing per test.</li>

</ol>



<h2 class="wp-block-heading">Why does power cause most ESP32-CAM failures?</h2>



<p class="wp-block-paragraph">Three facts stack against this board. First, the classic ESP32-CAM has no onboard USB-to-serial chip, so most builders power it through an adapter whose 3.3V output typically supplies only 50 to 100 mA, far below what the camera and Wi-Fi draw together. Second, the onboard AMS1117-3.3 regulator needs a 5V input with headroom to hold the rail steady during spikes. Third, the camera and Wi-Fi spike at the same moment during startup and streaming, so the worst load lands exactly when the driver probes the sensor.</p>



<ul class="wp-block-list">

<li><strong>Power the board through the 5V pin, not the 3.3V pin.</strong> The 3.3V pin bypasses the onboard regulator, and a weak 3.3V source sags under load.</li>
<li><strong>Use a regulated 5V 2A supply.</strong> A 1A supply is the minimum several guides quote, and 2A leaves headroom for the spikes. A phone charger rated 5V 2A works; a laptop USB port often does not.</li>
<li><strong>Use a short, thick USB cable.</strong> Long thin cables add resistance, and resistance turns a current spike into a voltage drop.</li>
<li><strong>Add a bulk capacitor across 5V and GND.</strong> A 470uF to 1000uF electrolytic capacitor near the board supplies the millisecond spikes the regulator cannot track. Add a 0.1uF ceramic capacitor in parallel for high-frequency noise. Watch the polarity: the marked side goes to ground.</li>
<li><strong>Keep the serial adapter at 3.3V logic.</strong> The adapter is fine for the TX and RX signal lines, and its logic jumper should stay at 3.3V, since ESP32 GPIO pins are not 5V tolerant.</li>
<li><strong>Do not share the rail with hungry peripherals.</strong> Motors, servos, and LED strips draw their own spikes, so give them a separate regulated supply with a common ground.</li>

</ul>



<p class="wp-block-paragraph">For a battery-powered build, the battery path must still deliver a steady 5V under spike load. A small lithium cell alone cannot do that without a boost stage, so use a battery module with a regulated 5V USB output and test under streaming load, not just at idle.</p>



<h2 class="wp-block-heading">Power-supply checklist</h2>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Check</th>
<th>Pass looks like</th>
<th>Fail looks like</th>
</tr>
</thead>
<tbody>
<tr>
<td>Supply rating</td>
<td>Regulated 5V adapter rated 2A</td>
<td>Laptop USB port, unbranded 5V 500 mA charger</td>
</tr>
<tr>
<td>Power pin</td>
<td>5V pin fed from the adapter</td>
<td>3.3V pin fed from an adapter</td>
</tr>
<tr>
<td>USB cable</td>
<td>Short, thick, data rated</td>
<td>Long thin charging cable</td>
</tr>
<tr>
<td>Capacitor</td>
<td>470uF to 1000uF electrolytic across 5V and GND, close to the board</td>
<td>No capacitor, or one far from the board</td>
</tr>
<tr>
<td>Breadboard</td>
<td>Power wired direct to the board pins</td>
<td>Power through a breadboard with loose jumpers</td>
</tr>
<tr>
<td>Flash and stream test</td>
<td>Board stays up with the flash LED on and the stream running</td>
<td>Board resets when the flash turns on or the stream starts</td>
</tr>
<tr>
<td>Battery test</td>
<td>Battery module with regulated 5V output</td>
<td>Bare cell wired direct</td>
</tr>
</tbody>
</table>
</figure>



<h2 class="wp-block-heading">Is the ribbon cable the problem?</h2>



<p class="wp-block-paragraph">The 24-pin ribbon cable between the camera module and the board is the most fragile part of the build, and a bad seating produces exactly the 0x105 probe failure. Power the board off first, then lift the black locking flap, slide the cable out, and look at it: the gold fingers should be clean and straight, the cable should not be creased, and the blue stiffener should sit flat. Push the cable in straight and all the way, then close the flap. If it went in crooked, the sensor gets power on the wrong pins or no connection at all.</p>



<p class="wp-block-paragraph">Two more checks. Clean the gold fingers with isopropyl alcohol and a cotton swab if the module sat unused in a damp room; oxidation on the contacts is a real failure mode. If reseating changes nothing, try a different camera module on the same board. If a known-good module works, the first module or its cable is faulty.</p>



<h2 class="wp-block-heading">Is PSRAM enabled and the right board selected?</h2>



<p class="wp-block-paragraph">The ESP32-CAM needs its external PSRAM to buffer image frames. The classic board carries 4MB of PSRAM. If the Arduino IDE is not told the PSRAM exists, the driver fails to allocate memory, and you see a malloc failure or an init error at higher resolutions.</p>



<p class="wp-block-paragraph">Check three settings. First, the board must be AI Thinker ESP32-CAM, not a generic ESP32 Dev Module, because the board selection carries the pin definitions and PSRAM mapping. Second, Tools, PSRAM must be set to Enabled. Third, the partition scheme must leave enough app space. If the error clears at a lower resolution or with one frame buffer, memory was the limit.</p>



<h2 class="wp-block-heading">Is the wrong camera model selected?</h2>



<p class="wp-block-paragraph">The sketch must define the camera model that matches the hardware. For the classic ESP32-CAM with an OV2640, that is <code>CAMERA_MODEL_AI_THINKER</code>. Other boards use different definitions and pin maps, so a sketch written for one board fails on another with the same 0x105 probe error. Check the definition at the top of the sketch before changing anything else.</p>



<p class="wp-block-paragraph">The sensor matters too. An OV2640 and an OV5640 are not interchangeable: the OV5640 needs its own initialisation settings, and OV2640 settings fail the probe on an OV5640 module. The ESP32-S3-CAM in the parts list below carries an OV5640, so use the S3 board definition and the S3 guide for that hardware. Verify the pin table for your board variant before wiring, because published pin tables disagree on some signals.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li>Powering the board from the 3.3V pin of a USB-to-serial adapter instead of the 5V pin.</li>
<li>Using a laptop USB port or a long thin charging cable.</li>
<li>Leaving the GPIO0 to GND jumper in place after flashing.</li>
<li>Selecting a generic ESP32 Dev Module board instead of AI Thinker ESP32-CAM.</li>
<li>Leaving PSRAM disabled, then running UXGA resolution with two frame buffers.</li>
<li>Reseating the ribbon cable with power on, or pushing it in crooked.</li>
<li>Setting the USB-to-serial adapter to 5V logic and feeding 5V into the RX pin.</li>
<li>Changing the sketch, the cable, and the power supply all at once.</li>

</ul>



<h2 class="wp-block-heading">When is the board or camera module dead?</h2>



<p class="wp-block-paragraph">If the power checklist passes, the cable is reseated, the board and camera model are correct, PSRAM is enabled, and a known-good camera module still fails with 0x105 or 0x20001, the board itself is the suspect. Check the connector for a lifted flap or bent pins, and look for a damaged AMS1117 regulator if the board browns out on a known-good 5V 2A supply. Before replacing anything, run the same module on a second board: a module that fails on two boards is a bad module, and a board that fails with two modules is a bad board.</p>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">These parts are in stock at Quality RC Parts in Queensbury, NY, shipping within the USA. Prices verified live on 2026-11-21.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/esp32-cam-development-board-with-ov2640-camera-module-4mb-psram/">ESP32-CAM Development Board with OV2640 Camera Module, 4MB PSRAM</a> (ID 13473) &#8211; $25.99. The classic board this guide troubleshoots. Use the AI Thinker setting and enable PSRAM.</li>
<li><a href="https://qualityrcparts.com/product/esp32-s3-n16r8-cam-development-board-with-ov5640-camera-dual-usb-c-wifi-bluetooth-5/">ESP32-S3-N16R8 CAM Development Board with OV5640 Camera, Dual USB-C, WiFi + Bluetooth 5</a> (ID 19636) &#8211; $22.99. The S3 successor with onboard USB-C; use the S3 board definition and pin map.</li>
<li><a href="https://qualityrcparts.com/product/lipo-battery-module-usb-c-rechargeable-1200mah-3-3v-5v-usb/">LiPo Battery Module, USB-C Rechargeable 1200mAh, 3.3V and 5V USB Output for Arduino, ESP32, and Raspberry Pi</a> (ID 18959) &#8211; $14.99. A battery module with a regulated 5V USB output for portable builds. Feed the board from the 5V output, not the 3.3V output.</li>
<li><a href="https://qualityrcparts.com/product/3-7v-3000mah-lipo-battery-1s-jst-1-25-plug-for-esp32-and-arduino-boards-4-pack/">3.7V 3000mAh LiPo Battery, 1S, JST 1.25 Plug, for ESP32 and Arduino Boards, 4-Pack</a> (ID 18961) &#8211; $35.99. Spare cells for the battery module above. Never run a cell flat.</li>

</ul>



<p class="wp-block-paragraph">Related guides on this site: <a href="https://qualityrcparts.com/esp32-cam-getting-started/">ESP32-CAM Getting Started</a>, <a href="https://qualityrcparts.com/esp32-cam-flashing-first-camera-stream/">ESP32-CAM Flashing and First Camera Stream</a>, <a href="https://qualityrcparts.com/esp32-cam-pinout/">ESP32-CAM Pinout</a>, <a href="https://qualityrcparts.com/esp32-brownout-reset-boot-loop-fix/">ESP32 Brownout Reset and Boot Loop: Causes and Fixes</a>, <a href="https://qualityrcparts.com/esp32-cam-s3-cam-camera-projects-guide/">ESP32-CAM S3-CAM Camera Projects Guide</a>, <a href="https://qualityrcparts.com/esp32-s3-cam-guide/">ESP32-S3-CAM Guide</a>.</p>



<h2 class="wp-block-heading">Frequently asked questions</h2>



<h3 class="wp-block-heading">How do I fix the ESP32-CAM &#8220;Camera init failed&#8221; error?</h3>



<p class="wp-block-paragraph">Check the error code first. For 0x105 or 0x20001, reseat the ribbon cable with power off, confirm <code>CAMERA_MODEL_AI_THINKER</code> for a classic board, enable PSRAM, and power the board from a regulated 5V 2A supply. For a malloc failure, enable PSRAM and lower the resolution. (Source: Bluegrays; Robotics Engineering.)</p>



<h3 class="wp-block-heading">What does &#8220;Brownout detector was triggered&#8221; mean?</h3>



<p class="wp-block-paragraph">It means the supply voltage dipped below what the ESP32 needs and the built-in detector reset the chip. The usual cause is a weak supply, a thin or long USB cable, or current spikes from Wi-Fi and the camera. Fix it with a regulated 5V 2A adapter, a short thick cable, and a 470uF to 1000uF capacitor across 5V and GND. (Source: MakerGuides; ESPBoards.)</p>



<h3 class="wp-block-heading">What does error 0x105 mean on the ESP32-CAM?</h3>



<p class="wp-block-paragraph">It is <code>ESP_ERR_NOT_FOUND</code>: the camera probe found no sensor on the control bus. The sensor did not answer, usually because the ribbon cable is loose, the wrong camera model is selected, or the power sagged at startup. (Source: Robotics Engineering; Bluegrays; Arduino Forum.)</p>



<h3 class="wp-block-heading">Can I power the ESP32-CAM from the 3.3V pin?</h3>



<p class="wp-block-paragraph">You can, but you should not. The 3.3V output of a typical USB-to-serial adapter supplies only about 50 to 100 mA, and the board draws far more with the camera and Wi-Fi running. Power the board through the 5V pin and let the onboard regulator step it down. (Source: MakerGuides; ElectricalFlux.)</p>



<h3 class="wp-block-heading">What size capacitor fixes an ESP32-CAM brownout?</h3>



<p class="wp-block-paragraph">A 470uF or larger electrolytic capacitor across 5V and GND, close to the board, is what MakerGuides and Projectech recommend; ESPBoards gives a 470uF to 1000uF range. Add a 0.1uF ceramic capacitor in parallel for high-frequency noise. The capacitor fixes spikes, not a supply that is too weak overall. (Source: MakerGuides; ESPBoards; Projectech.)</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>MakerGuides, &#8220;Fix brownout of ESP32-CAM&#8221;: <a href="https://www.makerguides.com/fix-brownout-of-esp32-cam/" target="_blank" rel="noopener">https://www.makerguides.com/fix-brownout-of-esp32-cam/</a></li>
<li>ESPBoards, &#8220;ESP32 Brownout Reset Error&#8221;: <a href="https://www.espboards.dev/troubleshooting/issues/power/esp32-brownout-reset/" target="_blank" rel="noopener">https://www.espboards.dev/troubleshooting/issues/power/esp32-brownout-reset/</a></li>
<li>Robotics Engineering, &#8220;ESP32-CAM Camera init failed with error 0x105: fixes&#8221;: <a href="https://roboticsengineering.in/fix/esp32-camera-init-failed-0x105/" target="_blank" rel="noopener">https://roboticsengineering.in/fix/esp32-camera-init-failed-0x105/</a></li>
<li>ElectricalFlux, &#8220;ESP32 CAM Module Troubleshooting: Fix Init and Brownout Errors&#8221;: <a href="https://electricalflux.com/mcu-general/esp32-cam-module-troubleshooting-fixes" target="_blank" rel="noopener">https://electricalflux.com/mcu-general/esp32-cam-module-troubleshooting-fixes</a></li>
<li>ElectricalFlux, &#8220;ESP32 Camera Pinout Troubleshooting: Fix Init Errors and Wiring Faults&#8221;: <a href="https://electricalflux.com/mcu-general/esp32-camera-pinout-troubleshooting-guide" target="_blank" rel="noopener">https://electricalflux.com/mcu-general/esp32-camera-pinout-troubleshooting-guide</a></li>
<li>ElectricalFlux, &#8220;ESP32-CAM Modules: Debugging Init Errors and Build Guide&#8221;: <a href="https://electricalflux.com/mcu-projects/esp32-cam-modules-debugging-build-guide" target="_blank" rel="noopener">https://electricalflux.com/mcu-projects/esp32-cam-modules-debugging-build-guide</a></li>
<li>Projectech, &#8220;ESP32-CAM Projects: Complete Setup Guide&#8221;: <a href="https://projectech.in/guides/esp32-cam-projects-complete-setup-guide/" target="_blank" rel="noopener">https://projectech.in/guides/esp32-cam-projects-complete-setup-guide/</a></li>
<li>Bluegrays, &#8220;ESP32-CAM Tutorial: Setup, Programming, Live Stream and SD Card&#8221;: <a href="https://bluegrays.com/en/blog/esp32-cam-tutorial-arduino-ide" target="_blank" rel="noopener">https://bluegrays.com/en/blog/esp32-cam-tutorial-arduino-ide</a></li>
<li>Arduino Forum, &#8220;Can&#8217;t get ESP32-cam to run&#8221;: <a href="https://forum.arduino.cc/t/cant-get-esp32-cam-to-run/1349502" target="_blank" rel="noopener">https://forum.arduino.cc/t/cant-get-esp32-cam-to-run/1349502</a></li>

</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23519</post-id>	</item>
		<item>
		<title>ESP32-CAM RTSP Streaming: Setup Guide for VLC and NVR</title>
		<link>https://qualityrcparts.com/esp32-cam-rtsp-streaming/</link>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubDate>Sat, 21 Nov 2026 23:13:18 +0000</pubDate>
				<category><![CDATA[ESP32]]></category>
		<category><![CDATA[arduino]]></category>
		<category><![CDATA[arduino-ide]]></category>
		<category><![CDATA[esp-idf]]></category>
		<category><![CDATA[esp32]]></category>
		<category><![CDATA[esp32-cam]]></category>
		<category><![CDATA[esp32-s3]]></category>
		<category><![CDATA[platformio]]></category>
		<category><![CDATA[project-build]]></category>
		<category><![CDATA[troubleshooting]]></category>
		<guid isPermaLink="false">https://qualityrcparts.com/esp32-cam-rtsp-streaming/</guid>

					<description><![CDATA[The stock ESP32-CAM sketch has no RTSP server. This guide shows which firmware adds one, how to stream to VLC, Frigate, and Home Assistant, and what frame rate to expect.]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">The ESP32-CAM is a cheap way to build a WiFi camera, but the sketch most beginners start with does not speak RTSP. The stock Espressif CameraWebServer example streams MJPEG over HTTP, and that is all it does. If you want VLC, Frigate, Blue Iris, or an NVR to pick the camera up as a standard network camera, you need RTSP, which needs different firmware or a different library.</p>



<p class="wp-block-paragraph">This guide covers the working routes, the board each one fits, the exact RTSP URL each serves, VLC viewing, Frigate and Home Assistant setup, and expected frame rate. Nothing here needs a paid app or a cloud account.</p>



<h2 class="wp-block-heading">What is RTSP, and when does it beat MJPEG?</h2>



<p class="wp-block-paragraph">RTSP, Real Time Streaming Protocol, is the standard way network cameras hand video to players and recorders. A client asks for a stream, the two agree on transport settings, and video flows over RTP. VLC, ffmpeg, Frigate, Blue Iris, ZoneMinder, and most NVR software all speak RTSP.</p>



<p class="wp-block-paragraph">MJPEG over HTTP, the <code>/stream</code> endpoint in the stock CameraWebServer sketch, is simpler: the camera sends one JPEG image after another in a single HTTP response, and any browser can show it. NVR software generally cannot record it, and detection tools cannot consume it directly.</p>



<p class="wp-block-paragraph">Use RTSP to record footage, run motion or person detection, watch several cameras in one app, or feed the camera into Home Assistant through Frigate or go2rtc. Stick with MJPEG over HTTP for a quick live view in a browser. If you have not set up the board yet, start with our <a href="/esp32-cam-getting-started/">ESP32-CAM getting started guide</a> first.</p>



<h2 class="wp-block-heading">Which board works for RTSP?</h2>



<p class="wp-block-paragraph">Any ESP32 camera board with PSRAM can run an RTSP server. The classic AI-Thinker style ESP32-CAM has an ESP32 chip with 4 MB PSRAM and an OV2640 camera. The ESP32-S3-N16R8 CAM board runs an ESP32-S3 chip with 8 MB PSRAM and an OV5640 camera, and its two USB-C ports mean no serial adapter is needed. Both boards stream MJPEG video over RTSP, not H.264, which matters for bandwidth and Home Assistant (see the frame rate section).</p>



<p class="wp-block-paragraph">Pin tables conflict across sources. A wrong camera pin map is the most common reason a build compiles cleanly and shows no video, so verify the pins against your exact board variant before flashing, using that variant&#8217;s own documentation.</p>



<h2 class="wp-block-heading">What are the RTSP setup options?</h2>



<p class="wp-block-paragraph">There is no single official RTSP example from Espressif for the classic ESP32-CAM. The working routes are community firmware and libraries. Pick one row and follow its section.</p>



<figure class="wp-block-table">
<table>
<thead>
<tr>
<th>Approach</th>
<th>Best for</th>
<th>Boards</th>
<th>RTSP URL pattern</th>
<th>Code or config needed</th>
</tr>
</thead>
<tbody>
<tr>
<td>esp32cam-rtsp firmware by rzeldent</td>
<td>Fastest setup, no code changes</td>
<td>ESP32, ESP32-S2, ESP32-S3 camera modules</td>
<td>rtsp://IP:554/mjpeg/1</td>
<td>Flash with PlatformIO, configure in a browser</td>
</tr>
<tr>
<td>Micro-RTSP library by geeksville</td>
<td>Arduino or PlatformIO sketch you control</td>
<td>Classic ESP32-CAM (OV2640)</td>
<td>rtsp://IP:8554/mjpeg/1</td>
<td>Arduino sketch plus the Micro-RTSP library</td>
</tr>
<tr>
<td>Tasmota32 webcam firmware</td>
<td>Users who already run Tasmota and want MQTT control</td>
<td>Classic ESP32-CAM (AI-Thinker template)</td>
<td>rtsp://IP:8554/mjpeg/1</td>
<td>Flash the webcam binary, run one command</td>
</tr>
<tr>
<td>ESPHome rtsp_server component</td>
<td>ESP32-S3 boards already in ESPHome</td>
<td>ESP32 camera boards running ESPHome</td>
<td>rtsp://IP:554/</td>
<td>Add two lines to your ESPHome YAML</td>
</tr>
</tbody>
</table>
</figure>



<p class="wp-block-paragraph">Sources: esp32cam-rtsp at <a href="https://www.esp32.diy/esp32cam-rtsp/" target="_blank" rel="noopener">https://www.esp32.diy/esp32cam-rtsp/</a> ; Micro-RTSP at <a href="https://github.com/geeksville/Micro-RTSP" target="_blank" rel="noopener">https://github.com/geeksville/Micro-RTSP</a> ; circuit.rocks tutorial at <a href="https://learn.circuit.rocks/esp32-cam-with-rtsp-video-streaming" target="_blank" rel="noopener">https://learn.circuit.rocks/esp32-cam-with-rtsp-video-streaming</a> ; Tasmota guide at <a href="https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/" target="_blank" rel="noopener">https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/</a> ; ESPHome docs at <a href="https://beta.esphome.io/components/rtsp_server/" target="_blank" rel="noopener">https://beta.esphome.io/components/rtsp_server/</a> .</p>



<h2 class="wp-block-heading">How do I set up esp32cam-rtsp, the no-code route?</h2>



<p class="wp-block-paragraph">Recommended route for most buyers. The firmware turns the board into an RTSP server, an HTTP MJPEG streamer, and a snapshot endpoint at once, all configured through a web page, with no code changes. Latest release at the time of writing: 1.0.8 (2026-09-29).</p>



<ol class="wp-block-list">

<li>Install PlatformIO (VS Code extension or CLI) and clone the project: <code>git clone https://github.com/rzeldent/esp32cam-rtsp.git</code>.</li>
<li>Enter download mode. USB-C boards do this on their own; if an upload fails, hold BOOT, press and release RESET, then release BOOT. On a classic ESP32-CAM, use a 3.3 V USB-to-serial adapter or an ESP32-CAM-MB carrier, and hold GPIO0 low while resetting. 5 V logic damages the board.</li>
<li>Flash your board target, for example <code>pio run -t upload -e esp32cam_ai_thinker</code> for the AI-Thinker board.</li>
<li>On first boot the firmware starts its own WiFi access point. Join it, open the config page shown in the serial monitor, enter your WiFi credentials and camera settings, then save. The board reboots onto your network.</li>
<li>Open VLC and play <code>rtsp://&lt;ip address&gt;:554/mjpeg/1</code>.</li>

</ol>



<p class="wp-block-paragraph">The same firmware also serves MJPEG at <code>http://&lt;ip address&gt;/stream</code> and a still at <code>http://&lt;ip address&gt;/snapshot</code>. Turn on RTSP authentication in the web interface if anyone outside your household can reach your network, and never forward port 554 through your router.</p>



<h2 class="wp-block-heading">How do I set up Micro-RTSP in an Arduino sketch?</h2>



<p class="wp-block-paragraph">Use this route when you want the RTSP server inside your own sketch, for example a camera that also reads sensors or drives outputs. Micro-RTSP is a small RTSP server library implementing RTSP and JPEG-over-RTP, with a reference streamer built for the OV2640 on the classic ESP32-CAM.</p>



<ol class="wp-block-list">

<li>Install Micro-RTSP from the ZIP in the circuit.rocks ESP32-RTSP repo, or as a PlatformIO dependency; it is not in the Arduino Library Manager. Full example: <a href="https://github.com/circuitrocks/ESP32-RTSP" target="_blank" rel="noopener">https://github.com/circuitrocks/ESP32-RTSP</a> .</li>
<li>Put your WiFi credentials in the sketch&#8217;s credentials header before compiling.</li>
<li>Wire the classic ESP32-CAM: 5 V and ground to the header pins, adapter TX to board U0R and RX to U0T, and a button between IO0 and ground. Use a 5 V, 2 A supply; a computer USB port is often not enough.</li>
<li>Hold the download button while powering up or resetting, then upload. The serial monitor at 115200 baud shows the boot message and board IP.</li>
<li>In VLC play <code>rtsp://&lt;ip address&gt;:8554/mjpeg/1</code>. Note the port: 8554, not 554.</li>

</ol>



<p class="wp-block-paragraph">The example loop sends a frame about every 100 ms, roughly 10 fps at 800 by 600, per the Micro-RTSP docs for that example. Run only one streaming server at a time; enabling both web and RTSP makes streaming very slow.</p>



<h2 class="wp-block-heading">How do I enable RTSP on Tasmota?</h2>



<p class="wp-block-paragraph">Use this route only if you already run Tasmota or want its MQTT control and web interface. Flash the <code>tasmota32-webcam</code> firmware, apply the AI-Thinker template, then enable the RTSP server from the Tasmota console:</p>



<pre class="wp-block-code"><code>WcRtsp 1
</code></pre>



<p class="wp-block-paragraph">The stream is then live at <code>rtsp://&lt;device IP&gt;:8554/mjpeg/1</code>. Enable it once; the RTSP server runs independently of the HTTP stream. The Tasmota guide reports VLC is the most reliable viewer. Full steps: <a href="https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/" target="_blank" rel="noopener">https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/</a> .</p>



<h2 class="wp-block-heading">How do I add RTSP to an ESPHome camera?</h2>



<p class="wp-block-paragraph">If your camera already runs ESPHome, add the RTSP server component next to your configured <code>esp32_camera</code> block:</p>



<pre class="wp-block-code"><code class="language-yaml">rtsp_server:
</code></pre>



<p class="wp-block-paragraph">That is the whole configuration. The stream is served at <code>rtsp://&lt;device IP&gt;:554/</code> with no path after the port. Optional settings: <code>port</code> (default 554), <code>max_connections</code> (1 to 4, default 2), and <code>allowed_ips</code> (addresses or networks allowed to connect).</p>



<p class="wp-block-paragraph">Two facts catch people out. First, the stream is MJPEG over RTSP, and the camera only streams while at least one client is playing. Second, there is no encryption or authentication; <code>allowed_ips</code> filters by address but authenticates nobody, so use it only on a trusted local network. Source: ESPHome RTSP docs.</p>



<h2 class="wp-block-heading">How do I watch the stream in VLC?</h2>



<p class="wp-block-paragraph">VLC is the best first test for any of the four routes, because its RTSP support is solid and its error messages point at the real problem.</p>



<ol class="wp-block-list">

<li>Open VLC, go to Media, then Open Network Stream, or press Ctrl+N.</li>
<li>Paste the RTSP URL for your firmware: port 554 for esp32cam-rtsp and ESPHome, port 8554 for Micro-RTSP and Tasmota. The path is <code>/mjpeg/1</code> for esp32cam-rtsp, Micro-RTSP, and Tasmota, and the root path <code>/</code> for ESPHome.</li>
<li>Click Play. If the picture appears, the camera, firmware, and network path all work, and any later failure is in the next app, not the camera.</li>

</ol>



<p class="wp-block-paragraph">If the video lags by a second or more, the cause is usually VLC network caching, not the camera. VLC buffers network streams at 1000 ms by default. In the stream dialog, click Show more options and lower caching to 300 ms, or to 0 ms for the lowest delay. Zero caching makes the picture more sensitive to WiFi jitter, so on a weak signal keep some caching and fix the signal instead.</p>



<h2 class="wp-block-heading">How do I add the camera to Home Assistant and Frigate?</h2>



<p class="wp-block-paragraph">Two warnings first, because most tutorials get this part wrong.</p>



<p class="wp-block-paragraph">Warning one: Home Assistant Generic Camera cannot play this stream. Its pipeline plays only H.264 and HEVC, and every RTSP route in this guide serves MJPEG. The ESPHome docs state this directly. Source: ESPHome RTSP docs.</p>



<p class="wp-block-paragraph">Warning two: if the camera runs ESPHome, Home Assistant does not need RTSP at all. The ESPHome native API already exposes the camera entity. RTSP is for other software.</p>



<p class="wp-block-paragraph">The route that works is Frigate, with go2rtc if your Frigate version uses it. Frigate reads the MJPEG RTSP stream with ffmpeg and handles detection and recording. A working Frigate camera entry from the Home Assistant community, using the Tasmota or Micro-RTSP URL:</p>



<pre class="wp-block-code"><code class="language-yaml">cameras:
  esp32_cam:
    ffmpeg:
      inputs:
        - path: rtsp://192.168.1.72:8554/mjpeg/1
          roles:
            - detect
            - record
    detect:
      width: 640
      height: 360
      fps: 5
</code></pre>



<p class="wp-block-paragraph">Replace the IP address with your camera IP, and use port 554 with the matching path for esp32cam-rtsp or ESPHome. Keep detection resolution low; community users run 640 by 360 at 5 frames per second. Source: Home Assistant community Frigate thread.</p>



<p class="wp-block-paragraph">If you only want a live dashboard view, skip RTSP and use the ESPHome native camera entity or the HTTP MJPEG stream. RTSP earns its place when Frigate or an NVR must record or analyze the feed.</p>



<h2 class="wp-block-heading">What latency and frame rate should I expect?</h2>



<p class="wp-block-paragraph">No source gives one tested frame rate for every board and firmware, so this guide gives no universal number. The numbers below are what named sources measured on their own setups. Your result moves with resolution, JPEG quality, WiFi signal, and client count.</p>



<ul class="wp-block-list">

<li>ESPHome measured about 5 fps over WiFi and 10 over Ethernet at 640 by 480 on an ESP32-S3 with an OV5640, using its high performance network settings; without them the same test ran at about 1 fps over WiFi. Source: ESPHome RTSP docs.</li>
<li>The Micro-RTSP example sends a frame about every 100 ms, roughly 10 fps at 800 by 600 in its own documentation. Source: Micro-RTSP docs.</li>
<li>The esp32cam-rtsp project states that resolution and frame rate are bounded by the ESP32 processor and available PSRAM. Source: esp32cam-rtsp project page.</li>

</ul>



<p class="wp-block-paragraph">Start at 640 by 480 and raise resolution only after the stream is stable. MJPEG uses more bandwidth than H.264 at the same picture quality, since every frame is a full JPEG. Assume one viewer at a time on a classic ESP32-CAM; ESPHome defaults to two RTSP clients.</p>



<h2 class="wp-block-heading">What are the common mistakes?</h2>



<ul class="wp-block-list">

<li><strong>Flashing the stock CameraWebServer sketch and expecting RTSP.</strong> It serves MJPEG over HTTP only.</li>
<li><strong>Using the wrong port.</strong> Port 554 belongs to esp32cam-rtsp and ESPHome; port 8554 belongs to Micro-RTSP and Tasmota. The wrong port gives a connection refused error even when the camera runs fine.</li>
<li><strong>Using the wrong path.</strong> The path is <code>/mjpeg/1</code> for esp32cam-rtsp, Micro-RTSP, and Tasmota, and the root path <code>/</code> for ESPHome.</li>
<li><strong>Powering the classic ESP32-CAM from a weak USB port.</strong> The board needs a stable 5 V, 2 A supply. Brownouts during WiFi connection look like firmware bugs and are usually power.</li>
<li><strong>Running two streaming servers at once in the Micro-RTSP sketch.</strong> The tutorial warns this makes streaming very slow. Pick one.</li>
<li><strong>Pointing Home Assistant Generic Camera at an MJPEG RTSP URL.</strong> It cannot play it. Use Frigate or go2rtc, or the ESPHome native camera entity.</li>
<li><strong>Opening RTSP to the internet.</strong> None of these routes is built for that, and ESPHome RTSP has no authentication at all. Keep the camera on your local network.</li>
<li><strong>Trusting a pin table from a different board variant.</strong> Pin maps conflict across sources. Verify the camera pins against your exact board variant before blaming the firmware.</li>

</ul>



<h2 class="wp-block-heading">How do I troubleshoot a stream that will not play?</h2>



<p class="wp-block-paragraph">Work through this list in order; each step rules out one layer.</p>



<p class="wp-block-paragraph"><strong>VLC says &#8220;Your input can&#8217;t be opened&#8221; or times out.</strong> Check the board IP in the serial monitor or your router, confirm the camera and computer share a network, and confirm the port and path match your firmware in the table above. Check the router is not isolating WiFi clients (AP isolation) and that no firewall blocks the RTSP port.</p>



<p class="wp-block-paragraph"><strong>VLC connects but shows a black or frozen frame.</strong> Drop to 640 by 480 and move closer to the router. The ESP32-CAM is 2.4 GHz only, so a 5 GHz network name will never work.</p>



<p class="wp-block-paragraph"><strong>The stream stutters or drops frames.</strong> Lower the resolution and frame rate, disconnect other viewers, and check the power supply, since a marginal 5 V supply causes this under load. In VLC, force RTP over RTSP (TCP) when UDP packets drop.</p>



<p class="wp-block-paragraph"><strong>The camera boots but never joins WiFi.</strong> Re-enter the network name and password, watching case and trailing spaces. Check the serial monitor at 115200 baud for connection messages and the assigned IP. A reboot loop usually means power first, then a loose camera ribbon cable.</p>



<p class="wp-block-paragraph"><strong>The camera works in VLC but Frigate reports &#8220;Unable to read frames&#8221;.</strong> Confirm the URL in VLC first, then copy it exactly into Frigate. The common cause is port 554 when the firmware serves on 8554, or an ESPHome web server port, which is HTTP, not RTSP. Source: Home Assistant community thread.</p>



<p class="wp-block-paragraph"><strong>Wrong colors or artifacts.</strong> Reseat the camera ribbon cable and lower the resolution.</p>



<h2 class="wp-block-heading">Parts used in this guide</h2>



<p class="wp-block-paragraph">Prices and stock were verified live on qualityrcparts.com on 2026-11-21 through the public Store API. All three items are in stock and purchasable; the live product page is the current price.</p>



<ul class="wp-block-list">

<li><a href="https://qualityrcparts.com/product/esp32-cam-development-board-with-ov2640-camera-module-4mb-psram/">ESP32-CAM Development Board with OV2640 Camera Module, 4MB PSRAM</a> (ID 13473) &#8211; $25.99. The classic ESP32-CAM for the Micro-RTSP and Tasmota routes. No USB port; program it over UART or with an ESP32-CAM-MB carrier.</li>
<li><a href="https://qualityrcparts.com/product/esp32-s3-n16r8-cam-development-board-with-ov5640-camera-dual-usb-c-wifi-bluetooth-5/">ESP32-S3-N16R8 CAM Development Board with OV5640 Camera, Dual USB-C, WiFi + Bluetooth 5</a> (ID 19636) &#8211; $22.99. The S3 board for the esp32cam-rtsp and ESPHome routes. Two USB-C ports split OTG and serial duties; 16 MB flash plus 8 MB PSRAM.</li>
<li><a href="https://qualityrcparts.com/product/esp32-cam-wifi-board-with-esp32-cam-mb-micro-usb-carrier-ov2640-camera-module-single/">ESP32-CAM WiFi Board with ESP32-CAM-MB Micro USB Carrier, OV2640 Camera Module, Single</a> (ID 23417) &#8211; $19.99. The classic ESP32-CAM bundled with the MB carrier board, which adds a micro USB port and USB-to-serial chip.</li>

</ul>



<p class="wp-block-paragraph">Shipped fast and securely from our secure facility in Queensbury, NY. QRC ships within the USA only.</p>



<h2 class="wp-block-heading">Related guides</h2>



<ul class="wp-block-list">

<li><a href="/esp32-cam-s3-cam-camera-projects-guide/">ESP32-CAM vs ESP32-S3-CAM: Which Camera Board to Pick</a> &#8211; compare the two camera boards.</li>
<li><a href="/esp32-s3-cam-guide/">How to Use the ESP32-S3-CAM Board for Camera Projects</a> &#8211; the S3 board setup guide, including its MJPEG streaming walkthrough.</li>
<li><a href="/esp32-cam-getting-started/">How to Start with ESP32-CAM for WiFi Camera Projects</a> &#8211; first-time setup for the classic ESP32-CAM.</li>
<li><a href="/convert-analog-fpv-video-usb/">Convert Analog FPV Video to USB</a> &#8211; a different approach for analog FPV cameras.</li>

</ul>



<h2 class="wp-block-heading">FAQ</h2>



<p class="wp-block-paragraph"><strong>Does the ESP32-CAM support RTSP out of the box?</strong>
No. The stock CameraWebServer example serves MJPEG over HTTP only, with no RTSP server. Add RTSP with esp32cam-rtsp firmware, the Micro-RTSP library, Tasmota webcam firmware, or the ESPHome rtsp_server component. Source: Home Assistant community, Tasmota guide.</p>



<p class="wp-block-paragraph"><strong>What is the RTSP URL for an ESP32-CAM?</strong>
It depends on the firmware: rtsp://IP:554/mjpeg/1 for esp32cam-rtsp, rtsp://IP:8554/mjpeg/1 for Micro-RTSP and Tasmota, rtsp://IP:554/ for ESPHome. Replace IP with the camera IP from your router or serial monitor. Source: esp32cam-rtsp, Micro-RTSP, Tasmota, and ESPHome docs.</p>



<p class="wp-block-paragraph"><strong>Can I add an ESP32-CAM RTSP stream to Home Assistant?</strong>
Not through Generic Camera: its pipeline plays only H.264 and HEVC, and ESP32-CAM RTSP serves MJPEG. Feed the stream to Frigate or go2rtc instead, or use the ESPHome native camera entity. Source: ESPHome RTSP docs.</p>



<p class="wp-block-paragraph"><strong>Why does VLC say it cannot open my ESP32-CAM stream?</strong>
The usual causes are a wrong IP address, the wrong port (554 vs 8554), the wrong path (/mjpeg/1 vs the ESPHome root path), AP isolation, or a firewall blocking the RTSP port. Check the stream in VLC first, then copy that working URL into any other app. Source: Micro-RTSP and circuit.rocks docs.</p>



<p class="wp-block-paragraph"><strong>What frame rate will I get from an ESP32-CAM over RTSP?</strong>
There is no single tested number. ESPHome measured about 5 fps over WiFi and 10 over Ethernet at 640 by 480 on an ESP32-S3 with an OV5640, and the Micro-RTSP example runs about 10 fps at 800 by 600. Start at 640 by 480. Source: ESPHome and Micro-RTSP docs.</p>



<p class="wp-block-paragraph"><strong>Is RTSP better than MJPEG for an ESP32-CAM?</strong>
RTSP is better when a recorder, NVR, or detection tool needs the feed, because those tools speak RTSP and generally cannot consume an MJPEG HTTP stream. MJPEG over HTTP is better for a quick live view in a browser. Both carry the same MJPEG video, so RTSP does not improve the picture, it makes the feed usable by more software. Source: ESPHome docs, esp32cam-rtsp page.</p>



<p class="wp-block-paragraph"><strong>Can I view an RTSP stream in a web browser?</strong>
No, not directly. Browsers do not play RTSP. Use VLC or an NVR app for RTSP, the HTTP MJPEG stream at <a href="http://IP/stream">http://IP/stream</a> for a browser view, or Frigate or go2rtc between the camera and the browser. Source: circuit.rocks docs, esp32cam-rtsp page.</p>



<h2 class="wp-block-heading">Sources</h2>



<ul class="wp-block-list">

<li>esp32cam-rtsp overview: <a href="https://www.esp32.diy/esp32cam-rtsp/" target="_blank" rel="noopener">https://www.esp32.diy/esp32cam-rtsp/</a></li>
<li>esp32cam-rtsp repository: <a href="https://github.com/rzeldent/esp32cam-rtsp" target="_blank" rel="noopener">https://github.com/rzeldent/esp32cam-rtsp</a></li>
<li>Micro-RTSP library: <a href="https://github.com/geeksville/Micro-RTSP" target="_blank" rel="noopener">https://github.com/geeksville/Micro-RTSP</a></li>
<li>Micro-RTSP getting started: <a href="https://deepwiki.com/geeksville/Micro-RTSP/2-getting-started" target="_blank" rel="noopener">https://deepwiki.com/geeksville/Micro-RTSP/2-getting-started</a></li>
<li>ESP32-RTSP tutorial: <a href="https://learn.circuit.rocks/esp32-cam-with-rtsp-video-streaming" target="_blank" rel="noopener">https://learn.circuit.rocks/esp32-cam-with-rtsp-video-streaming</a></li>
<li>ESP32-RTSP source code: <a href="https://github.com/circuitrocks/ESP32-RTSP" target="_blank" rel="noopener">https://github.com/circuitrocks/ESP32-RTSP</a></li>
<li>Tasmota webcam guide: <a href="https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/" target="_blank" rel="noopener">https://cgomesu.com/blog/Esp32cam-tasmota-webcam-server/</a></li>
<li>ESPHome RTSP server: <a href="https://beta.esphome.io/components/rtsp_server/" target="_blank" rel="noopener">https://beta.esphome.io/components/rtsp_server/</a></li>
<li>Home Assistant community, ESP32-CAM into Frigate: <a href="https://community.home-assistant.io/t/adding-rtsp-stream-from-esp32-cam-into-frigate/300919/10" target="_blank" rel="noopener">https://community.home-assistant.io/t/adding-rtsp-stream-from-esp32-cam-into-frigate/300919/10</a></li>
<li>Home Assistant community, ESP32-CAM RTSP not working: <a href="https://community.home-assistant.io/t/esp32-cam-rtsp-not-working/878614" target="_blank" rel="noopener">https://community.home-assistant.io/t/esp32-cam-rtsp-not-working/878614</a></li>
<li>Espressif esp32-camera repo: <a href="https://github.com/espressif/esp32-camera" target="_blank" rel="noopener">https://github.com/espressif/esp32-camera</a></li>

</ul>



<p class="wp-block-paragraph">Last updated: 2026-11-21</p>
]]></content:encoded>
					
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">23518</post-id>	</item>
	</channel>
</rss>
