Xiaomi Mi Air Purifier (Xiaomi Mi IO)

thomasbrandl · August 6, 2022, 11:19am

Marcel: many thanks! That worked perfectly!
(I had some trouble with the json syntax with missing the the “,” after the last “}” - I forgot the simple rule: do not copy the last item in a list, because it does not contain the item delimiter - this took me nearly two days )

I did not add specific values for the status, because 0 / 1 is not language specific.
Now the description file ended like this:

			{
				"property": "waterstatus",
				"friendlyName": "Water Status",
				"channel": "waterstatus",
				"type": "Number",
				"stateDescription": {
					"pattern": "%.0f",
					"readOnly": true
				},
				"refresh": true,
				"actions": []
			},
			{
				"property": "TemperatureValue",
				"friendlyName": "Temperature",
				"channel": "TemperatureValue",
				"type": "Number",
				"stateDescription": {
					"pattern": "%.0f",
					"readOnly": true
				},
				"refresh": true,
				"actions": []
			}

And this is the result :

As a new user I cannot upload attachments and therefore cannot upload the adjusted json - file, but the modifications are pretty simple.

And as a hint for others: the conf/misc/miio - folder on an openhabian distribution is /etc/openhab/misc/miio - and you have to create the misc/ and misc/miio folder by yourself.

axinitza · November 21, 2022, 11:03am

Is there any possibility to add zhimi.airp.vb4 (Xiaomi Air Purifier Pro 4) ? Thanks.

marcel_verpaalen · November 30, 2022, 1:34pm

Can you try the (experimental) Create experimental support for new MIOT protocol devices channel and feedback which channels are working and which not.
Than the created files, it will speedup implementing it

axinitza · November 30, 2022, 7:52pm

I tried but nothing works (or I don’t know how to use it) but found something here:

github.com

merdok/homebridge-miot/blob/3799be7a1a4e20b4beef629145678432a02dbaeb/lib/modules/airpurifier/devices/zhimi.airp.vb4.js

const AirPurifierDevice = require('../AirPurifierDevice.js');
const Constants = require('../../../constants/Constants.js');
const PropFormat = require('../../../constants/PropFormat.js');
const PropUnit = require('../../../constants/PropUnit.js');
const PropAccess = require('../../../constants/PropAccess.js');


class ZhimiAirpVb4 extends AirPurifierDevice {
  constructor(miotDevice, name, logger) {
    super(miotDevice, name, logger);
  }


  /*----------========== DEVICE INFO ==========----------*/

  getDeviceName() {
    return 'Xiaomi Air Purifier Pro 4';
  }

