¿Cuántas veces has tenido que apagar un proyecto, sacar la microSD con las uñas, buscar un lector de tarjetas y recién ahí mirar qué registró? Este proyecto elimina ese ritual: una placa ESP32-S3 guarda cada evento con fecha y hora en un archivo de texto dentro de su microSD y, cuando quieres revisarlo, la misma placa se presenta ante tu computador como si fuera un pendrive. Abres log.txt desde el explorador de archivos y listo, sin tocar la tarjeta.
El evento que se registra es la pulsación de un botón, porque así el foco queda en la parte interesante: el sistema de archivos FAT, la sincronización de hora por NTP y la clase USB Mass Storage (USB MSC). Al terminar vas a saber montar una microSD con SD_MMC, escribir registros sin pisar los anteriores, exponer la tarjeta por USB nativo y, como extra de esta versión, ajustar la hora a Chile y cambiar el botón por un sensor DHT22.
Concepto: dos modos que nunca se cruzan
La idea central es simple pero tiene una restricción dura. El ESP32-S3 y el computador no pueden escribir en la misma tarjeta al mismo tiempo. FAT no tiene ningún mecanismo para coordinar dos escritores: cada uno mantiene en memoria su propia copia de la tabla de asignación (FAT) y del directorio, y si ambos escriben, el segundo sobrescribe los cambios del primero sin saberlo. El resultado típico es un log.txt con el tamaño equivocado, clusters perdidos o una tarjeta que Windows pide "reparar".
Por eso el firmware funciona en uno de dos modos, y solo en uno a la vez:
- Modo registro (por defecto): el ESP32 es dueño de la tarjeta. Cada pulsación enciende el LED RGB en verde durante un segundo y agrega una línea con fecha y hora a
log.txt. - Modo unidad USB: el ESP32 deja de usar el sistema de archivos y le entrega la tarjeta, sector por sector, al computador. El LED queda en azul tenue.
Para cambiar de modo mantienes presionado el botón BOOT de la placa durante dos segundos. El modo elegido se guarda en la memoria no volátil con la librería Preferences y la placa se reinicia, así que el cambio sobrevive a un corte de energía.
| Elemento | Cómo se resuelve |
|---|---|
| Placa | ESP32-S3-WROOM CAM (ranura microSD integrada y puerto USB nativo) |
| Almacenamiento | microSD en FAT32, leída con SD_MMC en modo de 1 bit |
| Marca de tiempo | Hora NTP por WiFi (el original usa la hora de India; abajo la cambias a Chile) |
| Acceso desde el PC | USB Mass Storage Class sobre el puerto USB nativo |
| Cambio de modo | Botón BOOT presionado 2 segundos |
Hardware: por qué esta placa y qué puerto usar
Se eligió la ESP32-S3-WROOM CAM porque trae la ranura microSD soldada y cableada al periférico SD/MMC del chip. Eso ahorra el módulo lector externo y, además, permite usar SD_MMC en vez de SPI, que es más rápido y deja libres los pines del bus SPI.
El detalle que más confunde es que la placa tiene dos conectores USB-C. Uno pasa por un chip conversor USB a UART y solo sirve para programar y ver el monitor serial. El otro va directo a los pines USB del ESP32-S3 (GPIO19 y GPIO20) y es el único capaz de comportarse como dispositivo USB: pendrive, teclado HID, interfaz MIDI. Para este proyecto programas por el puerto UART y conectas el puerto nativo al computador cuando quieras leer la tarjeta.

La lista de materiales es corta:

- Placa ESP32-S3-WROOM CAM, idealmente la variante N16R8 (16 MB de flash y 8 MB de PSRAM).
- Tarjeta microSD de 32 GB o menos, formateada en FAT32.
- Un pulsador de 4 pines.
- Protoboard y cables macho macho.
- Cable USB-C de datos (no uno que solo carga).
El cableado es mínimo: una pata del pulsador va al GPIO14 y la otra a GND. No necesitas resistencia externa porque el código activa el pull up interno (INPUT_PULLUP), así que el pin lee HIGH en reposo y LOW al presionar. El modo se cambia con el botón BOOT, que ya está en la placa conectado al GPIO0.

