CP-Controlle PLUS – Configuration réseau

1) Prérequis et vocabulaire

1.1) Prérequis matériels

• CP-Controller CoralPlast alimenté (12V selon votre installation).
• Téléphone ou PC avec Wi-Fi.
• Le fichier firmware CoralPlast (extension .bin) fourni par CoralPlast.
• (Option Home Assistant) un Home Assistant déjà fonctionnel sur votre réseau.

1.2) Vocabulaire simple (AP / STA / IP / mDNS)

• AP (Point d’accès) : le CP-Controller crée son propre Wi-Fi. Vous vous connectez directement dessus.
• STA (Wi-Fi maison) : le CP-Controller se connecte à votre box/routeur, comme un appareil normal.
• IP LAN : l’adresse locale donnée par votre box au CP-Controller (ex. 192.168.1.89).
• mDNS / .local : accès par nom (ex. http://cp-controller-reef.local), pratique si l’IP change.

2) Mise à jour du firmware (première fois, depuis ancien firmware AP seul)

2.1) Ce que vous allez obtenir après mise à jour

• Une interface Web modernisée (toujours via AP).
• Un bouton OTA Update dans l’interface Web (ElegantOTA).
• Un assistant WiFi / LAN Setup pour connecter l’appareil à votre box (STA) sans perdre l’AP.
• Un bouton rapide “Connexion avec réglages enregistrés” (connexion STA en 1 tap, sans refaire l’assistant).
• Un nom d’appareil configurable (hostname) + accès mDNS en http://<nom>.local.
• Des endpoints réseau pour Home Assistant : /status, /wifi/status, commandes /resetusage, etc.

2.2) Mise à jour OTA (ElegantOTA) – procédure

Étape A – se connecter au Wi-Fi du CP-Controller

1. Sur votre téléphone/PC, ouvrez la liste des réseaux Wi-Fi.
2. Connectez-vous au réseau du CP-Controller (nom du type CP-Control_XXXXXX).
3. Mot de passe AP (si demandé) : 123456789 (sauf indication contraire CoralPlast).

Étape B – ouvrir l’interface Web

• Ouvrez un navigateur.
• Entrez : http://192.168.4.1

Étape C – accéder à l’OTA

• Dans le coin supérieur droit, cliquez sur OTA Update.
• Ou entrez directement : http://192.168.4.1/update

Étape D – identifiants OTA

• Utilisateur : admin
• Mot de passe : admin

Étape E – envoyer le firmware

1. Cliquez sur Choisir un fichier.
2. Sélectionnez le fichier .bin fourni par CoralPlast.
3. Cliquez sur Update.
4. Attendez la fin complète (en général 30 à 60 secondes).

2.3) Après la mise à jour

• Le CP-Controller redémarre automatiquement.
• Reconnectez-vous si besoin au Wi-Fi du CP-Controller (CP-Control_XXXXXX).
• Rouvrez : http://192.168.4.1

3) Première connexion au CP-Controller (réseau AP CoralPlast)

3.1) Pourquoi l’AP est indispensable

• Tous les CP-Controller sont accessibles en AP à tout moment.
• Après mise à jour, l’AP reste le moyen le plus simple pour configurer la connexion Wi-Fi maison (STA).
• En 1.9.2, le contrôleur démarre en AP uniquement : c’est normal.

3.2) Se connecter à l’AP CoralPlast

1. Ouvrez la liste Wi-Fi du téléphone/PC.
2. Connectez-vous au SSID : CP-Control_XXXXXX (suffixe variable).
3. Mot de passe : 123456789 (sauf indication contraire).
4. Ouvrez le navigateur → http://192.168.4.1

4) Connexion au Wi-Fi de la maison (assistant “WiFi / LAN Setup”)

4.1) Principe (mise à jour 1.9.2)

• L’AP reste actif pour accéder au contrôleur à tout moment.
• Le Wi-Fi maison (STA) est désactivé au démarrage (aucune tentative automatique).
• Vous lancez la connexion STA uniquement avec :
• “Enregistrer & connecter” (assistant), ou
• “Connexion avec réglages enregistrés” (bouton rapide, 1 tap).
• Une fois connecté, le contrôleur publie un nom mDNS : http://<nom>.local

