Sonoff RF Bridge - Tasmota + Portisch

Sonoff RF Bridge z oprogramowaniem Tasmota jest mostkiem między radiem 433MHz a MQTT, które jest bardzo wygodne do integracji z innymi systemami. W tym opisie pokażę jak wgrać Tasmote i zmienić firmware w samym radiu 433MHz zwiększając możliwości urządzenia. 

Chip RF to EFM8BB1, który domyślnie obsługuje tylko protokół 24-bitowy. Jest on wystarczający do większości pilotów ze stałym kodem, ale są np piloty, które nie działają z domyślnym firmware radia.

Wgranie Tasmoty

Wszystkie prezentowane kroki są skrótowe i oparte o oficjalną dokumentację.

1. Rozkręć urządzenie i podłącz programator do pinów RX, TX, 3,3V i GND. 
2. Przestaw przełącznik w pozycję OFF odłączając moduł radia.
3. Pobierz najnowszą wersję Tasmoty, konkretnie plik tasmota.bin
4. Włącz zasilanie podawane z programatora przytrzymując przycisk 'Pairing'.
5. Zainstaluj esptool python setup.py install
6. Wybierz odpowiedni port.
7. Wyczyść pamięć esptool.py --port /dev/ttyUSB0 erase_flash
8. Wgraj Tasmote esptool.py --port /dev/ttyUSB0 write_flash -fs 1MB -fm dout 0x0 tasmota.bin
9. Odłącz programator i przestaw przełącznik w pozycję ON
10. Po włączeniu zasilania podłącz się do sieci WiFi rozgłaszanej przez urządzenie
11. Skonfiguruj moduł jako RF Bridge wybierając Sonoff Bridge (25)
12. Skonfiguruj sieć wifi oraz MQTT

Połowa drogi za nami, w tej chwili mamy wgraną Tasmote z oryginalnym firmware samego modułu radia.

Nietypowe piloty

Jakiś czas temu kupiłem fajny pilot do obsługi rolet i jakie było moje zdziwienie kiedy Sonoff nie wykrywał żadnego przycisku.

Jest to pilot posiadający 16 kanałów, a każdy z nich ma trzy przyciski, no bajka do obsługi wielu rolet. Zacząłem szukać informacji czy czasem nie trzeba go jakoś zaprogramować, myślałem, że może trzeba go nauczyć kodów. Posiadam jeszcze Broadlink RM Pro, więc uruchomiłem tryb uczenia i sprawdziłem, że ten pilot wysyła jakieś kody. Niestety Broadlinka nie można wykorzystać do nasłuchiwania pilotów, można je tylko symulować.
Wróciłem do Sonoffa i postanowiłem zmienić firmware w samym radiu EFM8BB1. Opierałem się o tą instrukcję. 
W tym celu trzeba dokonać małej ingerencji w płytkę jeśli chcemy zasilić urządzenie z USB podczas wgrywania nowego firmware. 

Wgranie Portisch firmware

Na początku trzeba przeciąć dwie ścieżki zaznaczone czerwonym prostokątem na powyższym zdjęciu. Jest to GPIO4 i GPIO5, które podłączone są do wyjścia USB jakoś D+ i D-.

Nie musisz przecinać ścieżek jeśli:

• Zasilasz urządzenie z programatora używając napięcia 3,3V
• Zasilasz z USB, a zasilacz nie zwiera środkowych pinów do masy
• Zasilasz z USB i używasz kabelka bez przewodów D+ i D-, tylko VCC i GND

Następnie wykonaj kroki:

