Przewodnik po Interfejsie Webowym Shelly Plus Smoke

Shelly Plus Smoke web interface guide

Przegląd

Urządzenia Shelly udostępniają lokalny interfejs webowy, który pozwala kontrolować i konfigurować urządzenia za pomocą standardowej przeglądarki na komputerze lub urządzeniu mobilnym. Dzięki niemu możesz włączać lub wyłączać podłączone urządzenia, ustawiać harmonogramy oraz konfigurować akcje wykonywane po spełnieniu określonych warunków.

Zauważ, że do korzystania z lokalnego interfejsu webowego nie jest potrzebne połączenie z internetem ani Shelly Cloud — jedynym wymogiem jest, aby Twoja przeglądarka znajdowała się w tej samej sieci Wi‑Fi co urządzenie Shelly.

Dostęp do interfejsu webowego

Aby uzyskać dostęp do interfejsu webowego:

  1. Podłącz urządzenie do sieci Wi‑Fi o nazwie (SSID) w formacie: "DeviceName-XXXXXXXXXX", gdzie 'DeviceName' to nazwa urządzenia, które chcesz połączyć, a 'XXXXXXXXXX' to unikatowe połączenie liter i cyfr stanowiące identyfikator urządzenia.

  2. Po nawiązaniu połączenia z punktem dostępu urządzenia Access Point / AP (sieć Wi‑Fi wymieniona w kroku 1), uzyskanie dostępu do interfejsu webowego odbywa się poprzez wpisanie uniwersalnego adresu IP dla wszystkich urządzeń Shelly 192.168.33.1 w Twojej przeglądarce.

Jesteś teraz w interfejsie webowym swojego urządzenia.

Podłączanie urządzenia do sieci Wi‑Fi

Niektóre ustawienia widoczne w interfejsie webowym są dostępne tylko wtedy, gdy urządzenie jest połączone z internetem. Aby to zrobić, wykonaj następujące kroki:

  1. W interfejsie webowym przejdź do Settings>Wi-Fi.

  2. Wpisz lub wybierz preferowaną sieć Wi‑Fi, a następnie podaj jej hasło. Alternatywnie możesz połączyć się z siecią otwartą, zaznaczając pole wyboru umożliwiające łączenie z otwartymi sieciami Wi‑Fi. Dodatkowo zaleca się ustawienie statycznego adresu IP.

  3. Poczekaj kilka sekund, aby urządzenie mogło spróbować połączyć się z podaną siecią Wi‑Fi. Jeśli wpisane hasło jest niepoprawne albo sieć Wi‑Fi ma słaby lub niestabilny sygnał, w interfejsie webowym pojawi się komunikat informujący, że połączenie nie mogło zostać nawiązane. Po pomyślnym połączeniu z Wi‑Fi nad ustawieniami Wi‑Fi pojawi się link zawierający nowy adres IP. Skopiuj i wklej ten link do przeglądarki.

Jesteś teraz w interfejsie webowym urządzenia podłączonego do internetu. Następnym razem, gdy będziesz chciał uzyskać dostęp do UI, połącz się z tą samą siecią Wi‑Fi co urządzenie i wpisz nowy adres IP otrzymany w kroku 3. Zalecane jest ustawienie statycznego adresu IP, ponieważ gwarantuje stały dostęp pod tym adresem.

Zrozumienie układu

Interfejs webowy można podzielić na cztery główne sekcje — nagłówek, stopkę, menu główne i główną treść.

Nagłówek

Nagłówek składa się z dwóch elementów — nazwy urządzenia po lewej stronie oraz kilku ikon po prawej, które pokazują główne funkcje sieciowe i łączności urządzenia. Ikony te mogą obejmować funkcje takie jak Wi‑Fi, Bluetooth, MQTT i inne, a także ikonę informującą o dostępności nowych aktualizacji firmware. Najedzenie kursorem myszy na ikonę pokaże dodatkowe informacje. Legenda z opisem znaczenia każdej ikony znajduje się w przewodniku interfejsu webowego dla każdego urządzenia. Zwróć uwagę, że poszczególne przewodniki wyjaśniają tylko funkcje łączności dostępne dla danego urządzenia.

