hmh

homebridge-mi-humidifier-jsq4

A Xiaomi Mi humidifier plugin for Homebridge

Showing:

Popularity

Downloads/wk

4

GitHub Stars

46

Maintenance

Last Commit

4mos ago

Contributors

13

Package

Dependencies

1

Size (min+gzip)

10.1KB

License

MIT

Type Definitions

Built-In

Tree-Shakeable

No?

Categories

Readme

homebridge-mi-humidifier

verified-by-homebridge version downloads donate

A Xiaomi Mi humidifier plugin for Homebridge.

⚠️ The config format was changed in version 2. See the configuration section for more details.

Installation

npm install -g homebridge-mi-humidifier

Configuration

Add the following part to the "platforms" section of your Homebridge config:

{
  "platform": "MiHumidifier",
  "devices": [
    {
      "name": "Humidifier",
      "address": "<ip>",
      "token": "<token>",
      "model": "zhimi.humidifier.v1",
      "updateInterval": 30,
      "disabled": false,
      "autoSwitchToHumidityMode": true,
      "disableTargetHumidity": false,
      "ledBulb": {
        "enabled": true,
        "name": "Humidifier LED"
      },
      "buzzerSwitch": {
        "enabled": true,
        "name": "Humidifier Buzzer"
      },
      "temperatureSensor": {
        "enabled": true,
        "name": "Humidifier Temperature"
      },
      "humiditySensor": {
        "enabled": true,
        "name": "Humidifier Humidity"
      }
    }
  ]
}

Platform

KeyDescription
platformPlatform name. Has to be MiHumidifier
devicesArray of devices configurations.

Device

KeyDescriptionDefault value
nameName of the device. This will appear in your Home app."Humidifier"
addressIP address of the device.
tokenDevice token. See obtaining token.
modelOne of:
- zhimi.humidifier.v1
- zhimi.humidifier.ca1
- zhimi.humidifier.cb1
- zhimi.humidifier.ca4
- deerma.humidifier.mjjsq
- deerma.humidifier.jsq001
- deerma.humidifier.jsq1
- shuii.humidifier.jsq001
See supported devices section for more details.
updateIntervalDevice values update interval in seconds. This value affects how often data (humidity, temperature, etc.) from the device is updated.30
disabledDisable the devices. Can be used to temporary hide the device when it is not required without removing it from config.false
autoSwitchToHumidityModeAutomatically switches mode to "humidity" when target humidity is changed. Affects models:
- zhimi.humidifier.{ca1,cb1,ca4}
- deerma.humidifier.{mjjsq,jsq1,jsq001,jsq4}
false
disableTargetHumidityDisables ability to control target humidity. In this case long press on device in Home.app will allow to control fan speed instead of target humidity.false
ledBulb.enabledEnables additional light bulb accessory which allows to control LED lights.false
ledBulb.nameName of LED lightbulb. This will appear in your Home app."Humidifier LED"
buzzerSwitch.enabledEnables additional switch accessory which allows to control buzzer.false
buzzerSwitch.nameName of buzzer switch. This will appear in your Home app."Humidifier Buzzer"
temperatureSensor.enabledEnables additional temperature sensor accessory.false
temperatureSensor.nameName of temperature sensor. This will appear in your Home app."Humidifier Temperature"
humiditySensor.enabledEnables additional humidity sensor accessory.false
humiditySensor.nameName of humidity sensor. This will appear in your Home app."Humidifier Humidity"
cleanModeSwitch.enabledEnables additional switch accessory which allows to control clean mode (only for zhimi.humidifier.ca4).false
cleanModeSwitch.nameName of clean mode switch. This will appear in your Home app."Humidifier Clean Mode"

Supported devices

Smartmi Humidifier

Model: zhimi.humidifier.v1

Model №: CJJSQ01ZM

Smartmi Evaporative Humidifier

Model: zhimi.humidifier.ca1 / zhimi.humidifier.cb1

Model №: CJXJSQ02ZM, SKV6001EU

Smartmi Evaporative Humidifier 2

Model: zhimi.humidifier.ca4

Model №: CJXJSQ04ZM

Zero Fog Humidifier

Model: shuii.humidifier.jsq001

Model №: DWZF(G)-2100Z

Mijia Smart Sterilization Humidifier (S)

Model: deerma.humidifier.mjjsq / deerma.humidifier.jsq001

Model №: SCK0A45, ZNJSQ01DEM, MJJSQ03DY

Mijia Pure Smart Humidifier

Model: deerma.humidifier.jsq4

Model №: CJSJSQ01DY

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100