ManualUsuario » History » Version 3
« Previous -
Version 3/6
(diff) -
Next » -
Current version
bairon núñez, 01/03/2026 04:23 AM
Manual de Usuario¶
Home | Panorama General | Logística | Metodología | Manual | Resultados | Recursos
- Manual de Usuario
- 1. Manual de Instalación
- 2. Guía de Configuración Inicial
- 3. Manual de Operación
- 4. Uso del Modo de Prueba
- 5. Interfaz de Usuario
- 6. Solución de Problemas
- 7. Mantenimiento
- 8. Especificaciones Técnicas
- 9. Preguntas Frecuentes (FAQ)
- ¿Con qué frecuencia riega el sistema?
- ¿Puedo usar otros sensores?
- ¿Funciona con cualquier tipo de planta?
- ¿Necesita conexión a internet?
- ¿Qué hacer en caso de corte de energía?
- ¿Es resistente al agua el sistema?
- ¿Cuántas plantas puedo regar con este sistema?
- ¿Puedo controlar el sistema desde mi teléfono?
- ¿Cuánto dura el agua del depósito?
- 10. Seguridad y Precauciones
- 11. Comandos Útiles
- 12. Contacto y Soporte
1. Manual de Instalación¶
1.1 Requisitos Previos¶
Hardware necesario:- Raspberry Pi 4 Model B (4 GB RAM mínimo)
- Tarjeta microSD de 32 GB (Clase 10 o superior)
- Sensor de humedad del suelo
- Sensor de temperatura y humedad DHT22
- Mini bomba de agua sumergible 120l/h
- Relé de 5V
- Fuente de alimentación 5V/3A para Raspberry Pi
- Cables jumper macho-hembra
- Protoboard
- Manguera y goteros
- Depósito de agua (bidón 20L)
- Raspberry Pi OS (versión Bullseye o superior)
- Python 3.7 o superior
- Bibliotecas Python: RPi.GPIO, Adafruit_DHT, datetime, logging
1.2 Instalación del Sistema Operativo¶
Paso 1: Preparar la tarjeta microSD
- Descargar Raspberry Pi Imager desde https://www.raspberrypi.org/software/
- Insertar la tarjeta microSD en el computador
- Abrir Raspberry Pi Imager
- Seleccionar "Raspberry Pi OS (32-bit)"
- Seleccionar la tarjeta microSD como destino
- Hacer clic en "Write" y esperar a que termine el proceso
Paso 2: Configuración inicial
- Insertar la tarjeta microSD en la Raspberry Pi
- Conectar teclado, mouse y monitor
- Conectar la fuente de alimentación
- Seguir el asistente de configuración inicial
- Configurar idioma, zona horaria y red WiFi
- Actualizar el sistema:
sudo apt update && sudo apt upgrade -y
1.3 Instalación de Bibliotecas Python¶
Abrir la terminal y ejecutar los siguientes comandos:
# Actualizar pip
sudo pip3 install --upgrade pip
# Instalar RPi.GPIO
sudo pip3 install RPi.GPIO
# Instalar Adafruit DHT
sudo pip3 install Adafruit_DHT
# Verificar instalación
python3 -c "import RPi.GPIO; print('RPi.GPIO instalado correctamente')"
python3 -c "import Adafruit_DHT; print('Adafruit_DHT instalado correctamente')"
1.4 Conexión de Sensores¶
Conexión del sensor de humedad del suelo:
| Pin del Sensor | Pin de Raspberry Pi | Descripción |
|---|---|---|
| VCC | Pin 2 (5V) | Alimentación |
| GND | Pin 6 (GND) | Tierra |
| Signal | Pin 11 (GPIO 17) | Señal de datos |
Conexión del sensor DHT22:
| Pin del Sensor | Pin de Raspberry Pi | Descripción |
|---|---|---|
| VCC | Pin 1 (3.3V) | Alimentación |
| GND | Pin 9 (GND) | Tierra |
| Data | Pin 7 (GPIO 4) | Señal de datos |
Importante: Asegúrese de que la Raspberry Pi esté apagada antes de conectar los sensores.
1.5 Conexión del Relé y Bomba de Agua¶
Conexión del Relé:
| Pin del Relé | Conexión | Descripción |
|---|---|---|
| VCC | Pin 4 (5V) | Alimentación del relé |
| GND | Pin 14 (GND) | Tierra |
| IN | Pin 13 (GPIO 27) | Señal de control |
| COM | Fuente 12V (+) | Terminal común |
| NO | Bomba (+) | Normalmente abierto |
Conexión de la Bomba:
| Terminal | Conexión |
|---|---|
| Bomba (+) | Relé terminal NO |
| Bomba (-) | Fuente 12V (-) |
¡Advertencia! Nunca conecte la bomba directamente a los pines GPIO. Siempre use un relé para evitar daños a la Raspberry Pi.
1.6 Descarga e Instalación del Código¶
# Crear directorio del proyecto mkdir ~/sistema-riego cd ~/sistema-riego # Clonar repositorio (si está disponible) git clone [URL_DEL_REPOSITORIO] # O descargar archivos manualmente y extraer # Los archivos principales son: # - main.py (programa principal) # - config.py (configuración) # - sensor_reader.py (lectura de sensores) # - irrigation_controller.py (control de riego) # Dar permisos de ejecución chmod +x main.py
1.7 Verificación de la Instalación¶
Prueba de sensores:
# Probar sensor de humedad
python3 -c "import RPi.GPIO as GPIO; GPIO.setmode(GPIO.BCM); GPIO.setup(17, GPIO.IN); print('Sensor de humedad OK')"
# Probar sensor DHT22
python3 -c "import Adafruit_DHT; sensor = Adafruit_DHT.DHT22; pin = 4; h, t = Adafruit_DHT.read_retry(sensor, pin); print(f'Temp: {t}°C, Humedad: {h}%')"
Prueba del relé:
# Crear archivo test_relay.py
nano test_relay.py
# Contenido del archivo:
import RPi.GPIO as GPIO
import time
RELAY_PIN = 27
GPIO.setmode(GPIO.BCM)
GPIO.setup(RELAY_PIN, GPIO.OUT)
print("Activando relé...")
GPIO.output(RELAY_PIN, GPIO.HIGH)
time.sleep(2)
print("Desactivando relé...")
GPIO.output(RELAY_PIN, GPIO.LOW)
GPIO.cleanup()
# Ejecutar prueba
python3 test_relay.py
2. Guía de Configuración Inicial¶
2.1 Configuración de Pines GPIO¶
Editar el archivo config.py para ajustar los pines según su conexión:
# Abrir archivo de configuración nano config.py # Configuración de pines HUMEDAD_PIN = 17 # Pin del sensor de humedad del suelo DHT_PIN = 4 # Pin del sensor DHT22 RELAY_PIN = 27 # Pin del relé DHT_SENSOR = 22 # Tipo de sensor DHT (22 para DHT22)
2.2 Ajuste de Umbrales de Humedad¶
Los umbrales determinan cuándo activar y desactivar el riego:
# En config.py UMBRAL_HUMEDAD_MIN = 30 # Humedad mínima (activa riego) UMBRAL_HUMEDAD_MAX = 70 # Humedad máxima (detiene riego)
Recomendaciones por tipo de planta:
| Tipo de Planta | Umbral Mínimo | Umbral Máximo | Observaciones |
|---|---|---|---|
| Cactus y suculentas | 20% | 40% | Requieren poca agua |
| Plantas de interior | 30% | 60% | Humedad moderada |
| Hortalizas | 40% | 70% | Necesitan más agua |
| Plantas tropicales | 50% | 80% | Alta humedad constante |
2.3 Configuración de Frecuencia de Muestreo¶
# En config.py INTERVALO_LECTURA = 300 # Segundos entre lecturas (300 = 5 minutos) TIEMPO_RIEGO_MAX = 60 # Tiempo máximo de riego continuo (segundos)
Recomendación: Para pruebas iniciales, use intervalos cortos (30-60 segundos). Para operación normal, use 5-10 minutos.
2.4 Calibración de Sensores¶
Calibración del sensor de humedad:
- Sumergir el sensor en agua: anotar el valor (debería ser ~100%)
- Dejar el sensor al aire seco: anotar el valor (debería ser ~0%)
- Ajustar valores en el código si es necesario
# Función de calibración en sensor_reader.py
def calibrar_humedad(valor_raw):
VALOR_SECO = 0 # Ajustar según su sensor
VALOR_HUMEDO = 100 # Ajustar según su sensor
humedad = ((valor_raw - VALOR_SECO) / (VALOR_HUMEDO - VALOR_SECO)) * 100
return max(0, min(100, humedad))
2.5 Configuración de Rutas de Logs¶
# En config.py LOG_DIR = "/home/pi/sistema-riego/logs/" LOG_FILE = "riego.log" LOG_LEVEL = "INFO" # Opciones: DEBUG, INFO, WARNING, ERROR
# Crear directorio de logs mkdir -p ~/sistema-riego/logs
3. Manual de Operación¶
3.1 Inicio del Sistema¶
Inicio manual:
# Navegar al directorio del proyecto cd ~/sistema-riego # Ejecutar el programa principal python3 main.py
Inicio automático al arranque:
# Editar crontab crontab -e # Agregar la siguiente línea al final: @reboot sleep 30 && /usr/bin/python3 /home/pi/sistema-riego/main.py & # Guardar y salir (Ctrl+X, Y, Enter)
3.2 Monitoreo en Tiempo Real¶
Una vez iniciado, el sistema mostrará información en la terminal:
[2025-01-03 10:30:15] Sistema iniciado [2025-01-03 10:30:15] Configuración cargada [2025-01-03 10:30:20] Leyendo sensores... [2025-01-03 10:30:20] Humedad del suelo: 45% [2025-01-03 10:30:20] Temperatura: 22°C [2025-01-03 10:30:20] Humedad ambiente: 65% [2025-01-03 10:30:20] Estado: Humedad adecuada, sin riego necesario
3.3 Estados del Sistema¶
| Estado | Descripción | Acción |
|---|---|---|
| INICIANDO | Sistema arrancando | Verificando sensores y configuración |
| MONITOREANDO | Lectura de sensores activa | Evaluando condiciones continuamente |
| RIEGO_ACTIVO | Bomba encendida | Regando hasta alcanzar umbral máximo |
| RIEGO_DETENIDO | Bomba apagada | Esperando próxima lectura |
| ERROR_SENSOR | Fallo en lectura | Reintentando o alertando usuario |
| MODO_PRUEBA | Prueba manual activa | Riego controlado manualmente |
3.4 Modo Automático¶
En modo automático (predeterminado), el sistema:
- Lee sensores cada X segundos (según configuración)
- Evalúa si la humedad está bajo el umbral mínimo
- Activa la bomba si es necesario
- Monitorea constantemente la humedad durante el riego
- Detiene la bomba al alcanzar el umbral máximo
- Registra todos los eventos en el archivo de log
3.5 Detención del Sistema¶
Detención segura:
# Presionar Ctrl+C en la terminal # El sistema ejecutará limpieza de GPIO antes de cerrar # O encontrar el proceso y terminarlo: ps aux | grep main.py kill [PID_DEL_PROCESO]
Importante: Siempre detenga el sistema correctamente para evitar que la bomba quede activada.
4. Uso del Modo de Prueba¶
4.1 Activación del Modo de Prueba¶
El modo de prueba permite activar manualmente la bomba sin depender de las lecturas de humedad:
# Ejecutar script de prueba python3 test_mode.py # O agregar bandera al programa principal python3 main.py --test
4.2 Pruebas Disponibles¶
Prueba 1: Activación breve de la bomba
# En el modo de prueba, seleccionar opción 1 # La bomba se activará por 3 segundos # Verificar que el agua fluye correctamente
Prueba 2: Lectura de sensores
# Seleccionar opción 2 # Muestra lecturas actuales de todos los sensores # Útil para verificar calibración
Prueba 3: Ciclo completo de riego
# Seleccionar opción 3 # Simula un ciclo completo de riego # Dura 10 segundos (configurable)
4.3 Verificación de Componentes¶
| Componente | Prueba | Resultado Esperado |
|---|---|---|
| Sensor de humedad | Sumergir en agua | Lectura cercana a 100% |
| Sensor de humedad | Exponer al aire | Lectura entre 0-30% |
| Sensor DHT22 | Lectura normal | Temp: 15-30°C, Humedad: 30-80% |
| Relé | Activación manual | Sonido de "click" audible |
| Bomba | Modo de prueba | Flujo de agua constante |
5. Interfaz de Usuario¶
5.1 Descripción de la Interfaz¶
La interfaz por terminal muestra:
- Fecha y hora de cada evento
- Nivel de log (INFO, WARNING, ERROR)
- Lecturas actuales de sensores
- Estado del sistema (monitoreando, regando, etc.)
- Eventos de riego (inicio, fin, duración)
5.2 Indicadores Visuales¶
[INFO] → Información general [WARNING] → Advertencia (atención requerida) [ERROR] → Error (acción requerida) [DEBUG] → Información de depuración
5.3 Lectura del Historial de Riego¶
Ver logs en tiempo real:
# En otra terminal tail -f ~/sistema-riego/logs/riego.log
Ver últimos N eventos:
# Ver últimas 50 líneas tail -n 50 ~/sistema-riego/logs/riego.log # Buscar eventos de riego grep "RIEGO" ~/sistema-riego/logs/riego.log
Filtrar por fecha:
# Ver eventos de hoy grep "$(date +%Y-%m-%d)" ~/sistema-riego/logs/riego.log # Ver eventos de riego de hoy grep "$(date +%Y-%m-%d)" ~/sistema-riego/logs/riego.log | grep "RIEGO"
6. Solución de Problemas¶
| Problema | Causa Posible | Solución |
|---|---|---|
| Sensor no detectado | Conexión incorrecta | Verificar pines GPIO, reconectar sensor |
| Lecturas erróneas de humedad | Sensor no calibrado | Ejecutar calibración, verificar en agua/aire |
| Lecturas siempre 0% o 100% | Sensor dañado | Reemplazar sensor |
| Bomba no se activa | Relé sin alimentación | Verificar conexión VCC del relé |
| Bomba no se activa | Pin GPIO incorrecto | Revisar configuración en config.py |
| Riego no se detiene | Umbral máximo muy alto | Reducir UMBRAL_HUMEDAD_MAX |
| Riego no se detiene | Error en lógica | Verificar logs, reiniciar sistema |
| Sistema no responde | Proceso bloqueado | Reiniciar Raspberry Pi |
| Error "Permission denied" | Falta permisos GPIO | Ejecutar con sudo o agregar usuario a grupo gpio |
| Temperatura muestra "None" | DHT22 mal conectado | Reconectar sensor, verificar pin |
| Logs no se generan | Directorio no existe | Crear carpeta: mkdir -p ~/sistema-riego/logs |
| Consumo excesivo de agua | Umbrales incorrectos | Ajustar configuración de umbrales |
6.1 Mensajes de Error Comunes¶
Error: "ModuleNotFoundError: No module named 'RPi.GPIO'"
# Solución: sudo pip3 install RPi.GPIO
Error: "RuntimeError: No access to /dev/mem"
# Solución: ejecutar con sudo sudo python3 main.py # O agregar usuario al grupo gpio: sudo usermod -a -G gpio pi # Cerrar sesión y volver a entrar
Error: "DHT sensor not found"
# Verificar conexión del DHT22 # Verificar que el pin en config.py sea correcto # Intentar con otro pin GPIO
6.2 Procedimiento de Diagnóstico¶
Paso 1: Verificar hardware- Comprobar que todos los cables estén bien conectados
- Verificar que la Raspberry Pi esté encendida
- Comprobar que los sensores tengan alimentación (LED encendido si aplica)
- Revisar que todas las bibliotecas estén instaladas
- Verificar que no haya errores de sintaxis en archivos modificados
- Comprobar permisos de archivos
- Leer el archivo de log completo
- Identificar el último evento antes del error
- Buscar patrones de error repetidos
- Probar cada sensor individualmente
- Probar el relé por separado
- Ejecutar el modo de prueba
7. Mantenimiento¶
7.1 Mantenimiento Preventivo¶
Semanal:- Verificar funcionamiento del sistema
- Revisar nivel de agua en el depósito
- Inspeccionar visualmente las conexiones
- Limpiar sensor de humedad del suelo
- Limpieza profunda de sensores
- Verificar filtros de la bomba (si aplica)
- Revisar mangueras y goteros por obstrucciones
- Verificar integridad de cables
- Revisar logs para detectar anomalías
- Recalibrar sensores
- Verificar ajuste de umbrales según estación
- Actualizar software si hay versiones nuevas
- Realizar respaldo de configuración
7.2 Limpieza de Sensores¶
Sensor de humedad del suelo:
- Apagar el sistema
- Extraer el sensor del suelo
- Limpiar con agua destilada y cepillo suave
- Secar completamente antes de reinstalar
- No sumergir el módulo electrónico, solo la sonda
Sensor DHT22:
- No requiere limpieza frecuente
- Si es necesario, limpiar con aire comprimido
- No tocar directamente los componentes electrónicos
7.3 Actualización del Software¶
# Detener el sistema sudo pkill -f main.py # Navegar al directorio cd ~/sistema-riego # Hacer respaldo de configuración actual cp config.py config.py.backup # Actualizar código (si usa Git) git pull origin main # O descargar nueva versión manualmente # Restaurar configuración si es necesario cp config.py.backup config.py # Reiniciar el sistema python3 main.py
7.4 Respaldo de Configuración¶
# Crear respaldo completo tar -czf backup-$(date +%Y%m%d).tar.gz ~/sistema-riego/ # Guardar en ubicación segura mv backup-*.tar.gz ~/backups/ # Restaurar desde respaldo tar -xzf backup-YYYYMMDD.tar.gz -C ~/
8. Especificaciones Técnicas¶
8.1 Especificaciones de Hardware¶
Raspberry Pi 4 Model B:- Procesador: Broadcom BCM2711, Quad-core Cortex-A72 (ARM v8) 64-bit SoC @ 1.5GHz
- RAM: 4 GB LPDDR4
- GPIO: 40 pines
- Consumo: 5V, 3A (15W)
- Voltaje de operación: 3.3-5V DC
- Corriente: < 20mA
- Salida: Señal analógica/digital
- Rango de medición: 0-100% humedad relativa del suelo
- Voltaje de alimentación: 3.3-5V DC
- Rango de temperatura: -40°C a 80°C
- Precisión temperatura: ±0.5°C
- Rango de humedad: 0-100% RH
- Precisión humedad: ±2% RH
- Voltaje: 12V DC
- Corriente: 0.8-1A
- Flujo: 120 litros/hora
- Altura máxima: 1.5 metros
- Sumergible: Sí
- Voltaje de señal: 5V
- Corriente máxima: 10A
- Tipo: Normalmente abierto (NO)
8.2 Consumo Eléctrico¶
| Componente | Voltaje | Corriente | Potencia |
|---|---|---|---|
| Raspberry Pi 4 | 5V | 3A | 15W |
| Sensor de humedad | 5V | 0.02A | 0.1W |
| Sensor DHT22 | 3.3V | 0.002A | 0.007W |
| Relé | 5V | 0.07A | 0.35W |
| Bomba de agua | 12V | 1A | 12W |
| Total (bomba activa) | ~27.5W | ||
| Total (bomba inactiva) | ~15.5W |
8.3 Rango de Operación¶
| Parámetro | Rango | Valor Óptimo |
|---|---|---|
| Temperatura ambiente | -5°C a 40°C | 15°C a 30°C |
| Humedad ambiente | 10% a 90% RH | 40% a 70% RH |
| Humedad del suelo (lectura) | 0% a 100% | 30% a 70% (plantas comunes) |
| Frecuencia de muestreo | 10 segundos a 1 hora | 5 minutos |
| Tiempo de riego | 5 segundos a 5 minutos | 30-60 segundos |
8.4 Tolerancias y Precisión¶
- Precisión del sensor de humedad del suelo: ±5%
- Precisión del sensor DHT22 (temperatura): ±0.5°C
- Precisión del sensor DHT22 (humedad): ±2% RH
- Tiempo de respuesta del sistema: < 5 segundos
- Margen de error en tiempo de riego: ±2 segundos
9. Preguntas Frecuentes (FAQ)¶
¿Con qué frecuencia riega el sistema?¶
El sistema riega automáticamente cuando la humedad del suelo cae por debajo del umbral mínimo configurado. La frecuencia depende de:- Tipo de planta (consumo de agua)
- Temperatura y humedad ambiental
- Tamaño del contenedor/maceta
- Estación del año
Típicamente, puede regar desde 1 vez al día hasta varias veces por semana.
¿Puedo usar otros sensores?¶
Sí, el sistema es modular. Puede reemplazar los sensores por otros compatibles, ajustando la configuración de pines y las bibliotecas en el código. Sensores compatibles:- Cualquier sensor de humedad capacitivo o resistivo
- DHT11 (menos preciso que DHT22)
- Sensores I2C como BME280 (requiere modificación del código)
¿Funciona con cualquier tipo de planta?¶
El sistema funciona con la mayoría de plantas, pero debe ajustar los umbrales según las necesidades específicas:- Cactus y suculentas: umbrales bajos (20-40%)
- Plantas tropicales: umbrales altos (50-80%)
- Hortalizas: umbrales medios (40-70%)
¿Necesita conexión a internet?¶
No, el sistema funciona completamente offline. La Raspberry Pi solo necesita:- Alimentación eléctrica
- Acceso local (opcional, para monitoreo)
- Actualizaciones de software
- Monitoreo remoto (funcionalidad futura)
- Sincronización de fecha/hora
¿Qué hacer en caso de corte de energía?¶
El sistema no tiene batería de respaldo por defecto. En caso de corte:- El sistema se detendrá completamente
- Al restablecerse la energía, puede configurarse para iniciar automáticamente
- Los datos de configuración se mantienen guardados
- Se recomienda UPS (sistema de alimentación ininterrumpida) para aplicaciones críticas
¿Es resistente al agua el sistema?¶
- La Raspberry Pi NO es resistente al agua - mantenerla en lugar seco
- Los sensores son resistentes a la humedad/agua
- La bomba es sumergible
- El relé debe estar en lugar protegido
- Se recomienda caja protectora para la Raspberry Pi
¿Cuántas plantas puedo regar con este sistema?¶
Esto depende de:- Capacidad de la bomba (120 L/h en este caso)
- Longitud de manguera disponible
- Número de goteros instalados
- Presión del agua
Configuración típica: 4-8 plantas en un área de 2-3 metros cuadrados
¿Puedo controlar el sistema desde mi teléfono?¶
En la versión actual, no hay interfaz móvil. Sin embargo, puede:- Acceder por SSH desde una app como Termius
- Ver logs en tiempo real
- Modificar configuración remotamente
Funcionalidad futura incluirá app móvil dedicada.
¿Cuánto dura el agua del depósito?¶
Depende de:- Tamaño del depósito (20L en configuración base)
- Número de plantas
- Tiempo de riego por ciclo
- Frecuencia de riego
Ejemplo: Con riego de 30 segundos (1L aprox.), 3 veces por semana, para 4 plantas = ~12L/semana = el depósito dura ~10 días
10. Seguridad y Precauciones¶
10.1 Precauciones Eléctricas¶
¡PELIGRO! Nunca manipule conexiones eléctricas con el sistema encendido.
- Desconecte siempre la alimentación antes de modificar conexiones
- No mezcle voltajes diferentes sin la protección adecuada
- Use fuentes de alimentación certificadas
- Verifique polaridad antes de conectar componentes
- No exceda las especificaciones de corriente de los pines GPIO (16 mA max)
10.2 Manejo de Agua cerca de Componentes¶
- Mantenga la Raspberry Pi en lugar seco y elevado
- Use caja protectora resistente al agua para la Raspberry Pi
- Nunca sumerja la Raspberry Pi o el relé
- Coloque el depósito de agua alejado de componentes electrónicos
- Verifique regularmente la integridad de mangueras
- Use conectores herméticos en áreas propensas a salpicaduras
10.3 Voltajes Seguros¶
| Componente | Voltaje Seguro | Voltaje Máximo |
|---|---|---|
| Raspberry Pi | 5V | 5.25V |
| GPIO (entrada) | 3.3V | 3.3V |
| GPIO (salida) | 3.3V | 3.3V |
| Sensor de humedad | 3.3-5V | 5.5V |
| Sensor DHT22 | 3.3-5V | 5.5V |
| Relé (señal) | 5V | 5V |
| Bomba | 12V | 12V |
10.4 Qué NO Hacer¶
❌ NO conectar la bomba directamente a GPIO
❌ NO usar voltajes superiores a 3.3V en pines GPIO de entrada
❌ NO modificar el código sin respaldo previo
❌ NO dejar el sistema funcionando sin supervisión inicial
❌ NO ubicar el sistema cerca de fuentes de calor
❌ NO obstruir la ventilación de la Raspberry Pi
❌ NO usar agua salada o contaminada (daña sensores)
❌ NO forzar conexiones de pines
❌ NO tocar componentes mientras el sistema está encendido
10.5 Advertencias Importantes¶
Advertencia 1: El sensor de humedad del suelo se corroe con el tiempo. Reemplácelo cada 6-12 meses según uso.
Advertencia 2: Si el sistema no detiene el riego automáticamente, podría causar inundación. Pruebe siempre el sistema supervisado antes de dejarlo en modo automático.
Advertencia 3: La Raspberry Pi puede sobrecalentarse en ambientes calurosos. Monitoree la temperatura del procesador regularmente.
Advertencia 4: No utilice el sistema para aplicaciones críticas de vida o muerte sin sistemas de seguridad redundantes.
10.6 En Caso de Emergencia¶
Si la bomba no se detiene:- Desconecte inmediatamente la fuente de alimentación de la bomba
- No intente detenerla manualmente mientras esté energizada
- Revise la lógica del código antes de reiniciar
- Desconecte INMEDIATAMENTE toda la alimentación
- No vuelva a conectar hasta identificar el problema
- Revise visualmente todos los componentes
- Reemplace cualquier componente dañado
- Desconecte la alimentación desde el interruptor principal
- No toque componentes mojados hasta que estén completamente secos
- Espere al menos 24 horas antes de reconectar
- Inspeccione cuidadosamente todos los componentes
11. Comandos Útiles¶
11.1 Comandos del Sistema¶
# Ver estado del sistema ps aux | grep main.py # Reiniciar el sistema sudo pkill -f main.py && python3 ~/sistema-riego/main.py & # Ver logs en tiempo real tail -f ~/sistema-riego/logs/riego.log # Ver uso de CPU top # Ver temperatura de la Raspberry Pi vcgencmd measure_temp # Ver memoria disponible free -h # Ver espacio en disco df -h
11.2 Comandos de Configuración¶
# Editar configuración nano ~/sistema-riego/config.py # Ver configuración actual cat ~/sistema-riego/config.py # Hacer respaldo de configuración cp ~/sistema-riego/config.py ~/sistema-riego/config.py.backup # Restaurar configuración cp ~/sistema-riego/config.py.backup ~/sistema-riego/config.py
11.3 Comandos de Logs¶
# Ver últimas 100 líneas del log tail -n 100 ~/sistema-riego/logs/riego.log # Buscar eventos de riego grep "RIEGO" ~/sistema-riego/logs/riego.log # Contar eventos de riego de hoy grep "$(date +%Y-%m-%d)" ~/sistema-riego/logs/riego.log | grep "RIEGO_ACTIVO" | wc -l # Ver errores grep "ERROR" ~/sistema-riego/logs/riego.log # Limpiar logs antiguos (más de 30 días) find ~/sistema-riego/logs/ -name "*.log" -mtime +30 -delete
12. Contacto y Soporte¶
12.1 Información del Proyecto¶
Proyecto: Sistema de Riego Automatizado con Raspberry Pi
Asignatura: Proyecto II
Institución: Universidad de Tarapacá - Ingeniería Civil en Computación e Informática
Profesor: Diego Aracena Pizarro
12.2 Equipo de Desarrollo¶
| Nombre | Correo Electrónico | Rol |
|---|---|---|
| Bairon Núñez | bairon.nunez.godoy@alumnos.uta.cl | Jefe de Proyecto / Programador |
| Christopher Romo | christopher.romo@alumnos.uta.cl | Documentador |
| Gustavo Morales | gustavo.morales@alumnos.uta.cl | Diseñador |
12.3 Recursos Adicionales¶
- Repositorio del proyecto: [https://github.com/norybb/Huerto-IoT-Unity]
- Documentación completa: Ver todas las secciones