Μετρητής ενέργειας Wi-Fi IAMMETER: Τοπικά API και ανοιχτές διεπαφές

Μετρητής ενέργειας Wi-Fi IAMMETER: Τοπικά API και ανοιχτές διεπαφές

Οι μετρητές ενέργειας Wi-Fi της IAMMETER υποστηρίζουν το IAMMETER-Cloud καθώς και τοπικές ολοκληρώσεις και ολοκληρώσεις τρίτων.

Οι διαθέσιμες διεπαφές περιλαμβάνουν:

• Τοπικό HTTP API μέσω LAN
• Δημοσίευση μέσω MQTT και MQTTS
• Modbus TCP
• Μεταφόρτωση μέσω TCP/TLS
• Μεταφόρτωση μέσω HTTP/HTTPS
• Τοπική λειτουργία χωρίς σύνδεση (stand-alone)

Αυτές οι διεπαφές επιτρέπουν στους μετρητές IAMMETER να λειτουργούν ως ανοιχτές πηγές δεδομένων για:

• Το Home Assistant και άλλες πλατφόρμες έξυπνου σπιτιού
• Αυτοματισμούς με Node-RED
• Πίνακες ελέγχου αυτο-φιλοξενίας (self-hosted)
• Συστήματα PLC και SCADA
• Προσαρμοσμένα Συστήματα Διαχείρισης Ενέργειας (EMS)
• Προσαρμοσμένα Συστήματα Διαχείρισης Κτιρίων (BMS)
• Διακομιστές δεδομένων τρίτων

Αυτός ο οδηγός περιγράφει πρώτα το τρέχον firmware και το WebUI. Τα στιγμιότυπα οθόνης και οι μέθοδοι διαμόρφωσης για παλαιότερο firmware διατηρούνται στην τελική ενότητα Legacy.

Για μια έτοιμη προς χρήση εφαρμογή βασισμένη σε αυτές τις δυνατότητες, δείτε την Παρακολούθηση οικιακής ενέργειας, την Παρακολούθηση ηλιακής ενέργειας ή την τοπική παρακολούθηση χωρίς πρόσβαση στο Διαδίκτυο.

1) Ενημέρωση στο νεότερο Firmware

Το firmware της IAMMETER ενημερώνεται συνεχώς. Πριν διαμορφώσετε μια ολοκλήρωση, ελέγξτε την τρέχουσα έκδοση και τη συμβατότητα των μοντέλων:

• Σελίδα εκδόσεων Firmware IAMMETER

Το WebUI του νεότερου firmware εμφανίζει απευθείας τις συχνά χρησιμοποιούμενες επιλογές διαμόρφωσης. Οι μη αυτόματες κλήσεις API διαμόρφωσης που διατηρούνται αργότερα σε αυτό το άρθρο είναι κυρίως χρήσιμες κατά τη συντήρηση παλαιότερων εγκαταστάσεων.

2) Επιλογή της λειτουργίας εκτέλεσης (Run Mode) στο τρέχον WebUI

Επιλέξτε μια λειτουργία εκτέλεσης ανάλογα με το πού πρέπει να στέλνει δεδομένα ο μετρητής ή πώς πρέπει να λειτουργεί τοπικά.

Η λειτουργία εκτέλεσης ελέγχει τη συμπεριφορά μεταφόρτωσης δεδομένων. Η διαθεσιμότητα του τοπικού API και του Modbus TCP θα πρέπει να ελέγχεται για το μοντέλο του μετρητή, το firmware και την επιλεγμένη ολοκλήρωση.

3) Γιατί έχουν σημασία οι ανοιχτές διεπαφές

Οι ανοιχτές διεπαφές επιτρέπουν στους χρήστες να αποφασίζουν πού θα επεξεργάζονται και θα αποθηκεύονται τα δεδομένα ηλεκτρικής ενέργειας.

Τυπικοί λόγοι περιλαμβάνουν:

• Διατήρηση των μετρήσεων εντός του τοπικού δικτύου
• Αποστολή τηλεμετρίας σε υπάρχοντα διακομιστή
• Σύνδεση των ενεργειακών δεδομένων με το Home Assistant ή το Node-RED
• Δημιουργία προσαρμοσμένων πινάκων ελέγχου και συναγερμών
• Συνδυασμός των δεδομένων ηλεκτρικής ενέργειας με τιμολόγια, ηλιακή ενέργεια ή λογική ελέγχου φορτίου
• Λειτουργία σε τοποθεσία με περιορισμένη ή αναξιόπιστη πρόσβαση στο Διαδίκτυο

