Équipements¶

Les équipements sont le concept central de Sowel. Un équipement est une unité fonctionnelle avec laquelle vous interagissez au quotidien : "Spots Cuisine", "Volets Chambre", "Capteur Cuisine".

Un device est ce qui est sur le réseau, un équipement est ce qui est dans la pièce. Vous ne pensez jamais au module variateur Zigbee installé derrière le mur, vous pensez aux lumières de votre cuisine.

Page admin Équipements regroupée par zone et par type

Créer un équipement¶

Allez dans Administration > Équipements et cliquez sur Ajouter un équipement.

Étape 1 : Informations de base¶

Champ	Obligatoire	Description
Type	Oui	La catégorie de l'équipement (voir Types d'équipements plus bas)
Nom	Oui	Un nom parlant comme "Spots Cuisine" ou "Capteur Cuisine"
Zone	Oui	À quelle pièce ou zone cet équipement appartient
Description	Non	Une note pour vous-même

Le type ne peut pas être modifié après création

Choisissez le type avec soin, il détermine quels devices sont compatibles et comment l'équipement est affiché.

Étape 2 : Sélectionner les devices¶

Cliquez sur Suivant : Sélectionner les devices pour voir la liste des devices compatibles. Sowel filtre automatiquement les devices selon le type d'équipement.

Sélectionnez un ou plusieurs devices
Cliquez sur Créer

C'est tout. Sowel crée automatiquement toutes les liaisons de données et de commandes. Chaque valeur que le device expose (température, humidité, batterie...) devient immédiatement disponible sur l'équipement.

Vous pouvez ignorer la sélection de device

Vous pouvez créer un équipement sans device et en lier un plus tard depuis la page de détail.

Liaison multi-devices¶

Un seul équipement peut se lier à plusieurs devices. C'est une des fonctionnalités les plus puissantes de Sowel.

Exemple : Trois modules variateurs IKEA séparés alimentent les spots de votre cuisine. Créez un seul équipement "Spots Cuisine" et liez les trois. Un seul interrupteur allume les trois. Un seul curseur les variégradue tous les trois.

Types d'équipements¶

Lumières¶

Lumière (On/Off)¶

Contrôle simple on/off d'une lumière.

Contrôles : Bascule ON/OFF
Données attendues : état (on/off)

Lumière (Variateur)¶

Lumière à luminosité réglable.

Contrôles : Bascule ON/OFF + curseur de luminosité
Données attendues : état, niveau de luminosité

Lumière (Couleur)¶

Lumière à couleur réglable, avec température de couleur en option.

Contrôles : Bascule + curseur de luminosité + contrôles de couleur
Données attendues : état, luminosité, couleur, température de couleur

Volets¶

Volet¶

Volet roulant motorisé, store ou volet.

Contrôles : Boutons Ouvrir / Stop / Fermer, affichage de la position
Données attendues : position (0 % = fermé, 100 % = ouvert)

Store banne¶

Store banne extérieur motorisé.

Contrôles : Boutons Rétracter / Stop / Déployer, affichage de la position
Données attendues : position (0 % = rétracté, 100 % = déployé)

Le store banne partage la surface de contrôle du volet (même binding shutter_position, mêmes boutons OPEN/STOP/CLOSE) mais affiche un vocabulaire dédié dans toute l'UI : pastilles Déployé / Rétracté, boutons Déployer / Rétracter, groupe "Stores bannes" séparé dans la vue zone. Mapping : RF-up = rétracter = position 0, RF-down = déployer = position 100. Le plugin somfy-rts couvre les deux familles (volets + stores) sur le même matériel Somfy RTS.

Climatisation¶

Thermostat¶

Contrôle de chauffage ou de climatisation : climatiseur, poêle à granulés, pompe à chaleur.

Contrôles : Affichage de la température, ajustement de la consigne (+/-), allumage/extinction, mode
Cœur : température courante, consigne, état de marche, alimentation, mode de fonctionnement
Extras (selon le device) : tout le reste, vitesse du ventilateur, ioniseur, profil de poêle…

Un thermostat a un cœur et des extras. Le cœur est le petit ensemble que tous les thermostats partagent et sur lequel toutes les surfaces de Sowel s'appuient : temperature, setpoint, state, power, operationMode, plus outsideTemperature quand l'unité a une sonde extérieure. Sowel reconnaît un device comme thermostat dès qu'on peut lui donner une consigne, quel que soit le nom de la clé chez le plugin. Tout ce que le device offre en plus (une vitesse de ventilation, un ioniseur, le programme et la remise à zéro d'alarme d'un poêle à granulés, un réglage d'un fabricant que Sowel n'a jamais rencontré) est lié aussi, mais comme extra : la carte mène avec le cœur et liste les extras dans une section secondaire, un contrôle par commande liée (des boutons pour un choix, un interrupteur pour un marche/arrêt, un bouton d'action pour un déclenchement, un pas à pas pour un nombre) et une puce par lecture. Les extras varient d'un thermostat à l'autre et ne définissent jamais le type. Le mode de fonctionnement utilise un vocabulaire commun : auto, heat, cool, dry, fan, et off sur les unités dont le mode porte l'arrêt.

