Evaporative Humidifier

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Humidifier2
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringreturns null if not a bluetooth device

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Humidifier2
powerStringON/OFF state
humidityIntegerhumidity percentage
modeIntegerthe current mode. 1, level 4; 2, level 3; 3, level 2; 4, level 1; 5, humidity mode; 6, sleep mode; 7, auto mode; 8, drying mode
dryingBooleandetermines if the device is drying its filter or not
childLockBooleandetermines if the safety lock is on or not
filterElementObjectcontains status info of the filter. e.g. {"effectiveUsageHours": 240, "usedHours": 20}. effectiveUsageHours, the effective duration of the filter in hours; usedHours, the number of hours the filter has been used.
versionIntegerfirmware version

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Humidifier2commandturnOffdefaultset to OFF state
Humidifier2commandturnOndefaultset to ON state
Humidifier2commandsetMode{"mode": mode_int, "targetHumidify": humidity_int}set the mode. mode_int, 1, level 4; 2, level 3; 3, level 2; 4, level 1; 5, humidity mode; 6, sleep mode; 7, auto mode; 8, drying mode; targetHumidify, the target humidity level in percentage, 0~100.
Humidifier2commandsetChildLocktrue or falseenable or disable child lock. true, enable; false, disable

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
powerStringthe power state of the device
modeIntegerthe current mode. 1, level 4; 2, level 3; 3, level 2; 4, level 1; 5, humidity mode; 6, sleep mode; 7, auto mode; 8, drying mode
dryingBooleandetermines if the device is drying its filter or not
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Humidifier2",
        "deviceMac": DEVICE_MAC_ADDR,
        "power": "on",
        "mode": 1,
        "drying": false,
        "timeOfSample": 123456789
    }
}