Η πρόσβαση μέσω Cloud και η τοπική πρόσβαση δεν είναι κατ' ανάγκην αμοιβαία αποκλειόμενες. Η κατάλληλη αρχιτεκτονική εξαρτάται από το αν το έργο χρειάζεται αναφορές IAMMETER-Cloud, τοπική πλατφόρμα, διακομιστή τρίτου μέρους ή συνδυασμό αυτών.

4) Αποστολή δεδομένων σε διακομιστή τρίτου μέρους

4.1 TCP και TLS

Η IAMMETER μπορεί να αποστέλλει δεδομένα του μετρητή σε τελικό σημείο TCP ή TLS.

Στο τρέχον WebUI:

1. Επιλέξτε τη λειτουργία εκτέλεσης TCP.
2. Εισαγάγετε τη διεύθυνση προορισμού.
3. Διαμορφώστε το διάστημα μεταφόρτωσης.
4. Αποθηκεύστε τις ρυθμίσεις και επαληθεύστε τα δεδομένα στον διακομιστή λήψης.

Για διακομιστή TCP, χρησιμοποιήστε:

{domain-or-ip}:{port}

Παράδειγμα:

abc.com:12345

Για διακομιστή TLS, χρησιμοποιήστε:

tls://{domain-or-ip}:{port}

Παράδειγμα:

tls://abc.com:12345

Η επισκόπηση του τρέχοντος firmware τεκμηριώνει ελάχιστο διάστημα μεταφόρτωσης 2 δευτερολέπτων. Επιβεβαιώστε το τρέχον firmware και τη χωρητικότητα του διακομιστή λήψης προτού επιλέξετε σύντομο διάστημα.

4.2 MQTT και MQTTS

Η IAMMETER μπορεί να δημοσιεύει τηλεμετρία απευθείας σε broker MQTT χωρίς κρυπτογράφηση ή να χρησιμοποιεί MQTTS για κρυπτογραφημένη μεταφορά σε υποστηριζόμενο firmware.

Στο τρέχον WebUI:

1. Επιλέξτε τη λειτουργία εκτέλεσης MQTT.
2. Εισαγάγετε τη διεύθυνση IP ή τον τομέα του broker και τη θύρα χρησιμοποιώντας την κατάλληλη μορφή MQTT ή MQTTS.
3. Εισαγάγετε το όνομα χρήστη και τον κωδικό πρόσβασης του broker όταν απαιτείται έλεγχος ταυτότητας.
4. Διαμορφώστε το διάστημα μεταφόρτωσης.
5. Αποθηκεύστε και επαληθεύστε ότι τα μηνύματα φτάνουν στον broker.

Για απλό MQTT, εισαγάγετε τη διεύθυνση του broker και τη θύρα χωρίς πρόθεμα mqtt://:

192.168.11.163:1883

Για MQTTS, συμπεριλάβετε το πρόθεμα mqtts://:

mqtts://{mqtt-broker-address}:{port}

Παράδειγμα:

mqtts://broker.example.com:8883

Η υποστήριξη MQTTS που τεκμηριώνεται στην ενημέρωση firmware Νοεμβρίου 2025 έχει τους ακόλουθους τρέχοντες περιορισμούς:

• Υποστηρίζει TLS 1.2 και παλαιότερες εκδόσεις.
• Η μεταφόρτωση προσαρμοσμένου πιστοποιητικού CA δεν υποστηρίζεται.
• Η επαλήθευση ονόματος κεντρικού υπολογιστή (hostname) δεν υποστηρίζεται.
• Τα πιστοποιητικά πλευράς πελάτη για αμοιβαίο έλεγχο ταυτότητας TLS δεν υποστηρίζονται.

Αυτοί οι περιορισμοί είναι σημαντικοί κατά την επιλογή broker και την αξιολόγηση των απαιτήσεων ασφαλείας της ανάπτυξης.

Η επισκόπηση του τρέχοντος firmware τεκμηριώνει ελάχιστο διάστημα μεταφόρτωσης 2 δευτερολέπτων.

Το Home Assistant MQTT Discovery είναι μια πρόσθετη λειτουργία ανακάλυψης του Home Assistant· δεν απαιτείται για κάθε ολοκλήρωση MQTT. Δείτε:

• Οδηγός ολοκλήρωσης MQTT της IAMMETER
• MQTT Discovery στο Home Assistant

Αλλαγή του uploadInterval εξ αποστάσεως μέσω MQTT/MQTTS

