RasPY Utility
Benvenuti nella Documentazione di RasPY Utility
RasPY Utility è un’applicazione completa per il controllo e il monitoraggio dei pin GPIO del Raspberry Pi attraverso un’interfaccia grafica intuitiva o un’API REST.
Indice
Introduzione
Sviluppo
Risorse Aggiuntive
Comunità
Funzionalità Principali
✅ Interfaccia Grafica Moderna
- Tema chiaro/scuro
- Supporto multilingua
- Visualizzazione in tempo reale dello stato dei pin
- Integrazione con la barra delle applicazioni
🔌 Supporto Completo GPIO
- Controllo pin I/O digitali
- Simulatore integrato per lo sviluppo
- Rilevamento automatico dell’hardware
- Supporto GPIO remoto
🌐 Interfaccia Web
- Server web integrato
- Design reattivo per dispositivi mobili/desktop
- Aggiornamenti in tempo reale
- Documentazione API integrata
Guida Rapida
- Installazione - Come installare e configurare RasPY Utility
- Guida - Guida all’utilizzo dell’applicazione
- API - Documentazione API per sviluppatori
- Sviluppo - Guida allo sviluppo e ai contributi
Guida Utente
Interfaccia Grafica
L’interfaccia grafica di RasPY 4 Utility è progettata per essere intuitiva e facile da usare.
- File: Controlli generali dell’applicazione
- GPIO: Gestione pin GPIO e simulatore
- Visualizza: Personalizzazione dell’interfaccia
- Aiuto: Documentazione e informazioni
Controllo GPIO
- Apri la finestra di controllo GPIO dal menu
- Seleziona il pin da controllare
- Usa i pulsanti per attivare/disattivare i pin
- Monitora lo stato in tempo reale
Simulatore GPIO
Il simulatore consente di testare il codice senza hardware fisico:
- Avvia il simulatore dal menu GPIO
- Usa l’interfaccia per simulare input/output
- Le modifiche si riflettono in tempo reale
Registro e Debug
L’applicazione registra gli eventi importanti nel file logs/app.log. Usa il Visualizzatore di Log integrato per:
- Filtrare i messaggi per livello (INFO, AVVISO, ERRORE)
- Cercare messaggi specifici
- Esportare i log per l’analisi
Scorciatoie da Tastiera
- Ctrl+Q: Esci dall’applicazione
- F1: Mostra aiuto
- Ctrl+L: Apri il visualizzatore di log
- F5: Aggiorna l’interfaccia
Riferimento API
Panoramica
L’API REST di RasPY 4 Utility consente di controllare i pin GPIO tramite richieste HTTP.
Tutte le risposte sono in formato JSON.
Endpoint Disponibili
GET /api/gpio
Restituisce lo stato di tutti i pin GPIO configurati.
Esempio di risposta:
{
"17": {"stato": 0, "modalita": "out", "descrizione": "LED Rosso"},
"18": {"stato": 1, "modalita": "in", "descrizione": "Pulsante"}
}
GET /api/gpio/<int:pin>
Restituisce lo stato di un pin specifico.
Parametri:
Codici di stato:
- 200: Operazione riuscita
- 404: Pin non trovato
Esempio di risposta:
{
"stato": 0,
"modalita": "out",
"descrizione": "LED Rosso"
}
POST /api/gpio/<int:pin>/on
Attiva il pin specificato.
Parametri:
Codici di stato:
- 200: Operazione riuscita
- 400: Pin non valido o non scrivibile
POST /api/gpio/<int:pin>/off
Disattiva il pin specificato.
Parametri:
Codici di stato:
- 200: Operazione riuscita
- 400: Pin non valido o non scrivibile
Esempi di Utilizzo
Controllo GPIO con Python
import requests
URL_BASE = "http://localhost:5000/api/gpio"
# Ottieni lo stato di tutti i pin
risposta = requests.get(f"{URL_BASE}")
print("Stato attuale:", risposta.json())
# Attiva il pin 17
risposta = requests.post(f"{URL_BASE}/17/on")
print("Risposta attivazione:", risposta.status_code)
Risorse Utili
