Z-Wave Command Classes: Unterschied zwischen den Versionen

Aus FHEMWiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
K (Einige Klassen geändert, falsche Aussage im Text beseitigt)
Zeile 18: Zeile 18:
SWITCH_BINARY VERSION METER MANUFACTURER_SPECIFIC CONFIGURATION ASSOCIATION PROTECTION POWERLEVEL SENSOR_MULTILEVEL SWITCH_ALL
SWITCH_BINARY VERSION METER MANUFACTURER_SPECIFIC CONFIGURATION ASSOCIATION PROTECTION POWERLEVEL SENSOR_MULTILEVEL SWITCH_ALL


Dies ist jedoch von Hersteller zu Hersteller verschieden, in diesem Beispiel ist die Klasse "POWERLEVEL" z.B. für das Auslesen der Leistung zuständig, d.h. dieser Zwischenstecker kann auch die Leistung messen. Andere Steckdosenschalter ohne diese Funktion würden diese Klasse dementsprechend auch nicht unterstützen.
Dies ist jedoch von Hersteller zu Hersteller verschieden, in diesem Beispiel ist die Klasse "METER" z.B. für das Auslesen der Leistung zuständig, d.h. dieser Zwischenstecker kann z.B. auch die Leistung messen. Andere Steckdosenschalter ohne diese Funktion würden diese Klasse dementsprechend auch nicht unterstützen.


Aktuell sind mehr als 100 solcher Klassen definiert, hinzu kommt, dass diese Klassen in verschiedenen Versionen existieren. Die ständige Weiterentwicklung der Gerätefunktionen erfordert teilweise eine Erweiterung der jeweils betroffenen Command Classes, was sich in einer geänderten Definition der verwendeten Protokolle auswirkt. Im allgemeinen wird hier eine Abwärtskompatibilität eingehalten, sodass die Funktionen bis zu der unterstützten Version auch von Geräten mit höheren Versionen genutzt werden können.
Aktuell sind weit mehr als 100 solcher Klassen definiert, hinzu kommt, dass diese Klassen in verschiedenen Versionen existieren. Die ständige Weiterentwicklung der Gerätefunktionen erfordert teilweise eine Erweiterung der jeweils betroffenen Command Classes, was sich in einer geänderten Definition der verwendeten Protokolle auswirkt. Im allgemeinen wird hier eine Abwärtskompatibilität eingehalten, sodass die Funktionen bis zu der unterstützten Version auch von Geräten mit höheren Versionen genutzt werden können.


Den Command Classes ist jeweils eine eindeutige ID zugeordnet. Diese ID wird in der Kommunikation dazu genutzt die jeweilige Geräteklasse anzusprechen.
Den Command Classes ist jeweils eine eindeutige ID zugeordnet. Diese ID wird in der Kommunikation dazu genutzt die jeweilige Geräteklasse anzusprechen.
Zeile 32: Zeile 32:
  versionClass_32:02
  versionClass_32:02


erzeugt und es wird ein gleichnamiges Reading für das Gerät angelegt. In diesem Fall also die Version 2, meist nur als V2 angegeben. Hier werden die Werte als hexadezimale Zahl zurückgegeben, was nicht ganz konsequent mit den dezimalen Eingaben bei der Abfrage ist.
erzeugt und es wird ein gleichnamiges Reading für das Gerät angelegt. In diesem Fall also die Version 2, meist nur als V2 angegeben. Hier werden die Werte als hexadezimale Zahl zurückgegeben, was nicht ganz konsistent zu den dezimalen Eingaben bei der Abfrage ist.


Um herauszufinden ob ein Gerät prinzipiell von fhem unterstützt wird, werden daher die Informationen zu den Command Classes bzw. deren Versionen benötigt:
Um herauszufinden ob ein Gerät prinzipiell von fhem unterstützt wird, werden daher die Informationen zu den Command Classes bzw. deren Versionen benötigt:
Zeile 44: Zeile 44:
Für die letzten beiden Punkte soll dieser Artikel die nötigen Informationen bereitstellen.
Für die letzten beiden Punkte soll dieser Artikel die nötigen Informationen bereitstellen.


