Fan
in progress
Chris Jackson
Supporting Alexa fans would be amazing. Vornado makes a whole line of them that I'd love to have in HomeKit.
Joey Hage
Jeff Byrnes: can you please upgrade the plugin to the latest version (2.0.1), enable debug in the plugin settings, and share the following output:
[date time] [HomebridgeAlexaSmartHome] <your device name here> ::: Current state: [
...
]
[date time] [HomebridgeAlexaSmartHome] <your device name here> ::: Range capabilities: [
...
]
Thanks!
Patrick Kuras
Hi Joey! We chatted about this a couple years ago, but it's still an issue for me, and I'd like to add my $0.02, which is that not all fans present to Alexa as FAN devices. I'd like to be able to have my Fanimation ceiling fans, which present as "SWITCH" devices with SetPercentage AdjustPercentage controls, be controllable as to speed. I can turn my fans on and off via Homebridge, but I can't control the speed. I believe supporting speed control on devices like this would be a matter of recharacterizing the device to Homekit as a FAN, and then having the Homekit FAN speed control map to the Alexa SWITCH SetPercentage control.
Is there a straightforward way to add a configuration control that would, for limited Alexa-Homekit device type pairs, enable translation from one device type to another, with mapping of the percentage control between the domains? This would also be useful for Alexa SWITCH devices that control dimmable lights (by mapping SWITCH to LIGHT). I think to have SWITCH<->LIGHT and SWITCH<->FAN mapping would go a long way for a lot of people right now.
Here's my device enumeration detail from the log, and thanks for considering this!
[09/11/2025, 18:16:38] [HomebridgeAlexaSmartHome] Lanai Dining Fan ::: Attempting to add accessory(s) for device: {
"endpointId": "amzn1.alexa.endpoint.8abe7356-1c42-4074-9b59-5a5bdb601774",
"id": "8abe7356-1c42-4074-9b59-5a5bdb601774",
"displayName": "Lanai Dining Fan",
"supportedOperations": [
"turnOn",
"turnOff",
"setPercentage",
"adjustPercentage"
],
"enabled": true,
"deviceType": "SWITCH",
"serialNumber": "Unknown",
"model": "Unknown",
"manufacturer": "homebridge-alexa-smarthome"
}
[09/11/2025, 18:16:38] [HomebridgeAlexaSmartHome] Lanai Dining Fan ::: Current state: [
{
"featureName": "power",
"name": "powerState",
"value": "OFF"
}
]
Patrick Kuras
Also, some devices offer "setPercentage" and "adjustPercentage" controls, while others offer "setBrightness" and "adjustBrightness" controls. Ideally, the plugin should detect both, and offer a brightness/speed slider regardless of which type of control is offered by Alexa. In the Fanimation device, for example, Alexa gives me the ability to change the device type from SWITCH to LIGHT, but the fans always offer "setPercentage," rather than "setBrightness," even when characterized as LIGHT devices. This is yet another detail that exposes the broad range of possibilities that Alexa developers may choose when implementing their code, further complicating your task in creating a broadly functional adapter. We're grateful to you for taking this on!
If you decide to do the work that will enable my Fanimation devices for speed control, I will happily offer some sponsorship funds!
T
Timothy Mills
In case it's still helpful, here's the info from my Vornado Transom AE.
[27/09/2024, 07:30:09] [homebridge-alexa-smarthome] Window fan ::: Attempting to add accessory(s) for device: {
"endpointId": "amzn1.alexa.endpoint.ce2bd3d5-3391-490a-b52a-4f17ee8f69ab",
"id": "ce2bd3d5-3391-490a-b52a-4f17ee8f69ab",
"displayName": "Window fan",
"supportedOperations": [
"turnOn",
"turnOff",
"turnOn",
"turnOff",
"setRangeValue",
"adjustRangeValue"
],
"enabled": true,
"deviceType": "FAN",
"serialNumber": "GB21JU04252100UE",
"model": "A1AZ0VKGUB06NH",
"manufacturer": "homebridge-alexa-smarthome"
}
[27/09/2024, 07:30:09] [homebridge-alexa-smarthome] Window fan ::: Current state: [
{
"featureName": "power",
"name": "powerState",
"value": "ON"
},
{
"featureName": "toggle",
"name": "toggleState",
"value": "OFF"
},
{
"featureName": "range",
"name": "rangeValue",
"value": 60,
"instance": "3",
"rangeName": "Set Temperature"
},
{
"featureName": "range",
"name": "rangeValue",
"value": 71,
"instance": "5",
"rangeName": "Air Temperature"
}
]
C
Casey
Have you been able to add fan speed control or is that still being worked on? I have an Atomi ceiling fan and the on/off plus the light with RGB all shows up in Homekit and works just fine with your plugin now just trying to figure out how to get fan speed control and reverse direction too. Thanks!
C
Cameron Walters
Hi Joey Hage, I'm interested in the same thing, support for a Transom AE fan.
Running v2.2.1 of your plugin, I get these logs (had to reformat to save characters to stay under the post limit here)
[30/08/2024, 15:07:18] [homebridge-alexa-smarthome] Primary Bedroom Window Fan :::Raw device features:[
{
"name":"power",
"instance":null,
"operations":[{"name":"turnOn"},{"name":"turnOff"}],
"properties":[{"name":"powerState","powerStateValue":"OFF"}],
"configuration":null
},
{
"name":"connectivity",
"instance":null,
"operations":null,
"properties":[{"name":"reachability"}],
"configuration":null
},
{
"name":"mode",
"instance":"1",
"operations":null,
"properties":null,
"configuration":null
},
{
"name":"mode",
"instance":"2",
"operations":null,
"properties":null,
"configuration":null
},
{
"name":"endpointHealth",
"instance":null,
"operations":null,
"properties":null,
"configuration":null
},
{
"name":"toggle",
"instance":"4",
"operations":[{"name":"turnOn"},{"name":"turnOff"}],
"properties":[{"name":"toggleState","toggleStateValue":"OFF"}],
"configuration":{}
},
{
"name":"range",
"instance":"3",
"operations":null,
"properties":[{"name":"rangeValue","rangeValue":{"value":0}}],
"configuration":{"friendlyName":{"value":{"text":"Set Temperature"}}}
},
{
"name":"range",
"instance":"5",
"operations":null,
"properties":[{"name":"rangeValue","rangeValue":{"value":70}}],
"configuration":{"friendlyName":{"value":{"text":"Air Temperature"}}}
}
]
C
Cameron Walters
The other part that wouldn't fit:
[30/08/2024, 15:07:18] [homebridge-alexa-smarthome] Primary Bedroom Window Fan :::Current state:[
{"featureName":"power","name":"powerState","value":"OFF"},
{"featureName":"toggle","name":"toggleState","value":"OFF"},
{"featureName":"range","name":"rangeValue","value":0,"instance":"3","rangeName":"Set Temperature"},
{"featureName":"range","name":"rangeValue","value":70,"instance":"5","rangeName":"Air Temperature"}
]
j
jason
did you get the other functions working?
T
Tyler Epperson
Just picked up the Vornado TRANSOM AE window fan. On/Off works great but would love to see the plugin support the other functions of the fan (Auto, Fan Speed, Fan In/Exhaust, Temperature Adjust). Thank you for doing this! I can provide logs if needed.
Joey Hage
Tyler Epperson: If you are still interested, can you please upgrade to 2.2.0-alpha.5, turn on debug logging, and share the log output related to the fan? There have been some significant changes on Amazon's end so I need to revisit this.
T
Tyler Epperson
Joey Hage Sure thing! Anything in particular you need from the log? And what's the best way to get it to you. Not keen on posting a log publicly in case I miss anything sensitive.
Joey Hage
On/Off support has been added for fans
Eric Carr
I too am trying to add a Vornado fan that is in my Alexa setup into HomeKit. I have the OSCR37 model. I have the v2.06 version of your plugin and when I start the plugin I am getting the following message:
[30/12/2023, 17:48:06] [HomebridgeAlexaSmartHome] Initialize Devices - UnsupportedDeviceError(Unsupported device: Bedroom Fan with type: FAN. Currently supported device types are: LIGHT,SWITCH,SMARTLOCK,SMARTPLUG,THERMOSTAT,ALEXA_VOICE_ENABLED,AIR_QUALITY_MONITOR,VACUUM_CLEANER.)
I have enabled the Debug logging in the plugin, but I'm not seeing any other information. Is there anything else I can provide to help?
Robert O'Leary
Same for me, have this awesome fan and would be amazing to get the fan into Homekit.
Jeff Byrnes
Joey Hage here you go:
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] Found 2 devices connected to the current Alexa account.
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] BEGIN devices connected to Alexa account
[
{
"displayName": "Nursery Window Fan",
"deviceType": "FAN"
}
]
END devices connected to Alexa account
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] 0 devices provided in settings but 2 matching Alexa smart home devices were discovered.
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] Updating device states
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] Initialize Devices - UnsupportedDeviceError(Unsupported device: Nursery Window Fan with type: FAN. Currently supported device types are: LIGHT,SWITCH,SMARTLOCK,SMARTPLUG,THERMOSTAT,ALEXA_VOICE_ENABLED,AIR_QUALITY_MONITOR.)
[10/26/2023, 4:45:10 PM] [homebridge-alexa-smarthome] Initialize Devices - InvalidDeviceError(Unable to determine device type for: Nursery)
Load More
→