Web PWA APP de contrôle du module 8 relais WaveShare/Pico-W via via API's

Vue d'ensemble de la solution

Ce système permet de contrôler jusqu'à 8 relais du module waveshare via un Raspberry Pi Pico W.

Il offre une interface REST API et intègre des fonctionnalités de surveillance système, de journalisation des événements et de persistance des états.

Architecture du Système

Le système est composé de deux parties principales :

• Un serveur Flask (app.py) qui sert l'interface web et fait le pont avec le Pico
• Un client Pico (main.py) qui gère les relais et expose une API REST

Référence du module: https://www.waveshare.com/pico-relay-b.htm

Caractéristiques principales

• Contrôle de 8 relais indépendants
• Interface REST API
• Indicateur LED RGB
• Surveillance système (température, mémoire, tension)
• Journalisation des événements
• Sauvegarde persistante des états
• Support SSL optionnel

Configuration

Configuration matérielle

RELAY_PINS = {
    "1": 21, "2": 20, "3": 19, "4": 18,
    "5": 17, "6": 16, "7": 15, "8": 14
}
LED_PIN = 13
BUZZER_PIN = 6

Fichiers requis

• secrets.py : Contient les informations de connexion WiFi et SSL
• relay_states.json : Stockage persistant des états des relais
• mm_wlan.py : Module de gestion WiFi

Composants matériels

• Raspberry Pi Pico W
• 8 relais
• LED RGB (NeoPixel)
• Buzzer
• LED embarquée

API REST

Endpoints disponibles

État des relais

GET /relays

Retourne l'état de tous les relais

{
    "1": false,
    "2": true,
    ...
    "8": false
}

Contrôle d'un relai

POST /relay/<id>/<state>

• id : Identifiant du relai (1-8)
• state : État souhaité (0/1)

Contrôle de tous les relais

POST /allrelays/<state>

• state : État souhaité (0/1)

Informations système

GET /system

Retourne les informations système :

{
    "ip_address": "192.168.1.100",
    "ssid": "MyNetwork",
    "free_memory": "100",
    "temperature": "25.5",
    "voltage": "3.3",
    "time": "12:34:56",
    "date": "31.12.2024"
}

Journal des événements

GET /events

Retourne les derniers événements système

Redémarrage

POST /reboot

Redémarre le système

Classes principales

Class Config

Gère la configuration centralisée :

• Mapping des pins
• Définitions des couleurs
• Configuration système

Class PicoBoardRelay

Gère l'ensemble du système :

• Initialisation des relais
• Gestion des états
• Journalisation
• Surveillance système

Fonctionnalités

Gestion des relais

• Contrôle individuel des relais
• Contrôle groupé
• Sauvegarde automatique des états
• Restauration des états au démarrage

Surveillance système

• Température du processeur
• Tension d'alimentation
• Utilisation mémoire
• État de la connexion WiFi
• Horodatage

Journalisation

• Conservation des 200 derniers événements
• Horodatage des événements
• Types d'événements : INFO, WARNING, ERROR

Gestion des états

Persistance

Les états des relais sont sauvegardés dans relay_states.json :

{
    "1": false,
    "2": true,
    ...
    "8": false
}

Restauration

Au démarrage, le système :

1. Charge les états sauvegardés
2. Configure les relais selon ces états
3. Initialise le système de journalisation

Surveillance système

Mesures disponibles

• Température CPU
• Tension d'alimentation
• Mémoire libre/utilisée
• État de la connexion réseau

Format des événements

{
    "message": "INFO: Relay 1 set to True",
    "time": "12:34:56",
    "date": "31/12/2024"
}

Sécurité

• Support SSL optionnel
• Authentification WiFi
• Stockage sécurisé des credentials dans secrets.py

Dépannage

Problèmes courants

1. Perte de connexion WiFi

   • Vérifier les credentials dans secrets.py
   • Vérifier la portée du signal

2. États des relais incorrects

   • Vérifier relay_states.json
   • Redémarrer le système

3. Erreurs mémoire

   • Surveillance de l'utilisation mémoire via /system
   • Nettoyage automatique du journal des événements

Documentation de l'interface Web (PWA) Flask

Table des matières

• Vue d'ensemble
• Configuration
• Routes et Endpoints
• Progressive Web App
• Gestion des erreurs
• Installation
• Développement

Vue d'ensemble

Cette application Flask sert d'interface web pour un système de contrôle de relais Pico W. Elle fournit une interface utilisateur web complète et gère la communication avec le Pico W via une API REST.

Configuration

Le serveur Flask est configuré pour :

• Écouter sur toutes les interfaces (0.0.0.0)
• Port 80 par défaut
• CORS activé pour http://localhost
• Communication avec le Pico sur http://192.168.1.109

Points d'Accès (Routes)

Routes Principales

Route	Méthode	Description
/	GET, POST	Page d'accueil avec état des relais
/relais	GET, POST	Interface de contrôle des relais
/system	GET, POST	Informations système
/parameters	GET, POST	Page de paramètres
/events	GET, POST	Journal des événements

Routes PWA

Route	Méthode	Description
/__service-worker.js	GET	Service Worker pour PWA
/__manifest.json	GET	Manifeste PWA

Routes API

Route	Méthode	Description
/get_relay_state	GET, POST	Obtenir l'état des relais
/reboot	GET, POST	Redémarrer le Pico

Gestion des Erreurs

Le serveur implémente une gestion robuste des erreurs avec :

• Timeout de 3 secondes pour les requêtes
• États par défaut en cas de déconnexion
• Gestion des exceptions de connexion

Diagnostic

1. Vérification de connexion : http://<adresse_ip_pico>/system
2. État des relais : http://<adresse_ip_pico>/relays
3. Journal système : http://<adresse_ip_pico>/events

Développement Futur

Axes d'amélioration potentiels :

1. Authentification utilisateur
2. Planification des tâches
3. Intégration MQTT
4. Interface API étendue
5. Support de configurations avancées