/**
 * Conceito do código obtido do site
 * https://create.arduino.cc/projecthub/abdularbi17/how-to-scan-i2c-address-in-arduino-eaadda 
 * e adaptado e melhorado por James Owens <jjo(at)arduando.com.br> em Novembro de 2022.
 *
 * Arquivo:     EscaneadorI2C.ino
 * Criado em:   16/11/2022 12:34
 * Versão:
 * Fonte:       https://github.com/jjjowens/Arduando/tree/master/EscaneadorI2C
 * Website:     https://arduando.com.br
 *
 * Descrição: Escaneia todas as 128 portas possíveis para a interface
 * I2C. Se um dispositivo for encontrado, o endereço é apresentado. Em caso 
 * de erro, a respectiva mensagem é apresentada. 
 *
 * DISCLAIMER:
 * The author is in no way responsible for any problems or damage caused by
 * using this code. Use at your own risk.
 *
 * LICENSE:
 * This code is distributed under the GNU Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version.
 * More details can be found at http://www.gnu.org/licenses/gpl.txt
 */

#include <Wire.h>

void setup()
{
    Wire.begin();
    Serial.begin(9600);
    while (!Serial) yield();    // Aguarda inicialização da porta serial
    EscaneadorI2C();
}

void loop()
{
}

/**
 * Finalidade: escanear todas as 111 portas possíveis para a interface
 * I2C na plataforma Arduino. Se um dispositivo for encontrado,
 * o endereço é apresentado. Em caso de erro, a respectiva mensagem
 * é apresentada.
 *
 * Para executar, compile e chame esta função a partir do
 * seu código de loop, e faça o upload para o seu kit Arduino.
 *
 * Testado em:  Arduino UNO
 */
void EscaneadorI2C(void)
{
    uint8_t errorCode;
    uint8_t deviceAddress;
    uint8_t deviceCounter = 0;
    bool printAddress = true;

    Serial.println("Escaneador de portas I2C");
    Serial.println("Pesquisando...");
    
    // São 127 endereços possíveis, de 0x00 a 0x7F
    for (deviceAddress = 8; deviceAddress < 120; deviceAddress++)
    {
        Wire.beginTransmission(deviceAddress);
        errorCode = Wire.endTransmission();

        // Códigos de erro definidos em twi.c da biblioteca Wire 
        switch (errorCode)
        {
        case 0:
            Serial.print("Um dispositivo I2C foi encontrado no endereço ");
            deviceCounter++;
            break;
        case 1:
            Serial.print("Erro: Os dados excedem a capacidade do buffer (32 bytes) ao ler o endereço ");
            break;
        case 2:
            // Ignorado para simplificar a leitura dos resultados
            //Serial.print("Nenhum dispositivo foi encontrado no endereço ");
            printAddress = false;
            break;
        case 3:
            Serial.print("Um dispositivo foi encontrado neste endereço, mas não está respondendo ");
            break;
        case 4:
            Serial.print("Erro: algum outro problema foi detectado (perda de arbitração do bus, erro no bus, etc) no endereço ");
            break;
        case 5:
            Serial.print("Erro: timeout no endereço ");
            break;
        default:
            Serial.print("Erro: um erro desconhecido ocorreu ao indagar o endereço ");
        }
        if (printAddress)
        {
            Serial.print("0x");
            if (deviceAddress <= 0xF)
                Serial.print("0");
            Serial.println(deviceAddress, HEX);
        }
        else printAddress = true;
    }

    if (deviceCounter == 0)
        Serial.println("Nenhum dispositivo I2C foi detectado.");
    else {
        Serial.print("Foram encontrados ");
        Serial.print(deviceCounter);
        Serial.println(" dispositivos I2C.");
    }
    Serial.println("fim!");
}