Battery Circulator Fan 2 Pro

July 23, 2026 ยท View on GitHub


Device List Information

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

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Battery Circulator Fan 2 Pro
hubDeviceIdStringdevice's parent Hub ID
modeStringfan mode. direct, natural, sleep, hurricane, or custom
versionStringthe current firmware version, e.g. V6.3
powerStringON/OFF state. on or off
onlineStatusStringthe connection status. online or offline
nightStatusStringnightlight state. on or off
oscillationStringhorizontal oscillation. on or off
verticalOscillationStringvertical oscillation. on or off
chargingStatusStringbattery charge status. charging or uncharged
fanSpeedIntegerfan speed. 1-100

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Battery Circulator Fan 2 ProcommandturnOffdefaultset to OFF state
Battery Circulator Fan 2 ProcommandturnOndefaultset to ON state
Battery Circulator Fan 2 ProcommandsetNightLightModeoff, 0, or 1off, turn off; 0, bright; 1, soft
Battery Circulator Fan 2 ProcommandsetWindModedirect, natural, sleep, or hurricaneset fan mode
Battery Circulator Fan 2 ProcommandsetWindSpeed{1-100}, e.g. 10set fan speed

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, natural, sleep, or hurricane
powerStateStringON/OFF state
nightStatusStringnightlight state. on or off
oscillationStringhorizontal oscillation. on or off
verticalOscillationStringvertical oscillation. on or off
fanSpeedIntegerfan speed
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Battery Circulator Fan 2 Pro",
        "deviceMac": DEVICE_MAC_ADDR,
        "mode": "direct",
        "powerState": "ON",
        "nightStatus": "off",
        "oscillation": "on",
        "verticalOscillation": "on",
        "fanSpeed": 3,
        "timeOfSample": 123456789
    }
}