Z-Wave Command Classes: Unterschied zwischen den Versionen

Version vom 22. Mai 2015, 17:45 Uhr

	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 "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.

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.

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 konsequent mit 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 wahrscheinlich nur ein begrenzter Funktionsumfang dieser Klasse nutzbar sein.

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.

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

Commande Class Name	ID (hex)	ID (dezimal)	Versionen	Kommentar
NO_OPERATION	0x00	0	V1
BASIC	0x20	32	V1
CONTROLLER_REPLICATION	0x21	33	V1
APPLICATION_STATUS	0x22	34	V1
ZIP_SERVICES	0x23	35	V1
ZIP_SERVER	0x24	36	V1
SWITCH_BINARY	0x25	37	V1
SWITCH_MULTILEVEL	0x26	38	V1, V2 ,V3
SWITCH_ALL	0x27	39	V1
SWITCH_TOGGLE_BINARY	0x28	40	V1
SWITCH_TOGGLE_MULTILEVEL	0x29	41	V1
CHIMNEY_FAN	0x2A	42
SCENE_ACTIVATION	0x2B	43	V1
SCENE_ACTUATOR_CONF	0x2C	44	V1
SCENE_CONTROLLER_CONF	0x2D	45	V1
ZIP_CLIENT	0x2E	46	V1
ZIP_ADV_SERVICES	0x2F	47	V1	(Z/IP Tunneling Services)
SENSOR_BINARY	0x30	48	V1
SENSOR_MULTILEVEL	0x31	49	V1, V2, V3
METER	0x32	50	V1, V2, V3
ZIP_ADV_SERVER	0x33	51	V1	(Z/IP Tunneling Server)
ZIP_ADV_CLIENT	0x34	52	V1	(Z/IP Tunneling Client)
METER_PULSE	0x35	53	V1
METER_TBL_CONFIG	0x3C	60
METER_TBL_MONITOR	0x3D	61
METER_TBL_PUSH	0x3E	62
THERMOSTAT_HEATING	0x38	56
THERMOSTAT_MODE	0x40	64	V1, V2
THERMOSTAT_OPERATING_STATE	0x42	66	V1
THERMOSTAT_SETPOINT	0x43	67	V1, V2
THERMOSTAT_FAN_MODE	0x44	68	V1
THERMOSTAT_FAN_STATE	0x45	69	V1
CLIMATE_CONTROL_SCHEDULE	0x46	70	V1
THERMOSTAT_SETBACK	0x47	71
DOOR_LOCK_LOGGING	0x4C	76
SCHEDULE_ENTRY_LOCK	0x4E	78
BASIC_WINDOW_COVERING	0x50	80	V1
MTP_WINDOW_COVERING	0x51	81	V1	(MTP=Move to position)
MULTI_CHANNEL	0x60	96	V2
MULTI_INSTANCE	0x60	96	V1
DOOR_LOCK	0x62	98	V1
USER_CODE	0x63	99	V1
BARRIER_OPERATOR	0x66	102
CONFIGURATION	0x70	112	V1, V2
ALARM	0x71	113	V1
MANUFACTURER_SPECIFIC	0x72	114	V1
POWERLEVEL	0x73	115	V1
PROTECTION	0x75	117	V1, V2
LOCK	0x76	118	V1
NODE_NAMING	0x77	119	V1
FIRMWARE_UPDATE_MD	0x7A	122	V1, V2
GROUPING_NAME	0x7B	123	V1
REMOTE_ASSOCIATION_ACTIVATE	0x7C	124	V1
REMOTE_ASSOCIATION	0x7D	125
BATTERY	0x80	128	V1
CLOCK	0x81	129	V1
HAIL	0x82	130	V1
WAKE_UP	0x84	132	V1, V2
ASSOCIATION	0x85	133	V1, V2
VERSION	0x86	134	V1
INDICATOR	0x87	135	V1
PROPRIETARY	0x88	136	V1
LANGUAGE	0x89	137	V1
TIME	0x8A	138	V1, V2
TIME_PARAMETERS	0x8B	139	V1
GEOGRAPHIC_LOCATION	0x8C	140	V1
COMPOSITE	0x8D	141
MULTI_CHANNEL_ASSOCIATION	0x8E	142	V1
MULTI_INSTANCE_ASSOCIATION	0x8E	142	V1
MULTI_CMD	0x8F	143	V1
ENERGY_PRODUCTION	0x90	144	V1
MANUFACTURER_PROPRIETARY	0x91	145	V1
SCREEN_MD	0x92	146	V1, V2
SCREEN_ATTRIBUTES	0x93	147	V1, V2
SIMPLE_AV_CONTROL	0x94	148	V1
AV_CONTENT_DIRECTORY_MD	0x95	149
AV_RENDERER_STATUS	0x96	150
AV_CONTENT_SEARCH_MD	0x97	151
SECURITY	0x98	152	V1
AV_TAGGING_MD	0x99	153
IP_CONFIGURATION	0x9A	154	V1
ASSOCIATION_COMMAND_CONFIGURATION	0x9B	155	V1
SENSOR_ALARM	0x9C	156	V1
SILENCE_ALARM	0x9D	157	V1
SENSOR_CONFIGURATION	0x9E	158	V1
MARK	0xEF	239
NON_INTEROPERABLE	0xF0	240

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
Multi Instance Command V1
Multi Channel V2 (evtl. Multi Instance)
Remote Association Configuration V1
Thermostat setback V1 (evtl. Thermostat setpoint)

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

Quellen und Links