I2C wiring modification:
Note: The pin attached to the ground plane sinks a lot of heat and is pretty hard to solder to.
If anyone has trouble fitting this plastic case in the fan mounting bracket:
You can dremel/sand about half a mill off each bottom side of the Isosceles Trapezium and it may fit as the case is wider at the bottom than the top looking from the short end:
Worked for me your results may vary…
I2C 16 I/O Expander for fan light basic wall switch
I2C Backplane for Environment Sensor and 16 I/O Expander
YAML
i2c:
id: i2c_component
sda: 14
scl: 16
scan: true
# pcf8574 I2C 16 I/O Expander
pcf8574:
- id: 'pcf8574_hub'
address: 0x20
pcf8575: true
switch:
- platform: restart
name: "T-PoE Restart"
- platform: gpio
name: "PCF8574 Pin #1"
pin:
pcf8574: pcf8574_hub
# Use pin number 1
number: 1
# One of INPUT or OUTPUT
mode:
output: true
inverted: false
- platform: gpio
name: "PCF8574 Pin #2"
pin:
pcf8574: pcf8574_hub
# Use pin number 2
number: 2
# One of INPUT or OUTPUT
mode:
output: true
inverted: false
binary_sensor:
- platform: gpio
name: "Input_0"
pin:
pcf8574: pcf8574_hub
number: 0
mode: INPUT
inverted: False
Log
[05:56:18][C][i2c.arduino:039]: SDA Pin: GPIO14
[05:56:18][C][i2c.arduino:040]: SCL Pin: GPIO16
[05:56:18][C][i2c.arduino:041]: Frequency: 50000 Hz
[05:56:18][C][i2c.arduino:044]: Recovery: bus successfully recovered
[05:56:18][I][i2c.arduino:054]: Results from i2c bus scan:
[05:56:18][I][i2c.arduino:060]: Found i2c device at address 0x20
[05:56:18][C][pcf8574:021]: PCF8574:
[05:56:18][C][pcf8574:022]: Address: 0x20
[05:56:18][C][pcf8574:023]: Is PCF8575: YES
[05:56:18][C][switch.gpio:050]: GPIO Switch 'PCF8574 Pin #1'
[05:56:18][C][switch.gpio:051]: Pin: 1 via PCF8574
[05:56:18][C][switch.gpio:073]: Restore Mode: Restore (Defaults to OFF)
[05:56:18][C][switch.gpio:050]: GPIO Switch 'PCF8574 Pin #2'
[05:56:18][C][switch.gpio:051]: Pin: 2 via PCF8574
[05:56:18][C][switch.gpio:073]: Restore Mode: Restore (Defaults to OFF)
[05:56:18][C][gpio.binary_sensor:015]: GPIO Binary Sensor 'Input_0'
[05:56:18][C][gpio.binary_sensor:016]: Pin: 0 via PCF8574
[05:56:26][D][binary_sensor:036]: 'Input_0': Sending state ON
[05:56:27][D][binary_sensor:036]: 'Input_0': Sending state OFF
Two methods of operation thanks to Kraxman
YAML
binary_sensor:
# Physical button on the iFan04-L for testing not related to the PCF8575.
- platform: gpio
id: button_light
pin: GPIO0
on_press:
then:
- light.toggle: fan_light
# PCF8575 enabled basic light switch.
- platform: gpio
name: "Input_0"
pin:
pcf8574: pcf8574_hub
number: 0
mode: INPUT
inverted: true
# Method 1: If the light is on turn it off, if the light is off turn it on, if another source changes the light
# and the physical is in opposite state ignore and leave the current state.
on_press:
then:
- light.turn_on: fan_light
on_release:
then:
- light.turn_off: fan_light
# Method 2: 3-Way Light Switch Emulation.
#on_press:
# then:
# - light.toggle: fan_light
#on_release:
# then:
# - light.toggle: fan_light
# Method 2.1: Same as 2 just a different process.
# on_state:
# then:
# - light.toggle: fan_light
Hi All looks like some great work has gone on in here since I first had a go at this 
Time for a new fan for me so time to add another Sonoff - I’ve got a Hunter fan that came with the usual RF remote add on kit that you see in the US but inside the wiring loom of the fan I found there was 1 additional capacitor & i’m wondering if I can remove it and then just use the 3 found inside the ifan for speed control.
I have seen inisde the older pullcord types that have 2 or 3 but this new fan has no cords for lights or fan speed just the reverse switch and 1 cap is using the RF remote for all controls.
I should be ok to just cut it out and join the wiring ?
Thanks
All the fans I have been in have a capacitor in them like that. Usually you add the sonoff controller in addition to what is there. What I would do is find where the controller is in that fan and remove it and connect the Sonoff to the same wires where it was. As they usually all operate on the same principle wires Motor/Light/Neutral.
NonaSuomy - I used your experience and finally got mine working! So thank you, and the other contributors, for all of your work! Has anyone considered or tried getting Alexa/Google Home integration to control the speed of the fan(s)? Currently with Alexa turning on the fan works but only on the maximum speed. It would be great to be able to say Low/Med/High. Clearly it’s already coded based on the lovelace card Low/Med/High buttons, how do you translate that to a voice command. This is all new to me and I’m not quite sure how to work on it and/or where to start. Is it in the YAML or part of the github code?
This is assuming you already have Alexa setup in HA. Install the Alexa app on your mobile device and do something like this:
Step 1.)
Step 2.)
Step 3.)
Step 4.) Click create routine…
Step 5.)
Step 6.) Click add action…
Step 7.)
Step 8.)
Step 9.)
Step 10.)
Step 11.)
Received my iFan04 tonight. No matter what I’ve tried, I cannot get it to flash any code whatsoever.
Anyone have any documented, reliable suggestions for flashing this board?
It helps when you power the board with 110VAC.
Also helps when you depress the button while applying the power.
It finally flashed. 
I had the same problem you did Fred. I think it’s post #57 where NonaSuomy documented he had issues with flashing and it only worked with 110v.
As a side note, sonoff 1ch relays work fine with 3.3v applied, sonoff 4ch relays need 110v.
With some help from vincentscode, bearer and kraxman got the bleeding edge ENS160+AHT21 module stuff functioning that I mentioned above!
Mentioned again in # ENS160 + AHT21 Module https://www.aliexpress.us/item/3256804712105923.html
# Define the I2C device for iFan04 to the Test Points on the back of the board.
# GPIO04 - TP11 D_RX (SDA)
# GPIO05 - TP10 D_TX (SCL)
i2c:
id: i2c_component
sda: 4
scl: 5
scan: true
external_components:
- source: github://pr#4243
components:
- ens160
sensor:
- platform: aht10
id: aht21_sensor
address: 0x38
temperature:
name: "AHT21 Sensor Temperature"
id: aht21_sensor_temp
humidity:
name: "AHT21 Sensor Humidity"
id: aht21_sensor_humi
update_interval: 55s
- platform: ens160
id: ens160_sensor
address: 0x53
eco2:
name: "ENS160 Sensor eCO2"
id: ens160_sensor_eco2
tvoc:
name: "ENS160 Sensor Total Volatile Organic Compounds"
id: ens160_sensor_tvoc
aqi:
name: "ENS160 Sensor Air Quality Index"
id: ens160_sensor_aqi
# Inject the temp/humi data from the AHT21 into the ENS160 attached module for compensation.
# Makes the gas results more accurate.
temperature: aht21_sensor_temp
humidity: aht21_sensor_humi
update_interval: 60s
[23:03:09][C][aht10:135]: AHT10:
[23:03:09][C][aht10:136]: Address: 0x38
[23:03:09][C][aht10:140]: Temperature 'AHT21 Sensor Temperature'
[23:03:09][C][aht10:140]: Device Class: 'temperature'
[23:03:09][C][aht10:140]: State Class: 'measurement'
[23:03:09][C][aht10:140]: Unit of Measurement: '°C'
[23:03:09][C][aht10:140]: Accuracy Decimals: 2
[23:03:09][C][aht10:141]: Humidity 'AHT21 Sensor Humidity'
[23:03:09][C][aht10:141]: Device Class: 'humidity'
[23:03:09][C][aht10:141]: State Class: 'measurement'
[23:03:09][C][aht10:141]: Unit of Measurement: '%'
[23:03:09][C][aht10:141]: Accuracy Decimals: 2
[23:03:09][C][ens160:191]: ENS160
[23:03:09][C][ens160:192]: Address: 0x53
[23:03:09][C][ens160:193]: Update Interval: 15.0s
[23:03:09][C][ens160:194]: CO2 Sensor 'ENS160 Sensor eCO2'
[23:03:09][C][ens160:194]: Device Class: 'carbon_dioxide'
[23:03:09][C][ens160:194]: State Class: 'measurement'
[23:03:09][C][ens160:194]: Unit of Measurement: 'ppm'
[23:03:09][C][ens160:194]: Accuracy Decimals: 0
[23:03:09][C][ens160:194]: Icon: 'mdi:molecule-co2'
[23:03:09][C][ens160:195]: TVOC Sensor 'ENS160 Sensor Total Volatile Organic Compounds'
[23:03:09][C][ens160:195]: Device Class: 'volatile_organic_compounds'
[23:03:09][C][ens160:195]: State Class: 'measurement'
[23:03:09][C][ens160:195]: Unit of Measurement: 'ppb'
[23:03:09][C][ens160:195]: Accuracy Decimals: 0
[23:03:09][C][ens160:195]: Icon: 'mdi:radiator'
[23:03:09][C][ens160:196]: AQI Sensor 'ENS160 Sensor Air Quality Index'
[23:03:09][C][ens160:196]: Device Class: 'aqi'
[23:03:09][C][ens160:196]: State Class: 'measurement'
[23:03:09][C][ens160:196]: Unit of Measurement: 'index'
[23:03:09][C][ens160:196]: Accuracy Decimals: 0
[23:03:09][C][ens160:196]: Icon: 'mdi:chemical-weapon'
...
[23:03:10][D][sensor:127]: 'AHT21 Sensor Temperature': Sending state 22.74418 °C with 2 decimals of accuracy
[23:03:10][D][sensor:127]: 'AHT21 Sensor Humidity': Sending state 27.45819 % with 2 decimals of accuracy
[23:03:13][D][sensor:127]: 'ENS160 Sensor eCO2': Sending state 404.00000 ppm with 0 decimals of accuracy
[23:03:13][D][sensor:127]: 'ENS160 Sensor Total Volatile Organic Compounds': Sending state 25.00000 ppb with 0 decimals of accuracy
[23:03:13][D][sensor:127]: 'ENS160 Sensor Air Quality Index': Sending state 1.00000 index with 0 decimals of accuracy
Hello guys,
Thanks for the work here.
I’ve installed cpyarger’s version on my iFan04-H.
My fan is quite specific as it is an air extractor for my basement.
I have an issue as the switch works perfectly for maximum speed 3, but it didn’t work for speed 1 and 2.
I’ve modified the ifan.cpp file with the mixed relays
void IFan::set_low() {
digitalWrite(relay_1, HIGH);
digitalWrite(relay_2, LOW);
digitalWrite(relay_3, LOW);
beep();
}
void IFan::set_med() {
digitalWrite(relay_1, HIGH);
digitalWrite(relay_2, HIGH);
digitalWrite(relay_3, LOW);
beep(2);
}
void IFan::set_high() {
digitalWrite(relay_1, HIGH);
digitalWrite(relay_2, LOW);
digitalWrite(relay_3, HIGH);
With this, the situation seems better on speed 2, but it’s not enough to maintain a normal speed, it’s very very slow, almost stopped, and the fan motor is doing a big electric noise and it will destroyed the electric motor long term.
How can I set up a higher speed for speed 2 ?
Sorry not sure if these are meant for all fan use or just large ceiling fans with capacitors in them. Did the device have a speed control before? Some motors state that they should not be used with dimmers etc as they will burnout the coils so be cautious if you care. You could try to turn on all 3 relays and see if that does anything different.
Hello Nona,
My fan is a motor/capactor kind of fan, just like a ceiling one. Its max power is 600W.
Today it is piloted with a 10-postions rotative button.
I’ve tried to integrate the iFan04 at level 10, and also directly from a 220V source.
I’ve tried to change the mixed relays strategy but as soon as I activate relay3 in a speed level (the only one working to get a moving speed), this level is going almost max speed. Relay1+2 mode alone is not enough.
The 3 levels proposed by the iFan04 are probably not adapted to the 600W of my fan.
Do you know what is the power of your standard ceiling fan?
I realize that my 10-positions rotative button is wired for each step.
I should probably use a Shelly2PM (or several) as a switch on the positions I’m interested in to pilot.
It would have been easier.
I’m also thinking about changing the capacitors on the iFan04 (2,5µF and 3µF) by bigger ones : 10µF is the biggest I’ve found. It seems some people who had high speed issues solved the problem by changing to smaller ones. In my case, I need more speed.
What do you think ?
Can someone post (or at least post a link to) the latest and greatest known working code for just the iFan04-L that allows the buzzer to be disabled and has the proper speed ranges, please?
It would be nice to have a post of the definitive code for just the basic fan module and remote itself in one place.
And last (I think…) is the 3.3vdc power from an FTDI232 adapter enough to power the chip for flashing or do we need mains power and then use no 3.3vdc from the flashing adapter?
there seems to be a lot of branches to this thread and some (possibly?) unanswered questions about what works and what doesn’t.
Does anyone know what the differences are between the iFan03 and the iFan04 besides the different capacitors that prevents us from just using that code?
All your questions are answered in the thread above in chronological order. The newest stuff would be in that order.
Some fans act differently than others so it’s kinda subjective to what fan you have to how you have to trigger the relays but if it currently is too slow on MED etc then use the code below.
I have one fan that goes insanely fast if I enable the two MED/HIGH relays so test away and see what happens with yours.
If this happens and you need to customize the relays just fork my code base on github then modify the relay then in the yaml code change the github from mine to yours.
Only TTL USB Adapters with LDO regulators on the board.
If the remote doesn’t work right away and you never programmed the RF remote for the controller you will require an AC connection.
I have read this thread multiple times, there is none of this, it works. The only unanswered things are edge case stuff.
Not mentioned in any place in the thread but the RF remote sometimes doesn’t register it’s being pressed which you then have to press the button multiple times to wake it up. That is why I added the I2C I/O expander. I can just use the old light switch on the wall plugged into the I/O expander. The 120V direct to the controller with no light switch between to always keep the controller online to accept input. (Make sure your switch is separated from the power lines and doesn’t have 120V going through it)
There’s no difference besides the change of capacitor sizes to be more compatible with North America fans ie why the iFan04-L/H model exists. The circuit board was laid out differently to have more reliability but essentially it is identical in components. The only way this code wouldn’t work on the iFan03 is if they use different data pins on the ESP8266. If that is so then you would just have to modify those pins in the code to make it compatible and do the capacitor swap. You can compare the Pinout of the iFan03 here Sonoff iFan03 220V Light and Ceiling Fan Controller (IM190409021) Configuration for Tasmota with my post here which I confirmed with iTead the board manufacture Sonoff Ifan04 - ESPHome working code - #76 by NonaSuomy (Just checked both have the exact same pinout)
Note from the tasmota website about them:
The capacitors in the iFan03 do not set the speed of North America fans correctly. To correct the speeds for US ceiling fans, you need to remove the existing capacitors from the iFan03 and replace them with equivalently electrically rated 5uF (microfarad) capacitors. **Do NOT do this if you are not comfortable using a soldering iron as improperly performing this action could increase the risk of bodily injury or property damage.**
Hope this helps.
Latest YAML
Uncomment I2C stuff if you are playing with that.
ESPHome
# Primary Bedroom Fan
substitutions:
name: ifan-bedroom-001
friendly_name: Primary Bedroom
external_components:
- source: github://nonasuomy/custom_components@master
refresh: 0s
- source: github://pr#4243
components:
- ens160
esphome:
name: ${name}
comment: Sonoff iFan04-L
# This will allow for (future) project identification,
# configuration and updates.
project:
name: cpyarger.sonoff-ifan04-l
version: "1.0"
esp8266:
board: esp01_1m
# Disable logging on serial as it is used by the remote
logger:
baud_rate: 0
# Enable Home Assistant API
api:
services:
- service: fan_cycle
then:
- fan.cycle_speed: the_fan
encryption:
key: !secret encryption_key001
ota:
password: !secret ota_pass001
uart:
tx_pin: GPIO01
rx_pin: GPIO03
baud_rate: 9600
debug:
direction: BOTH
dummy_receiver: false
after:
delimiter: "\n"
sequence:
- lambda: UARTDebug::log_string(direction, bytes);
# Define I2C device
# for an ESP8266/32 SDA is D2 and goes to Arduino's A4
# SCL is D1 and goes to Arduino's A5
#i2c:
# id: i2c_component
# sda: 4
# scl: 5
# scan: true
# PCF8575 light switch input
#pcf8574:
# - id: 'pcf8574_hub'
# address: 0x20
# pcf8575: true
dashboard_import:
package_import_url: github://cpyarger/esphome-templates/sonoff-ifan04-l.yaml@main
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
use_address: !secret use_address001
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "Ifan04-001 Fallback Hotspot"
password: !secret fallbackhotspot001
web_server:
captive_portal:
# Define ENS160 + AHT21 Sensors
#sensor:
# - platform: aht10
# id: aht21_sensor
# address: 0x38
# temperature:
# name: "AHT21 Sensor Temperature"
# id: aht21_sensor_temp
# humidity:
# name: "AHT21 Sensor Humidity"
# id: aht21_sensor_humi
# update_interval: 55s
# - platform: ens160
# id: ens160_sensor
# address: 0x53
# eco2:
# name: "ENS160 Sensor eCO2"
# id: ens160_sensor_eco2
# tvoc:
# name: "ENS160 Sensor Total Volatile Organic Compounds"
# id: ens160_sensor_tvoc
# aqi:
# name: "ENS160 Sensor Air Quality Index"
# id: ens160_sensor_aqi
# Inject the temp/humi data from the AHT21 into the ENS160 attached module for compensation.
# Makes the gas results more accurate.
# temperature: aht21_sensor_temp
# humidity: aht21_sensor_humi
# update_interval: 60s
binary_sensor:
- platform: gpio
id: button_light
pin: GPIO0
on_press:
then:
- light.toggle: fan_light
# - platform: gpio
# name: "Input_0"
# pin:
# pcf8574: pcf8574_hub
# number: 0
# mode: INPUT
# inverted: true
# Method 1: If the light is on turn it off, if the light is off turn it on, if another source changes the light
# and the physical is in opposite state ignore and leave the current state.
# on_press:
# then:
# - light.turn_on: fan_light
# on_release:
# then:
# - light.turn_off: fan_light
# Method 2: 3-Way Light Switch Emulation.
#on_press:
# then:
# - light.toggle: fan_light
#on_release:
# then:
# - light.toggle: fan_light
# Method 2.1: Same as 2 just a different process.
# on_state:
# then:
# - light.toggle: fan_light
output:
- platform: esp8266_pwm
id: led_pin
pin: GPIO13
inverted: true
light:
- platform: ifan
id: fan_light
name: "${friendly_name} Light"
- platform: monochromatic
id: led1
output: led_pin
default_transition_length: 0s
restore_mode: always off
button:
- platform: template
name: ${friendly_name} Cycle Fan
on_press:
then:
- fan.cycle_speed: the_fan
fan:
- platform: ifan
id: the_fan
name: "${friendly_name} Fan"
remote_enable: false
buzzer_enable: false
ifan04:
on_fan:
- lambda: |-
auto call = speed ? id (the_fan).turn_on() : id (the_fan).turn_off();
call.set_speed(speed);
call.perform();
ESP_LOGD("IFAN04", "speed is %d", speed);
on_light:
- light.toggle: fan_light
- lambda: ESP_LOGD("IFAN04", "light trigger");
on_buzzer:
- lambda: ESP_LOGD("IFAN04", "buzzer trigger");
# Restart Device Switch
switch:
- platform: restart
name: "Primary Bedroom Fan Restart"
Home Assistant Card
type: grid
square: false
columns: 1
cards:
- type: custom:mod-card
card_mod:
style:
hui-vertical-stack-card $: |
div#root > * {
--ha-card-border-width: 0px;
}
.: |
hui-vertical-stack-card {
--vertical-stack-card-margin: 3px;
}
ha-card {
background-color: rgba(50,50,50,0.4);
box-shadow: var(--ha-card-box-shadow);
border: var(--ha-card-border-color,var(--divider-color,#e0e0e0)) solid var(--ha-card-border-width,1px);
--ha-card-header-color: white;
--ha-card-background: rgba(50,50,50,0.4);
}
card:
type: vertical-stack
title: Primary Bedroom
cards:
- type: custom:mod-card
card_mod:
style:
hui-horizontal-stack-card$: |
hui-tile-card {
margin-left: 0px !important;
margin-right: 0px !important;
margin-bottom: 0px !important;
width: 150%;
flex: auto !important;
}
hui-button-card {
margin-left: 10px !important;
margin-right: 10px !important;
margin-top: 63px !important;
margin-bottom: 0px !important;
height: 43px;
width: 115px;
flex: auto !important;
}
.: |
ha-card {
}
card:
type: horizontal-stack
cards:
- type: tile
entity: fan.primary_bedroom_fan
name: Ceiling Fan & Light
features:
- type: fan-speed
- type: button
entity: light.primary_bedroom_light
name: Ceiling Fan Light
show_state: false
show_name: false
# - type: entities
# entities:
# - entity: sensor.aht21_sensor_temperature
# name: Temperature
# - entity: sensor.aht21_sensor_humidity
# - entity: sensor.ens160_sensor_air_quality_index
# - entity: sensor.ens160_sensor_eco2
# - entity: sensor.ens160_sensor_total_volatile_organic_compounds