Software: configuración del IDE y librerías
Antes de compilar, en el menú Herramientas del Arduino IDE (núcleo Arduino ESP32 3.x) configura:
- Placa: ESP32S3 Dev Module
- USB Mode: USB OTG (TinyUSB). Sin esto la clase MSC no existe.
- USB CDC On Boot: Disabled, para que el puerto nativo quede libre para el pendrive y el monitor serial siga saliendo por el puerto UART.
- Flash Size: 16MB (o el de tu placa) y PSRAM: OPI PSRAM.
Todas las librerías vienen con el núcleo del ESP32, no hay que instalar nada:
#include <WiFi.h>
#include <time.h>
#include <Preferences.h>
#include "USB.h"
#include "USBMSC.h"
#include "SD_MMC.h"
WiFi.h y time.h obtienen y formatean la hora; Preferences.h recuerda el modo entre reinicios; USB.h y USBMSC.h levantan el puerto nativo como unidad de almacenamiento, y SD_MMC.h habla con la tarjeta por el bus SD/MMC.
Pines
#define SD_CLK_PIN 39
#define SD_CMD_PIN 38
#define SD_D0_PIN 40
#define LED_PIN 48
#define BUTTON_PIN 14
#define MODE_PIN 0
CLK, CMD y D0 son las tres líneas que usa el bus SD en modo de 1 bit (en modo de 4 bits harían falta D1 a D3). En la Freenove ESP32-S3-WROOM CAM están en los GPIO39, 38 y 40; si tu placa es de otro fabricante, revisa su esquemático, porque es lo primero que falla. LED_PIN es el LED RGB WS2812 integrado en el GPIO48, que se controla con neopixelWrite() sin librerías extra.
El LED funciona como panel de estado: verde por cada registro, azul tenue en modo unidad USB, rojo si falla la tarjeta o todavía no hay hora, ámbar mientras sincroniza y un destello blanco al cambiar de modo.
Escribir sin borrar lo anterior
void logLedEvent() {
String line = timestamp() + " IST - LED turned ON";
File f = SD_MMC.open("/log.txt", FILE_APPEND);
if (!f) {
Serial.println("Cannot open /log.txt");
return;
}
f.println(line);
f.close();
}
La clave es FILE_APPEND: abre el archivo y posiciona la escritura al final, así cada pulsación suma una línea en vez de reemplazar el contenido. Cerrar con f.close() después de cada línea parece ineficiente, pero es lo que garantiza que el dato llegue a la tarjeta: si cortas la energía con el archivo abierto, lo que estaba en el búfer se pierde. Para un registro cada pocos segundos es el compromiso correcto.
Entregarle la tarjeta al computador
Cuando el computador pide leer o escribir, lo hace por sectores (bloques de 512 bytes identificados por su número, el LBA). Las funciones onRead y onWrite del sketch traducen esas peticiones a SD_MMC.readRAW() y SD_MMC.writeRAW(), que acceden a la tarjeta en crudo, sin pasar por el sistema de archivos del ESP32. Eso es justamente lo que permite que el computador administre FAT por su cuenta.
MSC.onRead(onRead);
MSC.onWrite(onWrite);
MSC.onStartStop(onStartStop);
MSC.mediaPresent(true);
MSC.begin(
SD_MMC.numSectors(),
SD_MMC.sectorSize()
);
USB.begin();
MSC.begin() le informa al computador cuántos sectores tiene la tarjeta y de qué tamaño, y USB.begin() arranca el puerto nativo. Desde ese momento el sistema operativo ve una unidad extraíble más.
Cambio de modo
void toggleModeAndRestart() {
prefs.putBool("usb", !usbMode);
ESP.restart();
}
Invierte el valor guardado y reinicia. Reiniciar en lugar de cambiar "en caliente" es una decisión de diseño acertada: garantiza que el sistema de archivos del ESP32 queda desmontado por completo antes de que el computador toque la tarjeta.
El sketch completo, con la sincronización NTP con reintentos y el antirrebote del botón, está más abajo y en el repositorio de GitHub enlazado en Recursos.
Pruebas
Modo registro. Energiza la placa y abre el monitor serial a 115200 baudios por el puerto UART. Vas a ver que conecta al WiFi, espera la hora NTP y monta la tarjeta. Si es la primera vez, crea log.txt con un encabezado. Un destello verde corto indica que está lista. Presiona el pulsador varias veces: cada vez el LED se pone verde un segundo y aparece la línea registrada en el monitor serial.

Si el LED se pone rojo al presionar, la placa todavía no tiene hora válida y la pulsación no se registra. Es intencional: el código no inventa una hora de respaldo y reintenta la sincronización cada 20 segundos.
Modo unidad USB. Mantén presionado BOOT dos segundos. La placa destella en blanco, se reinicia y el LED queda en azul tenue. Conecta el puerto USB nativo al computador y la microSD aparece como una unidad nueva. Abre log.txt y vas a ver todas las pulsaciones con su fecha y hora.

