// ---------------------------------------------------------------------------
// (| " I2C_Scan.ino                                                       "|)
// (| " Este sketch permite escanear buscando dispositivos I2C conectados, "|)
// (| " localizandolos y mandando las direcciones que encuentra al Monitor "|)
// (| " serie.                                                             "|)
// (| " El objeto contiene como variables el rango de direcciones para el  "|)
// (| " escaneo Low_Address y High_Address. El objeto se inicializa a      "|)
// (| " traves del método Init().                                          "|)
// (| "                                                                    "|)
// (| " El pin SDA de la LCD 16x2 I2C va al pin A4 del Arduino UNO R3/NANO "|)
// (| " El pin SCL de la LCD 16x2 I2C va al pin A5 del Arduino UNO R3/NANO "|)
// (| "                                                                    "|)
// (| " Este código de ejemplo es de dominio público.                      "|)
// (| "                                                                    "|)
// (| " Maker/Developer: jorgechac© - Técnico Laboral en Programación UNAB "|)
// (| " Visita https://jorgechac.blogspot.com                              "|)
// (| "                                                                    "|)
// (| " Venta de accesorios Arduino/Raspberry Pi Pico/ESP32                "|)
// (| " Whatsapp y Ventas NEQUI +573177295861                              "|)
// (| " Bucaramanga - Colombia                                             "|)
// (| "                                                                    "|)
// (| " Simulación: https://wokwi.com/projects/339201035448877651          "|)
// (| " Descarga gratis este sketch en:                                    "|)
// (| " https://create.arduino.cc/editor/jorgechac/eaad38ae-3d58-4617-b151-8ce6decc2924/preview "|)
// ------------------------------------------------------------------------------------------------

#include <Wire.h>                   // Incluye la biblioteca Wire.h para la comunicación I2C

void setup()                        // La función setup() se ejecuta una vez al inicio del programa.
{
  Wire.begin();                     // Inicia la comunicación I2C
  Serial.begin(9600);               // Inicia la comunicación serial a una velocidad de 9600 baudios
  Serial.println("\nI2C Scanner");  // Imprime un mensaje indicando que el programa está iniciando
}

void loop()
{
  byte error, address;  // Declara las variables de tipo byte 'error' y 'address'
  int nDevices;         // Declara la variable de tipo int 'nDevices'

  Serial.println("Scanning...");  // Imprime un mensaje indicando que se está realizando un escaneo

  nDevices = 0;                   // Inicializa la variable 'nDevices' en cero

  for (address = 1; address < 127; address++) // Recorre todas las direcciones posibles de dispositivos I2C del 1 al 127 en hexadecimal
  {
    // I2c_scanner utiliza el valor de retorno de la Write.endTransmisstion para ver si un dispositivo reconoció la dirección.
    Wire.beginTransmission(address);  // Envía un mensaje al dispositivo en la dirección actual
    error = Wire.endTransmission();   // Verifica si el dispositivo ha respondido correctamente

    if (error == 0)                   // Si el dispositivo ha respondido correctamente....
    {
      Serial.print("Dispositivo I2C encontrado en la direccion hexadecimal 0x");  // Imprime un mensaje indicando la dirección del dispositivo encontrado
      if (address < 16)
        Serial.print("0");        // Si la dirección es menor a 16, imprime un cero adelante para formatear correctamente la dirección
      Serial.print(address, HEX); // Imprime la dirección en formato hexadecimal
      Serial.println("  !");      // Imprime un mensaje indicando que se ha encontrado un dispositivo

      nDevices++;                 // Incrementa el número de dispositivos encontrados
    }
    else if (error == 4)          // Si se ha producido un error desconocido en esa dirección
    {
      Serial.print("Unknow error at address 0x"); // Imprime un mensaje de error
      if (address < 16)
        Serial.print("0");          // Si la dirección es menor a 16, imprime un cero adelante para formatear correctamente la dirección
      Serial.println(address, HEX); // Imprime la dirección en formato hexadecimal
    }
  }
  if (nDevices == 0)                          // Si no se ha encontrado ningún dispositivo
    Serial.println("No I2C devices found\n"); // Imprime un mensaje indicando que no se han encontrado dispositivos
  else                                        // Si se ha encontrado al menos un dispositivo
    Serial.println("done\n");                 // Imprime un mensaje indicando que el escaneo ha finalizado

  delay(5000);                                // Detiene el programa durante 5 segundos antes de volver a ejecutar el ciclo loop()
}