1. Introducción

MiSuelo es una aplicación móvil para Android diseñada para el monitoreo inteligente de cultivos. Se conecta a un sensor ESP32 vía Bluetooth Low Energy (BLE) para medir cuatro parámetros del suelo en tiempo real:

Además, la app incluye un asistente de inteligencia artificial (Gemini), análisis de compatibilidad de cultivos, alertas automáticas e historial de datos.

2. Requisitos del Sistema

3. Primer Inicio

Al instalar la app por primera vez, verás una serie de pantallas de bienvenida que explican las funciones principales:

Después del onboarding, un tutorial guiado interactivo resaltará cada botón y sección de la pantalla principal.

4. Conexión Bluetooth con ESP32

¿Cómo conectar?

1. Enciende tu sensor ESP32 (asegúrate de que tenga el firmware MiSuelo).
2. En la app, toca el ícono de Bluetooth 📶 en la barra superior, o ve al menú ⋮ → Conectar.
3. La app comenzará a buscar automáticamente. La barra se pondrá naranja con el texto "BUSCANDO...".
4. Cuando encuentre tu sensor, se conectará automáticamente. La barra se pondrá verde con "CONECTADO".

Estados de conexión

5. Pantalla Monitor

La pantalla principal de la app. Aquí ves tus cultivos activos, el clima y accedes a las funciones principales.

5.1 Tarjeta de Clima 🌤️

En la parte superior aparece una tarjeta con el clima actual de tu ubicación. Muestra:

• ☀️ Ícono y descripción del clima
• 🌡️ Temperatura actual
• 📍 Tu ubicación detectada

Expandir la tarjeta

Toca la tarjeta de clima para expandirla y ver:

• 💧 Humedad del aire
• 💨 Velocidad del viento
• 🌡️ Sensación térmica
• 📅 Pronóstico de los próximos días
• 🌱 Consejo agrícola personalizado basado en el clima

Toca nuevamente para contraer.

5.2 Agregar un Cultivo ➕

1. Toca el botón verde ➕ en la esquina superior derecha.
2. Se abrirá un formulario. Completa:
   • Nombre: un nombre para identificar tu cultivo (ej: "Tomates del patio").
   • Tipo de cultivo: selecciona del menú desplegable (Frijol, Maíz, Arroz, Tomate, Chiltomo).
   • Referencias/Descripción: (opcional) notas adicionales.
3. Presiona Guardar. El cultivo se creará con rangos óptimos predefinidos según el tipo seleccionado.

5.3 Tarjetas de Cultivos 🌱

Debajo del clima aparecen las tarjetas de tus cultivos registrados. Cada tarjeta muestra:

• 🌱 Nombre y tipo del cultivo
• 📊 Última lectura del sensor (humedad, temperatura, pH, luz)
• 🕐 Fecha de la última lectura

Toca cualquier tarjeta para abrir el detalle completo del cultivo.

Si no tienes cultivos registrados, verás una tarjeta indicando "No hay cultivos registrados" con instrucciones para agregar uno.

5.4 Análisis Pre-Siembra 🔬

Para evaluar tu terreno antes de sembrar:

1. Toca el botón morado 🔬 (junto al botón ➕) en la pantalla Monitor.
2. Se abrirá la pantalla de análisis pre-siembra.
3. Presiona "📡 Escanear terreno" para iniciar un escaneo BLE al sensor.
4. Espera a que lleguen los datos (2-5 segundos).
5. La app mostrará:
   • Estado del Suelo: las 4 métricas con indicadores de estado (🟢/🟡/🔴).
   • Ranking de Compatibilidad: qué cultivos son más compatibles con tu suelo actual.
6. Toca cualquier cultivo del ranking para ver su Plan de Preparación — pasos específicos para acondicionar el suelo.

6. Detalle del Cultivo

Al tocar una tarjeta de cultivo en el Monitor, se abre el detalle con toda la información del cultivo.

6.1 Escanear Datos del Sensor 📡

