Przegląd
Urządzenia Shelly udostępniają lokalny interfejs webowy, który pozwala sterować i konfigurować urządzenia za pomocą standardowej przeglądarki na komputerze lub urządzeniu mobilnym. Dzięki niemu możesz włączać i wyłączać urządzenia podłączone do Twojego urządzenia, ustawiać harmonogramy oraz konfigurować akcje do wykonania 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:
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 unikalna kombinacja liter i cyfr stanowiąca identyfikator urządzenia.
Po nawiązaniu połączenia z Access Point / AP (siecią Wi‑Fi wymienioną w kroku 1), dostęp do interfejsu webowego uzyskuje się przez wpisanie uniwersalnego adresu IP dla wszystkich urządzeń Shelly 192.168.33.1 w przeglądarce.
Teraz jesteś 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, jeśli urządzenie jest podłączone do internetu. Aby to zrobić, wykonaj następujące kroki:
W interfejsie webowym przejdź do Settings>Wi-Fi.
Wpisz lub wybierz preferowaną sieć Wi‑Fi, a następnie podaj hasło. Alternatywnie możliwe jest połączenie z siecią otwartą, zaznaczając pole wyboru pozwalające na łączenie z otwartymi sieciami Wi‑Fi. Dodatkowo zalecane jest ustawienie statycznego adresu IP.
Pozwól urządzeniu kilka sekund na próbę połączenia z podaną siecią Wi‑Fi. Jeśli wpisane hasło jest nieprawidłowe lub sieć Wi‑Fi ma zbyt 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 jako tekst nad ustawieniami Wi‑Fi pojawi się link zawierający nowy adres IP. Wystarczy skopiować i wkleić ten link do przeglądarki.
Teraz jesteś w interfejsie webowym urządzenia połączonego z internetem. Następnym razem, gdy będziesz potrzebować dostępu do UI, połącz się z tą samą siecią Wi‑Fi co urządzenie i wpisz nowy adres IP, uzyskany w kroku 3. Zalecane jest ustawienie statycznego adresu IP, ponieważ gwarantuje to stały dostęp pod tym konkretnym adresem.
Zrozumienie układu
Interfejs webowy można podzielić na cztery główne sekcje – nagłówek, stopkę, menu główne i główną zawartość.
Nagłówek
Nagłówek składa się z dwóch elementów – nazwy urządzenia po lewej 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. Najazd kursorem na ikonę dostarczy dodatkowych informacji. Legendę z opisem każdej ikony znajdziesz w przewodniku po interfejsie webowym dla danego urządzenia. Zwróć uwagę, że poszczególne przewodniki wyjaśniają tylko funkcje łączności dostępne dla konkretnego urządzenia.
Stopka
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ć poprawnie. Niektóre wcześniejsze wersje interfejsu webowego nie zawierają wszystkich tych elementów.
Menu główne
W wersji desktopowej menu główne znajduje się po lewej stronie, natomiast na urządzeniach mobilnych wygląda jak hamburger menu z ikoną trzech poziomych linii. Zawartość menu różni się w zależności od urządzenia, ale kliknięcie pozycji przenosi na inną stronę. Możesz też wrócić do strony głównej, klikając Home.
Główna zawartość
Klikając element z menu głównego, będziesz poruszać się po interfejsie webowym. Wszystko, co widzisz na ekranie poza nagłówkiem, stopką i menu głównym, uważa się za główną zawartość.
*Uwaga: nie wszystkie zrzuty ekranu interfejsu webowego wyświetlane u góry każdej strony przewodnika (tam, gdzie zrzut jest dostępny) przedstawiają najnowszą wersję. Mogą się więc nieco różnić od aktualnego wyglądu i nie odzwierciedlać interfejsu każdego urządzenia.
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 zawartość po kliknięciu poszczególnych ustawień. Krótkie wprowadzenie do ikon w nagłówku, specyficznych dla tego urządzenia, znajduje się również w opisie strony Home. Nagłówek jest obecny we wszystkich ekranach, nie tylko na stronie Home.
Strona główna
W nagłówku interfejsu webowego zobaczysz pięć ikon, w tym dla AP, Wi‑Fi, Bluetooth, Cloud i MQTT. Oto co oznaczają różne kolory statusu:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Na stronie głównej interfejsu webowego zobaczysz przycisk do włączania i wyłączania urządzenia oraz suwak jasności. Są dwa menu – jedno po lewej i jedno u góry.
Ustawienia - ustawienia światła
W menu ustawień u góry strony głównej znajdziesz ustawienia światła.
Nazwa światła
W tym ustawieniu możesz zmienić nazwę światła, a następnie kliknąć Save settings, aby zapisać nową nazwę. Gdy pojawi się zielony komunikat informujący o pomyślnym zapisaniu ustawień, nazwa światła zostanie zmieniona.
Tryb nocny
Włącz tryb nocny i ustaw jego godziny rozpoczęcia oraz zakończenia. W tym okresie światło będzie świecić z niestandardową jasnością ustawioną suwakiem poniżej godzin startu i zakończenia. Możesz także włączyć akcję, zaznaczając pole obok Enable action, którą następnie skonfigurujesz – po wejściu urządzenia w tryb nocny akcja ta zostanie wykonana. Kliknij Save settings, aby zapisać zmiany.
Akcja po włączeniu zasilania
Ustaw akcję, którą urządzenie ma wykonać po włączeniu zasilania. Możesz wyłączyć to ustawienie lub wybrać Restore last aby przywrócić ostatnią wykonaną akcję urządzenia.
Wskaźniki LED
Wskaźnik LED Wi‑Fi - Urządzenie ma domyślnie diodę sygnalizacyjną za przyciskiem zasilania, która pokazuje status połączenia Wi‑Fi. Jeśli urządzenie jest połączone, niebieskie światło świeci stale. Możesz wybrać jego wyłączenie.
Wskaźnik LED zasilania - Za przyciskiem zasilania znajduje się biała dioda LED, która domyślnie świeci, gdy ściemniacz jest WŁĄCZONY. To ustawienie nosi nazwę Match input. Aby skonfigurować świecenie diody, gdy ściemniacz jest WYŁĄCZONY, wybierz ustawienie Inverted input. Możesz też całkowicie ją wyłączyć lub ustawić, by świeciła zawsze.
Akcje
Skonfiguruj akcje dla swojego urządzenia – twórz nowe akcje, edytuj istniejące lub usuwaj akcje. Tworząc akcje, musisz określić warunek, przy którym akcja ma się wykonać. Możesz też ustawić czas trwania akcji oraz URL, który zostanie wywołany po spełnieniu warunku.
Harmonogramy
Funkcja ta wymaga działającego połączenia z Internetem, aby urządzenie mogło zsynchronizować czas. Pozwala tworzyć, przeglądać, edytować i usuwać harmonogramy.
Są dwa rodzaje harmonogramów: Basic i Advanced.
Aby utworzyć basic harmonogram:
Wybierz dzień/dni tygodnia.
Wybierz przedział czasowy: czas, wschód słońca lub zachód słońca.
-
Ustaw czas dla wybranych dni:
Czas: Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić czas w godzinach i minutach.
Zachód/Wschód słońca: Urządzenie Shelly może włączać/wyłączać (lub wykonać określoną akcję) automatycznie o wschodzie/zachodzie słońca albo o określonym czasie przed lub po wschodzie/zachodzie. Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić czas w godzinach i minutach.
Aby utworzyć advanced harmonogram:
Funkcja zaawansowanego harmonogramu wykorzystuje cron do wykonywania zadań jednym harmonogramem zamiast kilku podstawowych.
Tworzenie harmonogramu zaawansowanego różni się od podstawowego ze względu na menu When to execute.
Zachęca ono do wybrania jednej lub wielu wartości, zakresu wartości lub kroku między wartościami (Wybierz jedną z trzech opcji, klikając Select, Range lub Step dla każdej wartości) dla:
Sekundy (0-59)
Minuty (0-59)
Godziny (0-23)
Dni (1-31)
Miesiące (JAN-DEC)
Dni tygodnia (SUN-SAT)
Aby utworzyć harmonogram, który występuje co sekundę/minutę/godzinę/dzień/miesiąc/dzień tygodnia, po prostu zaznacz pole pod wartościami w wybranej sekcji (sekundy, minuty, godziny, dni, miesiące lub dni tygodnia). Dodatkowo możesz użyć przesunięcia względem wschodu/zachodu słońca, zaznaczając pole obok tej opcji. Spowoduje to wyświetlenie nowego menu z godzinami i minutami. Pozostawienie godzin i minut oraz wybranie wschodu lub zachodu ustawi harmonogram dokładnie na wschód lub zachód słońca. Zmiana wartości godzin i minut utworzy przesunięcie — wpisanie wartości ujemnej spowoduje wykonanie harmonogramu dokładnie [ustawione godziny i/lub minuty] przed wschodem/zachodem, natomiast wpisanie wartości dodatniej spowoduje wykonanie harmonogramu [ustawione godziny i/lub minuty] po wschodzie/zachodzie. Nie możesz wpisać wartości dodatniej dla jednego (godziny/minuty) i ujemnej dla drugiego.
Następnie określ akcję, którą chcesz, aby urządzenie wykonało w sekcji Do what . Kliknij Save po zakończeniu, aby zapisać nowy harmonogram.
W menu Harmonogramy możesz przeglądać wszystkie swoje harmonogramy. Możesz wyświetlać każdy z nich w czasie podstawowym lub zaawansowanym. Widok podstawowy pokazuje czas i dni, w których harmonogram występuje, natomiast widok zaawansowany wyświetla tekst w karcie harmonogramu informujący o kliknięciu po więcej informacji.
Oba widoki wyświetlają akcje powyżej. Jeśli jest więcej niż trzy akcje, są one wyświetlane jako +n, gdzie n to liczba pozostałych akcji niewyświetlonych. Aby włączyć/wyłączyć harmonogram, użyj przycisku przełączającego po prawej.
Timery
Pozwalają automatycznie zarządzać zasilaniem. Możesz użyć:
Auto on: Po wyłączeniu, wyjście przekaźnika zostanie automatycznie włączone po zdefiniowanym czasie (w sekundach).
Auto off: Po włączeniu, wyjście przekaźnika zostanie automatycznie wyłączone po zdefiniowanym czasie (w sekundach).
Ustawienia - urządzenie
Te ustawienia znajdują się w menu po lewej i dotyczą urządzenia.
Ustawienia sieci
Access Point - Skonfiguruj AP urządzenia, w tym włączanie/wyłączanie i ustawienie hasła. Punkt dostępowy urządzenia domyślnie jest siecią otwartą. SSID jest unikalne i nie można go zmienić.
-
WiFi - Zarejestruj urządzenie Shelly, aby połączyć je z maksymalnie 2 różnymi sieciami Wi‑Fi.
Wpisz lub wybierz sieć Wi‑Fi. Można wybrać sieć otwartą i ustawić statyczny adres IP.
Włącz Wi‑Fi 1, lub Wi‑Fi 2, lub oba jednocześnie. Jeśli obie sieci Wi‑Fi 1 i Wi‑Fi 2 są włączone, a urządzenie Shelly rozłączy się z jedną z sieci, połączy się z drugą.
Bluetooth - Wyłącz/włącz Bluetooth przełącznikiem. Domyślne ustawienie Bluetooth urządzenia jest włączone.
Łączność
Cloud - Połączenie Shelly z jego chmurą pozwala na zdalne sterowanie oraz otrzymywanie powiadomień i aktualizacji o urządzeniach. Domyślnie chmura jest włączona. Jeśli wyłączysz obsługę chmury urządzenia, stracisz połączenie z urządzeniem spoza jego lokalnej sieci!
MQTT - Skonfiguruj urządzenie Shelly do wykonywania akcji za pośrednictwem MQTT. Domyślnie MQTT jest wyłączone, ale możesz je włączyć przełącznikiem. Zmiana tych ustawień spowoduje restart urządzenia. Są 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ólną aktualizację statusu), które możesz włączać/wyłączać przełącznikami po prawej. Można również włączyć SSL i wpisać swój serwer, nazwę użytkownika i hasło, ale pamiętaj, że włączenie SSL wpłynie 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 z niego korzysta. Domyślnie to ustawienie jest wyłączone. Aby je włączyć, kliknij przełącznik obok Enable. Wpisz adres usługi w polu tekstowym, a z rozwijanego menu pod SSL Connectivity wybierz *, ca.pem lub user_ca.pem.
Range extender - To ustawienie rozszerza zasięg działania urządzenia, konfigurując je do pracy na większą odległość. Aby włączyć extender, kliknij przełącznik i kliknij Apply.
Ustawienia urządzenia
Device info - Zobacz ID urządzenia, do jakiego Wi‑Fi jest podłączone oraz Wi‑Fi RSSI.
Lokalizacja i strefa czasowa - Twoja strefa czasowa i lokalizacja zostaną wykryte automatycznie, ale możesz zmienić je ręcznie, wybierając strefę czasową z rozwijanego menu i wpisując szerokość oraz długość geograficzną. Jest też przycisk Auto detect location, który ponownie pozwoli urządzeniu automatycznie wykryć lokalizację, jeśli poprzednia próba się nie powiodła.
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 pojawi się monit.
Firmware - W tym ustawieniu możesz zobaczyć ID urządzenia, wersję firmware i build ID oraz Web build ID. Możesz też zobaczyć dostępne nowe wersje, sprawdzić aktualizacje i łatwo zaktualizować urządzenie. Istnieje także opcja wgrania własnego firmware, jednak flashowanie urządzeń niestandardowym firmware nieodwracalnie unieważnia gwarancję urządzenia.
Certyfikat użytkownika - Prześlij niestandardowy certyfikat SSL przez przeciągnięcie i upuszczenie pliku lub przeglądając pliki za pomocą przeznaczonego przycisku.
Tryb Eco - Zmniejsz zużycie energii przez urządzenie poprzez obniżenie częstotliwości CPU i aktywności modemu w trybie Eco. Aby włączyć to ustawienie, kliknij przełącznik obok Enable eco mode a następnie kliknij przycisk Apply aby zapisać zmiany.
Debug - To ustawienie obejmuje debug Mqtt, Websocket i Udp. Aby włączyć którykolwiek z nich, kliknij przełącznik obok konkretnego ustawienia. Dla debugowania Udp zostaniesz też poproszony o wpisanie udp address.
Skrypty
To urządzenie oferuje możliwości skryptowania. Możesz ich użyć, aby dostosować i rozszerzyć funkcjonalność urządzenia zgodnie z potrzebami użytkownika. Skrypty mogą uwzględniać stan urządzenia, komunikować się z innymi urządzeniami lub pobierać dane z zewnętrznych usług, takich jak prognozy pogody. Skrypt to program napisany w podzbiorze JavaScript.
W interfejsie webowym, wchodząc do menu Scripts, zobaczysz istniejące skrypty lub, jeśli ich nie masz, możesz utworzyć nowy lub otworzyć bibliotekę, aby sprawdzić dostępne zasoby. Obok każdego skryptu zobaczysz jego status (czy działa, czy jest zatrzymany) oraz przełącznik umożliwiający uruchomienie skryptu przy starcie. Jeśli skrypt ma błędy, ostatni zapisany błąd zostanie pokazany pod nazwą skryptu.
W widoku edycji skryptu zobaczysz konsolę poniżej oraz wszelkie pojawiające się błędy. Nad polem z kodem znajdują się opcje Save, Start/Stop, lub Delete skryptu. Możesz także uzyskać dostęp do Snippets i Docs klikając odpowiednie etykiety.
Ustawienia zaawansowane
Po kliknięciu strzałki obok tego ustawienia ukażą się ustawienia zaawansowane. Zostały one wyjaśnione poniżej.
KVS
KVS oznacza Key-Value Storage i jest to rodzaj bazy danych nierelacyjnej, która działa, używając prostej metody 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, gdzie zostaniesz poproszony 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 więcej informacji o działaniu KVS dla urządzeń Shelly.
Diagnostyka
Z tego ustawienia możesz pobrać logi debugowania. Włączenie logowania debug bez powodu nie jest zalecane, ponieważ spowolni urządzenie i przyczyni się do starzenia pamięci flash. Jeśli jednak zdecydujesz się je włączyć, możesz też pobrać poprzednie i bieżące logi. Uwaga: opuszczenie tej strony zresetuje logger i dane logów.
HTTP ping
Wpisz URL w przeznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia. Interfejs webowy poinformuje Cię, czy żądanie powiodło się, czy nie powiodło.