Το MQTT Discovery του Home Assistant για Μετρητή Ενέργειας

Το MQTT Discovery του Home Assistant για Μετρητή Ενέργειας

Το MQTT Discovery του Home Assistant επιτρέπει σε έναν μετρητή ενέργειας να δημιουργεί αυτόματα τη συσκευή του και τις οντότητες των αισθητήρων του. Αφού ο μετρητής και το Home Assistant συνδεθούν στον ίδιο broker MQTT, το Home Assistant μπορεί να ανακαλύψει τον μετρητή χωρίς χειροκίνητο YAML αισθητήρων MQTT.

Η IAMMETER υποστηρίζει το MQTT Discovery σε όλους τους τρέχοντες μετρητές ενέργειας. Ανάλογα με το μοντέλο, το Home Assistant δημιουργεί οντότητες για τάση, ρεύμα, ενεργό ισχύ, εισαγόμενη ενέργεια, εξαγόμενη ενέργεια και άλλες διαθέσιμες μετρήσεις φάσης ή καναλιού.

Χρησιμοποιήστε αυτή τη μέθοδο όταν θέλετε:

• τοπική παρακολούθηση ενέργειας μέσω MQTT·
• αυτόματη δημιουργία συσκευής και οντοτήτων·
• ταχύτερες ενημερώσεις από ό,τι με τις ενσωματώσεις HTTP·
• οντότητες εισαγόμενης/εξαγόμενης ενέργειας συμβατές με το Energy Dashboard·
• ελάχιστη διαμόρφωση του Home Assistant.

Αν χρειάζεστε πλήρη έλεγχο των topics, των προτύπων, των ονομάτων των οντοτήτων και των μεταδεδομένων, χρησιμοποιήστε αντί αυτού τον οδηγό χειροκίνητου MQTT μετρητή ενέργειας.

MQTT Discovery έναντι χειροκίνητου MQTT

Και οι δύο μέθοδοι απαιτούν έναν broker MQTT, αλλά μόνο το Discovery δημιουργεί αυτόματα οντότητες στο Home Assistant.

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

Απαιτήσεις

Χρειάζεστε:

• έναν μετρητή ενέργειας IAMMETER με firmware i.76.058.8 ή νεότερο·
• έναν broker MQTT προσβάσιμο από τον μετρητή και το Home Assistant·
• τη διεύθυνση, τη θύρα, το όνομα χρήστη και τον κωδικό πρόσβασης του broker·
• Home Assistant με ενεργοποιημένη την ενσωμάτωση MQTT.

Το firmware i.76.058.8 είναι η σταθερή έκδοση βάσης για το MQTT Discovery. Η προηγούμενη εικόνα i.76.02 ήταν δοκιμαστικό firmware και δεν θα πρέπει πλέον να εγκαθίσταται ούτε να αναφέρεται ως η συνιστώμενη έκδοση.

Για τις τρέχουσες διορθώσεις και τις τελευταίες επιλογές MQTT, αναβαθμίστε στο νεότερο firmware IAMMETER.

Βήμα 1: Σύνδεση του Home Assistant με τον broker MQTT

Αν το Home Assistant δεν είναι ήδη συνδεδεμένο με τον broker:

1. Ανοίξτε τις Ρυθμίσεις → Συσκευές και υπηρεσίες.
2. Επιλέξτε Προσθήκη ενσωμάτωσης.
3. Αναζητήστε MQTT.
4. Εισαγάγετε τη διεύθυνση, τη θύρα, το όνομα χρήστη και τον κωδικό πρόσβασης του broker.
5. Επιβεβαιώστε ότι η ενσωμάτωση MQTT συνδέεται με επιτυχία.

Αν το Home Assistant χρησιμοποιεί ήδη τον επιδιωκόμενο broker, διατηρήστε την υπάρχουσα ενσωμάτωση MQTT. Μην δημιουργήσετε δεύτερη σύνδεση με τον broker για τη συσκευή IAMMETER.

Το MQTT Discovery είναι ενεργοποιημένο από προεπιλογή σε μια κανονική ρύθμιση MQTT του Home Assistant. Αν το discovery έχει απενεργοποιηθεί ή χρησιμοποιείται πρόθεμα discovery διαφορετικό από το προεπιλεγμένο, βεβαιωθείτε ότι ο μετρητής και το Home Assistant χρησιμοποιούν συμβατές ρυθμίσεις.

