# Mi IO Devices
-Currently the miio binding supports more than 200 different models.
+Currently the miio binding supports more than 210 different models.
| Device | ThingType | Device Model | Supported | Remark |
|------------------------------|------------------|------------------------|-----------|------------|
| Yeelight yilai ceiling | miio:basic | [yilai.light.ceiling2](#yilai-light-ceiling2) | Yes | |
| Yeelight yilai ceiling | miio:basic | [yilai.light.ceiling3](#yilai-light-ceiling3) | Yes | |
| Zhimi Heater | miio:basic | [zhimi.heater.za1](#zhimi-heater-za1) | Yes | Experimental support. Please report back if all channels are functional. Preferably share the debug log of property refresh and command responses |
+| Zhimi Heater | miio:basic | [zhimi.heater.za2](#zhimi-heater-za2) | Yes | Experimental support. Please report back if all channels are functional. Preferably share the debug log of property refresh and command responses |
+| Zhimi Heater | miio:basic | [zhimi.heater.zb1](#zhimi-heater-zb1) | Yes | Experimental support. Please report back if all channels are functional. Preferably share the debug log of property refresh and command responses |
# Advanced: Unsupported devices
| temperature | Number:Temperature | Temperature | |
| usedhours | Number | Run Time | |
+### Zhimi Heater (<a name="zhimi-heater-za2">zhimi.heater.za2</a>) Channels
+
+| Channel | Type | Description | Comment |
+|------------------|---------|-------------------------------------|------------|
+| fault | Number | Heater - Device Fault | |
+| on | Switch | Heater - Power | |
+| target-temperature | Number:Temperature | Heater - Target Temperature | |
+| alarm | Switch | Alarm - Alarm | |
+| countdown-time | Number:Time | Countdown - Countdown Time | |
+| relative-humidity | Number | Environment - Relative Humidity | |
+| temperature | Number:Temperature | Environment - Temperature | |
+| brightness | Dimmer | Indicator Light - Brightness | |
+| physical-controls-locked | Switch | Physical Control Locked - Physical Controls Locked | |
+| use-time | Number:Time | Private-Service - Use Time | |
+
+### Zhimi Heater (<a name="zhimi-heater-zb1">zhimi.heater.zb1</a>) Channels
+
+| Channel | Type | Description | Comment |
+|------------------|---------|-------------------------------------|------------|
+| fault | Number | Heater - Device Fault | |
+| on | Switch | Heater - Power | |
+| target-temperature | Number:Temperature | Heater - Target Temperature | |
+| alarm | Switch | Alarm - Alarm | |
+| countdown-time | Number:Time | Countdown - Countdown Time | |
+| relative-humidity | Number | Environment - Relative Humidity | |
+| temperature | Number:Temperature | Environment - Temperature | |
+| brightness | Dimmer | Indicator Light - Brightness | |
+| physical-controls-locked | Switch | Physical Control Locked - Physical Controls Locked | |
+| use-time | Number:Time | Private-Service - Use Time | |
+| country-code | Number | Private-Service - Country-Code | Value mapping [0="Unknown",1="US",82="KR",44="EU",81="JP",7="RU",86="CN",852="HK",886="TW",33="FR"] |
+
Number usedhours "Run Time" (G_heater) {channel="miio:basic:heater:usedhours"}
```
+### Zhimi Heater (zhimi.heater.za2) item file lines
+
+note: Autogenerated example. Replace the id (heater) in the channel with your own. Replace `basic` with `generic` in the thing UID depending on how your thing was discovered.
+
+```java
+Group G_heater "Zhimi Heater" <status>
+Number fault "Heater - Device Fault" (G_heater) {channel="miio:basic:heater:fault"}
+Switch on "Heater - Power" (G_heater) {channel="miio:basic:heater:on"}
+Number:Temperature target-temperature "Heater - Target Temperature" (G_heater) {channel="miio:basic:heater:target-temperature"}
+Switch alarm "Alarm - Alarm" (G_heater) {channel="miio:basic:heater:alarm"}
+Number:Time countdown-time "Countdown - Countdown Time" (G_heater) {channel="miio:basic:heater:countdown-time"}
+Number relative-humidity "Environment - Relative Humidity" (G_heater) {channel="miio:basic:heater:relative-humidity"}
+Number:Temperature temperature "Environment - Temperature" (G_heater) {channel="miio:basic:heater:temperature"}
+Dimmer brightness "Indicator Light - Brightness" (G_heater) {channel="miio:basic:heater:brightness"}
+Switch physical-controls-locked "Physical Control Locked - Physical Controls Locked" (G_heater) {channel="miio:basic:heater:physical-controls-locked"}
+Number:Time use-time "Private-Service - Use Time" (G_heater) {channel="miio:basic:heater:use-time"}
+```
+
+### Zhimi Heater (zhimi.heater.zb1) item file lines
+
+note: Autogenerated example. Replace the id (heater) in the channel with your own. Replace `basic` with `generic` in the thing UID depending on how your thing was discovered.
+
+```java
+Group G_heater "Zhimi Heater" <status>
+Number fault "Heater - Device Fault" (G_heater) {channel="miio:basic:heater:fault"}
+Switch on "Heater - Power" (G_heater) {channel="miio:basic:heater:on"}
+Number:Temperature target-temperature "Heater - Target Temperature" (G_heater) {channel="miio:basic:heater:target-temperature"}
+Switch alarm "Alarm - Alarm" (G_heater) {channel="miio:basic:heater:alarm"}
+Number:Time countdown-time "Countdown - Countdown Time" (G_heater) {channel="miio:basic:heater:countdown-time"}
+Number relative-humidity "Environment - Relative Humidity" (G_heater) {channel="miio:basic:heater:relative-humidity"}
+Number:Temperature temperature "Environment - Temperature" (G_heater) {channel="miio:basic:heater:temperature"}
+Dimmer brightness "Indicator Light - Brightness" (G_heater) {channel="miio:basic:heater:brightness"}
+Switch physical-controls-locked "Physical Control Locked - Physical Controls Locked" (G_heater) {channel="miio:basic:heater:physical-controls-locked"}
+Number:Time use-time "Private-Service - Use Time" (G_heater) {channel="miio:basic:heater:use-time"}
+Number country-code "Private-Service - Country-Code" (G_heater) {channel="miio:basic:heater:country-code"}
+```
+
### <a name="Country-Servers">Country Servers</a>
YL_CEILING2("yilai.light.ceiling2", "Yeelight yilai ceiling", THING_TYPE_BASIC),
YL_CEILING3("yilai.light.ceiling3", "Yeelight yilai ceiling", THING_TYPE_BASIC),
ZHIMI_HEATER_ZA1("zhimi.heater.za1", "Zhimi Heater", THING_TYPE_BASIC),
+ ZHIMI_HEATER_ZA2("zhimi.heater.za2", "Zhimi Heater", THING_TYPE_BASIC),
+ ZHIMI_HEATER_ZB1("zhimi.heater.zb1", "Zhimi Heater", THING_TYPE_BASIC),
UNKNOWN("unknown", "Unknown Mi IO Device", THING_TYPE_UNSUPPORTED);
public static MiIoDevices getType(String modelString) {
SECOND(SmartHomeUnits.SECOND),
MINUTE(SmartHomeUnits.MINUTE),
HOUR(SmartHomeUnits.HOUR),
+ SECONDS(SmartHomeUnits.SECOND),
+ MINUTES(SmartHomeUnits.MINUTE),
+ HOURS(SmartHomeUnits.HOUR),
AMPERE(SmartHomeUnits.AMPERE),
WATT(SmartHomeUnits.WATT);
<state readOnly="true"/>
</channel-type>
+ <!-- Generic Numeric QtyType channels -->
+ <channel-type id="temperatureRW">
+ <item-type>Number:Temperature</item-type>
+ <label>Temperature</label>
+ <state pattern="%.1f %unit%"/>
+ </channel-type>
+ <channel-type id="time">
+ <item-type>Number:Time</item-type>
+ <label>Hours</label>
+ <state readOnly="true" pattern="%.0f %unit%"/>
+ </channel-type>
+
<!-- Common Actions channels -->
<channel-type id="commands" advanced="true">
<item-type>String</item-type>
</options>
</state>
</channel-type>
+ <channel-type id="ZhimiHeaterZa2_target-temperature">
+ <item-type>Number:Temperature</item-type>
+ <label>Heater - Target Temperature</label>
+ <state min="16" max="28" step="1" pattern="%.1f %unit%">
+ </state>
+ </channel-type>
+ <channel-type id="ZhimiHeaterZb1_country-code">
+ <item-type>Number</item-type>
+ <label>Private-Service - Country-Code</label>
+ <state>
+ <options>
+ <option value="0">Unknown</option>
+ <option value="1">US</option>
+ <option value="7">RU</option>
+ <option value="33">FR</option>
+ <option value="44">EU</option>
+ <option value="81">JP</option>
+ <option value="82">KR</option>
+ <option value="86">CN</option>
+ <option value="852">HK</option>
+ <option value="886">TW</option>
+ </options>
+ </state>
+ </channel-type>
</thing:thing-descriptions>
--- /dev/null
+{
+ "deviceMapping": {
+ "id": [
+ "zhimi.heater.za2"
+ ],
+ "propertyMethod": "get_properties",
+ "maxProperties": 1,
+ "channels": [
+ {
+ "property": "fault",
+ "siid": 2,
+ "piid": 1,
+ "friendlyName": "Heater - Device Fault",
+ "channel": "fault",
+ "channelType": "miot_uint32",
+ "type": "Number",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "on",
+ "siid": 2,
+ "piid": 2,
+ "friendlyName": "Heater - Power",
+ "channel": "on",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "target-temperature",
+ "siid": 2,
+ "piid": 6,
+ "friendlyName": "Heater - Target Temperature",
+ "channel": "target-temperature",
+ "channelType": "ZhimiHeaterZa2_target-temperature",
+ "type": "Number:Temperature",
+ "unit": "CELCIUS",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "NUMBER"
+ }
+ ]
+ },
+ {
+ "property": "alarm",
+ "siid": 3,
+ "piid": 1,
+ "friendlyName": "Alarm - Alarm",
+ "channel": "alarm",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "countdown-time",
+ "siid": 4,
+ "piid": 1,
+ "friendlyName": "Countdown - Countdown Time",
+ "channel": "countdown-time",
+ "channelType": "time",
+ "type": "Number:Time",
+ "unit": "hours",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "STRING"
+ }
+ ]
+ },
+ {
+ "property": "relative-humidity",
+ "siid": 5,
+ "piid": 7,
+ "friendlyName": "Environment - Relative Humidity",
+ "channel": "relative-humidity",
+ "channelType": "humidity",
+ "type": "Number",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "temperature",
+ "siid": 5,
+ "piid": 8,
+ "friendlyName": "Environment - Temperature",
+ "channel": "temperature",
+ "channelType": "temperatureC",
+ "type": "Number:Temperature",
+ "unit": "CELCIUS",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "brightness",
+ "siid": 6,
+ "piid": 1,
+ "friendlyName": "Indicator Light - Brightness",
+ "channel": "brightness",
+ "channelType": "brightness",
+ "type": "Dimmer",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "NUMBER"
+ }
+ ]
+ },
+ {
+ "property": "physical-controls-locked",
+ "siid": 7,
+ "piid": 1,
+ "friendlyName": "Physical Control Locked - Physical Controls Locked",
+ "channel": "physical-controls-locked",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "use-time",
+ "siid": 8,
+ "piid": 7,
+ "friendlyName": "Private-Service - Use Time",
+ "channel": "use-time",
+ "channelType": "time",
+ "type": "Number:Time",
+ "unit": "seconds",
+ "refresh": true,
+ "actions": []
+ }
+ ],
+ "experimental": true
+ }
+}
--- /dev/null
+{
+ "deviceMapping": {
+ "id": [
+ "zhimi.heater.zb1"
+ ],
+ "propertyMethod": "get_properties",
+ "maxProperties": 1,
+ "channels": [
+ {
+ "property": "fault",
+ "siid": 2,
+ "piid": 1,
+ "friendlyName": "Heater - Device Fault",
+ "channel": "fault",
+ "channelType": "miot_uint32",
+ "type": "Number",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "on",
+ "siid": 2,
+ "piid": 2,
+ "friendlyName": "Heater - Power",
+ "channel": "on",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "target-temperature",
+ "siid": 2,
+ "piid": 6,
+ "friendlyName": "Heater - Target Temperature",
+ "channel": "target-temperature",
+ "channelType": "ZhimiHeaterZa2_target-temperature",
+ "type": "Number:Temperature",
+ "unit": "CELCIUS",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "NUMBER"
+ }
+ ]
+ },
+ {
+ "property": "alarm",
+ "siid": 3,
+ "piid": 1,
+ "friendlyName": "Alarm - Alarm",
+ "channel": "alarm",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "countdown-time",
+ "siid": 4,
+ "piid": 1,
+ "friendlyName": "Countdown - Countdown Time",
+ "channel": "countdown-time",
+ "channelType": "time",
+ "type": "Number:Time",
+ "unit": "hours",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "STRING"
+ }
+ ]
+ },
+ {
+ "property": "relative-humidity",
+ "siid": 5,
+ "piid": 7,
+ "friendlyName": "Environment - Relative Humidity",
+ "channel": "relative-humidity",
+ "channelType": "humidity",
+ "type": "Number",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "temperature",
+ "siid": 5,
+ "piid": 8,
+ "friendlyName": "Environment - Temperature",
+ "channel": "temperature",
+ "channelType": "temperatureC",
+ "type": "Number:Temperature",
+ "unit": "CELCIUS",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "brightness",
+ "siid": 6,
+ "piid": 1,
+ "friendlyName": "Indicator Light - Brightness",
+ "channel": "brightness",
+ "channelType": "brightness",
+ "type": "Dimmer",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "NUMBER"
+ }
+ ]
+ },
+ {
+ "property": "physical-controls-locked",
+ "siid": 7,
+ "piid": 1,
+ "friendlyName": "Physical Control Locked - Physical Controls Locked",
+ "channel": "physical-controls-locked",
+ "channelType": "miot_bool",
+ "type": "Switch",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "ONOFFBOOL"
+ }
+ ]
+ },
+ {
+ "property": "use-time",
+ "siid": 8,
+ "piid": 7,
+ "friendlyName": "Private-Service - Use Time",
+ "channel": "use-time",
+ "channelType": "time",
+ "type": "Number:Time",
+ "unit": "seconds",
+ "refresh": true,
+ "actions": []
+ },
+ {
+ "property": "country-code",
+ "siid": 8,
+ "piid": 8,
+ "friendlyName": "Private-Service - Country-Code",
+ "channel": "country-code",
+ "channelType": "ZhimiHeaterZb1_country-code",
+ "type": "Number",
+ "refresh": true,
+ "actions": [
+ {
+ "command": "set_properties",
+ "parameterType": "NUMBER"
+ }
+ ],
+ "value-list": [
+ {
+ "value": 0,
+ "description": "Unknown"
+ },
+ {
+ "value": 1,
+ "description": "US"
+ },
+ {
+ "value": 82,
+ "description": "KR"
+ },
+ {
+ "value": 44,
+ "description": "EU"
+ },
+ {
+ "value": 81,
+ "description": "JP"
+ },
+ {
+ "value": 7,
+ "description": "RU"
+ },
+ {
+ "value": 86,
+ "description": "CN"
+ },
+ {
+ "value": 852,
+ "description": "HK"
+ },
+ {
+ "value": 886,
+ "description": "TW"
+ },
+ {
+ "value": 33,
+ "description": "FR"
+ }
+ ],
+ "readmeComment": "Value mapping [0\u003d\"Unknown\",1\u003d\"US\",82\u003d\"KR\",44\u003d\"EU\",81\u003d\"JP\",7\u003d\"RU\",86\u003d\"CN\",852\u003d\"HK\",886\u003d\"TW\",33\u003d\"FR\"]"
+ }
+ ],
+ "experimental": true
+ }
+}
projects / openhab-addons.git / commitdiff