Aprender

Um scanner I2C para Arduino e ESP32, e o que verificar quando ele não encontra nada

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um OLED e um LCD no mesmo barramento I2Cao vivo0.000 s 0.00x
Clique para abrir no editor
O Uno pergunta a cada endereço de 1 a 126 e imprime os dois que respondem, 0x27 e 0x3C.

Um scanner I2C é o primeiro sketch a rodar em qualquer montagem I2C nova. Ele pergunta a cada endereço de 1 a 126 se há um dispositivo ali e imprime os que respondem. Se o seu display, sensor ou relógio aparece, a ligação está certa e o endereço é o que você deve colocar no seu código. Se nada aparece, o problema está nos fios ou na alimentação, e nenhuma mudança no código do display vai resolver.

O circuito acima é um Arduino Uno com dois módulos comuns no barramento: um LCD 16x2 com um módulo PCF8574 e um OLED SSD1306. Ele roda o programa i2cscan do Mokxi, que verifica o barramento antes de escanear e depois imprime "barramento ocioso: SDA HIGH, SCL HIGH", "found 0x27", "found 0x3C" e "2 device(s), 126 addresses in 51 ms". Um analisador lógico está nos mesmos dois fios, decodificando cada endereço que sai.

Abaixo está o scanner simples que a maioria dos tutoriais usa, rodando em um Uno e em placas ESP32, e depois cada forma de um scan voltar vazio, feita de propósito nos mesmos dois módulos.

O sketch do scanner

Para cada endereço, o sketch inicia uma transmissão, não envia nada e a encerra. Wire.endTransmission() retorna 0 quando um dispositivo puxou o SDA para baixo no nono pulso de clock para dizer "sou eu", e 2 quando ninguém o fez. Então o scan inteiro é um laço pelos endereços e um único if. Os endereços 0 e 127 ficam de fora, porque 0 é o endereço de chamada geral e o topo da faixa é reservado.

O mesmo sketch compila para um Uno e para todas as placas ESP32 sem mudança nenhuma. Com o LCD e o OLED em A4 e A5 de um Uno, ele imprimiu "I2C scanner", depois "Found a device at 0x27", "Found a device at 0x3C" e "2 device(s) found". Com os mesmos dois módulos em GPIO 8 e 9 de um ESP32-C3, em GPIO 21 e 22 de um ESP32 DevKit e em GPIO 8 e 9 de um ESP32-S3, imprimiu os mesmos dois endereços. Ele escaneia de novo a cada cinco segundos, então você pode plugar um módulo enquanto ele roda e vê-lo aparecer.

Um scanner I2C para Arduino e ESP32
#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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Quais pinos Wire.begin() usa em cada ESP32

Wire.begin() sem argumentos usa os pinos I2C padrão da placa, e eles não são os mesmos em todo ESP32. Este é o motivo mais comum de um scan em um ESP32 não encontrar nada: os módulos estão nos pinos que um tutorial de outra placa usou. Imprimir SDA e SCL no Mokxi dá estes resultados, que são os padrões que o core do Arduino para ESP32 define para as mesmas placas: o ESP32 DevKit usa SDA 21 e SCL 22, o ESP32-S3 DevKitC e o ESP32-C3 DevKitM usam SDA 8 e SCL 9, e o mesmo vale para o ESP32-C3 SuperMini. O ESP32-C6 DevKitC usa SDA 23 e SCL 22. As placas XIAO seguem a serigrafia: SDA 6 e SCL 7 na XIAO ESP32-C3, SDA 22 e SCL 23 na XIAO ESP32-C6.

Colocamos os dois módulos em GPIO 8 e 9 de um ESP32-C6, os pinos do C3, e o scan imprimiu "No I2C devices found". Em um ESP32-C3 com os módulos em GPIO 4 e 5, imprimiu o mesmo. Nada estava errado com nenhum dos módulos. Mudando uma linha para Wire.begin(4, 5);, que indica o SDA primeiro e o SCL depois, o C3 encontrou 0x27 e 0x3C de novo. Quaisquer dois pinos GPIO livres podem carregar I2C em um ESP32, então na dúvida, indique-os.

No C3 SuperMini, o GPIO 8 também aciona o LED azul da placa e o GPIO 9 é o botão BOOT. No Mokxi, um scan nos pinos 8 e 9 de um SuperMini ainda encontra os dois módulos. Se um SuperMini seu se comportar de forma estranha com I2C nesses dois pinos, mova o barramento para outros dois com Wire.begin(sda, scl) e verifique de novo.

Não encontra nada: SDA e SCL trocados