1. Asegúrate de que el sensor ESP32 está conectado (barra verde).
2. Presiona el botón "Escanear".
3. La app enviará el comando SCAN al ESP32 vía Bluetooth.
4. Espera a que los datos lleguen (la app acumulará los fragmentos automáticamente).
5. Los valores se guardarán en la base de datos y se mostrarán en las tarjetas de métricas.

6.2 Métricas del Suelo 📊

Después de un escaneo, verás 4 tarjetas de métricas:

Toca cada tarjeta de métrica para ver información detallada: el valor actual, el rango ideal para tu tipo de cultivo, y una recomendación si está fuera de rango.

Indicadores de estado

• 🟢 Óptimo: el valor está dentro del rango ideal
• 🟡 Precaución: el valor se acerca al límite
• 🔴 Alerta: el valor está fuera del rango ideal

Otras opciones en el detalle

• 🗑️ Eliminar cultivo: botón para eliminar el cultivo (con confirmación)
• ⬅️ Volver: botón para regresar al Monitor

7. Observaciones / Alertas 🔔

La pestaña Observaciones (ícono 🔔 en la barra inferior) muestra alertas automáticas cuando los valores de tus cultivos están fuera de rango.

¿Cuándo se generan alertas?

Cada vez que se realiza un escaneo de sensor, la app compara los valores obtenidos con los rangos ideales del cultivo. Si algún valor está fuera de rango, se genera una alerta.

Contenido de cada alerta

• ⚠️ Tipo de alerta (humedad alta/baja, temperatura, pH, luz)
• 📊 Valor actual vs valor esperado
• 🌱 Nombre del cultivo afectado
• 🕐 Fecha y hora de la alerta
• 💡 Recomendación de acción

8. Historial 📊

La pestaña Historial (ícono 📊 en la barra inferior) te permite consultar datos históricos de tus cultivos.

Funcionalidades

• 📈 Gráficas interactivas de cada métrica a lo largo del tiempo
• 🔍 Filtrar por cultivo para ver solo los datos de uno específico
• 📅 Rango de fechas para acotar el período de análisis
• 📊 Estadísticas — valores promedio, mínimo y máximo

¿Cómo usar?

1. Ve a la pestaña Historial desde la barra inferior.
2. Selecciona un cultivo del selector.
3. Observa las gráficas para cada métrica (humedad, temperatura, pH, luz).
4. Desliza o acerca (pinch-to-zoom) para explorar los datos.

9. Agente IA 🤖

Tu asistente agrícola inteligente potenciado por Google Gemini. Accede desde la pestaña 🤖 en la barra inferior.

Funcionalidades

10. Análisis de Cultivos 📈

La pestaña Análisis (ícono 📈 en la barra inferior) ofrece análisis detallado de cada cultivo usando inteligencia artificial.

Contenido del análisis

• 📊 Tendencias de cada métrica
• 🎯 Predicciones basadas en datos históricos
• 📋 Comparación con valores ideales de referencia
• 🌡️ Análisis detallado por métrica
• 📝 Recomendaciones generadas por IA

11. Respaldo de Datos 💾

Protege tu información exportando e importando datos. Accede desde el menú ⋮ → Respaldo de Datos.

Exportar (crear respaldo) 📤

1. Toca "Exportar Datos".
2. El sistema te pedirá dónde guardar el archivo.
3. Se generará un archivo .json con todos tus datos:
   • Dispositivos registrados
   • Sensores
   • Cultivos
   • Lecturas de sensores
   • Umbrales configurados
   • Alertas
   • Eventos de riego
   • Análisis de terreno (pre-siembra)
4. Verás un mensaje con el total de registros exportados.

Importar (restaurar respaldo) 📥

1. Toca "Importar Datos".
2. Se mostrará una advertencia: la importación reemplaza TODOS los datos actuales.
3. Selecciona el archivo .json de respaldo.
4. Espera a que se complete la importación.
5. Reinicia la app para ver los cambios.

12. Menú de Opciones ⋮

Toca los tres puntos ⋮ en la esquina superior derecha para acceder a:

13. Solución de Problemas