Przegląd
Urządzenia Shelly udostępniają lokalny interfejs WWW, który pozwala sterować i konfigurować urządzenia za pośrednictwem standardowej przeglądarki na komputerze lub urządzeniu mobilnym. Dzięki niemu możesz włączać i wyłączać podłączone do urządzenia urządzenia, ustawiać harmonogramy oraz konfigurować akcje do wykonania po spełnieniu określonych warunków.
Zauważ, że do korzystania z lokalnego interfejsu WWW 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 Twoje urządzenie Shelly.
Dostęp do interfejsu WWW
Aby uzyskać dostęp do interfejsu WWW:
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 punktem dostępowym urządzenia Access Point / AP (sieć Wi‑Fi wymieniona w kroku 1), dostęp do interfejsu WWW uzyskuje się, wpisując uniwersalny adres IP wszystkich urządzeń Shelly 192.168.33.1 w przeglądarce.
Jesteś teraz w interfejsie WWW swojego urządzenia.
Podłączanie urządzenia do sieci Wi‑Fi
Niektóre ustawienia widoczne w interfejsie WWW są dostępne tylko wtedy, gdy urządzenie jest połączone z internetem. Aby to zrobić, wykonaj następujące kroki:
W interfejsie WWW przejdź do Settings>Wi-Fi.
Wpisz lub wybierz preferowaną sieć Wi‑Fi, a następnie wprowadź jej hasło. Alternatywnie możesz połączyć się z siecią otwartą, zaznaczając pole wyboru zezwalające na łączenie z otwartymi sieciami Wi‑Fi. Zalecane jest także ustawienie statycznego adresu IP.
Poczekaj kilka sekund, aby urządzenie spróbowało połączyć się z podaną siecią Wi‑Fi. Jeśli wpisane hasło jest nieprawidłowe lub sieć Wi‑Fi ma niewystarczającą siłę lub stabilność, w interfejsie WWW pojawi się komunikat informujący, że połączenie nie mogło zostać nawiązane. Po pomyślnym połączeniu z Wi‑Fi nad ustawieniami pojawi się link zawierający nowy adres IP. Skopiuj i wklej ten link do przeglądarki.
Jesteś teraz w interfejsie WWW urządzenia podłączonego do internetu. Następnym razem, gdy będziesz potrzebować dostępu do interfejsu WWW, wystarczy połączyć się z tą samą siecią Wi‑Fi co urządzenie i wpisać nowy adres IP uzyskany w kroku 3. Zaleca się ustawienie statycznego adresu IP, ponieważ gwarantuje to stały dostęp pod tym samym adresem.
Zrozumienie układu
Interfejs WWW 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 i kilku ikon pokazujących główne funkcje sieciowe i łączność urządzenia po prawej. Ikony te mogą obejmować funkcje takie jak Wi‑Fi, Bluetooth, MQTT i inne, a także ikonę informującą o dostępnych aktualizacjach firmware'u. Najedzenie kursorem na ikonę wyświetli dodatkowe informacje. Legenda z wyjaśnieniem znaczenia każdej ikony znajduje się w przewodniku interfejsu WWW dla każdego urządzenia. Pamiętaj, że poszczególne przewodniki opisują tylko funkcje łączności dostępne dla danego urządzenia.
Stopka
Na dole ekranu, od lewej do prawej, znajdują się: nazwa modelu urządzenia, jego ID, wersja interfejsu WWW, wersja firmware'u urządzenia oraz aktualny czas. Jeśli czas nie jest zsynchronizowany, u góry ekranu pojawi się powiadomienie, a niektóre harmonogramy i akcje mogą nie działać poprawnie. Niektóre wcześniejsze wersje interfejsu WWW nie zawierały wszystkich tych elementów.
Menu główne
Wersja desktopowa menu głównego znajduje się po lewej stronie, natomiast na urządzeniu mobilnym wygląda jak menu typu hamburger z ikoną trzech poziomych linii. Menu zawiera różne elementy w zależności od urządzenia, a kliknięcie pozycji przenosi do innej strony. Możesz również wrócić do strony głównej, klikając Home.
Główna zawartość
Klikając element w menu głównym, możesz poruszać się po interfejsie WWW. Wszystko, co widzisz na ekranie z wyłączeniem nagłówka, stopki i menu głównego, jest traktowane jako główna zawartość.
*Zwróć uwagę, że nie wszystkie zrzuty ekranu interfejsu WWW wyświetlane u góry każdej strony przewodnika (tam, gdzie jest zrzut ekranu) przedstawiają najnowszą wersję. Mogą się nieco różnić od najnowszej wersji i niekoniecznie odzwierciedlać wygląd interfejsu WWW każdego urządzenia.
Klasyczny widok strony głównej
Menu główne
Poniżej znajdują się wyjaśnienia poszczególnych ustawień w menu głównym, w tym co jest wyświetlane jako główna zawartość po kliknięciu różnych ustawień. Krótkie wprowadzenie do ikon w nagłówku, specyficznych dla tego urządzenia, jest zawarte również w opisie strony Home. Pamiętaj, że nagłówek jest obecny we wszystkich ekranach, nie tylko na stronie Home.
Strona główna
W interfejsie WWW zobaczysz pięć ikon w nagłówku, w tym ikonę dla AP, Wi‑Fi, Bluetooth, Cloud i MQTT. Oto co oznaczają różne kolory statusu:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Na stronie głównej interfejsu WWW urządzenia dostępne są trzy opcje widoku. W widoku Klasycznym odczyty dla faz są podzielone na kolumny dla każdej fazy — A, B i C. Każda kolumna pokazuje indywidualne odczyty faz, w tym napięcie, natężenie prądu, moc czynną, moc pozorną i współczynnik mocy, a powyższa tabela oznaczona Total pokazuje sumę odczytów dla wszystkich faz.
Odczyty napięcia, natężenia i mocy czynnej są mierzone odpowiednio w woltach, amperach i watach. Moc pozorna jest mierzona w woltoamperach.
Współczynnik mocy może być:
Dodatni (powyżej 0), wskazujący obciążenia indukcyjne.
Ujemny (poniżej 0), wskazujący obciążenia pojemnościowe.
Pod każdą tabelą dla faz A–C znajduje się sekcja zatytułowana Energy last minute. Są to odczyty dla danej fazy z ostatniej minuty, dotyczące energii czynnej i energii czynnej zwróconej w MWh.
Widok diagramu strony głównej
Widok Diagramu wizualizuje odczyty widoczne w Widoku Klasycznym, używając diagramu urządzenia i opisując każdą część odpowiednią wartością. Zobaczysz tu również, że trzy fazy mają swoje odczyty wyświetlane oddzielnie — nad każdą fazą widoczne są odczyty prądu i mocy, podobnie jak w Widoku Klasycznym.
Wykresy energii
W widoku Wykresy energii każda faza ma po dwa menu dedykowane — Phase (i jej nazwa, w tym przypadku A‑C) oraz Phase (jej nazwa, w tym przypadku A‑C) returned. Pomagają one wizualizować wartości energii w Wh z ostatnich 30 minut, rozdzielając moc na czynną i zwróconą. Zauważysz, że ten widok jest bardziej szczegółową wersją menu Energy last minute w Widoku Klasycznym.
W każdym z tych widoków dostępny będzie przycisk Download CVS file. Klikając przycisk < obok tej opcji, możesz wybrać pobranie pliku zawierającego:
Odczyty z ostatnich n godzin, gdzie n to wartość, którą możesz wpisać.
Odczyty z ostatnich n dni, gdzie n to wartość, którą możesz wpisać.
Wszystko — wszystkie dane, które urządzenie zebrało od momentu konfiguracji i pierwszego włączenia.
Po kliknięciu na menu Settings obok overview, zostaniesz przeniesiony do:
Ustawienia licznika energii
Nazwa licznika energii - Nazwij/zmień nazwę swojego EM.
Reverse CT measurement direction - Odwraca kierunek, w którym current transformer (CT) mierzy prąd elektryczny dla jednej lub więcej faz. W zależności od okablowania możesz chcieć zastosować to ustawienie do niektórych lub wszystkich faz (A, B i C). Wybierz fazę/fazy, dla których chcesz zmienić kierunek pomiaru, a następnie kliknij Save Settings.
Wybór trybu migania - Wybierz sposób, w jaki kontrolowana będzie dioda statusu LED urządzenia — przez Active energy lub Apparent energy. Wybrana wielkość elektryczna będzie sterować diodą LED, a stan światła LED będzie zmieniany zgodnie z nią.
Wybór fazy - Wszystkie fazy mogą sterować diodą LED jednocześnie, lub możesz wybrać konkretną fazę, która będzie miała pełną kontrolę nad diodą LED. Jeśli wybierzesz jedną fazę, zmiany odczytów innych faz nie będą wpływać na diodę.
Monitorowanie kolejności faz - Włączenie tego ustawienia pozwoli urządzeniu sprawdzać i powiadamiać o nieprawidłowo umieszczonych Current Transformers (CT) w systemie trójfazowym.
Rejestrator danych
Usuń zapisane dane - Usuń wszystkie odczyty zebrane dotychczas przez urządzenie.
Akcje
Skonfiguruj akcje dla urządzenia — utwórz nowe akcje, edytuj istniejące lub usuń akcje. Przy tworzeniu akcji należy określić warunek, na którym akcja ma zostać uruchomiona. Możesz także ustawić czas trwania akcji oraz adres URL, który ma zostać wywołany, gdy warunek akcji zostanie spełniony.
Ustawienia
Ustawienia sieci
Access Point - Konfiguruj AP urządzenia, w tym włączanie lub wyłączanie (przełącznikiem) oraz ustawianie hasła. Punkt dostępowy urządzenia jest domyślnie siecią otwartą. SSID jest unikalne i nie można go zmienić.
-
Wi‑Fi - Zarejestruj urządzenie Shelly, aby połączyć je z maksymalnie 2 różnymi sieciami Wi‑Fi.
Wpisz (poprzez pole tekstowe) lub wybierz sieć Wi‑Fi, klikając ikonę chevron (strzałkę), aby przeglądać dostępne sieci. Można wybrać sieć otwartą i ustawić statyczny adres IP.
Włącz Wi‑Fi 1, lub Wi‑Fi 2, lub oba jednocześnie (przełącznikiem obok każdego z nich). Jeśli Wi‑Fi 1 i Wi‑Fi 2 są włączone i urządzenie Shelly rozłączy się 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 urządzenia jest włączone.
Ethernet - możesz podłączyć urządzenie za pomocą Ethernet zamiast Wi‑Fi. Podobnie jak w ustawieniach Wi‑Fi, możesz ustawić statyczny adres IP dla urządzenia (co jest zalecane), aby uzyskać dostęp do urządzenia pod tym samym adresem IP za każdym razem. Jeśli statyczny IP jest włączony, zostaniesz poproszony o podanie adresu IP, serwera DNS, bramy i maski sieci.
Łączność
Uwaga dotycząca komunikacji RPC: Gdy wywołanie RPC nie zostanie wykonane, pojawia się baner z komunikatem — 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 - Połączenie urządzenia Shelly z chmurą umożliwia zdalne sterowanie oraz otrzymywanie powiadomień i aktualizacji o urządzeniach. Domyślnie ta opcja jest włączona. Jeśli wyłączysz obsługę chmury, utracisz możliwość połączenia z urządzeniem spoza jego lokalnej sieci!
MQTT - Skonfiguruj urządzenie Shelly do wykonywania akcji za pomocą 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żliwiają komunikację z urządzeniem poprzez powiadomienia RPC) i Generic status update over MQTT (aby uzyskać ogólny status), które możesz włączać/wyłączać przełącznikami po ich prawej stronie. Możesz także włączyć SSL i wpisać serwer, nazwę użytkownika oraz hasło, jednak 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 generuje wyjątek I/O, gdy połączenie przychodzące zostanie zamknięte podczas gdy serwlet nadal go używa. Domyślnie to ustawienie jest wyłączone. Aby je włączyć, kliknij przełącznik obok Enable. Wprowadź adres usługi w polu tekstowym, a z rozwijanego menu pod SSL Connectivity wybierz *, ca.pem lub user_ca.pem.
Wzmacniacz zasięgu - Włączenie funkcji Range extender tworzy hotspot, do którego można podłączać urządzenia Wi‑Fi. Jeśli urządzenie Shelly z włączonym wzmacniaczem zasięgu jest połączone z routerem Wi‑Fi i Internetem, wszystkie urządzenia do niego podłączone również mają dostęp do routera i Internetu.
Nawet jeśli urządzenie Shelly nie jest połączone z routerem Wi‑Fi, wszystkie urządzenia do niego podłączone nadal mogą komunikować się z nim i między sobą. Poniżej znajdują się informacje o klientach AP — ile ich jest, oraz ich konfiguracja IP, adres MAC oraz wewnętrzne i zewnętrzne adresy IP.
-
RPC przez UDP - Komunikuj się z urządzeniem i wysyłaj żądania za pomocą Remote Procedure Call (RPC) przez serwer User Datagram Protocol (UDP). Może to być użyteczne do zdalnego sterowania i monitorowania urządzenia bez potrzeby dedykowanego serwera lub połączenia.
Aby korzystać z tego ustawienia, musisz wprowadzić port nasłuchu i adres docelowy serwera UDP. Port nasłuchu to numer portu, na którym urządzenie będzie nasłuchiwać przychodzących żądań, natomiast adres docelowy to adres IP serwera, do którego żądania będą wysyłane.
Po wprowadzeniu wymaganych informacji możesz używać protokołu RPC over UDP do wysyłania żądań do urządzenia i odbierania odpowiedzi.
Ustawienia urządzenia
Nazwa urządzenia (info) - Zobacz ID urządzenia, sieć Wi‑Fi, z którą jest połączone, oraz Wi‑Fi RSSI.
Restart - Po kliknięciu przycisku Reboot zostaniesz zapytany, czy na pewno chcesz zrestartować urządzenie. Kliknij OK aby zrestartować urządzenie i Cancel jeśli nie chcesz restartować urządzenia.
Przywracanie ustawień fabrycznych - Klikając przycisk Reset wszystkie ustawienia urządzenia zostaną przywrócone do wartości domyślnych. Wszelkie wprowadzone zmiany zostaną cofnięte. Potwierdź chęć przywrócenia ustawień fabrycznych, klikając OK w wyskakującym okienku, lub Cancel aby anulować reset.
Lokalizacja i strefa czasowa - Twoja 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ą. Jest też przycisk Auto detect location, który sprawi, że urządzenie ponownie spróbuje automatycznie wykryć lokalizację, jeśli wcześniej się to nie powiodło.
Jeśli czas urządzenia nie jest zsynchronizowany z aktualnym czasem, harmonogramy i akcje mogą nie działać prawidłowo. Pojawi się komunikat informujący o braku synchronizacji czasu.
Uwierzytelnianie - Jeśli włączysz uwierzytelnianie, zostaniesz poproszony o wpisanie hasła, którego następnie będziesz używać do dostępu do interfejsu WWW urządzenia. Po włączeniu, aby je wyłączyć, kliknij przełącznik i wpisz swoje hasło, gdy zostaniesz o to poproszony.
Firmware - W tym ustawieniu możesz zobaczyć ID urządzenia, wersję firmware'u, build ID i web build ID. Użyj przycisku Copy nad firmware ID lub web build ID, aby skopiować zawartość do schowka. Możesz także sprawdzić dostępne nowe wersje, wyszukać aktualizacje i łatwo zaktualizować urządzenie. Istnieje też opcja wgrania własnego firmware'u, jednak wgrywanie niestandardowego firmware'u powoduje nieodwracalne unieważnienie gwarancji urządzenia.
Certyfikat użytkownika (Konfiguracja TLS) - Prześlij niestandardowy certyfikat urzędu certyfikacji, certyfikat klienta i klucz klienta, przeciągając i upuszczając pliki lub przeglądając pliki poprzez kliknięcie wyznaczonego przycisku. Kliknij Upload aby wgrać pliki oraz Clear aby usunąć pliki, których nie chcesz wysyłać.
Tryb oszczędzania energii - Zmniejsz zużycie energii przez urządzenie poprzez obniżenie częstotliwości CPU i aktywności modemu podczas Trybu 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 debugowanie Mqtt, Websocket i Udp. Aby włączyć dowolne z nich, kliknij przełącznik obok konkretnego ustawienia. Dla debugowania Udp zostaniesz także poproszony o wpisanie Udp address.
Jednostki temperatury - Wybierz jednostki, w których będą wyświetlane zmierzone dane — Celsjusz lub Fahrenheita.
Skrypty
To urządzenie posiada możliwości skryptowania. Możesz ich użyć do dostosowania i rozszerzenia funkcjonalności urządzenia zgodnie z indywidualnymi 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 WWW, przechodząc do menu Scripts, zobaczysz istniejące skrypty, a jeśli ich nie masz, możesz utworzyć nowy lub otworzyć bibliotekę, aby sprawdzić dostępne skrypty. Obok każdego skryptu zobaczysz jego status (czy działa, czy jest zatrzymany) oraz przełącznik pozwalający uruchamiać skrypt przy starcie. Jeśli skrypt zawiera błędy, ostatni zapisany błąd będzie widoczny 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 rozwiną się ustawienia zaawansowane. Zostały one opisane poniżej.
KVS
KVS oznacza Key-Value Storage i jest rodzajem bazy danych nierelacyjnej, działającej poprzez prostą metodę klucz-wartość do przechowywania danych. Na jednym urządzeniu można przechować do 50 par klucz‑wartość. Po kliknięciu przycisku Add value zostaniesz przeniesiony 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ę pod nią w trybie edycji. 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. Włączenie logowania debug bez powodu nie jest zalecane, ponieważ spowolni urządzenie i spowoduje starzenie pamięci flash. Jeśli zdecydujesz się je włączyć, możesz też pobrać poprzednie i aktualne logi. Pamiętaj, że opuszczenie tej strony zresetuje logger i dane logów.
HTTP ping
Wprowadź URL w przeznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia. Interfejs WWW poinformuje Cię, czy żądanie powiodło się, czy nie powiodło.