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 "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)	höchste Version	unterstützte Version(en)	Kommentar
NO_OPERATION	0x00	0	V1
BASIC	0x20	32	V2	V?
CONTROLLER_REPLICATION	0x21	33	V1	nein
APPLICATION_STATUS	0x22	34	V1	nein
ZIP_SERVICES	0x23	35	V2	nein
ZIP_SERVER	0x24	36	V1	nein	(SECURITY_PANEL_MODE ?)
SWITCH_BINARY	0x25	37	V2	V?
SWITCH_MULTILEVEL	0x26	38	V4	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	V1	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	(SECURITY_PANELZONE ?)
ZIP_ADV_SERVICES	0x2F	47	V1	nein	(Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
SENSOR_BINARY	0x30	48	V2	V?
SENSOR_MULTILEVEL	0x31	49	V8	V?
METER	0x32	50	V4	V1, V2, (V3)	V3 evtl. nicht vollständig
ZIP_ADV_SERVER / COLOR_CONTROL	0x33	51	V1	V?	(Z/IP Tunneling Server) (COLOR_CONTROL ?)
ZIP_ADV_CLIENT	0x34	52	V1		(Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION)
METER_PULSE	0x35	53	V1	nein
BASIC_TARIFF_INFO	0x36	54	V1	nein
HRV_STATUS	0x37	55	V1	V?
THERMOSTAT_HEATING	0x38	56	V1	nein
HRV_CONTROL	0x39	57	V1	V?
DCP_CONFIG	0x3a	58	V1	nein
DCP_MONITOR	0x3b	59	V1	nein
METER_TBL_CONFIG	0x3C	60	V1	nein
METER_TBL_MONITOR	0x3D	61	V2	nein
METER_TBL_PUSH	0x3E	62	V1	nein
THERMOSTAT_MODE	0x40	64	V3	V?
PREPAYMENT_ENCAPSULATION	0x41	67	V1	nein
THERMOSTAT_OPERATING_STATE	0x42	66	V2	nein
THERMOSTAT_SETPOINT	0x43	67	V3	V?
THERMOSTAT_FAN_MODE	0x44	68	V4	nein
THERMOSTAT_FAN_STATE	0x45	69	V2	nein
CLIMATE_CONTROL_SCHEDULE	0x46	70	V1	V?
THERMOSTAT_SETBACK	0x47	71	V1	nein
RATE_TBL_CONFIG	0x48	72	V1	nein
RATE_TBL_MONITOR	0x49	73	V1	nein
TARIFF_CONFIG	0x4a	74	V1	nein
TARIFF_TBL_MONITOR	0x4b	75	V1	nein
DOOR_LOCK_LOGGING	0x4C	76	V1	nein
NETWORK_MANAGEMENT_BASIC	0x4d	77	V1	nein
SCHEDULE_ENTRY_LOCK	0x4E	78	V3	nein
ZI_6LOWPAN	0x4F	79	V1	nein
BASIC_WINDOW_COVERING	0x50	80	V1	V?
MTP_WINDOW_COVERING	0x51	81	V1	nein	(MTP=Move to position)
NETWORK_MANAGEMENT_PROXY	0x52	82	V1	nein
NETWORK_SCHEDULE	0x53	83	V1	nein
NETWORK_MANAGEMENT_PRIMARY	0x54	84	V1	nein
TRANSPORT_SERVICE	0x55	85	V2	nein
CRC_16_ENCAP	0x56	86	V1	evtl.
APPLICATION_CAPABILITY	0x57	87	V1	nein
ZIP_ND	0x58	88	V1	nein
ASSOCIATION_GRP_INFO	0x59	89	V1	nein
DEVICE_RESET_LOCALLY	0x5a	90	V1	nein
CENTRAL_SCENE	0x5b	91	V2	nein
IP_ASSOCIATION	0x5c	92	V1	nein
ANTITHEFT	0x5d	93	V2	nein
ZWAVEPLUS_INFO	0x5e	94	V2	V1
ZIP_GATEWAY	0x5f	95	V1	nein
MULTI_CHANNEL	0x60	96	V3	V2
MULTI_INSTANCE	0x60	96	V1	V1	MULTI_INSTANCE wurde in MULTI_CHANNEL umbenannt
ZIP_PORTAL	0x61	97	V1	nein
DOOR_LOCK	0x62	98	V3	nein
USER_CODE	0x63	99	V1	V1
APPLIANCE / GARAGE_DOOR?	0x64	100	V1	nein
DMX	0x65	101	V1	nein
BARRIER_OPERATOR	0x66	102	V1	nein
CONFIGURATION	0x70	112	V2	V?
ALARM	0x71	113	V5	V?
MANUFACTURER_SPECIFIC	0x72	114	V2	V?
POWERLEVEL	0x73	115	V1	nein
PROTECTION	0x75	117	V2	V?
LOCK	0x76	118	V1	nein
NODE_NAMING	0x77	119	V1	nein
FIRMWARE_UPDATE_MD	0x7A	122	V4	nein
GROUPING_NAME	0x7B	123	V1	nein
REMOTE_ASSOCIATION_ACTIVATE	0x7C	124	V1	nein
REMOTE_ASSOCIATION	0x7D	125	V1	nein
BATTERY	0x80	128	V1	V?
CLOCK	0x81	129	V1	V?
HAIL	0x82	130	V1	V?
WAKE_UP	0x84	132	V2	V?
ASSOCIATION	0x85	133	V2	V?
VERSION	0x86	134	V2	V?
INDICATOR	0x87	135	V1	V?
PROPRIETARY	0x88	136	V1	nein
LANGUAGE	0x89	137	V1	nein
TIME	0x8A	138	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	V2	nein
SCREEN_ATTRIBUTES	0x93	147	V2	nein
SIMPLE_AV_CONTROL	0x94	148	V4	nein
AV_CONTENT_DIRECTORY_MD	0x95	149	V1	nein
AV_RENDERER_STATUS	0x96	150	V1	nein
AV_CONTENT_SEARCH_MD	0x97	151	V1	nein
SECURITY	0x98	152	V1	nein
AV_TAGGING_MD	0x99	153	V1	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.