Martin Jerry Fan Speed Controller US-FC-01

Single Gang Decora 4 Speed Fan Controller. This switch has a touch panel with LEDs behind it to indicate the fan speed. It is designed for typical 3 speed ceiling fans. As of the 10/01/2022, Martin Jerry is now offering a TASMOTA Pre-flashed model that doesn't require flashing or even a chip swap!

Pre-Flashed with TASMOTA Purchase on Amazon

NOTE: The pre-flashed version comes with some settings already set in the default firmware on the device. I've included them all below in case the switch is upgraded to a later release of TASMOTA and set to default settings which would remove the preconfigure MJ factory settings.

Detailed video integration

Tasmota Template

None necessary. Tasmota GUI -> Configuration -> Configure Module -> Tuya MCU (54)
OR
issue a Module 54 command on the Tasmota Console.

Settings

Set the following on the TASMOTA Console

Setting	Description
tuyamcu 11,1	Assign Relay1 to dpID 1

Rules

OPTION A: Does NOT turn the fan on when the speed/preset is changed:

Rule1 on TuyaReceived#Data=55AA03070005030400010016 do publish2 stat/%topic%/speed 3,0 endon
      on TuyaReceived#Data=55AA03070005030400010117 do publish2 stat/%topic%/speed 3,1 endon
      on TuyaReceived#Data=55AA03070005030400010218 do publish2 stat/%topic%/speed 3,2 endon
      on TuyaReceived#Data=55AA03070005030400010319 do publish2 stat/%topic%/speed 3,3 endon

OPTION B: The fan turns on when the speed/preset is changed:

Rule1 on TuyaReceived#Data=55AA03070005030400010016 do backlog power1 1 ; publish2 stat/%topic%/speed 3,0 endon
      on TuyaReceived#Data=55AA03070005030400010117 do backlog power1 1 ; publish2 stat/%topic%/speed 3,1 endon
      on TuyaReceived#Data=55AA03070005030400010218 do backlog power1 1 ; publish2 stat/%topic%/speed 3,2 endon
      on TuyaReceived#Data=55AA03070005030400010319 do backlog power1 1 ; publish2 stat/%topic%/speed 3,3 endon

Enable the rule with the following

Rule1 1

Home Assistant Integration

On the TASMOTA Web GUI -> Configuration -> Configure Other

Set a Device Name and Friendly Name 1.(For example: Living Room Fan) Save the changes.

On the TASMOTA Web GUI -> Configuration -> Configure MQTT.

Set your MQTT Settings: Host, User, Password and Topic. You do not need to change the fulltopic or client. Save the Settings

Home Assistant Integration (Auto Discovery)

Defining and enabling the following rules allows for the power and speed of the fan to be automatically discovered in Home Assistant.

In the TASMOTA Console (Main Menu of web UI > Console) paste in the following rules:

Define Rule1

Rule1
ON TuyaReceived#Data=55AA03070005030400010016 DO publish2 stat/%topic%/speed 3,0 ENDON
ON TuyaReceived#Data=55AA03070005030400010117 DO publish2 stat/%topic%/speed 3,1 ENDON
ON TuyaReceived#Data=55AA03070005030400010218 DO publish2 stat/%topic%/speed 3,2 ENDON
ON TuyaReceived#Data=55AA03070005030400010319 DO publish2 stat/%topic%/speed 3,3 ENDON

Enable Rule1

Rule1 1

Define Rule3

Rule3 ON SYSTEM#BOOT DO publish2 homeassistant/fan/%macaddr%_fan/config {"name":"%hostname% Fan","uniq_id":"%macaddr%_fan","stat_t":"stat/%topic%/POWER","cmd_t":"cmnd/%topic%/POWER1","avty_t":"tele/%topic%/LWT","pct_stat_t":"stat/%topic%/speed","pct_val_tpl":"{{ 25 if value|trim == '3,0' else 50 if value|trim == '3,1' else 75 if value|trim == '3,2' else 100 if value|trim == '3,3' else 25 }}","pct_cmd_t":"cmnd/%topic%/EVENT","pct_cmd_tpl":"{{ 'SetPower=0' if value|int(0) == 0 else 'SetSpeed=3,' + (((value|int(0)-1)/25)|int(0))|string }}","speed_count":4,"pl_avail":"Online","pl_not_avail":"Offline","pl_on":"ON","pl_off":"OFF","dev":{"connections":[["mac","%macaddr%"]]}} ENDON

