API du WPC3700
Abréviation des noms WPC : contrôleur de puissance Wi-Fi
API du contrôleur de puissance de la série WPC
Cet article présente principalement les API fournies par les contrôleurs de puissance de la série WPC. Grâce à ces API, les utilisateurs peuvent effectuer les opérations suivantes :
- Configurer les paramètres du WPC
- Contrôler la puissance de sortie du WPC
Qui devrait lire cet article
Cette section est placée au début car, bien que nous ayons écrit cet article, il n'est en fait pas pertinent pour la plupart des utilisateurs du WPC.
Si vous avez obtenu un contrôleur de puissance de la série WPC, plusieurs modes de fonctionnement sont possibles :
- Vous avez déjà installé des compteurs IAMMETER côté réseau et utilisez directement le WPC3700 en conjonction avec les compteurs IAMMETER (le WPC3700 fonctionne en mode automatique), permettant au WPC3700 de travailler en continu sous l'impulsion du surplus solaire, ce qui est la solution IAMMETER Système de contrôle du chauffage PV.
- Vous n'avez pas de compteur IAMMETER, mais vous connaissez Home Assistant ou Node-RED et avez intégré le WPC3700 dans le système d'automatisation HA ou Node-RED (Activer la découverte MQTT dans Home Assistant avec le dernier firmware IAMMETER (i.76.058.8)).
- Vous devez appeler l'API pour intégrer le WPC3700 dans votre propre système.
Seuls les utilisateurs qui nécessitent le troisième mode de fonctionnement devraient lire cet article.
/api/setpower
/api/setpower?x=100
Introduction
Cette API contrôle la puissance de sortie du WPC.
Remarque : Ce paramètre peut également être modifié via l'API setadv (appel HTTP POST, paramètre setPower).
Étant donné que le paramètre setPower peut devoir être fréquemment modifié en fonction des relevés de puissance du réseau en temps réel, cette interface API HTTP GET supplémentaire est fournie.
URL et méthode
URL : http://{{IP}}/api/setpower
Méthode : HTTP GET
| Nom du paramètre | Exemple de valeur | Unité | Requis | Type | Description |
|---|---|---|---|---|---|
| x | 100 | W | Oui | int | Représente la puissance de sortie du WPC. Il s'agit du même paramètre que setPower dans setadv. |
/api/setadv
Introduction
Cette API est utilisée pour configurer les paramètres du WPC.
Remarque : Tous les paramètres peuvent être définis directement via l'interface utilisateur. Seul un petit nombre de clients qui doivent intégrer les produits de la série WPC dans leurs propres systèmes utiliseront cette API.
URL et méthode
- URL :
http://{{IP locale du WPC}}/api/setadv - Méthode : HTTP POST
Paramètres de la requête
Voici un exemple des paramètres setadv.
Remarque : Lors de l'exécution de setadv, il n'est pas nécessaire de soumettre tous les paramètres. Seuls les paramètres qui doivent être modifiés doivent être soumis. Les paramètres qui n'ont pas besoin de modification n'ont pas besoin d'être soumis. Vous pouvez d'abord utiliser getadv pour lire la configuration actuelle, puis soumettre uniquement les paramètres à modifier.
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"meterAddress": "10.10.30.35",
"threshold": 30,
"hysteresis": 50,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 1,
"mqttEnabled": 1,
"mqttAddress": "10.10.30.89:1883",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 6
}
Réponse
{
"successful": 1,
"message": "ok"
}
Description des paramètres
| Nom du paramètre | Type | Unité | Description |
|---|---|---|---|
| maxPower | int | W | La puissance maximale de la charge contrôlée, doit être inférieure à 3700 |
| setPower | int | W | La puissance de sortie du WPC |
| restorePower | int | W | Puissance après la sortie du mode de contrôle automatique |
| setPowerMode | int | Sélection du mode de fonctionnement : 0 : Manuel, 1 : Automatique | |
| threshold | int | W | En mode automatique, seuil d'ajustement basé sur la puissance du réseau |
| hysteresis | int | W | En mode automatique, hystérésis d'ajustement basé sur la puissance du réseau |
| startHour | int | heure | Heure de début du mode automatique |
| stopHour | int | heure | Heure de fin du mode automatique |
| tzOffset | int | Décalage horaire | |
| meterType | int | Choix de la marque du compteur pour la mesure du réseau en mode automatique : 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Choix du modèle de compteur pour la mesure du réseau en mode automatique : 3:triphasé, 2:utiliser phaseB, 1:ratio | |
| ntpServer | string | Adresse du serveur NTP | |
| haDiscovery | int | Activer la découverte automatique MQTT de Home Assistant : 0:désactiver, 1:activer | |
| mqttEnabled | int | Activer MQTT : 0:désactiver, 1:activer | |
| meterAddress | string | Adresse du courtier MQTT, nécessaire pour l'intégration avec Home Assistant : 192.168.1.22:1833 | |
| mqttUsername | string | Nom d'utilisateur MQTT | |
| mqttPassword | string | Mot de passe MQTT | |
| uploadInterval | int | s | Intervalle de téléchargement |
/api/getadv
Introduction
Cette API lit tous les paramètres du WPC (tous les paramètres de l'API setadv peuvent être lus ici).
URL et méthode
- URL :
http://{{IP locale du WPC}}/api/getadv - Méthode : HTTP GET
Réponse
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"setPowerModeList": "Manual,Auto",
"meterAddress": "10.10.30.35",
"threshold": 20,
"hysteresis": 30,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"meterList": "iMeter,virtualTCP",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 0,
"mqttEnabled": 0,
"mqttAddress": "192.168.1.22:1833",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 60
}
Reportez-vous à la description des paramètres dans setadv.
/api/setwifiadv
Introduction
Cette API configure les paramètres Wi-Fi pour les appareils WPC/WEM.
URL et méthode
- URL :
http://{{IP locale du WPC}}/api/setwifiadv - Méthode : HTTP POST
Paramètres de la requête
{
"ssid":"xxxx",
"pwd":"xxxx",
"ip":"xxxx",
"netmask":"xxxxx",
"gw":"xxxx",
"dns":"192.168.1.1",
"dhcp":true,
"runMode":"cloud", // cloud, tcp, http
"uploadAddress":"http://myserver.com/upload" // Utile uniquement si runMode n'est pas cloud
}
Réponse
{
"successful": true,
"message": "ok"
}
Description des paramètres
| Nom du paramètre | Type | Unité | Description |
|---|---|---|---|
| ssid | string | Nom du point d'accès Wi-Fi pour la connexion WLAN | |
| pwd | string | Mot de passe Wi-Fi pour la connexion WLAN | |
| ip | string | IP statique ; non requis en mode DHCP | |
| netmask | string | Masque de sous-réseau ; non requis en mode DHCP | |
| gw | string | Passerelle ; non requis en mode DHCP | |
| dns | string | Serveur DNS ; non requis en mode DHCP | |
| dhcp | bool | false : désactiver DHCP, true : activer DHCP |
Documentation de référence
Les fonctionnalités « cachées » du firmware du compteur d'énergie Wi-Fi
N'hésitez pas à nous faire part de vos réflexions sur notre forum. https://imeter.club
À propos d'IAMMETER
IAMMETER est une entreprise spécialisée dans les produits et services de gestion de l'énergie, proposant des compteurs d'énergie intelligents, des applications de gestion et des plateformes cloud.
Notre objectif est d'aider les clients à gérer, utiliser et économiser efficacement l'énergie, en réduisant les factures d'électricité grâce à une surveillance et une analyse intelligentes.
Solutions
Produits
- Aperçu des compteurs d'énergie IAMMETER
- WEM3080T – Compteur d'énergie Wi-Fi triphasé/biphasé
- WEM3080 – Compteur d'énergie Wi-Fi monophasé
- WEM3050T – Compteur d'énergie triphasé
- WEM3046T – Compteur d'énergie Wi-Fi triphasé avec entrée CT standard 5A