Skip to content

Latest commit

 

History

History
175 lines (156 loc) · 6.01 KB

README.md

File metadata and controls

175 lines (156 loc) · 6.01 KB

Hampton Bay/Fanimation/DawnSun Fan MQTT

Features

  • Added rc codes received to mqtt
  • reboot of disconnected from mqtt for over 30min
  • Added support for percentage based speeds
  • Added support for Hampton Bay A25-TX028 rf remotes made by dawnsun
  • Added support for fanimation 6speed fan remote controls
  • All 3 can operate at the same time
  • Modified rc-switch to handle the hamptonbay 24bit codes and the fanimation 12bit codes
  • Added support to restore current fan state from mqtt retain storage on startup
  • Fixed inverted bits for fanimation
  • Added sleep delay
  • Added support for HarborBreeze UC-9050T/UC-7080T
  • Added support for + and - on fan speeds
  • Added doorbell support (I have mounted mine in the doorbell for good full house coverage of the rf)
  • Stabilize wifi better
  • Added txrcswitch to send raw codes

Overview

ESP8266 project enabling MQTT control for a Hampton Bay fan with a wireless receiver. Wireless communication is performed with a CC1101 wireless transceiver operating at 303 MHz.

This will also monitor for Hampton Bay RF signals so the state will stay in sync even if the original remote is used to control the fan.

Fan control is not limited to a single dip switch setting, so up to 16 fans can be controlled with one ESP8266.

Dependencies

This project uses the following libraries that are available through the Arduino IDE

Hardware

  • ESP8266 development board (Tested with a NodeMCU v2 and a D1 Mini)
  • CC1101 wireless transceiver

Setup

Configuration

Change the WIFI_* and MQTT_* definitions in the sketch to match your network settings before uploading to the ESP.

MQTT

By default, the state/command topics will be

  • Fan on/off (payload ON or OFF)
    • stat/hamptonbay/<fan_id>/fan
    • cmnd/hamptonbay/<fan_id>/fan
  • Fan speed (payload low, medium, or high; the fanimation 6speed fans can also use I,II,III,IV,V,VI to set any of the six speeds, but will only report 3 speeds back via mqtt as homeassistant only supports 3 speeds)
    • stat/hamptonbay/<fan_id>/speed
    • cmnd/hamptonbay/<fan_id>/speed
  • Light on/off (payload ON or OFF)
    • stat/hamptonbay/<fan_id>/light
    • cmnd/hamptonbay/<fan_id>/light

fan_id is a 4-digit binary number determined by the dip switch settings on the transmitter/receiver where up = 1 and down = 0. For example, the dip setting:

1 2 3 4

...corresponds to a fan ID of 1000

Home Assistant

When mqtt support for percentage speeds is supported it will use percent instead of speed cmnd and stat

To use this in Home Assistant as an MQTT Fan and MQTT Light, I'm using this config for hamptonbay

fan:
- platform: mqtt
  name: "Bedroom Fan"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/hamptonbay/1000/fan"
  command_topic: "cmnd/hamptonbay/1000/fan"
  percentage_state_topic: "stat/hamptonbay/1000/percent"
  percentage_command_topic: "cmnd/hamptonbay/1000/percent"
  preset_mode_state_topic: "stat/hamptonbay/1000/speed"
  preset_mode_command_topic: "cmnd/hamptonbay/1000/speed"
  preset_modes:
    - "low"
    - "medium"
    - "high"

light:
- platform: mqtt
  name: "Bedroom Fan Light"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/hamptonbay/1000/light"
  command_topic: "cmnd/hamptonbay/1000/light"

For HarborBreeze

fan:
- platform: mqtt
  name: "Bedroom Fan"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/fanimation/1000/fan"
  command_topic: "cmnd/fanimation/1000/fan"
  percentage_state_topic: "stat/fanimation/1000/percent"
  percentage_command_topic: "cmnd/fanimation/1000/percent"
  preset_mode_state_topic: "stat/fanimation/1000/speed"
  preset_mode_command_topic: "cmnd/fanimation/1000/speed"
  preset_modes:
    - low
    - medium
    - high

light:
- platform: mqtt
  name: "Bedroom Fan Light"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/fanimation/1000/light"
  command_topic: "cmnd/fanimation/1000/light"

For Fanimation (can use low/medium/high, or if FANIMATION6 is defined can also use all 6 speeds)

fan:
- platform: mqtt
  name: "Bedroom Fan"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/fanimation/1000/fan"
  command_topic: "cmnd/fanimation/1000/fan"
  percentage_state_topic: "stat/fanimation/1000/percent"
  percentage_command_topic: "cmnd/fanimation/1000/percent"
  preset_mode_state_topic: "stat/fanimation/1000/speed"
  preset_mode_command_topic: "cmnd/fanimation/1000/speed"
  preset_modes:
    - I
    - II
    - III
    - IV
    - V
    - VI

light:
- platform: mqtt
  name: "Bedroom Fan Light"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"
  state_topic: "stat/fanimation/1000/light"
  command_topic: "cmnd/fanimation/1000/light"

For Doorbells

binary_sensor:
- platform: mqtt
  name: "Doorbell Front"
  state_topic: "stat/doorbell/1/state"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"    
  payload_on: "ON"
  payload_off: "OFF"

- platform: mqtt
  name: "Doorbell Rear"
  state_topic: "stat/doorbell/2/state"
  availability_topic: "tele/rf-fans/LWT"
  payload_available: "Online"
  payload_not_available: "Offline"    
  payload_on: "ON"
  payload_off: "OFF"