Embedded Files
Smart-me Zähler in Loxone verwenden
Smart-me Zähler in Loxone verwenden
Einbindung über Modbus
Einbindung über Modbus
Modbus TCP muss auf dem Zähler aktiviert werden. Die IP des Zählers muss im Template eingetragen werden.
Einbindung über API - Basic Auth (Veraltet)
Einbindung über API - Basic Auth (Veraltet)
Nur noch bis November 2026 möglich (bis v.1.0.2)
Im Template muss vor dem URL des API Calls der Benutzername und das Passwort des Kontos stehen. Der Benutzername muss je nach dem von smart-me gesetzt werden.
Einbindung über API - API-Keys (Empfohlen)
Einbindung über API - API-Keys (Empfohlen)
ab Version 1.0.3, ist ab 28.07.2025 verfügbar.
Im Smart-me Portal ein API Key erstellen.
Im Smart-me Portal ein API Key erstellen.
Im Smart-me Portal im linken Menu unter Schnittstellen auf API klicken.
Im orangen Banner auf den Link für die API Keys klicken.
Auf "Neu erstellen" klicken.
Den API Key benennen, z.B. Loxone, das Ablaufdatum und die Berechtigungen setzen. Für Loxone reicht "device.readswitch"
Weitere Infos zu den Berechtigungen: API
Auf "Erstellen" klicken und den API Key kopieren.
Achtung: Der Key kann danach nicht wieder abgerufen werden.
DeviceID des smart-me Zählers holen
DeviceID des smart-me Zählers holen
Wenn das Konto auf Professional ist, kann die DeviceID bei der Systemgesundheit geholt werden.
Wenn das Konto nicht auf Professional ist, muss die DeviceID über die API geholt werden.
1. Windowstaste drücken und "cmd" eingeben.
2. Die Eingabeaufforderung öffnen
3. Folgenden Befehl in die Eingabe kopieren.
curl -X "GET" "https://api.smart-me.com/Devices" -H "accept: */*" -H "Authorization: ApiKey n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu"
Achtung: Den ApiKey anpassen.
In der Antwort nach dem Zählernamen suchen und die Id rauskopieren.
Im Loxone den virtuellen Ausgang konfigurieren
Im Loxone den virtuellen Ausgang konfigurieren
Das template aus der Loxone Library herunterladen (VO_XXXX).
Unter "Vordefinierte Geräte" den smart-me Request laden.Ein neuer virtueller Ausgang erscheint, dort auf den Befehl "Meter" klicken.
Im Feld "Befehl bei EIN" muss die DeviceID eingepflegt werden bsp: /Devices/61c71d00-3d40-4963-745b2-7c6b0c512gf3
Im Feld "HTTP header bei EIN" den API Key einpflegen bsp: Authorization: ApiKey n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu
Im Feld "HTTP-Antwort speichern" die HTML Datei umbenennen.
Der Name muss für jeden Ausgang (bzw. Zähler) individuell sein.
Wir empfehlen:
user/common/smartme_WohnungEG.html ODER
user/common/smartme_SN638595.html ODER
user/common/smartme_61c71d00-3d40-4963-745b2-7c6b0c512gf3.html
Im Loxone den virtuellen Eingang konfigurieren
Im Loxone den virtuellen Eingang konfigurieren
Das template aus der Loxone Library herunterladen (VI_XXXX).
Unter "Vordefinierte HTTP-Geräte" den smart-me meter laden.Ein neuer virtueller Eingang erscheint, dort auf den Eingang "smart-me meter" klicken.
Beim Feld "URL" muss die IP, Zugangsdaten des Loxone Miniservers und der Name des HTML Files hinterlegt werden.
https://admin:sicheres_admin_passwort@127.0.0.1/smartme_61c71d00-3d40-4963-745b2-7c6b0c512gf3.html
Hintergrund: Der virtuelle Eingang von Loxone bietet keine Möglichkeit den HTTP Request Header anzupassen, der Ausgang hingegen schon. Dadurch muss dieser so angepasst werden, dass die Antwort des Requests auf dem MiniServer gespeichert wird und mit dem virtuellen Eingang ausgelesen wird.
Wenn nicht das smart-me Template verwendet wird, muss der "Virtuelle Ausgang Befehl" mittels Impulsgenerator angesteuert werden.
Loxone Zähler in Smart-me verwenden
Loxone Zähler in Smart-me verwenden
API Key im Smart-me Portal erstellen mit den Claims: device.readwrite und user.readwrite
Folgenden call ausführen (Felder davor editieren (ApiKey & Name))
Mit Power-Shell:
curl -i -X 'POST' 'https://api.smart-me.com/Devices' -H 'accept: text/plain' -H 'Authorization: ApiKey <apikey>' -H 'Content-Type: application/json-patch+json' -d '{"activePower": 0, "counterReading": 0, "counterReadingExport": 0, "valueDate": "2025-07-08T08:15:55.026Z", "name": "Loxone Beispiel", "deviceEnergyType": 1}'
Mit Windows CMD (DOS):
curl -i -X POST "https://api.smart-me.com/Devices" -H "accept: text/plain" -H "Authorization: ApiKey <apikey> " -H "Content-Type: application/json" -d "{\"activePower\": 0, \"counterReading\": 0, \"counterReadingExport\": 0, \"valueDate\": \"2025-12-05T00:00:00.000Z\", \"name\": \"Loxone Beispiel\", \"deviceEnergyType\": 1}"Die UUID des Zählers aus dem Response nehmen.
Alternative 1: UUID aus Systemgesundheit im Dashboard holen
Alternative 2: https://api.smart-me.com/Devices GET verwenden um alle IDs zu erhalten.Diese Daten müssen in der Loxone Library eingetragen werden.
Zusammengefasst wurde so ein virtueller Zähler erstellt, welcher dann in Loxone verwendet werden kann.
Page updated
Report abuse