Add Support for Smart 3D Oscillating DC Fan (Kogan)#4459
Add Support for Smart 3D Oscillating DC Fan (Kogan)#4459angus-thompson wants to merge 8 commits intomake-all:mainfrom
Conversation
Added configuration for Smart 3D Oscillating DC Fan including entities for fan control, modes, oscillation, and timer settings.
Hide the Timer entity in the configuration and ensure proper formatting of the switch name.
fixed linting
| @@ -0,0 +1,114 @@ | |||
| name: Smart 3D Oscillating DC Fan | |||
There was a problem hiding this comment.
Top level name should be generic, as other models may also match
| range: | ||
| min: 1 | ||
| max: 10 | ||
| - id: 2 |
There was a problem hiding this comment.
I don't think trying to map multiple modes into a boolean oscillate is a good idea, leave this out.
| - dps_val: normal | ||
| value: false | ||
|
|
||
| - entity: select |
There was a problem hiding this comment.
This can be the preset_mode of the fan (use translation_key:: fan_with_presets to pull in translations for most of the below)
| - dps_val: auto | ||
| value: Auto | ||
| - dps_val: "3Dmode" | ||
| value: 3D Mode |
There was a problem hiding this comment.
Aside from 3Dmode, the original tuya dps_val correspond to translated preset_modes already, so can map to themselves. 3D Mode can remain to a string, as it seems like a marketing term that should not be translated, and circulate is only available with the ventilation translation key (which does not have the other modes).
| value: 3D Mode | ||
|
|
||
| - entity: select | ||
| name: Vertical Oscillation |
There was a problem hiding this comment.
HA naming convention is to only capitalise the first word of device and entity names.
| value: "150°" | ||
|
|
||
| - entity: select | ||
| name: Timer |
There was a problem hiding this comment.
Use translation_key: timer instead of the explicit name and icon. Not sure why this is marked as hidden.
| name: option | ||
| mapping: | ||
| - dps_val: cancel | ||
| value: "Off" |
There was a problem hiding this comment.
When using the translation_key, map these to the same string as original tuya values.
2 participants
Added configuration for Smart 3D Oscillating DC Fan including entities for fan control, modes, oscillation, and timer settings.
This is a relatively cheap Tuya based standard pedastal fan in Australia from Kogan link. It has both vertical and horizontal oscillation, vertical oscillation defined by DP 6: Run/Stop, and Horizontal by DP 7 as sweep angle in degrees. Speed is DP 3 as a value between 1 to 10. It also has various modes, which could be incorporated into the fan entity as preset modes, however these unfortunately do not appear in homekit well due to limitations, so for now I have them as a separate entity (and default hidden this as they aren't particularly useful). Noted however this config uses "3D Mode" (vertical and horizontal oscillation) as the oscillate attribute as I think this is more appropriate than using just vertical oscillation, or a set angled of horizontal oscillation as this binary value. Finally it has a timer function, I have included this but also default hidden it as timers in smart home products can be better triggered through automations.