Na dole ekranu, od lewej do prawej, znajdują się: nazwa modelu urządzenia, jego ID, wersja interfejsu webowego, wersja firmware urządzenia oraz aktualny czas. Jeśli czas nie jest zsynchronizowany, otrzymasz powiadomienie u góry ekranu, a niektóre harmonogramy i akcje mogą nie działać prawidłowo. Niektóre wcześniejsze wersje interfejsu webowego nie zawierają wszystkich tych elementów.

Menu główne

Wersja desktopowa menu głównego znajduje się po lewej stronie, natomiast na urządzeniach mobilnych wygląda jak menu hamburgerowe z ikoną trzech poziomych linii. Menu zawiera różne pozycje w zależności od urządzenia, a kliknięcie elementu przenosi do innej strony. Możesz też wrócić do strony głównej, klikając Home.

Główna treść

Klikając pozycję w menu głównym, możesz poruszać się po interfejsie webowym. Wszystko, co widzisz na ekranie z wyjątkiem nagłówka, stopki i menu głównego, jest uważane za główną treść.

*Prosimy pamiętać, że nie wszystkie zrzuty ekranu interfejsu webowego wyświetlane na początku każdej strony przewodnika (tam, gdzie jest zrzut ekranu) przedstawiają najnowszą wersję. Mogą się więc nieco różnić od najnowszej wersji i nie odzwierciedlać wyglądu interfejsu wszystkich urządzeń.

Menu Główne

Poniżej znajdują się wyjaśnienia każdego ustawienia w menu głównym, w tym tego, co jest wyświetlane jako główna treść po kliknięciu poszczególnych ustawień. Krótkie wprowadzenie do ikon w nagłówku, specyficznych dla tego urządzenia, znajduje się także w opisie strony Home. Nagłówek jest obecny na wszystkich ekranach, nie tylko na stronie Home.

Strona główna

W interfejsie webowym w nagłówku zobaczysz pięć ikon, w tym dla AP, Wi‑Fi, Bluetooth, Cloud i MQTT. Oto co oznaczają różne kolory statusu:

  • AP ikona :

    • Szary: tryb AP jest wyłączony.

    • Niebieski: tryb AP jest włączony.

  • Wi‑Fi ikona :

    • Szary: połączenie Wi‑Fi jest wyłączone.

    • Biały: połączenie Wi‑Fi jest włączone, ale nie zostało nawiązane.

    • Niebieski: urządzenie jest połączone z Wi‑Fi.

  • Bluetooth ikona :

    • Szary: połączenie jest wyłączone.

    • Niebieski: połączenie jest włączone.

  • Cloud ikona :

    • Szary: połączenie z Shelly Cloud jest wyłączone.

    • Biały: połączenie z Shelly Cloud jest włączone, ale nie zostało nawiązane.

    • Niebieski: urządzenie jest połączone z Shelly Cloud.

  • MQTT ikona :

    • Szary: MQTT jest wyłączone.

    • Niebieski: MQTT jest włączone.

package.png
  • Aktualizacja firmware ikona:

    • Niebieski: dostępna jest nowa stabilna wersja firmware dla Twojego urządzenia.

    • Nie pojawia się: Firmware urządzenia jest aktualny.

websocket.svg

  • Połączenie websocket ikona:

    • Niebieski: Websocket połączony.

    • Szary: Websocket nie jest połączony.

battery.svg

  • Ikona baterii

    • Wyświetla status baterii przez 4 ikony stanu, odpowiadające procentom (100% do 0%).

battery_charging.svg

  • Ikona ładowania

    • Pojawia się, gdy zewnętrzne źródło zasilania (np. USB) jest podłączone do urządzenia zasilanego baterią.