Βήμα 2: Ρύθμιση του MQTT Discovery στο WebUI του μετρητή

Ανοίξτε το τοπικό WebUI του μετρητή και μεταβείτε στις Ρυθμίσεις. Ρυθμίστε:

Αποθηκεύστε τις ρυθμίσεις και αφήστε τον μετρητή να κάνει επανεκκίνηση ή επανασύνδεση.

Το νεότερο firmware εμφανίζει τις απαιτούμενες ρυθμίσεις στο WebUI. Δεν χρειάζεται να καλέσετε το ιστορικό τελικό σημείο /api/mqttha?x=1.

Η επιλογή HA MQTT Discovery προορίζεται ειδικά για την αυτόματη ανακάλυψη του Home Assistant. Για έναν γενικό broker, προσαρμοσμένο σύστημα, ροή Node-RED ή χειροκίνητη διαμόρφωση MQTT, αφήστε την απενεργοποιημένη και χρησιμοποιήστε την τυπική μορφή δημοσίευσης MQTT του μετρητή.

Βήμα 3: Επιβεβαίωση ότι το Home Assistant ανακαλύπτει τον μετρητή

Αφού συνδεθεί ο μετρητής με τον broker:

1. Ανοίξτε τις Ρυθμίσεις → Συσκευές και υπηρεσίες → MQTT.
2. Αναζητήστε μια νέα συσκευή IAMMETER που ανακαλύφθηκε.
3. Ανοίξτε τη συσκευή και εξετάστε τις οντότητες.
4. Επιβεβαιώστε ότι οι τιμές τάσης, ρεύματος, ισχύος και ενέργειας είναι εύλογες.
5. Ελέγξτε ότι υπάρχει ο αναμενόμενος αριθμός φάσεων ή καναλιών μέτρησης.

Η διαμόρφωση discovery και η κατάσταση μέτρησης αποστέλλονται μέσω διαφορετικών topics MQTT. Το Home Assistant χρησιμοποιεί τη διαμόρφωση discovery για να δημιουργήσει τις οντότητες και στη συνέχεια ενημερώνει τις τιμές τους όταν φτάνουν μηνύματα κατάστασης.

Αν η συσκευή δεν εμφανίζεται, κάντε επανεκκίνηση μόνο αφού ελέγξετε τη σύνδεση με τον broker και τα topics. Μια επανεκκίνηση του Home Assistant δεν μπορεί να διορθώσει λανθασμένη διεύθυνση broker ή απορριφθέντα διαπιστευτήρια MQTT.

Υποστήριξη Energy Dashboard

Τα τρέχοντα payloads MQTT Discovery της IAMMETER περιλαμβάνουν τα απαιτούμενα μεταδεδομένα για τις οντότητες εισαγόμενης και εξαγόμενης ενέργειας:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Η IAMMETER χρησιμοποιεί τα συμπαγή κλειδιά MQTT Discovery που αντιστοιχούν σε αυτά τα πεδία, συμπεριλαμβανομένων των:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

Αφού οι οντότητες λάβουν έγκυρα δεδομένα:

1. μεταβείτε στις Ρυθμίσεις → Πίνακες ελέγχου → Ενέργεια·
2. επιλέξτε την οντότητα εισαγόμενης ενέργειας για την κατανάλωση από το δίκτυο·
3. επιλέξτε την οντότητα εξαγόμενης ενέργειας για την επιστροφή στο δίκτυο·
4. αποθηκεύστε τη διαμόρφωση του Energy Dashboard.

Μην επιλέξετε μια οντότητα στιγμιαίας ενεργού ισχύος σε watt για ένα πεδίο ενέργειας. Το Energy Dashboard απαιτεί σωρευτική kWh.

Τα μονοφασικά και τα τριφασικά μοντέλα δημιουργούν διαφορετικές οντότητες ενέργειας. Επιλέξτε τις οντότητες που αντιστοιχούν στην καλωδίωση του μετρητή και στον τρόπο με τον οποίο η εγκατάσταση μετρά την εισαγωγή/εξαγωγή από το δίκτυο.

Επιλογή διαστήματος ενημέρωσης MQTT

Το νεότερο firmware της IAMMETER υποστηρίζει ενημερώσεις MQTT έως και 2 δευτερόλεπτα. Ένα μικρότερο διάστημα δίνει στο Home Assistant πιο πρόσφατες μετρήσεις ισχύος, αλλά δημιουργεί επίσης περισσότερη κίνηση στον broker, περισσότερες ενημερώσεις οντοτήτων και περισσότερα δεδομένα καταγραφής (recorder).

