Circulator Fan

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Circulator Fan
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Circulator Fan
modeStringfan mode. direct mode: direct; natural mode: "natural"; sleep mode: "sleep"; ultra quiet mode: "baby"
versionStringthe current firmware version, e.g. V4.2
powerStringON/OFF state
nightStatusStringset nightlight status. turn off: off; mode 1: 1; mode 2: 2
oscillationStringset horizontal oscillation. turn on: on; turn off: off
verticalOscillationStringset vertical oscillation. turn on: on; turn off: off
fanSpeedIntegerfan speed. 1~100

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Circulator FancommandturnOffdefaultSet to OFF state
Circulator FancommandturnOndefaultSet to ON state
Circulator FancommandsetNightLightModeoff, 1, or 2off, turn off nightlight,
1, bright
2, dim
Circulator FancommandsetWindModedirect, natural, sleep, or babySet fan mode. direct: direct mode. natural: natural mode. sleep: sleep mode. baby: ultra quiet mode
Circulator FancommandsetWindSpeed{1-100} e.g. 10Set fan speed.1~100
Circulator FanncommandcloseDelay{1-36000} e.g. 10Set fan close time

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
modeStringfan mode. direct mode: direct; natural mode: "natural"; sleep mode: "sleep"; ultra quiet mode: "baby"
versionStringthe current firmware version, e.g. V4.2
powerStateStringON/OFF state
nightStatusIntegerset nightlight status. turn off: off; mode 1: 1; mode 2: 2
oscillationStringset horizontal oscillation. turn on: on; turn off: off
verticalOscillationStringset vertical oscillation. turn on: on; turn off: off
fanSpeedIntegerfan speed. 1~100
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoFan2",
        "deviceMac": DEVICE_MAC_ADDR,
        "mode": "direct",
        "version": "V3.1",
        "powerState": "ON",
        "nightStatus": "off",
        "oscillation": "on",
        "verticalOscillation": "on",
        "fanSpeed": 3,
        "timeOfSample": 123456789
    }
}