Solución de Problemas

Esta guía te ayudará a identificar y resolver problemas comunes del Sistema Gateway Agrícola.

Problemas de Compilación

Error: «RadioHead library not found»

Síntomas: - Error de compilación: fatal error: “RHMesh.h” file not found - Error: RadioHead library not found

Solución: .. code-block:: bash

# Instalar librería RadioHead pio lib install «RadioHead»

# O instalar manualmente pio lib install «https://github.com/airspayce/RadioHead.git»

Error: «RtcDS1302 library not found»

Síntomas: - Error de compilación: fatal error: “RtcDS1302.h” file not found - Error: RtcDS1302 library not found

Solución: .. code-block:: bash

# Instalar librería RtcDS1302 pio lib install «andrewrapp/RtcDS1302»

Error: «LittleFS library not found»

Síntomas: - Error de compilación: fatal error: “LittleFS.h” file not found - Error: LittleFS library not found

Solución: .. code-block:: bash

# Instalar librería LittleFS pio lib install «LittleFS»

Error de Memoria Insuficiente

Síntomas: - Error: section “.text” will not fit in region “iram0_0” - Error: section “.data” will not fit in region “dram0_0”

Solución: .. code-block:: cpp

// Reducir buffers en config.h #define MAX_NODES 100 // Reducir de 250 a 100 #define NUMERO_MUESTRAS_ATMOSFERICAS 4 // Reducir de 8 a 4 #define RH_MESH_MAX_MESSAGE_LEN 30 // Reducir de 50 a 30

Problemas de Subida

Error: «Failed to connect to ESP8266»

Síntomas: - Error: Failed to connect to ESP8266: Timed out waiting for packet header - Error: Failed to connect to ESP8266: Invalid head of packet

Solución: 1. Verificar Conexión USB:

Cambiar cable USB

Probar puerto USB diferente

Verificar drivers instalados

Modo de Descarga: - Mantener botón FLASH presionado - Presionar botón RESET - Soltar botón RESET - Soltar botón FLASH después de 2 segundos

3. Verificar Puerto: .. code-block:: bash

# Listar puertos disponibles pio device list

# Usar puerto correcto pio run –target upload –upload-port COM7

Error: «Upload failed»

Síntomas: - Error: Upload failed: Timed out waiting for packet header - Error: Upload failed: Invalid head of packet

Solución: 1. Verificar Velocidad de Subida: .. code-block:: ini

# En platformio.ini upload_speed = 921600

2. Verificar Configuración de Board: .. code-block:: ini

# En platformio.ini board = esp12e platform = espressif8266

3. Limpiar y Recompilar: .. code-block:: bash

pio run –target clean pio run –target build pio run –target upload

Problemas de Hardware

Error de Comunicación LoRa

Síntomas: - Mensaje: RF95 MESH init failed - No hay comunicación entre nodos - Errores de timeout en transmisión

Solución: 1. Verificar Conexiones:

Confirmar pines SPI conectados correctamente

Verificar alimentación 3.3V estable

Confirmar antena conectada

2. Verificar Configuración: .. code-block:: cpp

// En config.h #define RFM95_CS 2 // Verificar pin CS #define RFM95_INT 5 // Verificar pin INT

3. Diagnóstico de Hardware: .. code-block:: bash

# Verificar comunicación SPI pio device monitor –port COM7 # Buscar mensajes de inicialización

Error de RTC

Síntomas: - Mensaje: RTC initialization failed - Fecha/hora incorrecta - RTC no responde

Solución: 1. Verificar Conexiones 3-wire:

Confirmar pines CLK, DAT, RST conectados

Verificar niveles de voltaje 3.3V

Confirmar batería de backup

2. Verificar Configuración: .. code-block:: cpp

// En config.h #define RTC_CLK 18 // Verificar pin CLK #define RTC_DAT 19 // Verificar pin DAT #define RTC_RST 4 // Verificar pin RST

3. Diagnóstico de RTC: .. code-block:: bash

# Verificar estado del RTC pio device monitor –port COM7 # Buscar mensajes de RTC

Problemas de Red

Nodos No Detectados

Síntomas: - No se reciben mensajes HELLO - Nodos no aparecen en la red - Timeouts de comunicación

Solución: 1. Verificar Configuración de Frecuencia: .. code-block:: cpp

// En radio_manager.cpp driver.setFrequency(433.0); // Verificar frecuencia

2. Verificar Potencia de Transmisión: .. code-block:: cpp

// En radio_manager.cpp driver.setTxPower(20, false); // Aumentar potencia si es necesario

Verificar Distancia: - Reducir distancia entre nodos - Verificar obstáculos - Probar con antenas de mayor ganancia

Pérdida de Paquetes

Síntomas: - Mensajes perdidos ocasionalmente - Timeouts frecuentes - Datos incompletos

Solución: 1. Ajustar Parámetros LoRa: .. code-block:: cpp

// Aumentar spreading factor para mayor alcance driver.setSpreadingFactor(9);

// Aumentar coding rate para mayor robustez driver.setCodingRate4(6);

2. Ajustar Timeouts: .. code-block:: cpp

// En config.h #define TIMEOUTGRAL 3000 // Aumentar timeout #define INTERVALOANNOUNCE 10000 // Aumentar intervalo

Verificar Interferencias: - Cambiar frecuencia si es necesario - Verificar fuentes de interferencia - Usar filtros si es necesario

Problemas de Memoria

Desbordamiento de Memoria

Síntomas: - Reinicios inesperados - Comportamiento errático - Errores de heap

Solución: 1. Reducir Buffers: .. code-block:: cpp