Προτεινόμενα σημεία εκκίνησης:

Χρησιμοποιήστε το συντομότερο διάστημα μόνο όταν ο αυτοματισμός επωφελείται από αυτό. Τα σύνολα του Energy Dashboard γενικά δεν χρειάζονται ενημερώσεις ανά δύο δευτερόλεπτα.

Συμβατότητα με το IAMMETER Cloud

Το MQTT Discovery αλλάζει το Run Mode του μετρητή σε MQTT. Ο μετρητής στέλνει τις μετρήσεις του στον διαμορφωμένο broker και δεν τις ανεβάζει ταυτόχρονα στο IAMMETER Cloud.

Αν χρειάζεστε και το Home Assistant και το IAMMETER Cloud από τον ίδιο μετρητή, επιλέξτε αντί αυτού μια τοπική ενσωμάτωση HTTP ή Modbus TCP. Αυτές οι μέθοδοι διαβάζουν τον μετρητή τοπικά ενώ η κανονική μεταφόρτωση στο Cloud συνεχίζεται.

Συγκρίνετε τις επιλογές στην επισκόπηση ενσωματώσεων μετρητή ενέργειας για Home Assistant.

Υποστηριζόμενα μοντέλα IAMMETER

Όλοι οι τρέχοντες μετρητές ενέργειας IAMMETER υποστηρίζουν το MQTT Discovery. Η βασική διαφορά είναι ο αριθμός φάσεων/καναλιών και, συνεπώς, ο αριθμός των οντοτήτων που δημιουργούνται.

Οι WEM3046T και WEM3046TE μετρούν τη δευτερεύουσα έξοδο 5 A των εξωτερικών μετασχηματιστών ρεύματος. Πρέπει να εφαρμοστεί η σωστή αναλογία CT για να ληφθούν το ρεύμα, η ισχύς και η ενέργεια της πρωτεύουσας πλευράς. Πρόκειται για απαίτηση του συστήματος μέτρησης, όχι περιορισμό του Home Assistant ή του MQTT Discovery.

Ο διακοπείς WEM3162 δεν περιλαμβάνεται στο τρέχον πεδίο συμβατότητας.

Αντιμετώπιση προβλημάτων MQTT Discovery

Το Home Assistant δεν ανακαλύπτει τον μετρητή

• Επιβεβαιώστε ότι ο μετρητής και το Home Assistant χρησιμοποιούν τον ίδιο broker.
• Ελέγξτε τη διεύθυνση, τη θύρα, το όνομα χρήστη και τον κωδικό πρόσβασης του broker.
• Επιβεβαιώστε ότι η επιλογή HA MQTT Discovery είναι ενεργοποιημένη στο WebUI του μετρητή.
• Ελέγξτε τα αρχεία καταγραφής του broker για απορριφθείσες συνδέσεις ή σφάλματα εξουσιοδότησης.
• Βεβαιωθείτε ότι η ενσωμάτωση MQTT του Home Assistant είναι συνδεδεμένη.
• Εγγραφείτε στο πρόθεμα discovery του Home Assistant στον broker με έναν πελάτη MQTT και ελέγξτε αν υπάρχουν μηνύματα διαμόρφωσης.

Η συσκευή εμφανίζεται, αλλά οι οντότητες δεν είναι διαθέσιμες

• Επιβεβαιώστε ότι ο μετρητής συνεχίζει να δημοσιεύει μηνύματα κατάστασης μετά τη διαμόρφωση discovery.
• Ελέγξτε αν κάποιο τείχος προστασίας, VLAN ή ACL του broker επιτρέπει τόσο τα topics discovery όσο και τα topics κατάστασης.
• Βεβαιωθείτε ότι ο μετρητής δεν έχει μεταβεί σε διαφορετικό broker.
• Αναβαθμίστε στο νεότερο firmware και επανασυνδεθείτε.

Η εισαγόμενη/εξαγόμενη ενέργεια δεν είναι επιλέξιμη στο Energy Dashboard

