Guía para usar el ESP32-CAM en escaneo de códigos QR

¡Hola equipo! Bienvenidos a Ingtelecto Pro. Hoy vamos a llevar el módulo ESP32-CAM al límite.

Seguramente has visto proyectos de videovigilancia, pero... ¿sabías que el ESP32 tiene suficiente potencia bruta para procesar imágenes en tiempo real y decodificar información? Hoy vamos a construir un Lector de Códigos QR totalmente autónomo.

Este proyecto es ideal para sistemas de control de asistencia, abrir puertas automáticamente o validar tickets. Y lo mejor: resolveremos los 3 problemas clásicos que hacen que la gente abandone este proyecto (Enfoque, Memoria y Partición). ¡Vamos a escanear! 📸🔍

Materiales Necesarios

Fundamentos Técnicos y "El Secreto del Enfoque"

Antes de programar, tenemos que arreglar un problema de hardware que afecta al 99% de las ESP32-CAM nuevas.

🔧 El Truco del Enfoque (Macro)

Para que esto funcione, necesitas modificar la lente:

1. Mira el lente de la cámara. Tiene un pegamento rojo o transparente en la rosca para que no se mueva.
2. Con mucho cuidado (y un cutter o bisturí), raspa ese pegamento para liberar la rosca.
3. Gira la lente lentamente en sentido anti-horario (hacia la izquierda) unos 10-20 grados.
4. Abre el ejemplo de "Camera Web Server" para ver el video en tu PC y ajusta hasta que veas nítido un objeto a 10cm.

Configuración del Entorno (Arduino IDE)

Este código es pesado. Si usas la configuración estándar, Arduino te dirá que "El sketch es muy grande". Sigue estos pasos:

1. Selecciona la placa: AI Thinker ESP32-CAM.
2. Ve a Herramientas > Partition Scheme.
3. Cambia "Default 4MB" por "Huge APP (3MB No OTA/1MB SPIFFS)".
4. Esto libera espacio reservado para actualizaciones inalámbricas y se lo da a tu programa. ¡Vital!

Instalación de la Librería QR

Usaremos la librería más eficiente, creada por Alvaro Viebrantz. No está en el gestor automático, así que haremos una instalación manual rápida:

1. Descarga la librería desde este Repositorio de GitHub (ZIP).
2. En Arduino IDE, ve a Programa > Incluir Librería > Añadir biblioteca .ZIP.
3. Selecciona el archivo que bajaste.

El Código del Escáner

Este código configura la cámara y utiliza el **Núcleo 1** del ESP32 exclusivamente para procesar video, dejando el Núcleo 0 libre para WiFi o Bluetooth.

#include

#include
// Definimos el modelo de cámara

ESP32QRCodeReader reader(CAMERA_MODEL_AI_THINKER);
// --- TAREA DE PROCESAMIENTO QR ---

// Esta función se ejecuta en paralelo en un núcleo dedicado

void onQrCodeTask(void *pvParameters) {

struct QRCodeData qrCodeData;
while (true) {

// Intentar leer QR con una calidad de 100 (máxima)

if (reader.receiveQrCode(&qrCodeData, 100)) {

Serial.println("✅ ¡Código QR Encontrado!");
if (qrCodeData.valid) {

// Imprimir el contenido (URL, Texto, etc.)

Serial.print("Contenido: ");

Serial.println((const char *)qrCodeData.payload);

} else {

Serial.print("❌ Inválido: ");

Serial.println((const char *)qrCodeData.payload);

}

}

// Pequeña pausa para no saturar el procesador

vTaskDelay(100 / portTICK_PERIOD_MS);

}

}
void setup() {

Serial.begin(115200);

Serial.println("\n--- Iniciando Lector QR ESP32 ---");
// Configuración inicial de la cámara

reader.setup();
Serial.println("Cámara iniciada. Arrancando tarea en Núcleo 1...");
// Iniciar el lector en el Core 1 (Multitasking)

reader.beginOnCore(1);
// Crear la tarea que procesa las imágenes

xTaskCreate(onQrCodeTask, "onQrCode", 4 * 1024, NULL, 4, NULL);

}
void loop() {

// El loop queda vacío porque todo ocurre en la tarea onQrCodeTask

// Aquí podrías poner un LED parpadeando o control de WiFi

delay(100);

}

Análisis del Código

• reader.setup(): Inicializa el sensor OV2640. Si falla aquí, revisa que la cámara esté bien conectada en su zócalo.
• reader.beginOnCore(1): El ESP32 tiene dos cerebros (núcleos). Aquí le decimos: "Dedícate a analizar imágenes en el Cerebro 1 sin interrupciones".
• qrCodeData.payload: Aquí es donde se guarda el texto que estaba oculto en el QR.

Prueba y Solución de Problemas

Sube el código (recuerda presionar el botón de Reset en la placa cuando empiece a cargar si no usas la base MB). Abre el Monitor Serie a **115200 baudios**.

Conclusión