Comment raccorder une sonnenBatterie au Reduxi Controller
Connectez votre sonnenBatterie au Reduxi Controller et laissez les stratégies Reduxi la charger et la décharger aux meilleurs prix. Ce guide couvre la connexion par API JSON et indique dans quels cas le guide de l'API REST pour la Gen. 8 ou supérieure s'applique.
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.
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 avec l'API JSON sous Software Integration
- Adresse IP locale de la sonnenBatterie
- 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
Connectez la sonnenBatterie au réseau local via LAN. Le Reduxi Controller doit se trouver sur le même réseau.
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
Connectez-vous à l'interface web de la sonnenBatterie (voir point 3). Vous avez besoin du jeton API et de l'adresse IP pour le Reduxi Controller (voir point 6).
4.1 Ouvrir Software Integration
Description textuelle de cette image
Capture d'écran de l'interface web de la sonnenBatterie dans un navigateur, page Software-Integration, onglet JSON API. La barre d'adresse affiche une adresse IP locale suivie du chemin dash/software-integration/json-api ; l'adresse IP est marquée d'un cadre rouge et d'une flèche libellée SonnenBatterie IP. Menu de gauche : Dashboard, System, Inverter, Settings, Network et Software-Integration (surligné). Onglets : JSON API (actif), Webhook API et sonnenKNX Module. Deux interrupteurs sont activés : Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) et Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). En dessous, le champ API Token avec une valeur de jeton, marqué d'un cadre rouge et du libellé API Token, et un bouton Create New. Une ligne d'exemple reprend le jeton et l'adresse IP avec les mêmes marquages. En bas : le lien sonnenBatterie JSON API v2 documentation.
4.2 Activer Read API et Write API
Activez Read API et Write API. Les deux sont nécessaires : Reduxi lit les mesures avec Read API et envoie les commandes de charge et de décharge avec Write API.
Description textuelle de cette image
Capture d'écran recadrée de l'onglet JSON API avec les onglets JSON API, Webhook API et sonnenKNX Module. L'interrupteur Read API est activé. En dessous, un avis bleu clair indique This functionality is disabled while VPP is active, suivi d'un interrupteur Write API grisé en position désactivée avec le texte Send requests to charge/discharge the sonnenBatterie and set configuration values. Un rectangle bleu met en évidence l'avis et l'interrupteur Write API.
4.3 Définir le mode de fonctionnement
Ouvrez le menu Settings à gauche et réglez le mode de fonctionnement sur Manual. Le Reduxi Controller ne peut prendre le contrôle de la batterie qu'à cette condition.
Description textuelle de cette image
Capture d'écran de la page Settings de la sonnenBatterie (logiciel 1.15.6). Menu de gauche : Dashboard, System, Inverter, Settings (surligné), Network et Software-Integration. La carte Operating Mode contient une liste déroulante qui affiche Manual ; la liste ouverte en dessous propose Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) et Time-Of-Use. Sous la carte, un interrupteur libellé Surplus fullcharge est visible.
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 la sonnenBatterie comme nouvel appareil sur le Reduxi Controller.
6.1 Paramètres de base
Connectez-vous au Reduxi Configurator (voir point 5 ; voir aussi How to log in to Reduxi Configurator via browser) 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 :
- Type d'appareil : 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
Saisissez les paramètres de connexion entre le Reduxi Controller et la sonnenBatterie. Utilisez l'adresse IP et le jeton API du point 4.
| Paramètre | Valeur |
|---|---|
| Connexion | TCP/IP |
| IP | Adresse IP de la sonnenBatterie |
| Port | 80 |
| Jeton d'API | Le jeton API de l'onglet JSON API (point 4, point 4.1) |
| Puissance nominale | Sélectionnez la puissance nominale correspondant à votre sonnenBatterie |
| PV | Sélectionnez Yes si un compteur PV est installé, sinon No |
Description textuelle de cette image
Capture d'écran du formulaire Communication channel and device configuration du Reduxi Configurator. Champs de haut en bas : Connection (TCP/IP), IP (vide, avec une flèche bleu clair qui désigne le champ), Port (80), API token (vide, avec une flèche bleu clair ; aide : API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) et PV (Yes ; aide : Is PV meter installed?). Boutons en bas : Back, Test communication et Next.
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 Next.
Le test renvoie l'un de ces deux résultats :
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 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).
6.4 Paramètres avancés
Les paramètres avancés sont facultatifs et dépendent des besoins du site. Lorsque vous avez terminé, cliquez sur Done : seul Done crée l'appareil.
Description textuelle de cette image
Capture d'écran de l'assistant du Reduxi Configurator, étape 3 sur 3 Advanced settings ; la barre de progression affiche Basic settings, Communication channel et Advanced settings. Bascules Yes/No, toutes sur No : set data saving interval (par défaut 1 min), set reading delay (par défaut 1000 ms), set writing delay (par défaut 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (par défaut No), invert direction for energy import and export (par défaut No), exclude device from summary (par défaut No). Trois listes déroulantes L1, L2 et L3 is connected to main feed sont réglées sur L1, L2 et L3. Boutons : Back à gauche et Done à droite.
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 – votre appareil Sonnen – Last measurements dans le Reduxi Configurator.
7.2 Control type
Ouvrez Devices – votre appareil Sonnen dans le Reduxi Configurator et réglez le control type sur AUTO. Les commandes de la stratégie agissent alors sur la batterie.
7.3 Reduxi Cloud
Comment ajouter et raccorder le contrôleur au Reduxi Cloud : Reduxi Cloud
Une fois l'appareil ajouté, vous pouvez aussi le surveiller et le piloter dans l'application Reduxi.
7.4 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 et port : l'adresse IP de la sonnenBatterie et le port
80sont saisis. - Jeton d'API : un jeton d'API valide est saisi.
- Puissance nominale et PV : la puissance nominale et le choix PV correspondent au système.
- Test de communication : le test de communication est réussi.
- Control type : le control type de l'appareil est réglé sur AUTO.
- 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.
- VPP : la batterie est déconnectée de la VPP.
- 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 et un ordinateur sur le même réseau. Ouvrez l'interface web de la sonnenBatterie.
sonnenBatterie (point 4) : ouvrez Software-Integration, onglet JSON API. Activez Read API et Write API (déconnectez d'abord la batterie de la VPP), copiez ou créez le jeton API et réglez le mode de fonctionnement sur Manual.
Ajout à Reduxi (points 5–6) : ouvrez le Configurator et ajoutez l'appareil avec le type Sonnen. Saisissez l'adresse IP, le port 80, le jeton API, la puissance nominale et PV. Lancez Test communication, puis cliquez sur Done.
Mise en service (points 7–8) : vérifiez les mesures, réglez le control type sur AUTO, 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” | Vérifiez l'adresse IP, le port 80, le jeton API et que l'adresse IP est joignable depuis le contrôleur (voir point 8). |
| Write API ne peut pas être activée | L'avis « This functionality is disabled while VPP is active » s'affiche. Déconnectez la batterie de la VPP, puis activez Write API (voir point 4.2). |
| Aucun jeton d'API disponible | Ouvrez Software-Integration, onglet JSON API, dans l'interface web de la sonnenBatterie et cliquez sur Create New. |
| 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 le control type est AUTO, 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 la joignabilité, l'adresse IP et le port, et que l'API est activée sur l'appareil. |