  getMiotSpecUrl() {

This file has been truncated. show original

marcel_verpaalen · November 30, 2022, 10:24pm

let me walk you through the steps

open your openhab folder, find the folder /conf/misc/miio
You may have a json file there from a previous run. please delete it
delete your thing
restart openhab to ensure all is cleaned up
after openhab is fully started again, discover your air purifier again. It should be recognised as unsupported device
log into the openhab console and type
log:set debug org.openhab.binding.miio log:tail org.openhab.binding.miio
there are a few channels for unsupported devices. use the above mentioned (experimental) Create experimental support for new MIOT protocol devices nb use the miot one. It is a switch, just switch it on once.
in the console screen you will see it is creating files for your device.
After creation it most likely will change to a miio:basic thing with many channels. If that does not work automatically, restart openhab once more to ensure the new folder / json file is picked up.
check if the channels work as expected and share the file

axinitza · December 5, 2022, 2:15pm

I can confirm that it works but unfortunately “Sorry, new users cannot upload attachments.”
Thanks.

axinitza · December 6, 2022, 7:55pm

Hello. The “(experimental) Create experimental support for new MIOT protocol devices” make a JSON file in /etc/openhab/misc/miio and with this file now zhimi.airp.vb4 and chuangmi.camera.ipc016 works.
zhimi.airp.vb4-miot-experimental.json (17.6 KB)
chuangmi.camera.ipc016-experimental.json (3.2 KB)

And the Item file contains :

Group Videocamera "Video camera " [“Equipment”]

// Points:

// String Videocamera_SSID “SSID” (Videocamera) [“Point”] { channel=“miio:generic:16178534:network#ssid” }
// String Videocamera_BSSID “BSSID” (Videocamera) [“Point”] { channel=“miio:generic:16178534:network#bssid” }
// Number Videocamera_RSSI “RSSI” (Videocamera) [“Point”] { channel=“miio:generic:16178534:network#rssi” }
// Number Videocamera_Life “Life” (Videocamera) [“Point”] { channel=“miio:generic:16178534:network#life” }
// String Videocamera_ExecuteCommand “Execute Command” (Videocamera) [“Point”] { channel=“miio:generic:16178534:actions#commands” }
// String Videocamera_ExecuteRPCcloudCommand “Execute RPC (cloud) Command” (Videocamera) [“Point”] { channel=“miio:generic:16178534:actions#rpc” }
Switch Videocamera_CameraControlSwitchStatus “Camera Control - Switch Status” (Videocamera) [“Point”] { channel=“miio:generic:16178534:power” }
Number:Angle Videocamera_CameraControlImageRollover “Camera Control - Image Rollover” (Videocamera) [“Point”] { channel=“miio:generic:16178534:flip” }
Number Videocamera_CameraControlNightShot “Camera Control - Night Shot” (Videocamera) [“Point”] { channel=“miio:generic:16178534:night_shot” }
Switch Videocamera_CameraControlTimeWatermark “Camera Control - Time Watermark” (Videocamera) [“Point”] { channel=“miio:generic:16178534:watermark” }
Switch Videocamera_CameraControlWideDynamicRangeMode “Camera Control - Wide Dynamic Range Mode” (Videocamera) [“Point”] { channel=“miio:generic:16178534:wdr_mode” }
Switch Videocamera_CameraControlGlimmerFullColor “Camera Control - Glimmer Full Color” (Videocamera) [“Point”] { channel=“miio:generic:16178534:glimmer_full_color” }
Number Videocamera_CameraControlRecordingMode “Camera Control - Recording Mode” (Videocamera) [“Point”] { channel=“miio:generic:16178534:recording_mode” }
Switch Videocamera_CameraControlMotionTracking “Camera Control - Motion Tracking” (Videocamera) [“Point”] { channel=“miio:generic:16178534:motion_tracking” }

Group XiaomiSmartAirPurifier4Pro "Xiaomi Smart Air Purifier 4 Pro " [“Equipment”]

// Points:

// String XiaomiSmartAirPurifier4Pro_SSID // String XiaomiSmartAirPurifier4Pro_BSSID // Number XiaomiSmartAirPurifier4Pro_RSSI // Number XiaomiSmartAirPurifier4Pro_Life // String XiaomiSmartAirPurifier4Pro_ExecuteCommand // String XiaomiSmartAirPurifier4Pro_ExecuteRPCcloudCommand String XiaomiSmartAirPurifier4Pro_Actions Switch XiaomiSmartAirPurifier4Pro_AirPurifierSwitchStatus Number XiaomiSmartAirPurifier4Pro_AirPurifierDeviceFault Number XiaomiSmartAirPurifier4Pro_AirPurifierMode Number XiaomiSmartAirPurifier4Pro_AirPurifierFanLevel Switch XiaomiSmartAirPurifier4Pro_AirPurifierAnion Number:Dimensionless XiaomiSmartAirPurifier4Pro_EnvironmentRelativeHumidity Number XiaomiSmartAirPurifier4Pro_EnvironmentPM25Density Number:Temperature XiaomiSmartAirPurifier4Pro_EnvironmentTemperature Number XiaomiSmartAirPurifier4Pro_EnvironmentPM10Density Number:Dimensionless XiaomiSmartAirPurifier4Pro_FilterFilterLifeLevel Number:Time XiaomiSmartAirPurifier4Pro_FilterFilterUsedTime Number:Time XiaomiSmartAirPurifier4Pro_FilterFilterLeftTime Switch XiaomiSmartAirPurifier4Pro_AlarmAlarm Switch XiaomiSmartAirPurifier4Pro_PhysicalControlLocke Number:Dimensionless XiaomiSmartAirPurifier4Pro_ScreenBrightness Number XiaomiSmartAirPurifier4Pro_DeviceDisplayUnitTem Number XiaomiSmartAirPurifier4Pro_CustomServiceMotoSpeedRpm Number XiaomiSmartAirPurifier4Pro_CustomServiceFavoriteSpeed Number XiaomiSmartAirPurifier4Pro_CustomServiceMotorSetSpeed Number XiaomiSmartAirPurifier4Pro_CustomServiceFavoriteLevel Switch XiaomiSmartAirPurifier4Pro_CustomServiceButtomDoor Number XiaomiSmartAirPurifier4Pro_CustomServiceRebootCause Number XiaomiSmartAirPurifier4Pro_CustomServiceManualLevel Number XiaomiSmartAirPurifier4Pro_CustomServiceCountryCode Number:Time XiaomiSmartAirPurifier4Pro_FilterTimeFilterUsedDebug Number XiaomiSmartAirPurifier4Pro_AqiPurifyVolume Number XiaomiSmartAirPurifier4Pro_AqiAverageAqi Number XiaomiSmartAirPurifier4Pro_AqiAqiState Number XiaomiSmartAirPurifier4Pro_AqiAqiUpdataHeartbeat String XiaomiSmartAirPurifier4Pro_RfidRfidTag String XiaomiSmartAirPurifier4Pro_RfidRfidFactoryId String XiaomiSmartAirPurifier4Pro_RfidRfidProductId String XiaomiSmartAirPurifier4Pro_RfidRfidTime String XiaomiSmartAirPurifier4Pro_RfidRfidSerialNum “SSID” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:network#ssid” }
“BSSID” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:network#bssid” }
“RSSI” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:network#rssi” }
“Life” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:network#life” }
“Execute Command” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:actions#commands” }
“Execute RPC (cloud) Command” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:actions#rpc” }
“Actions” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:actions” }
“Air Purifier - Switch Status” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:on” }
“Air Purifier - Device Fault” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:fault” }
“Air Purifier - Mode” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:mode” }
“Air Purifier - Fan Level” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:fan_level” }
“Air Purifier - Anion” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:anion” }
“Environment - Relative Humidity” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:relative_humidity” }
“Environment - PM2 5 Density” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:pm2_5_density” }
“Environment - Temperature” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:temperature” }
“Environment - PM10 Density” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:pm10_density” }
“Filter - Filter Life Level” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:filter_life_level” }
“Filter - Filter Used Time” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:filter_used_time” }
“Filter - Filter Left Time” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:filter_left_time” }
“Alarm - Alarm” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:alarm” }
dPhysicalControlLocked “Physical Control Locked - Physical Control Locked” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:physical_controls_locked” }
“Screen - Brightness” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:brightness” }
peratureDisplayUnit “Device Display Unit - Temperature Display Unit” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:temperature_display_unit” }
“Custom Service - Moto Speed Rpm” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:moto_speed_rpm” }
“Custom Service - Favorite Speed” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:favorite_speed” }
“Custom Service - Motor Set Speed” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:motor_set_speed” }
“Custom Service - Favorite Level” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:favorite_level” }
“Custom Service - Buttom Door” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:buttom_door” }
“Custom Service - Reboot Cause” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:reboot_cause” }
“Custom Service - Manual Level” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:manual_level” }
“Custom Service - Country Code” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:country_code” }
“Filter Time - Filter Used Debug” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:filter_used_debug” }
“Aqi - Purify Volume” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:purify_volume” }
“Aqi - Average Aqi” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:average_aqi” }
“Aqi - Aqi State” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:aqi_state” }
“Aqi - Aqi Updata Heartbeat” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:aqi_updata_heartbeat” }
“Rfid - Rfid Tag” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:rfid_tag” }
“Rfid - Rfid Factory Id” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:rfid_factory_id” }
“Rfid - Rfid Product Id” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:rfid_product_id” }
“Rfid - Rfid Time” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:rfid_time” }
“Rfid - Rfid Serial Num” (XiaomiSmartAirPurifier4Pro) [“Point”] { channel=“miio:generic:1C4F9D45:rfid_serial_num” }

Constantinos_Contis · February 17, 2023, 9:52am

hi @marcel_verpaalen ,i got the 3H purifier and the purifier modes channel that autocreated is a Number.But the values it gets are string type like “Auto”,“Sleep”,“Favorite” and “None”.

when i try to control it it needs numbers 0,1,2, and 3.Is that right?The displayed value at all widgets are numbers and not the modes.Can be fixed?
thnx

marcel_verpaalen · February 21, 2023, 6:44pm

In openhab you can associate the numbers to string.
So while the channel requires a number it will display the string.
You can control that with map. If you have custom widgets you may need to do the mapping another way

Constantinos_Contis · February 21, 2023, 8:00pm

so the item had to be a number and with map i can make it display a string?As you see at the pic it is a number item but it shows a string by default…But at the default control widget it shows numbers(as it should be).If i turn this item to string type i get this

[WARN ] [al.profiles.MapTransformationProfile] - Could not transform state '1' with function 'purifier.map' and format '%s'

my map file

Auto=0
Sleep=1
Favorite=2
None=3