Battery Circulator Fan

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Battery 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. Battery 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
batteryIntegerthe current battery level
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
chargingStatusStringbattery charge status. charging or uncharged
fanSpeedIntegerfan speed. 1~100

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Battery Circulator FancommandturnOffdefaultSet to OFF state
Battery Circulator FancommandturnOndefaultSet to ON state
Battery Circulator FancommandsetNightLightModeoff, 1, or 2off, turn off nightlight,
1, bright
2, dim
Battery Circulator FancommandsetWindModedirect, natural, sleep, or babySet fan mode. direct: direct mode. natural: natural mode. sleep: sleep mode. baby: ultra quiet mode
Battery Circulator FancommandsetWindSpeed{1-100} e.g. 10Set fan speed.1~100
Battery 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
batteryIntegerthe current battery level
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
chargingStatusStringbattery charge status. charging or uncharged
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",
        "battery": 22,
        "powerState": "ON",
        "nightStatus": "off",
        "oscillation": "on",
        "verticalOscillation": "on",
        "chargingStatus": "charging",
        "fanSpeed": 3,
        "timeOfSample": 123456789
    }
}