Με το firmware που περιγράφεται στην ενημέρωση Νοεμβρίου 2025, ένας μετρητής που λειτουργεί σε λειτουργία MQTT εγγράφεται αυτόματα σε:

device/{sn}/config

Δημοσιεύστε το παρακάτω JSON από άλλο πελάτη MQTT για να αλλάξετε εξ αποστάσεως το διάστημα μεταφόρτωσης:

{"uploadInterval": 10}

Αντικαταστήστε το 10 με το επιθυμητό διάστημα σε δευτερόλεπτα και το {sn} με τον σειριακό αριθμό του μετρητή στο θέμα (topic).

Αυτή η εξ αποστάσεως διαμόρφωση MQTT διαφέρει από την παλαιότερη τοπική μέθοδο /api/uploadinterval που διατηρείται στην ενότητα Legacy.

4.3 HTTP και HTTPS

Η IAMMETER μπορεί να αποστέλλει δεδομένα σε προσαρμοσμένο διακομιστή HTTP/HTTPS.

Στο τρέχον WebUI:

1. Επιλέξτε τη λειτουργία εκτέλεσης HTTP.
2. Εισαγάγετε τη διεύθυνση και τη θύρα του διακομιστή.
3. Διαμορφώστε το διάστημα μεταφόρτωσης.
4. Αποθηκεύστε και επαληθεύστε τα αιτήματα στον διακομιστή.

Το τρέχον firmware υποστηρίζει τόσο την προεπιλεγμένη θύρα HTTPS όσο και μια προσαρμοσμένη θύρα HTTPS.

Χρησιμοποιήστε μία από αυτές τις μορφές:

• Απλό HTTP χωρίς ρητή θύρα: {address} — προεπιλεγμένη θύρα 80.
• Απλό HTTP με προσαρμοσμένη θύρα: {address}:{port}.
• HTTPS χωρίς ρητή θύρα: https://{address} — προεπιλεγμένη θύρα 443.
• HTTPS με προσαρμοσμένη θύρα: https://{address}:{port} — χρησιμοποιεί την καθορισμένη θύρα.

Το πρόθεμα https:// επιλέγει HTTPS. Η θύρα 443 δεν είναι πλέον η μόνη διαθέσιμη θύρα για HTTPS.

Παραδείγματα:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Δείτε το Νέο firmware προσθέτει MQTTS, εξ αποστάσεως διαμόρφωση και προσαρμοσμένη θύρα HTTPS για τις σημειώσεις έκδοσης του firmware.

Για τον χειρισμό των δεδομένων στην πλευρά του διακομιστή, δείτε επίσης την Ολοκλήρωση του IAMMETER με διακομιστή τρίτου μέρους.

5) Τοπική ανάγνωση δεδομένων μέσω HTTP

Συνδέστε τον μετρητή στο LAN και ζητήστε δεδομένα από την τοπική διεύθυνση IP του. Αυτά τα αιτήματα δεν απαιτούν IAMMETER-Cloud.

Δοκιμάστε τα API διαδραστικά： Ανοίξτε τον Εξερευνητή Τοπικού API της IAMMETER, εισαγάγετε την τοπική διεύθυνση IP του μετρητή και επιλέξτε τη σελίδα δοκιμής WEM API. Ο εξερευνητής τύπου Swagger παραθέτει τα διαθέσιμα τοπικά API και σας επιτρέπει να στέλνετε δοκιμαστικά αιτήματα απευθείας από το πρόγραμμα περιήγησης. Το πρόγραμμα περιήγησής σας και ο μετρητής IAMMETER πρέπει να βρίσκονται στο ίδιο LAN.

5.1 GET /api/monitorjson

Επιστρέφει μετρήσεις ηλεκτρικών μεγεθών σε πραγματικό χρόνο.

Τα τυπικά δεδομένα περιλαμβάνουν τιμές όπως:

• Τάση
• Ένταση ρεύματος
• Ενεργός ισχύς
• Προωθημένη/εισαγόμενη kWh
• Αντιστρεπτή/εξαγόμενη kWh
• Συχνότητα
• Συντελεστής ισχύος

Παράδειγμα απόκρισης:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

Ο αριθμός των πινάκων μετρήσεων εξαρτάται από το μοντέλο του μετρητή και τον αριθμό των καναλιών.

Εάν η μέτρηση άεργου ισχύος είναι ενεργοποιημένη σε υποστηριζόμενο μοντέλο/firmware, η μορφή απόκρισης μπορεί να περιέχει πρόσθετα πεδία. Δείτε τη Μορφή δεδομένων μέτρησης άεργου ισχύος.