Antes de volver al modo registro, expulsa la unidad desde el sistema operativo y recién ahí mantén BOOT otra vez. Si te saltas la expulsión, el computador puede no haber terminado de escribir su caché y la tabla FAT queda a medias.
Errores comunes y cómo resolverlos
- "SD card mount failed" con el LED rojo apenas enciende: revisa que la tarjeta esté en FAT32 y que los pines CLK/CMD/D0 correspondan a tu placa. Las tarjetas SDXC de 64 GB o más vienen en exFAT de fábrica y
SD_MMCno las monta: reformatéalas en FAT32 o usa una de 32 GB o menos. - El computador no detecta la unidad: casi siempre es el puerto equivocado (estás en el UART) o un cable que solo carga. También revisa que USB Mode esté en USB OTG (TinyUSB).
- Nunca sincroniza la hora: el ESP32-S3 solo se conecta a redes de 2,4 GHz. Si tu router mezcla 2,4 y 5 GHz con el mismo nombre, crea una red separada para tus proyectos.
- Windows crea una carpeta "System Volume Information" en la tarjeta: es normal y no afecta el registro.
Variantes y mejoras
Hora de Chile en vez de la de India. El sketch original usa TZ_INFO = "IST-5:30". Para Chile continental, con su cambio de horario, reemplázalo por la regla POSIX equivalente a America/Santiago: "<-04>4<-03>,M9.1.6/24,M4.1.6/24". Esa cadena dice que el horario estándar es UTC-4, el de verano UTC-3, que el cambio a verano ocurre el primer sábado de septiembre a las 24:00 y el regreso el primer sábado de abril a la misma hora. Con eso configTzTime() aplica solo el cambio de horario dos veces al año, sin tocar el código. Ojo: la función logLedEvent() escribe el texto " IST - LED turned ON" fijo; cámbialo por " CLT - " o simplemente quítalo. Si vives en Magallanes, que mantiene UTC-3 todo el año, usa "<-03>3".
Registrar temperatura y humedad con un DHT22. El pulsador es solo un disparador. Conecta un DHT22 a un GPIO libre (con una resistencia pull up de 10 kΩ en la línea de datos si tu sensor no viene en módulo), y en el loop() reemplaza la lectura del botón por un temporizador que cada 60 segundos lea temperatura y humedad y escriba una línea tipo 2026-11-18 09:30:00;21.4;58.2. Con punto y coma como separador, el archivo se abre directo en Excel o LibreOffice con la configuración regional chilena (que usa la coma para los decimales en las celdas). Respeta la misma lógica de FILE_APPEND y de no registrar sin hora válida.
Registro sin WiFi con un RTC DS3231. Si el logger va a vivir en un invernadero o una bodega sin red, la hora NTP solo se obtiene al encender. Un módulo RTC DS3231 con su pila de botón mantiene la hora con una deriva de un par de minutos al año: sincronízalo por NTP cuando haya red y léelo por I2C el resto del tiempo.
Otras placas. Si no consigues la versión CAM, cualquier ESP32-S3 con puerto USB nativo sirve combinada con un lector microSD SPI, pero cambia el código: SD_MMC pasa a SD (librería SD sobre SPI), que también ofrece readRAW() y writeRAW() para los callbacks de MSC. Un ESP32 clásico (WROOM-32) no sirve para la parte del pendrive, porque no tiene USB nativo.
Personalización para Chile
En Chile consigues casi todo lo necesario en MechatronicStore:
- Micro SD tarjeta de memoria 16gb (SKU B-450V3): guarda
log.txt. Viene en FAT32, el formato que pideSD_MMC, y 16 GB alcanzan para años de registros de texto. Si prefieres más espacio, la de 32 GB (SKU B-450) sigue siendo FAT32; evita la de 64 GB para este proyecto porque viene en exFAT. - Botón pulsador switch cuadrado de 4 pines 12x12x7mm (SKU GC3-2): el disparador del registro, entre el GPIO14 y GND.
- Breadboard / Protoboard 830 puntos MB102 (SKU C-302): base para montar la placa y el pulsador sin soldar.
- Cables macho macho 40 piezas 20cm (SKU C-411): las conexiones del pulsador.
- Cable USB Tipo C a USB Tipo A 1mt (SKU B-101): para programar por el puerto UART y luego leer la tarjeta por el puerto nativo. Es de datos, no solo de carga.
La placa ESP32-S3-WROOM CAM es el único componente que hoy no está en el catálogo; se consigue con facilidad en tiendas de importación. Si el tutorial original habla de "pen drive", en Chile es lo que llamamos pendrive.
Recursos
- Tutorial original (inglés, Circuit Digest): ESP32 Data Logger: SD Card Logging + USB Drive Access. Esta versión está basada en él, con hora de Chile, diagnóstico de errores y variantes nuevas.
- Repositorio GitHub: Circuit Digest/ESP32-FATFS
- Archivos descargables: Código completo (.zip)
- Documentación adicional: USB MSC en Arduino ESP32 y Librería SD_MMC
Versión chilena con componentes en stock local en MechatronicStore.









