API του WPC3700
Συντομογραφία όρου WPC: Wi-Fi power controller (ελεγκτής ισχύος Wi-Fi)
API των ελεγκτών ισχύος της σειράς WPC
Αυτό το άρθρο παρουσιάζει κυρίως τα API που παρέχονται από τους ελεγκτές ισχύος της σειράς WPC. Μέσω αυτών των API, οι χρήστες μπορούν να εκτελέσουν τις ακόλουθες λειτουργίες:
- Ρύθμιση των παραμέτρων του WPC
- Έλεγχος της ισχύος εξόδου του WPC
Ποιος Πρέπει να Διαβάσει Αυτό το Άρθρο
Αυτή η ενότητα τοποθετείται στην αρχή επειδή, αν και γράψαμε αυτό το άρθρο, στην πραγματικότητα δεν αφορά τους περισσότερους χρήστες του WPC.
Εάν έχετε αποκτήσει έναν ελεγκτή ισχύος της σειράς WPC, υπάρχουν μερικοί πιθανοί τρόποι λειτουργίας:
- Έχετε ήδη εγκαταστήσει μετρητές IAMMETER στην πλευρά του δικτύου και χρησιμοποιείτε άμεσα το WPC3700 σε συνδυασμό με μετρητές IAMMETER (το WPC3700 λειτουργεί σε αυτόματη λειτουργία), επιτρέποντας στο WPC3700 να λειτουργεί συνεχώς με γνώμονα την πλεονάζουσα ηλιακή ενέργεια· πρόκειται για τη λύση της IAMMETER Σύστημα Ελέγχου Θερμοσίφωνα με Φωτοβολταϊκά.
- Δεν έχετε μετρητή IAMMETER, αλλά είστε εξοικειωμένοι με το Home Assistant ή το Node-RED και έχετε ενσωματώσει το WPC3700 στο σύστημα αυτοματισμού HA ή Node-RED (Ενεργοποίηση της ανακάλυψης MQTT στο Home Assistant με το τελευταίο firmware της IAMMETER (i.76.058.8)).
- Χρειάζεται να καλέσετε το API για να ενσωματώσετε το WPC3700 στο δικό σας σύστημα.
Μόνο οι χρήστες που χρειάζονται τον τρίτο τρόπο λειτουργίας θα πρέπει να διαβάσουν αυτό το άρθρο.
/api/setpower
/api/setpower?x=100
Εισαγωγή
Αυτό το API ελέγχει την ισχύ εξόδου του WPC.
Σημείωση: Αυτή η παράμετρος μπορεί επίσης να τροποποιηθεί μέσω του API setadv (κλήση HTTP POST, παράμετρος setPower).
Επειδή η παράμετρος setPower μπορεί να χρειαστεί να τροποποιηθεί συχνά με βάση τις μετρήσεις ισχύος του δικτύου σε πραγματικό χρόνο, παρέχεται επιπλέον αυτή η διεπαφή API HTTP GET.
URL και Μέθοδος
URL: http://{{IP}}/api/setpower
Μέθοδος: HTTP GET
| Όνομα Παραμέτρου | Παράδειγμα Τιμής | Μονάδα | Υποχρεωτική | Τύπος | Περιγραφή |
|---|---|---|---|---|---|
| x | 100 | W | Ναι | int | Αντιπροσωπεύει την ισχύ εξόδου του WPC. Είναι η ίδια παράμετρος με το setPower στο setadv. |
/api/setadv
Εισαγωγή
Αυτό το API χρησιμοποιείται για τον ορισμό των παραμέτρων του WPC.
Σημείωση: Όλες οι παράμετροι μπορούν να οριστούν απευθείας μέσω του UI. Μόνο ένας μικρός αριθμός πελατών που χρειάζονται να ενσωματώσουν τα προϊόντα της σειράς WPC στα δικά τους συστήματα θα χρησιμοποιήσει αυτό το API.
URL και Μέθοδος
- URL:
http://{{Τοπική IP του WPC}}/api/setadv - Μέθοδος: HTTP POST
Παράμετροι Αιτήματος
Παρακάτω παρατίθεται ένα παράδειγμα των παραμέτρων του setadv.
Σημείωση: Κατά την εκτέλεση του setadv, δεν χρειάζεται να υποβληθούν όλες οι παράμετροι. Θα πρέπει να υποβληθούν μόνο οι παράμετροι που πρέπει να τροποποιηθούν. Οι παράμετροι που δεν χρειάζονται τροποποίηση δεν χρειάζεται να υποβληθούν. Μπορείτε πρώτα να χρησιμοποιήσετε το getadv για να διαβάσετε την τρέχουσα διαμόρφωση και στη συνέχεια να υποβάλετε μόνο τις παραμέτρους που πρέπει να τροποποιηθούν.
{
"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
}
Απόκριση
{
"successful": 1,
"message": "ok"
}
Περιγραφή Παραμέτρων
| Όνομα Παραμέτρου | Τύπος | Μονάδα | Περιγραφή |
|---|---|---|---|
| maxPower | int | W | Η μέγιστη ισχύς του ελεγχόμενου φορτίου, πρέπει να είναι μικρότερη από 3700 |
| setPower | int | W | Η ισχύς εξόδου του WPC |
| restorePower | int | W | Ισχύς μετά την έξοδο από τον αυτόματο έλεγχο λειτουργίας |
| setPowerMode | int | Επιλογή λειτουργίας: 0: Χειροκίνητη, 1: Αυτόματη | |
| threshold | int | W | Σε αυτόματη λειτουργία, είναι το όριο για τη ρύθμιση με βάση την ισχύ του δικτύου |
| hysteresis | int | W | Σε αυτόματη λειτουργία, είναι η υστέρηση για τη ρύθμιση με βάση την ισχύ του δικτύου |
| startHour | int | ώρα | Ώρα έναρξης της αυτόματης λειτουργίας |
| stopHour | int | ώρα | Ώρα λήξης της αυτόματης λειτουργίας |
| tzOffset | int | Μετατόπιση ζώνης ώρας | |
| meterType | int | Επιλογή μάρκας μετρητή για τη μέτρηση του δικτύου σε αυτόματη λειτουργία: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Επιλογή μοντέλου μετρητή για τη μέτρηση του δικτύου σε αυτόματη λειτουργία: 3:τριφασικός, 2:χρήση φάσης B, 1:αναλογία | |
| ntpServer | string | Διεύθυνση διακομιστή NTP | |
| haDiscovery | int | Ενεργοποίηση της αυτόματης ανακάλυψης MQTT του Home Assistant: 0: απενεργοποίηση, 1: ενεργοποίηση | |
| mqttEnabled | int | Ενεργοποίηση MQTT: 0: απενεργοποίηση, 1: ενεργοποίηση | |
| meterAddress | string | Διεύθυνση διακομιστή MQTT (broker), απαραίτητη κατά την ενσωμάτωση με το Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | Όνομα χρήστη MQTT | |
| mqttPassword | string | Κωδικός πρόσβασης MQTT | |
| uploadInterval | int | s | Χρόνος διαστήματος αποστολής δεδομένων |
/api/getadv
Εισαγωγή
Αυτό το API διαβάζει όλες τις παραμέτρους του WPC (όλες οι παράμετροι του API setadv μπορούν να διαβαστούν εδώ).
URL και Μέθοδος
- URL:
http://{{Τοπική IP του WPC}}/api/getadv - Μέθοδος: HTTP GET
Απόκριση
{
"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
}
Ανατρέξτε στην περιγραφή των παραμέτρων στο setadv.
/api/setwifiadv
Εισαγωγή
Αυτό το API διαμορφώνει τις παραμέτρους Wi-Fi για συσκευές WPC/WEM.
URL και Μέθοδος
- URL:
http://{{Τοπική IP του WPC}}/api/setwifiadv - Μέθοδος: HTTP POST
Παράμετροι Αιτήματος
{
"ssid": "xxxx",
"pwd": "xxxx",
"ip": "xxxx",
"netmask": "xxxxx",
"gw": "xxxx",
"dns": "192.168.1.1",
"dhcp": true,
"runMode": "cloud",
"uploadAddress": "http://myserver.com/upload"
}
Απόκριση
{
"successful": true,
"message": "ok"
}
Περιγραφή Παραμέτρων
| Όνομα Παραμέτρου | Τύπος | Μονάδα | Περιγραφή |
|---|---|---|---|
| ssid | string | Όνομα σημείου πρόσβασης (AP) Wi-Fi για τη σύνδεση WLAN | |
| pwd | string | Κωδικός πρόσβασης Wi-Fi για τη σύνδεση WLAN | |
| ip | string | Στατική διεύθυνση IP· δεν απαιτείται εάν χρησιμοποιείτε λειτουργία DHCP | |
| netmask | string | Μάσκα δικτύου· δεν απαιτείται εάν χρησιμοποιείτε λειτουργία DHCP | |
| gw | string | Πύλη (gateway)· δεν απαιτείται εάν χρησιμοποιείτε λειτουργία DHCP | |
| dns | string | Διακομιστής DNS· δεν απαιτείται εάν χρησιμοποιείτε λειτουργία DHCP | |
| dhcp | bool | false: απενεργοποίηση DHCP, true: ενεργοποίηση DHCP |
Τεκμηρίωση Αναφοράς
Τα "κρυφά" χαρακτηριστικά στο firmware του μετρητή ενέργειας Wi-Fi
Προηγμένη λειτουργία της IAMMETER
Μη διστάσετε να μας πείτε τη γνώμη σας στο φόρουμ μας. https://imeter.club
Σχετικά με την IAMMETER
Η IAMMETER είναι μια εταιρεία που επικεντρώνεται σε προϊόντα και υπηρεσίες διαχείρισης ενέργειας, προσφέροντας έξυπνους μετρητές ενέργειας, εφαρμογές διαχείρισης και πλατφόρμες cloud.
Στόχος μας είναι να βοηθήσουμε τους πελάτες να διαχειρίζονται, να αξιοποιούν και να εξοικονομούν ενέργεια αποτελεσματικά, μειώνοντας τους λογαριασμούς ηλεκτρικού ρεύματος μέσω έξυπνης παρακολούθησης και ανάλυσης.
Λύσεις
Προϊόντα
- Επισκόπηση των μετρητών ενέργειας IAMMETER
- WEM3080T – Τριφασικός/Διαχωρισμένης φάσης μετρητής ενέργειας Wi-Fi
- WEM3080 – Μονοφασικός μετρητής ενέργειας Wi-Fi
- WEM3050T – Τριφασικός μετρητής ενέργειας
- WEM3046T – Τριφασικός μετρητής ενέργειας Wi-Fi με τυπική είσοδο μετασχηματιστή έντασης (CT) 5A