Sur un thermostat, l'état marche/arrêt rapporté par le device lui-même est lié sous l'alias state, le même alias marche/arrêt que les équipements à relais. C'est important sur un thermostat sous-compté (une pompe à chaleur mesurée par une pince) : l'alias power y porte la puissance instantanée, et un wattage ne dit pas à l'interface si l'unité est allumée ou en veille. Si la carte du thermostat ne passe jamais à ON, ouvrez le panneau des liaisons manquantes de l'équipement et ajoutez la donnée d'alimentation du device : elle est proposée sous state. Les thermostats existants dont le booléen est lié directement sous power continuent de fonctionner sans changement.

Radiateur¶

Radiateur électrique individuel piloté par relais fil pilote.

Contrôles : Bascule Confort / Éco
Données attendues : état du relais (ON = éco, OFF = confort)

Chauffe-eau¶

Chauffe-eau / cumulus piloté par un relais on/off. Le canal on/off est lié automatiquement (ainsi que sa puissance/énergie si le relais les mesure).

Contrôles : Bascule Marche / Arrêt, plus une bascule Solaire dédiée lorsqu'un canal solaire est lié
Données attendues : état du relais on/off, température d'eau optionnelle (affichage seul, exclue de la moyenne de température ambiante de la zone), puissance/énergie optionnelles
Canal solaire (optionnel) : un second on/off indépendant, lié sur un contact dédié (par exemple un relais Zigbee contact sec SONOFF MINI-ZBD qui pilote l'entrée photovoltaïque d'un chauffe-eau thermodynamique). Il est distinct de la marche normale de l'appareil : sur un chauffe-eau en alimentation permanente, seule la bascule Solaire apparaît. La carte affiche une bascule par canal lié (Marche/Arrêt si présent, Solaire si présent).
La consigne réglable est volontairement hors périmètre (ce serait un thermostat). L'équipement fournit le canal de commande solaire (l'actionneur) ; la logique de pilotage sur surplus solaire reste dans une recette qui pilote ce canal via l'arbitre d'énergie.

Accès¶

Portail¶

Portail, portail coulissant, ou porte de garage.

Contrôles : Bouton Ouvrir/Fermer avec indicateur d'état
Données attendues : état du portail (ouvert, fermé, en ouverture, en fermeture)

Icône du tableau de bord

Vous pouvez choisir une icône spécifique pour les portails sur le tableau de bord : portail standard, portail coulissant, ou porte de garage.

Un portail peut être piloté par n'importe quel relais on/off : un module contact sec Zigbee (par ex. SONOFF MINI-ZBD), un canal de relais LoRa, ou une télécommande Somfy RTS. Le bouton de commande agit en impulsion ; configurez le comportement d'impulsion (inching / auto-off) sur le module lui-même. Associez un capteur d'ouverture (par ex. SONOFF SNZB-04P) au même équipement pour obtenir l'état ouvert/fermé ; sans capteur, l'état s'affiche comme inconnu.

Capteurs¶

Capteur¶

Capteur générique qui affiche une ou plusieurs valeurs mesurées. Sowel adapte l'affichage automatiquement selon ce que le device expose.

Contrôles : Affichage en lecture seule avec icônes et unités appropriées
Données typiques : température, humidité, pression, CO2, COV, luminosité, bruit, batterie
Capteurs booléens : mouvement (Mouvement/Calme), contact (Ouvert/Fermé), fuite d'eau, fumée

Station météo¶

Capteur météo extérieur qui fournit les conditions actuelles.

Contrôles : Affichage multi-valeurs
Données typiques : température, humidité, pression, pluie, vent, bruit, batterie
Les températures (extérieure et intérieure) affichent en dessous le minimum et le maximum mesurés depuis minuit, sur le widget du dashboard comme sur la page de détail. Fonctionne avec toute station qui remonte une température, sans configuration.

Prévision météo¶

Prévision météo sur plusieurs jours depuis une intégration API (par ex. plugin Open-Meteo).

Contrôles : Cartes de prévisions jour par jour avec icônes des conditions
Données par jour (J+1 à J+5) : condition météo, températures min/max, probabilité de pluie, rafales de vent

Bouton / Télécommande¶

Bouton physique ou télécommande. Pas piloté directement, utilisé comme déclencheur d'automatisations.

Données : événements d'action (appui simple, double appui, appui long)
Usage : Déclencher des recettes ou basculer des modes

Énergie¶

Compteur d'énergie¶