Enable Rule3

Rule3 1

Define Rule2 - OPTION 1 - Power fan ON when speed is selected

Rule2
ON Event#SetPower DO Power1 %value% ENDON
ON Event#SetSpeed DO Backlog Power1 1; TuyaSend4 %value% ENDON

Define Rule2 - OPTION 2 - Do not change power state (i.e., leave off) when speed is selected

Rule2
ON Event#SetPower DO Power1 %value% ENDON
ON Event#SetSpeed DO TuyaSend4 %value% ENDON

Enable Rule2

Rule2 1

Restart Switch

restart 1

Open up Home Assistant, go to Integrations, and under MQTT Devices the fan controller should now be listed.

Change the speed using the percent slider and the percent slider should become active. The percent slider "snaps" to the following preset values:

Selected Slider Value (Range)	Resulting Percent Value	Fan Effect
0	0%	Off
1 - 25	25%	low (turtle)
26 - 50	50%	medium
51 - 75	75%	high
76 - 100	100%	very high

Home Assistant Integration (w/ Named Speed Presets)

If you already have a fan section under the MQTT tag do not duplicate these sections in your Configuration YAML file. Don't forget to change the "fan_living_room" topic to the MQTT topic configured in your fan switch MQTT page of Tasmota from the previous steps

As of 2022.6 Home Assistant MQTT Fan configuration below:

mqtt:
  fan:
    - name: "Living Room Fan"  
      qos: 1
      state_topic: "stat/fan_living_room/POWER"
      command_topic: "cmnd/fan_living_room/POWER"
      availability_topic: "tele/fan_living_room/LWT"
      percentage_state_topic: "stat/fan_living_room/speed"
      percentage_value_template: '{{ ((value | replace("3,","")) | int + 1) * 25 }}'
      percentage_command_topic: "cmnd/fan_living_room/tuyasend4"
      percentage_command_template: "3,{{ ((value | int - 1) / 25) | int }}"
      preset_mode_state_topic: "stat/fan_living_room/speed"
      preset_mode_value_template: '{{ value | replace("3,0", "turtle") | replace("3,1", "low") | replace("3,2", "medium") | replace("3,3", "high") }}'
      preset_mode_command_topic: "cmnd/fan_living_room/tuyasend4"
      preset_mode_command_template: '{{ value | replace("turtle", "3,0") | replace("low", "3,1") | replace("medium", "3,2") | replace("high", "3,3") }}'
      preset_modes:
        - "turtle"
        - "low"
        - "medium"
        - "high"
      payload_available: "Online"
      payload_not_available: "Offline"
      payload_on: "ON"
      payload_off: "OFF"

That's it! Enjoy! If you need help feel free to pop into Discord and ask for a hand.

Bonus Home Assistant Card

HA Dashboard YAML - Utilizing the HACS fan-mode-button-row card

entities:
  - entity: fan.master_fan
    type: custom:fan-mode-button-row
    reverseButtons: true
    sendStateWithMode: true

GPIO Layout

GPIO	Component	Description
GPIO01	Tuya TX	MCU Transmit
GPIO03	Tuya RX	MCU Recieve

ESPHome YAML

substitutions:
  device_name: Fan_name   #CustomizeThis
  friendly_name: Fan  Name #CustomizeThis
  icon: "mdi:light-fan"

esphome:
  name: ${device_name}
  platform: ESP8266
  board: esp01_1m

wifi:
  # https://esphome.io/components/wifi
   
#web_server:
  #port: 80
  # https://esphome.io/components/web_server.html

logger:
  # https://esphome.io/components/logger

api:
  #password: !secret esphome_api_password
  # https://esphome.io/components/api

ota:
  platform: esphome
  #password: !secret esphome_ota_password
  # https://esphome.io/components/ota

uart:
  rx_pin: GPIO3
  tx_pin: GPIO1
  baud_rate: 9600

tuya:

sensor:
  - platform: wifi_signal
    name: ${friendly_name} Wifi Signal
    update_interval: 60s

  - platform: uptime
    name: ${friendly_name} uptime

fan:
  - platform: "tuya"
    name: ${friendly_name} Speed
    switch_datapoint: 1
    speed_datapoint: 3
    speed_count: 4

Pics

Wiring Diagram