La bibliothèque d'appareils
La bibliothèque d'appareils est un catalogue de modèles prêts à l'emploi pour des équipements déjà préconfigurés : compteurs d'énergie, onduleurs solaires, batteries domestiques, bornes de recharge pour VE, relais connectés, lecteurs multimédia et haut-parleurs Sonos. Vous choisissez le modèle, renseignez quelques champs — généralement peu de choses au-delà de l'adresse de l'appareil — et la bibliothèque crée les widgets avec tous leurs objets de communication déjà liés : registres, topics, chemins d'accès, types de données, mise à l'échelle et unités inclus. Un travail qui nécessiterait autrement un après-midi avec un manuel de registres ne prend qu'une minute.
Ouvrez-la depuis Appareils → Ajouter depuis la bibliothèque.
Ce dont vous avez besoin : l'appareil sur le réseau à une adresse fixe (réservation DHCP), les options nécessaires activées dans sa propre configuration — Modbus TCP est désactivé par défaut sur la plupart des onduleurs — et le protocole activé dans Services (voir « Services et protocoles »).
Parcourir le catalogue
Chaque modèle est une carte indiquant la marque, le modèle, le badge de protocole et une description en une ligne. Affinez la liste grâce à :
- le champ de recherche — marque, modèle, nom de l'appareil ou description ; le compteur à sa droite indique résultats / total ;
- les filtres de catégorie — un par catégorie réellement présente dans le catalogue (actuellement Éclairage, Volets roulants, Énergie et Audio / Vidéo) ;
- les menus déroulants Marque et Protocole.

Ce que couvre la bibliothèque. Le catalogue est intégré avec le serveur et s'enrichit à chaque mise à jour. Il contient actuellement 83 modèles de 49 marques :
| Famille d'appareils | Marques couvertes |
|---|---|
| Onduleurs solaires et hybrides | SMA · Huawei (SUN2000) · SolarEdge · Sungrow · GoodWe · Growatt · FoxESS · Solax · Deye · SAJ · SofarSolar · Solplanet · Solinteg · SolarMax · M-TEC · Senergy · IBC Solar · Anker (SOLIX X1) · EcoFlow (PowerOcean) |
| Batteries domestiques et stockage | Marstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE) |
| Gestionnaires d'énergie et dataloggers | Huawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog |
| Compteurs d'énergie | HomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S) |
| Bornes de recharge pour VE | KEBA · Mennekes · Schneider (EVlink Pro) · Phoenix Contact (CHARX, EM-CP-PP-ETH, EV-SER) · Heidelberg · go-e · Bender · Peblar · EM2GO · OBO Bettermann · openWB · Stark in Strom |
| Relais d'éclairage et de volets | Shelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 roller) |
| Audio / vidéo | Sonos (toutes zones) · AUDAC (XMP44) |
La plupart des appareils d'énergie communiquent en Modbus TCP. Les modules Shelly sont proposés à la fois en HTTP et en MQTT — deux cartes distinctes ; choisissez celle correspondant à la configuration de l'appareil. HomeWizard utilise HTTP, AUDAC TCP/UDP, et Sonos son propre protocole (voir « Intégration Sonos »).
📘 Note : Un modèle couvre une famille de produits, pas une seule référence : le modèle Sonos convient à toutes les zones, et le modèle Shelly Plus 1 convient au 1 et au 1PM. Lorsqu'un fabricant a modifié sa table de registres entre deux générations, celles-ci font l'objet de cartes distinctes (Shelly Gen1 et Shelly Plus).
Créer un appareil à partir d'un modèle
- Cliquez sur la carte du modèle. La page de configuration s'ouvre avec la description du modèle et, le cas échéant, un panneau Prérequis d'installation. Lisez-le d'abord — il énumère les conditions requises sur l'appareil : un compte installateur, une option Modbus à activer, un onduleur à réponse lente nécessitant un intervalle de scrutation plus long.
- Saisissez le Nom de l'appareil. Il servira de préfixe à chaque widget créé par le modèle : ainsi, « Garage » génère « Garage — Réseau », « Garage — Solaire », etc.
- Renseignez les paramètres du modèle — ce dont les widgets eux-mêmes ont besoin : un Modbus Unit ID, une variante de modèle dans un menu déroulant, la zone Sonos. Le formulaire ne demande pas l'adresse IP : celle-ci est portée par la connexion, que vous définissez à l'étape 4.
- Ouvrez Connexion. La liste affiche uniquement les connexions du protocole associé au modèle. Sélectionnez la connexion de cet appareil ou — pour un appareil qui dispose de sa propre adresse IP (un onduleur, une borne de recharge, un haut-parleur) — choisissez Créer une nouvelle connexion… : la boîte de dialogue Ajouter une connexion s'ouvre avec le protocole et le nom déjà renseignés. Saisissez-y l'adresse IP de l'appareil et cliquez sur Créer la connexion ; la nouvelle connexion est alors sélectionnée — sans avoir à passer par la page Connexions au préalable. Si une connexion pointe déjà vers cette adresse, la bibliothèque l'indique et la réutilise au lieu de créer un doublon. Les modèles pour infrastructures partagées — comme un broker MQTT — utilisent par défaut la connexion existante.
- Choisissez la Pièce et la Catégorie de destination des widgets. Ces deux champs sont obligatoires.
- Le panneau Widgets à créer affiche un aperçu en direct du résultat.

