Utilidad RasPY
Bienvenido a la documentación de Utilidad RasPY
Utilidad RasPY es una aplicación completa para controlar y monitorear pines GPIO de Raspberry Pi a través de una interfaz gráfica intuitiva o API REST.
Tabla de Contenidos
Introducción
Desarrollo
Recursos Adicionales
Comunidad
Características Principales
✅ Interfaz Gráfica Moderna
- Tema claro/oscuro
- Soporte multilingüe
- Visualización en tiempo real del estado de los pines
- Integración con bandeja del sistema
🔌 Soporte Completo para GPIO
- Control de pines digitales de entrada/salida
- Simulador integrado para desarrollo
- Detección automática de hardware
- Soporte para GPIO remoto
🌐 Interfaz Web
- Servidor web integrado
- Diseño adaptable para móvil/escritorio
- Actualizaciones en tiempo real
- Documentación de API integrada
Inicio Rápido
- Instalación - Cómo instalar y configurar Utilidad RasPY
- Guía - Guía de uso de la aplicación
- API - Documentación de la API para desarrolladores
- Desarrollo - Guía de desarrollo y contribución
Guía del Usuario
Interfaz Gráfica
La interfaz gráfica de Utilidad RasPY 4 está diseñada para ser intuitiva y fácil de usar.
Menú Principal
- Archivo: Controles generales de la aplicación
- GPIO: Gestión de pines GPIO y simulador
- Vista: Personalización de la interfaz
- Ayuda: Documentación e información
Control de GPIO
- Abra la ventana de control de GPIO desde el menú
- Seleccione el pin a controlar
- Use los botones para cambiar el estado de los pines
- Monitoree el estado en tiempo real
Simulador de GPIO
El simulador permite probar código sin hardware físico:
- Inicie el simulador desde el menú GPIO
- Use la interfaz para simular entradas/salidas
- Los cambios se reflejan en tiempo real
Registro y Depuración
La aplicación registra eventos importantes en el archivo logs/app.log. Use el Visor de Registros integrado para:
- Filtrar mensajes por nivel (INFO, ADVERTENCIA, ERROR)
- Buscar mensajes específicos
- Exportar registros para análisis
Atajos de Teclado
- Ctrl+Q: Salir de la aplicación
- F1: Mostrar ayuda
- Ctrl+L: Abrir visor de registros
- F5: Actualizar interfaz
Referencia de la API
Visión General
La API REST de Utilidad RasPY 4 permite controlar pines GPIO mediante peticiones HTTP.
Todas las respuestas están en formato JSON.
Puntos Finales Disponibles
GET /api/gpio
Devuelve el estado de todos los pines GPIO configurados.
Ejemplo de respuesta:
{
"17": {"state": 0, "mode": "out", "description": "LED Rojo"},
"18": {"state": 1, "mode": "in", "description": "Botón"}
}
GET /api/gpio/<int:pin>
Devuelve el estado de un pin específico.
Parámetros:
Códigos de estado:
- 200: Operación exitosa
- 404: Pin no encontrado
Ejemplo de respuesta:
{
"state": 0,
"mode": "out",
"description": "LED Rojo"
}
POST /api/gpio/<int:pin>/on
Enciende el pin especificado.
Parámetros:
Códigos de estado:
- 200: Operación exitosa
- 400: Pin inválido o no escribible
POST /api/gpio/<int:pin>/off
Apaga el pin especificado.
Parámetros:
Códigos de estado:
- 200: Operación exitosa
- 400: Pin inválido o no escribible
Ejemplos de Uso
Control de GPIO con Python
import requests
BASE_URL = "http://localhost:5000/api/gpio"
# Obtener estado de todos los pines
response = requests.get(f"{BASE_URL}")
print("Estado actual:", response.json())
# Encender el pin 17
response = requests.post(f"{BASE_URL}/17/on")
print("Respuesta de encendido:", response.status_code)
Recursos Útiles