5.2 GET /api/monitor

Επιστρέφει μια εκτεταμένη απόκριση πραγματικού χρόνου που περιλαμβάνει επίσης πληροφορίες Wi-Fi όπως:

• ssid — όνομα του συνδεδεμένου σημείου πρόσβασης
• sig — ισχύς σήματος Wi-Fi

Χρησιμοποιήστε αυτό το τελικό σημείο όταν μια ολοκλήρωση χρειάζεται τόσο ηλεκτρικές μετρήσεις όσο και βασική κατάσταση Wi-Fi.

5.3 GET /api/wifidata

Επιστρέφει πληροφορίες διαμόρφωσης firmware, συσκευής και δικτύου.

Παράδειγμα:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Μην δημοσιεύετε αποκρίσεις που περιέχουν σειριακούς αριθμούς συσκευών, διευθύνσεις MAC, εσωτερικές διευθύνσεις ή πληροφορίες Wi-Fi, εκτός εάν οι τιμές έχουν απολυμανθεί (sanitized).

6) Μορφή JSON σε όλες τις λειτουργίες μεταφόρτωσης

Η IAMMETER χρησιμοποιεί μια συνεπή βασική δομή μετρήσεων JSON σε HTTP, TCP, MQTT και το τοπικό API. Αυτό μειώνει την εργασία που απαιτείται όταν ένα σύστημα λήψης υποστηρίζει πολλαπλές μεθόδους μεταφοράς.

Η μέθοδος μεταφοράς και το περίβλημα (envelope) μπορεί να επηρεάζουν τον τρόπο με τον οποίο ένας παραλήπτης συνδέεται, πιστοποιείται ή διαμορφώνει ένα μήνυμα. Υλοποιήστε το σύστημα λήψης σύμφωνα με την τεκμηριωμένη μορφή για την επιλεγμένη λειτουργία.

• Ορισμός δεδομένων JSON μετρητή ενέργειας IAMMETER

7) Modbus TCP

Οι μετρητές IAMMETER υποστηρίζουν Modbus TCP για άμεση ολοκλήρωση μέσω LAN με συμβατούς πελάτες.

Τυπικοί πελάτες περιλαμβάνουν:

• Home Assistant
• PLC
• Συστήματα SCADA
• Βιομηχανικές πύλες (gateways)
• Προσαρμοσμένες εφαρμογές Modbus

Αναφορές:

• Επισκόπηση Modbus TCP της IAMMETER
• Επισκόπηση ολοκλήρωσης Home Assistant

Επιβεβαιώστε το μοντέλο του μετρητή, το firmware, τον ορισμό των καταχωρητών (registers), το διάστημα δημοσκόπησης (polling) και τη συμπεριφορά του πελάτη πριν από την ανάπτυξη.

8) Σενάρια ολοκλήρωσης

9) Σύνοψη τρεχουσών διεπαφών και πόροι

Πρόσθετοι πόροι:

• Νεότερο Firmware
• Σημείωση firmware για MQTTS και προσαρμοσμένη θύρα HTTPS
• Εκπαιδευτικά βίντεο
• Ορισμός δεδομένων JSON
• Επισκόπηση Modbus TCP
• Αναπτύξτε το δικό σας σύστημα
• Παρακολούθηση χωρίς πρόσβαση στο Διαδίκτυο

Τα τοπικά API και τα ανοιχτά πρωτόκολλα της IAMMETER καθιστούν δυνατό να ξεκινήσετε με παρακολούθηση σε πραγματικό χρόνο και αργότερα να προσθέσετε ένα προσαρμοσμένο EMS, πίνακα ελέγχου αυτο-φιλοξενίας ή ροή εργασιών αυτοματισμού.

10) Σελίδες παλαιού firmware και μέθοδοι διαμόρφωσης

Το παρακάτω υλικό διατηρείται μόνο για μετρητές που εξακολουθούν να εκτελούν παλαιότερο firmware ή για χρήστες που συντηρούν μια υπάρχουσα ολοκλήρωση. Για μια νέα εγκατάσταση, ενημερώστε στο νεότερο firmware και χρησιμοποιήστε το τρέχον WebUI όπου είναι διαθέσιμη η απαιτούμενη επιλογή.

10.1 Σελίδα λειτουργίας εκτέλεσης (παλαιού firmware)