// En config.h #define MAX_NODES 100 // Reducir número de nodos #define NUMERO_MUESTRAS_ATMOSFERICAS 4 // Reducir muestras #define RH_MESH_MAX_MESSAGE_LEN 30 // Reducir tamaño de mensaje

2. Optimizar Almacenamiento: .. code-block:: cpp

// Usar tipos de datos más pequeños uint8_t nodeID; // En lugar de uint16_t uint16_t timestamp; // En lugar de uint32_t

3. Liberar Memoria: .. code-block:: cpp

// Limpiar buffers periódicamente void cleanupMemory() {

// Limpiar buffers no utilizados

}

Problemas de Energía

Consumo Excesivo

Síntomas: - Batería se agota rápidamente - Voltaje inestable - Reinicios por bajo voltaje

Solución: 1. Optimizar Sleep: .. code-block:: cpp

// Implementar sleep profundo ESP.deepSleep(60000000); // Sleep por 1 minuto

2. Reducir Transmisiones: .. code-block:: cpp

// En config.h #define INTERVALOANNOUNCE 300000 // Aumentar intervalo (5 min) #define INTERVALOATMOSPHERIC 900000 // Aumentar intervalo (15 min)

Optimizar Hardware: - Usar regulador de voltaje eficiente - Verificar consumo de componentes - Implementar modo de baja potencia

Problemas de Datos

Datos Corruptos

Síntomas: - Valores de sensores incorrectos - Datos fuera de rango - Checksums fallidos

Solución: 1. Verificar Validación: .. code-block:: cpp

// Implementar validación de rangos if (temperature < -40 || temperature > 80) {

// Datos inválidos return false;

}

2. Implementar Checksums: .. code-block:: cpp

// Verificar integridad de datos uint8_t checksum = calculateChecksum(data, length); if (checksum != receivedChecksum) {

// Datos corruptos return false;

}

3. Reintentos: .. code-block:: cpp

// Implementar reintentos para datos críticos for (int i = 0; i < MAX_RETRIES; i++) {

if (requestData()) {
break;

} delay(RETRY_DELAY);

}

Problemas de Configuración

Configuración No Persistente

Síntomas: - Configuración se pierde al reiniciar - Archivos no se guardan en LittleFS - Errores de escritura

Solución: 1. Verificar LittleFS: .. code-block:: cpp

// Inicializar LittleFS correctamente if (!LittleFS.begin()) {

Serial.println(«Error al inicializar LittleFS»); return false;

}

2. Verificar Escritura: .. code-block:: cpp

// Verificar escritura exitosa File file = LittleFS.open(«/config.json», «w»); if (!file) {

Serial.println(«Error al abrir archivo para escritura»); return false;

}

3. Backup de Configuración: .. code-block:: cpp

// Implementar backup automático void backupConfiguration() {

// Crear backup de configuración

}

Comandos de Diagnóstico

Verificar Estado del Sistema

# Verificar comunicación serial
pio device monitor --port COM7 --baud 115200

# Buscar mensajes de estado:
# - "RF95 MESH init okay"
# - "RTC inicializado correctamente"
# - "NodeIdentity::getNodeID()"

Verificar Memoria

// Función para verificar memoria disponible
void checkMemory() {
    Serial.printf("Free heap: %d bytes\n", ESP.getFreeHeap());
    Serial.printf("Free stack: %d bytes\n", ESP.getFreeContStack());
}

Verificar Red

// Función para verificar estado de red
void checkNetwork() {
    Serial.printf("Nodos activos: %d\n", activeNodes);
    Serial.printf("Paquetes enviados: %d\n", packetsSent);
    Serial.printf("Paquetes recibidos: %d\n", packetsReceived);
}

Verificar RTC

// Función para verificar RTC
void checkRTC() {
    RtcDateTime now = rtc.getDateTime();
    Serial.printf("Fecha: %04d/%02d/%02d\n",
                 now.Year(), now.Month(), now.Day());
    Serial.printf("Hora: %02d:%02d:%02d\n",
                 now.Hour(), now.Minute(), now.Second());
}

Logs de Diagnóstico

Habilitar Logs Detallados

// En config.h
#define DEBUG_MODE true
#define LOG_LEVEL DEBUG
#define ENABLE_SERIAL_OUTPUT true

// En código
#ifdef DEBUG_MODE
    Serial.printf("[DEBUG] %s: %s\n", __FUNCTION__, message);
#endif

Interpretar Logs

Logs de Inicialización: .. code-block:: text

Inicializando LittleFS en sketch principal… RF95 MESH init okay RTC inicializado correctamente NodeIdentity::getNodeID() - ID: 0x42 AppLogic::begin() - Gateway iniciado

Logs de Comunicación: .. code-block:: text

RadioManager::sendMessage() - Enviando a 0x10 RadioManager::recvMessage() - Recibido de 0x10 AppLogic::handleHello() - Nodo 0x10 registrado

Logs de Error: .. code-block:: text

ERROR: RF95 MESH init failed ERROR: RTC initialization failed ERROR: Memory allocation failed

Contacto y Soporte

Si los problemas persisten:

Recopilar Información: - Logs completos del sistema - Configuración actual - Descripción detallada del problema
Verificar Documentación: - Revisar guías de instalación - Consultar configuración avanzada - Verificar requisitos del sistema
Contactar Soporte: - Email: soporte@agro-iot.com - GitHub: https://github.com/agro-iot/gateway/issues - Foro: https://forum.agro-iot.com

Para más información, consulta la documentación completa en las siguientes secciones.