Na tej stronie wyświetlany będzie również stan czujnika dymu (czy wykryto dym, czy nie), który może być albo ON (wykryto dym) albo OFF (dym nie został wykryty). Poniżej widoczny jest również procent naładowania baterii Twojego Shelly Plus Smoke, informujący, kiedy urządzenie ma niski poziom zasilania.

Ustawienia

Ustawienia sieci

  • Access Point - Skonfiguruj AP urządzenia, w tym włączanie lub wyłączanie (przełącznikiem) oraz ustawienie hasła. Punkt dostępu urządzenia jest domyślnie siecią otwartą. SSID jest unikatowy i nie można go zmienić.

  • Wi‑Fi - Zarejestruj urządzenie Shelly, aby połączyć je z maksymalnie 2 różnymi sieciami Wi‑Fi.

    Wprowadź (poprzez wpisanie w pole tekstowe) lub wybierz sieć Wi‑Fi, klikając ikonę chevron (strzałkę), aby przeglądać dostępne sieci. Można wybrać sieć otwartą oraz ustawić statyczny adres IP.

    Włącz Wi‑Fi 1, Wi‑Fi 2 lub oba jednocześnie (używając przełącznika obok każdego z nich). Jeśli oba Wi‑Fi 1 i Wi‑Fi 2 są włączone, a urządzenie Shelly utraci połączenie z jedną z sieci, połączy się z drugą. Możliwe jest włączenie Wi‑Fi dopiero po ustawieniu nazwy sieci (SSID). Jeśli urządzenie nie ma innych dostępnych połączeń (AP, Bluetooth, Ethernet (jeśli dotyczy) lub drugiej sieci Wi‑Fi), próba wyłączenia Wi‑Fi spowoduje pojawienie się okienka z pytaniem, czy chcesz kontynuować.

  • Bluetooth - Wyłącz/włącz Bluetooth, przesuwając przełącznik. Domyślne ustawienie Bluetooth w urządzeniu jest włączone.

Łączność

Uwaga dotycząca komunikacji RPC: Gdy wywołanie RPC nie zostanie wykonane, pojawia się baner — informuje on, że urządzenie nie odpowiada na czas i utraciło połączenie. Po przywróceniu połączenia żądanie zostanie wysłane ponownie.

  • Cloud - Podłączenie Shelly do chmury pozwala na zdalne sterowanie oraz otrzymywanie powiadomień i aktualizacji o urządzeniach. Domyślnie chmura jest włączona. Jeśli wyłączysz wsparcie chmury dla urządzenia, stracisz dostęp do urządzenia spoza jego lokalnej sieci!

  • MQTT - Skonfiguruj urządzenie Shelly do wykonywania akcji przez MQTT. Domyślnie MQTT jest wyłączone, ale możesz je włączyć, przesuwając przełącznik. Zmiana tych ustawień spowoduje ponowne uruchomienie urządzenia. Istnieją też inne ustawienia, takie jak RPC status notifications over MQTT (które umożliwia komunikację z urządzeniem poprzez powiadomienia RPC) oraz Generic status update over MQTT (aby otrzymywać ogólny raport statusu), które możesz włączać/wyłączać za pomocą przełączników po ich prawej stronie. Możesz także włączyć SSL i wpisać swój serwer, nazwę użytkownika i hasło, ale pamiętaj, że włączenie SSL wpłynie negatywnie na żywotność baterii i najprawdopodobniej skróci ją o połowę.

  • Outbound Websocket - Określa, czy kanał HTTP tworzy wyjątek I/O, gdy połączenie przychodzące zostanie zamknięte podczas gdy servlet nadal go używa. Domyślnie to ustawienie jest wyłączone. Aby je włączyć, kliknij przełącznik obok Enable. Wpisz adres usługi w polu tekstowym i z menu rozwijanego pod SSL Connectivity wybierz *, ca.pem lub user_ca.pem.

