Désolé, votre navigateur ne prend pas en charge JavaScript !
Se connecter

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 :

  1. 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.
  2. 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)).
  3. 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

Fonction avancée d'IAMMETER

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

Système

Haut