# Cozify Capability Definitions

The capability definitions for the Cozify ecosystem, used by services, apps and devices.

- **JSON:** [capabilities.json](capabilities.json)
- **Schema:** [schema.json](schema.json)

_119 capabilities._

## Capabilities

- [ACTIVE_CURRENT](#active_current) — en: Current / fi: Virta
- [ACTIVE_POWER](#active_power) — en: Power / fi: Teho
- [AIRCON](#aircon) — en: Air conditioner / fi: Ilmastointilaite
- [ALERT](#alert) — en: Alert / fi: Hälytys
- [ANALOG_VALUE](#analog_value) — en: Analog value / fi: Analoginen arvo
- [BACNET](#bacnet) — en: BACnet / fi: BACnet
- [BASS](#bass) — en: Bass / fi: Basso
- [BATTERY_C](#battery_c) — en: Battery charging / fi: Akun lataus
- [BATTERY_U](#battery_u) — en: Battery monitor / fi: Pariston tila
- [BRIGHTNESS](#brightness) — en: Brightness / fi: Kirkkaus
- [CLEAR_ALERT](#clear_alert) — en: Clear alert / fi: Kuittaa hälytys
- [CO](#co) — en: Carbon monoxide / fi: Häkä
- [CO2](#co2) — en: Carbon dioxide / fi: Hiilidioksidi
- [COLOR_HS](#color_hs) — en: Hue and saturation / fi: Sävy ja kylläisyys
- [COLOR_LOOP](#color_loop) — en: Color loop / fi: Värikierto
- [COLOR_RGB](#color_rgb) — en: RGB color / fi: RGB-väri
- [COLOR_TEMP](#color_temp) — en: Color temperature / fi: Värilämpötila
- [COLOR_XY](#color_xy) — en: XY color / fi: XY-väri
- [CONFIGURABLE](#configurable) — en: Configurable / fi: Määritettävä
- [CONTACT](#contact) — en: Door/window sensor / fi: Ovi- tai ikkunatunnistin
- [CONTROL_LIGHT](#control_light) — en: Light control / fi: Valon ohjaus
- [CONTROL_MODE](#control_mode) — en: Control mode / fi: Ohjaustila
- [CONTROL_POWER](#control_power) — en: Power control / fi: Virran ohjaus
- [CONTROL_PRESET](#control_preset) — en: Control preset / fi: Esiasetus
- [CONTROL_REL_HUMIDITY](#control_rel_humidity) — en: Humidity control / fi: Kosteuden ohjaus
- [CONTROL_TEMPERATURE](#control_temperature) — en: Target temperature / fi: Tavoitelämpötila
- [DETERIORATION](#deterioration) — en: Deterioration detection / fi: Voinnin heikkeneminen
- [DEVICE](#device) — en: Device presence / fi: Laitteen yhteys
- [DEVICE_HEALTH](#device_health) — en: Device health / fi: Laitteen kunto
- [DIMMER](#dimmer) — en: Dimmer / fi: Himmennin
- [DIMMER_CONTROL](#dimmer_control) — en: Dimmer control / fi: Himmennysohjain
- [EXT_THERMOMETER](#ext_thermometer) — en: External thermometer / fi: Ulkoinen lämpömittari
- [FAN_MODE](#fan_mode) — en: Fan mode / fi: Puhallintila
- [FLOOR_TEMP](#floor_temp) — en: Floor temperature / fi: Lattian lämpötila
- [FLOW](#flow) — en: Flow / fi: Virtaus
- [FLOW_TEMPERATURE](#flow_temperature) — en: Flow temperature / fi: Virtauslämpötila
- [FLOW_VOLUME](#flow_volume) — en: Flow volume / fi: Virtaustilavuus
- [FOSCAM_API](#foscam_api) — en: Foscam API / fi: Foscam-rajapinta
- [GENERATE_ALERT](#generate_alert) — en: Generate alert / fi: Luo hälytys
- [G_ALARM](#g_alarm) — en: Generic alarm / fi: Yleinen hälytys
- [HEXC_PRIMARY_TEMPERATURES](#hexc_primary_temperatures) — en: Heat exchanger primary temperatures / fi: Lämmönvaihtimen ensiöpuolen lämpötilat
- [HEXC_SECONDARY_TEMPERATURES](#hexc_secondary_temperatures) — en: Heat exchanger secondary temperatures / fi: Lämmönvaihtimen toisiopuolen lämpötilat
- [HIGH_TEMP](#high_temp) — en: High temperature alarm / fi: Korkean lämpötilan hälytys
- [HOME_SWITCH](#home_switch) — en: Home/Away switch / fi: Kotona/poissa-kytkin
- [HUE_SWITCH](#hue_switch) — en: Hue switch / fi: Hue-kytkin
- [HUMIDITY](#humidity) — en: Humidity / fi: Ilmankosteus
- [HYPOTERMIA](#hypotermia) — en: Hypothermia detection / fi: Alilämpöisyyden tunnistus
- [IAS_ACE](#ias_ace) — en: Alarm keypad / fi: Hälytysnäppäimistö
- [IDENTIFY](#identify) — en: Identify device / fi: Tunnista laite
- [IKEA_ONOFF_SWITCH](#ikea_onoff_switch) — en: IKEA on/off switch / fi: IKEA on/off -kytkin
- [IKEA_RC](#ikea_rc) — en: IKEA remote control / fi: IKEA-kauko-ohjain
- [KNX_AWAY_SWITCH](#knx_away_switch) — en: KNX away switch / fi: KNX poissa -kytkin
- [LIFT](#lift) — en: Lift position / fi: Nostoasento
- [LIVE_FEED](#live_feed) — en: Live feed / fi: Suora kuva
- [LOUDNESS](#loudness) — en: Loudness / fi: Loudness-korostus
- [LOW_TEMP](#low_temp) — en: Low temperature alarm / fi: Matalan lämpötilan hälytys
- [LUX](#lux) — en: Light level / fi: Valoisuus
- [MEASURE_POWER](#measure_power) — en: Energy / fi: Energia
- [MOISTURE](#moisture) — en: Moisture / fi: Kosteus
- [MOTION](#motion) — en: Motion / fi: Liike
- [MUTE](#mute) — en: Mute / fi: Vaiennus
- [NEXT](#next) — en: Next / fi: Seuraava
- [ONVIF_API](#onvif_api) — en: ONVIF API / fi: ONVIF-rajapinta
- [ON_OFF](#on_off) — en: On/off / fi: Päälle/pois
- [PASSIVITY](#passivity) — en: Passivity detection / fi: Passiivisuuden tunnistus
- [PAUSE](#pause) — en: Pause / fi: Tauko
- [PHONE_MAKE_CALL](#phone_make_call) — en: Make phone call / fi: Soita puhelu
- [PHONE_RECEIVE_CALL](#phone_receive_call) — en: Receive phone call / fi: Vastaanota puhelu
- [PIR_MOVE](#pir_move) — en: PIR/movement mode / fi: PIR-/liiketila
- [PLAY](#play) — en: Play / fi: Toista
- [PLAY_MUTE](#play_mute) — en: Playback mute / fi: Toiston vaiennus
- [PLAY_TONE](#play_tone) — en: Play tone / fi: Toista merkkiääni
- [PLAY_VOLUME](#play_volume) — en: Playback volume / fi: Toiston äänenvoimakkuus
- [POWER_SAVE](#power_save) — en: Power saving mode / fi: Virransäästötila
- [POWER_SOURCE](#power_source) — en: Power source / fi: Virtalähde
- [PRESSURE](#pressure) — en: Air pressure / fi: Ilmanpaine
- [PREVIOUS](#previous) — en: Previous / fi: Edellinen
- [PROXIMITY](#proximity) — en: Proximity / fi: Läheisyys
- [PUSH_NOTIFICATION](#push_notification) — en: Push notification / fi: Push-ilmoitus
- [RAW_MESSAGE](#raw_message) — en: Raw message / fi: Raakaviesti
- [RC_DIMMER](#rc_dimmer) — en: Remote dimmer / fi: Kauko-ohjattava himmennin
- [READ_SMS](#read_sms) — en: Receive SMS / fi: Vastaanota tekstiviesti
- [RECORD_AUDIO](#record_audio) — en: Record audio / fi: Tallenna ääntä
- [RECORD_VIDEO](#record_video) — en: Record video / fi: Tallenna videota
- [REC_MUTE](#rec_mute) — en: Recording mute / fi: Tallennuksen vaiennus
- [REC_VOLUME](#rec_volume) — en: Recording volume / fi: Tallennuksen äänenvoimakkuus
- [REMOTE_CONTROL](#remote_control) — en: Remote control / fi: Kauko-ohjain
- [ROAMING](#roaming) — en: Roaming device / fi: Roaming-laite
- [RSSI](#rssi) — en: Signal strength / fi: Signaalin voimakkuus
- [RW_VALUE](#rw_value) — en: Read/write value / fi: Luettava ja kirjoitettava arvo
- [SEEK](#seek) — en: Seek / fi: Siirry kohtaan
- [SELF_MOTION](#self_motion) — en: Self motion / fi: Laitteen oma liike
- [SEND_SMS](#send_sms) — en: Send SMS / fi: Lähetä tekstiviesti
- [SETPOINT_TEMPERATURE](#setpoint_temperature) — en: Temperature setpoint / fi: Lämpötilan asetusarvo
- [SHUTTER](#shutter) — en: Covering control / fi: Verho-ohjaus
- [SIGNAL](#signal) — en: Signal / fi: Signaali
- [SIM_PIN](#sim_pin) — en: SIM card / fi: SIM-kortti
- [SIREN](#siren) — en: Siren / fi: Sireeni
- [SMOKE](#smoke) — en: Smoke alarm / fi: Palovaroitin
- [STARTUP_VALS](#startup_vals) — en: Startup values / fi: Käynnistysarvot
- [STATE_MACHINE](#state_machine) — en: State machine / fi: Tilakone
- [STOP](#stop) — en: Stop / fi: Pysäytä
- [TEMPERATURE](#temperature) — en: Temperature / fi: Lämpötila
- [TILT](#tilt) — en: Tilt angle / fi: Kallistuskulma
- [TRANSITION](#transition) — en: Transition time / fi: Siirtymäaika
- [TREBLE](#treble) — en: Treble / fi: Diskantti
- [TWILIGHT](#twilight) — en: Twilight / fi: Hämärä
- [UPGRADE](#upgrade) — en: Firmware upgrade / fi: Laiteohjelmiston päivitys
- [USER_PRESENCE](#user_presence) — en: User presence / fi: Käyttäjän läsnäolo
- [VALVE](#valve) — en: Valve opening / fi: Venttiilin avaus
- [VOC](#voc) — en: VOC concentration / fi: VOC-pitoisuus
- [VOICE_CALL](#voice_call) — en: Voice call / fi: Äänipuhelu
- [VOICE_CALL_AUTOANSWER](#voice_call_autoanswer) — en: Automatic call answer / fi: Puhelun automaattivastaus
- [VOLUME](#volume) — en: Volume / fi: Äänenvoimakkuus
- [VU](#vu) — en: Ventilation unit / fi: Ilmanvaihtokone
- [VU_FN_FIREPLACE](#vu_fn_fireplace) — en: Fireplace function / fi: Takkatoiminto
- [WEARABLE](#wearable) — en: Wearable / fi: Puettava laite
- [ZGB](#zgb) — en: Zigbee / fi: Zigbee
- [ZW](#zw) — en: Z-Wave / fi: Z-Wave

## ACTIVE_CURRENT

**Current**

**en:** Current / **fi:** Virta

**en:** Electric current consumption in amperes. / **fi:** Sähkövirran kulutus ampeereina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `activeCurrent` | **en:** Current / **fi:** Virta | `number` | ✅ | — | — | **en:** A / **fi:** A | 2 decimals |  |  |

## ACTIVE_POWER

**Power**

**en:** Power / **fi:** Teho

**en:** Current power consumption in watts. / **fi:** Hetkellinen tehonkulutus watteina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `activePower` | **en:** Power / **fi:** Teho | `number` | ✅ | — | — | **en:** W / **fi:** W | 2 decimals |  |  |

## AIRCON

**Air conditioner**

**en:** Air conditioner / **fi:** Ilmastointilaite

**en:** Air conditioner or heat pump controls and status. / **fi:** Ilmastointilaitteen tai lämpöpumpun ohjaus ja tila.

Icon: `airPump`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `mode` | **en:** Mode / **fi:** Tila | `enum` | ✅ | ✅ | — |  | one of `auto`, `dry`, `cool`, `heat`, `lowheat` |  |  |
| `fan` | **en:** Fan speed / **fi:** Puhallinnopeus | `enum` | ✅ | ✅ | — |  | one of `auto`, `min`, `norm`, `max` |  |  |
| `hswing` | **en:** Horizontal swing / **fi:** Vaakasuuntainen heilunta | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `lastCommand` | **en:** Last command time / **fi:** Viimeisin komento | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## ALERT

**Alert**

**en:** Alert / **fi:** Hälytys

**en:** Device can show or trigger an alert, such as flashing a light. / **fi:** Laite voi näyttää tai käynnistää hälytyksen, esimerkiksi vilkuttamalla valoa.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `high_priority` | **en:** High priority / **fi:** Korkea prioriteetti | `boolean` | — | ✅ | — |  |  |  |  |
| `alert_type` | **en:** Alert type / **fi:** Hälytystyyppi | `string` | — | ✅ | — |  |  |  |  |
| `flash` | **en:** Flash indicator / **fi:** Vilkuta merkkivaloa | `boolean` | — | ✅ | — |  |  |  |  |

## ANALOG_VALUE

**Analog value**

**en:** Analog value / **fi:** Analoginen arvo

**en:** Generic analog value reported by the device. / **fi:** Laitteen ilmoittama yleinen analoginen arvo.

Icon: `devices`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `value` | **en:** Value / **fi:** Arvo | `number` | ✅ | — | — |  |  |  |  |

## BACNET

**BACnet**

**en:** BACnet / **fi:** BACnet

**en:** BACnet device or point exposed through the hub. / **fi:** Hubin kautta käytettävä BACnet-laite tai -piste.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `bacnetIds` | **en:** BACnet objects / **fi:** BACnet-objektit | `object[]` | ✅ | — | — |  |  |  | **en:** BACnet object identifiers and point metadata exposed by the hub. / **fi:** Hubin kautta näkyvät BACnet-objektien tunnisteet ja pistetiedot. |
| `bacnetEnabled` | **en:** BACnet enabled / **fi:** BACnet käytössä | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `deviceId` | **en:** Device id / **fi:** Laitteen tunniste | `string` | ✅ | ✅ | — |  |  |  |  |
| `port` | **en:** Port / **fi:** Portti | `number` | ✅ | ✅ | — |  | min 0, 0 decimals |  |  |
| `broadcast` | **en:** Broadcast discovery / **fi:** Broadcast-haku | `boolean` | ✅ | ✅ | — |  |  |  |  |

## BASS

**Bass**

**en:** Bass / **fi:** Basso

**en:** Bass adjustment for a media renderer. / **fi:** Medialaitteen bassosäätö.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.bass` | **en:** Bass / **fi:** Basso | `number` | ✅ | ✅ | — |  | min -10, max 10, 0 decimals |  |  |

## BATTERY_C

**Battery charging**

**en:** Battery charging / **fi:** Akun lataus

**en:** Battery charging state reported by the device. / **fi:** Laitteen ilmoittama akun lataustila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `chargingStatus` | **en:** Charging status / **fi:** Lataustila | `enum` | — | — | — |  | one of `0`, `1`, `2` | `0`: **en:** Idle / **fi:** Valmiustila; `1`: **en:** Charging / **fi:** Latautuu; `2`: **en:** Full / **fi:** Täysi |  |

## BATTERY_U

**Battery monitor**

**en:** Battery monitor / **fi:** Pariston tila

**en:** Battery level and low-battery status reported by the device. / **fi:** Laitteen ilmoittama pariston taso ja alhaisen pariston tila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `batteryLow` | **en:** Low battery / **fi:** Paristo vähissä | `boolean` | — | — | — |  |  | `false`: **en:** OK / **fi:** OK; `true`: **en:** Low / **fi:** Matala |  |
| `batteryV` | **en:** Battery voltage / **fi:** Pariston jännite | `number` | — | — | — | **en:** V / **fi:** V | 2 decimals |  |  |

## BRIGHTNESS

**Brightness**

**en:** Brightness / **fi:** Kirkkaus

**en:** Brightness level for a light or dimmable device. / **fi:** Valon tai himmennettävän laitteen kirkkaustaso.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `brightness` | **en:** Brightness / **fi:** Kirkkaus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 1, 2 decimals |  |  |

## CLEAR_ALERT

**Clear alert**

**en:** Clear alert / **fi:** Kuittaa hälytys

**en:** Clear an alert that the device does not cancel automatically. / **fi:** Kuittaa hälytys, jota laite ei poista automaattisesti.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `clearAlert` | **en:** Clear alert / **fi:** Kuittaa hälytys | `boolean` | — | ✅ | — |  |  |  |  |
| `alarmId` | **en:** Alarm id / **fi:** Hälytyksen tunniste | `string` | — | ✅ | — |  |  |  |  |

## CO

**Carbon monoxide**

**en:** Carbon monoxide / **fi:** Häkä

**en:** Carbon monoxide concentration in parts per million. / **fi:** Häkäpitoisuus miljoonasosina.

Icon: `coSensor`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `coDetected` | **en:** Carbon monoxide detected / **fi:** Häkä havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Clear / **fi:** Ei hälytystä; `true`: **en:** Detected / **fi:** Havaittu |  |
| `coAt` | **en:** Last carbon monoxide time / **fi:** Viimeisin häkähavainto | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `coStartAt` | **en:** Carbon monoxide start time / **fi:** Häkähavainnon alkamisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## CO2

**Carbon dioxide**

**en:** Carbon dioxide / **fi:** Hiilidioksidi

**en:** Carbon dioxide concentration in parts per million. / **fi:** Hiilidioksidipitoisuus miljoonasosina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `co2Ppm` | **en:** Carbon dioxide / **fi:** Hiilidioksidi | `number` | ✅ | — | — | **en:** ppm / **fi:** ppm | 2 decimals |  |  |

## COLOR_HS

**Hue and saturation**

**en:** Hue and saturation / **fi:** Sävy ja kylläisyys

**en:** Color control using hue and saturation. / **fi:** Värin ohjaus sävyn ja kylläisyyden avulla.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `hue` | **en:** Hue / **fi:** Sävy | `number` | ✅ | ✅ | — | **en:** rad / **fi:** rad | min 0, max 6.28318531 |  |  |
| `saturation` | **en:** Saturation / **fi:** Kylläisyys | `number` | ✅ | ✅ | — |  | min 0, max 1 |  |  |
| `colorMode` | **en:** Color mode / **fi:** Väritila | `enum` | ✅ | ✅ | — |  | one of `hs`, `ct` |  |  |

## COLOR_LOOP

**Color loop**

**en:** Color loop / **fi:** Värikierto

**en:** Animated color loop support for lights. / **fi:** Valojen animoitu värikiertotoiminto.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `start` | **en:** Color loop active / **fi:** Värikierto käytössä | `boolean` | — | ✅ | — |  |  | `false`: **en:** Stop / **fi:** Pysäytä; `true`: **en:** Start / **fi:** Käynnistä |  |

## COLOR_RGB

**RGB color**

**en:** RGB color / **fi:** RGB-väri

**en:** Color control using red, green, and blue values. / **fi:** Värin ohjaus punaisen, vihreän ja sinisen arvoilla.

_No state attributes._

## COLOR_TEMP

**Color temperature**

**en:** Color temperature / **fi:** Värilämpötila

**en:** White color temperature control in kelvins. / **fi:** Valkoisen valon värilämpötilan ohjaus kelvineinä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `temperature` | **en:** Temperature / **fi:** Lämpötila | `number` | ✅ | ✅ | — | **en:** K / **fi:** K | min 0, max 1000000 |  |  |
| `minTemperature` | **en:** Minimum temperature / **fi:** Vähimmäislämpötila | `number` | ✅ | — | — | **en:** K / **fi:** K |  |  |  |
| `maxTemperature` | **en:** Maximum temperature / **fi:** Enimmäislämpötila | `number` | ✅ | — | — | **en:** K / **fi:** K |  |  |  |

## COLOR_XY

**XY color**

**en:** XY color / **fi:** XY-väri

**en:** Color control using CIE XY color coordinates. / **fi:** Värin ohjaus CIE XY -värikoordinaateilla.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `xySupported` | **en:** XY color supported / **fi:** XY-väri tuettu | `boolean` | ✅ | — | — |  |  |  |  |
| `x` | **en:** X coordinate / **fi:** X-koordinaatti | `number` | — | ✅ | — |  | min 0, max 65279 |  |  |
| `y` | **en:** Y coordinate / **fi:** Y-koordinaatti | `number` | — | ✅ | — |  | min 0, max 65279 |  |  |

## CONFIGURABLE

**Configurable**

**en:** Configurable / **fi:** Määritettävä

**en:** Device-specific settings are available. / **fi:** Laitteelle on saatavilla laitekohtaisia asetuksia.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `template` | **en:** Configuration template / **fi:** Asetusten malli | `object` | ✅ | — | — |  |  |  | **en:** Available device-specific configuration fields and validation rules. / **fi:** Saatavilla olevat laitekohtaiset asetuskentät ja validointisäännöt. |
| `parameters` | **en:** Configuration values / **fi:** Asetusarvot | `object` | ✅ | ✅ | — |  |  |  | **en:** Current device-specific configuration values. / **fi:** Nykyiset laitekohtaiset asetusarvot. |

## CONTACT

**Door/window sensor**

**en:** Door/window sensor / **fi:** Ovi- tai ikkunatunnistin

**en:** Door or window contact sensor state. / **fi:** Oven tai ikkunan kosketintunnistimen tila.

Icon: `contactSensorDoor`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `open` | **en:** Open / **fi:** Auki | `boolean` | ✅ | — | — |  |  | `false`: **en:** Closed / **fi:** Kiinni; `true`: **en:** Open / **fi:** Auki |  |
| `lastChange` | **en:** Last change / **fi:** Viimeisin muutos | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## CONTROL_LIGHT

**Light control**

**en:** Light control / **fi:** Valon ohjaus

**en:** Device can control a light. / **fi:** Laite voi ohjata valoa.

Icon: `onOff`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `brightness` | **en:** Brightness / **fi:** Kirkkaus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 1 |  |  |
| `hue` | **en:** Hue / **fi:** Sävy | `number` | ✅ | ✅ | — | **en:** rad / **fi:** rad | min 0, max 6.28318531 |  |  |
| `saturation` | **en:** Saturation / **fi:** Kylläisyys | `number` | ✅ | ✅ | — |  | min 0, max 1 |  |  |
| `temperature` | **en:** Color temperature / **fi:** Värilämpötila | `number` | ✅ | ✅ | — | **en:** K / **fi:** K | min 0, max 1000000 |  |  |
| `colorMode` | **en:** Color mode / **fi:** Väritila | `enum` | ✅ | ✅ | — |  | one of `hs`, `ct` |  |  |
| `transitionMsec` | **en:** Transition time / **fi:** Siirtymäaika | `number` | — | ✅ | — | **en:** ms / **fi:** ms | min 0 |  |  |

## CONTROL_MODE

**Control mode**

**en:** Control mode / **fi:** Ohjaustila

**en:** Selectable operating mode for the device. / **fi:** Laitteen valittava toimintatila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `mode` | **en:** Mode / **fi:** Tila | `number` | ✅ | ✅ | — |  |  |  |  |

## CONTROL_POWER

**Power control**

**en:** Power control / **fi:** Virran ohjaus

**en:** Device can control power output. / **fi:** Laite voi ohjata virransyöttöä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `lastChange` | **en:** Last change / **fi:** Viimeisin muutos | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `brightness` | **en:** Brightness / **fi:** Kirkkaus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 1 |  |  |

## CONTROL_PRESET

**Control preset**

**en:** Control preset / **fi:** Esiasetus

**en:** Selectable preset for the device. / **fi:** Laitteen valittava esiasetus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `preset` | **en:** Preset / **fi:** Esiasetus | `number` | ✅ | ✅ | — |  |  |  |  |

## CONTROL_REL_HUMIDITY

**Humidity control**

**en:** Humidity control / **fi:** Kosteuden ohjaus

**en:** Device can control relative humidity. / **fi:** Laite voi ohjata suhteellista ilmankosteutta.

_No state attributes._

## CONTROL_TEMPERATURE

**Target temperature**

**en:** Target temperature / **fi:** Tavoitelämpötila

**en:** Target temperature for heating or cooling control. / **fi:** Lämmityksen tai jäähdytyksen tavoitelämpötila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `targetTemp` | **en:** Target temperature / **fi:** Tavoitelämpötila | `number` | ✅ | ✅ | — | **en:** °C / **fi:** °C | 2 decimals |  |  |
| `heatingDemand` | **en:** Heating demand / **fi:** Lämmitystarve | `number` | ✅ | — | — | **en:** % / **fi:** % | min 0, max 1, 2 decimals |  |  |

## DETERIORATION

**Deterioration detection**

**en:** Deterioration detection / **fi:** Voinnin heikkeneminen

**en:** Healthcare sensor indication for patient deterioration. / **fi:** Hyvinvointianturin ilmoitus voinnin heikkenemisestä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `deterioration` | **en:** Deterioration detected / **fi:** Voinnin heikkeneminen havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** OK / **fi:** OK; `true`: **en:** Detected / **fi:** Havaittu |  |

## DEVICE

**Device presence**

**en:** Device presence / **fi:** Laitteen yhteys

**en:** Device connectivity status and last seen time. / **fi:** Laitteen yhteystila ja viimeisin havaintoaika.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `lastSeen` | **en:** Last seen / **fi:** Viimeksi nähty | `number` | ✅ | — | — |  |  |  |  |
| `reachable` | **en:** Reachable / **fi:** Tavoitettavissa | `boolean` | ✅ | — | — |  |  |  |  |

## DEVICE_HEALTH

**Device health**

**en:** Device health / **fi:** Laitteen kunto

**en:** Device can report health or diagnostic status. / **fi:** Laite voi ilmoittaa kunto- tai diagnostiikkatilan.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `operational` | **en:** Operational / **fi:** Toimintakunnossa | `boolean` | ✅ | — | — |  |  |  |  |
| `errors` | **en:** Errors / **fi:** Virheet | `string[]` | ✅ | — | — |  |  |  |  |
| `warnings` | **en:** Warnings / **fi:** Varoitukset | `string[]` | ✅ | — | — |  |  |  |  |
| `loads` | **en:** Load measurements / **fi:** Kuormitusmittaukset | `object[]` | ✅ | — | — |  |  |  |  |

## DIMMER

**Dimmer**

**en:** Dimmer / **fi:** Himmennin

**en:** Dimmer level or dimmer control state. / **fi:** Himmentimen taso tai ohjaustila.

Icon: `dimmerSwitch`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `step` | **en:** Dimmer step / **fi:** Himmennyksen askel | `boolean` | ✅ | — | — |  |  |  |  |
| `onoff` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Off / **fi:** Pois päältä; `true`: **en:** On / **fi:** Päällä |  |
| `transitionMsec` | **en:** Transition time / **fi:** Siirtymäaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## DIMMER_CONTROL

**Dimmer control**

**en:** Dimmer control / **fi:** Himmennysohjain

**en:** Legacy dimmer control capability. / **fi:** Vanha himmennysohjauksen ominaisuus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `step` | **en:** Dimmer step / **fi:** Himmennyksen askel | `number` | — | — | — |  |  |  |  |
| `onoff` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | — | — | — |  |  |  |  |
| `transitionMsec` | **en:** Transition time / **fi:** Siirtymäaika | `number` | — | — | — | **en:** ms / **fi:** ms |  |  |  |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | — | — | — |  |  |  |  |

## EXT_THERMOMETER

**External thermometer**

**en:** External thermometer / **fi:** Ulkoinen lämpömittari

**en:** Device needs an external temperature measurement. / **fi:** Laite tarvitsee ulkoisen lämpötilamittauksen.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `thermometer` | **en:** Thermometer device / **fi:** Lämpömittarilaite | `string` | ✅ | ✅ | — |  |  |  |  |

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `temperature` | **en:** Temperature / **fi:** Lämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |

## FAN_MODE

**Fan mode**

**en:** Fan mode / **fi:** Puhallintila

**en:** Selectable fan speed or fan operating mode. / **fi:** Valittava puhaltimen nopeus tai toimintatila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `fanMode` | **en:** Fan mode / **fi:** Puhallintila | `enum` | ✅ | ✅ | — |  | one of `0`, `1`, `2`, `3`, `4`, `5`, `6` | `0`: **en:** Off / **fi:** Pois päältä; `1`: **en:** Min / **fi:** Minimi; `2`: **en:** Low / **fi:** Matala; `3`: **en:** Normal / **fi:** Normaali; `4`: **en:** High / **fi:** Korkea; `5`: **en:** Max / **fi:** Maksimi; `6`: **en:** Auto / **fi:** Automaattinen |  |

## FLOOR_TEMP

**Floor temperature**

**en:** Floor temperature / **fi:** Lattian lämpötila

**en:** Floor temperature in degrees Celsius. / **fi:** Lattian lämpötila Celsius-asteina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `floorTemp` | **en:** Floor temperature / **fi:** Lattian lämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |

## FLOW

**Flow**

**en:** Flow / **fi:** Virtaus

**en:** Fluid flow rate reported by the device. / **fi:** Laitteen ilmoittama nesteen virtausnopeus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `flow` | **en:** Flow rate / **fi:** Virtausnopeus | `number` | ✅ | — | — | **en:** l/h / **fi:** l/h |  |  |  |

## FLOW_TEMPERATURE

**Flow temperature**

**en:** Flow temperature / **fi:** Virtauslämpötila

**en:** Water flow temperature in degrees Celsius. / **fi:** Veden virtauslämpötila Celsius-asteina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `flowTemp` | **en:** Flow temperature / **fi:** Virtauslämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |

## FLOW_VOLUME

**Flow volume**

**en:** Flow volume / **fi:** Virtaustilavuus

**en:** Total measured fluid volume. / **fi:** Mitattu kokonaisnestetilavuus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `flowVolume` | **en:** Flow volume / **fi:** Virtaustilavuus | `number` | ✅ | — | — | **en:** l / **fi:** l |  |  |  |

## FOSCAM_API

**Foscam API**

**en:** Foscam API / **fi:** Foscam-rajapinta

**en:** Foscam camera API support. / **fi:** Foscam-kamerarajapinnan tuki.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `username` | **en:** Username / **fi:** Käyttäjätunnus | `string` | ✅ | ✅ | — |  |  |  |  |
| `ip` | **en:** IP address / **fi:** IP-osoite | `string` | ✅ | — | — |  |  |  |  |
| `media_port` | **en:** Media port / **fi:** Mediaportti | `number` | ✅ | — | — |  | min 0, 0 decimals |  |  |
| `model_number` | **en:** Model number / **fi:** Mallinumero | `string` | ✅ | — | — |  |  |  |  |
| `sw_version` | **en:** Software version / **fi:** Ohjelmistoversio | `string` | ✅ | — | — |  |  |  |  |
| `fw_version` | **en:** Firmware version / **fi:** Laiteohjelmiston versio | `string` | ✅ | — | — |  |  |  |  |
| `credentialStatus` | **en:** Credential status / **fi:** Kirjautumistietojen tila | `enum` | ✅ | — | — |  | one of `OK`, `INSUFFICIENT`, `DEFAULT`, `ERROR` |  |  |
| `medias` | **en:** Media profiles / **fi:** Mediaprofiilit | `object[]` | ✅ | — | — |  |  |  |  |

## GENERATE_ALERT

**Generate alert**

**en:** Generate alert / **fi:** Luo hälytys

**en:** Device can generate an alert event. / **fi:** Laite voi luoda hälytystapahtuman.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `alert` | **en:** Alert active / **fi:** Hälytys aktiivinen | `boolean` | — | — | — |  |  | `false`: **en:** Clear / **fi:** Ei hälytystä; `true`: **en:** Active / **fi:** Aktiivinen |  |
| `alertAt` | **en:** Alert time / **fi:** Hälytysaika | `number` | — | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `alertStartAt` | **en:** Alert start time / **fi:** Hälytyksen alkamisaika | `number` | — | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## G_ALARM

**Generic alarm**

**en:** Generic alarm / **fi:** Yleinen hälytys

**en:** Generic alarm state and alarm event details. / **fi:** Yleinen hälytystila ja halytystapahtuman tiedot.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `gAlarm` | **en:** Alarm active / **fi:** Hälytys aktiivinen | `boolean` | — | — | — |  |  | `false`: **en:** Clear / **fi:** Ei hälytystä; `true`: **en:** Active / **fi:** Aktiivinen |  |
| `gAlarmId` | **en:** Alarm id / **fi:** Hälytyksen tunniste | `string` | — | — | — |  |  |  |  |
| `gAlarmAt` | **en:** Alarm time / **fi:** Hälytysaika | `number` | — | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `gAlarmCode` | **en:** Alarm code / **fi:** Hälytyskoodi | `string` | — | — | — |  |  |  |  |
| `gAlarmMsg` | **en:** Alarm message / **fi:** Hälytysviesti | `string` | — | — | — |  |  |  |  |

## HEXC_PRIMARY_TEMPERATURES

**Heat exchanger primary temperatures**

**en:** Heat exchanger primary temperatures / **fi:** Lämmönvaihtimen ensiöpuolen lämpötilat

**en:** Temperatures on the energy provider side of a heat exchanger. / **fi:** Lämmönvaihtimen energiantoimittajan puolen lämpötilat.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `hexcPrimaryInTemperature` | **en:** Primary inlet temperature / **fi:** Ensiöpuolen tulolämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | min -273.15, max 5600, 2 decimals |  |  |
| `hexcPrimaryOutTemperature` | **en:** Primary outlet temperature / **fi:** Ensiöpuolen lähtölämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | min -273.15, max 5600, 2 decimals |  |  |

## HEXC_SECONDARY_TEMPERATURES

**Heat exchanger secondary temperatures**

**en:** Heat exchanger secondary temperatures / **fi:** Lämmönvaihtimen toisiopuolen lämpötilat

**en:** Temperatures on the building side of a heat exchanger. / **fi:** Lämmönvaihtimen kiinteistön puolen lämpötilat.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `hexcSecondaryInTemperature` | **en:** Secondary inlet temperature / **fi:** Toisiopuolen tulolämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | min -273.15, max 5600, 2 decimals |  |  |
| `hexcSecondaryOutTemperature` | **en:** Secondary outlet temperature / **fi:** Toisiopuolen lähtölämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | min -273.15, max 5600, 2 decimals |  |  |

## HIGH_TEMP

**High temperature alarm**

**en:** High temperature alarm / **fi:** Korkean lämpötilan hälytys

**en:** Indicates that the measured temperature is too high. / **fi:** Ilmoittaa, että mitattu lämpötila on liian korkea.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `highTemp` | **en:** High temperature / **fi:** Korkea lämpötila | `boolean` | ✅ | — | — |  |  | `false`: **en:** Normal / **fi:** Normaali; `true`: **en:** High / **fi:** Korkea |  |
| `highTempAt` | **en:** High temperature time / **fi:** Korkean lämpötilan aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## HOME_SWITCH

**Home/Away switch**

**en:** Home/Away switch / **fi:** Kotona/poissa-kytkin

**en:** Home/Away mode switch for remote controls and wall switches. / **fi:** Koti-/poissa-tilan kytkin kauko-ohjaimille ja seinäkytkimille.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `homeSwitchMode` | **en:** Home/Away mode / **fi:** Kotona/poissa-tila | `boolean` | ✅ | ✅ | — |  |  |  |  |

## HUE_SWITCH

**Hue switch**

**en:** Hue switch / **fi:** Hue-kytkin

**en:** Philips Hue switch specific capability. / **fi:** Philips Hue -kytkimen laitekohtainen ominaisuus.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `buttons` | **en:** Buttons / **fi:** Painikkeet | `object[]` | ✅ | — | — |  |  |  |  |

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `button` | **en:** Button / **fi:** Painike | `number` | — | — | — |  | min 1, max 4 |  |  |
| `modifiers` | **en:** Button modifiers / **fi:** Painikkeen lisämääreet | `string[]` | — | — | — |  | one of `longpress`, `stop`, `full_on`, `toggle` |  |  |

## HUMIDITY

**Humidity**

**en:** Humidity / **fi:** Ilmankosteus

**en:** Relative humidity in percent. / **fi:** Suhteellinen ilmankosteus prosentteina.

Icon: `humiditySensor`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `humidity` | **en:** Humidity / **fi:** Ilmankosteus | `number` | ✅ | — | — | **en:** % / **fi:** % | 2 decimals |  |  |

## HYPOTERMIA

**Hypothermia detection**

**en:** Hypothermia detection / **fi:** Alilämpöisyyden tunnistus

**en:** Healthcare sensor indication for hypothermia. / **fi:** Hyvinvointianturin ilmoitus alilämpöisyydestä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `lowTemp` | **en:** Low temperature / **fi:** Matala lämpötila | `boolean` | ✅ | — | — |  |  | `false`: **en:** Normal / **fi:** Normaali; `true`: **en:** Low / **fi:** Matala |  |
| `lowTempAt` | **en:** Low temperature time / **fi:** Matalan lämpötilan aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## IAS_ACE

**Alarm keypad**

**en:** Alarm keypad / **fi:** Hälytysnäppäimistö

**en:** Zigbee IAS ACE alarm keypad commands. / **fi:** Zigbee IAS ACE -hälytysnäppäimistön komennot.

Icon: `keyfob`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `command` | **en:** Command / **fi:** Komento | `enum` | — | — | — |  | one of `disarm`, `arm_day`, `arm_night`, `arm_away`, `emergency`, `panic`, `fire` |  |  |

## IDENTIFY

**Identify device**

**en:** Identify device / **fi:** Tunnista laite

**en:** Device can identify itself, for example by blinking or sounding. / **fi:** Laite voi tunnistaa itsensä esimerkiksi vilkkumalla tai äänellä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `stop` | **en:** Stop identifying / **fi:** Lopeta tunnistus | `boolean` | — | ✅ | — |  |  |  |  |

## IKEA_ONOFF_SWITCH

**IKEA on/off switch**

**en:** IKEA on/off switch / **fi:** IKEA on/off -kytkin

**en:** IKEA on/off switch specific capability. / **fi:** IKEA on/off -kytkimen laitekohtainen ominaisuus.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `buttons` | **en:** Buttons / **fi:** Painikkeet | `object[]` | ✅ | — | — |  |  |  |  |

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `button` | **en:** Button / **fi:** Painike | `number` | — | — | — |  | min 1, max 2 |  |  |
| `modifiers` | **en:** Button modifiers / **fi:** Painikkeen lisämääreet | `string[]` | — | — | — |  | one of `longpress`, `stop` |  |  |

## IKEA_RC

**IKEA remote control**

**en:** IKEA remote control / **fi:** IKEA-kauko-ohjain

**en:** IKEA remote control specific capability. / **fi:** IKEA-kauko-ohjaimen laitekohtainen ominaisuus.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `buttons` | **en:** Buttons / **fi:** Painikkeet | `object[]` | ✅ | — | — |  |  |  |  |

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `button` | **en:** Button / **fi:** Painike | `number` | — | — | — |  | min 1, max 6 |  |  |
| `modifiers` | **en:** Button modifiers / **fi:** Painikkeen lisämääreet | `string[]` | — | — | — |  | one of `longpress`, `stop`, `full_on`, `toggle` |  |  |

## KNX_AWAY_SWITCH

**KNX away switch**

**en:** KNX away switch / **fi:** KNX poissa -kytkin

**en:** KNX Home/Away switch, for example via MQTT. / **fi:** KNX-koti-/poissa-kytkin, esimerkiksi MQTT:n kautta.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Home / **fi:** Kotona; `true`: **en:** Away / **fi:** Poissa |  |

## LIFT

**Lift position**

**en:** Lift position / **fi:** Nostoasento

**en:** Curtain, blind, or covering lift position. / **fi:** Verhon, kaihtimen tai peitteen nostoasento.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `liftPct` | **en:** Lift position / **fi:** Nostoasento | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100 |  |  |

## LIVE_FEED

**Live feed**

**en:** Live feed / **fi:** Suora kuva

**en:** Camera live feed state and connection information. / **fi:** Kameran suoran kuvan tila ja yhteystiedot.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `media` | **en:** Media profile / **fi:** Mediaprofiili | `string` | ✅ | ✅ | — |  |  |  |  |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `viewerCount` | **en:** Viewer count / **fi:** Katsojien määrä | `number` | ✅ | — | — |  | min 0, 0 decimals |  |  |
| `connectionState` | **en:** Connection state / **fi:** Yhteyden tila | `enum` | ✅ | — | — |  | one of `OK`, `DEGRADED`, `LOST` |  |  |

## LOUDNESS

**Loudness**

**en:** Loudness / **fi:** Loudness-korostus

**en:** Loudness adjustment for a media renderer. / **fi:** Medialaitteen loudness-korostuksen säätö.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.loudness` | **en:** Loudness / **fi:** Loudness-korostus | `boolean` | ✅ | ✅ | — |  |  |  |  |

## LOW_TEMP

**Low temperature alarm**

**en:** Low temperature alarm / **fi:** Matalan lämpötilan hälytys

**en:** Indicates that the measured temperature is too low. / **fi:** Ilmoittaa, että mitattu lämpötila on liian matala.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `lowTemp` | **en:** Low temperature / **fi:** Matala lämpötila | `boolean` | ✅ | — | — |  |  | `false`: **en:** Normal / **fi:** Normaali; `true`: **en:** Low / **fi:** Matala |  |
| `lowTempAt` | **en:** Low temperature time / **fi:** Matalan lämpötilan aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## LUX

**Light level**

**en:** Light level / **fi:** Valoisuus

**en:** Ambient light level reported by the sensor. / **fi:** Anturin ilmoittama ympäristön valoisuuden taso.

Icon: `dimmer`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `lux` | **en:** Light level / **fi:** Valoisuustaso | `number` | ✅ | — | — | **en:** lux / **fi:** lux |  |  |  |

## MEASURE_POWER

**Energy**

**en:** Energy / **fi:** Energia

**en:** Consumed energy in kilowatt-hours. / **fi:** Kulutettu energia kilowattitunteina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `totalPower` | **en:** Total energy / **fi:** Kokonaisenergia | `number` | ✅ | — | — | **en:** kWh / **fi:** kWh | 2 decimals |  |  |
| `powerToday` | **en:** Energy today / **fi:** Energia tänään | `number` | ✅ | — | — | **en:** kWh / **fi:** kWh | 2 decimals |  |  |
| `powerYesterday` | **en:** Energy yesterday / **fi:** Energia eilen | `number` | ✅ | — | — | **en:** kWh / **fi:** kWh | 2 decimals |  |  |

## MOISTURE

**Moisture**

**en:** Moisture / **fi:** Kosteus

**en:** Moisture or water leak sensing state. / **fi:** Kosteuden tai vesivuodon tunnistustila.

Icon: `floodSensor`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `moisture` | **en:** Moisture detected / **fi:** Kosteus havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Dry / **fi:** Kuiva; `true`: **en:** Detected / **fi:** Havaittu |  |
| `moistureAt` | **en:** Moisture time / **fi:** Kosteushavainnon aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## MOTION

**Motion**

**en:** Motion / **fi:** Liike

**en:** Motion sensing state. / **fi:** Liikkeentunnistuksen tila.

Icon: `motionDetector`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `motion` | **en:** Motion detected / **fi:** Liike havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** No motion / **fi:** Ei liikettä; `true`: **en:** Motion / **fi:** Liikettä |  |
| `lastMotion` | **en:** Last motion time / **fi:** Viimeisin liike | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## MUTE

**Mute**

**en:** Mute / **fi:** Vaiennus

**en:** Mute control for a media renderer. / **fi:** Medialaitteen vaiennuksen ohjaus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.mute` | **en:** Mute / **fi:** Vaiennus | `boolean` | ✅ | ✅ | — |  |  |  |  |

## NEXT

**Next**

**en:** Next / **fi:** Seuraava

**en:** Move to the next media item. / **fi:** Siirry seuraavaan mediasisältöön.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `next` | **en:** Next item / **fi:** Seuraava kohde | `boolean` | — | ✅ | — |  |  |  |  |

## ONVIF_API

**ONVIF API**

**en:** ONVIF API / **fi:** ONVIF-rajapinta

**en:** ONVIF camera API support. / **fi:** ONVIF-kamerarajapinnan tuki.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `username` | **en:** Username / **fi:** Käyttäjätunnus | `string` | ✅ | ✅ | — |  |  |  |  |
| `cameraId` | **en:** Camera id / **fi:** Kameran tunniste | `string` | ✅ | — | — |  |  |  |  |
| `medias` | **en:** Media profiles / **fi:** Mediaprofiilit | `object[]` | ✅ | — | — |  |  |  | **en:** Available ONVIF media profiles with token, resolution, bitrate and framerate metadata. / **fi:** Saatavilla olevat ONVIF-mediaprofiilit, joissa on tunniste, resoluutio, bittinopeus ja kuvataajuus. |
| `credentialStatus` | **en:** Credential status / **fi:** Kirjautumistietojen tila | `enum` | ✅ | — | — |  | one of `OK`, `INSUFFICIENT`, `DEFAULT`, `ERROR` | `DEFAULT`: **en:** Default credentials / **fi:** Oletuskirjautumistiedot; `ERROR`: **en:** Credential error / **fi:** Kirjautumistietojen virhe; `INSUFFICIENT`: **en:** Insufficient rights / **fi:** Riittämättömät oikeudet; `OK`: **en:** OK / **fi:** OK |  |

## ON_OFF

**On/off**

**en:** On/off / **fi:** Päälle/pois

**en:** Device can be switched on and off. / **fi:** Laite voidaan kytkeä päälle ja pois.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Off / **fi:** Pois päältä; `true`: **en:** On / **fi:** Päällä |  |

## PASSIVITY

**Passivity detection**

**en:** Passivity detection / **fi:** Passiivisuuden tunnistus

**en:** Healthcare sensor indication for passivity. / **fi:** Hyvinvointianturin ilmoitus passiivisuudesta.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `passive` | **en:** Passivity detected / **fi:** Passiivisuus havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Active / **fi:** Aktiivinen; `true`: **en:** Passive / **fi:** Passiivinen |  |
| `passiveAt` | **en:** Passivity time / **fi:** Passiivisuuden aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## PAUSE

**Pause**

**en:** Pause / **fi:** Tauko

**en:** Pause media playback. / **fi:** Keskeytä median toisto.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** Playback active / **fi:** Toisto käynnissä | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Paused / **fi:** Tauolla; `true`: **en:** Playing / **fi:** Toistaa |  |

## PHONE_MAKE_CALL

**Make phone call**

**en:** Make phone call / **fi:** Soita puhelu

**en:** Start a phone call from the hub. / **fi:** Aloita puhelu hubista.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `callToNumber` | **en:** Number to call / **fi:** Soitettava numero | `string` | — | ✅ | — |  |  |  |  |

## PHONE_RECEIVE_CALL

**Receive phone call**

**en:** Receive phone call / **fi:** Vastaanota puhelu

**en:** Receive or answer an incoming phone call. / **fi:** Vastaanota tai vastaa saapuvaan puheluun.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `callState` | **en:** Call state / **fi:** Puhelun tila | `number` | ✅ | ✅ | — |  |  |  |  |
| `callFromNumber` | **en:** Caller number / **fi:** Soittajan numero | `string` | ✅ | — | — |  |  |  |  |

## PIR_MOVE

**PIR/movement mode**

**en:** PIR/movement mode / **fi:** PIR-/liiketila

**en:** Selectable PIR or movement detection mode. / **fi:** Valittava PIR- tai liiketunnistuksen tila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `usePir` | **en:** Use PIR detection / **fi:** Käytä PIR-tunnistusta | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Movement / **fi:** Liike; `true`: **en:** PIR / **fi:** PIR |  |

## PLAY

**Play**

**en:** Play / **fi:** Toista

**en:** Media playback state and play controls. / **fi:** Median toiston tila ja toisto-ohjaus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `avtData` | **en:** Playback metadata / **fi:** Toiston metatiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `avtData.state` | **en:** Playback state / **fi:** Toiston tila | `enum` | ✅ | — | — |  | one of `PLAYING`, `TRANSITIONING`, `PAUSED_PLAYBACK`, `STOPPED` |  |  |
| `avtData.playMode` | **en:** Play mode / **fi:** Toistotila | `enum` | ✅ | ✅ | — |  | one of `NORMAL`, `REPEAT_ALL`, `SHUFFLE_NOREPEAT`, `SHUFFLE` |  |  |
| `avtData.numberOfTracks` | **en:** Track count / **fi:** Kappaleiden määrä | `number` | ✅ | — | — |  | min 0, 0 decimals |  |  |
| `avtData.currentTrack` | **en:** Current track / **fi:** Nykyinen kappale | `number` | ✅ | — | — |  | min 0, 0 decimals |  |  |
| `avtData.currentTrackDuration` | **en:** Track duration / **fi:** Kappaleen kesto | `string` | ✅ | — | — |  |  |  |  |
| `avtData.currentTrackMetadata` | **en:** Track metadata / **fi:** Kappaleen metatiedot | `object` | ✅ | — | — |  |  |  |  |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.volume` | **en:** Volume / **fi:** Äänenvoimakkuus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100, 0 decimals |  |  |
| `rcData.mute` | **en:** Mute / **fi:** Vaiennus | `boolean` | ✅ | ✅ | — |  |  |  |  |
| `rcData.bass` | **en:** Bass / **fi:** Basso | `number` | ✅ | ✅ | — |  | min -10, max 10, 0 decimals |  |  |
| `rcData.treble` | **en:** Treble / **fi:** Diskantti | `number` | ✅ | ✅ | — |  | min -10, max 10, 0 decimals |  |  |
| `rcData.loudness` | **en:** Loudness / **fi:** Loudness-korostus | `boolean` | ✅ | ✅ | — |  |  |  |  |

## PLAY_MUTE

**Playback mute**

**en:** Playback mute / **fi:** Toiston vaiennus

**en:** Mute control for playback audio. / **fi:** Toistoäänen vaiennuksen ohjaus.

Icon: `volumeX`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `playMute` | **en:** Playback muted / **fi:** Toisto vaiennettu | `boolean` | ✅ | ✅ | — |  |  |  |  |

## PLAY_TONE

**Play tone**

**en:** Play tone / **fi:** Toista merkkiääni

**en:** Play a named sound file, such as a ring tone. / **fi:** Toista nimetty äänitiedosto, kuten soittoääni.

Icon: `bellRing`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `playTone` | **en:** Tone to play / **fi:** Toistettava merkkiääni | `string` | — | ✅ | — |  |  |  |  |

## PLAY_VOLUME

**Playback volume**

**en:** Playback volume / **fi:** Toiston äänenvoimakkuus

**en:** Playback volume level. / **fi:** Toiston äänenvoimakkuuden taso.

Icon: `speaker`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `playVolume` | **en:** Playback volume / **fi:** Toiston äänenvoimakkuus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100, 0 decimals |  |  |

## POWER_SAVE

**Power saving mode**

**en:** Power saving mode / **fi:** Virransäästötila

**en:** Device-specific power saving state reported by the device. / **fi:** Laitteen ilmoittama laitekohtainen virransäästötila.

Icon: `measurePower`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `powerSave` | **en:** Power saving mode / **fi:** Virransäästötila | `enum` | ✅ | — | — |  | one of `0`, `1`, `2`, `3` | `0`: **en:** Normal / **fi:** Normaali; `1`: **en:** Pending / **fi:** Odottaa; `2`: **en:** In effect / **fi:** Käytössä; `3`: **en:** Temporarily off / **fi:** Tilapäisesti pois | **en:** Current power saving state. Pending means external power was disconnected; temporarily off means power saving is suspended for a periodic connection. / **fi:** Nykyinen virransäästötila. Odottaa tarkoittaa, että ulkoinen virta on katkaistu; tilapäisesti pois tarkoittaa, että virransäästö on keskeytetty määräaikaisen yhteyden ajaksi. |
| `powerSaveAt` | **en:** Last changed / **fi:** Viimeksi muutettu | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  | **en:** Timestamp for when the power saving state last changed. / **fi:** Aikaleima, jolloin virransäästötila viimeksi muuttui. |

## POWER_SOURCE

**Power source**

**en:** Power source / **fi:** Virtalähde

**en:** Active power source reported by the device. / **fi:** Laitteen ilmoittama käytössä oleva virtalähde.

Icon: `activePower`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `powerSource` | **en:** Power source / **fi:** Virtalähde | `enum` | ✅ | — | — |  | one of `1`, `2` | `1`: **en:** Mains power / **fi:** Verkkovirta; `2`: **en:** Battery power / **fi:** Akkuvirta |  |
| `powerSourceAt` | **en:** Last changed / **fi:** Viimeksi muutettu | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  | **en:** Timestamp for when the active power source last changed. / **fi:** Aikaleima, jolloin käytössä oleva virtalähde viimeksi muuttui. |

## PRESSURE

**Air pressure**

**en:** Air pressure / **fi:** Ilmanpaine

**en:** Air pressure reported by the device. / **fi:** Laitteen ilmoittama ilmanpaine.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `pressure` | **en:** Air pressure / **fi:** Ilmanpaine | `number` | ✅ | — | — | **en:** Pa / **fi:** Pa |  |  |  |

## PREVIOUS

**Previous**

**en:** Previous / **fi:** Edellinen

**en:** Move to the previous media item. / **fi:** Siirry edelliseen mediasisältöön.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `previous` | **en:** Previous item / **fi:** Edellinen kohde | `boolean` | — | ✅ | — |  |  |  |  |

## PROXIMITY

**Proximity**

**en:** Proximity / **fi:** Läheisyys

**en:** Whether the device is near the hub. / **fi:** Onko laite hubin lähellä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `near` | **en:** Near hub / **fi:** Hubin lähellä | `boolean` | ✅ | — | — |  |  | `false`: **en:** Far / **fi:** Kaukana; `true`: **en:** Near / **fi:** Lähellä |  |
| `nearAt` | **en:** Proximity time / **fi:** Läheisyyden aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## PUSH_NOTIFICATION

**Push notification**

**en:** Push notification / **fi:** Push-ilmoitus

**en:** Device can receive push notifications from the cloud. / **fi:** Laite voi vastaanottaa push-ilmoituksia pilvestä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `sendNotification` | **en:** Send notification / **fi:** Lähetä ilmoitus | `boolean` | — | ✅ | — |  |  |  |  |
| `msg` | **en:** Message text / **fi:** Viestin teksti | `string` | — | ✅ | — |  |  |  |  |
| `msgId` | **en:** Message id / **fi:** Viestin tunniste | `string` | — | ✅ | — |  |  |  |  |
| `sms` | **en:** Send also as SMS / **fi:** Lähetä myös tekstiviestinä | `boolean` | — | ✅ | — |  |  |  |  |

## RAW_MESSAGE

**Raw message**

**en:** Raw message / **fi:** Raakaviesti

**en:** Original raw message received from the device. / **fi:** Laitteelta vastaanotettu alkuperäinen raakaviesti.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `datagram` | **en:** Raw datagram / **fi:** Raakadatagrammi | `number[]` | — | — | — |  |  |  |  |

## RC_DIMMER

**Remote dimmer**

**en:** Remote dimmer / **fi:** Kauko-ohjattava himmennin

**en:** Remote control with dimming capability. / **fi:** Himmennykseen pystyvä kauko-ohjain.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `buttons` | **en:** Buttons / **fi:** Painikkeet | `object[]` | ✅ | — | — |  |  |  |  |

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `button` | **en:** Button / **fi:** Painike | `number` | — | — | — |  |  |  |  |
| `modifiers` | **en:** Button modifiers / **fi:** Painikkeen lisämääreet | `string[]` | — | — | — |  | one of `longpress`, `stop`, `full_on`, `toggle` |  |  |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | — | — | — |  |  |  |  |
| `step` | **en:** Dimmer step / **fi:** Himmennyksen askel | `number` | — | — | — |  |  |  |  |
| `onoff` | **en:** On/off command / **fi:** Päälle/pois-komento | `boolean` | — | — | — |  |  |  |  |
| `transitionMsec` | **en:** Transition time / **fi:** Siirtymäaika | `number` | — | — | — | **en:** ms / **fi:** ms |  |  |  |

## READ_SMS

**Receive SMS**

**en:** Receive SMS / **fi:** Vastaanota tekstiviesti

**en:** Hub can receive SMS messages. / **fi:** Hubi voi vastaanottaa tekstiviestejä.

_No state attributes._

## RECORD_AUDIO

**Record audio**

**en:** Record audio / **fi:** Tallenna ääntä

**en:** Camera audio recording support. / **fi:** Kameran äänitallennuksen tuki.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `audioParams` | **en:** Audio parameters / **fi:** Ääniparametrit | `object[]` | ✅ | — | — |  |  |  | **en:** Audio payload, encoding and format metadata for camera media profiles. / **fi:** Kameran mediaprofiilien äänen payload-, koodaus- ja formaattitiedot. |

## RECORD_VIDEO

**Record video**

**en:** Record video / **fi:** Tallenna videota

**en:** Camera video recording support. / **fi:** Kameran videotallennuksen tuki.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `recording` | **en:** Recording / **fi:** Tallennus | `boolean` | ✅ | ✅ | — |  |  |  |  |

## REC_MUTE

**Recording mute**

**en:** Recording mute / **fi:** Tallennuksen vaiennus

**en:** Mute control for recording or capture audio. / **fi:** Tallennus- tai kaappausäänen vaiennuksen ohjaus.

Icon: `micOff`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `recMute` | **en:** Recording muted / **fi:** Tallennus vaiennettu | `boolean` | ✅ | ✅ | — |  |  |  |  |

## REC_VOLUME

**Recording volume**

**en:** Recording volume / **fi:** Tallennuksen äänenvoimakkuus

**en:** Recording or capture volume level. / **fi:** Tallennuksen tai kaappauksen äänenvoimakkuuden taso.

Icon: `applianceMicro`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `recVolume` | **en:** Recording volume / **fi:** Tallennuksen äänenvoimakkuus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100, 0 decimals |  |  |

## REMOTE_CONTROL

**Remote control**

**en:** Remote control / **fi:** Kauko-ohjain

**en:** Remote control button events. / **fi:** Kauko-ohjaimen painiketapahtumat.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `button` | **en:** Button / **fi:** Painike | `number` | — | — | — |  |  |  |  |
| `modifiers` | **en:** Button modifiers / **fi:** Painikkeen lisämääreet | `string[]` | — | — | — |  | one of `longpress`, `stop`, `full_on`, `toggle` |  |  |

## ROAMING

**Roaming device**

**en:** Roaming device / **fi:** Roaming-laite

**en:** Device keeps the same identity when paired to another hub. / **fi:** Laite säilyttää saman tunnisteen, kun se liitetään toiseen hubiin.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `autoPaired` | **en:** Automatically paired / **fi:** Automaattisesti paritettu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Unpaired / **fi:** Ei paritettu; `true`: **en:** Paired / **fi:** Paritettu |  |

## RSSI

**Signal strength**

**en:** Signal strength / **fi:** Signaalin voimakkuus

**en:** Received signal strength indicator for radio communication. / **fi:** Radioviestinnän vastaanotetun signaalin voimakkuus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rssi` | **en:** Signal strength / **fi:** Signaalin voimakkuus | `number` | ✅ | — | — |  |  |  |  |

## RW_VALUE

**Read/write value**

**en:** Read/write value / **fi:** Luettava ja kirjoitettava arvo

**en:** Generic value that can be read from and written to the device. / **fi:** Yleinen arvo, jota voidaan lukea laitteelta ja kirjoittaa laitteelle.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `value` | **en:** Value / **fi:** Arvo | `number` | ✅ | ✅ | — |  |  |  |  |

## SEEK

**Seek**

**en:** Seek / **fi:** Siirry kohtaan

**en:** Seek within media playback. / **fi:** Siirry kohtaan median toistossa.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `trackNumber` | **en:** Track number / **fi:** Kappalenumero | `number` | — | ✅ | — |  | min 1, 0 decimals |  |  |

## SELF_MOTION

**Self motion**

**en:** Self motion / **fi:** Laitteen oma liike

**en:** Device detects its own movement. / **fi:** Laite tunnistaa oman liikkeensä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `selfMotion` | **en:** Self motion detected / **fi:** Laitteen oma liike havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Still / **fi:** Paikallaan; `true`: **en:** Motion / **fi:** Liikettä |  |
| `lastSelfMotion` | **en:** Last self motion time / **fi:** Viimeisin oma liike | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## SEND_SMS

**Send SMS**

**en:** Send SMS / **fi:** Lähetä tekstiviesti

**en:** Hub can send SMS messages. / **fi:** Hubi voi lähettää tekstiviestejä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `sendSms` | **en:** Send SMS / **fi:** Lähetä tekstiviesti | `boolean` | — | ✅ | — |  |  |  |  |
| `msg` | **en:** Message text / **fi:** Viestin teksti | `string` | — | ✅ | — |  |  |  |  |
| `msgId` | **en:** Message id / **fi:** Viestin tunniste | `string` | — | ✅ | — |  |  |  |  |
| `extraSms` | **en:** Additional recipients / **fi:** Lisävastaanottajat | `string[]` | — | ✅ | — |  |  |  |  |

## SETPOINT_TEMPERATURE

**Temperature setpoint**

**en:** Temperature setpoint / **fi:** Lämpötilan asetusarvo

**en:** Temperature setpoint value and timestamp. / **fi:** Lämpötilan asetusarvo ja asetuksen ajankohta.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `setpointTemp` | **en:** Temperature setpoint / **fi:** Lämpötilan asetusarvo | `number` | ✅ | ✅ | — | **en:** °C / **fi:** °C | 2 decimals |  |  |
| `setpointTempAt` | **en:** Setpoint time / **fi:** Asetusarvon aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## SHUTTER

**Covering control**

**en:** Covering control / **fi:** Verho-ohjaus

**en:** Curtain, blind, shutter, or covering control. / **fi:** Verhon, kaihtimen, rullaoven tai muun peitteen ohjaus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `motorStatus` | **en:** Motor status / **fi:** Moottorin tila | `enum` | ✅ | — | — |  | one of `-1`, `0`, `1` | `-1`: **en:** Down / **fi:** Alas; `0`: **en:** Stopped / **fi:** Pysähtynyt; `1`: **en:** Up / **fi:** Ylös |  |
| `calibrating` | **en:** Calibrating / **fi:** Kalibrointi | `boolean` | ✅ | — | — |  |  |  |  |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  |  |  |

## SIGNAL

**Signal**

**en:** Signal / **fi:** Signaali

**en:** Generic signal value, for example a BACnet binary value. / **fi:** Yleinen signaaliarvo, esimerkiksi BACnet-binääriarvo.

Icon: `power`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `isOn` | **en:** On/off state / **fi:** Päälle/pois-tila | `boolean` | ✅ | ✅ | — |  |  | `false`: **en:** Off / **fi:** Pois päältä; `true`: **en:** On / **fi:** Päällä |  |

## SIM_PIN

**SIM card**

**en:** SIM card / **fi:** SIM-kortti

**en:** SIM card status and PIN/PUK/APN configuration. / **fi:** SIM-kortin tila sekä PIN-, PUK- ja APN-asetukset.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `simStatus` | **en:** SIM status / **fi:** SIM-kortin tila | `enum` | ✅ | — | — |  | one of `0`, `1`, `2`, `3`, `4`, `10`, `11` |  |  |
| `pinAttempts` | **en:** PIN attempts left / **fi:** PIN-yrityksiä jäljellä | `number` | ✅ | — | — |  |  |  |  |
| `pukAttempts` | **en:** PUK attempts left / **fi:** PUK-yrityksiä jäljellä | `number` | ✅ | — | — |  |  |  |  |
| `pin` | **en:** PIN code / **fi:** PIN-koodi | `string` | — | ✅ | — |  |  |  |  |
| `puk` | **en:** PUK code / **fi:** PUK-koodi | `string` | — | ✅ | — |  |  |  |  |
| `apn` | **en:** APN / **fi:** APN | `string` | — | ✅ | — |  |  |  |  |

## SIREN

**Siren**

**en:** Siren / **fi:** Sireeni

**en:** Siren or warning sound control. / **fi:** Sireenin tai varoitusäänen ohjaus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `sirenOn` | **en:** Siren on / **fi:** Sireeni päällä | `boolean` | ✅ | — | — |  |  | `false`: **en:** Off / **fi:** Pois päältä; `true`: **en:** On / **fi:** Päällä |  |
| `sirenAt` | **en:** Siren time / **fi:** Sireenin aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `sirenStartAt` | **en:** Siren start time / **fi:** Sireenin alkamisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `mutedForMs` | **en:** Muted duration / **fi:** Vaiennuksen kesto | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## SMOKE

**Smoke alarm**

**en:** Smoke alarm / **fi:** Palovaroitin

**en:** Smoke or fire alarm sensing state. / **fi:** Savu- tai palohälytyksen tunnistustila.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `alert` | **en:** Alert active / **fi:** Hälytys aktiivinen | `boolean` | ✅ | — | — |  |  | `false`: **en:** Clear / **fi:** Ei hälytystä; `true`: **en:** Smoke / **fi:** Savua |  |
| `alertAt` | **en:** Alert time / **fi:** Hälytysaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `alertStartAt` | **en:** Alert start time / **fi:** Hälytyksen alkamisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## STARTUP_VALS

**Startup values**

**en:** Startup values / **fi:** Käynnistysarvot

**en:** Device can restore previous settings after a power cycle. / **fi:** Laite voi palauttaa aiemmat asetukset virtakatkon jälkeen.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `enable` | **en:** Restore startup values / **fi:** Palauta käynnistysarvot | `boolean` | — | ✅ | — |  |  |  |  |

## STATE_MACHINE

**State machine**

**en:** State machine / **fi:** Tilakone

**en:** Device has multiple possible named states. / **fi:** Laitteella on useita mahdollisia nimettyjä tiloja.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `currentState` | **en:** Current state / **fi:** Nykyinen tila | `number` | ✅ | ✅ | — |  |  |  |  |
| `currentStateAt` | **en:** Current state time / **fi:** Nykyisen tilan aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## STOP

**Stop**

**en:** Stop / **fi:** Pysäytä

**en:** Stop media playback. / **fi:** Pysäytä median toisto.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `state` | **en:** Playback state / **fi:** Toiston tila | `enum` | ✅ | — | — |  | one of `PLAYING`, `TRANSITIONING`, `PAUSED_PLAYBACK`, `STOPPED` | `PAUSED_PLAYBACK`: **en:** Paused / **fi:** Tauolla; `PLAYING`: **en:** Playing / **fi:** Toistaa; `STOPPED`: **en:** Stopped / **fi:** Pysähtynyt; `TRANSITIONING`: **en:** Transitioning / **fi:** Siirtymässä |  |

## TEMPERATURE

**Temperature**

**en:** Temperature / **fi:** Lämpötila

**en:** Temperature in degrees Celsius. / **fi:** Lämpötila Celsius-asteina.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `temperature` | **en:** Temperature / **fi:** Lämpötila | `number` | ✅ | — | ✅ | **en:** °C / **fi:** °C | min -273.15, max 5600, 2 decimals |  |  |

## TILT

**Tilt angle**

**en:** Tilt angle / **fi:** Kallistuskulma

**en:** Curtain, blind, or covering tilt angle. / **fi:** Verhon, kaihtimen tai peitteen kallistuskulma.

Icon: `shadeStillDown`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `tiltPct` | **en:** Tilt angle / **fi:** Kallistuskulma | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100 |  |  |

## TRANSITION

**Transition time**

**en:** Transition time / **fi:** Siirtymäaika

**en:** Transition time for executing a light state change. / **fi:** Valon tilamuutoksen suorittamiseen käytettävä siirtymäaika.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `transitionMsec` | **en:** Transition time / **fi:** Siirtymäaika | `number` | — | ✅ | — | **en:** ms / **fi:** ms | min 0 |  |  |

## TREBLE

**Treble**

**en:** Treble / **fi:** Diskantti

**en:** Treble adjustment for a media renderer. / **fi:** Medialaitteen diskanttisäätö.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.treble` | **en:** Treble / **fi:** Diskantti | `number` | ✅ | ✅ | — |  | min -10, max 10, 0 decimals |  |  |

## TWILIGHT

**Twilight**

**en:** Twilight / **fi:** Hämärä

**en:** Whether the sensor detects darkness or twilight. / **fi:** Tunnistaako anturi hämärän tai pimeyden.

Icon: `twilightSensor`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `twilight` | **en:** Twilight detected / **fi:** Hämärä havaittu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Light / **fi:** Valoisaa; `true`: **en:** Dark / **fi:** Pimeä |  |
| `twilightStart` | **en:** Twilight start time / **fi:** Hämärän alkamisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `twilightStop` | **en:** Twilight stop time / **fi:** Hämärän päättymisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `twilightThreshold` | **en:** Twilight threshold / **fi:** Hämärän raja-arvo | `number` | ✅ | — | — | **en:** Lux / **fi:** Lux |  |  |  |

## UPGRADE

**Firmware upgrade**

**en:** Firmware upgrade / **fi:** Laiteohjelmiston päivitys

**en:** Device supports firmware upgrade. / **fi:** Laite tukee laiteohjelmiston päivitystä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `upgradeStatus` | **en:** Upgrade status / **fi:** Päivityksen tila | `enum` | ✅ | — | — |  | one of `OK`, `AVAILABLE`, `ENQUEUED`, `RUNNING`, `BOOTING` | `AVAILABLE`: **en:** Available / **fi:** Saatavilla; `BOOTING`: **en:** Booting / **fi:** Käynnistyy; `ENQUEUED`: **en:** Queued / **fi:** Jonossa; `OK`: **en:** Up to date / **fi:** Ajan tasalla; `RUNNING`: **en:** Running / **fi:** Käynnissä |  |

## USER_PRESENCE

**User presence**

**en:** User presence / **fi:** Käyttäjän läsnäolo

**en:** Device can report user presence. / **fi:** Laite voi ilmoittaa käyttäjän läsnäolon.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `reachable` | **en:** Reachable / **fi:** Tavoitettavissa | `boolean` | ✅ | — | — |  |  |  |  |

## VALVE

**Valve opening**

**en:** Valve opening / **fi:** Venttiilin avaus

**en:** Opening percentage for a controllable valve. / **fi:** Ohjattavan venttiilin avausprosentti.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `openPct` | **en:** Opening / **fi:** Avaus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 1, 2 decimals |  |  |
| `openPctAt` | **en:** Opening time / **fi:** Avauksen aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## VOC

**VOC concentration**

**en:** VOC concentration / **fi:** VOC-pitoisuus

**en:** Volatile organic compound concentration. / **fi:** Haihtuvien orgaanisten yhdisteiden pitoisuus.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `vocPpm` | **en:** VOC concentration / **fi:** VOC-pitoisuus | `number` | ✅ | — | — | **en:** ppm / **fi:** ppm |  |  |  |

## VOICE_CALL

**Voice call**

**en:** Voice call / **fi:** Äänipuhelu

**en:** Voice call status and call timing information. / **fi:** Äänipuhelun tila ja ajoitustiedot.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `callState` | **en:** Call state / **fi:** Puhelun tila | `enum` | ✅ | — | — |  | one of `1`, `2`, `3`, `4`, `5` |  |  |
| `callToNumber` | **en:** Number to call / **fi:** Soitettava numero | `string` | ✅ | — | — |  |  |  |  |
| `callFromNumber` | **en:** Caller number / **fi:** Soittajan numero | `string` | ✅ | — | — |  |  |  |  |
| `callAt` | **en:** Call start time / **fi:** Puhelun alkamisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `callStopAt` | **en:** Call end time / **fi:** Puhelun päättymisaika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |
| `callIncoming` | **en:** Incoming call / **fi:** Saapuva puhelu | `boolean` | ✅ | — | — |  |  | `false`: **en:** Idle / **fi:** Valmiustila; `true`: **en:** Incoming / **fi:** Saapuva |  |

## VOICE_CALL_AUTOANSWER

**Automatic call answer**

**en:** Automatic call answer / **fi:** Puhelun automaattivastaus

**en:** Automatic voice call answering settings. / **fi:** Äänipuheluiden automaattisen vastaamisen asetukset.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `callAutoAnswerFrom` | **en:** Allowed callers / **fi:** Sallitut soittajat | `string[]` | ✅ | ✅ | — |  |  |  |  |
| `callAutoAnswerUntil` | **en:** Auto-answer until / **fi:** Automaattivastaus päättyy | `number` | ✅ | ✅ | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## VOLUME

**Volume**

**en:** Volume / **fi:** Äänenvoimakkuus

**en:** Output volume level. / **fi:** Ulostulon äänenvoimakkuuden taso.

Icon: `stereoSpeakers`

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `rcData` | **en:** Rendering control data / **fi:** Toiston säätötiedot | `object` | ✅ | ✅ | — |  |  |  |  |
| `rcData.volume` | **en:** Volume / **fi:** Äänenvoimakkuus | `number` | ✅ | ✅ | — | **en:** % / **fi:** % | min 0, max 100, 0 decimals |  |  |

## VU

**Ventilation unit**

**en:** Ventilation unit / **fi:** Ilmanvaihtokone

**en:** Ventilation unit mode and indoor-air measurements. / **fi:** Ilmanvaihtokoneen tila ja sisäilman mittaukset.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `mode` | **en:** Mode / **fi:** Tila | `enum` | ✅ | ✅ | — |  | one of `0`, `1`, `2`, `3`, `4` | `0`: **en:** Stopped / **fi:** Pysähtynyt; `1`: **en:** Traveling / **fi:** Matkoilla; `2`: **en:** Away / **fi:** Poissa; `3`: **en:** Home / **fi:** Kotona; `4`: **en:** Boost / **fi:** Tehostus |  |
| `freshTemperature` | **en:** Outdoor air temperature / **fi:** Ulkoilman lämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |
| `supplyTemperature` | **en:** Supply air temperature / **fi:** Tuloilman lämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |
| `extractTemperature` | **en:** Extract air temperature / **fi:** Poistoilman lämpötila | `number` | ✅ | — | — | **en:** °C / **fi:** °C | 2 decimals |  |  |
| `humidity` | **en:** Humidity / **fi:** Ilmankosteus | `number` | ✅ | — | — | **en:** % / **fi:** % | min 0, max 100 |  |  |
| `co2Ppm` | **en:** Carbon dioxide / **fi:** Hiilidioksidi | `number` | ✅ | — | — | **en:** ppm / **fi:** ppm |  |  |  |
| `vocPpm` | **en:** VOC concentration / **fi:** VOC-pitoisuus | `number` | ✅ | — | — | **en:** ppm / **fi:** ppm |  |  |  |

## VU_FN_FIREPLACE

**Fireplace function**

**en:** Fireplace function / **fi:** Takkatoiminto

**en:** Ventilation function that increases indoor air pressure while a fireplace is burning. / **fi:** Ilmanvaihdon toiminto, joka kasvattaa sisäilman painetta takan käytön aikana.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `fn_fireplace` | **en:** Fn_fireplace / **fi:** Fn_fireplace | `boolean` | ✅ | ✅ | — |  |  |  |  |

## WEARABLE

**Wearable**

**en:** Wearable / **fi:** Puettava laite

**en:** Whether a wearable device is currently worn. / **fi:** Onko puettava laite parhaillaan käytössä.

### State

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `worn` | **en:** Worn / **fi:** Käytössä | `boolean` | ✅ | — | — |  |  | `false`: **en:** Not worn / **fi:** Ei käytössä; `true`: **en:** Worn / **fi:** Käytössä |  |
| `wornAt` | **en:** Wear state time / **fi:** Käyttötilan aika | `number` | ✅ | — | — | **en:** ms / **fi:** ms | 0 decimals |  |  |

## ZGB

**Zigbee**

**en:** Zigbee / **fi:** Zigbee

**en:** Zigbee device capability. / **fi:** Zigbee-laitteen ominaisuus.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `nodedesc` | **en:** Node descriptor / **fi:** Solmun kuvaus | `object` | ✅ | — | — |  |  |  |  |
| `endpoints` | **en:** Endpoints / **fi:** Päätepisteet | `object` | ✅ | — | — |  |  |  |  |
| `eui64` | **en:** EUI-64 address / **fi:** EUI-64-osoite | `string` | ✅ | — | — |  |  |  |  |
| `nwk_addr` | **en:** Network address / **fi:** Verkko-osoite | `string` | ✅ | — | — |  |  |  |  |

## ZW

**Z-Wave**

**en:** Z-Wave / **fi:** Z-Wave

**en:** Z-Wave device capability. / **fi:** Z-Wave-laitteen ominaisuus.

### Status

| Attribute | Name | Type | Get | Set | Required | Unit | Constraints | Labels | Description |
| --- | --- | --- | :-: | :-: | :-: | --- | --- | --- | --- |
| `nodeId` | **en:** Node id / **fi:** Solmun tunniste | `number` | ✅ | — | — |  | min 0, 0 decimals |  |  |
| `status` | **en:** Node status / **fi:** Solmun tila | `enum` | ✅ | — | — |  | one of `0`, `1`, `2` | `0`: **en:** OK / **fi:** OK; `1`: **en:** Not responding / **fi:** Ei vastaa; `2`: **en:** Unknown / **fi:** Tuntematon |  |
| `manufacturer_id` | **en:** Manufacturer id / **fi:** Valmistajan tunniste | `string` | ✅ | — | — |  |  |  |  |
| `product_id` | **en:** Product id / **fi:** Tuotteen tunniste | `string` | ✅ | — | — |  |  |  |  |
| `securityKeys` | **en:** Security keys / **fi:** Turva-avaimet | `number` | ✅ | — | — |  | 0 decimals |  |  |
