This is a custom component for home assistant to integrate the Xiaomi Mi Smart Fan.

Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.

Credits: Thanks to Rytilahti for all the work.

• Power (on, off)
• Preset modes (Level 1, Level 2, Level 3, Level 4)
• Speed percentage (0...100)
• Oscillate (on, off)
• Oscillation angle (30, 60, 90, 120, 140, 150)
• Natural mode (on, off)
• Rotate by 5 degrees (left, right)
• Child lock (on, off)
• LED brightness (bright, dim, off)
• Attributes
  • model
  • temperature (zhimi.fan.v2 and v3 only)
  • humidity (zhimi.fan.v2 and v3 only)
  • led_brightness
  • buzzer
  • child_lock
  • natural_level
  • oscillate
  • delay_off_countdown
  • speed
  • direct_speed
  • natural_speed
  • angle
  • use_time
  • ac_power
  • battery (zhimi.fan.v2 and v3 only)
  • battery_charge (zhimi.fan.v2 & v3 only)
  • button_pressed (zhimi.fan.v2 & v3 only)
  • led (zhimi.fan.v2 only)
  • battery_state (zhimi.fan.v2 only)
  • anion (zhimi.fan.za5 only)

• Power (on, off)

• Operation modes (manual, sleep, strong, natural)

• Preset modes (Level 1, Level 2, Level 3, Level 4)

• Speed percentage (0...100)

• Oscillate (on, off)

• Buzzer (on, off)

• Delayed turn off (minutes)

• Attributes

  • model
  • mode
  • speed
  • buzzer
  • oscillate
  • delay_off_countdown
  • error_detected

You can install this custom component via HACS. Search for for 'Xiaomi Mi Smart Pedestal Fan Integration' at the integration page of HACS. Alternatively, you can install it manually by copying the custom_component folder to your Home Assistant configuration folder.

As next step you have to setup the custom component at your configuration.yaml. This custom component doesn't provide a config-flow right now. A restart of Home Assistant is required afterwards.

# configuration.yaml

fan:
  - platform: xiaomi_miio_fan
    name: Xiaomi Smart Fan
    host: 192.168.130.71
    token: b7c4a758c251955d2c24b1d9e41ce47d

Configuration variables:

• host (Required): The IP of your fan.
• token (Required): The API token of your fan.
• name (Optional): The name of your fan.
• model (Optional): The model of your device. This setting can be used to bypass the device model detection and is recommended if your device isn't always available.
• preset_modes_override (Optional): Overrides the list of preset modes. Can be used to suppress the preset mode switches at homekit by passing an empty list (preset_modes_override: []).

Set the fan speed percentage.

Set a preset mode.

Oscillates the fan.

Rotates the fan 5 degrees to the left/right.

Set the oscillation angle. Supported values are 30, 60, 90 and 120 degrees.

Set the scheduled turn off time. Supported values are 0, 60, 120, 180, 240, 300, 360, 420, 480 minutes. When 0 is passed, delay_off is disabled.

Turn the natural mode on.

Turn the natural mode off.

Turn the buzzer on.

Turn the buzzer off.

Turn the child lock on.

Turn the child lock off.

Set the led brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off).

Turn the ionizer on.

Turn the ionizer off.