Retour à l'accueilDocumentation Domus

DOMUS - Manuel Technique et Guide d'Utilisation

Bienvenue dans le guide technique du système domotique Domus. Ce document détaille la procédure de mise en route du boîtier matériel (ESP32) et la signification de ses différents états.

1. Prérequis matériels et avertissements

Alimentation :L'appareil est conçu pour être alimenté via son port USB-C (5V). Le code intègre une bride logicielle de sécurité à 400mA pour protéger le port USB de votre ordinateur ou votre chargeur.
Réseau Wi-Fi :Le microcontrôleur ESP32 ne supporte que la bande 2.4 GHz. Assurez-vous que votre routeur ou votre partage de connexion mobile diffuse sur cette fréquence (Option "Maximiser la compatibilité" sur iPhone, par exemple). Il est recommandé d'utiliser un partage de connexion même si une box wifi peut fonctionner selon sa configuration.
Réseaux d'entreprise :L'appareil ne prend pas en charge les réseaux nécessitant un portail d'authentification complexe, comme des réseaux universitaires par exemple. Privilégiez un partage de connexion classique ou une box domestique.

2. Tutoriel pas-à-pas : Appairage de l'appareil

L'appareil fonctionne de manière autonome (Plug & Play) et ne nécessite aucune modification de code pour changer de réseau Wi-Fi. Voici comment lier le boîtier physique à votre compte web.

Étape 1 : Récupérer le Hardware Token

  • Rendez-vous sur l'application Web Domus (https://domus.eric-leclerc.dev).
  • Connectez-vous à votre compte utilisateur ou inscrivez-vous.
  • Dans la section profil, repérez et copiez le Jeton Matériel (Hardware Token) affiché à l'écran (il commence généralement par foyer_...). C'est la clé de sécurité unique de votre domicile.

Étape 2 : Alimenter l'appareil

  • Branchez l'ESP32 à une source d'alimentation USB.
  • Le bandeau LED va s'initialiser. S'il ne trouve aucun réseau connu en mémoire, il va se mettre à respirer lentement en BLEU. Cela signifie qu'il est prêt à être configuré.

Étape 3 : Connexion au Portail Captif

  • Prenez votre smartphone (ou votre ordinateur) et ouvrez les paramètres Wi-Fi.
  • Connectez-vous au nouveau réseau Wi-Fi créé par le boîtier, nommé : Foyer_Connecte
  • Mot de passe du réseau : Admin1234
  • Une page de configuration devrait s'ouvrir automatiquement sur votre écran (Portail Captif). Si la page ne s'ouvre pas, ouvrez votre navigateur et tapez l'adresse : http://192.168.4.1.

Étape 4 : Configuration du réseau

Sur la page Web de configuration de l'appareil :

  • Nom du réseau (SSID) : Entrez le nom exact de votre box Wi-Fi ou de votre partage de connexion (Attention aux majuscules et aux espaces).
  • Mot de passe : Entrez la clé de sécurité de votre Wi-Fi.
  • Hardware Token : Collez le jeton récupéré à l'Étape 1.
  • Cliquez sur le bouton de validation. Le boîtier va redémarrer et se connecter à votre wifi. En cas de partage de connexion, activer le partage quand l'esp32 cherche le wifi (bande led de couleur orange). Une fois connecté, la bande devrait émettre une courte lumière verte.

3. Guide de diagnostic : Codes Lumineux

L'appareil est conçu pour communiquer son état réseau via le ruban LED. Voici la signification des couleurs lors de la phase de démarrage :

  • Bleu (Respiration) : Mode Configuration (Portail Captif actif). Connectez-vous au réseau Foyer_Connecte.
  • Orange (Clignotement) : Tentative de connexion au Wi-Fi en cours. Patientez.
  • Vert (Fixe, 2 secondes) : SUCCÈS. Connecté au Wi-Fi et prêt à l'emploi.
  • Rouge (Fixe, 3 secondes) : ERREUR WI-FI. Réseau introuvable ou mauvais mot de passe.
  • Violet (3 flashs rapides) : ERREUR PARE-FEU. Connecté au Wi-Fi, mais accès Internet bloqué

4. Redémarrage de l'appareil

Pour redémarrer l'appareil, appuyez sur le bouton EN.

5. Avertissement

L'ESP32 est programmé pour communiquer en HTTPS (IPv4) avec l'API Laravel. Lors des phases de test matériel, il a été identifié que certains smartphones utilisés en "Partage de connexion" (notamment les Samsung Galaxy ou selon les restrictions de certains opérateurs mobiles) bloquent activement et physiquement les requêtes HTTP/HTTPS sortantes des microcontrôleurs via leur pare-feu interne.

Symptôme :

Si le bandeau LED flashe en VIOLET lors de son utilisation, cela signifie que votre smartphone bloque délibérément la connexion Internet de l'appareil (Erreur Connection Refused code -1).

Solution :

Ce comportement est externe au code du projet. Pour réaliser les tests matériels dans de bonnes conditions, merci de privilégier un autre smartphone non restreint en partage de connexion (en forçant le protocole APN sur IPv4/IPv6 si possible).

En cas de difficultés à faire fonctionner l'appareil, veuillez contacter le webmaster de domus à l'adresse suivante : leclerceric05@gmail.com.