Z-Wave Command Classes

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	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?	eventuell? (Hinweis auf code vorhanden)
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	V?	V?
ZIP_GATEWAY	0x5f	95	V?	nein
MULTI_CHANNEL	0x60	96	V2	V2	(V1 -> MULTI_INSTANCE)
MULTI_INSTANCE	0x60	96	V1	V?
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	V1	V?	(MULTI_CHANNEL <-> MULTI_INSTANCE)
MULTI_INSTANCE_ASSOCIATION	0x8E	142	V1	V?	(MULTI_CHANNEL <-> MULTI_INSTANCE)
MULTI_CMD	0x8F	143	V1	eventuell (Hinweise im Code)
ENERGY_PRODUCTION	0x90	144	V1	nein
MANUFACTURER_PROPRIETARY	0x91	145	V1	eventuell (Hinweise im Code)
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
Multi Instance Command V1
Multi Channel V2 (evtl. Multi Instance)
Remote Association Configuration V1
Thermostat setback V1 (evtl. Thermostat setpoint)