Suit la consommation d'énergie d'un circuit ou d'un device spécifique. Souvent utilisé comme sous-compteur sur une ligne dédiée (pompe à chaleur, piscine, borne VE) pour alimenter la ventilation par usage sur la page Énergie.

Contrôles : Affichage de la puissance (W) et de l'énergie quotidienne (Wh/kWh)
Données attendues : énergie cumulée (Wh)

Compteur d'énergie principal¶

Le compteur principal du réseau de votre maison. Un seul autorisé par système.

Contrôles : Identique au compteur d'énergie, plus alimentation de la page Suivi énergétique
Données attendues : puissance, énergie (avec classification tarifaire HP/HC)

Compteur d'énergie de production¶

Panneau solaire ou autre source de production. Un seul autorisé par système.

Contrôles : Affichage de la production avec calcul d'autoconsommation
Données attendues : puissance de production, production cumulée

Multimédia¶

Lecteur multimédia¶

TV, barre de son, ou appareil multimédia (par ex. TV Samsung SmartThings).

Contrôles : Allumage/extinction, volume, mute, sélecteur de source d'entrée
Données attendues : état d'alimentation, niveau de volume, mute, source d'entrée courante, mode image
Ordres : allumer/éteindre, régler le volume, basculer mute, changer de source d'entrée

Électroménager¶

Appareil électroménager¶

Appareil électroménager connecté tel que lave-linge, sèche-linge ou lave-vaisselle (par ex. Samsung SmartThings Washer).

Contrôles : Affichage de statut en lecture seule
Données attendues : état d'alimentation, état de fonctionnement (prêt/en cours/en pause), phase courante (lavage/rinçage/essorage), progression (%), temps restant, consommation d'énergie

Notification de fin de cycle

Utilisez une recette de surveillance d'état pour être notifié quand l'état de fonctionnement passe de running à ready.

Eau¶

Vanne d'eau¶

Vanne d'arrosage connectée pour le jardin. Conçue pour des devices comme la SONOFF SWV qui exposent state, flow, et les propriétés irrigation_*.

Contrôles : Bascule ON/OFF, action minutée "Arroser pendant X min" qui ouvre la vanne et laisse le firmware du device la refermer automatiquement après la durée configurée
Métriques live affichées si liées : débit (m³/h), batterie, statut device (normal / manque d'eau / fuite)
Alias standards : state, flow, battery, status, duration, cycles, interval, capacity, autoCloseOnShortage, seul state est requis, l'UI s'adapte à ce qui est lié
Agrégation de zone : compte les vannes ouvertes/totales et somme le débit live sur l'arbre des zones
Base pour de futures recettes d'arrosage automatique (planification consciente de la pluie)

Caméras¶

Caméra¶

Type générique, indépendant du fabricant : tout plugin caméra qui remonte les bonnes données peut s'y lier.

Contrôles (si liés) : vue en direct, actualisation de l'aperçu, activer/désactiver la surveillance, spot lumineux, sirène
Données attendues (si liées) : aperçu, flux en direct, état de surveillance, mode du spot, dernière détection

Chaque fonctionnalité est activée à la carte, par caméra

Qu'une caméra propose un flux en direct, un bouton de surveillance ou remonte des détections dépend uniquement des données/ordres que vous liez — le même mécanisme de liaison que pour tous les autres types d'équipement. Créer une caméra à partir d'un device détecté lie automatiquement l'aperçu, le flux en direct et la bascule de surveillance ; le spot, la sirène et les détections restent à activer manuellement depuis la page de détail ("Ajouter une liaison") si vous le souhaitez. Une fonctionnalité non liée reste inaccessible même via l'API, pas seulement masquée dans l'interface — c'est un choix de confidentialité délibéré, pas qu'une préférence d'affichage.

L'aperçu et le flux en direct passent par le backend de Sowel — votre navigateur ne parle jamais directement à la caméra et n'apprend jamais son adresse réseau.

Autre¶

Interrupteur / Prise¶

Simple interrupteur on/off ou prise connectée.

Contrôles : Bascule ON/OFF avec badge d'état
Données attendues : état (on/off)

Gérer les équipements¶

Page de détail¶

Cliquez sur n'importe quel équipement pour voir sa page de détail :

Données live : toutes les valeurs sont mises à jour en temps réel via WebSocket
Contrôles : contrôles interactifs adaptés au type d'équipement
Graphique d'historique : tendances des données dans le temps (si l'historisation est activée)
Configuration : devices liés, liaisons de données, liaisons d'ordres

Changer le device¶

Depuis la page de détail, cliquez sur Changer de device pour relier l'équipement à un ou plusieurs devices différents. Sowel supprime toutes les liaisons existantes et les recrée automatiquement à partir des nouveaux devices.

Warning

