Skip to Content
🚀 We just launched! Please star us on Github!

Fan Channel

Channel Category: fan

Controls fan devices, including on/off, speed, oscillation, direction, and operating modes.


Required Properties

PropertyData TypeRange/ValuesUnitPermissions
onBool--RW (Read-Write)

Property Details

on

Power state of the device (on/off)

Optional Properties

PropertyData TypeRange/ValuesUnitPermissions
swingBool--RW (Read-Write)
speedUchar0–100%RW (Read-Write)
modeEnumauto, manual, eco, sleep, natural, turbo-RW (Read-Write)
directionEnumclockwise, counter_clockwise-RW (Read-Write)
natural_breezeBool--RW (Read-Write)
timerUshort0–86400sRW (Read-Write)
lockedBool--RW (Read-Write)

Property Details

swing

speed

Fan speed control - integrator can choose between percentage or discrete levels

This property supports multiple data type variants:

  • percentage: Uchar (0–100) in % - Speed as percentage (0-100%)
  • level: Enum (off, low, medium, high, turbo, auto) - Speed as discrete levels

mode

Fan operating mode - controls how fan adjusts speed automatically

direction

natural_breeze

Natural breeze mode simulates natural wind patterns

timer

Auto-off timer - integrator can choose between duration or preset intervals

This property supports multiple data type variants:

  • duration: Ushort (0–86400) in s - Timer duration in seconds (0-86400)
  • preset: Enum (off, 30m, 1h, 2h, 4h, 8h, 12h) - Preset timer intervals

locked

Child lock or panel lock state

Last updated on