4.2) Ouvrir l’assistant

1. Dans l’interface Web, descendez sous “Advanced Settings”.
2. Cliquez sur WiFi / LAN Setup.
3. Une fenêtre (assistant) s’ouvre en 3 étapes : 1) Name → 2) Network → 3) Connect.

4.3) (Option rapide) Connexion avec réglages enregistrés

Quand ce bouton apparaît

• Si vous avez déjà enregistré un SSID/mot de passe auparavant, un bouton “Connexion avec réglages enregistrés” apparaît :
• sur la page principale (près de “WiFi / LAN Setup”),
• et aussi dans l’assistant.

Ce que fait ce bouton

• Il démarre la connexion STA en 1 tap, sans refaire l’assistant.
• Si ça échoue (SSID changé, mauvais mot de passe…), l’AP reste disponible : vous pouvez rouvrir l’assistant et corriger.

4.4) Étape 1 : choisir le nom de l’appareil (hostname)

Règles de nommage

• Utilisez uniquement : a-z, 0-9 et -
• Les espaces/underscore/points sont automatiquement transformés en “-”.
• Conseil : si vous avez plusieurs unités, choisissez un nom unique (ex. cp-controller-reef1).

Pourquoi ce nom est important

• Il apparaît dans la liste de votre routeur (nom DHCP).
• Il sert à l’adresse mDNS : http://<nom>.local

4.5) Étape 2 : choisir le réseau Wi-Fi (SSID) et le mot de passe

Option A (recommandée) : “Scan networks”

1. Cliquez sur Scanner les réseaux.
2. Attendez la fin du scan.

Option B : saisie manuelle

• Si votre réseau n’apparaît pas, saisissez le SSID manuellement.
• Entrez le mot de passe (laissez vide uniquement si votre Wi-Fi est ouvert, ce qui est déconseillé).

4.6) Étape 3 : “Enregistrer & connecter” (lancer la connexion STA)

1. Vérifiez le résumé (Nom + SSID).
2. Cliquez sur Enregistrer & connecter.
3. Le message indique “Connexion… (l’AP reste disponible)”.

Comment savoir si c’est connecté

• Dans l’assistant, “LAN IP” passe de “-” à une adresse (ex. 192.168.1.89).
• Le champ “mDNS” affiche : http://<nom>.local/
• Sur la page principale, le statut Wi-Fi affiche : “Connecté • IP : …”.

Cas fréquent : “réglages enregistrés mais inactifs”

• En 1.9.2, il est normal de voir : “Wi-Fi LAN enregistré mais inactif. Ouvrez l’assistant pour vous connecter.”
• Cela signifie : SSID/mot de passe sont bien sauvegardés, mais la connexion STA n’a pas été lancée.
• Solution : cliquez sur “Connexion avec réglages enregistrés” ou ouvrez l’assistant et faites “Enregistrer & connecter”.

4.7) Désactiver le Wi-Fi maison (si vous voulez AP uniquement)

• Dans l’étape 3, cliquez sur Désactiver Wi-Fi LAN.
• Le CP-Controller revient en mode AP uniquement (stabilité maximale).

5) Accès au tableau de bord : AP / IP LAN / .local

5.1) Accès via AP (toujours disponible)

• Connectez-vous au Wi-Fi CP-Control_XXXXXX
• Ouvrez : http://192.168.4.1

5.2) Accès via réseau maison (IP LAN)

• Votre téléphone/PC doit être sur le même Wi-Fi que le routeur (Wi-Fi maison).
• Ouvrez l’IP LAN affichée dans l’assistant (ex. http://192.168.1.89).

5.3) Accès via .local (mDNS) – recommandé

• Votre téléphone/PC doit être sur le réseau maison.
• Ouvrez : http://<nom>.local (ex. http://cp-controller-reef1.local).

6) Home Assistant : installation du package (capteurs + commandes)

6.1) Pré-requis côté CP-Controller

