mirror of https://github.com/arendst/Tasmota.git
Updated Sonoff RF Bridge 433 (markdown)
blakadder
parent
63da4205ef
commit
a93de0660b
|
|
@ -1,57 +1,38 @@
|
|||
* [Itead Product Page](http://sonoff.itead.cc/en/products/appliances/sonoff-rf-bridge-433)
|
||||
* [Itead Shop](https://www.itead.cc/sonoff-rf-bridge-433.html)
|
||||
* [Itead Wiki](https://www.itead.cc/wiki/Sonoff_RF_Bridge_433)
|
||||
* [How to Flash the RF Bridge](https://github.com/arendst/Sonoff-Tasmota/wiki/How-to-Flash-the-RF-Bridge)
|
||||
* [RF Bridge 433 R2 Information](https://github.com/arendst/Sonoff-Tasmota/issues/1916)
|
||||
|
||||
## Overview
|
||||
|
||||
The bridge has the *ESP chip*, similar to all other Sonoff boards. This chip can be flashed with the Sonoff-Tasmota software. In addition the bridge has an *RF chip* (433MHz) for which there is a custom firmware commonly referred to as 'Portisch'. The original Sonoff RF firmware is limited. By updating the firmware of the RF chip (EFM8BB1 MCU), new features and types of devices become usable. Tasmota supports the Original Sonoff RF firmware and [Portisch firmware](https://github.com/Portisch/RF-Bridge-EFM8BB1).
|
||||
In addition to the ESP8266, the bridge has an *RF chip* (433MHz) for which there is a custom firmware commonly referred to as 'Portisch'. The original Sonoff RF firmware is limited. By updating the firmware of the RF chip (EFM8BB1 MCU), new features and types of devices become usable. Tasmota supports the Original Sonoff RF firmware and [Portisch firmware](https://github.com/Portisch/RF-Bridge-EFM8BB1).
|
||||
|
||||
The RF upgrade requires wiring the bridge and then flashing the firmware via Sonoff-Tasmota Web UI.
|
||||
|
||||
|
||||
The preparation process outline is as follows:
|
||||
|
||||
1. Make sure you read the [Prerequisite](https://github.com/arendst/Sonoff-Tasmota/wiki/Prerequisite) wiki.
|
||||
2. Connect to the bridge via the four flashing pins. Do not plug anything in the micro USB port. Hold pairing button while connecting to power to put ESP into programming mode.
|
||||
3. Flash the ESP with Sonoff-Tasmota software
|
||||
4. Make sure the bridge connects to your wifi.
|
||||
5. (Optional) Flash the RF firmware with Portisch via the Web UI.
|
||||
6. You're ready. Now go figure out how to communicate with your 433MHz devices.
|
||||
|
||||
## Serial Connection
|
||||
|
||||
<img src="https://github.com/arendst/arendst.github.io/blob/master/media/sonoff_bridge_2.jpg" width="250" align="right" />
|
||||
|
||||
Please see the [Hardware Preparation](https://github.com/arendst/Sonoff-Tasmota/wiki/Hardware-Preparation) page for general instructions.
|
||||
|
||||
As always, you need to access the serial interface. The **four serial pins** (3V3, Rx, Tx, GND) connected to the ESP8285 are available on the 5-pin header just next to the switch as can be seen in the image to the right.
|
||||
As always, you need to access the serial interface. The **four serial pins** (3V3, RX, TX, GND) connected to the ESP8285 are available on the 5-pin header just next to the switch as can be seen in the image.
|
||||
|
||||
Move the switch towards the 5-pin header, keep the button on the edge pressed and connect the serial programmer.
|
||||
|
||||
|
||||
Move the switch towards the 5-pin header, keep the button on the edge pressed and connect the serial-to-USB adapter.
|
||||
|
||||
After programming make sure to move the switch away from the 5-pin header to restore connection to the RF microcontroller. Select device Sonoff Bridge in configuration page!!!
|
||||
|
||||
### Video tutorial by alsolh
|
||||
[](http://www.youtube.com/watch?v=XixXbg2T4Ns "")
|
||||
|
||||
|
||||
## Operation
|
||||
During normal operation the serial interface is used at 19200 baud to communicate with the RF microcontroller. It is therefore wise to disable serial logging ([`SerialLog 0`](https://github.com/arendst/Sonoff-Tasmota/wiki/Commands#seriallog)).
|
||||
|
||||
During normal operation the serial interface is used at 19200 baud to communicate with the RF microcontroller. It is therefore wise to disable serial logging ([`SerialLog 0`](Commands#seriallog)).
|
||||
|
||||
The bridge is able to learn up to 16 different remote control commands of fixed code 433 MHz frequency as provided by PT2260, PT2262, PT2264 and EV1527 Transmitters. I was not able to recognize the latest Klik Aan Klik Uit (KaKu) remote control signals but some people managed to use the fixed code KaKu devices like PAR-1000 receiver and PAT-103 transmitter.
|
||||
The bridge is able to learn up to 16 different remote control commands of fixed code at 433 MHz frequency as provided by PT2260, PT2262, PT2264 and EV1527 transmitters. It was not able to recognize the latest Klik Aan Klik Uit (KaKu) remote control signals but some people managed to use the fixed code KaKu devices like PAR-1000 receiver and PAT-103 transmitter.
|
||||
|
||||
Tasmota provides default remote control commands to all 16 keys so you can start using the bridge with a Sonoff 4CH Pro or Sonoff RF device without having the bridge have to learn remote control commands.
|
||||
|
||||
See [Supported Commands](Commands#sonoff-rf-bridge) for available Sonoff RF Bridge 433 specific commands.
|
||||
See [RF Commands](https://github.com/arendst/Sonoff-Tasmota/wiki/Commands#sonoff-rf-bridge) for Sonoff RF Bridge 433 specific commands.
|
||||
|
||||
**IMPORTANT:** In the Module configuration GPIO4 and GPIO5 must be left as **`00 None`**
|
||||
|
||||
## RF Firmware Upgrade
|
||||
**Attention ⚠️️⚠️️⚠️️ There are 2 versions of the `Sonoff RF Bridge 433`: the `R1` and the `R2 V1.0`. Wiring for `R2 V1.0` RF firmware flashing shown on the right.
|
||||
|
||||
|
||||
<img src="https://github.com/arendst/arendst.github.io/raw/master/media/sonoff_bridge_rffw_upgrade.png" width="300" align="right">
|
||||
|
||||
1. This first step will be different depending on your version of the `Sonoff RF Bridge 433`. You will have to connect two wires:
|
||||
|
|
@ -75,41 +56,45 @@ _This section applies only to the R2 revision of the Sonoff RF Bridge_
|
|||
|
||||
<img src="https://user-images.githubusercontent.com/34340210/53682776-39f49700-3cc7-11e9-9184-4cecf2a3a4c3.png" width="250" align="right" />
|
||||
|
||||
Apply this modification if you intend to use USB for powering the device during EFM flash process or if you want to use GPIO4 or GPIO5 for other purposes with the RF Bridge.
|
||||
Apply this modification if you intend to use USB for powering the device during flash process or if you want to use GPIO4 or GPIO5 for other purposes with the RF Bridge.
|
||||
|
||||
The R2 revision boards connect the GPIO4 and GPIO5 pins to the USB data lines of the power connector. Compliant USB chargers/power supplies are expected to short the two pins together, which is no good. These lines are not used by the original firmware, nor by Tasmota. The traces toward the USB power connector need to be cut to avoid interference by the USB wiring. Removing these connections does not interfere with the normal Bridge functionality.
|
||||
|
||||
## Portisch Firmware Specific Usage
|
||||
These sections only apply to the custom Portisch firmware.
|
||||
|
||||
### Learning of Commands with custom Firmware
|
||||
In order to learn Buttons from your remote, go to the Console of your RFBridge.
|
||||
There, enter rfraw 177 and push the buttons on your remote. Repeat each button 2-3 times, as the signal may be different for each try.
|
||||
### Learning Commands with Portisch Firmware
|
||||
In order to learn Buttons from your remote, go to the Console of your RF Bridge.
|
||||
There, enter `rfraw 177` and push the buttons on your remote. Repeat each button 2-3 times, as the signal may be different for each try.
|
||||
This will give you a so called B1 code of your button, which needs to be converted to a B0 code (see below).
|
||||
|
||||
### Sending of Commands with custom Firmware
|
||||
The commands learned with the hacked (Portisch-)Firmware **cannot** be stored in the web interface. Instead, they must be sent via MQTT:
|
||||
openHAB example: `mqtt=">[broker:cmnd/sonoff-8E8329/Backlog:command:ON:RfRaw AAB0210314016703F924180101011001100110010101100110011001010110010101100255; RfRaw 0]`
|
||||
Refer to [this issue](https://github.com/arendst/Sonoff-Tasmota/issues/3973) for further information
|
||||
### Sending Commands with Portisch Firmware
|
||||
The commands learned with Portisch Firmware **cannot** be stored in device memory.
|
||||
Instead, they must be sent as a command.
|
||||
|
||||
Example using MQTT:
|
||||
```
|
||||
cmnd/sonoffRFBridge/Backlog RfRaw AAB0210314016703F924180101011001100110010101100110011001010110010101100255; RfRaw 0]
|
||||
```
|
||||
Refer to [issue #3973](https://github.com/arendst/Sonoff-Tasmota/issues/3973) for further information.
|
||||
|
||||
|
||||
### Interactive B1 to B0 tool
|
||||
An [interactive tool](https://github.com/henfri/bitbuckedconverter/blob/master/BitBucketConverter) was developed to learn Commands/Codes.
|
||||
Process:
|
||||
-Run rfraw 177 in your SonOff console -Push all your remote (each Button 2-3 times)
|
||||
-Save everything from the console that happened after rfraw 177 to a file, e.g., console.txt
|
||||
|
||||
a) Run bitbuckedconverter.py -f console.txt
|
||||
1. Run `rfraw 177` in your SonOff console
|
||||
2. Push all your remote (each Button 2-3 times)
|
||||
3. Save everything from the console that happened after `rfraw 177` to a file, e.g. console.txt
|
||||
4. Run bitbuckedconverter.py -f console.txt
|
||||
- Each line of console.txt will be converted into a B0 string and displayed
|
||||
|
||||
b) Run bitbuckedconverter.py -f console.txt -e
|
||||
5. Run bitbuckedconverter.py -f console.txt -e
|
||||
- Each line of console.txt will be converted into a B0 string and sent to the Bridge
|
||||
|
||||
Then:
|
||||
* If the device reacted as expected, you can enter a name of the button (e.g., "light")
|
||||
* Else enter nothing to try the next
|
||||
* Repeat this until all lines have been tried
|
||||
* The tool will create a list of buttons -and their B0 codes- that have worked (i.e., for which you have specified a name)
|
||||
* The tool will create a list of buttons and their B0 codes that have worked (i.e. for which you have specified a name)
|
||||
* In the end you can test all of these codes
|
||||
|
||||
### B1 to B0 helping tool
|
||||
|
|
@ -133,35 +118,35 @@ In the Tasmota console, send
|
|||
|
||||
This will result in two consecutive messages:
|
||||
1. The first one tells you that you are using one of the new firmware commands
|
||||
`22:58:44 MQT: gvf/cega/bridge1/stat/RESULT = {"RfRaw":"ON"}`
|
||||
`22:58:44 MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":"ON"}`
|
||||
|
||||
2. The second one tells that the EFM8BB1 RF chip new firmware accepts the command and enters raw sniffing mode ('A0' means 'ACK')
|
||||
`22:58:44 MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AAA055"}}`
|
||||
`22:58:44 MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AAA055"}}`
|
||||
|
||||
After that keep pushing one of the buttons on the remote.
|
||||
```
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AAA055"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 04 07F0 0128 00F2 3822 010101010101101001010101101010100103 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0126 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F5 0127 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F7 0125 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07FC 011E 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0122 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F1 012D 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37C8 010101010101101001010101101010100102 55"}}`
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0128 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0124 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: gvf/cega/bridge1/tele/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AAA055"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 04 07F0 0128 00F2 3822 010101010101101001010101101010100103 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0126 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F5 0127 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F7 0125 37DC 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07FC 011E 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0125 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0122 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F1 012D 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37C8 010101010101101001010101101010100102 55"}}`
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F8 0128 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37D2 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0124 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F9 0124 37C8 010101010101101001010101101010100102 55"}}
|
||||
MQT: tele/sonoffRFbridge/RESULT = {"RfRaw":{"Data":"AA B1 03 07F4 0123 37D2 010101010101101001010101101010100102 55"}}
|
||||
```
|
||||
|
||||
Notice that this sequence of messages all start with 'AA' then 'B1' and the last byte '55'
|
||||
|
|
@ -170,7 +155,7 @@ The reason for pushing the remote button for several seconds is to get enough 'A
|
|||
|
||||
Then discard the sequences with 'data values' not equal.
|
||||
|
||||
In the example 'data values' are the '**010101010101101001010101101010100102**' string.
|
||||
In the example 'data values' are the **`010101010101101001010101101010100102`** string.
|
||||
|
||||
Notice that before that 'data values' string there are several 2 byte values (they are called 'buckets'); they are time values in microseconds. The number of 'buckets' is indicated in a previous byte (in the example a 3 or a 4).
|
||||
|
||||
|
|
@ -178,3 +163,10 @@ In the example, discard the first message (it contains 4 buckets, whereas the re
|
|||
Examine the values on the buckets in order to choose the message where more buckets are 'similar'.
|
||||
|
||||
For example messages with '_**37D2**_' in the third bucket are good candidates. Messages with '_**0124**_' in the second bucket are also good candidates. First bucket values are very similar; '_**07F8**_' can be a good one.
|
||||
|
||||
## Official Sources
|
||||
* [Itead Product Page](http://sonoff.itead.cc/en/products/appliances/sonoff-rf-bridge-433)
|
||||
* [Itead Shop](https://www.itead.cc/sonoff-rf-bridge-433.html)
|
||||
* [Itead Wiki](https://www.itead.cc/wiki/Sonoff_RF_Bridge_433)
|
||||
* [How to Flash the RF Bridge](https://github.com/arendst/Sonoff-Tasmota/wiki/How-to-Flash-the-RF-Bridge)
|
||||
* [RF Bridge 433 R2 Information](https://github.com/arendst/Sonoff-Tasmota/issues/1916)
|
||||
Loading…
Reference in New Issue