• Επιβεβαιώστε ότι η οντότητα έχει λάβει μια έγκυρη αριθμητική τιμή kWh.
• Ανοίξτε τα Εργαλεία προγραμματιστή → Καταστάσεις και εξετάστε τη μονάδα μέτρησης, την κατηγορία συσκευής και την κατηγορία κατάστασης.
• Αφαιρέστε τις ξεπερασμένες οντότητες που δημιουργήθηκαν από πρώιμο δοκιμαστικό firmware προτού αξιολογήσετε το τρέχον payload discovery.
• Βεβαιωθείτε ότι επιλέγετε οντότητα ενέργειας και όχι οντότητα ενεργού ισχύος.

Εμφανίζονται διπλότυπες οντότητες MQTT

Τα διπλότυπα εμφανίζονται συνήθως όταν:

• είναι ενεργά ταυτόχρονα το χειροκίνητο YAML MQTT και το MQTT Discovery·
• άλλαξε ο σειριακός αριθμός του μετρητή ή το μοναδικό αναγνωριστικό discovery·
• το πρώιμο firmware δημοσίευσε διαφορετική διαμόρφωση discovery·
• παραμένουν στον broker retained topics discovery από μια παλιά διαμόρφωση.

Επιλέξτε είτε το χειροκίνητο MQTT είτε το MQTT Discovery για τις ίδιες μετρήσεις και, στη συνέχεια, αφαιρέστε την ξεπερασμένη διαμόρφωση.

Αφαίρεση παλαιών retained οντοτήτων Discovery

Τα μηνύματα διαμόρφωσης MQTT Discovery διατηρούνται συνήθως (retained) από τον broker, ώστε το Home Assistant να μπορεί να αναδημιουργήσει τις οντότητες μετά από επανεκκίνηση. Αν παραμείνει ένα παλιό topic διαμόρφωσης, η διαγραφή της συσκευής μόνο από τη διεπαφή του Home Assistant μπορεί να μην αρκεί — η οντότητα μπορεί να επανέλθει όταν ληφθεί ξανά η retained διαμόρφωση.

Διαδικασία ασφαλούς καθαρισμού:

1. Απενεργοποιήστε την επιλογή HA MQTT Discovery στον μετρητή ή αποσυνδέστε τον προσωρινά, ώστε να μην αναδημοσιεύσει αμέσως την παλιά διαμόρφωση.
2. Χρησιμοποιήστε έναν πελάτη MQTT για να επιθεωρήσετε το πρόθεμα discovery του Home Assistant, συνήθως homeassistant/#.
3. Εντοπίστε μόνο τα topics διαμόρφωσης που ανήκουν στον επηρεαζόμενο σειριακό αριθμό/συσκευή IAMMETER.
4. Δημοσιεύστε ένα κενό retained payload σε κάθε ξεπερασμένο topic διαμόρφωσης.
5. Αφαιρέστε την ξεπερασμένη συσκευή/οντότητες από το Home Assistant, αν παραμένουν.
6. Ενεργοποιήστε ξανά το Discovery στο τρέχον firmware.
7. Επιβεβαιώστε ότι δημιουργείται μία συσκευή και οι αναμενόμενες τρέχουσες οντότητες.

Μην διαγράψετε ολόκληρο το δέντρο retained topics homeassistant/# σε έναν κοινόχρηστο broker. Αυτό θα μπορούσε να αφαιρέσει τη διαμόρφωση discovery για άσχετες συσκευές.

Πότε το χειροκίνητο MQTT είναι η καλύτερη επιλογή

Χρησιμοποιήστε αντί αυτού το χειροκίνητο MQTT όταν χρειάζεστε:

• προσαρμοσμένα ονόματα οντοτήτων και μοναδικά αναγνωριστικά·
• προσαρμοσμένα πρότυπα JSON ή υπολογισμούς·
• μόνο ένα επιλεγμένο υποσύνολο μετρήσεων·
• δομή topics κοινή με εφαρμογές εκτός Home Assistant·
• ρητό έλεγχο της κατηγορίας συσκευής και της κατηγορίας κατάστασης·
• συμβατότητα με ένα σύστημα όπου το Home Assistant Discovery είναι σκόπιμα απενεργοποιημένο.

Σχετικοί οδηγοί

• Χειροκίνητη διαμόρφωση μετρητή ενέργειας MQTT για Home Assistant
• Δημοσίευση δεδομένων IAMMETER σε broker MQTT
• Σύγκριση όλων των μεθόδων ενσωμάτωσης IAMMETER–Home Assistant
• Αναβάθμιση στο νεότερο firmware IAMMETER
• Τεκμηρίωση MQTT του Home Assistant

Ενημερώθηκε: 19 Ιουλίου 2026.