1. Połącz ze sobą GPIO4 z C2D oraz GPIO5 z C2CK. 
2. Przełącz suwak w pozycję OFF i włącz Sonoffa. 
3. Pobierz najnowszy firmware Portisch, 
4. Uruchom Web UI SonOffa i przejdź do 'Firmware Upgrade/Upgrade by File' Upload
5. Wybierz plik z pobranym hex-em dla radia i kliknij Start Upgrade. Musisz chwilę poczekać, aż Sonoff się zrestartuje.
6. Jeśli otrzymasz błąd "Magic byte is not 0xE9" sprawdź wszystkie połączenia.
7. Rozłącz dwa mostki GPIO4 i GPIO5, oraz przełącz suwak w pozycję ON. 
8. Przeciętych ścieżek nie trzeba naprawiać.

Teraz możesz już złożyć urządzenie.

Obsługa RAW Data

Po zaktualizowaniu radia w pierwszej chwili może się wydawać, że nic się nie zmieniło i wszystko działa po staremu. Dzieje się tak, ponieważ musisz ręcznie aktywować funkcję odbierania rozszerzonych kodów.

Przechodzimy do Console, wpisujemy rfraw 166 i enter, a w odpowiedzi powinniśmy dostać potwierdzenie.

Dlaczego 166? Opis poszczególnych kodów można sprawdzić tutaj: Sonoff RF Bridge Commands.

Od teraz możesz już wyłapywać surowe ramki, interesuje nas pozycja RfRaw.Data

RFRAW 166 autostart

Po restarcie Sonoffa domyślna wartość rfraw to 0, czyli urządzenie działa w trybie dekodowania protokołu 24-bitowego, tak jak przed zmianą firmware. Ręczne ustawianie wartości  rfraw 166 po każdym restarcie raczej mija się z celem, możemy poradzić sobie automatyzując ten proces, poprzez ustawienie reguły.

Przejdź do konsoli i wprowadź

Rule1 ON SYSTEM#BOOT D0 rfraw 166 ENDON

Wysyłanie kodu

Niestety z oprogramowanie Portisch nie jest możliwe zdefiniowanie przycisków w WebUI tak aby wysyłały nauczony kod. Należy to zrobić poprzez konsole lub MQTT.

Kod który przechwyciliśmy nie nadaje się wprost do wysyłania. Należy dokonać konwersji. 

Pomijając szczegółowe kwestie to w przypadku pokazanych tutaj pilotów wystarczy zamienić drugi bajt z A6 na A8.

Przykładowo odebraliśmy kod AAA60601BF3486111E55, to musimy wysłać AAA80601BF3486111E55

Jeśli chcemy użyć konsoli w WebUI to wystarczy wprowadzić 

rfraw AAA80601BF3486111E55

Drugim sposobem jest użycie MQTT. Trzeba sprawdzić pod jaką nazwą Sonoff RF Bridge nasłuchuje. Informacja ta znajduje się w 'Information -> MQTT Full Topic', u mnie jest to 'cmnd/tasmota_E4BA92/'

Wysłanie sprowadza się do polecenia w terminalu:

mosquitto_pub -h 192.168.X.X -t 'cmnd/tasmota_E4BA92/Backlog' -m 'RfRaw AAA80601BF3486111E55'

Struktura kodów

Pilot jest tak skonstruowany, że na szczęście nie musimy odczytywać kodów wszystkich przycisków czyli 16*3=48. Jest pewna zależność

Prefix Channel CMD Example

AAA60602BF34861 X 1E55(up) AAA606013E3534AX1E55

3355(down) AAA606013E3534AX3355

5555(stop) AAA606013E3534AX5555

example channel 8 down receive:  AAA606013E3534A83355

example channel 9 up send:       AAA806013E3534A91E55

Home Assistant integracja

Przykładowa integracja odbioru może wyglądać tak:

# COVER 4

- alias: "[DOOYA] Button 4 OPEN"

trigger:

platform: mqtt

topic: rfbridge/RESULT

condition:

condition: template

value_template: '{{ trigger.payload_json.RfRaw.Data == "AAA60602BF3486141E55" }}'

action:

service: cover.open_cover

entity_id: cover.blind_4

Inny pilot działający dokładnie w ten sam sposób, kupiony na Aliexpress: