Un escáner I2C para Arduino y ESP32, y qué revisar cuando no encuentra nada
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Un escáner I2C es el primer sketch que debes ejecutar en cualquier proyecto nuevo con I2C. Pregunta en cada dirección, de la 1 a la 126, si hay un dispositivo ahí e imprime los que responden. Si tu pantalla, sensor o reloj aparece, el cableado está bien y esa es la dirección que debes poner en tu código. Si no aparece nada, el problema son los cables o la alimentación, y ningún cambio en el código de la pantalla lo va a arreglar.
El circuito de arriba es un Arduino Uno con dos módulos comunes en su bus: una LCD 16x2 con un módulo PCF8574 y una OLED SSD1306. Ejecuta el programa i2cscan de Mokxi, que revisa el bus antes de escanear y luego imprime "bus inactivo: SDA en HIGH, SCL en HIGH", "encontrado 0x27", "encontrado 0x3C" y "2 dispositivo(s), 126 direcciones en 51 ms". Un analizador lógico está conectado a los mismos dos cables, decodificando cada dirección que sale.
Abajo está el escáner sencillo que usan la mayoría de los tutoriales, ejecutado en un Uno y en placas ESP32, y después cada caso en que un escaneo no encuentra nada, hecho a propósito con los mismos dos módulos.
El sketch del escáner
Para cada dirección, el sketch inicia una transmisión, no envía nada y la termina. Wire.endTransmission() devuelve 0 cuando un dispositivo puso SDA en bajo en el noveno pulso de reloj para decir "aquí estoy", y 2 cuando nadie lo hizo. Así que todo el escaneo es un ciclo sobre las direcciones y un solo if. Las direcciones 0 y 127 se dejan fuera, porque 0 es la dirección de llamada general y el tope del rango está reservado.
El mismo sketch se compila para un Uno y para todas las placas ESP32 sin cambios. Con la LCD y la OLED en A4 y A5 de un Uno imprimió "I2C scanner", luego "Found a device at 0x27", "Found a device at 0x3C" y "2 device(s) found". Con los mismos dos módulos en GPIO 8 y 9 de un ESP32-C3, en GPIO 21 y 22 de un ESP32 DevKit y en GPIO 8 y 9 de un ESP32-S3, imprimió las mismas dos direcciones. Vuelve a escanear cada cinco segundos, así que puedes conectar un módulo mientras corre y ver cómo aparece.
#include <Wire.h>
void setup() {
Serial.begin(115200);
Wire.begin();
Serial.println("I2C scanner");
}
void loop() {
int found = 0;
for (byte address = 1; address < 127; address++) {
Wire.beginTransmission(address);
byte error = Wire.endTransmission();
if (error == 0) {
Serial.print("Found a device at 0x");
if (address < 16) Serial.print("0");
Serial.println(address, HEX);
found++;
}
}
if (found == 0) {
Serial.println("No I2C devices found");
} else {
Serial.print(found);
Serial.println(" device(s) found");
}
delay(5000);
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Qué pines usa Wire.begin() en cada ESP32
Wire.begin() sin argumentos usa los pines I2C predeterminados de la placa, y no son los mismos en todos los ESP32. Esta es la razón más común por la que un escaneo en ESP32 no encuentra nada: los módulos están en los pines que usaba un tutorial para otra placa. Imprimir SDA y SCL en Mokxi da estos valores, que son los predeterminados que el núcleo de Arduino para ESP32 asigna a las mismas placas: el ESP32 DevKit usa SDA 21 y SCL 22, el ESP32-S3 DevKitC y el ESP32-C3 DevKitM usan SDA 8 y SCL 9, y lo mismo el ESP32-C3 SuperMini. El ESP32-C6 DevKitC usa SDA 23 y SCL 22. Las placas XIAO siguen su serigrafía: SDA 6 y SCL 7 en la XIAO ESP32-C3, SDA 22 y SCL 23 en la XIAO ESP32-C6.
Pusimos los dos módulos en GPIO 8 y 9 de un ESP32-C6, los pines del C3, y el escaneo imprimió "No I2C devices found". En un ESP32-C3 con los módulos en GPIO 4 y 5 imprimió lo mismo. Ninguno de los dos módulos estaba dañado. Cambiando una línea por Wire.begin(4, 5);, que indica primero SDA y después SCL, el C3 volvió a encontrar 0x27 y 0x3C. Cualquier par de pines GPIO libres puede llevar I2C en un ESP32, así que ante la duda, indícalos.
En el C3 SuperMini, el GPIO 8 también controla el LED azul integrado y el GPIO 9 es el botón BOOT. En Mokxi, un escaneo en 8 y 9 de un SuperMini igual encuentra ambos módulos. Si un SuperMini tuyo se comporta de forma extraña con I2C en esos dos pines, mueve el bus a otros dos con Wire.begin(sda, scl) y vuelve a revisar.
No encuentra nada: SDA y SCL intercambiados
Intercambia los dos cables del bus en el Uno, de modo que el SDA de los módulos vaya a A5 y su SCL a A4, y el escaneo imprime "No I2C devices found". Todos los módulos siguen alimentados, siguen en su dirección y siguen teniendo sus pull-ups. Simplemente nunca ve una condición de inicio que reconozca, porque la línea que lee como reloj está llevando datos. Nada se daña. Vuelve a intercambiarlos y ambas direcciones regresan.
Revisa las etiquetas del módulo mismo y no un dibujo. Algunos breakouts imprimen SDA antes de SCL y otros al revés, y los cuatro pines de un backpack de LCD están en un orden distinto al de los cuatro de un OLED.
Encuentra un dispositivo pero no el otro: alimentación y tierra
Quita el cable de VCC del backpack del LCD y ejecuta el escaneo de nuevo. Imprime "Found a device at 0x3C" y "1 device(s) found": el OLED sigue respondiendo y el backpack, sin alimentación, no. Quita los cables de tierra de ambos módulos e imprime "No I2C devices found". Un módulo necesita VCC y GND además de los dos cables del bus, así que revisa los cuatro en cada módulo, no solo los dos que llevan datos.
Algo que esto no muestra: Mokxi no revisa el voltaje de alimentación de un módulo. El backpack alimentado desde el pin de 3.3 V de un C3 siguió respondiendo en 0x27 aquí. En un escritorio, la mayoría de los LCD 16x2 son componentes de 5 V y se ven tenues o en blanco con 3.3 V, así que alimenta el backpack desde el pin de 5 V de la placa. Sus pull-ups entonces mantienen SDA y SCL en 5 V, que es más de lo que soportan los pines de un ESP32. Un pequeño nivelador de voltaje para I2C entre ambos es la solución segura.
Pull-ups y lo que la simulación omite
Las líneas de I2C nunca se impulsan a nivel alto. Cada dispositivo solo baja una línea a nivel bajo o la suelta, y unas resistencias hacia la alimentación la suben de nuevo. Casi todo breakout trae su propio par, por eso el OLED y el LCD de aquí funcionan sin nada más en la protoboard. Un chip suelto no tiene ninguno. Pusimos un PCF8574 suelto en el Uno sin resistencias y aun así respondió en 0x20, y lo mismo en un ESP32-C3, porque el Wire de ambas placas activa los pull-ups internos débiles del chip.
Mokxi no modela la capacitancia del bus ni los tiempos de subida. Un bus con pull-ups débiles, cables largos o muchos módulos funciona aquí incluso donde falla en un banco de trabajo, así que si tu escaneo encuentra un dispositivo solo a veces, agrega resistencias de 4.7 k de SDA y SCL hacia la alimentación y mantén los cables cortos. Para saber cómo funcionan los pull-ups y el acknowledge, y por qué dos dispositivos en una dirección parecen uno, consulta la guía de I2C.
Encuentra el dispositivo, pero la pantalla queda en blanco
Entonces el bus está bien y la falla está en el sketch. Pon la dirección que imprimió el escáner en el constructor, como LiquidCrystal_I2C lcd(0x27, 16, 2); o display.begin(SSD1306_SWITCHCAPVCC, 0x3C), y llama al init() o begin() de la biblioteca antes de imprimir. Un backpack que responde en 0x3F en lugar de 0x27 es la sorpresa habitual; la guía de LCD de abajo repasa todos los síntomas de una pantalla en blanco.
Abre este circuito en el editor. Arduino Uno: un OLED y un LCD en un solo bus I2C, cableado como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Preguntas
¿Qué dirección usa un LCD 16x2 con I2C?
Normalmente 0x27 para un backpack con el chip PCF8574 y 0x3F para el PCF8574A, pero los jumpers del backpack pueden moverla. Ejecuta el escáner y usa la dirección que imprime.
¿Cuál es la dirección I2C de un OLED SSD1306?
La mayoría de los módulos 128x64 y 128x32 responden en 0x3C, y algunos están configurados en 0x3D. El escaneo del circuito de esta página encuentra su OLED en 0x3C.
¿Por qué mi escáner I2C de ESP32 no encuentra nada?
La mayoría de las veces los módulos están en pines distintos de los predeterminados de la placa: 21 y 22 en una ESP32 DevKit, 8 y 9 en la S3 y la C3, 23 y 22 en la C6. Nombra tus pines con Wire.begin(sda, scl). Después verifica que SDA y SCL no estén invertidos y que cada módulo tenga alimentación y tierra.
¿Qué imprime el escáner sin nada en el bus?
En un Uno en Mokxi imprime "No I2C devices found". Un escaneo que en cambio encuentra todas las direcciones, o se queda colgado, te dice que una línea está en nivel bajo, normalmente por un corto, un módulo conectado al revés o una pull-up que falta.
Sigue así
De dónde vienen los datos de esta página
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.