Spis treści
- Informacje podstawowe
- Instalacja
- Konfiguracja
- Podłączanie czujnika temperatury DS18B20
- Wymiana danych / MQTT
- Konfiguracja openHAB
- Informacje na temat nowych wersji oraz zgłaszanie problemów
Interfejs wymiany danych z przełącznikiem Sonoff
Komunikacja z przełącznikiem zrealizowana jest o protokół MQTT. MQTT to bardzo prosty i lekki protokół do wymiany informacji oparty o mechanizm publikowania wiadomości i subskrybowania się do tematów. Został specjalnie opracowany do wymiany danych w sieciach, gdzie mogą występować niskie przepustowości, długie czasy oczekiwań, czy zwyczajnie problem z jej działaniem. Protokół mimo potencjalnych problemów z siecią zapewnia niezawodność. Idealnie nadaje się do wymiany danych między urządzeniami, IoT, ma szerokie zastosowanie w automatyce.
Wymiana danych między urządzeniami odbywa się za pomocą MQTT Brokera. Broker jest pośrednikiem wymiany informacji między urządzeniami, serwisami, oprogramowaniem.
Wymagania
- Dostęp do MQTT Brokera
Wiadomości MQTT
Temat | Wiadomość | Działanie | |
---|---|---|---|
/sonoff/dual/1/cmd | Wejściowa | ON | Włącza przekaźnik o nazwie 1 |
/sonoff/dual/1/cmd | Wejściowa | OFF | Wyłącza przekaźnik o nazwie 1 |
/sonoff/dual/1/cmd | Wejściowa | ReportStatus | Zwraca aktualny stan przełącznika o nazwie 1: ON – włączony, OFF – wyłączony |
/sonoff/dual/1/state | Wyjściowa | ON | Sonoff publikuje wiadomość ON pod ten temat za każdym razem kiedy przekaźnik o nazwie 1 zostanie włączony |
/sonoff/dual/1/state | Wyjściowa | OFF | Sonoff publikuje wiadomość OFF pod ten temat za każdym razem kiedy przekaźnik o nazwie 1 zostanie wyłączony |
/sonoff/dual/cmd | Wejściowa | reboot:Normal | Uruchamia ponownie przełącznik |
/sonoff/dual/cmd | Wejściowa | reboot:Configuration | Uruchamia przełącznik w tryb konfiguracji przez sieć LAN |
/sonoff/dual/cmd | Wejściowa | reboot:AccessPoint | Uruchamia przełącznik w tryb konfiguracji Access Point |
/sonoff/dual/cmd | Wejściowa | ON | Włącza oba przekaźniki |
/sonoff/dual/cmd | Wejściowa | OFF | Wyłącza oba przekaźniki |
Uwaga:
- Wartość /sonoff/dual/ z powyższej tabeli jest przykładowa. To wartość Temat MQTT ustawiona w konfiguracji przełącznika.
- Wartość /sonoff/dual/1 z powyższej tabeli jest przykładowa. To wartość Temat MQTT z nazwą przekaźnika ustawiona w konfiguracji przełącznika.
Konfiguracja
Aby używać przełącznik Sonoff konieczne jest wprowadzenie do konfiguracji przełącznika informacje na temat MQTT Brokera:
- Host: IP lub nazwa hosta MQTT Brokera
- Port: Port MQTT Brokera, domyślnie 1883
- Użytkownik: Nazwa użytkownika (opcjonalnie)
- Hasło: Hasło użytkownika (opcjonalnie)
- Temat: Temat wiadomości. Można zmodyfikować domyślną wartość. Format:
- /nazwa-tematu/nazwa-sub-tematu/…/ np:
- /sonoff/kuchnia/
- /sonoff/salon/lampa/
- /sonoff/salon/tv/
- /sonoff/salon/audio/
- Każde urządzenie, korzystające z protokołu MQTT musi mieć unikalny temat
- /nazwa-tematu/nazwa-sub-tematu/…/ np:
- Nazwy przekaźników tworzą temat wiadomości MQTT dla każdego z przekaźników
- jeśli pole Temat MQTT to np: /sonoff/kuchnia/
- nazwa przekaźnika 1 to: lampa
- nazwa przekaźnika 2 to: czajnik to
- przekaźnik 1 będzie nasłuchiwał na temacie: /sonoff/kuchnia/lampa
- przekaźnik 2 będzie nasłuchiwał na temacie /sonoff/kuchnia/czajnik
Informacje
- Aktualna wersja firmware nie obsługuje połączenia opartego o SSL
- Zalecana jest konfiguracja MQTT Brokera z koniecznością autentykacji użytkownikiem i hasłem
- Możliwe jest skonfigurowanie Sonoff bez konieczności autentykacji
> Przejdź teraz do informacji, jak skonfigurować openHAB dla przełącznika SonOff