Sollte zumindest die Liste der Command Classes des Gerätes in fhem als unterstützt gekennzeichnet sein, so wird das Gerät höchstwahrscheinlich unterstützt werden, eine Garantie ist es jedoch nicht. Falls die Versionen der Command Classes unterschiedlich ist, so wird wahrscheinlich nur ein begrenzter Funktionsumfang dieser Klasse nutzbar sein.
Sollte zumindest die Liste der Command Classes des Gerätes in fhem als unterstützt gekennzeichnet sein, so wird das Gerät höchstwahrscheinlich unterstützt werden, eine Garantie ist es jedoch nicht. Falls die Versionen der Command Classes unterschiedlich ist, so wird eventuell nur ein begrenzter Funktionsumfang dieser Klasse nutzbar sein. Es ist jedoch auch möglich das ein Gerät zwar eine höhere Version einer Command Class untertützt, trotzdem aber keine der in dieser Version neuen Funktion nutzt.


Fehlt die Unterstützung für eine Klasse jedoch ganz, kann dies für die Funktion des Geräte von entscheidender Bedeutung sein und die Nutzung unter fhem dadurch aktuell nicht möglich sein. Da aber auch fhem ständig weiterentwickelt wird, kann sich dies schnell ändern.
Fehlt die Unterstützung für eine Klasse jedoch ganz, kann dies für die Funktion des Geräte von entscheidender Bedeutung sein und die Nutzung unter fhem dadurch aktuell nicht möglich sein. Da aber auch fhem ständig weiterentwickelt wird, kann sich dies schnell ändern.


Hierzu ist es natürlich hielfreich sich im Forum von fhem mal mit einer entsprechenden Frage zu melden.
In fhem sind die für die Hausautomatisierung wichtigsten Klassen meist soweit implementiert, wie es für den Betrieb nötig ist. Sollten Geräte mit neuen Funktionen "auftauchen", so kann entweder anhand vorhandener Informationen zu den jeweiligen Command Classes oder aber durch "Trial and Error" versucht werden diese Funktion zu implementieren.
 
Hierzu ist es natürlich hielfreich sich im Forum von fhem mal mit einer entsprechenden Frage zu melden.  


=== Liste von bekannten Command Classes und deren Unterstützung in fhem ===
=== Liste von bekannten Command Classes und deren Unterstützung in fhem ===


