FHEMWiki - Benutzerbeiträge [de]

HMUARTLGW

2017-02-13T20:49:27Z

A.Harrenberg: Einfügen der Standardinformationen aus dem ersten Post des Entwicklungsthreads für dieses Modul

{{Infobox Modul
|ModPurpose=Unterstützung des HomeMatic Funk-LAN Gateways und des Funkmoduls für Raspberry Pi
|ModType=d
|ModForumArea=HomeMatic
|ModFTopic=54511
|ModTechName=00_HMUARTLGW.pm
|ModOwner={{Link2FU|1379|mgernoth}}
}}
Das Modul [[HMUARTLGW]] ermöglicht die Nutzung der [[HomeMatic]] [[Interface|Interfaces]]
* [[HM-LGW-O-TW-W-EU Funk-LAN Gateway]] und
* [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi]]
in FHEM. Das Modul ist seit dem 19.7.2016 über den [[update|Update]]-Mechanismus verfügbar.

== Voraussetzungen ==
Eine der beiden genannten Hardware-Komponenten muss installiert sein.

== Anwendung ==
{{Randnotiz|RNTyp=Info|RNText=Diese "Kurzanleitung" wurde dem ersten Post des unten verlinkten Forenthreads entnommen. Bitte den Inhalt dieses ersten Posts auf Updates prüfen, für weitergehende Informationen bitte den Thread verfolgen.}}
=== Define ===
Um das Modul in Fhem zu nutzen, wird ein neues Gerät definiert:

Bei einem UART-Modul auf einem Raspberry Pi (HM-MOD-RPI-PCB):
define myHmUART HMUARTLGW /dev/ttyAMA0

Für ein LAN Gateway mit einer IP 192.168.42.23 (Beispieladresse):
define myHmLGW HMUARTLGW 192.168.42.23

=== Attribute ===
Bei einem UART-Modul auf einem Raspberry Pi (HM-MOD-RPI-PCB) mit einer hmId von 424242 (Beispiel):
attr myHmUART hmId 424242

Für ein LAN Gateway mit einer hmId von 424242 (Beispiel) und einem Passwort für das LGW:
attr myHmLGW hmId 424242
attr myHmLGW lgwPw GeheimesGatewayPasswort

== Anwendungsbeispiele ==
( noch keine Beispiele vorhanden )

== Firmwareupdate ==
Die Verwendung einer Firmware >= 1.4.1 für die Rf-Interfaces wird dringend empfohlen, die Rf-Firmware kann direkt aus Fhem heraus aktualisiert werden:

HM-MOD-UART: [https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/HM-MOD-UART/coprocessor_update.eq3 coprocessor_update.eq3]

HM-LGW-O-TW-W-EU: [https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3 coprocessor_update_hm_only.eq3]

Das Update wird in FHEM mit "updateCoPro" angestossen:
set myHmUART updateCoPro /path/to/coprocessor_update.eq3
für den HMUART bzw.
set myHmLGW updateCoPro /path/to/coprocessor_update.eq3
für das HMLAN.

