Geavanceerde opties voor generieke Z-Wave producten
Dit artikel legt uit hoe u geavanceerde ondersteuning toevoegt voor generieke Z-Wave producten, inclusief command classes en datatypes. Het veronderstelt basiskennis van generieke producten en voldoende kennis van Z-Wave.
In deze tutorial gaan we bekijken hoe we generieke producten uitgebreider kunnen ondersteunen. Als eerst gaan we kijken hoe command classes werken binnen het BeNext systeem. Vervolgens gaan we een command class toevoegen. Daarna wordt een overzicht gegeven van alle datatypes en parameters die aanwezig zijn in het systeem.
In het volgende deel gaan we dieper in op het sturen van configuraties en associaties voor een generiek product.
Deze tutorial gaat ervan uit dat u al in staat bent generieke producten te installeren en dat u weet wat command classes zijn. Ook gaan we ervan uit dat er al een geïnstalleerd generiek product is.
Bekijk ook de vorige tutorial over generieke producten toevoegen
Het instellingen scherm#
De meeste van deze instellingen zullen plaats vinden op of vanaf het “Instellingen scherm”. Dit is te vinden door naar Setup te gaan en dan in het menu op ‘Product’ te klikken. Als tweede optie in de tabbalk bovenin vindt u dan de “Instellingen” pagina. Op deze pagina kunt u onderin het product selecteren dat u wilt gaan instellen.
Let op: het product moet geïnstalleerd zijn voor u het kunt selecteren.
Aanpassen
Met deze optie kunt u de naam en datatype van een property aanpassen. Met het datatype kunt u bepalen of uw product bijvoorbeeld juist als Energie of Klimaat product verschijnt. Meer informatie over property datatypes vindt u hieronder.
Auto-verversen
Als u deze optie aanzet voor een property wordt hij periodiek opgevraagd. Dit kan handig zijn bij temperatuur of energie sensoren. Voor sommige sensoren is het noodzakelijk om deze op te vragen. Bijvoorbeeld als ze niet automatisch verstuurd worden en er een Rule op aangemaakt is. De waarden worden iedere negen minuten opgevraagd voor gevoede apparaten. Voor batterij gevoede apparaten is dit iedere wake-up.
Properties verwijderen
Mocht er iets mis gaan of heeft u de verkeerde instellingen geselecteerd? Selecteer dan het vinkje voor de property bij “Properties verwijderen”. Deze actie is NIET ongedaan te maken en zal alle bijbehorende informatie verwijderen. Pas dus op met het gebruiken van deze optie.
Overzicht command classes#
Tijdens het installeren van een generiek product probeert het BeNext systeem al te detecteren of er extra command classes toegevoegd moeten worden. Zo wordt automatisch de Battery en de Wakeup command class gemapped. Het systeem is echter in de meeste gevallen niet slim genoeg om dit 100% goed te doen. Daarom biedt het BeNext systeem de mogelijkheid om zelf deze command classes toe te voegen of opnieuw in te stellen.
Open het “Command Class toevoegen” scherm door op het linkje te klikken. Dit scherm bevat meerdere instellingen, waarvan een deel al vooraf ingevuld is. We lopen stap voor stap door de instellingen heen zodat we weten wat alles doet.
- Command Class
De command class die u wilt toevoegen. Niet alle command classes worden ondersteund. Om goede ondersteuning te garanderen hebben we de lijst kort gehouden en de belangrijkste command classes toegevoegd. - Channel (Kanaal)
Sommige apparaten hebben meerdere channels of instances of endpoints. Met deze optie kunt u een specifieke channel of instance van een command classes toevoegen. Als een apparaat geen channels heeft of u wilt de standaard waarde, kies dan channel 0. - Parameter
De parameter optie zorgt ervoor dat u verschillende waarden kunt opvragen voor de Meter en Sensor Multilevel V5+ command classes. Over het algemeen moet u hier de scale invullen. Onderaan deze pagina wordt een tabel met alle waarden weergegeven. - Name (Naam)
De naam die gebruikt wordt bij de weergave. - Datatype
Het datatype van een product beïnvloedt de weergave en de bediening van een product. De verschillende datatypes worden beneden uitgebreider uitgelegd. - Sends reports (stuurt reports)
Dit geeft aan of het product waarden stuurt vanaf deze command class. Meestal moet dit aanstaan. - Receive sets (ontvangt sets)
Dit geeft aan of de command class van het apparaat bestuurbaar is. Voorbeelden hiervan zijn Basic, Switch Binary en Switch Multilevel.
Command Class toevoegen#
Stap 1: Instellingen pagina
Het toevoegen van een command class begint op de instellingen pagina. Ga naar Setup en klik op de menu optie ‘Product’. U komt dan op de “Product naam” pagina. Klik op ‘Instellingen’ in de tabbalk bovenin.
Stap 2: Product selectie
Selecteer het product waar u de command class aan wilt toevoegen.
Stap 3: Open command class toevoegen
Klik op het linkje “Command class toevoegen”. Dit opent een nieuw scherm met daarin alle opties.
Stap 4: Vul de velden in
Vul de velden in. Voor meer informatie welke waarden geselecteerd moeten worden kunt u onderaan deze tutorial kijken. Klik op “Toevoegen” als u tevreden bent met de instellingen.
Stap 5: Command class toegevoegd
De command class is nu toegevoegd. U kunt nu gebruik maken van deze command class. Eventueel kunt u de waarde automatisch op laten vragen. Kijk hiervoor bij de volgende stap.
Stap 6: Waarde automatisch opvragen (optioneel)
Ververs de pagina nadat u de command class hebt toegevoegd. De nieuwe command class staat nu in het instellingen scherm. Zet het vinkje bij “Auto-ververs” aan en druk op Save.
Let op: U moet de Gateway synchroniseren voordat de waarde opgevraagd wordt.
Overzicht datatypes & parameters#
Property datatypes
Het datatype dat geselecteerd wordt beïnvloed het gedrag van de property.
| Datatype | Weergave | Bediening |
| Battery | Percentage (%) | — |
| CO2 | PPM | — |
| Contact | Open / Dicht | — |
| Dimmer | Percentage (%) | Slider |
| Energy | Watt (kW) | — |
| EnergyProductionkWh | Energie (kWh) | — |
| Energy_kWh | Energie (kWh) | — |
| Flow | Stroming (m³/h) | — |
| LightLux | Lux | — |
| Lock | Slot erop / Slot eraf | Erop / eraf knoppen |
| Lux | Percentage (%) | — |
| Meter | Komma getal | — |
| Movement | Gedetecteerd / Inactief | — |
| ScheduleOverride | Temperatuur (°C) | Slider |
| Sensor | Komma getal | — |
| Setpoint | Temperatuur (°C) | — |
| Switch | Aan / Uit | Aan / Uit knoppen |
| Temperature | Temperatuur (°C) | — |
| Volume | Volume (m³) | — |
Parameter waarde selectie#
De parameter optie wordt gebruikt om verschillende waarden te selecteren.
Geen specifieke parameter waarden
Deze command classes hebben geen specifieke parameter waarden die ingevuld kunnen worden. U kunt gewoon de waarde “0” gebruiken.
- Alarm V1
- Basic
- Climate Control Schedule
- Sensor Binary
- Sensor Multilevel V1-V4
- Switch Binary
- Switch Multilevel
Alarm V2+ / Notification cmd class
Voor Alarm V2 moet het “Z-Wave Alarm Type” gebruikt worden
| Alarm type | Parameter |
| Smoke | 256 |
| CO | 512 |
| CO2 | 768 |
| Heat | 1024 |
| Water | 1280 |
| Access Control | 1536 |
| Burglar / Home Security | 1792 |
| Power Management | 2048 |
Color Control
Om color control goed te laten werken moet voor elke basis (RGBW) kleur een command class aanmaken. Doe dit doet u met de datatype Dimmer8bit, voor het volledige bereik van een individuele kleur. U kunt vervolgens de kleuren mixen met de dimmers. Als u makkelijk naar een specifieke kleur wilt schakelen kunt u het beste een scene aanmaken.
| Kleur | Parameter |
| Warm wit | 1 |
| Koud wit | 2 |
| Rood | 3 |
| Groen | 4 |
| Blauw | 5 |
Configuration#
Voor Configuration moet als parameter de configuratie parameter gegeven worden.
Meter V1-V2
Voor Meter V1 en V2 geldt dat de parameter hetzelfde is als de scale type:
| Meter Type | Scale | Parameter |
| Electric Meter | kWh | 0 |
| KVAh | 1 | |
| Watt | 2 | |
| Pulse Count | 3 | |
| Gas Meter | Cubic meter | 0 |
| Cubic feet | 1 | |
| Reserve | 2 | |
| Pulse count | 3 | |
| Water Meter | Cubic meter | 0 |
| Cubic feet | 1 | |
| US Gallons | 2 | |
| Pulse count | 3 |
Meter V3
| Meter Type | Scale | Parameter |
| Electric Meter | kWh | 0 |
| kVAh | 1 | |
| Watt | 2 | |
| Pulse Count | 3 | |
| Voltage | 260 | |
| Ampère | 261 | |
| Power factor | 262 | |
| Gas Meter | Cubic meter | 0 |
| Cubic feet | 1 | |
| Reserve | 2 | |
| Pulse Count | 3 | |
| Water Meter | Cubic meter | 0 |
| Cubic feet | 1 | |
| US Gallons | 2 | |
| Pulse count | 3 |
Meter V4+
Voor Meter V4+ gelden dezelfde parameters als voor Meter V1-V2. Als toevoeging hierop is het mogelijk om specifiek verbruik en opwekking op te vragen (rate type). Om dit te doen moet er 256 (voor verbruik) of 512 (voor opwekking) bij opgeteld worden. Zo wordt het verbruikte Watt: 2 + 256 = 258. Het opgewekte kWh wordt: 0 + 512 = 512.
| Meter Type | Scale | Parameter (verbruik) | parameter (opwekking) |
| Electric Meter | kWh | 256 | 512 |
| kVAh | 257 | 513 | |
| Watt | 258 | 514 | |
| Pulse Count | 259 | 515 | |
| Voltage | 602 | 516 | |
| Ampère | 261 | 517 | |
| Power factor | 262 | 518 | |
| Gas Meter | Cubic meter | 256 | 512 |
| Cubic feet | 257 | 513 | |
| Reserve | 258 | 514 | |
| Pulse Count | 259 | 515 | |
| Water Meter | Cubic meter | 256 | 512 |
| Cubic feet | 257 | 513 | |
| US Gallons | 258 | 514 | |
| Pulse count | 259 | 515 |
Sensor Multilevel V5+
Voor Sensor Multilevel V5+ geldt dat waarden per sensor type opgevraagd kunnen worden. Net als bij Meter V4+ moet de scale erbij opgeteld worden. Voor de scales, zie de Z-wave documentatie.
| Sensor type | Parameter |
| Luchttemperature | 256 |
| General purpose value | 512 |
| Licht | 768 |
| Lux | 769 |
| Vermogen | 1024 |
| Luchtvochtigheid | 1280 |
| Snelheid | 1536 |
| Richting | 1792 |
| Atmosferische druk | 2048 |
| Barometrische druk | 2304 |
| Zonnestraling | 2560 |
| Dauwpunt | 2816 |
| Regen | 3072 |
| Getijdenniveau | 3328 |
| Gewicht | 3584 |
| Voltage | 3840 |
| Stroom | 4096 |
| CO2-niveau | 4352 |
| Luchtstroming | 4608 |
| Inhoud | 4864 |
| Afstand | 5120 |
| Hoek | 5376 |
| Toerental | 5632 |
| Watertemperatuur | 5888 |
| Aardetemperatuur | 6144 |
| Seismische intensiteit | 6400 |
| Seismische magnitude | 6656 |
| Ultraviolet | 6912 |
| Elektrische weerstand | 7168 |
| Elektrische geleiding | 7424 |
| Geluidsniveau | 7680 |
| Vochtigheid | 7936 |
| Frequentie | 8192 |
| Tijd | 8448 |
| Doel temperatuur | 8704 |
| PM2.5 | 8960 |
| CH20 niveau | 9216 |
| Radon concentratie | 9472 |
| Methaan dichtheid (CH4) | 9728 |
| VOC niveau (mol/m3) | 9984 |
| VOC Parts/million (ppm) | 9985 |
| CO niveau | 10240 |
| Rook dichtheid | 14080 |
| Water flow | 14336 |
| Waterdruk | 14592 |
| RF signaal sterkte | 14848 |
Thermostat Setpoint
De parameter voor thermostaat setpoint is afhankelijk van het setpoint type dat geset moet worden. In de meeste gevallen zal die 1 zijn. Daarnaast komt ook Energy Save Heating (11) vaak voor.
| Setpoint type | Parameter |
| Heating #1 | 1 |
| Cooling #1 | 2 |
| Furnace | 7 |
| Dry Air | 8 |
| Moist Air | 9 |
| Auto changeover | 10 |
| Energy Save Heating | 11 |
| Energy Save Cooling | 12 |
| Away Heating | 13 |
Bedankt voor het lezen van dit artikel.