Ustawienia urządzenia

  • Nazwa urządzenia (info) - Zobacz ID urządzenia, sieć Wi‑Fi, z którą jest połączone, oraz Wi‑Fi RSSI.

  • Lokalizacja i czas - Strefa czasowa i lokalizacja zostaną wykryte automatycznie, ale możesz je zmienić ręcznie, wybierając strefę czasową z menu rozwijanego i wpisując szerokość oraz długość geograficzną. Dostępny jest także przycisk Auto detect location, który ponownie spowoduje automatyczne wykrycie lokalizacji, jeśli poprzednia próba zakończyła się niepowodzeniem.

  • Uwierzytelnianie - Jeśli włączysz uwierzytelnianie, zostaniesz poproszony o wpisanie hasła, którego potem użyjesz do dostępu do Web UI urządzenia. Po włączeniu, aby je wyłączyć, kliknij przełącznik i wpisz hasło uwierzytelniające, gdy zostaniesz o to poproszony.

  • Firmware - W tym ustawieniu możesz zobaczyć ID urządzenia, wersję Firmware i build ID, a także Web build ID. Możesz także zobaczyć dostępne nowe wersje, sprawdzić aktualizacje i łatwo zaktualizować urządzenie. Istnieje również opcja wgrania własnego firmware, jednak wgrywanie niestandardowego oprogramowania trwale unieważnia gwarancję urządzenia.

  • User Certificate (TLS Configuration) - Prześlij niestandardowy urząd certyfikacji, certyfikat klienta i klucz klienta przez przeciągnięcie i upuszczenie plików lub przez przeglądanie plików za pomocą odpowiedniego przycisku. Kliknij Upload aby przesłać pliki oraz Clear aby usunąć pliki, których nie chcesz przesyłać.

  • Debug - To ustawienie obejmuje debugowanie Mqtt, Websocket i Udp. Aby włączyć któreś z nich, kliknij przełącznik obok konkretnego ustawienia. Dla Udp debug zostaniesz również poproszony o wpisanie udp address.

Zaawansowane ustawienia

Po kliknięciu strzałki obok tego ustawienia ujawnią się ustawienia zaawansowane. Zostały opisane poniżej.

KVS

KVS oznacza Key-Value Storage i jest rodzajem bazy danych nierelacyjnej, która działa poprzez prostą metodę klucz‑wartość do przechowywania danych. W jednym urządzeniu można przechować do 50 par klucz‑wartość. Po kliknięciu przycisku Add value przejdziesz do ekranu tworzenia wartości, który poprosi o wpisanie klucza (do 42 znaków) i wartości (do 253 znaków). Pod polem tekstowym dla wartości zobaczysz aktualny typ wartości. Domyślnie typ wartości to Number, ale po wpisaniu tekstu typ zmieni się na String. Aby zapisać klucz, kliknij przycisk Save. Aby edytować istniejącą wartość, kliknij ją. Aby usunąć parę klucz‑wartość, kliknij przycisk Delete który pojawi się poniżej podczas edycji klucza. Kliknięcie znaku zapytania obok nazwy ustawienia przeniesie Cię do dokumentacji API, która dostarczy dalszych informacji o działaniu KVS w urządzeniach Shelly.

Diagnostyka

Z tego ustawienia możesz pobrać logi debugowania. Nie zaleca się włączania logu debug bez powodu, ponieważ spowolni to urządzenie i spowoduje zużycie pamięci flash. Jeśli zdecydujesz się go włączyć, możesz także pobrać poprzednie i bieżące logi. Uwaga: opuszczenie tej strony spowoduje zresetowanie loggera i danych logów.

HTTP ping

Wpisz URL w przeznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia do tego adresu. Interfejs webowy poinformuje Cię, czy żądanie zakończyło się powodzeniem, czy nieudaną próbą.