`Bridge miio:gateway:lumigateway "Mi Smarter Gateway" [ host="10.10.x.x", token="put here your token", deviceId="326xxxx", model="lumi.gateway.mieu01", communication="direct", cloudServer="de" ]`
-# Advanced: Unsupported devices
+# Advanced: Getting unsupported devices to work with the binding
Newer devices may not yet be supported.
However, many devices share large similarities with existing devices.
The binding allows to try/test if your new device is working with database files of older devices as well.
-There are 2 ways to get unsupported devices working, by overriding the model with the model of a supported item or by test all known properties to see which are supported by your device.
+There are 3 ways to get unsupported devices working:
+- by overriding the model with the model of a similar supported device. E.g. this works great for roborock vacuum devices and yeelight devices). See [Substitute model for unsupported devices](#substitute-model-for-unsupported-devices)
+- by switching on the `(experimental) Create channels for new/unsupported devices (MIOT protocol)` channel, this works for most newer devices. See [Create support for new devices based on online published spec database](#create-support-for-new-devices-based-on-online-published-spec-database)
+- by switching on the `(experimental) Create channels / test properties for unsupported devices (legacy protocol)` channel. This works for older / legacy devices. It test all known properties to see which are supported by your device. See [Supported property test for unsupported devices](#supported-property-test-for-unsupported-devices)
## Substitute model for unsupported devices
For this, first remove your unsupported thing. Manually add a miio:basic thing.
Besides the regular configuration (like ip address, token) the modelId needs to be provided.
Normally the modelId is populated with the model of your device, however in this case, use the modelId of a similar device.
-Look at the openHAB forum, or the openHAB GitHub repository for the modelId of similar devices.
+Look at the openHAB forum, or the openHAB GitHub repository or this readme for the modelId of similar devices.
+
+## Create support for new devices based on online published spec database
+
+The unsupported device has a `(experimental) Create channels for new/unsupported devices (MIOT protocol)` channel. When switching on, it will try to build support based on the published spec from [https://home.miot-spec.com/](https://home.miot-spec.com/).
+It will test all properties are in the spec for your device, which may take few minutes.
+A test report will be shown in the log and is saved in the `userdata/miio` folder with a filename `test-[your model]-[timestamp].txt`.
+The experimental database file is saved to the conf/misc/miio folder (see below chapter).
+The thing will go offline and will come back online as basic device, supporting the found channels.
+If this does not happen automatically, restart the binding or restart openHAB in order to have the new database file picked up.
+
+Please validate and feedback if all channels and actions are working, and share the logfile and json files on the openHAB forum or the openHAB GitHub to build future support for this model.
## Supported property test for unsupported devices
`Bridge miio:gateway:lumigateway "Mi Smarter Gateway" [ host="10.10.x.x", token="put here your token", deviceId="326xxxx", model="lumi.gateway.mieu01", communication="direct", cloudServer="de" ]`
-# Advanced: Unsupported devices
+# Advanced: Getting unsupported devices to work with the binding
Newer devices may not yet be supported.
However, many devices share large similarities with existing devices.
The binding allows to try/test if your new device is working with database files of older devices as well.
-There are 2 ways to get unsupported devices working, by overriding the model with the model of a supported item or by test all known properties to see which are supported by your device.
+There are 3 ways to get unsupported devices working:
+- by overriding the model with the model of a similar supported device. E.g. this works great for roborock vacuum devices and yeelight devices). See [Substitute model for unsupported devices](#substitute-model-for-unsupported-devices)
+- by switching on the `(experimental) Create channels for new/unsupported devices (MIOT protocol)` channel, this works for most newer devices. See [Create support for new devices based on online published spec database](#create-support-for-new-devices-based-on-online-published-spec-database)
+- by switching on the `(experimental) Create channels / test properties for unsupported devices (legacy protocol)` channel. This works for older / legacy devices. It test all known properties to see which are supported by your device. See [Supported property test for unsupported devices](#supported-property-test-for-unsupported-devices)
## Substitute model for unsupported devices
For this, first remove your unsupported thing. Manually add a miio:basic thing.
Besides the regular configuration (like ip address, token) the modelId needs to be provided.
Normally the modelId is populated with the model of your device, however in this case, use the modelId of a similar device.
-Look at the openHAB forum, or the openHAB GitHub repository for the modelId of similar devices.
+Look at the openHAB forum, or the openHAB GitHub repository or this readme for the modelId of similar devices.
+
+## Create support for new devices based on online published spec database
+
+The unsupported device has a `(experimental) Create channels for new/unsupported devices (MIOT protocol)` channel. When switching on, it will try to build support based on the published spec from [https://home.miot-spec.com/](https://home.miot-spec.com/).
+It will test all properties are in the spec for your device, which may take few minutes.
+A test report will be shown in the log and is saved in the `userdata/miio` folder with a filename `test-[your model]-[timestamp].txt`.
+The experimental database file is saved to the conf/misc/miio folder (see below chapter).
+The thing will go offline and will come back online as basic device, supporting the found channels.
+If this does not happen automatically, restart the binding or restart openHAB in order to have the new database file picked up.
+
+Please validate and feedback if all channels and actions are working, and share the logfile and json files on the openHAB forum or the openHAB GitHub to build future support for this model.
## Supported property test for unsupported devices
channel-type.miio.state_id.label = State ID
channel-type.miio.string.label = Generic String Channel
channel-type.miio.switch.label = Generic Switch Channel
-channel-type.miio.testcommands.label = (experimental)Execute test to find supported channels
-channel-type.miio.testcommands.description = Execute test for all known properties to find channels supported by your device. Check your log, share your results.
-channel-type.miio.testmiot.label = (experimental) Create experimental support for new MIOT protocol devices
+channel-type.miio.testcommands.label = (experimental) Create channels / test properties for unsupported devices (legacy protocol)
+channel-type.miio.testcommands.description = Execute test for all known properties to find channels supported by your device. This is for older /legacy devices, newer devices mostly use MIOT. Check your log, share your results.
+channel-type.miio.testmiot.label = (experimental) Create channels for new/unsupported devices (MIOT protocol)
channel-type.miio.testmiot.description = Create experimental support for MIOT protocol devices based on the online specification. Check your log, share your results.
channel-type.miio.total_clean_area.label = Total Cleaning Area
channel-type.miio.total_clean_count.label = Total Cleanings
<channel id="power" typeId="power"/>
<channel id="commands" typeId="commands"/>
<channel id="rpc" typeId="rpc"/>
- <channel id="testcommands" typeId="testcommands"/>
<channel id="testmiot" typeId="testmiot"/>
-
+ <channel id="testcommands" typeId="testcommands"/>
</channels>
</channel-group-type>
<channel-type id="testcommands">
<item-type>Switch</item-type>
- <label>(experimental)Execute test to find supported channels</label>
- <description>Execute test for all known properties to find channels supported by your device. Check your log, share
+ <label>(experimental) Create channels / test properties for unsupported devices (legacy protocol)</label>
+ <description>Execute test for all known properties to find channels supported by your device. This is for older /
+ legacy devices, newer devices mostly use MIOT. Check your log, share
your results.</description>
<category>settings</category>
</channel-type>
<channel-type id="testmiot">
<item-type>Switch</item-type>
- <label>(experimental) Create experimental support for new MIOT protocol devices</label>
+ <label>(experimental) Create channels for new/unsupported devices (MIOT protocol)</label>
<description>Create experimental support for MIOT protocol devices based on the online specification. Check your log,
share your results.</description>
<category>settings</category>
projects / openhab-addons.git / commitdiff