Comment raccorder une sonnenBatterie (Gen. 8 ou supérieure, connexion API REST) au Reduxi Controller
Raccordez la sonnenBatterie Gen. 8 ou supérieure au Reduxi Controller via l'API REST.
Description textuelle de cette image
Photo d'une sonnenBatterie, image du fabricant. Mur de béton gris foncé dans une pièce tamisée. Sur le mur, à gauche, est accroché un module rectangulaire gris à face avant nervurée ou perforée, l'onduleur hybride selon la légende. À côté, à droite, se dresse une grande armoire gris clair avec un anneau rond lumineux bleu clair près du haut. Aucun texte lisible sur les appareils.
- Documentation technique
- Matériel nécessaire
- Accès local à la sonnenBatterie
- Configuration de l'appareil sur la sonnenBatterie
- Se connecter à l'interface web de Reduxi
- Ajouter la sonnenBatterie à Reduxi
- Vérifier les mesures et configurer les stratégies
- Liste de contrôle
- Résumé
- Problèmes courants
- Articles associés
1 Documentation technique
Pages du fabricant pour la sonnenBatterie :
- sonnenBatterie 10 – Page produit du fabricant
- Notices d'utilisation Sonnen – Notices d'utilisation du fabricant
Tutoriels vidéo :
2 Matériel nécessaire
Préparez les éléments suivants :
- Reduxi Controller (installé et en ligne)
- sonnenBatterie Gen. 8 ou supérieure (API REST)
- Adresse IP locale de la sonnenBatterie
- Mot de passe installateur de la sonnenBatterie (voir Point 4)
- Ordinateur dans le même réseau local que la sonnenBatterie
- Ordinateur portable ou tablette avec accès à Internet pour configurer l'appareil dans Reduxi
3 Accès local à la sonnenBatterie
Avant de commencer, assurez-vous de disposer de l'adresse IP locale de la sonnenBatterie et que votre ordinateur est connecté au même réseau local.
La sonnenBatterie reçoit son adresse IP de :
- le routeur,
- un switch réseau,
- ou un serveur DHCP local.
Pour trouver l'adresse IP ou le nom DNS de la sonnenBatterie, utilisez find-my.sonnen-batterie.com et suivez les instructions de Sonnen.
Ouvrez un navigateur web et saisissez l'adresse IP locale de la sonnenBatterie pour ouvrir son interface web. Exemple : http://<IP>
4 Configuration de l'appareil sur la sonnenBatterie
4.1 Connexion installateur
Après avoir ouvert l'adresse IP dans le navigateur, un écran de connexion s'affiche. Sélectionnez Installer comme type de connexion et saisissez le mot de passe installateur.
Si vous avez besoin d'un accès, contactez l'installateur qui a mis le système en service, ou contactez le support Sonnen. Le support Sonnen peut vérifier la demande, débloquer l'accès ou effectuer les modifications nécessaires à votre place.
Description textuelle de cette image
Capture d'écran de l'écran de connexion de l'interface web de la sonnenBatterie, fenêtre large avec le logo sonnen dans la barre supérieure sombre. Cadre de connexion centré avec le titre Dashboard. Texte : Please choose a login. Liste déroulante avec la valeur sélectionnée Installer. Libellé du champ Password, champ vide. Bouton bleu clair Login.
4.2 Dashboard
Après une connexion réussie, le Menu / Dashboard s'affiche.
Description textuelle de cette image
Capture d'écran de l'interface web de la sonnenBatterie, page Dashboard, avec le logo sonnen dans la barre supérieure sombre. Menu de gauche : Dashboard (en bleu clair), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Titre de la zone principale : Dashboard. Schéma des flux d'énergie avec quatre cadres : production 3145 W (jaune, icône de panneau solaire) ; consumption 1875 W (bleu, icône de maison) ; FeedIn 1273 W (gris, icône de pylône) ; active power avec l'état idle, rSOC: 16% et uSOC: 9% (vert, icône de batterie). Une flèche jaune va de production vers le cadre de la batterie, une flèche verte va du cadre de la batterie vers consumption.
4.3 Activer l'API REST de la sonnenBatterie
Sur le tableau de bord, procédez comme suit :
Description textuelle de cette image
Capture d'écran de l'interface web de la sonnenBatterie, page Software-Integration (logo sonnen dans la barre supérieure sombre ; numéro de série et version du logiciel affichés en petit en haut à droite). Menu de gauche : Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (entouré d'un cadre rouge). Onglets : JSON API (sélectionné), WebSocket API, Generated Docs (petit texte). Deux boutons bascule, tous deux activés (bleus) et chacun entouré d'un cadre rouge : Read API (texte en dessous : allows to request the current status of the sonnenBatterie, measurements and configuration values) et Write API (texte en dessous : send requests to change or discharge the sonnenBatterie and set configuration values). Un cadre rouge entoure la ligne API Token : une valeur de jeton (non affichée ici, masquée) et un bouton Create New. En dessous : un exemple de commande curl avec un en-tête Auth-Token et une URL se terminant par /api/v2/latestdata. Titre Documentation avec un lien vers la documentation de la JSON API de la sonnenBatterie.
4.4 Définir le mode de fonctionnement
Ouvrez le menu Settings sur le côté gauche et sélectionnez le mode de fonctionnement Manual.
Description textuelle de cette image
Capture d'écran de l'interface web de la sonnenBatterie, page Settings (en haut à droite : Software: 1.15.6, le reste est coupé). Menu de gauche : Dashboard, System, Inverter, Settings (en bleu), Network, Software-Integration. Titre de la zone principale : Settings. Section : Operating Mode. Une liste déroulante est ouverte avec l'entrée sélectionnée Manual (en gris). Les options listées sont : Manual ; Automatic - Self-Consumption ; Battery-Module-Extension (30%) ; Time-Of-Use. Sous la liste déroulante, un bouton bascule libellé Surplus fullcharge est visible, désactivé (gris).
5 Se connecter à l'interface web de Reduxi
Vous pouvez ouvrir l'interface web de Reduxi de deux façons :
Description textuelle de cette image
Capture d'écran de trois écrans de l'application mobile Reduxi côte à côte, avec des cadres cyan et des pastilles numérotées de 2 à 4. Écran de gauche (tableau de bord, thème sombre) : icône de menu en haut à gauche entourée d'un cadre et de la pastille 2 ; logo 'reduxi' ; onglets 'Real time data' (actif) et 'Statistics' ; prix 5.79 € et température 3.2 °C ; schéma de flux d'énergie avec une maison au centre (-1.25 kW) et des icônes avec les valeurs 69.0 W, 1.3 kW, 1.1 kW (cercle rouge), -165.0 W avec 97 % (cercle rouge) et des valeurs 0.0 W en bas ; onglets 'Power' et 'Energy' ; navigation du bas : Dashboard, Diagnostics, Device control, Settings. Écran du milieu (menu latéral) : logo 'reduxi', 'Number of locations: 1233', titre 'Reduxi device management', entrées '+ Add Reduxi location' et 'Reduxi devices' (entourée d'un cadre et de la pastille 3), puis 'My profile' et 'About app'. Écran de droite (page de l'appareil) : Back ; image d'un contrôleur Reduxi noir avec deux ports Ethernet ; état 'Connected' ; carte 'Update available' : 'New update is available for your Reduxi device.' avec le bouton 'Download and install update' ; carte 'Connect to configurator' : 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' avec le bouton 'Activate tunnel connection' (entouré d'un cadre et de la pastille 4) ; carte 'Unit details' avec le champ 'Unit ID'.
Description textuelle de cette image
Capture d'écran composée de deux parties côte à côte. Partie gauche : écran de l'application mobile Reduxi sur fond sombre. En haut : bouton Back ; image d'un contrôleur Reduxi noir avec deux ports Ethernet et un bornier ; état 'Connected' avec une icône Wi-Fi. Carte 'Update available' : 'New update is available for your Reduxi device.' avec le bouton 'Download and install update'. Carte 'Connect to configurator' avec une icône de clé : 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' et le bouton 'Open configurator', entouré d'un cadre cyan et de la pastille 5. En dessous : carte 'Unit details' avec un champ 'Unit ID' (valeur non visible). Partie droite : le Reduxi Configurator ouvert dans un navigateur, entouré d'un cadre cyan et de la pastille 6. En-tête : flèche de retour, 'Tunnel connection', icône d'actualisation. Barre latérale gauche avec des icônes (éclair, puce, éclair, diagramme en barres, engrenage). Page 'Home' avec une icône de lien verte. Avis vert : 'New patch available. Click here to apply.' avec une croix de fermeture. Heure 09:12:56. Schéma de flux d'énergie avec une maison au centre (1.700 kW) et des icônes pour le réseau (0.000 kW), le solaire (1.700 kW), la batterie (verte, 0.000 kW et 0.800 kW), un appareil à gauche (0.900 kW), un véhicule électrique et une borne ou un appareil en bas. Libellé 'Energy manager' en bas.
http://reduxi.local. Vous trouverez l'adresse IP du contrôleur dans la liste des appareils de votre routeur ou dans l'application Reduxi sous Reduxi devices.admin · Mot de passe : admin (valeurs d'usine)Description textuelle de cette image
Capture d'écran de la page de connexion du Reduxi Configurator dans une fenêtre de navigateur Chrome. La barre d'adresse affiche 'Not secure' et 'reduxi.local' ; elle est entourée d'un cadre cyan, et une copie agrandie (cadre cyan, texte 'Not secure reduxi.local') est affichée à gauche, reliée par une ligne cyan. Arrière-plan de la page : dessin au trait gris clair d'une maison avec des panneaux solaires (verts), une wallbox, un onduleur, une voiture et une borne de recharge. En haut à gauche : logo 'reduxi configurator'. Au centre, une boîte de connexion avec le titre 'Login', un sélecteur de langue (drapeau anglais, 'English'), un champ de nom d'utilisateur et un champ de mot de passe, et un bouton sombre 'Login'.
Description textuelle de cette image
Capture d'écran de l'interface web du Reduxi Configurator après la connexion, thème clair. En haut à gauche : logo 'reduxi configurator'. Barre d'en-tête : 'Home' à gauche, état vert 'Connected' en haut à droite. Barre latérale gauche : section 'Devices' dépliée avec une liste d'entrées, puis sections repliées 'Manager', 'Configuration' et 'Settings'. Zone principale : schéma de flux d'énergie. Maison au centre avec un anneau, valeur 24.20 kW. Icône Grid en haut à gauche, 24.20 kW (point rouge sur sa ligne). Icône Solar en haut à droite, valeur '-'. Icône de gauche (batterie ou appareil), 6.700 kW (point vert sur sa ligne). Icônes de droite (stockage par batterie et un appareil), valeurs '-'. Icône EV charger en bas à gauche, 31.00 kW. Une autre icône d'appareil en bas à droite. Étiquette 'Energy manager' sous la maison.
6 Ajouter la sonnenBatterie à Reduxi
Suivez ces étapes pour ajouter un nouvel appareil au Reduxi Controller.
6.1 Paramètres de base
Connectez-vous au Reduxi Configurator (voir Point 5 ; voir aussi Comment se connecter au Reduxi Configurator via un navigateur) et cliquez sur + Add device.
Description textuelle de cette image
Capture d'écran du menu de gauche du Reduxi Configurator sous le logo reduxi Configurator. Entrées de menu : Devices (dépliée, avec un signe moins) contenant le bouton '+ Add device' (contour) ; Strategies (signe plus) ; Utility Rate Plan ; Settings (signe plus). Le côté droit est un fond blanc vide.
À la première étape, définissez les paramètres de base :
- Device type :
Hybrid Inverter - Type :
Sonnen - Name : un nom de votre choix
Description textuelle de cette image
Capture d'écran du formulaire du Reduxi Configurator intitulé Basic settings. Champs : Device type (liste déroulante, valeur en petit texte) ; Type (liste déroulante, la valeur semble indiquer Sonnen, petit texte) ; Name (champ de texte, la valeur semble indiquer sonnen, petit texte). En dessous, une section Include in Strategy avec un tableau : colonnes Strategy, Measurement Device, Regulated Device ; deux lignes, toutes deux nommées Energy manager, chacune avec un petit indicateur dans les colonnes Measurement Device et Regulated Device. Boutons : Back (en bas à gauche, blanc), Next (en bas à droite, noir). L'image est de faible résolution et la plupart des textes sont petits.
Cliquez sur Next.
6.2 Paramètres de communication
| Paramètre | Valeur |
|---|---|
| Connexion | TCP/IP |
| IP | Adresse IP de la sonnenBatterie |
| Jeton d'API | Le jeton d'API du Point 4, Point 4.3 |
| PV | Choisissez le type d'onduleur : AC‑coupled (batterie et onduleur séparés) ou Hybrid (batterie et onduleur intégrés dans un seul système) |
Description textuelle de cette image
Capture d'écran du formulaire du Reduxi Configurator intitulé Communication channel and device configuration. L'image est de faible résolution. Champs : Connection type (liste déroulante) ; IP (champ de texte, vide) avec un bouton noir Scan for IP ; Port : 80 ; Reconnect IP recovery (bouton bascule, libellé Yes, activé) ; API token (champ de texte, vide) ; un second bouton bascule avec un court titre et le texte Yes/No ; Number of AC system units : 1 ; What is type of inverter (liste déroulante) : AC coupled system. Boutons : Back (en bas à gauche), Test communication et Done (en bas à droite, Done est noir).
6.3 Tester la communication
Cliquez sur Test communication en bas de l'assistant. Il lit une fois la sonnenBatterie et n'enregistre rien. Si le test réussit, cliquez sur Done : seul Done crée l'appareil.
Description textuelle de cette image
Capture d'écran de la barre de boutons inférieure d'une page du Reduxi Configurator. À gauche : bouton 'Back'. À droite : bouton 'Test communication' (entouré d'un cadre cyan) et bouton sombre 'Done'.
Description textuelle de cette image
Capture d'écran de la page 'Communication channel and device configuration' du Reduxi Configurator. Connection * : TCP/IP (liste déroulante). IP * : 192.168.50.243, avec le bouton 'Scan for IP'. Port * : 502, avec le bouton 'Test port'. Modbus unit ID * : 1. Boutons en bas : Back (à gauche), Test communication et Done (à droite). Le bouton Done est entouré d'un cadre cyan.
Le test renvoie l'un de ces deux résultats :
Description textuelle de cette image
Capture d'écran de la boîte de dialogue Test communication du Reduxi Configurator avec une icône de fermeture (x) en haut à droite. Cadre de résultat blanc, texte vert : Successful readout from device. Valeurs : Battery active power: 5.0 W ; Battery current: 0.0229 A ; Battery export active energy: 0 Wh ; Battery import active energy: 0 Wh ; Battery min. active power: -9600.0 W ; Battery min. state of charge: 10.0 % ; Battery state of charge: 100.0 % ; Battery voltage: 218.0 V ; Grid active power: 1456.0 W ; Grid export active energy: 0 Wh ; Grid import active energy: 0 Wh ; Load active power: 1454.0 W ; Load import active energy: 0 Wh ; Off-grid: false ; PV active power: 0.0 W ; PV export active energy: 0 Wh ; State name: GRID_ON ; Additional parameter - CAPACITY_MAX_WH: 19531.0 ; Additional parameter - FREQUENCY: 49.965. Bouton : Close (foncé, en bas à droite).
Description textuelle de cette image
Capture d'écran d'une boîte de dialogue intitulée Test communication (croix de fermeture en haut à droite). Premier cadre : Unable to communicate with device. Second cadre avec un texte rouge : Unable to communicate with null on port 502. Check if service is enabled on device, port number is correct and device is reachable on the network. ping: null: Name or service not known. Bouton : Close (foncé).
Si vous obtenez le message “Unable to communicate with device”, vérifiez les paramètres (voir Point 8).
7 Vérifier les mesures et configurer les stratégies
7.1 Last measurements
Une fois la communication établie, vérifiez les valeurs mesurées sous Devices – your Sonnen device – Last measurements dans le Reduxi Configurator.
7.2 Reduxi Cloud
Comment ajouter et raccorder le contrôleur au Reduxi Cloud : Reduxi Cloud
7.3 Stratégies
Pour configurer les stratégies et l'AI Energy Manager, utilisez la documentation ci-dessous.
8 Liste de contrôle
Consultez cette liste de contrôle pour une configuration correcte et un fonctionnement fiable.
8.1 Sur le Reduxi Controller
- Adresse IP : la bonne adresse IP est saisie pour l'appareil raccordé.
- Jeton d'API : un jeton d'API valide est saisi.
- Type de système : le bon type de système est sélectionné : AC‑coupled ou Hybrid.
- Test de communication : le test de communication est réussi.
- Accessibilité : l'adresse IP de l'appareil est joignable depuis le Reduxi Controller.
8.2 Dans l'interface web de la sonnenBatterie
- Autorisations d'API : Read API et Write API sont toutes deux activées.
- Mode de fonctionnement : le mode de fonctionnement est Manual.
8.3 Stratégie
- Stratégie active : la stratégie sélectionnée est réglée sur Active.
- Optimisation énergétique par IA : l'optimisation AI Energy Manager est activée dans la stratégie.
- Une seule stratégie active : une seule stratégie est active à la fois.
- Limites d'import/d'export : les limites d'import et d'export sont définies et configurées.
✓ Résumé
Préparation (points 1 à 3) : préparez l'adresse IP locale, le mot de passe installateur et un ordinateur dans le même réseau. Ouvrez l'interface web de la sonnenBatterie.
sonnenBatterie (point 4) : connectez-vous en tant qu'Installer, activez Read API et Write API, copiez ou créez le jeton d'API et réglez le mode de fonctionnement sur Manual.
Ajout à Reduxi (points 5 et 6) : ouvrez le Configurator et ajoutez l'appareil avec le type Sonnen. Saisissez l'adresse IP, le jeton d'API et le type d'onduleur (AC‑coupled ou Hybrid). Lancez Test communication.
Mise en service (points 7 et 8) : vérifiez les mesures, configurez les stratégies et parcourez la liste de contrôle.
→ Problèmes courants
| Problème | Solution |
|---|---|
| Test communication affiche “Unable to communicate with device” | Le système n'est pas configuré correctement. Vérifiez l'adresse IP, le jeton d'API, le type de système (AC‑coupled ou Hybrid) et que l'adresse IP est joignable depuis le contrôleur (voir Point 8). |
| La connexion installateur est impossible | Le mot de passe installateur n'est pas accessible aux utilisateurs finaux. Contactez l'installateur qui a mis le système en service ou le support Sonnen (voir Point 4). |
| Aucun jeton d'API disponible | Ouvrez Software Integration dans l'interface web de la sonnenBatterie et cliquez sur Create new en bas de la page. |
| Les commandes de Reduxi n'ont aucun effet sur la batterie | Vérifiez que le mode de fonctionnement est Manual, que Read API et Write API sont activées, que la stratégie est Active et qu'une seule stratégie est active (voir Point 8). |
| Open configurator ne s'ouvre pas ou reste vide | Le tunnel n'est pas encore actif. Patientez environ 30 secondes et vérifiez que le contrôleur est en ligne. |
La connexion avec admin est refusée |
Le mot de passe a été modifié lors de l'installation. Demandez-le à l'installateur. Le mot de passe de votre compte Reduxi ne fonctionne pas ici. |
reduxi.local ne se charge pas |
Votre appareil ne se trouve pas sur le même réseau que le contrôleur. Utilisez l'adresse IP ou la connexion par tunnel. |
| Le test de communication échoue, l'appareil apparaît hors ligne | Vérifiez l'accessibilité, l'adresse IP / le port / l'ID d'unité, et que le protocole est activé sur l'appareil. |