Les Command Classes sont le vocabulaire technique de Z-Wave — elles définissent ce qu’un appareil peut faire et comment on lui parle. Comprendre leur rôle vous permettra de diagnostiquer les incompatibilités, d’exploiter toutes les fonctionnalités de vos appareils et de créer des automatisations plus précises.

La notion de Command Class : le vocabulaire Z-Wave

Dans le protocole Z-Wave, chaque type d’action ou d’information est codifié dans ce qu’on appelle une Command Class (CC). Une CC est en quelque sorte un « langage spécialisé » que les appareils utilisent pour se comprendre. Par exemple, la Command Class SWITCH_BINARY permet d’allumer ou éteindre un appareil. La CC SENSOR_MULTILEVEL permet de rapporter une mesure (température, luminosité, humidité). La CC DOOR_LOCK permet de verrouiller ou déverrouiller une serrure.

Chaque appareil Z-Wave supporte un ensemble précis de Command Classes, défini lors de sa conception. Lors de l’inclusion dans votre réseau, votre box domotique interroge l’appareil pour connaître la liste complète de ses CC — c’est l’étape dite d’interview. Une fois l’interview complet, votre box sait précisément ce que l’appareil peut faire et génère les commandes correspondantes dans votre interface.

Pourquoi les Command Classes sont importantes pour vous

La liste des CC supportées par un appareil détermine directement les fonctionnalités disponibles dans votre box domotique. Deux appareils de même type mais de générations différentes peuvent supporter des CC différentes, offrant des niveaux de contrôle et de reporting très différents.

• Exemple concret — Variateur : un variateur de première génération peut ne supporter que SWITCH_MULTILEVEL (variation on/off/niveau) sans ENERGY_METER ni CENTRAL_SCENE. Un modèle récent supportera en plus ENERGY_METER (mesure de consommation), CENTRAL_SCENE (gestion des scènes depuis le bouton physique) et CONFIGURATION (paramètres avancés). Le second offre une expérience domotique beaucoup plus riche.
• Exemple concret — Thermostat : un thermostat basique supporte THERMOSTAT_SETPOINT (consigne de température). Un modèle avancé ajoute THERMOSTAT_MODE (modes confort/éco/hors-gel), THERMOSTAT_OPERATING_STATE (état chauffe/arrêt) et SCHEDULE (programmation horaire intégrée).

Les Command Classes les plus importantes à connaître

Command Class	Abréviation	Fonction	Appareils typiques
SWITCH_BINARY	CC 0x25	ON/OFF d’une charge	Prises, relais, interrupteurs
SWITCH_MULTILEVEL	CC 0x26	Variation de niveau (0-99)	Variateurs, volets
SENSOR_BINARY	CC 0x30	Détection binaire (présent/absent)	Capteurs d’ouverture, détecteurs
SENSOR_MULTILEVEL	CC 0x31	Mesure de grandeurs physiques	Température, humidité, lux…
METER	CC 0x32	Comptage d’énergie (kWh, W, V, A)	Prises avec compteur, HEM
DOOR_LOCK	CC 0x62	Verrouillage/déverrouillage	Serrures connectées
THERMOSTAT_SETPOINT	CC 0x43	Consigne de température	Thermostats, TRV
THERMOSTAT_MODE	CC 0x40	Mode de fonctionnement du thermostat	Thermostats avancés
NOTIFICATION	CC 0x71	Alertes et événements (fumée, intrusion)	Détecteurs fumée, CO, alarmes
CENTRAL_SCENE	CC 0x5B	Gestion des scènes via bouton physique	Interrupteurs, télécommandes
CONFIGURATION	CC 0x70	Paramètres avancés de l’appareil	La plupart des appareils
WAKE_UP	CC 0x84	Gestion du réveil des appareils sur piles	Capteurs sur piles
BATTERY	CC 0x80	Niveau de batterie en %	Tous appareils sur piles
FIRMWARE_UPDATE_MD	CC 0x7A	Mises à jour firmware OTA	Appareils avec support OTA

Comment vérifier les Command Classes d’un appareil

Vous pouvez consulter les Command Classes supportées par un appareil de plusieurs façons :

• Dans Z-Wave JS UI (Home Assistant) : sélectionnez l’appareil dans la liste des nœuds → onglet « Node Info » → section « Command Classes ». Chaque CC est listée avec son statut (Supported / Controlled) et sa version.
• Dans la base de données Z-Wave JS : le projet Z-Wave JS maintient une base de données publique de tous les appareils Z-Wave connus (zwave-js.io/device-database). Chaque fiche liste les CC supportées, les paramètres de configuration disponibles et les notes de compatibilité.
• Dans la fiche produit du fabricant : les fabricants sérieux (Fibaro, Aeotec, Zooz) publient les manuel d’installation qui listent explicitement les CC supportées et les paramètres de configuration accessibles.