📚 Ejemplos y Tutoriales - Sistema Gateway Agrícola

🎯 Enfoque de esta Guía

Esta sección proporciona ejemplos mínimos pero funcionales, junto con enlaces a recursos externos para tutoriales más detallados.

🚀 Ejemplos de Código

📡 Configuración Básica del Gateway

#include "app_logic.h"
#include "node_identity.h"
#include "radio_manager.h"
#include "rtc_manager.h"

// Configuración básica
NodeIdentity identity;
RadioManager radio(identity.getNodeID());
RtcManager rtc(RTC_DAT, RTC_CLK, RTC_RST);
AppLogic logic(identity, radio, rtc);

void setup() {
    Serial.begin(115200);

    // Inicializar componentes
    if (!radio.init()) {
        Serial.println("Error: Radio no inicializada");
        return;
    }

    if (!rtc.begin()) {
        Serial.println("Error: RTC no inicializado");
        return;
    }

    logic.begin();
    Serial.println("Gateway iniciado correctamente");
}

void loop() {
    logic.update();
    delay(100);
}

🔧 Configuración de Hardware

// config.h - Configuración de pines
#define RFM95_CS 2    // D4
#define RFM95_INT 14  // D5
#define RFM95_RST 12  // D6

#define RTC_DAT 4     // D2
#define RTC_CLK 5     // D1
#define RTC_RST 0     // D3

📊 Acceso a Datos

// Obtener datos atmosféricos de un nodo
auto& nodeData = logic.AtmosphericSampleNodes[0x42];
AtmosphericSample sample = nodeData[0];
Serial.printf("Temp: %.1f°C, Hum: %.1f%%\n",
    sample.temperature, sample.humidity);

// Obtener datos de suelo/GPS
auto& groundData = logic.groundGpsSamplesNodes[0x42];
GroundGpsPacket ground = groundData[0];
Serial.printf("Suelo: %.1f%%, pH: %.1f\n",
    ground.soilMoisture, ground.pH);

🔗 Tutoriales Externos

📚 Arduino y ESP8266

Tutoriales Básicos

Arduino Getting Started: https://www.arduino.cc/en/Guide
ESP8266 Quick Start: https://docs.espressif.com/projects/esp8266-rtos-sdk/en/latest/get-started/
PlatformIO Guide: https://docs.platformio.org/en/latest/tutorials/

Comunicación LoRa

RadioHead Tutorial: https://www.airspayce.com/mikem/arduino/RadioHead/
LoRa Basics: https://lora-alliance.org/resource_hub/what-is-lora/
RFM95 Datasheet: https://www.hoperf.com/rf_transceiver/rfm95.html

RTC y Tiempo

DS1302 Library: https://github.com/andrewrapp/RtcDS1302
Time Management: https://www.arduino.cc/reference/en/language/functions/time/

🛠️ Desarrollo y Debugging

PlatformIO

PlatformIO IDE: https://docs.platformio.org/en/latest/integration/ide/
Debugging Guide: https://docs.platformio.org/en/latest/advanced/debugging/
Library Management: https://docs.platformio.org/en/latest/librarymanager/

Git y Versionado

Git Tutorial: https://git-scm.com/doc
GitHub Guides: https://guides.github.com/
Submodules: https://git-scm.com/book/en/v2/Git-Tools-Submodules

📊 Documentación Técnica

Sphinx y Autodoc

Sphinx Documentation: https://www.sphinx-doc.org/
Doxygen Manual: https://www.doxygen.nl/manual/
Mermaid Diagrams: https://mermaid-js.github.io/mermaid/

Markdown y reStructuredText

Markdown Guide: https://www.markdownguide.org/
reStructuredText: https://docutils.sourceforge.io/rst.html

🎯 Casos de Uso Comunes

🔍 Debugging de Comunicación

// Habilitar debug detallado
#define DEBUG_MODE

// En config.h
#ifdef DEBUG_MODE
    #define DEBUG_PRINT(x) Serial.print(x)
    #define DEBUG_PRINTLN(x) Serial.println(x)
#else
    #define DEBUG_PRINT(x)
    #define DEBUG_PRINTLN(x)
#endif

⚙️ Configuración de Red

// Ajustar parámetros de red
#define INTERVALOANNOUNCE 5000      // 5 segundos
#define INTERVALOATMOSPHERIC 30000  // 30 segundos
#define TIMEOUTGRAL 2000            // 2 segundos

📈 Monitoreo de Memoria

// Verificar uso de memoria
Serial.printf("Memoria libre: %d bytes\n", ESP.getFreeHeap());
Serial.printf("Memoria total: %d bytes\n", ESP.getHeapSize());

🔧 Herramientas Recomendadas

📱 IDEs y Editores

Visual Studio Code: https://code.visualstudio.com/
PlatformIO IDE: https://platformio.org/ide
Arduino IDE: https://www.arduino.cc/en/software

🔍 Herramientas de Debugging

Serial Monitor: Integrado en Arduino IDE
PlatformIO Monitor: pio device monitor
Wireshark: https://www.wireshark.org/ (para análisis de red)

📊 Análisis de Datos

Arduino Serial Plotter: Para visualización en tiempo real
Python Matplotlib: https://matplotlib.org/ (para análisis avanzado)
Jupyter Notebooks: https://jupyter.org/ (para análisis de datos)

🚨 Solución de Problemas

❌ Problemas Comunes

Radio no inicializa

Verificar conexiones SPI
Comprobar alimentación del módulo
Revisar configuración de pines

RTC no responde

Verificar conexiones de 3 hilos
Comprobar batería del módulo
Revisar configuración de pines

Memoria insuficiente

Reducir MAX_NODES
Optimizar almacenamiento de datos
Usar PROGMEM para constantes

🔗 Recursos de Ayuda

Arduino Forum: https://forum.arduino.cc/
ESP8266 Community: https://community.espressif.com/
RadioHead Support: https://www.airspayce.com/mikem/arduino/RadioHead/

📝 Notas de Desarrollo

🎯 Mejores Prácticas

Siempre verificar inicialización de componentes
Usar DEBUG_MODE durante desarrollo
Monitorear memoria regularmente
Documentar cambios en el código
Probar en hardware real frecuentemente

⚡ Optimizaciones

Usar PROGMEM para strings largos
Minimizar uso de String en favor de char*
Optimizar bucles críticos
Usar interrupciones cuando sea posible

Esta guía proporciona ejemplos mínimos y enlaces a recursos externos para tutoriales más detallados. 📚✨