Zusätzlich sollte die LAN-Firmware des HM-LGW-O-TW-W-EU auf mindestens Version 1.1.5 aktualisiert werden: [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 hm-lgw-o-tw-w-eu_update.eq3]. Dies kann entweder mit dem [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, betriebssystemübergeifend) oder den [http://www.fhemwiki.de/wiki/HM-LGW-O-TW-W-EU_Funk-LAN_Gateway#Vorbereitung_des_LAN-Firmwareupdates_mit_den_eQ-3_Tools eQ-3 Tools] (x86/arm, Linux) erfolgen.

== Aktivierung der seriellen Schnittstelle auf RPi1/2/3 unter Jessie ==
UART muss in der /boot/config.txt aktiviert sein:
enable_uart=1
Die serielle Schnittstelle darf in der /boot/cmdline.txt nicht referenziert werden (console=...)
dwc_otg.lpm_enable=0 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait
Das Getty auf der seriellen Schnittstelle muss deaktiviert werden
sudo systemctl stop serial-getty@ttyAMA0.service
sudo systemctl disable serial-getty@ttyAMA0.service
Der Fhem-Benutzer muss in die dialout-Gruppe aufgenommen werden, damit er auf das serielle Gerät zugreifen darf.

Notwendige zusätzliche Schritte auf einem RPi3: [https://forum.fhem.de/index.php/topic,54511.msg462039.html#msg462039 Link zu Beitrag von betateilchen]

== Links ==
* Forenthread {{Link2Forum|Topic=54511|LinkText=HMUARTLGW: Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}

[[Kategorie:HomeMatic Components]]

Z-Wave Command Classes

2016-09-03T16:12:27Z

A.Harrenberg:

{{Randnotiz|RNTyp=Info|RNText=Dieser Artikel wurde vor Veröffentlichung der [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification] am 31.08.2016 erstellt. Die Informationen zu den Command Classes waren bis zu diesem Zeitpunkt nicht offengelegt, die Versionen/Namen der Klassen wurden anhand der nun verfügbaren Dokumentation angepasst (03-09.2016)}}
[[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. Allgemeine Grundlagen zu Z-Wave finden sich im [[Z-Wave|Z-Wave Hauptartikel]].

== Command Classes ==
=== Einleitung ===
Entstanden ist dieser Artikel da die Dokumentation der Z-Wave Command Classes zum damaligen Zeitpunkt leider (noch) nicht offengelegt waren, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder auch falsch waren. Am 31.08.2016 hat Sigma Designs die Dokumentationen der ZWave Command Classes freigegeben (siehe: [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]). Die Informationen auf dieser Seite wurden nach Erscheinen dieser offiziellen Dokumente angepasst, dieser Artikel erhebt dennoch 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 zu 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 die minimale Anforderung an ein Geräte die Unterstützung der Command Class "CLASS_BASIC". Diese "BASIC" Klasse wird von den Geräten nicht explizit in der Liste Ihrer unterstützten Klassen aufgeführt, laut Spezifikation soll jedes Gerät diese Klasse unterstützen bzw. mit Nachrichten dieser Klasse umgehen können.

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_50:2

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.

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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen, so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| ZWAVE_CMD_CLASS
| 0x01
| 1
| ?
| ?
| LowLevel-Funktionen, die von http://fhem.de/commandref#ZWCUL teilweise unterstützt werden
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
| Z-Wave for IP
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| SWITCH_TOGGLE_BINARY
| 0x28
| 40
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_BINARY [DEPRECATED]
|-
| SWITCH_TOGGLE_MULTILEVEL
| 0x29
| 41
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_MULTILEVEL [DEPRECATED]
|-
| CHIMNEY_FAN
| 0x2A
| 42
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SCENE_ACTIVATION
| 0x2B
| 43
| V1
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
| SENSOR_BINARY [DEPRECATED]
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V10
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| SWITCH_COLOR (COLOR_CONTROL)
| 0x33
| 51
| V3
| V1
|
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
|
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
| METER_PULSE [DEPRECATED]
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| PREPAYMENT
| 0x3F
| 63
| V1
| nein
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
| CLIMATE_CONTROL_SCHEDULE [DEPRECATED]
|-
| 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
| V1, V2, V3
| SCHEDULE_ENTRY_LOCK [DEPRECATED]
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V8
| nein
| ZIP_6LOWPAN (ITU-T G.9959 / IETF RFC 7428)
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
| BASIC_WINDOW_COVERING [OBSOLETED]
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| MTP_WINDOW_COVERING [OBSOLETED] (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| SCHEDULE (NETWORK_SCHEDULE)
| 0x53
| 83
| V3
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V3
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V3
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V4
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| HUMIDITY_CONTROL_SETPOINT (APPLIANCE)
| 0x64
| 100
| V1
| nein
|
|-
| DMX
| 0x65
| 101
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| NETWORK_MANAGEMENT_INSTALLATION_MAINTENANCE
| 0x67
| 103
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| ZIP_NAMING
| 0x68
| 104
| V1
| nein
|
|-
| MAILBOX
| 0x69
| 105
| V1
| nein
|
|-
| WINDOW_COVERING
| 0x6A
| 106
| V1
| nein
|
|-
| IRRIGATION
| 0x6B
| 107
| V1
| nein
|
|-
| SUPERVISION
| 0x6C
| 108
| V1
| nein
|
|-
| HUMIDITY_CONTROL_MODE
| 0x6D
| 109
| V1
| nein
|
|-
| HUMIDITY_CONTROL_OPERATING_STATE
| 0x6E
| 110
| V1
| nein
|
|-
| ENTRY_CONTROL
| 0x6F
| 111
| V1
| nein
|
|-
| CONFIGURATION
| 0x70
| 112
| V4
| V1
|
|-
| ALARM
| 0x71
| 113
| V8
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| FIRMWARE_UPDATE_MD
| 0x7A
| 122
| V5
| nein
|
|-
| GROUPING_NAME
| 0x7B
| 123
| V1
| nein
| GROUPING_NAME [DEPRECATED]
|-
| REMOTE_ASSOCIATION_ACTIVATE
| 0x7C
| 124
| V1
| nein
| REMOTE_ASSOCIATION_ACTIVATE [OBSOLETED]
|-
| REMOTE_ASSOCIATION
| 0x7D
| 125
| V1
| nein
| REMOTE_ASSOCIATION [OBSOLETED]
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
| HAIL [DEPRECATED]
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V2
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
| PROPRIETARY [DEPRECATED]
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_COMMAND (MULTI_CMD)
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_RENDERER_STATUS
| 0x96
| 150
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_CONTENT_SEARCH_MD
| 0x97
| 151
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SECURITY
| 0x98
| 152
| V1
| V1
| weitere Tests erforderlich
|-
| AV_TAGGING_MD
| 0x99
| 153
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| IP_CONFIGURATION
| 0x9A
| 154
| V1
| nein
| IP_CONFIGURATION [OBSOLETED]
|-
| ASSOCIATION_COMMAND_CONFIGURATION
| 0x9B
| 155
| V1
| nein
|
|-
| SENSOR_ALARM
| 0x9C
| 156
| V1
| V1
| SENSOR_ALARM [DEPRECATED]
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
| SENSOR_CONFIGURATION [OBSOLETED]
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| N/A
|
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| N/A
|
|
|-
| SECURITY_SCHEME0_MARK
| 0xF100
| 61696
| N/A
|
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in Fhem jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet, dass neuere Geräte, die laut der Produktbeschreibung NOTIFICATION unterstützen, dies in Fhem NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind. Als eine Besonderheit ist hier bereits 0xF100 für "SECURITY_SCHEME0_MARK" vergeben.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet bzw. nicht in der offiziellen Liste von Sigma Designs enthalten:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind, z.B.:
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-09-03T16:10:29Z

A.Harrenberg: Text an Veröffentlichung der Dokumente von Sigma Designs angepasst.

{{Randnotiz|RNTyp=Info|RNText=Dieser Artikel wurde vor Veröffentlichung der [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification] am 31.08.2016 erstellt. Die Informationen zu den Command Classes waren bis zu diesem Zeitpunkt nicht offengelegt, die Versionen/Namen der Klassen wurden anhand der nun verfügbaren Dokumentation angepasst (03-09.2016)}}
[[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. Allgemeine Grundlagen zu Z-Wave finden sich im [[Z-Wave|Z-Wave Hauptartikel]].

== Command Classes ==
=== Einleitung ===
Entstanden ist dieser Artikel da die Dokumentation der Z-Wave Command Classes zum damaligen Zeitpunkt leider (noch) nicht offengelegt waren, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder auch falsch waren. Am 31.08.2016 hat Sigma Designs die Dokumentationen der ZWave Command Classes freigegeben [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]. Die Informationen auf dieser Seite wurden nach Erscheinen dieser offiziellen Dokumente angepasst, dieser Artikel erhebt dennoch 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 zu 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 die minimale Anforderung an ein Geräte die Unterstützung der Command Class "CLASS_BASIC". Diese "BASIC" Klasse wird von den Geräten nicht explizit in der Liste Ihrer unterstützten Klassen aufgeführt, laut Spezifikation soll jedes Gerät diese Klasse unterstützen bzw. mit Nachrichten dieser Klasse umgehen können.

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_50:2

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.

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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen, so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| ZWAVE_CMD_CLASS
| 0x01
| 1
| ?
| ?
| LowLevel-Funktionen, die von http://fhem.de/commandref#ZWCUL teilweise unterstützt werden
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
| Z-Wave for IP
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| SWITCH_TOGGLE_BINARY
| 0x28
| 40
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_BINARY [DEPRECATED]
|-
| SWITCH_TOGGLE_MULTILEVEL
| 0x29
| 41
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_MULTILEVEL [DEPRECATED]
|-
| CHIMNEY_FAN
| 0x2A
| 42
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SCENE_ACTIVATION
| 0x2B
| 43
| V1
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
| SENSOR_BINARY [DEPRECATED]
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V10
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| SWITCH_COLOR (COLOR_CONTROL)
| 0x33
| 51
| V3
| V1
|
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
|
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
| METER_PULSE [DEPRECATED]
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| PREPAYMENT
| 0x3F
| 63
| V1
| nein
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
| CLIMATE_CONTROL_SCHEDULE [DEPRECATED]
|-
| 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
| V1, V2, V3
| SCHEDULE_ENTRY_LOCK [DEPRECATED]
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V8
| nein
| ZIP_6LOWPAN (ITU-T G.9959 / IETF RFC 7428)
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
| BASIC_WINDOW_COVERING [OBSOLETED]
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| MTP_WINDOW_COVERING [OBSOLETED] (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| SCHEDULE (NETWORK_SCHEDULE)
| 0x53
| 83
| V3
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V3
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V3
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V4
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| HUMIDITY_CONTROL_SETPOINT (APPLIANCE)
| 0x64
| 100
| V1
| nein
|
|-
| DMX
| 0x65
| 101
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| NETWORK_MANAGEMENT_INSTALLATION_MAINTENANCE
| 0x67
| 103
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| ZIP_NAMING
| 0x68
| 104
| V1
| nein
|
|-
| MAILBOX
| 0x69
| 105
| V1
| nein
|
|-
| WINDOW_COVERING
| 0x6A
| 106
| V1
| nein
|
|-
| IRRIGATION
| 0x6B
| 107
| V1
| nein
|
|-
| SUPERVISION
| 0x6C
| 108
| V1
| nein
|
|-
| HUMIDITY_CONTROL_MODE
| 0x6D
| 109
| V1
| nein
|
|-
| HUMIDITY_CONTROL_OPERATING_STATE
| 0x6E
| 110
| V1
| nein
|
|-
| ENTRY_CONTROL
| 0x6F
| 111
| V1
| nein
|
|-
| CONFIGURATION
| 0x70
| 112
| V4
| V1
|
|-
| ALARM
| 0x71
| 113
| V8
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| FIRMWARE_UPDATE_MD
| 0x7A
| 122
| V5
| nein
|
|-
| GROUPING_NAME
| 0x7B
| 123
| V1
| nein
| GROUPING_NAME [DEPRECATED]
|-
| REMOTE_ASSOCIATION_ACTIVATE
| 0x7C
| 124
| V1
| nein
| REMOTE_ASSOCIATION_ACTIVATE [OBSOLETED]
|-
| REMOTE_ASSOCIATION
| 0x7D
| 125
| V1
| nein
| REMOTE_ASSOCIATION [OBSOLETED]
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
| HAIL [DEPRECATED]
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V2
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
| PROPRIETARY [DEPRECATED]
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_COMMAND (MULTI_CMD)
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_RENDERER_STATUS
| 0x96
| 150
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_CONTENT_SEARCH_MD
| 0x97
| 151
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SECURITY
| 0x98
| 152
| V1
| V1
| weitere Tests erforderlich
|-
| AV_TAGGING_MD
| 0x99
| 153
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| IP_CONFIGURATION
| 0x9A
| 154
| V1
| nein
| IP_CONFIGURATION [OBSOLETED]
|-
| ASSOCIATION_COMMAND_CONFIGURATION
| 0x9B
| 155
| V1
| nein
|
|-
| SENSOR_ALARM
| 0x9C
| 156
| V1
| V1
| SENSOR_ALARM [DEPRECATED]
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
| SENSOR_CONFIGURATION [OBSOLETED]
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| N/A
|
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| N/A
|
|
|-
| SECURITY_SCHEME0_MARK
| 0xF100
| 61696
| N/A
|
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in Fhem jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet, dass neuere Geräte, die laut der Produktbeschreibung NOTIFICATION unterstützen, dies in Fhem NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind. Als eine Besonderheit ist hier bereits 0xF100 für "SECURITY_SCHEME0_MARK" vergeben.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet bzw. nicht in der offiziellen Liste von Sigma Designs enthalten:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind, z.B.:
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-09-03T15:58:02Z

A.Harrenberg: Update der Klassen/Versionen mit den offiziellen Listen von Sigma Designs (SDS12657-12-Z-Wave-Command-Class-Specification-A-M.pdf)

{{Randnotiz|RNTyp=Info|RNText=Dieser Artikel wurde vor Veröffentlichung der [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification] am 31.08.2016 erstellt. Die Informationen zu den Command Classes waren bis zu diesem Zeitpunkt nicht offengelegt. Die Versionen/Namen der Klassen wurden anhand der nun verfügbaren Dokumentation angepasst (03-09.2016)}}
[[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. Allgemeine Grundlagen zu Z-Wave finden sich im [[Z-Wave|Z-Wave Hauptartikel]].

== Command Classes ==
=== Einleitung ===
Die Dokumentation der Z-Wave Command Classes ist leider nicht offengelegt, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder 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 zu 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 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_50:2

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.

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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen, so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| ZWAVE_CMD_CLASS
| 0x01
| 1
| ?
| ?
| LowLevel-Funktionen, die von http://fhem.de/commandref#ZWCUL teilweise unterstützt werden
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
| Z-Wave for IP
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| SWITCH_TOGGLE_BINARY
| 0x28
| 40
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_BINARY [DEPRECATED]
|-
| SWITCH_TOGGLE_MULTILEVEL
| 0x29
| 41
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_MULTILEVEL [DEPRECATED]
|-
| CHIMNEY_FAN
| 0x2A
| 42
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SCENE_ACTIVATION
| 0x2B
| 43
| V1
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
| SENSOR_BINARY [DEPRECATED]
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V10
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| SWITCH_COLOR (COLOR_CONTROL)
| 0x33
| 51
| V3
| V1
|
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
|
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
| METER_PULSE [DEPRECATED]
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| PREPAYMENT
| 0x3F
| 63
| V1
| nein
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
| CLIMATE_CONTROL_SCHEDULE [DEPRECATED]
|-
| 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
| V1, V2, V3
| SCHEDULE_ENTRY_LOCK [DEPRECATED]
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V8
| nein
| ZIP_6LOWPAN (ITU-T G.9959 / IETF RFC 7428)
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
| BASIC_WINDOW_COVERING [OBSOLETED]
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| MTP_WINDOW_COVERING [OBSOLETED] (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| SCHEDULE (NETWORK_SCHEDULE)
| 0x53
| 83
| V3
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V3
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V3
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V4
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| HUMIDITY_CONTROL_SETPOINT (APPLIANCE)
| 0x64
| 100
| V1
| nein
|
|-
| DMX
| 0x65
| 101
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| NETWORK_MANAGEMENT_INSTALLATION_MAINTENANCE
| 0x67
| 103
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| ZIP_NAMING
| 0x68
| 104
| V1
| nein
|
|-
| MAILBOX
| 0x69
| 105
| V1
| nein
|
|-
| WINDOW_COVERING
| 0x6A
| 106
| V1
| nein
|
|-
| IRRIGATION
| 0x6B
| 107
| V1
| nein
|
|-
| SUPERVISION
| 0x6C
| 108
| V1
| nein
|
|-
| HUMIDITY_CONTROL_MODE
| 0x6D
| 109
| V1
| nein
|
|-
| HUMIDITY_CONTROL_OPERATING_STATE
| 0x6E
| 110
| V1
| nein
|
|-
| ENTRY_CONTROL
| 0x6F
| 111
| V1
| nein
|
|-
| CONFIGURATION
| 0x70
| 112
| V4
| V1
|
|-
| ALARM
| 0x71
| 113
| V8
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| FIRMWARE_UPDATE_MD
| 0x7A
| 122
| V5
| nein
|
|-
| GROUPING_NAME
| 0x7B
| 123
| V1
| nein
| GROUPING_NAME [DEPRECATED]
|-
| REMOTE_ASSOCIATION_ACTIVATE
| 0x7C
| 124
| V1
| nein
| REMOTE_ASSOCIATION_ACTIVATE [OBSOLETED]
|-
| REMOTE_ASSOCIATION
| 0x7D
| 125
| V1
| nein
| REMOTE_ASSOCIATION [OBSOLETED]
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
| HAIL [DEPRECATED]
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V2
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
| PROPRIETARY [DEPRECATED]
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_COMMAND (MULTI_CMD)
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_RENDERER_STATUS
| 0x96
| 150
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_CONTENT_SEARCH_MD
| 0x97
| 151
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SECURITY
| 0x98
| 152
| V1
| V1
| weitere Tests erforderlich
|-
| AV_TAGGING_MD
| 0x99
| 153
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| IP_CONFIGURATION
| 0x9A
| 154
| V1
| nein
| IP_CONFIGURATION [OBSOLETED]
|-
| ASSOCIATION_COMMAND_CONFIGURATION
| 0x9B
| 155
| V1
| nein
|
|-
| SENSOR_ALARM
| 0x9C
| 156
| V1
| V1
| SENSOR_ALARM [DEPRECATED]
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
| SENSOR_CONFIGURATION [OBSOLETED]
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| N/A
|
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| N/A
|
|
|-
| SECURITY_SCHEME0_MARK
| 0xF100
| 61696
| N/A
|
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in Fhem jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet, dass neuere Geräte, die laut der Produktbeschreibung NOTIFICATION unterstützen, dies in Fhem NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnetbzw. nicht in der offiziellen Liste von Sigma Designs auftauchen:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-08-19T19:39:45Z

A.Harrenberg: Update Name 0x3f PREPAYMENT

[[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. Allgemeine Grundlagen zu Z-Wave finden sich im [[Z-Wave|Z-Wave Hauptartikel]].

== Command Classes ==
=== Einleitung ===
Die Dokumentation der Z-Wave Command Classes ist leider nicht offengelegt, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder 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 zu 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 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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen, so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| ZWAVE_CMD_CLASS
| 0x01
| 1
| ?
| ?
| LowLevel-Funktionen, die von http://fhem.de/commandref#ZWCUL teilweise unterstützt werden
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
|
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| 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
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| COLOR_CONTROL
| 0x33
| 51
| V3
| V1
|
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
| nein
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| PREPAYMENT
| 0x3F
| 63
| V1
| nein
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
|
|-
| 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
| V1, V2, V3
|
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V1
| nein
|
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
|
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| NETWORK_SCHEDULE
| 0x53
| 83
| V1
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V1
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V2
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V4
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| NETWORK_MANAGEMENT_INSTALLATION_MAINTENANCE
| 0x67
| 103
| V1
| nein
|
|-
| ZIP_NAMING
| 0x68
| 104
| V1
| nein
|
|-
| MAILBOX
| 0x69
| 105
| V1
| nein
|
|-
| unbekannt
| 0x6A - 0x6F
| 106 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| V1
|
|-
| ALARM
| 0x71
| 113
| V5
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V1
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
|
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
|
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_CMD
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| V1
| weitere Tests erforderlich
|-
| 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
| V1
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| V1
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V1
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in Fhem jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet, dass neuere Geräte, die laut der Produktbeschreibung NOTIFICATION unterstützen, dies in Fhem NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x3F 63
** 0x6A-0x6F 106-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag, der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:
:<code>Remote Association Configuration V1</code>

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-07-23T06:54:29Z

A.Harrenberg: Umbenennung ALARM / NOTIFICATION unter Bemerkungen erklärt

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

Allgemeine Grundlagen zu [[Z-Wave|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
|
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| 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
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| V1
|
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
| nein
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
|
|-
| 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
| V1, V2, V3
|
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V1
| nein
|
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
|
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| NETWORK_SCHEDULE
| 0x53
| 83
| V1
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V1
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V2
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V3
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| V1
|
|-
| ALARM
| 0x71
| 113
| V5
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V1
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
|
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
|
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_CMD
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| V1
| weitere Tests erforderlich
|-
| 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
| V1
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| V1
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in Fhem jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet das neuere Geräte die laut der Produktbeschreibung NOTIFICATION unterstützen dies in Fhem NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-07-16T09:19:10Z

A.Harrenberg:

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

Allgemeine Grundlagen zu [[Z-Wave|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
|
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| 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
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| V1
|
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
| nein
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
|
|-
| 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
| V1, V2, V3
|
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V1
| nein
|
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
|
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| NETWORK_SCHEDULE
| 0x53
| 83
| V1
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V1
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V2
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V3
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| V1
|
|-
| ALARM
| 0x71
| 113
| V5
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V1
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
|
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
|
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_CMD
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| V1
| weitere Tests erforderlich
|-
| 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
| V1
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| V1
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-07-16T09:17:43Z

A.Harrenberg: Update unterstützte Version für 0x71 ALARM / NOTIFICATION

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

Allgemeine Grundlagen zu [[Z-Wave|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
|
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| 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
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| V1
|
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
| nein
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
|
|-
| 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
| V1, V2, V3
|
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V1
| nein
|
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
|
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| NETWORK_SCHEDULE
| 0x53
| 83
| V1
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V1
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V2
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V3
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| V1
|
|-
| ALARM
| 0x71
| 113
| V5
| V4
| ab V3 umbenannt in NOTIFICATION
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V1
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
|
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
|
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_CMD
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| V1
| weitere Tests erforderlich
|-
| 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
| V1
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| V1
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2016-01-03T11:32:36Z

A.Harrenberg: Updates zu unterstützen Klassen (0x22, 0x53, 0x62, 0x8a, 0x8b)

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

Allgemeine Grundlagen zu [[Z-Wave|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In Fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von Fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| BASIC
| 0x20
| 32
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
|
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| 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
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| V1
|
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
| nein
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
|
|-
| 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
| V1
|
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| NETWORK_SCHEDULE
| 0x53
| 83
| V1
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V1
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V2
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V3
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| V1
|
|-
| ALARM
| 0x71
| 113
| V5
| unterstützt, Version noch nicht geklärt
|
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V1
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
|
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
|
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_CMD
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| 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
| V1
| weitere Tests erforderlich
|-
| 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
| V1
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| nein
|
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

=== Beispiel für eine Command Class und deren Implementierung in Fhem ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-23T21:27:26Z

A.Harrenberg:

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selsbt keine dieser neuen Funktion nutzt. Genausogut können in der höheren höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
|
|
|-
| BASIC
| 0x20
| 32
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| 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 ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (Z/IP Tunneling Server) (COLOR_CONTROL ?)
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (ZIP_ADV_SERVER ?)
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
|
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
|
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| 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 durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| nein
|
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ALARM
| 0x71
| 113
| V5
| unterstützt, Version noch nicht geklärt
|
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| nein
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| nein
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| CLOCK
| 0x81
| 129
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| HAIL
| 0x82
| 130
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| VERSION
| 0x86
| 134
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| INDICATOR
| 0x87
| 135
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| V1
| nein
|
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, sodaß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

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

=== Quellen und Links ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Benutzer:A.Harrenberg/Z-Wave Command Classes

2015-05-23T21:17:08Z

A.Harrenberg: A.Harrenberg verschob die Seite Benutzer:A.Harrenberg/Z-Wave Command Classes nach Z-Wave Command Classes

#WEITERLEITUNG [[Z-Wave Command Classes]]

Z-Wave Command Classes

2015-05-23T21:17:07Z

A.Harrenberg: A.Harrenberg verschob die Seite Benutzer:A.Harrenberg/Z-Wave Command Classes nach Z-Wave Command Classes

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selsbt keine dieser neuen Funktion nutzt. Genausogut können in der höheren höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
|
|
|-
| BASIC
| 0x20
| 32
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| 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 ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (Z/IP Tunneling Server) (COLOR_CONTROL ?)
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (ZIP_ADV_SERVER ?)
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
|
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
|
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| 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 durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| nein
|
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ALARM
| 0x71
| 113
| V5
| unterstützt, Version noch nicht geklärt
|
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| nein
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| nein
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| CLOCK
| 0x81
| 129
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| HAIL
| 0x82
| 130
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| VERSION
| 0x86
| 134
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| INDICATOR
| 0x87
| 135
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| unterstützt, Version noch nicht geklärt
| nein
|
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, sodaß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

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

=== Quellen und Links ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-23T21:08:14Z

A.Harrenberg: Einträge in der Liste weiter verfeinert, Bemerkungen zu den Einträgen unten angefügt.

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

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 noch 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 unterstützt, trotzdem aber selsbt keine dieser neuen Funktion nutzt. Genausogut können in der höheren höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

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.

In fhem sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte 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.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von fhem zu melden.

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

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
|
|
|-
| BASIC
| 0x20
| 32
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| 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 ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| unterstützt, Version noch nicht geklärt
|
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V8
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (Z/IP Tunneling Server) (COLOR_CONTROL ?)
|-
| COLOR_CONTROL
| 0x33
| 51
| V1
| unterstützt, Version noch nicht geklärt
| (ZIP_ADV_SERVER ?)
|-
| ZIP_ADV_CLIENT
| 0x34
| 52
| V1
|
| (Z/IP Tunneling Client) (NETWORK_MANAGEMENT_INCLUSION ?)
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
|
| (ZIP_ADV_CLIENT ?)
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
|
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
|
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
|
|-
| unbekannt
| 0x3F
| 63
|
|
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| nein
|
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| nein
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| nein
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| 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 durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| nein
|
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| APPLIANCE
| 0x64
| 100
| V1
| nein
| (GARAGE_DOOR ?)
|-
| GARAGE_DOOR
| 0x64
| 100
| V1
| nein
| (APPLIANCE ?)
|-
| DMX
| 0x65
| 101
| V1
| nein
|
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| nein
|
|-
| unbekannt
| 0x67 - 0x6F
| 103 - 111
|
|
|
|-
| CONFIGURATION
| 0x70
| 112
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ALARM
| 0x71
| 113
| V5
| unterstützt, Version noch nicht geklärt
|
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| nein
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| nein
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| 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
|
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| CLOCK
| 0x81
| 129
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| HAIL
| 0x82
| 130
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| VERSION
| 0x86
| 134
| V2
| unterstützt, Version noch nicht geklärt
|
|-
| INDICATOR
| 0x87
| 135
| V1
| unterstützt, Version noch nicht geklärt
|
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| 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
| unterstützt, Version noch nicht geklärt
|
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
|
|-
| unbekannt
| 0x9F - 0xEE
| 159 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| unterstützt, Version noch nicht geklärt
| nein
|
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| V?
| nein
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, sodaß hier für die Zukunft noch einige Erweiterungen möglich sind.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
** 0x64 APPLIANCE / GARAGE_DOOR
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt sind:
** 0x3F 63
** 0x67-0x6F 103-111
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

Es gibt aktuell noch einen Eintrag der nicht der obigen Liste zugeordnet werden kann, da keine ID bekannt ist:

Remote Association Configuration V1

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

=== Quellen und Links ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-22T21:41:50Z

A.Harrenberg: Link korrigiert, "unsortable" für einige Tabellenspalten eingefügt, Tabelle mit weiteren Informationen gefüllt

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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 ===

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | 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.

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

=== Quellen und Links ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-22T20:54:55Z

A.Harrenberg: Einige Klassen geändert, falsche Aussage im Text beseitigt

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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 ===

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | 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 ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-22T17:31:34Z

A.Harrenberg:

{{Baustelle}}

[[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|Z-Wave]] finden sich in dem Hauptartikel [[Z-Wave|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|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 ===

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | 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)

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

=== Quellen und Links ===

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave Command Classes

2015-05-22T16:45:48Z

A.Harrenberg: Eintragen von bekannten Version

Z-Wave Command Classes

2015-05-21T20:26:45Z

A.Harrenberg: Beschreibung von Z-Wave Command Classes (Kommandoklassen) und der Implementierung in fhem.

Benutzer:A.Harrenberg

2015-05-21T18:06:36Z

A.Harrenberg:

Dies ist nur ein Platzhalter

[[/Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]]

[[/Z-Wave Command Classes]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-13T22:24:29Z

A.Harrenberg: Hinweise zu der ISO-Norm der RFiD-Tags hinzugefügt

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP WT-RFID Keypad]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften des Zipato WT-RFID Keypad sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)
* Kommunikation über Z-Wave Protokoll

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastencodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
<pre>get <device> userCode <UserID></pre>

Programmieren einer UserID:
<pre>set <device> userCode <UserID> <UserID-Status> <code></pre>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden. Im Logfile wird die gesamte Nachricht als Rohwerte abgelegt.

Zahlenangaben im Logfile und im Reading sind in der Regel in hexadezimaler Form. Bei den Logfile Einträgen wurde Datum/Uhrzeit und Loglevel entfernt um die Einträge kurz zu halten.

<pre>
Aktion: Home gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Home gedrückt, Tastencode 1234 und Enter eingegeben
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
</pre>
Tasten werden im ASCII-Code übertragen.

==== Anlernen/Abspeichern von RFID-Tags oder Tastencodes ====

<pre>
Anlernen Tag #1:
fhem-Befehl: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: Sending stored command: 13080e630101018fa4d1542a00010400000508
</pre>
Überprüfen durch Abfrage der UserID:
<pre>
Auslesen UserID 1:
fhem-Befehl: get Zipato_EC userCode 1
Logfile: Sending stored command: 1308036302010508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000
</pre>
Wenn der status = 1 ist und der code identisch ist, dann hat das abspeichern funktioniert.

Auslesen einer UserID die noch nicht gespeichert wurde:
<pre>
Auslesen UserID 2:
fhem-Befehlt: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000
</pre>
Hier ist der Status 0 (verfügbar/nicht aktiv), es ist jedoch ein Code angezeigt der aber nicht relevant ist. Es ist nicht möglich nur den Status zu wechsel ohne den Code mit zu übertragen. Daher wird auf jeden Fall immer der beim set Befehl gelieferte Code geschrieben/genutzt.

<pre>
Tastencode 1234 auf UserID 2 anlernen:
fhem-Befehl: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: Sending stored command: 13080e63010201313233340000000000000508
</pre>
<pre>
Auslesen UserID 2:
fhem-Befehl: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000
</pre>
Der Code würde überschrieben und ist jetzt gültig.

==== Anzahl Codes ====
Laut einem Beitrag im Internet soll der Reader nur 10 Codes unterstützen, laut der Webseite von Zipato bis zu 20 Codes. Das Gerät wurde erfolgreich mit 32 verschiedenen Codes getestet und hat die Codes einwandfrei der UserID zugeordnet. Daher ist davon auszugehen, dass es keine Beschränkung in der Anzahl der Codes gibt und das somit 255 verschiedenen Codes abgelegt werden können.

==== Alarmmeldungen ====
Bei gültigem Code wird, je nachdem ob "Home" oder "Away" gewählt wurde, eine entsprechende Meldung gesendet:

<pre>
Home + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101
</pre>
<pre>
Away + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101
</pre>
<pre>
Home + 1234 + Enter:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102
</pre>
Diese Events können jetzt z.B. mit einem Notify abgefragt werden um damit dann ein Sicherheitssystem zu schalten. Die UserID ist im letzten (hexadezimalen) Wert in "arg" erkennbar, der Tastencode in obigem Beispiel ist der UserID 2 zugeordnet. Die Bedeutung der davorstehenden 0x01 ist bisher nicht geklärt, vermutlich handelt es sich hier um den Status der UserID, welcher auch noch 02 für Admistrator sein kann.

Beim Öffnen des Gehäuse (Entfernen von der Rückplatte) wird ein Sabotagealarm ausgelöst:
<pre>
Tamper alarm ausgelöst:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00
</pre>

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Die wichtigsten Logmeldungen sind in dem obigen Kapitel bereits aufgeführt.

Das Gerät erzeugt regelmäßig Einträge im Log wenn der Loglevel entsprechend hoch gesetzt wurde, in diesem Fall auf 4:
<pre>
ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:028407
</pre>
Hierbei handelt es sich um die beschriebene WAKE_UP_NOTIFICATION die das Gerät nach dem Aufwachen verschickt.

== Bekannte Probleme ==
Aktuell sind noch keine Probleme oder Einschränkungen bekannt, das Gerät wird zur Zeit aber noch nicht produktiv eingesetzt.

== Verwendete RFiD-Tags ==
Das Gerät ist für Tags nach:
* ISO 15693
* ISO 18000-3
* Tag-itTM
spezifiziert.
Als weiteres ist noch "RFiD" angegeben, was aber nicht wirklich hilft ein passenden Tag zu kaufen.
Die "Standard"-Tags die es z.B. auf ebay oder bei Amazon gibt verwenden meistens ISO 14443 und sind nicht kompatibel. Bisher sind keine kompatiblen Tags ausser den originalen Hersteller-Tags bekannt.

Eine recht günstige Quelle ist z.B. hier im [http://www.intellihome.be/de/z-wave-zipato-rfid-key-tag.html Online-Shop von intellihome.be] in Belgien. Hier muss allerdings der Versand nach Deutschland (8 €) berücksichtigt werden. Hinweise zu kompatiblen günstigeren Alternativen sind willkommen.

== Ähnliche/Baugleiche Geräte ==
Das hier dargestellte Gerät ist von Zipato, ein identisch aussehendes Gerät gibt es auch noch von [http://www.benext.eu/ BeNext]. Es gibt wiedersprüchliche Aussagen ob die Geräte nun identisch sind oder nicht (z.B. [https://community.zipato.com/topic/support-of-the-benext-tag-reader-rfid Diskussion zum BeNext Tag Reader in der Zipato Community]). Informationen zu dem Gerät von Schlage (von dem auch der Eintrag in der XML-Datei (siehe get <device> model) stammt findet sich im Netz nicht mehr. Schlage scheint dieses Gerät nicht mehr zu vertreiben.

Der eigentliche Hersteller des Gerätes scheint Wintop zu sein. In der Anleitung des Gerätes findet sich zum Thema COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2 die folgende Passage: "Manufacturer ID of Wintop is 0x97, the ID of this product is 0x31". Auf der Webseite von Wintop findet man die Geräte leider nur sehr schwer, Informationen zu den dortigen Geräten erhalten anscheinend nur registrierte Händler mit Login. Die Geräte sind jedoch [http://www.wintop.com/Home/Index/rfid/ hier] abgebildet, der online-shop von Wintop verlinkt dann [http://www.ihomeapple.hk/goods.php?id=2270 hierhin].

== Forumsdiskussion ==
Der Wiki-Artikel beruht auf den Informationen aus der Forumsdiskussion zur Implementierung des RFID-Readers bzw. der damals fehlenden Implementierung der COMMAND_CLASS_USER_CODE.
({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=Forumsdiskussion
}})

== Weblinks ==
* Herstellerwebseite: [http://www.zipato.com zipato]
* Zipato wt-rfid.eu - Mini Keypad RDiD: [http://www.zipato.com/default.aspx?id=24&pid=88&page=1&grupe= online shop]

* Anleitung v1.3: (aktuell funktioniert download-link nicht!) [http://www.zipato.com/UserDocsImages/Zipato/wt-rfid%20-%20Zipato%20Mini%20Keypad%20RFiD+Z-Wave%20User%20Manual%20v1.3.pdf download PDF]
** das hier beschrieben Gerät wurde mit einer Anleitung V1.2 ausgeliefert: [http://www.intellihome.be/de/z-wave-zipato-mini-keypad-rfid-z-wave.html#technical download PDF from www.intellihome.be]
* Alternatives Keypad: [http://www.benext.eu/ BeNext]
* Anleitung BeNext: [http://www.benext.eu/static/manual/tagreader.pdf download PDF]
* BeNext Tag Reader: [https://shop.benext.eu/product_info.php?cPath=24&products_id=44 online Shop]

[[Kategorie:Z-Wave Components]]

Benutzer:A.Harrenberg/Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID

2015-05-12T19:07:12Z

A.Harrenberg: A.Harrenberg verschob die Seite Benutzer:A.Harrenberg/Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID nach Z-Wave-ZIP WT-RFID Keypad: Veröffentlichung der Seite

#WEITERLEITUNG [[Z-Wave-ZIP WT-RFID Keypad]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-12T19:07:12Z

A.Harrenberg: A.Harrenberg verschob die Seite Benutzer:A.Harrenberg/Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID nach Z-Wave-ZIP WT-RFID Keypad: Veröffentlichung der Seite

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP WT-RFID Keypad]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften des Zipato WT-RFID Keypad sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)
* Kommunikation über Z-Wave Protokoll

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastencodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
<pre>get <device> userCode <UserID></pre>

Programmieren einer UserID:
<pre>set <device> userCode <UserID> <UserID-Status> <code></pre>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden. Im Logfile wird die gesamte Nachricht als Rohwerte abgelegt.

Zahlenangaben im Logfile und im Reading sind in der Regel in hexadezimaler Form. Bei den Logfile Einträgen wurde Datum/Uhrzeit und Loglevel entfernt um die Einträge kurz zu halten.

<pre>
Aktion: Home gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Home gedrückt, Tastencode 1234 und Enter eingegeben
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
</pre>
Tasten werden im ASCII-Code übertragen.

==== Anlernen/Abspeichern von RFID-Tags oder Tastencodes ====

<pre>
Anlernen Tag #1:
fhem-Befehl: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: Sending stored command: 13080e630101018fa4d1542a00010400000508
</pre>
Überprüfen durch Abfrage der UserID:
<pre>
Auslesen UserID 1:
fhem-Befehl: get Zipato_EC userCode 1
Logfile: Sending stored command: 1308036302010508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000
</pre>
Wenn der status = 1 ist und der code identisch ist, dann hat das abspeichern funktioniert.

Auslesen einer UserID die noch nicht gespeichert wurde:
<pre>
Auslesen UserID 2:
fhem-Befehlt: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000
</pre>
Hier ist der Status 0 (verfügbar/nicht aktiv), es ist jedoch ein Code angezeigt der aber nicht relevant ist. Es ist nicht möglich nur den Status zu wechsel ohne den Code mit zu übertragen. Daher wird auf jeden Fall immer der beim set Befehl gelieferte Code geschrieben/genutzt.

<pre>
Tastencode 1234 auf UserID 2 anlernen:
fhem-Befehl: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: Sending stored command: 13080e63010201313233340000000000000508
</pre>
<pre>
Auslesen UserID 2:
fhem-Befehl: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000
</pre>
Der Code würde überschrieben und ist jetzt gültig.

==== Anzahl Codes ====
Laut einem Beitrag im Internet soll der Reader nur 10 Codes unterstützen, laut der Webseite von Zipato bis zu 20 Codes. Das Gerät wurde erfolgreich mit 32 verschiedenen Codes getestet und hat die Codes einwandfrei der UserID zugeordnet. Daher ist davon auszugehen, dass es keine Beschränkung in der Anzahl der Codes gibt und das somit 255 verschiedenen Codes abgelegt werden können.

==== Alarmmeldungen ====
Bei gültigem Code wird, je nachdem ob "Home" oder "Away" gewählt wurde, eine entsprechende Meldung gesendet:

<pre>
Home + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101
</pre>
<pre>
Away + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101
</pre>
<pre>
Home + 1234 + Enter:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102
</pre>
Diese Events können jetzt z.B. mit einem Notify abgefragt werden um damit dann ein Sicherheitssystem zu schalten. Die UserID ist im letzten (hexadezimalen) Wert in "arg" erkennbar, der Tastencode in obigem Beispiel ist der UserID 2 zugeordnet. Die Bedeutung der davorstehenden 0x01 ist bisher nicht geklärt, vermutlich handelt es sich hier um den Status der UserID, welcher auch noch 02 für Admistrator sein kann.

Beim Öffnen des Gehäuse (Entfernen von der Rückplatte) wird ein Sabotagealarm ausgelöst:
<pre>
Tamper alarm ausgelöst:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00
</pre>

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Die wichtigsten Logmeldungen sind in dem obigen Kapitel bereits aufgeführt.

Das Gerät erzeugt regelmäßig Einträge im Log wenn der Loglevel entsprechend hoch gesetzt wurde, in diesem Fall auf 4:
<pre>
ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:028407
</pre>
Hierbei handelt es sich um die beschriebene WAKE_UP_NOTIFICATION die das Gerät nach dem Aufwachen verschickt.

== Bekannte Probleme ==
Aktuell sind noch keine Probleme oder Einschränkungen bekannt, das Gerät wird zur Zeit aber noch nicht produktiv eingesetzt.

== Ähnliche/Baugleiche Geräte ==
Das hier dargestellte Gerät ist von Zipato, ein identisch aussehendes Gerät gibt es auch noch von [http://www.benext.eu/ BeNext]. Es gibt wiedersprüchliche Aussagen ob die Geräte nun identisch sind oder nicht (z.B. [https://community.zipato.com/topic/support-of-the-benext-tag-reader-rfid Diskussion zum BeNext Tag Reader in der Zipato Community]). Informationen zu dem Gerät von Schlage (von dem auch der Eintrag in der XML-Datei (siehe get <device> model) stammt findet sich im Netz nicht mehr. Schlage scheint dieses Gerät nicht mehr zu vertreiben.

Der eigentliche Hersteller des Gerätes scheint Wintop zu sein. In der Anleitung des Gerätes findet sich zum Thema COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2 die folgende Passage: "Manufacturer ID of Wintop is 0x97, the ID of this product is 0x31". Auf der Webseite von Wintop findet man die Geräte leider nur sehr schwer, Informationen zu den dortigen Geräten erhalten anscheinend nur registrierte Händler mit Login. Die Geräte sind jedoch [http://www.wintop.com/Home/Index/rfid/ hier] abgebildet, der online-shop von Wintop verlinkt dann [http://www.ihomeapple.hk/goods.php?id=2270 hierhin].

== Forumsdiskussion ==
Der Wiki-Artikel beruht auf den Informationen aus der Forumsdiskussion zur Implementierung des RFID-Readers bzw. der damals fehlenden Implementierung der COMMAND_CLASS_USER_CODE.
({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=Forumsdiskussion
}})

== Weblinks ==
* Herstellerwebseite: [http://www.zipato.com zipato]
* Zipato wt-rfid.eu - Mini Keypad RDiD: [http://www.zipato.com/default.aspx?id=24&pid=88&page=1&grupe= online shop]

* Anleitung v1.3: (aktuell funktioniert download-link nicht!) [http://www.zipato.com/UserDocsImages/Zipato/wt-rfid%20-%20Zipato%20Mini%20Keypad%20RFiD+Z-Wave%20User%20Manual%20v1.3.pdf download PDF]
** das hier beschrieben Gerät wurde mit einer Anleitung V1.2 ausgeliefert: [http://www.intellihome.be/de/z-wave-zipato-mini-keypad-rfid-z-wave.html#technical download PDF from www.intellihome.be]
* Alternatives Keypad: [http://www.benext.eu/ BeNext]
* Anleitung BeNext: [http://www.benext.eu/static/manual/tagreader.pdf download PDF]
* BeNext Tag Reader: [https://shop.benext.eu/product_info.php?cPath=24&products_id=44 online Shop]

[[Kategorie:Z-Wave Components]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-12T19:03:56Z

A.Harrenberg: erste Version für die Veröffentlichung im Wiki

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP WT-RFID Keypad]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften des Zipato WT-RFID Keypad sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)
* Kommunikation über Z-Wave Protokoll

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastencodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
<pre>get <device> userCode <UserID></pre>

Programmieren einer UserID:
<pre>set <device> userCode <UserID> <UserID-Status> <code></pre>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden. Im Logfile wird die gesamte Nachricht als Rohwerte abgelegt.

Zahlenangaben im Logfile und im Reading sind in der Regel in hexadezimaler Form. Bei den Logfile Einträgen wurde Datum/Uhrzeit und Loglevel entfernt um die Einträge kurz zu halten.

<pre>
Aktion: Home gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Home gedrückt, Tastencode 1234 und Enter eingegeben
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
</pre>
Tasten werden im ASCII-Code übertragen.

==== Anlernen/Abspeichern von RFID-Tags oder Tastencodes ====

<pre>
Anlernen Tag #1:
fhem-Befehl: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: Sending stored command: 13080e630101018fa4d1542a00010400000508
</pre>
Überprüfen durch Abfrage der UserID:
<pre>
Auslesen UserID 1:
fhem-Befehl: get Zipato_EC userCode 1
Logfile: Sending stored command: 1308036302010508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000
</pre>
Wenn der status = 1 ist und der code identisch ist, dann hat das abspeichern funktioniert.

Auslesen einer UserID die noch nicht gespeichert wurde:
<pre>
Auslesen UserID 2:
fhem-Befehlt: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000
</pre>
Hier ist der Status 0 (verfügbar/nicht aktiv), es ist jedoch ein Code angezeigt der aber nicht relevant ist. Es ist nicht möglich nur den Status zu wechsel ohne den Code mit zu übertragen. Daher wird auf jeden Fall immer der beim set Befehl gelieferte Code geschrieben/genutzt.

<pre>
Tastencode 1234 auf UserID 2 anlernen:
fhem-Befehl: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: Sending stored command: 13080e63010201313233340000000000000508
</pre>
<pre>
Auslesen UserID 2:
fhem-Befehl: get Zipato_EC userCode 2
Logfile: Sending stored command: 1308036302020508
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000
</pre>
Der Code würde überschrieben und ist jetzt gültig.

==== Anzahl Codes ====
Laut einem Beitrag im Internet soll der Reader nur 10 Codes unterstützen, laut der Webseite von Zipato bis zu 20 Codes. Das Gerät wurde erfolgreich mit 32 verschiedenen Codes getestet und hat die Codes einwandfrei der UserID zugeordnet. Daher ist davon auszugehen, dass es keine Beschränkung in der Anzahl der Codes gibt und das somit 255 verschiedenen Codes abgelegt werden können.

==== Alarmmeldungen ====
Bei gültigem Code wird, je nachdem ob "Home" oder "Away" gewählt wurde, eine entsprechende Meldung gesendet:

<pre>
Home + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101
</pre>
<pre>
Away + Tag #1:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101
</pre>
<pre>
Home + 1234 + Enter:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102
</pre>
Diese Events können jetzt z.B. mit einem Notify abgefragt werden um damit dann ein Sicherheitssystem zu schalten. Die UserID ist im letzten (hexadezimalen) Wert in "arg" erkennbar, der Tastencode in obigem Beispiel ist der UserID 2 zugeordnet. Die Bedeutung der davorstehenden 0x01 ist bisher nicht geklärt, vermutlich handelt es sich hier um den Status der UserID, welcher auch noch 02 für Admistrator sein kann.

Beim Öffnen des Gehäuse (Entfernen von der Rückplatte) wird ein Sabotagealarm ausgelöst:
<pre>
Tamper alarm ausgelöst:
Logfile: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00
</pre>

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Die wichtigsten Logmeldungen sind in dem obigen Kapitel bereits aufgeführt.

Das Gerät erzeugt regelmäßig Einträge im Log wenn der Loglevel entsprechend hoch gesetzt wurde, in diesem Fall auf 4:
<pre>
ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:028407
</pre>
Hierbei handelt es sich um die beschriebene WAKE_UP_NOTIFICATION die das Gerät nach dem Aufwachen verschickt.

== Bekannte Probleme ==
Aktuell sind noch keine Probleme oder Einschränkungen bekannt, das Gerät wird zur Zeit aber noch nicht produktiv eingesetzt.

== Ähnliche/Baugleiche Geräte ==
Das hier dargestellte Gerät ist von Zipato, ein identisch aussehendes Gerät gibt es auch noch von [http://www.benext.eu/ BeNext]. Es gibt wiedersprüchliche Aussagen ob die Geräte nun identisch sind oder nicht (z.B. [https://community.zipato.com/topic/support-of-the-benext-tag-reader-rfid Diskussion zum BeNext Tag Reader in der Zipato Community]). Informationen zu dem Gerät von Schlage (von dem auch der Eintrag in der XML-Datei (siehe get <device> model) stammt findet sich im Netz nicht mehr. Schlage scheint dieses Gerät nicht mehr zu vertreiben.

Der eigentliche Hersteller des Gerätes scheint Wintop zu sein. In der Anleitung des Gerätes findet sich zum Thema COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2 die folgende Passage: "Manufacturer ID of Wintop is 0x97, the ID of this product is 0x31". Auf der Webseite von Wintop findet man die Geräte leider nur sehr schwer, Informationen zu den dortigen Geräten erhalten anscheinend nur registrierte Händler mit Login. Die Geräte sind jedoch [http://www.wintop.com/Home/Index/rfid/ hier] abgebildet, der online-shop von Wintop verlinkt dann [http://www.ihomeapple.hk/goods.php?id=2270 hierhin].

== Forumsdiskussion ==
Der Wiki-Artikel beruht auf den Informationen aus der Forumsdiskussion zur Implementierung des RFID-Readers bzw. der damals fehlenden Implementierung der COMMAND_CLASS_USER_CODE.
({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=Forumsdiskussion
}})

== Weblinks ==
* Herstellerwebseite: [http://www.zipato.com zipato]
* Zipato wt-rfid.eu - Mini Keypad RDiD: [http://www.zipato.com/default.aspx?id=24&pid=88&page=1&grupe= online shop]

* Anleitung v1.3: (aktuell funktioniert download-link nicht!) [http://www.zipato.com/UserDocsImages/Zipato/wt-rfid%20-%20Zipato%20Mini%20Keypad%20RFiD+Z-Wave%20User%20Manual%20v1.3.pdf download PDF]
** das hier beschrieben Gerät wurde mit einer Anleitung V1.2 ausgeliefert: [http://www.intellihome.be/de/z-wave-zipato-mini-keypad-rfid-z-wave.html#technical download PDF from www.intellihome.be]
* Alternatives Keypad: [http://www.benext.eu/ BeNext]
* Anleitung BeNext: [http://www.benext.eu/static/manual/tagreader.pdf download PDF]
* BeNext Tag Reader: [https://shop.benext.eu/product_info.php?cPath=24&products_id=44 online Shop]

[[Kategorie:Z-Wave Components]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-11T19:47:25Z

A.Harrenberg:

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID.EU
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften von Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastencodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
<pre>get <device> userCode <UserID></pre>

Programmieren einer UserID:
<pre>set <device> userCode <UserID> <UserID-Status> <code></pre>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden. Im Logfile wird die gesamte Nachricht als Rohwerte abgelegt.

<pre>
Aktion: Home gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: 2015.05.09 15:28:08 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: 2015.05.09 15:29:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Home gedrückt, Tastencode 1234 und Enter eingegeben
Logfile: 2015.05.09 15:32:25 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
</pre>
Tasten werden im ASCII-Code übertragen.

==== Anlernen/Abspeichern von RFID-Tags oder Tastencodes ====

<pre>
Anlernen Tag #1:
fhem-Befehl: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: 2015.05.09 15:37:56 4: Sending stored command: 13080e630101018fa4d1542a00010400000508
</pre>
Überprüfen durch Abfrage der UserID:
<pre>
Auslesen UserID 1:
fhem-Befehl: get Zipato_EC userCode 1
Logfile: 2015.05.09 15:39:40 4: Sending stored command: 1308036302010508
Logfile: 2015.05.09 15:39:40 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000
</pre>
Wenn der status = 1 ist und der code identisch ist, dann hat das abspeichern funktioniert.

Auslesen einer UserID die noch nicht gespeichert wurde:
<pre>
Auslesen UserID 2:
fhem-Befehlt: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:42:37 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:42:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000
</pre>
Hier ist der Status 0 (verfügbar/nicht aktiv), es ist jedoch ein Code angezeigt der aber nicht relevant ist. Es ist nicht möglich nur den Status zu wechsel ohne den Code mit zu übertragen. Daher wird auf jeden Fall immer der beim set Befehl gelieferte Code geschrieben/genutzt.

<pre>
Tastencode 1234 auf UserID 2 anlernen:
fhem-Befehl: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: 2015.05.09 15:46:12 4: Sending stored command: 13080e63010201313233340000000000000508
</pre>
<pre>
Auslesen UserID 2:
fhem-Befehl: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:46:54 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:46:54 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000
</pre>
Der Code würde überschrieben und ist jetzt gültig.

==== Anzahl Codes ====
Laut einem Beitrag im Internet soll der Reader nur 10 Codes unterstützen, laut der Webseite von Zipato bis zu 20 Codes. Das Gerät wurde mit 32 verschiedenen Codes getestet und hat die Codes einwandfrei der UserID zugeordnet. Daher ist davon auszugehen das es keine Beschränkung in der Anzahl der Codes gibt und das somit 255 verschiedenen Codes abgelegt werden können.

==== Alarmmeldungen ====
Bei gültigem Code wird je nachdem ob "Home" oder "Away" gewählt wurde eine entsprechende Meldung gesendet:

<pre>
Home + Tag #1:
Logfile: 2015.05.09 15:49:02 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101
</pre>
<pre>
Away + Tag #1:
Logfile: 2015.05.09 15:50:55 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101
</pre>
<pre>
Home + 1234 + Enter:
Logfile: 2015.05.09 15:51:49 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102
</pre>
Diese Events können jetzt z.B. mit einem Notify abgefragt werden um damit dann ein Sicherheitssystem zu schalten.

Beim Öffnen des Gehäuse (Entfernen von der Rückplatte) wird ein Sabotagealarm ausgelöst:
<pre>
Tamper alarm ausgelöst:
Logfile: 2015.05.09 15:48:29 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00
</pre>

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Die wichtigsten Logmeldungen sind in dem obigen Kapitel bereits aufgeführt.

Das Gerät erzeugt regelmäßig Einträge im Log:
<pre>
2015.05.11 20:42:34 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:028407
</pre>
Hierbei handelt es sich um die beschriebene WAKE_UP_NOTIFICATION die das Gerät nach dem Aufwachen verschickt.

== Bekannte Probleme ==
Aktuell sind noch keine Probleme oder Einschränkungen bekannt, das Gerät wird zur Zeit aber noch nicht produktiv eingesetzt.

== Ähnliche/Baugleiche Geräte ==
Das hier dargestellte Gerät ist von Zipato, ein identisch aussehendes Gerät gibt es auch noch von [http://www.benext.eu/ BeNext]. Es gibt wiedersprüchliche Aussagen ob die Geräte nun identisch sind oder nicht (z.B. [https://community.zipato.com/topic/support-of-the-benext-tag-reader-rfid Diskussion zum BeNext Tag Reader in der Zipato Community]). Informationen zu dem Gerät von Schlage (von dem auch der Eintrag in der XML-Datei (siehe get <device> model) stammt findet sich im Netz nicht mehr. Schlage scheint dieses Gerät nicht mehr zu vertreiben.

== Weblinks ==
* Herstellerwebseite: [http://www.zipato.com zipato]
* Zipato wt-rfid.eu - Mini Keypad RDiD: [http://www.zipato.com/default.aspx?id=24&pid=88&page=1&grupe= online shop]

* Anleitung v1.3: (aktuell funktioniert download-link nicht!) [http://www.zipato.com/UserDocsImages/Zipato/wt-rfid%20-%20Zipato%20Mini%20Keypad%20RFiD+Z-Wave%20User%20Manual%20v1.3.pdf download PDF]
** das hier beschrieben Gerät wurde mit einer Anleitung V1.2 ausgeliefert: [http://www.intellihome.be/de/z-wave-zipato-mini-keypad-rfid-z-wave.html#technical download PDF from www.intellihome.be]
* Alternatives Keypad: [http://www.benext.eu/ BeNext]
* Anleitung BeNext: [http://www.benext.eu/static/manual/tagreader.pdf download PDF]
* BeNext Tag Reader: [https://shop.benext.eu/product_info.php?cPath=24&products_id=44 online Shop]

[[Kategorie:Z-Wave Components]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-11T06:12:30Z

A.Harrenberg:

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID.EU
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften von Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastencodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
get <device> userCode <UserID>

Programmieren einer UserID:
set <device> userCode <UserID> <UserID-Status> <code>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden.

<pre>
Aktion: Home gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: 2015.05.09 15:28:08 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: 2015.05.09 15:29:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000
</pre>
<pre>
Aktion: Home gedrückt, Tastencode 1234 und Enter eingegeben
Logfile: 2015.05.09 15:32:25 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
</pre>
Tasten werden als ASCII-Code übertragen.

Die Rückmeldung aus dem userCode Reading kann

Anlernen Tag #1: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: 2015.05.09 15:37:56 4: Sending stored command: 13080e630101018fa4d1542a00010400000508

Auslesen UserID 1: get Zipato_EC userCode 1
Logfile: 2015.05.09 15:39:40 4: Sending stored command: 1308036302010508
Logfile: 2015.05.09 15:39:40 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000

Auslesen UserID 2: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:42:37 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:42:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000

Tastencode 1234 auf UserID 2 anlernen: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: 2015.05.09 15:46:12 4: Sending stored command: 13080e63010201313233340000000000000508

Auslesen UserID 2: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:46:54 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:46:54 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000

Tamper alarm ausgelöst:
Logfile: 2015.05.09 15:48:29 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00

Home + Tag #1:
Logfile: 2015.05.09 15:49:02 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101

Away + Tag #1:
Logfile: 2015.05.09 15:50:55 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101

Home + 1234 + Enter:
Logfile: 2015.05.09 15:51:49 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102

Wird am Gerät ein aktiver code per Tastatur oder RFID-Tag erkannt, so wird über einen Report der COMMAND_CLASS_ALARM_V2 ein "Lock" bzw. "Unlock" Befehle übermittelt

get jlklö

set kjl

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# ...
# ...

== Bekannte Probleme ==
Keine (oder Liste der bekannten Probleme / Einschränkungen).

== Weblinks ==
* Erläuterung [/_weblink_ Linktitel]

[[Kategorie:XYZ Gerät]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-11T06:05:54Z

A.Harrenberg:

{{Infobox Hardware
|Bild=ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg|200px|center|Produktbild Zipato WT-RFID.EU
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser, welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften von Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID sind
* Einlesen von RFID Tags (Protokolle: ISO15693, ISO18000-3, Tag-itTM, RFiD)
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll
* Kontroll LED, Summer
* Batteriebetrieb
* Wandmontage (nur für Innenbereich geeignet, Kunststoffgehäuse nicht Vandalensicher)

Prinzipielle Funktionsweise:

Betätigen der Taste "Home" oder "Away", danach Eingabe eines 4-10 stelligen Codes und Bestätigung mit Enter ODER Einlesen eines RFiD-Tags.

Sollte der Code bzw. der RFID-Tag angenommen werden, so wird über die COMMAND_CLASS_ALARM_V2 eine "Lock" bzw. "Unlock" Nachricht verschickt, wodurch ein Sicherheitssystem ein- oder ausgeschaltet werden kann. Die Übertragung dieser Nachricht ist nicht gesondert gesichert oder verschlüsselt, die COMMAND_CLASS_SECURITY wird von dem Gerät nicht unterstützt.

== Hinweise zum Betrieb mit Fhem ==
=== Allgemeine Informationen zum Betrieb mit FHEM ===
Das Gerät verwendet die folgenden Z-Wave Befehlsklassen (COMMAND_CLASS)
* Class: 0x85 COMMAND_CLASS_ASSOCIATION
* Class: 0x80 COMMAND_CLASS_BATTERY
* Class: 0x84 COMMAND_CLASS_WAKE_UP
* Class: 0x86 COMMAND_CLASS_VERSION
* Class: 0x72 COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2
* Class: 0x71 COMMAND_CLASS_ALARM_V2
* Class: 0x70 COMMAND_CLASS_CONFIGURATION
* Class: 0x25 COMMAND_CLASS_SWITCH_BINARY
* Class: 0x63 COMMAND_CLASS_USER_CODE

Diese Klassen werden aktuell (Stand 10.05.2015) von FHEM soweit unterstützt, wie es zum Betrieb des Gerätes nötig ist. Die Klasse 0x63 (COMMAND_CLASS_USER_CODE) wurde extra für dieses Gerät von Rudolf König implementiert.

Im folgenden wird das Gerät entweder als ZWave_ENTRY_CONTROL_<nodeID> oder allgemeiner als <device> bezeichnet, um es in den FHEM-Befehlen anzusprechen. Dargestellte Ausschnitte aus den Logfiles oder Konfigurationsdateien zeigen das Gerät als allerdings unter dem Namen "Zipato_EC".

=== Inklusion ===
Das Gerät wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und als "'''ZWave_ENTRY_CONTROL_<nodeID>'''" in FHEM definiert. (Also z.B. als ZWave_ENTRY_CONTROL_8, falls das Gerät die nodeID 8 erhalten hat)

=== Assoziation ===
Die Gruppe 1 wird zwischen dem Gerät und dem Z-Wave-Controller (z.B. einem ZWave.me USB-Stick; hier mit NodeID 1) durch den folgenden Befehl erzeugt:
set <device> associationAdd 1 1

=== Konfiguration ===
==== XML-Dateien einbinden ====
Durch
get <device> model
wird die Definiton aus der externen XML-Datei mit weiteren Hilfetexten und Parametern in fhem eingefügt.

Nach aktuellem Stand (10.05.2015) der XML-Datei werden dabei die folgenden Informationen als Readings eingetragen:

* model: Schlage Link Mini Keypad RFID
* modelConfig: schlagelink/minikeypad.xml
* modelId: 0097-6131-4501
==== Wakeup-Interval / "Always on" Modus / (Sabotage-Kontakt) ====
Das Gerät ist batteriebetrieben und schaltet sich nach Beendigung der Datenübertragung in einen Tiefschlafmodus, sobald vom Z-Wave-Controller keine weiteren Daten mehr vorliegen (wird vom Controller mit einer "WAKE_UP_NO_MORE_NOTIFICATION" mitgeteilt) um den Batterieverbrauch minimal zu halten.

Das Zeitinterval nach dem das Gerät automatisch wieder aufwacht und dem Controller die Chance gibt neue Befehle zu senden lässt sich mit
set <device> wakeupInterval <sekunden> 1
setzen. In diesem Fall würde die WAKE_UP_NOTIFICATION NUR an den Z-Wave-Controller (nodeID = 1) gehen. Soll die WAKE_UP_NOTIFICATION an alle Geräte gesendet werden, so kann für die nodeID 255 (Broadcast) angegeben werden.
Default Wert für das Zeitinterval ist bei diesem Gerät 7200 Sekunden (2 Stunden).

Durch diesen Tiefschlafmodus ist es teilweise schwierig das Gerät einzurichten / neue Codes zu senden, da Befehle erst nach dem nächsten Aufwachen abgearbeitet werden.

Möglichkeiten zum umgehen der Einschränkungen durch den Tiefschlafmodus:
* Zeitinterval auf z.B. 5 Sekunden heruntersetzen, hierdurch werden Befehle spätestens nach 5 Sekunden abgearbeitet. Nach Beendigung der Konfigurationsarbeiten sollte das Interval wieder hochgesetzt werden um die Batterien zu schonen.
* "Always on" Mode setzen: In diesem Modus ist der Empfänger ständig an, allerdings funktioniert in diesem Modus die Eingabe von Codes bzw. das Einlesen von RFID-Tags am Gerät nicht! Daher müssten eventuell anzulernende RFID-Tags vorher ausgelesen werden. Der Modus wird durch eine "3" eingeschaltet und durch eine "1" wieder ausgeschaltet:
set <device> configTheMode 3
set <device> configTheMode 1
* Nutzung des Sabotage-Kontaktes: Entfernt man das Gerät aus seiner Halterung, so wird ein Sabotage Kontakt ausgelöst, was mit einer Nachricht an den Controller gemeldet wird. Hierdurch wird auch eine "WAKE_UP_NOTIFICATION" erzeugt, innerhalb derer dann die aufgelaufenen und gespeicherten Befehle ausgeführt werden. Das kann man sich zu Nutze machen indem man das Gerät auf den Tisch legt (Sabotage Kontakt ist dann geschlossen) und kurz anhebt sobald man eine Datenübertragung benötigt.

=== Umgang mit Tastencodes / RFID-Tags ===
Das Gerät nutzt 4-10 stellige Tastecodes (aus den Zahlen 1-4) oder die in RFID-Chips gespeicherten Seriennummern zum Authentifizieren. Es können bis zu 255 solcher Codes (entweder Tastencode oder RFID-code) im Gerät gespeichert werden. Die Verwaltung dieser Codes wird über die COMMAND_CLASS_USER_CODE (0x63) durchgeführt.

Jedem Code ist ein "User Identifier" (UserID oder UID) sowie ein Status (User ID Status) zugeordnet. Die UserID kann von 1 bis 255 gewählt werden, 0 ist an dieser Stelle nicht gültig. Der Status ist entweder 0 (verfügbar/nicht aktiv) oder 1 (belegt/aktiv). Im Z-Wave Standard ist hier auch noch 2 "Reserved by administrator" vorgesehen, diese scheint bei dem Gerät aber nicht genutzt zu werden.

Codes werden intern IMMER 10 stellig abgelegt, sollte der Code kürzer sein, so wird mit 0x00 aufgefüllt. Dies gilt sowohl für Tastencodes, als auch für die RFID-Tags. Die Tastencodes werden als ASCII-Codes der Zahlen abgelegt, die Taste 1 wird als 0x31 eingetragen.

Im Auslieferungszustand des Gerätes ist kein Code aktiv, auch der mitgelieferte RFID-Tag ist nicht angelernt und kann daher nicht direkt zum schalten genutzt werden.

Die Befehle zum Umgang mit den Tastencodes / RFID-Tags nutzen wie schon beschrieben die COMMAND_CLASS_USER_CODE:

Auslesen einer UserID:
get <device> userCode <UserID>

Programmieren einer UserID:
set <device> userCode <UserID> <UserID-Status> <code>

<UserId>: 1-255, 0 ist nicht erlaubt

<UserID-Status>: 0 (verfügbar/nicht aktiv), 1 (belegt/aktiv), (2 reserviert für Administator)

==== Auslesen unbekannter RFID-Tags oder nicht angelernter Tastencodes ====
Wird ein unbekannter Tastencode oder ein unbekannter RFID-Tag am Gerät eingegeben, so sendet das Gerät einen Report mit:
* UserID=0
* UserID-Status=0
* Code, 10 stellig
Bei unbekanntem Code wird keine Info gesendet ob "Home" oder "Away" gedruckt wurde. Der gemeldete Code wird in den Readings unter userCode angezeigt und kann dann zum Programmieren des Codes verwendet werden.

Home gedrückt, dann (unbekannten) Tag #1 davorgehalten:
Logfile: 2015.05.09 15:28:08 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000

Away gedrückt, dann (unbekannten) Tag #1 davorgehalten
Logfile: 2015.05.09 15:29:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630300008fa4d1542a0001040000
Reading: userCode id 0 status 0 code 8fa4d1542a0001040000

Home, Code 1234, Enter
Logfile: 2015.05.09 15:32:25 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303000031323334000000000000
Reading: userCode id 0 status 0 code 31323334000000000000
-> Tasten werden als ASCII-Code übertragen

Die Rückmeldung aus dem userCode Reading kann

Anlernen Tag #1: set Zipato_EC userCode 1 1 8fa4d1542a0001040000
Logfile: 2015.05.09 15:37:56 4: Sending stored command: 13080e630101018fa4d1542a00010400000508

Auslesen UserID 1: get Zipato_EC userCode 1
Logfile: 2015.05.09 15:39:40 4: Sending stored command: 1308036302010508
Logfile: 2015.05.09 15:39:40 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e630301018fa4d1542a0001040000
Reading: userCode id 1 status 1 code 8fa4d1542a0001040000

Auslesen UserID 2: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:42:37 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:42:37 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020031323334000000000000
Reading: userCode id 2 status 0 code 8fe37e542a0001040000

Tastencode 1234 auf UserID 2 anlernen: set Zipato_EC userCode 2 1 31323334000000000000
Logfile: 2015.05.09 15:46:12 4: Sending stored command: 13080e63010201313233340000000000000508

Auslesen UserID 2: get Zipato_EC userCode 2
Logfile: 2015.05.09 15:46:54 4: Sending stored command: 1308036302020508
Logfile: 2015.05.09 15:46:54 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0e6303020131323334000000000000
Reading: userCode id 2 status 1 code 31323334000000000000

Tamper alarm ausgelöst:
Logfile: 2015.05.09 15:48:29 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:09710500ff00ff070300
Reading: alarm HomeSecurity: Tampering, product covering removed, arg 00

Home + Tag #1:
Logfile: 2015.05.09 15:49:02 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060101
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0101

Away + Tag #1:
Logfile: 2015.05.09 15:50:55 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a710500ff00ff06050101
Reading: alarm AccessControl: Keypad Lock Operation, arg 0101

Home + 1234 + Enter:
Logfile: 2015.05.09 15:51:49 4: ZWDongle_0 CMD:APPLICATION_COMMAND_HANDLER ID:08 ARG:0a7105000000ff06060102
Reading: alarm AccessControl: Keypad Unlock Operation, arg 0102

Wird am Gerät ein aktiver code per Tastatur oder RFID-Tag erkannt, so wird über einen Report der COMMAND_CLASS_ALARM_V2 ein "Lock" bzw. "Unlock" Befehle übermittelt

get jlklö

set kjl

=== Definition ===
Auszug aus der fhem.cfg mit der Definition des Gerätes:
<pre>
define Zipato_EC ZWave e173b78d 8
attr Zipato_EC IODev ZWDongle_0
attr Zipato_EC classes ASSOCIATION BATTERY WAKE_UP VERSION MANUFACTURER_SPECIFIC ALARM CONFIGURATION SWITCH_BINARY USER_CODE
attr Zipato_EC room ZWave
attr Zipato_EC verbose 5
define FileLog_Zipato_EC FileLog ./log/Zipato_EC-%Y.log Zipato_EC
attr FileLog_Zipato_EC logtype text
</pre>
Der Gerätename ist in diesem Beispiel Zipato_EC, der Loglevel steht zu Debug-Zwecken auf 5.

=== Logbeispiel ===

Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# ...
# ...

== Bekannte Probleme ==
Keine (oder Liste der bekannten Probleme / Einschränkungen).

== Weblinks ==
* Erläuterung [/_weblink_ Linktitel]

[[Kategorie:XYZ Gerät]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T20:52:52Z

A.Harrenberg:

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T20:36:39Z

A.Harrenberg:

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T19:55:49Z

A.Harrenberg:

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T18:32:38Z

A.Harrenberg:

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T17:45:08Z

A.Harrenberg:

Datei:ZIP-WT-RFID.EU-Mini-Keypad-RFID.jpg

2015-05-10T17:43:01Z

A.Harrenberg: Produktbild Zipato WT-RFID.EU-Mini-Keypad-RFID Quelle: Foto A.Harrenberg

Produktbild Zipato WT-RFID.EU-Mini-Keypad-RFID
Quelle: Foto A.Harrenberg

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T17:30:31Z

A.Harrenberg:

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=Z-Wave
|HWType=Eingabe, Sender und Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=keine Herstellerangaben
|HWPoweredBy=2xAA 1,5V Batterien
|HWSize=63x63x19mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.zipato.com zipato]
}}
[[Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften von Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID sind
* Einlesen von RFID Tags
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)
* Tasten für "Home" und "Away" zur Kennzeichnung ob Ein- oder Ausgeschaltet werden soll

Das Gerät verfügt weiterhin über eine Kontroll-LED sowie einen Summer über den Tasteneingaben oder RFID-Tags akkustisch bestätigt werden.

== Hinweise zum Betrieb mit Fhem ==
Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# ...
# ...

== Bekannte Probleme ==
Keine (oder Liste der bekannten Probleme / Einschränkungen).

== Weblinks ==
* Erläuterung [/_weblink_ Linktitel]

[[Kategorie:XYZ Gerät]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T17:17:35Z

A.Harrenberg:

{{Infobox Hardware|...}}
[[Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]] ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser welches dazu geeignet ist, ein Sicherheitssystem über Z-Wave Kommunikation ein-/ und auszuschalten.

== Features / Funktionen ==
Die Haupteigenschaften von Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID sind
* Einlesen von RFID Tags
* Eingabe von Tastencodes über Mini-Keypad (Zahlen 1-4, Enter)

Das Gerät verfügt weiterhin über ein Kontroll-LED sowie einen Summer über den Tasteneingaben oder RFID-Tags akkustisch bestätigt werden.

== Hinweise zum Betrieb mit Fhem ==
Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# ...
# ...

== Bekannte Probleme ==
Keine (oder Liste der bekannten Probleme / Einschränkungen).

== Weblinks ==
* Erläuterung [/_weblink_ Linktitel]

[[Kategorie:XYZ Gerät]]

Z-Wave-ZIP WT-RFID Keypad

2015-05-10T17:16:40Z

A.Harrenberg: Die Seite wurde neu angelegt: „{{Infobox Hardware|...}} Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID ist ein Eingabeterminal mit Mini-Keypad und eingebautem RFID-Leser welches dazu geeignet is…“

Benutzer:A.Harrenberg

2015-05-10T17:02:46Z

A.Harrenberg:

Dies ist nur ein Platzhalter

[[/Z-Wave-ZIP-WT-RFID.EU-Mini-Keypad-RFID]]

Benutzer:A.Harrenberg

2015-05-10T16:57:05Z

A.Harrenberg: Die Seite wurde neu angelegt: „Dies ist nur ein Platzhalter“

Dies ist nur ein Platzhalter