Differences

This shows you the differences between two versions of the page.

--- home:rf_control [2021/01/27 16:27]
derek created
+++ home:rf_control [2024/09/22 19:51] (current)
@@ Line 1: / Line 1: @@
 =====Rf Control=====
-Flash and use the [[https://sonoff.tech/product/accessories/433-rf-bridge|Sonoff RF Bridge]] to control RF devices
+Flash and use the [[https://sonoff.tech/product/accessories/433-rf-bridge|Sonoff RF Bridge R2 V1.0]] to control RF devices
 ====Setup====
-Using a [[https://www.aliexpress.com/item/32634246159.html|serial-to-USB converter (FT232RL FTDI USB to TTL)]] and some dupont wires flash the RF bridge ESP with Tasmota, flash the RF chip with the custom Portisch firmware, then reflash the ESP with ESPHome.
+Using a [[https://www.aliexpress.com/item/32634246159.html|serial-to-USB converter (FT232RL FTDI USB to TTL)]] and some dupont wires flash the R2 V1.0 RF bridge ESP with Tasmota, flash the RF chip with the custom Portisch firmware, then reflash the ESP with ESPHome.
-===Preparation===
+===Downloads===
   * Download [[https://github.com/esphome/esphome-flasher/releases|ESPHome-Flasher]]
   * Download ''tasmota.bin'' from [[https://github.com/arendst/Tasmota/releases|Tasmota releases]]
   * Download the entire contents of the [[https://github.com/arendst/Tasmota/tree/master/|Tasmota GitHub project]] via the green Clone or Download button to ensure that the firmware hex files are downloaded properly. The firmware files are located in the ./tools/fw_SonoffRfBridge_efm8bb1/ folder. Select the newest available hex file. Otherwise you may get error "Magic byte is not 0xE9".
-  *
+===Prepare the RF Bridge===
   * Remove the rubber feet from the Sonoff RF Bridge, optionally placing them just next to the screw holes
   * Pull out the circuit board from the casing
@@ Line 15: / Line 16: @@
   * Locate the 5-pin header under near the bottom of the bent up led panel
   * Move the switch position towards the 5-pin header (to the off position)
-  *
-  * Attach the dupont cables to the serial-to-USB converter
+===Flash ESP===
-  *
+  * Make sure the serial-to-USB converter is set to 3.3V mode
+  * Attach the female to male dupont wires to the serial-to-USB converter
+  * Place the male ends of the dupont wires in the RF bridge in the following order, making sure there is good contact:
+    * Serial -> RF Bridge:
+    * VCC -> 3V3
+    * TX -> RX
+    * RX -> TX
+    * GND -> GND
+  * Connect the serial-to-USB adapter to the computer while pressing the button on the edge in order to put the ESP8285 into programming mode to upload the Tasmota firmware
   * If the green led panel lights up and there is no blue flashing light then it is in programming mode
+  * Release the button on the RF bridge
+  * Open ESPHome-Flasher on the PC
+  * Make sure the correct serial port appears and is selected
+  * Select the ''tasmota.bin'' firmware file
+  * Click ''Flash ESP'' and wait for it to finish uploading, fiddling with the pins and retrying if needed
-<code batch batch.bat>
+===Configure Tasmota===
-Downloadable batch file
+  * Using a Wi-Fi device search for a wifi AP named tasmota_XXXXXX-#### (where XXXXXX is a string derived from the device's MAC address and #### is a number) and connect to it
-</code>
+  * It should take you to the Tasmota configuration page automatically
+  * Configure your network details in ''AP1'', the hostname doesn't matter at this stage, and ''Save''
+  * It should connect to your wifi network, use your router to find its IP address
+  * Connect to that address:
+    * ''Configuration'' > ''Configure Module'' > ''Module Type'' > ''Sonoff Bridge (25)''
+    * ''Save'' (It should restart and act as a Sonoff RF Bridge)
+    * ''Console'':
+      * Enter the command: ''SerialLog 0''
+===Flash RF firmware===
+  * Disconnect the RF Bridge from the PC
+  * Keep the switch on the RF Bridge in the ''OFF'' position
+  * On the RF Bridge, connect two wires from GPIO4 to C2D and GPIO5 to C2Ck
+  * Plug the serial adaptor back into the PC
+  * Reconnect to the RF Bridge web UI:
+    * ''Firmware Upgrade'':
+      * ''Upgrade by File Upload'' > Pick the previously downloaded Portisch firmware hex file
+      * ''Start Upgrade'' (This should complete within 60 seconds)
+  * Disconnect the serial adaptor from the PC and remove all the wiring
+  * Switch the ON/OFF switch on the board back to ''ON'' to enable the RF again
+  * Carefully bend the led panel back into place and optionally cut one of the wires to it to disable the relatively bright led
+  * Fit the board into the case again, screwing it in
+===Create and upload ESPHome firmware===
+  * Give the RF bridge a static IP address in your router
+  * Using the ESPHome addon in Home Assistant:
+    * Create a new device with the name ''sonoff_rf_bridge'' and any placeholder text for the network info
+    * Enter the code from the [[#Notes]] section below into the config of the device
+    * ''Save''
+    * Three dot menu on the device > ''Compile''
+    * ''Download Binary''
+  * Power up the RF bridge and load its web UI:
+    * ''Firmware Upgrade'':
+      * ''Upgrade by File Upload'' > Pick the just downloaded ESPHome firmware
+      * ''Start Upgrade'' (This should complete within 60 seconds)
+  * You should get a new device discovered notification in Home Assistant
+  * Agree to add the RF bridge to Home Assistant
+===Learn Codes===
+  * FIXME: learn new RF codes
 ====Update====
@@ Line 31: / Line 84: @@
   * [[https://tasmota.github.io/docs/devices/Sonoff-RF-Bridge-433/]]
   * [[https://next.esphome.io/components/rf_bridge.html]]
+  * [[https://next.esphome.io/components/cover/time_based.html]]
+  * [[https://next.esphome.io/components/cover/template.html]]
 ====Notes====
+ESPHome firmware definition to allow discovery of new RF codes:
+<code yaml>
+substitutions:
+  devicename: sonoff_rf_bridge
+  upper_devicename: Sonoff RF Bridge
+  device_platform: ESP8266
+  device_board: esp01_1m
+  device_ip: 10.0.0.108
+# Enable Web Server (optional)
+# web_server:
+#   port: 80
+<<: !include common/base.yaml
+logger:
+  baud_rate: 0
+uart:
+  tx_pin: 1
+  rx_pin: 3
+  baud_rate: 19200
+api:
+  services:
+    - service: send_rf_code
+      variables:
+        sync: int
+        low: int
+        high: int
+        code: int
+      then:
+        - rf_bridge.send_code:
+            sync: !lambda 'return sync;'
+            low: !lambda 'return low;'
+            high: !lambda 'return high;'
+            code: !lambda 'return code;'
+    - service: learn
+      then:
+        - rf_bridge.learn
+    - service: send_advanced_rf_code
+      variables:
+        length: int
+        protocol: int
+        code: string
+      then:
+        - rf_bridge.send_advanced_code:
+            length: !lambda 'return length;'
+            protocol: !lambda 'return protocol;'
+            code: !lambda 'return code;'
+    - service: start_advanced_sniffing
+      then:
+        - rf_bridge.start_advanced_sniffing
+    - service: stop_advanced_sniffing
+      then:
+        - rf_bridge.stop_advanced_sniffing
+rf_bridge:
+  on_code_received:
+    then:
+      - homeassistant.event:
+          event: esphome.rf_code_received
+          data:
+            sync: !lambda 'char buffer [10];return itoa(data.sync,buffer,16);'
+            low: !lambda 'char buffer [10];return itoa(data.low,buffer,16);'
+            high: !lambda 'char buffer [10];return itoa(data.high,buffer,16);'
+            code: !lambda 'char buffer [10];return itoa(data.code,buffer,16);'
+  on_advanced_code_received:
+    then:
+      - homeassistant.event:
+          event: esphome.rf_advanced_code_received
+          data:
+            length: !lambda 'char buffer [10];return itoa(data.length,buffer,16);'
+            protocol: !lambda 'char buffer [10];return itoa(data.protocol,buffer,16);'
+            code: !lambda 'return data.code;'
+# Turn the Wifi led on for 2 seconds when the button is pressed to show that it's working
+output:
+  - platform: gpio
+    pin:
+      number: GPIO13
+      inverted: True
+    id: output_wifi_led
+light:
+  - platform: binary
+    id: wifi_led
+    output: output_wifi_led
+binary_sensor:
+  - platform: gpio
+    pin: GPIO00
+    id: pairing_button
+    on_press:
+      then:
+        - light.turn_on: wifi_led
+        - delay: 2s
+        - light.turn_off: wifi_led
+</code>

Guides

User Tools

Site Tools

Differences

Page Tools