Το παλαιότερο firmware χρησιμοποιούσε την ακόλουθη σελίδα επιλογής λειτουργίας εκτέλεσης:

Η διάταξη και τα ονόματα των επιλογών ενδέχεται να μην ταιριάζουν με το τρέχον WebUI που παρουσιάστηκε νωρίτερα σε αυτόν τον οδηγό.

10.2 Σελίδα TCP/TLS (παλαιού firmware)

Οι ολοκληρώσεις παλαιότερου firmware ενδέχεται να αναφέρονται σε αυτή τη σελίδα διαμόρφωσης TCP/TLS και στον σχετικό οδηγό:

• Οδηγός ολοκλήρωσης διακομιστή τρίτου μέρους (παλαιός)
• Βίντεο μεταφόρτωσης σε διακομιστή (παλαιό)

10.3 Σελίδα MQTT (παλαιού firmware)

Η παλαιότερη τεκμηρίωση MQTT χρησιμοποιούσε αυτή τη διεπαφή διαμόρφωσης:

Για την τρέχουσα διαδικασία, χρησιμοποιήστε τις οδηγίες του τρέχοντος WebUI που αναφέρονται νωρίτερα σε αυτό το άρθρο και τον ενημερωμένο Οδηγό ολοκλήρωσης MQTT.

10.4 Σελίδα HTTP/HTTPS (παλαιού firmware)

Το παλαιότερο firmware χρησιμοποιούσε την ακόλουθη σελίδα προορισμού HTTP/HTTPS:

Ο παλαιός οδηγός ολοκλήρωσης διατηρείται στη Μεταφόρτωση μέσω HTTP/HTTPS.

Σε αυτή την παλαιότερη διαδικασία, το HTTPS συνδεόταν με την προεπιλεγμένη θύρα 443 και δεν απαιτούσε το πρόθεμα https://. Το τρέχον firmware χρησιμοποιεί αντίθετα το πρόθεμα https:// για την επιλογή HTTPS και υποστηρίζει είτε την προεπιλεγμένη θύρα 443 είτε μια ρητά καθορισμένη προσαρμοσμένη θύρα.

10.5 Τοπικά API διαμόρφωσης (παλαιά)

Οι ακόλουθες κλήσεις τοπικού API εμφανίζονταν σε παλαιότερες διαδικασίες διαμόρφωσης. Στο τρέχον firmware, οι αντίστοιχες ρυθμίσεις θα πρέπει κανονικά να διαμορφώνονται μέσω του WebUI, όταν η επιλογή είναι διαθέσιμη.

/api/uploadinterval?x=<seconds>

Παλαιά μέθοδος για τον ορισμό του διαστήματος μεταφόρτωσης εκτός Cloud.

/api/mqtt

Παλαιά μέθοδος για τη διαμόρφωση των διαπιστευτηρίων MQTT.

/api/netmetring

Παλαιά μέθοδος για την ενεργοποίηση ή απενεργοποίηση της λειτουργίας Net Energy Metering.

• Αναφορά Net Energy Metering

/api/ctcratio

Παλαιά μέθοδος για την εφαρμογή του τεκμηριωμένου πολλαπλασιαστή Φάσης C σε συγκεκριμένα σενάρια διαιρεμένης φάσης (split-phase) ή ισορροπημένου φορτίου.

• Αναφορά αναλογίας CTC

/api/reactive

Παλαιά μέθοδος για την ενεργοποίηση ή απενεργοποίηση της μέτρησης άεργου ισχύος και άεργης ενέργειας σε υποστηριζόμενα firmware/μοντέλα.

• Αναφορά άεργου ισχύος

/api/ratio — μόνο για WEM3046T

Το WEM3046T χρησιμοποιεί εξωτερικούς μετασχηματιστές έντασης (CT) με δευτερεύουσα έξοδο 5 A. Οι παλαιότερες οδηγίες διαμόρφωσης όριζαν την αναλογία CT με:

/api/ratio?x={ct_ratio}

Παράδειγμα:

/api/ratio?x=400

Αυτό το τελικό σημείο είναι ειδικό για το WEM3046T και δεν ισχύει για άλλα μοντέλα IAMMETER. Για το τρέχον firmware, χρησιμοποιήστε τη διαμόρφωση του τρέχοντος WebUI του μοντέλου όταν είναι διαθέσιμη.

Το παλαιό υλικό διατηρείται για μελλοντική αναφορά· οι τρέχουσες εγκαταστάσεις θα πρέπει να ακολουθούν το WebUI του νεότερου firmware.