{| class="wikitable sortable"
{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | Versionen !! unterstützte Versionen !! Kommentar
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | Versionen !! unterstützte <br>Versionen !! Kommentar
|-
|-


| NO_OPERATION
| NO_OPERATION
| 0x00
| 0x00  
| 0
| 0  
| V1
| V1
|  
|  
Zeile 201: Zeile 203:
| V1
| V1
| V?
| V?
| (Z/IP Tunneling Server) (in fhem als COLOR_CONTROL genutzt?)
| (Z/IP Tunneling Server) <br>(in fhem als COLOR_CONTROL genutzt?)
|-
|-
| ZIP_ADV_CLIENT
| ZIP_ADV_CLIENT
Zeile 438: Zeile 440:
| 86
| 86
| V?
| V?
| eventuell? (Hinweis auf code vorhanden)
| evtl.
|  
|  
|-
|-
Zeile 493: Zeile 495:
| 0x5e
| 0x5e
| 94
| 94
| V?
| V1, V2
| V?
| V1
|  
|  
|-
|-
Zeile 509: Zeile 511:
| V2
| V2
| V2
| V2
| (V1 -> MULTI_INSTANCE)
|  
|-
|-
| MULTI_INSTANCE
| MULTI_INSTANCE
Zeile 515: Zeile 517:
| 96
| 96
| V1
| V1
| V?
| V1
|  
| MULTI_INSTANCE wurde in <br>MULTI_CHANNEL umbenannt
|-
|-
| DOOR_LOCK
| DOOR_LOCK
Zeile 710: Zeile 712:
| 0x8E
| 0x8E
| 142
| 142
| V1
| V2
| V?
| V?
| (MULTI_CHANNEL <-> MULTI_INSTANCE)
|  
|-
|-
| MULTI_INSTANCE_ASSOCIATION
| MULTI_INSTANCE_ASSOCIATION
Zeile 719: Zeile 721:
| V1
| V1
| V?
| V?
| (MULTI_CHANNEL <-> MULTI_INSTANCE)
| MULTI_INSTANCE wurde in <br>MULTI_CHANNEL umbenannt
|-
|-
| MULTI_CMD
| MULTI_CMD
Zeile 725: Zeile 727:
| 143
| 143
| V1
| V1
| eventuell (Hinweise im Code)
| evtl.
|  
|  
|-
|-
Zeile 739: Zeile 741:
| 145
| 145
| V1
| V1
| eventuell (Hinweise im Code)
| V1
|  
|  
|-
|-
Zeile 852: Zeile 854:
  HRV Status V1
  HRV Status V1
  HRV Control V1
  HRV Control V1
Multi Instance Command V1
Multi Channel V2 (evtl. Multi Instance)
  Remote Association Configuration V1
  Remote Association Configuration V1
  Thermostat setback V1 (evtl. Thermostat setpoint)
  Thermostat setback V1 (evtl. Thermostat setpoint)
Die Klasse MULTI_INSTANCE wurde in der Version V2 in MULTI_CHANNEL umbenannt.





Version vom 22. Mai 2015, 21:54 Uhr


Clock - Under Construction.svg An dieser Seite wird momentan noch gearbeitet.


Z-Wave Command Classes sind Klassen von Befehlen oder Protokollen, die zur Kommunikation und Steuerung der Z-Wave-Geräte dienen.

Auf dieser Seite werden einige Grundlagen zu diesen Command Classes von Z-Wave, sowie deren Implementierung in fhem beschrieben.

Allgeine Grundlagen zu Z-Wave finden sich in dem Hauptartikel hier.

Command Classes

Einleitung

Die Dokumentation der Z-Wave Command Classes ist leider nicht offen gelegt, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder teilweise auch falsch sind. Dieser Artikel erhebt daher auch keinen Anspruch auf Vollständigkeit, Aktualität oder Richtigkeit. Er soll vielmehr dazu dienen die bekannten Command Classes aufzulisten, sowie einen Hinweis auf deren Unterstützung in fhem geben.

Allgemeines

Die Kommunikation zwischen den Z-Wave Nodes erfolgt über festgelegte Protokolle, welche jeweils in den Command Classes festgelegt sind. Für jede Gerätefunktion gibt es eine Command Class, ein Gerät hat jedoch im Allgemeinen mehrere Funktionen und damit auch mehrere Command Classes.

Wie im Z-Wave Basisartikel beschrieben ist, ist die minimale Anforderung an ein Geräte die Unterstützung der Command Class "CLASS_BASIC".

Eine schaltbare Zwischensteckdose unterstützt z.B. die folgenden Command Classes: SWITCH_BINARY VERSION METER MANUFACTURER_SPECIFIC CONFIGURATION ASSOCIATION PROTECTION POWERLEVEL SENSOR_MULTILEVEL SWITCH_ALL

Dies ist jedoch von Hersteller zu Hersteller verschieden, in diesem Beispiel ist die Klasse "METER" z.B. für das Auslesen der Leistung zuständig, d.h. dieser Zwischenstecker kann z.B. auch die Leistung messen. Andere Steckdosenschalter ohne diese Funktion würden diese Klasse dementsprechend auch nicht unterstützen.

Aktuell sind weit mehr als 100 solcher Klassen definiert, hinzu kommt, dass diese Klassen in verschiedenen Versionen existieren. Die ständige Weiterentwicklung der Gerätefunktionen erfordert teilweise eine Erweiterung der jeweils betroffenen Command Classes, was sich in einer geänderten Definition der verwendeten Protokolle auswirkt. Im allgemeinen wird hier eine Abwärtskompatibilität eingehalten, sodass die Funktionen bis zu der unterstützten Version auch von Geräten mit höheren Versionen genutzt werden können.

Den Command Classes ist jeweils eine eindeutige ID zugeordnet. Diese ID wird in der Kommunikation dazu genutzt die jeweilige Geräteklasse anzusprechen.

Der COMMAND_CLASS_METER ist beispielsweise die ID 0x32 (hexadezimal) bzw. 50 (dezimal) zugeordnet. Um die unterstützte Version einer Klasse abzufragen wird die COMMAND_CLASS_VERSION genutzt. In fhem wird die Version der Klasse des Gerätes durch den Befehl:

get <devicename> versionClass <ID>

abgefragt, die <ID> ist hier dezimal anzugeben. Als Ausgabe wird von fhem dann z.B.:

versionClass_32:02

erzeugt und es wird ein gleichnamiges Reading für das Gerät angelegt. In diesem Fall also die Version 2, meist nur als V2 angegeben. Hier werden die Werte als hexadezimale Zahl zurückgegeben, was nicht ganz konsistent zu den dezimalen Eingaben bei der Abfrage ist.

Um herauszufinden ob ein Gerät prinzipiell von fhem unterstützt wird, werden daher die Informationen zu den Command Classes bzw. deren Versionen benötigt:

  • Liste der vom Gerät unterstützten Command Classes
    • Informationen zu den Versionen der Command Class
  • Liste der von fhem unterstützten Command Classes
    • Informationen zu den von fhem unterstützten Versionen der Command Class

(Grundlegende) Informationen zu den ersten beiden Punkten finden sich relativ häufig bereits in der Anleitung der Geräte, evtl. hilft auch eine Suche im Internet mit der Gerätebezeichnung und dem Stichwort "COMMAND CLASS".

Für die letzten beiden Punkte soll dieser Artikel die nötigen Informationen bereitstellen.

Sollte zumindest die Liste der Command Classes des Gerätes in fhem als unterstützt gekennzeichnet sein, so wird das Gerät höchstwahrscheinlich unterstützt werden, eine Garantie ist es jedoch nicht. Falls die Versionen der Command Classes unterschiedlich ist, so wird eventuell nur ein begrenzter Funktionsumfang dieser Klasse nutzbar sein. Es ist jedoch auch möglich das ein Gerät zwar eine höhere Version einer Command Class untertützt, trotzdem aber keine der in dieser Version neuen Funktion nutzt.

Fehlt die Unterstützung für eine Klasse jedoch ganz, kann dies für die Funktion des Geräte von entscheidender Bedeutung sein und die Nutzung unter fhem dadurch aktuell nicht möglich sein. Da aber auch fhem ständig weiterentwickelt wird, kann sich dies schnell ändern.

In fhem sind die für die Hausautomatisierung wichtigsten Klassen meist soweit implementiert, wie es für den Betrieb nötig ist. Sollten Geräte mit neuen Funktionen "auftauchen", so kann entweder anhand vorhandener Informationen zu den jeweiligen Command Classes oder aber durch "Trial and Error" versucht werden diese Funktion zu implementieren.

Hierzu ist es natürlich hielfreich sich im Forum von fhem mal mit einer entsprechenden Frage zu melden.

Liste von bekannten Command Classes und deren Unterstützung in fhem

Commande Class Name ID (hex) ID (dezimal) Versionen unterstützte
Versionen
Kommentar
NO_OPERATION 0x00 0 V1
BASIC 0x20 32 V1 V?
CONTROLLER_REPLICATION 0x21 33 V1 nein
APPLICATION_STATUS 0x22 34 V1 nein
ZIP_SERVICES 0x23 35 V1 nein
ZIP_SERVER 0x24 36 V1 nein
SWITCH_BINARY 0x25 37 V1 V?
SWITCH_MULTILEVEL 0x26 38 V1, V2 ,V3 V?
SWITCH_ALL 0x27 39 V1 V?
SWITCH_TOGGLE_BINARY 0x28 40 V1 nein
SWITCH_TOGGLE_MULTILEVEL 0x29 41 V1 nein
CHIMNEY_FAN 0x2A 42 nein
SCENE_ACTIVATION 0x2B 43 V1 V?
SCENE_ACTUATOR_CONF 0x2C 44 V1 V?
SCENE_CONTROLLER_CONF 0x2D 45 V1 V?
ZIP_CLIENT 0x2E 46 V1 nein
ZIP_ADV_SERVICES 0x2F 47 V1 nein (Z/IP Tunneling Services)
SENSOR_BINARY 0x30 48 V1 V?
SENSOR_MULTILEVEL 0x31 49 V1, V2, V3 V?
METER 0x32 50 V1, V2, V3 V1, V2, (V3) V3 evtl. nicht vollständig
ZIP_ADV_SERVER / COLOR_CONTROL 0x33 51 V1 V? (Z/IP Tunneling Server)
(in fhem als COLOR_CONTROL genutzt?)
ZIP_ADV_CLIENT 0x34 52 V1 (Z/IP Tunneling Client)
METER_PULSE 0x35 53 V1 nein
BASIC_TARIFF_INFO 0x36 54 V? nein
HRV_STATUS 0x37 55 V? V?
THERMOSTAT_HEATING 0x38 56 V? nein
HRV_CONTROL 0x39 57 V? V?
DCP_CONFIG 0x3a 58 V? nein
DCP_MONITOR 0x3b 59 V? nein
METER_TBL_CONFIG 0x3C 60 V? nein
METER_TBL_MONITOR 0x3D 61 V? nein
METER_TBL_PUSH 0x3E 62 V? nein
THERMOSTAT_MODE 0x40 64 V1, V2 V?
PREPAYMENT_ENCAPSULATION 0x41 67 V? nein
THERMOSTAT_OPERATING_STATE 0x42 66 V1 nein
THERMOSTAT_SETPOINT 0x43 67 V1, V2 V?
THERMOSTAT_FAN_MODE 0x44 68 V1 nein
THERMOSTAT_FAN_STATE 0x45 69 V1 nein
CLIMATE_CONTROL_SCHEDULE 0x46 70 V1 V?
THERMOSTAT_SETBACK 0x47 71 V? nein
RATE_TBL_CONFIG 0x48 72 V? nein
RATE_TBL_MONITOR 0x49 73 V? nein
TARIFF_CONFIG 0x4a 74 V? nein
TARIFF_TBL_MONITOR 0x4b 75 V? nein
DOOR_LOCK_LOGGING 0x4C 76 V? nein
NETWORK_MANAGEMENT_BASIC 0x4d 77 V? nein
SCHEDULE_ENTRY_LOCK 0x4E 78 V? nein
ZI_6LOWPAN 0x4F 79 V? nein
BASIC_WINDOW_COVERING 0x50 80 V1 V?
MTP_WINDOW_COVERING 0x51 81 V1 nein (MTP=Move to position)
NETWORK_MANAGEMENT_PROXY 0x52 82 V? nein
NETWORK_SCHEDULE 0x53 83 V? nein
NETWORK_MANAGEMENT_PRIMARY 0x54 84 V? nein
TRANSPORT_SERVICE 0x55 85 V? nein
CRC_16_ENCAP 0x56 86 V? evtl.
APPLICATION_CAPABILITY 0x57 87 V? nein
ZIP_ND 0x58 88 V? nein
ASSOCIATION_GRP_INFO 0x59 89 V? nein
DEVICE_RESET_LOCALLY 0x5a 90 V? nein
CENTRAL_SCENE 0x5b 91 V? nein
IP_ASSOCIATION 0x5c 92 V? nein
ANTITHEFT 0x5d 93 V? nein
ZWAVEPLUS_INFO 0x5e 94 V1, V2 V1
ZIP_GATEWAY 0x5f 95 V? nein
MULTI_CHANNEL 0x60 96 V2 V2
MULTI_INSTANCE 0x60 96 V1 V1 MULTI_INSTANCE wurde in
MULTI_CHANNEL umbenannt
DOOR_LOCK 0x62 98 V1 nein
USER_CODE 0x63 99 V1 V1
BARRIER_OPERATOR 0x66 102 V? nein
CONFIGURATION 0x70 112 V1, V2 V?
ALARM 0x71 113 V1 V?
MANUFACTURER_SPECIFIC 0x72 114 V1 V?
POWERLEVEL 0x73 115 V1 nein
PROTECTION 0x75 117 V1, V2 V?
LOCK 0x76 118 V1 nein
NODE_NAMING 0x77 119 V1 nein
FIRMWARE_UPDATE_MD 0x7A 122 V1, V2 nein
GROUPING_NAME 0x7B 123 V1 nein
REMOTE_ASSOCIATION_ACTIVATE 0x7C 124 V1 nein
REMOTE_ASSOCIATION 0x7D 125 V? nein
BATTERY 0x80 128 V1 V?
CLOCK 0x81 129 V1 V?
HAIL 0x82 130 V1 V?
WAKE_UP 0x84 132 V1, V2 V?
ASSOCIATION 0x85 133 V1, V2 V?
VERSION 0x86 134 V1 V?
INDICATOR 0x87 135 V1 V?
PROPRIETARY 0x88 136 V1 nein
LANGUAGE 0x89 137 V1 nein
TIME 0x8A 138 V1, V2 nein
TIME_PARAMETERS 0x8B 139 V1 nein
GEOGRAPHIC_LOCATION 0x8C 140 V1 nein
COMPOSITE 0x8D 141 V? nein
MULTI_CHANNEL_ASSOCIATION 0x8E 142 V2 V?
MULTI_INSTANCE_ASSOCIATION 0x8E 142 V1 V? MULTI_INSTANCE wurde in
MULTI_CHANNEL umbenannt
MULTI_CMD 0x8F 143 V1 evtl.
ENERGY_PRODUCTION 0x90 144 V1 nein
MANUFACTURER_PROPRIETARY 0x91 145 V1 V1
SCREEN_MD 0x92 146 V1, V2 nein
SCREEN_ATTRIBUTES 0x93 147 V1, V2 nein
SIMPLE_AV_CONTROL 0x94 148 V1 nein
AV_CONTENT_DIRECTORY_MD 0x95 149 V? nein
AV_RENDERER_STATUS 0x96 150 V? nein
AV_CONTENT_SEARCH_MD 0x97 151 V? nein
SECURITY 0x98 152 V1 nein
AV_TAGGING_MD 0x99 153 V? nein
IP_CONFIGURATION 0x9A 154 V1 nein
ASSOCIATION_COMMAND_CONFIGURATION 0x9B 155 V1 nein
SENSOR_ALARM 0x9C 156 V1 V?
SILENCE_ALARM 0x9D 157 V1 nein
SENSOR_CONFIGURATION 0x9E 158 V1 nein
MARK 0xEF 239 V? nein
NON_INTEROPERABLE 0xF0 240 V? nein

Es gibt noch ein paar Einträge die nicht eindeutig der obigen Liste zugeordnet werden können, da keine ID bekannt ist:

HRV Status V1
HRV Control V1
Remote Association Configuration V1
Thermostat setback V1 (evtl. Thermostat setpoint)

Die Klasse MULTI_INSTANCE wurde in der Version V2 in MULTI_CHANNEL umbenannt.


Beispiel für eine Command Class und deren Implementierung in fhem

Quellen und Links