Comunicación Inalámbrica

Protocolo Híbrido de Comunicación

GITAF PRO no depende de una sola tecnología. Para lograr el equilibrio perfecto entre control de usuario y rendimiento en campo, el sistema implementa una arquitectura de red híbrida.

Comparativa de Tecnologías Utilizadas

Arquitectura de Red Lógica

El flujo de información es bidireccional, pero asimétrico. El Maestro orquesta el tráfico para evitar colisiones.

graph LR
    subgraph "Control Remoto"
    App[App Android]
    end

    subgraph "Campo de Juego (Red Local)"
    Master[ESP32 Maestro]
    Slave1[Esclavo 1]
    Slave2[Esclavo 2]
    end

    App -->|BLE: '21'| Master
    Master -->|ESP-NOW: CMD| Slave1
    Master -->|ESP-NOW: CMD| Slave2
    
    Slave1 -.->|ESP-NOW: Bat%| Master
    Slave2 -.->|ESP-NOW: Bat%| Master
    Master -.->|BLE: Notificación| App

Estructura de Datos (Payload)

Para maximizar la velocidad de transmisión, no enviamos texto (JSON o Strings) entre los ESP32. Enviamos paquetes binarios compactos definidos mediante structs de C++.

1. Paquete de Control (Maestro Esclavo)

Es el mensaje más ligero posible. Solo contiene un caracter para indicar la acción.

typedef struct struct_control {
    char command; 
} struct_control;

2. Paquete de Telemetría (Esclavo Maestro)

El esclavo reporta su estado de energía.

typedef struct struct_battery {
    int percent;
} struct_battery;

Implementación Técnica del Firmware

La implementación en GITAF PRO supera desafíos específicos de la versión 3.0 del Core de ESP32.

Inicialización y Emparejamiento (Pairing)

El sistema utiliza Emparejamiento Estático. Las direcciones MAC de los esclavos están "quemadas" (hardcoded) en el firmware del Maestro. Esto evita que otros dispositivos ESP32 interfieran con el entrenamiento.

// Dirección MAC real del Esclavo 1 (Ejemplo del proyecto)
uint8_t slave1MAC[] = {0x2C, 0xBC, 0xBB, 0x0D, 0xF0, 0xE4}; 

void setupESPNow() {
  WiFi.mode(WIFI_STA); // Obligatorio: Modo Estación
  if (esp_now_init() != ESP_OK) return;
  
  // Registro de Callbacks con Casting para compatibilidad V3.0
  esp_now_register_send_cb((esp_now_send_cb_t)OnDataSent);
  esp_now_register_recv_cb((esp_now_recv_cb_t)OnDataRecv);
  
  // Registro del Peer (Esclavo)
  memcpy(peerInfo.peer_addr, slave1MAC, 6);
  peerInfo.channel = 0;  
  peerInfo.encrypt = false; // Sin encriptación para mayor velocidad
  esp_now_add_peer(&peerInfo);
}

Lógica de Envío (Maestro)

Cuando la App solicita activar un poste, el Maestro "inyecta" el comando en la red ESP-NOW.

// Ejemplo: Activar Esclavo 1
void activateSlave1() {
    struct_control myControlData;
    myControlData.command = '1';
    
    // Envío directo a la MAC específica
    esp_now_send(slave1MAC, (uint8_t *) &myControlData, sizeof(myControlData));
}

Lógica de Recepción (Esclavo)

El esclavo siempre está escuchando. Al recibir un paquete, verifica el contenido y ejecuta la máquina de estados del audio.

void OnDataRecv(const esp_now_recv_info_t * info, const uint8_t *incomingData, int len) {
  memcpy(&incomingControl, incomingData, sizeof(incomingControl));

  if (incomingControl.command == '1') {
      // Activar bandera para iniciar bucle de audio en void loop()
      sequenceActive = true; 
  }
}

Manejo de Errores y Robustez

Canales WiFi

ESP-NOW utiliza los canales de la radio WiFi (2.4 GHz).

• Configuración: Canal 1 (Default).
• Interferencia: Si el campo de entrenamiento tiene muchas redes WiFi saturando el canal 1, se puede cambiar el canal en la configuración peerInfo.channel tanto en el maestro como en los esclavos.

Confirmación de Entrega

Aunque usamos un protocolo de "disparo y olvido" para la velocidad, ESP-NOW tiene un mecanismo interno de ACK (Acuse de Recibo).

• Si el Maestro envía una orden y el Esclavo está apagado o fuera de rango, la función de callback OnDataSent retornará un estado de Delivery Fail.
• Actualmente, usamos esto para depuración vía Serial, pero podría implementarse para mostrar un error en la App.

Seguridad

1. Lista Blanca de MACs: Los esclavos ignoran cualquier paquete que no provenga de la dirección MAC del Maestro (validación en software).
2. Aislamiento: Al no estar conectados a Internet ni tener puerto abierto al público, el riesgo de ataque remoto es nulo.