Troque os dois fios do barramento no Uno, de modo que o SDA dos módulos vá para A5 e o SCL deles para A4, e o scan imprime "No I2C devices found". Todo módulo continua alimentado, continua no seu endereço e ainda tem seus pull-ups. Ele simplesmente nunca vê uma condição de início que reconheça, porque a linha que ele lê como clock está carregando dados. Nada se danifica. Troque de volta e os dois endereços retornam.

Confira os rótulos no próprio módulo em vez de um desenho. Alguns breakouts imprimem SDA antes de SCL e outros ao contrário, e os quatro pinos de um módulo de LCD ficam em uma ordem diferente dos quatro de um OLED.

Encontra um dispositivo mas não o outro: alimentação e terra

Tire o fio de VCC do módulo do LCD e rode o scan de novo. Ele imprime "Found a device at 0x3C" e "1 device(s) found": o OLED ainda responde e o módulo, sem alimentação, não. Tire os fios de terra dos dois módulos e ele imprime "No I2C devices found". Um módulo precisa de VCC e GND além dos dois fios do barramento, então verifique os quatro em cada módulo, não apenas os dois que carregam dados.

Uma coisa que isso não mostra: o Mokxi não verifica a tensão de alimentação de um módulo. O módulo alimentado pelo pino de 3,3 V de um C3 ainda respondeu em 0x27 aqui. Na bancada, a maioria dos LCDs 16x2 são componentes de 5 V e ficam apagados ou em branco com 3,3 V, então alimente o módulo pelo pino de 5 V da placa. Os pull-ups dele então mantêm SDA e SCL em 5 V, o que é mais do que os pinos de um ESP32 suportam. Um pequeno conversor de nível de I2C entre os dois é a solução segura.

Pull-ups, e o que a simulação deixa de fora

As linhas I2C nunca são acionadas para cima. Cada dispositivo só puxa uma linha para baixo ou solta, e resistores para a alimentação a trazem de volta para cima. Quase todo breakout carrega seu próprio par, e é por isso que o OLED e o LCD aqui funcionam sem mais nada na protoboard. Um chip puro não tem nenhum. Colocamos um PCF8574 puro no Uno sem resistores e ele ainda respondeu em 0x20, e o mesmo em um ESP32-C3, porque o Wire de ambas as placas ativa os pull-ups internos fracos do chip.

O Mokxi não modela capacitância do barramento nem tempos de subida. Um barramento com pull-ups fracos, fios longos ou muitos módulos funciona aqui mesmo onde falha numa bancada, então se o seu scan encontra um dispositivo só de vez em quando, adicione resistores de 4,7 k de SDA e SCL para a alimentação e mantenha os fios curtos. Para saber como os pull-ups e o acknowledge funcionam, e por que dois dispositivos no mesmo endereço parecem um só, veja o explicativo de I2C.

Encontra o dispositivo, mas a tela fica em branco

Então o barramento está bom e a falha está no sketch. Coloque o endereço que o scanner imprimiu no construtor, como LiquidCrystal_I2C lcd(0x27, 16, 2); ou display.begin(SSD1306_SWITCHCAPVCC, 0x3C), e chame o init() ou begin() da biblioteca antes de imprimir. Um módulo que responde em 0x3F em vez de 0x27 é a surpresa mais comum; o guia de LCD abaixo passa por todos os sintomas de um display em branco.

Abra este circuito no editor. Arduino Uno: um OLED e um LCD no mesmo barramento I2C, ligados como aparece no topo desta página. Mude um componente ou um valor e rode de novo.

Perguntas

Qual endereço um LCD I2C 16x2 usa?

Normalmente 0x27 para um módulo com o chip PCF8574 e 0x3F para o PCF8574A, mas jumpers no módulo podem mudá-lo. Rode o scanner e use o endereço que ele imprimir.

Qual é o endereço I2C de um OLED SSD1306?

A maioria dos módulos 128x64 e 128x32 responde em 0x3C, e alguns vêm configurados em 0x3D. O scan do circuito desta página encontra o OLED em 0x3C.

Por que meu scanner I2C no ESP32 não encontra nada?

Na maioria das vezes os módulos ficam em pinos diferentes dos padrões da placa: 21 e 22 no ESP32 DevKit, 8 e 9 no S3 e no C3, 23 e 22 no C6. Nomeie seus pinos com Wire.begin(sda, scl). Depois verifique se SDA e SCL não estão trocados e se cada módulo tem alimentação e terra.

O que o scanner imprime com nada no barramento?

Em um Uno no Mokxi ele imprime "No I2C devices found". Um scan que em vez disso encontra todos os endereços, ou trava, está avisando que uma linha está sendo mantida em nível baixo, geralmente por um curto, um módulo ligado ao contrário ou um pull-up faltando.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.