L'aperçu et les éléments modifiables
Chaque widget dans l'aperçu indique son nom, son type de widget et un compteur N / M objets liés. Le modèle définit quels widgets sont cochés par défaut — généralement ceux présents dans toutes les installations. Les autres sont proposés décochés car ils dépendent d'équipements optionnels : le modèle Huawei coche le compteur solaire et laisse les compteurs réseau et batterie décochés, à ajouter une fois le Smart Power Sensor installé. Consultez les prérequis d'installation, puis cochez ce qui est réellement installé. Avant la création, vous pouvez :
- cocher ou décocher chaque widget — une installation solaire simple n'a pas de batterie à créer ;
- renommer un widget directement sur place ;
- déplier le compteur d'objets pour inspecter chaque objet : son numéro, son nom, l'adresse résolue correspondante et son type de données. Les objets volontairement laissés non configurés par le modèle indiquent aucune adresse.
Lorsqu'un paramètre est manquant ou hors limites, un message rouge remplace la liste des widgets et désigne le paramètre à corriger ; le bouton de création reste désactivé jusqu'à correction.
Cliquez sur Créer N widget(s). La page de résultat indique ce qui a été créé avec le nombre d'objets, les éventuels échecs et leur cause, et propose Ajouter un autre appareil pour réutiliser la bibliothèque. Il s'agit du cas classique pour un système multi-pièces Sonos, où l'on applique le même modèle une fois par zone.
📘 Note : Les widgets sont enregistrés mais pas encore actifs. Cliquez sur Appliquer les modifications dans la barre latérale, puis confirmez dans la boîte de dialogue Appliquer les modifications de configuration (voir « Visite du panneau d'administration ») pour redémarrer les protocoles et déployer la configuration sur tous les clients.

Après la création
Dès cet instant, les widgets sont des appareils normaux — renommez-les, modifiez leurs icônes, déplacez-les d'une pièce à l'autre, activez l'historique de données, utilisez-les dans des vues, scènes et automatisations. Les liaisons sont également des liaisons standard : ouvrez un objet et modifiez-le exactement comme un objet configuré manuellement (voir « Intégration Modbus TCP », « Intégration MQTT »).
Les compteurs créés par un modèle de gestion de l'énergie intègrent leur rôle déjà défini — réseau, solaire, batterie, borne de recharge, consommateur — ce qui permet au module Énergie et à son bilan de fonctionner sans configuration supplémentaire (voir « Appareils de gestion de l'énergie », « Vue d'ensemble de l'énergie »).
Importer et exporter des modèles
La bibliothèque accepte vos propres modèles : un fichier .yaml ou .yml de 256 Ko maximum, au même format que les modèles intégrés. Le panneau d'administration ne comporte pas d'éditeur de modèles : un modèle personnalisé est un fichier texte que vous écrivez ou recevez, et que vous éditez dans un éditeur de texte.
- Importer un modèle (en haut à droite) permet de téléverser un fichier. Il est d'abord validé — un modèle présentant des erreurs est refusé avec le nombre de problèmes et leur détail, et aucun élément n'est enregistré. Un modèle importé porte un badge importé sur sa carte.
- Un modèle importé comportant le même identifiant qu'un modèle intégré remplace celui-ci, et sa carte indique remplace le modèle intégré. Supprimer ce modèle rétablit la version d'origine.
- Les modèles importés peuvent être exportés (Exporter en YAML) et supprimés (Supprimer le modèle) via les icônes qui s'affichent au survol de leur carte. Supprimer le modèle supprime immédiatement, sans confirmation.
- Les modèles intégrés ne peuvent être ni exportés ni supprimés : leurs cartes ne comportent pas ces icônes. Ils sont fournis avec le serveur et réinitialisés à chaque mise à jour. Pour concevoir votre propre modèle, exportez un modèle importé ou créez le fichier de zéro.
⚠️ Avertissement : Supprimer un modèle ne modifie en rien les appareils déjà créés à partir de celui-ci. Ils continuent de fonctionner — seule la matrice de configuration est supprimée.
Liaison Sonos
Les objets Sonos sont liés à une zone, et non à une adresse saisie manuellement. Définissez le protocole de l'appareil sur Sonos — ou laissez la bibliothèque s'en charger — et l'éditeur de chaque objet propose :
| Champ | Description |
|---|---|
| Zone Sonos | La zone pilotée par ce widget, sélectionnée dans la liste des zones actives du système. L'identifiant enregistré est conservé même si la pièce est renommée dans l'application Sonos ou en cas de changement d'adresse IP. |
| Agir sur tout le groupe | Sur les deux objets de commande, Consigne de volume et Sourdine On/Off : lorsque la zone est groupée avec d'autres, la commande agit sur le groupe et non sur ce seul haut-parleur. Définissez ce réglage séparément sur chacun : le volume peut ainsi agir sur le groupe tandis que la sourdine reste individuelle. Ce commutateur apparaît aussi sur Retour de volume et Retour de sourdine, où il n'a aucun effet : le retour d'état indique toujours le volume et la sourdine propres à la zone. |
Tous les objets du widget sont associés à la même zone ; le numéro d'objet détermine sa fonction — volume, sourdine, lecture/pause, source, précédent/suivant, titre du morceau, artiste, pochette. La commande Zone On/Off n'a aucune signification sur un haut-parleur Sonos et reste non liée, raison pour laquelle le modèle de la bibliothèque utilise le sous-type audio sans zones.
Cliquez sur Enregistrer l'objet, puis sur Appliquer les modifications dans la barre latérale et confirmez (voir « Visite du panneau d'administration »).
📘 Note : La création et la dissociation des groupes s'effectuent dans l'application Sonos ; HyperVisu ne gère pas cette fonction. Les applications n'affichent pas non plus l'état des groupes : chaque zone reste un appareil audio distinct avec son propre curseur de volume et son bouton de sourdine, et le curseur continue d'indiquer le volume propre à cette zone même lorsque ses commandes s'appliquent au groupe. Pour identifier les zones groupées, consultez l'application Sonos ou la section Zones de ce système sur la connexion Sonos (voir « Intégration Sonos »). Les commandes de lecture, pause, suivant et précédent sont systématiquement transmises au coordinateur du groupe.

Les sources sont les favoris Sonos. Au-dessus de la liste d'objets du widget se trouve le panneau Sources Sonos. Cliquez sur Synchroniser les favoris Sonos pour que le serveur interroge le système : d'abord les entrées directes du haut-parleur (TV pour une barre de son, Entrée ligne sur les modèles compatibles), puis les favoris enregistrés dans l'application Sonos. Leurs noms et leur nombre sont appliqués au widget, et les applications génèrent un bouton de source par entrée.
Cette liste est en lecture seule ici — sa gestion appartient à Sonos. Relancez une synchronisation après tout ajout, suppression ou renommage de favoris dans l'application Sonos, faute de quoi les applications continueront de proposer les anciens boutons.

💡 Conseil : Au-delà de six sources, les applications basculent automatiquement sur un menu déroulant à la place des boutons, assurant ainsi une interface claire même avec une longue liste de favoris.