• Le CP-Controller doit être connecté au Wi-Fi maison (STA) via l’assistant ou “Connexion avec réglages enregistrés”.
• Vous devez connaître son IP LAN (ex. 192.168.1.89) ou son <nom>.local.
• Home Assistant doit être sur le même réseau.

6.2) Créer la structure “packages” dans Home Assistant

Emplacement attendu

• Dans le dossier de configuration Home Assistant (là où se trouve configuration.yaml), créez un dossier nommé : packages
• Créez ensuite le fichier : packages/cp_controller.yaml

Activer les packages (une seule fois)

Dans votre configuration.yaml, assurez-vous d’avoir :

homeassistant:
  packages: !include_dir_named packages

6.3) Copier le package CoralPlast CP-Controller

Contenu recommandé

Collez le contenu YAML fourni par CoralPlast dans :

• packages/cp_controller.yaml

Point crucial : l’adresse du contrôleur

• Dans le package, modifiez : input_text.cp_controller_host
• Exemple IP : http://192.168.1.89
• Exemple .local : http://cp-controller-reef1.local

6.4) Redémarrer Home Assistant

1. Paramètres → Système → Redémarrer.
2. Attendez le retour complet de l’interface.

6.5) Vérifier que les entités sont bien créées

Allez dans :

• Outils de développement → États
• Cherchez : sensor.cp_controller_raw_status

Résultat attendu

• sensor.cp_controller_raw_status doit avoir l’état : OK
• Les capteurs dérivés doivent afficher des valeurs (Used, Remaining, Roll Usage…)
• Les commandes doivent être disponibles (advance, reset, etc.)

7) Home Assistant : ajout de la carte Lovelace

7.1) Ajouter une carte “Manuelle”

1. Ouvrez votre Dashboard.
2. Cliquez sur Modifier le tableau de bord.
3. Ajoutez une carte → Manuelle (ou “Manual”).
4. Collez le YAML Lovelace fourni par CoralPlast.
5. Enregistrez.

7.2) Ce que la carte doit afficher

• Utilisé (m), Restant (m), Usure (%), Connexion
• Bouton “Avancer (1s)” (avance temporisée)
• Bouton “Reset” (reset usage/log)
• Historique (24h) : Usure %, Eau haute, Moteur en marche

7.3) Note importante sur les boutons

• Avancer (1s) est volontairement temporisé (sécurité) : il ne nécessite pas de “relâcher”.
• Le reset appelle la commande /resetusage (POST) du CP-Controller.

8) Dépannage rapide (FAQ)

8.1) Le CP-Controller n’apparaît pas sur mon Wi-Fi maison

• C’est normal si vous n’avez pas lancé la connexion STA : par défaut, le firmware démarre en AP uniquement.
• Ouvrez WiFi / LAN Setup depuis l’AP (192.168.4.1), puis “Enregistrer & connecter”.
• Ou cliquez sur “Connexion avec réglages enregistrés” (si disponible).
• Vérifiez SSID et mot de passe, évitez les réseaux “invités” ou isolés.

8.2) Le scan de réseaux déconnecte mon téléphone

• C’est normal (limitation ESP8266).
• Reconnectez le Wi-Fi CP-Control_XXXXXX puis rouvrez http://192.168.4.1.

8.3) L’adresse .local ne fonctionne pas

• Essayez l’IP LAN (ex. http://192.168.1.89).
• Certains routeurs/appareils gèrent mal le mDNS ; dans ce cas, utilisez l’IP ou configurez une réservation DHCP.

8.4) Home Assistant affiche “Unavailable” sur les cartes

• Vérifiez que le CP-Controller est bien connecté en STA (IP LAN visible dans l’assistant).
• Vérifiez que input_text.cp_controller_host pointe vers l’IP LAN / .local correct.
• Redémarrez Home Assistant après toute modification du package.

8.5) Les boutons Home Assistant ne déclenchent rien

• Testez dans Outils de développement → Services la commande REST correspondante (reset, advance…).
• Si ça marche en service mais pas sur la carte, vérifiez l’entity_id appelé par la carte.
• Assurez-vous que l’URL du host commence bien par http://.

Support CoralPlast

Site : www.coralplast.fr
Contact : https://coralplast.fr/nous-contacter/