Les liaisons sont reconstruites de zéro : les alias personnalisés et les réglages d'historisation par liaison sont perdus. Pour récupérer de nouvelles valeurs sans les perdre, utilisez Ajouter les liaisons manquantes ci-dessous.

Ajouter les liaisons manquantes¶

La mise à jour d'un plugin peut publier des valeurs que le device ne remontait pas avant. Ces valeurs arrivent bien jusqu'au device, mais un équipement lié avant leur apparition ne les récupère pas tout seul.

Ouvrez Configuration > Liaisons sur la page de détail. Quand il manque quelque chose, Sowel le signale et propose Examiner :

chaque valeur manquante est listée, cochée par défaut
décochez ce que vous ne voulez pas, puis confirmez
les valeurs qui seront enregistrées dans l'historique sont marquées, et leur nombre est indiqué avant de confirmer

Rien n'est ajouté tant que vous n'avez pas confirmé : une valeur que vous aviez retirée volontairement ne revient que si vous le demandez. Sur un device multi-canal, seul le canal déjà utilisé par cet équipement est proposé.

Historisation¶

Chaque valeur de donnée est historisée vers InfluxDB par défaut, selon sa catégorie (température, humidité, puissance...). Depuis la page de détail, vous pouvez surcharger ce comportement par liaison :

Défaut : suit la règle de la catégorie
Forcer ON : toujours historiser cette valeur
Forcer OFF : ne jamais historiser cette valeur

Commande temporisée¶

Un équipement peut agir maintenant et revenir en arrière au bout d'un délai : ouvrir le portail pour un quart d'heure, allumer la lumière extérieure une demi-heure, arroser vingt minutes. C'est le moteur qui tient l'échéance, donc un redémarrage ou une coupure ne la perd pas, et une échéance dépassée pendant l'arrêt est honorée au retour.

Activez-la depuis la page équipement, sous Commande temporisée. Elle est désactivée par défaut. Vous choisissez la commande, celle qui la défait, et la durée. Sur un portail coulissant piloté par une impulsion unique, les deux commandes sont la même et le panneau le dit.

Le panneau n'apparaît que sur un équipement qui remonte un état pour cette commande. Sans cet état, un retour fait à la main passerait inaperçu et l'échéance agirait sur un équipement qui a bougé depuis, ce qui sur un portail à impulsion revient à rouvrir ce que vous venez de fermer.

Une fois activée, la commande apparaît à deux endroits :

Sur la vue Accueil, à côté de l'équipement sur sa ligne, avec le temps restant pendant le créneau.
Sur le Dashboard, sous forme de tuile que vous épinglez à côté de la tuile ordinaire, pour que « ouvrir » et « ouvrir quinze minutes » restent deux boutons distincts.

Appuyer de nouveau sur la tuile pendant le créneau prolonge le délai au lieu d'agir deux fois. Annuler envoie tout de suite la commande de fermeture.

Paliers : chaque appui demande plus longtemps¶

Une durée unique répond « pas encore » mais jamais « combien de temps encore ». Cochez Paliers sous la commande temporisée et choisissez les durées que les appuis parcourent — un quart d'heure, une demi-heure, une heure, par exemple. Ensuite :

le premier appui agit et lance la durée la plus courte ;
chaque appui suivant passe à la durée au-dessus, comptée à partir de cet instant, et n'envoie rien ;
un appui au-delà de la dernière arrête le décompte et laisse l'équipement exactement tel qu'il est — le portail reste ouvert, et plus rien ne le refermera.

Ce dernier appui n'est volontairement pas la même chose qu'annuler : annuler envoie la commande de fermeture, arrêter le décompte non. Les deux sont sur la tuile, côte à côte.

De deux à six paliers, du plus court au plus long. Le premier est la durée, donc le sélecteur de durée le suit au lieu d'annoncer une valeur à lui. Modifier les paliers pendant qu'un créneau court ne le dérange pas : le créneau garde sa propre échéance et l'appui suivant repart du palier le plus proche.

Un contact qui ne certifie qu'un seul sens

Le contact d'un portail prouve en général qu'il est fermé et ne fait que suggérer qu'il est ouvert. Si vous fermez le portail à la main sans que le contact le voie, le créneau continue de courir et rouvrira le portail à l'échéance. Terminez le créneau depuis Sowel plutôt qu'à la main quand cela compte.

Désactiver un équipement¶

Un équipement désactivé :

N'apparaît pas dans la vue Accueil
Est exclu de l'agrégation de zone
Ne déclenche pas les recettes ni les impacts de mode
Reste consultable et modifiable

Supprimer un équipement¶

La suppression retire l'équipement de Sowel. Les devices sous-jacents ne sont pas affectés, ils restent disponibles pour de nouveaux équipements.

Warning

Supprimer un équipement supprime également toutes les instances de recettes et impacts de mode qui le référencent.