EIO404 - Stacja bazowa Bluetooth IFM - Bezpłatna instrukcja obsługi

INSTRUKCJA OBSŁUGI EIO404 IFM

Instrukcja obsługi

Stacja bazowa Bluetooth® Mesh IoT

EIO404

▷ Oprogramowanie sprzętowe: 1.55

Spis treści

1 Wstep 5

1.1 Informacje prawne i prawa autorskie.... 5
1.2 Symbolika 5
1.3 Ostrzeżenia.... 5

2 Instrukcje bezpieczeństwa 7

2.1 Cyberbezpieczeństwo....7
2.2 Znak bezpieczeństwa na urządzeniu 8

3 Zastosowanie zgodne z przeznaczeniem 9

3.1 Przewidywalne niewłaściwe użycie 9
3.2 Topologia siatki Bluetooth Mesh 9

4 Działanie.... 11

4.1 Wskazanie wizualne 11
4.2 Interfejs Ethernet.... 11
4.3 Bluetooth LE 11
4.4 Bluetooth Mesh.... 11
4.5 ifm IoT Core 11

5 Montaż 12

5.1 Przegład 12
5.2 Opcje montażowe 12

5.2.1 Montaż bez akcesoriów.... 12
5.2.2 Instalacja z uchwytem kątowym E80335.... 12
5.2.3 Instalacja z urządzeniem montażowym E80336 13
5.2.4 Instalacja z prętami mocującymi E80337 13

5.3 Montaż urządzenia 13

6 Podłączenie elektryczne 14

6.1 Przegład 14
6.2 Ogólne uwagi dotyczące okablowania 14
6.3 Napięcie zasilania.... 14
6.4 Porty Ethernet 15

7 Wyświetlacz i przyciski sterujące.... 16

7.1 Przegład 16
7.2 Dioda LED stanu.... 16

8 Parametryzacja.... 17

8.1 Uwagi dotyczące parametryzacji.... 17

8.1.1 Parametryzacja przez interfejs Bluetooth 17
8.1.2 Parametryzacja przez interfejs Ethernet 17
8.1.3 Instalacja ifm moneo|blue 18
8.1.4 Instalacja ifm moneo|configure 18
8.1.5 Hasło Bluetooth.... 18

8.2 ifm moneo|blue 20

8.2.1 Łaczenie z urządzeniem 20

8.2.1.1 Udostępnianie adapterów Bluetooth Mesh IO-Link 20
8.2.1.2 Usuwanie adaptera Bluetooth Mesh IO-Link z siatki 21

8.2.2 Odczyt informacji identyfikacyjnych.... 22

8.2.3 Konfiguracja ustawień IP.... 22
8.2.4 Ustawianie nazwy siatki Bluetooth Mesh.... 22
8.2.5 Ustawianie nazwy stacji Bluetooth 22
8.2.6 Konfigurowanie połączenia MQTT 22
8.2.7 Konfigurowanie kanału poleceń MQTT 23
8.2.8 Aktualizacja oprogramowania sprzętowego 23

8.2.8.1 Aktualizacja oprogramowania sprzętowego mastera IO-Link 24

8.3 ifm IoT Core REST API 25

8.3.1 Rdzeń IoT firmy ifm: Informacje ogólne 25
8.3.1.1 Dostęp do ifm IoT Core 25
8.3.2 Skrócona instrukcja.... 27
8.3.3 Funkcje ogólne 28

8.3.3.1 Przykład: Zmiana wartości parametru 28
8.3.3.2 Przykład: Odczyt wielu wartości parametrów jednocześnie.... 29
8.3.3.3 Przykład: Wyświetłanie poddrzewa 29
8.3.3.4 Przykład: Przeszukiwanie IoT Core.... 30

8.3.4 Ethernet: Konfiguracja ustawień IP 31

8.3.5 Ethernet: Konfigurowanie ochrony hasłem 31

8.3.5.1 Przykład: Ustawianie hasła sieci Ethernet.... 32
8.3.5.2 Przykład: Żądanie z uwierzytelnieniem 32
8.3.5.3 Przykład: Usuwanie hasła sieci Ethernet.... 33

8.3.6 Bluetooth: Ustawianie nazwy stacji 34

8.3.7 Bluetooth: Konfigurowanie ochrony hasłem 34

8.3.7.1 Przykład: Zmiana hasła Bluetooth.... 34

8.3.8 Zarządzanie siatkąBluetooth Mesh 35

8.3.8.1 Przykład: Skanowanie w poszukiwaniu dostępnych adapterów mesh ..... 35
8.3.8.2 Przykład: Zarejestruj adapter mesh w sieci mesh 36
8.3.8.3 Przykład: Wymiana adaptera mesh.... 36
8.3.8.4 Przykład: Wyrejestrowanie adaptera mesh z sieci mesh.... 37

8.3.9 Zarządzanie adapterami Bluetooth mesh IO-Link 37

8.3.10 Konfigurowanie timerów 38

8.3.10.1 Przykład: Ustawianie interwału zliczania 38
8.3.10.2 Przykład: Uruchomienie licznika 38
8.3.10.3 Przykład: Zatrzymanie licznika 39

8.3.11 Korzystanie z powiadomień. 39

8.3.11.1 Powiadomienia wyzwalane zdarzeniami 40
8.3.11.2 Powiadomienia wyzwalane czasowo.... 40
8.3.11.3 Przykład: Tworzenie powiadomień wyzwalanych czasowo ..... 40
8.3.11.4 Przykład: Utwórz powiadomienie wyzwalane zdarzeniem.... 41
8.3.11.5 Przykład: Wyświetlanie aktywnych powiadomień 42
8.3.11.6 Przykład: Zmiana powiadomienia 42
8.3.11.7 Przykład: Usuwanie powiadomienia 43

8.3.12 Użyj MQTT 43

8.3.12.1 Konfigurowanie połączenia MQTT 44
8.3.12.2 Konfigurowanie kanału poleceń MQTT 45
8.3.12.3 Przykład: Konfiguracja i aktywacja kanału poleceń MQTT.... 45
8.3.12.4 Przykład: Publikowanie temperatury urządzenia do brokera MQTT ..... 47

8.3.13 Resetowanie, ponowne uruchamianie i lokalizowanie urządzenia.... 48
8.3.14 Odczyt i zapis informacji o urządzeniu 48
8.3.15 Odczyt stanu i informacji diagnostycznych 49

8.4 ifm moneo|configure 50

8.4.1 Łaczenie z urządzeniem 50

8.4.1.1 Udostępnianie adapterów Bluetooth Mesh IO-Link 50
8.4.1.2 Usuwanie adaptera Bluetooth Mesh IO-Link z sieci mesh....51

8.4.2 Informacja: Odczyt informacji identyfikacyjnych 52
8.4.3 IoT: Konfiguracja ustawień IP 52
8.4.4 IoT: Konfigurowanie ochrony hasłem 53

8.4.4.1 Ustawianie hasła sieci Ethernet 53
8.4.4.2 Resetowanie hasła sieci Ethernet 53

8.4.5 Bluetooth LE: Ustawianie nazw stacji 54

8.4.6 Bluetooth LE: Konfigurowanie ochrony hasłem 54

8.4.6.1 Zmiana hasła Bluetooth 54

8.4.7 Bluetooth Mesh: Zarządzanie siatką 55
8.4.8 MQTT Konfigurowanie połączenia MQTT 55
8.4.8.1 Kontrolowanie połączenia MQTT 55

8.4.9 MQTT Konfigurowanie kanału poleceń 56

8.4.9.1 Zarządzanie kanałem poleceń MQTT 57

8.4.10 Timer Konfigurowanie timerów 57

8.4.10.1 Uruchamianie timera....57
8.4.10.2 Zatrzymywanie timera....58

8.4.11 ▷ Oprogramowanie sprzętowe: Resetowanie, ponowne uruchamianie i lokalizowanie urządzenia 58

8.5 Wizualizator rdzenia IoT: 59

8.5.1 Aby uruchomić wizualizator IoTCore: 59

8.5.2 Zarządzanie powiadomieniami 59

8.5.2.1 Tworzenie nowych powiadomień. 59

8.5.2.2 Usuwanie powiadomień 60

8.5.3 Dostęp do drzewa IoT Core 61

8.5.3.1 Wyszukiwanie elementów IoT Core 61

8.5.3.2 Dostęp do elementów IoT Core....62

8.5.4 Aktualizacja oprogramowania sprzętowego 63

9 Rozwiązywanie problemów....65

10 Konserwacja, naprawa, utylizacja 66

10.1 Aktualizacja oprogramowania sprzętowego 66

11 Dodatek 67

11.1 ifm IoT Core 67

11.1.1 Profile 67

11.1.2 Typy 68

11.1.3 Ustugi 69

11.1.3.1 Serwis: Utwórz kopie zapasowa 69

11.1.3.2 Serwis: factoryreset....69

11.1.3.3 Serwis: get_credit 69

11.1.3.4 Serwis: getblobdata....69

11.1.3.5 Serwis: getdata 70

11.1.3.6 Serwis: getdatamulti 70

11.1.3.7 Serwis: getidentity.... 70

11.1.3.8 Serwis: getsubscriberlist 71

11.1.3.9 Serwis: gettree 71

11.1.3.10 Serwis: instalacja 72

11.1.3.11 Serwis: install_backup.... 72

11.1.3.12 Serwis: querytree 72

11.1.3.13 Serwis: uruchom ponownie 73

11.1.3.14 Serwis: Zarejestruj 73

11.1.3.15 Serwis: Zastąp 73

11.1.3.16 Serwis: Resetuj....73

11.1.3.17 Serwis: resetpassword 74

11.1.3.18 Serwis: reset_credits....74

11.1.3.19 Serwis: Skanuj 74

11.1.3.20 Serwis: setblock 74

11.1.3.21 Serwis: setdata 74

11.1.3.22 Serwis: setdatamulti 75

11.1.3.23 Serwis: signal 75

11.1.3.24 Serwis: ../start 75

11.1.3.25 Serwis: start_stream_set.... 75

11.1.3.26 Serwis: stop 76

11.1.3.27 Serwis: stream_set 76

11.1.3.28 Serwis: subscribe 76

11.1.3.29 Serwis: unregister 77

11.1.3.30 Serwis: unsubscribe 77

1 Wstęp

Instrukcje, dane techniczne, aprobaty i dodatkowe informacje można znaleźć za pomocą kodu QR na urządzeniu/opakowaniu lub na stronie documentation.ifm.com.

1.1 Informacje prawne i prawa autorskie

© Wszelkie prawa zastrzeżone przez ifm electronic gmbh. Żadna część niniejszej instrukcji nie może być powielana ani wykorzystywana bez zgody firmy ifm electronic gmbh.

• Bluetooth® jest zastrzeżonym znakiem towarowym firmy Bluetooth SIG Inc.
• Apple , logo Apple, iPhone i iPod Touch są znakami towarowymi Apple Inc. zarejestrowanymi w Stanach Zjednoczonych i innych krajach. App Store jest znakiem usługowym firmy Apple Inc.
• System operacyjny iOS® jest zastrzeżonym znakiem towarowym firmy Apple Inc.
• Google® jest zastrzeżonym znakiem towarowym Google LLC.
• System operacyjny Android® jest zastrzeżonym znakiem towarowym firmy Google LLC.
• Android, Google Play i logo Google Play są znakami towarowymi Google Inc.

1.2 Symbolika

√ Wymaganie

Instrukcje

Reakcja, rezultat

[...] Oznaczenie klawiszy i przycisków lub wskazań

→ Odnośnik

Ważna uwaga

Niestosowanie się do instrukcji obsługi może prowadzić do nieprawidłowego działania lub zakłóceń.

Informacja

Nota uzupełniająca

1.3 Ostrzeżenia

Ostrzeżenia wskazują na możliwość zranienia osób i uszkodzenia własności. Pozwala to na bezpieczne obchodzenie się z produktami. Ostrzeżenia są stopniowane następująco:

OSTRZEŻENIE

Ostrzeżenie przed poważnym urazem ciała.

▷ W przypadku niezastosowaniu się do ostrzeżenia, możliwe są ciężkie zranienia włącznie ze śmiertelnymi.

UWAGA

Ostrzeżenie o niewielkim lub średnio grożnym zranieniu

▷ W przypadku niezastosowaniu się do ostrzeżenia, możliwe są niewielkie lub średnio groźne zranienia.

UWAGA

Ostrzeżenie o uszkodzeniu mienia

▷ W przypadku niezastosowaniu się do ostrzeżenia, możliwe są uszkodzenia przedmiotów.

2 Instrukcje bezpieczeństwa

- Opisane urządzenie stanowi element składowy do integracji z systemem.

– Projektant systemu jest odpowiedzialny za jego bezpieczeństwo.
- Projektant systemu przeprowadza analizę ryzyka i tworzy dokumentację, którą powinien otrzymać użytkownik i operator systemu, zgodnie z wymaganiami prawnymi oraz normatywnymi, Ta dokumentacja musi zawierać wszystkie niezbędne informacje i instrukcje bezpieczeństwa dla operatorów, użytkownika i pracowników serwisowych autoryzowanych przez projektanta systemu.

• Przed konfiguracją produktu proszę zapoznać się z tym dokumentem, a następnie przechowywać go przez cały okres użytkowania produktu.
• Produkt musi odpowiadać zamierzonym zastosowaniem i warunkom środowiskowym bez żadnych ograniczeń.
• Produkt należy stosować tylko zgodnie z jego przeznaczeniem (→ Zastosowanie zgodne z przeznaczeniem).
• W przypadku nieprzestrzegania instrukcji obsługi lub danych technicznych może dojść do uszkodzenia ciała i/lub mienia.
• Producent nie ponosi odpowiedzialności ani nie udziela gwarancji w przypadku nieuprawnionej ingerencji w produkt lub jego nieprawidłowego użytkowania.
• Instalacja, połączenie elektryczne, konfiguracja, programowanie, eksploatacja i konserwacja produktu muszą być wykonane przez wykwalifikowanych pracowników upoważnionych do wykonywania odpowiednich prac.
• Chronić urządzenia i kable przed uszkodzeniem.
• Uszkodzone urządzenia należy wymieniać, w przeciwnym razie grozi to pogorszeniem danych technicznych i bezpieczeństwa.

2.1 Cyberbezpieczeństwo

Montaż

Urządzenie jest przystosowane do pracy w bezpiecznym środowisku zgodnie z normą IEC 62443-1-1.

▶ Należy przeprowadzić ocenę ryzyka systemu zgodnie z normą IEC 62443-1-1.

Urządzenie zostało zaprojektowane do pracy za zaporą sieciową.

▶ Należy podjąć środki w celu zapewnienia bezpieczeństwa fizycznego.

Urządzenie nie ma wbudowanej ochrony przed nieautoryzowanym dostępem.

▶ Urządzenie należy obsługiwać wyłącznie w zaufanych sieciach.

Przykłady sieci godnych zaufania (zgodnie z normą IEC 62443-3-1, część 5):

- Wewnętrzne sieci firmowe (Local Area Networks - LANs)

– Sieci zarządzane i zabezpieczone przez dział IT

- Przemysłowe systemy sterowania (Industrial Control Systems - ICS)

– Sieci do sterowania i monitorowania procesów przemysłowych

– ICS są odizolowane od innych sieci

- Połączenie punkt-punkt między urządzeniem a jego bezpośrednim partnerem komunikacyjnym

Interfejs Bluetooth LE

Interfejs Bluetooth LE wykorzystuje metodę parowania JustWorks do ustanowienia kryptograficznie zabezpieczonej komunikacji między urządzeniem a ifm moneo|blue.

▶ Połączenie między urządzeniem a ifm moneo|blue należy nawiązywać wyłącznie w bezpiecznym środowisku.

Interfejs Bluetooth LE urządzenia jest chroniony hasłem. Przy pierwszym logowaniu do urządzenia użytkownik musi zmienić ustawione fabrycznie hasło.

▶ Hasło należy zmieniać wyłącznie w bezpiecznym środowisku.
▶ Wybierz silne hasło zgodnie z polityką firmy.

Interfejs Bluetooth Mesh

Komunikacja Bluetooth Mesh między uczestnikami sieci jest zabezpieczona kryptograficznie po pomyślnym udostępnieniu urządzeń w sieci Bluetooth Mesh.

▶ Udostępniaj urządzenia tylko w bezpiecznym środowisku dla sieci mesh Bluetooth.

Działanie urządzenia

▶ Należy przestrzegać funkcji bezpieczeństwa opisanych w dokumentacji produktu oraz zaleceń dotyczących ich stosowania.

Konserwacja

▶ Należy tworzyć kopie zapasowe konfiguracji i danych systemu zgodnie z procesami zarządzania zmianami obowiązującymi w firmie.
▶ Regularnie sprawdzaj, czy dostępne są aktualizacje oprogramowania dla urządzenia.

Zapewnienie integralności i autentyczności aktualizacji oprogramowania poprzez podjęcie następujących środków organizacyjnych:

▶ Pobierz nowy plik oprogramowania sprzętowego na bezpieczny laptop/komputer PC.
▶ Oblicz wartość skrótu SHA-256 dla pobranego pliku oprogramowania układowego www.ifm.com/cnt/product-security.
▶ Sprawdź, czy obliczona wartość skrótu jest zgodna z wartością skrótu SHA-256 podaną na stronie internetowej ifm.
▶ Zainstaluj plik oprogramowania sprzętowego na urządzeniu za pośrednictwem bezpiecznego połączenia, np. połączenia punkt-punkt.

Wyłączenie z eksploatacji

▶ Należy upewnić się, że żadne poufne informacje nie dostaną się w niepowołane ręce.
▶ Przed wycofaniem urządzenia z eksploatacji należy zawsze przywrócić ustawienia fabryczne systemu.

2.2 Znak bezpieczeństwa na urządzeniu

Znak bezpieczeństwa na urządzeniu:

▶ Należy przestrzegać instrukcji obsługi w celu zapewnienia bezpiecznej eksploatacji urządzenia.

3 Zastosowanie zgodne z przeznaczeniem

Urządzenie może być używane:

• Jako centralny węzeł organizacyjny do konfigurowania i zarządzania siatką Bluetooth Mesh z adapterami Bluetooth Mesh IO-Link jako uczestnikami
• Aby skonfigurować podłączone adaptery Bluetooth Mesh IO-Link i opcjonalnie podłączone urządzenia IO-Link.
• Jako brama między wyższym poziomem IIoT a podłączonymi adapterami Bluetooth Mesh IO-Link do transmisji danych procesowych, a także informacji o stanie i diagnostyce z podłączonych urządzeń IO-Link.

Dozwolone użycie:

• Wewnątrz pomieszczeń
- Z urządzenia należy korzystać wyłącznie w granicach określonych w danych technicznych: → Dane techniczne.

Uwagi istotne dla zatwierdzenia: Ulotka dołączona do opakowania urządzenia i documentation.ifm.com

3.1 Przewidywalne niewłaściwe użycie

Urządzenie nie nadaje się do środowisk o specjalnych wymaganiach w zakresie stabilności mechanicznej (np. wstrząsy/wibracje).

Urządzenie nie nadaje się do użytku w krytycznych aplikacjach. Dane nie są przesyłane w czasie rzeczywistym.

3.2 Topologia siatki Bluetooth Mesh

Zalecana topologia:

Rys. 1: Umieszczenie urządzenia EIO404 w centrum siatki Bluetooth Mesh

▶ Jeśli to możliwe, umieść stację bazową Bluetooth Mesh IoT w centrum siatki Bluetooth Mesh.
▷ Zmniejsza się wykorzystanie sieci.
▷ Stabilność komunikacji jest większa w porównaniu do umieszczenia stacji bazowej na skraju siatki Bluetooth Mesh.

Niezalecana topologia:

Rys. 2: Umieszczenie EIO404 na skraju siatki Bluetooth Mesh

Umieszczenie stacji bazowej Bluetooth Mesh IoT na skraju siatki Bluetooth mesh oznacza, że wszystkie dane muszą być przesyłane przez jeden lub kilka adapterów Bluetooth mesh IO-Link. Prowadzi to do wysokiego wykorzystania tych adapterów i może mieć negatywny wpływ na stabilność i opóźnienia całej siatki Bluetooth mesh.

▶ Należy unikać umieszczania stacji bazowej Bluetooth Mesh IoT na skraju siatki Bluetooth Mesh.
▶ Jeśli centralne pozycjonowanie nie jest możliwe, umieść dodatkowe adaptery Bluetooth Mesh IO-Link jako węzły przekaźnikowe w siatce Bluetooth Mesh.

4 Działanie

4.1 Wskazanie wizualne

Urządzenie posiada diodę LED stanu do wyświetlania informacji o stanie, ostrzeżeń i stanów błędów.

4.2 Interfejs Ethernet

Urządzenie wyposażono w interfejs Ethernet.

• parametryzacja urządzenia
• Parametryzacja siatki Bluetooth Mesh
- Komunikacja Ethernet do poziomu IT (monitorowanie)

4.3 Bluetooth LE

Urządzenie obsługuje komunikację poprzez Bluetooth Low Energy (LE). Za pośrednictwem Bluetooth LE można wykonywać następujące funkcje:

• Parametryzacja stacji bazowej
• Parametryzacja siatki Bluetooth Mesh
• Parametryzacja interfejsu Ethernet
• Parametryzacja połączenia MQTT
- Parametryzacja podłączonych adapterów Bluetooth Mesh IO-Link, w tym podłączonych urządzeń IO-Link

4.4 Bluetooth Mesh

Urządzenie obsługuje protokół Bluetooth Mesh.

Wraz z adapterami Bluetooth Mesh IO-Link EIO344, urządzenie może tworzyć i zarządzać siatką Bluetooth Mesh. Po skonfigurowaniu siatki Bluetooth Mesh urządzenie automatycznie nawiąże połączenie z adapterem Bluetooth Mesh IO-Link (EIO344).

Do stacji bazowej Bluetooth Mesh IoT można podłączyć do 50 adapterów Bluetooth Mesh IO-Link.

Urządzenie oferuje następujące funkcje w sieci Bluetooth Mesh:

• Ustawienie parametrów adaptera
- Ustawienie parametrów podłączonego urządzenia IO-Link
• Monitorowanie danych procesowych (interwał: 1 s ... 24 h)

Szczegółowe informacje na temat adaptera Bluetooth Mesh IO-Link EIO344: documentation.ifm.com

4.5 ifm IoT Core

Urządzenie posiada rdzeń ifm IoT-Core. Rdzeń ifm IoT-Core reprezentuje funkcjonalność urządzenia. Funkcjonalność składa się z zestawu danych, usług i zdarzeń. Elementy ifm IoT-Core są rozmieszczone w obiekcie JSON w hierarchicznej strukturze drzewa. Rdzeń ifm IoT-Core udostępnia te elementy światu zewnętrznemu za pośrednictwem standardowych interfejsów (np. HTTP). Umożliwia to użytkownikowi i innym urządzeniom dostęp do danych (parametrów, danych procesowych), zdarzeń i funkcji (usług) urządzenia.

5 Montaż

5.1 Przegład

1: Otwory gwintowane
2: Zasilanie i połączenia Ethernet

Złącza zasilania i Ethernet można obracać o 270°.

5.2 Opcje montażowe

Do montażu dostępne są opcjonalne akcesoria: documentation.ifm.com

Śruby wymagane do instalacji nie są dołączone do urządzenia.

5.2.1 Montaż bez akcesoriów

Urządzenie można zamontować bez akcesoriów montażowych.

▶ Do montażu należy użyć płaskiej powierzchni montażowej.
▶ Do montażu należy użyć 4 gwintowanych otworów z tyłu urządzenia, Przegład (→ 12).

5.2.2 Instalacja z uchwytem kątowym E80335

Wspornik kątowy służy do bocznego montażu urządzenia.

5.2.3 Instalacja z urządzeniem montażowym E80336

Urządzenie montażowe służy do mocowania urządzenia do zacisku.

5.2.4 Instalacja z prętami mocującymi E80337

Przymocuj urządzenie w miejscu instalacji za pomocą śrub mocujących.

5.3 Montaż urządzenia

▶ Przed montażem należy odłączyć zasilanie urządzenia.

▶ Zainstaluj urządzenie zgodnie z wybraną opcją.
▶ Do mocowania obudowy należy używać wyłącznie śrub M4. Maks. moment dokręcenia: 0,8 Nm.

6 Podłączenie elektryczne

Urządzenie musi zostać podłączone przez wykwalifikowanego elektryka.

Należy zapoznać się z krajowymi i międzynarodowymi przepisami dotyczącymi instalacji urządzeń elektrycznych.

Napięcie zasilania spełniające wymogi SELV, PELV.

▶ Odłączyć zasilanie.

6.1 Przegład

1: Porty Ethernet
2: Napięcie zasilania

6.2 Ogólne uwagi dotyczące okablowania

Przyłącza gwintowane w urządzeniu odpowiadają standardowi M12. Aby zapewnić zgodność z określonym stopniem ochrony, można stosować wyłącznie kable zgodne z tym standardem. W przypadku kabli montowanych samodzielnie za stopień ochrony odpowiada producent systemu.

▶ Należy stosować złącza z pozłacanymi stykami.
▶ Podczas montażu należy ustawić złącza pionowo, aby nakrętka łącząca nie uszkodziła gwintu.
▶ Przed podłączeniem złącza należy sprawdzić, czy w gnieździe znajduje się nieuszkodzony o-ring.
▶ Podczas montażu przestrzegaj kodowania złączek.
▶ Wszystkie przewody wychodzące należy wyposażć w odpowiednie odciążenie po maksymalnie 200 mm.

Dla obszaru zastosowań cULus:

▶ Do podłączenia urządzenia należy używać wyłącznie przewodów kategorii CYJV 2/7/8 z certyfikatem UL i odpowiednimi danymi technicznymi.

6.3 Napięcie zasilania

Urządzenie jest podłączone do zasilania przez port.

UWAGA

Port nie posiada zabezpieczenia nadprądowego.

▷ Ryzyko pożaru
▶ Należy zabezpieczyć obwody.

Schemat połączeń:

1: L+
2: n.c.
3:1-
4: n.c.
5: n.c.

▶ Podłącz port do zasilania.
▶ Do połączenia należy użyć złącza M12.
▶ Dokreć nakrętkę łączącą momentem 0,6...1,5 Nm.

6.4 Porty Ethernet

Urządzenie jest podłączone do sieci IT za pośrednictwem portu.

• Maksymalna długość kabla 20 m

Urządzenie nie może być zasilane zewnętrznie przez port M12.

Schemat połączeń:

1: TX +
2: RX +
3: TX -
4: RX -
5: n.c.

▶ Podłącz port do sieci IT bezpośrednio lub za pośrednictwem elementu łączącego z siecią (np. przełącznika).
▶ Do podłączenia należy użyć złącza M12 (minimalny stopień ochrony): IP 67;
▶ Dokręć nakrętkę łączącą momentem 0,6...1,5 Nm.

7 Wyświetlacz i przyciski sterujące

7.1 Przegład

1: Dioda LED stanu

7.2 Dioda LED stanu

Dioda LED	Opis	Kolor	Stan	Typ	Opis
Status	-	-	Wyt	Błąd	Zbyt niskie napięcie
	Wskazanie pracy	zielony	On	Tryb pracy normalny	Niezawodne działanie urządzenia
			Miga (podwójne mi-gnięcie)	Ostrzeże-nie	Identyfikacja optyczna
			miga z częstotliwo-ścią (200 ms wt., 800 ms wył.)	Uwaga	Aktualizacja oprogramowania sprzętowe-goUWAGA! Poczekaj, aż proces aktualiza-cji zostanie zakończony.
	Wskazanie zakłóceń :	czerwo-ny	On	Wymiana urządzenia	Awaria sprzętu
			Miga (1 Hz)	Błąd	Temperatura płytki drukowanej poza za-kresem tolerancji
			Miga (1 Hz)	Uwaga	Brak połączenia Ethernet
			Miga (1 Hz)	Ostrzeże-nie	Brak połączenia Bluetooth Mesh
	Status Bluetooth	niebieski	On	Uwaga	Aktywny Bluetooth
			Miga (podwójne mi-gnięcie, jeden raz)	Uwaga	Udostępnianie sieci powiodło się (po ko-munikacie ID urządzenia)

8 Parametryzacja

Parametry tego urządzenia można ustawić za pomocą 2 interfejsów. Możliwe jest odczytywanie informacji lub wprowadzanie ustawień przez Ethernet lub Bluetooth. Przypisane informacje i zmiany są możliwe dla każdego interfejsu.

1. W przypadku sieci Ethernet podłącz złącze M12 do sieci za pomocą kabla Ethernet M12 → (Akcesoria).
2. Połączenie jest nawiązywane z aplikacją przez Bluetooth.

Informacje na temat odpowiedniego oprogramowania do ustawiania parametrów można znaleźć w ▷ pliku io-link.ifm.

8.1 Uwagi dotyczące parametryzacji

8.1.1 Parametryzacja przez interfejs Bluetooth

Aby skonfigurować stację bazową Bluetooth Mesh IoT za pośrednictwem interfejsu Bluetooth:

▶ Podłącz nowe urządzenie do zasilania.
▶ Zainstaluj ifm moneo|blue, Instalacja ifm moneo|blue (→ 18).

8.1.2 Parametryzacja przez interfejs Ethernet

Dostępne opcje konfiguracji urządzenia za pośrednictwem interfejsu Ethernet:

• ifm IoT Core REST API: ifm IoT Core REST API (→ 25)
• ifm moneo|configure: ifm moneo|configure (→ 50)
• Wizualizator IoT Core ifm: Wizualizator rdzenia IoT: (→ 59)

Aby skonfigurować stację bazową Bluetooth Mesh IoT za pośrednictwem interfejsu Ethernet:

▶ Podłącz urządzenie do komputera/laptopa poprzez port Ethernet.
▶ Podłącz nowe urządzenie do zasilania.
▶ Opcjonalnie: Zainstaluj ifm moneo|configure, Instalacja ifm moneo|configure (→ 18).

8.1.3 Instalacja ifm moneo|blue

ifm electronic dostarcza aplikację ifm moneo|blue umożliwiającą dostęp do urządzenia za pośrednictwem interfejsu Bluetooth. Aplikacja jest dostępna w Apple App Store i Google Play Store.

moneo|blue

Aby zainstalować ifm moneo|blue:

▶ Zeskanuj kod QR za pomocą urządzenia mobilnego.
▷ Zostanie otwarta strona aplikacji w App Store lub Google PlayStore.
▶ Zainstaluj ifm moneo|blue.
▷ ifm monoe|blue jest zainstalowany na urządzeniu mobilnym.

8.1.4 Instalacja ifm moneo|configure

Informacje na temat ifm moneo|configure: ifm.com/cnt/moneo

▶ Pobierz ifm moneo|configure.
▶ Uruchom laptopa/komputer PC.
▶ Zaloguj się z uprawnieniami administratora.
▶ Zainstaluj i licencjonuj ifm moneo|configure (→ instrukcje instalacji ifm moneo).
▷ ifm moneo|configure jest zainstalowany.

8.1.5 Hasło Bluetooth

Dostęp do urządzenia przez Bluetooth LE jest chroniony hasłem. Nie można wyłączyć ochrony hasłem.

Fabrycznie ustawione hasło Bluetooth składa się z ostatnich 6 cyfr numeru seryjnego urządzenia (np. 100000138488).

Numer seryjny jest wydrukowany na opakowaniu i na urządzeniu.

Rys. 3: Wskazanie numeru seryjnego: na urządzeniu (po lewej) i na opakowaniu (po prawej)

Podczas uzyskiwania dostępu do urządzenia przez ifm moneo|blue po raz pierwszy, użytkownik jest proszony o zmianę hasła ustawionego fabrycznie.

▶ Wybierz silne hasło zgodnie z polityką firmy.

Hasło Bluetooth nie ma wpływu na dostęp do urządzenia za pośrednictwem ifm moneo i interfejsu IoT Core.

8.2 ifm moneo|blue

8.2.1 Łaczenie z urządzeniem

▶ Podczas początkowej konfiguracji należy zmienić ustawione fabrycznie hasło (→ Hasło Bluetooth ☐ 18) interfejsu Bluetooth.

Wymagania:

√ Bluetooth jest aktywowany na urządzeniu mobilnym.
√ jeśli moneo|blue jest zainstalowane na urządzeniu mobilnym, Instalacja ifm moneo|blue (→ 18).
√ Urządzenie znajduje się blisko urządzenia mobilnego (odległość: maks. 15 m).
√ Urządzenie jest podłączone i gotowe do użytku
▶ Start ifm monoe|blue.

▶ Kliknij [Scan for Devices].

▷ ifm moneo|blue skanuje środowisko w poszukiwaniu dostępnych urządzeń.
▷ ifm moneo|blue wykrywa wszystkie dostępne urządzenia.

▶ Wybierz stację bazową Bluetooth Mesh IoT i sparuj ją z urządzeniem mobilnym.

▷ Pojawi się widok przeglądu.
▷ Widok ogólny pokazuje urządzenia w siatce Bluetooth Mesh.

▶ Kliknij ikonę stacji bazowej Bluetooth Mesh IoT.

▷ Zostanie wyświetlony edytor wartości parametrów urządzenia.

▷ Urządzenie można skonfigurować.

8.2.1.1 Udostępnianie adapterów Bluetooth Mesh IO-Link

Aby dodać adapter Bluetooth Mesh IO-Link do siatki Bluetooth Mesh, adapter musi zostać udostępniony na stacji bazowej Bluetooth Mesh IoT.

Wymagania:

√ jeśli moneo|blue jest zainstalowane na urządzeniu mobilnym, Instalacja ifm moneo|blue (→ 18).

√ Bluetooth jest aktywowany na urządzeniu mobilnym.
√ ▷ Stacja bazowa Bluetooth Mesh IoT EIO404 jest uruchomiona i gotowa do pracy.
√ ▷ Adapter Bluetooth Mesh IO-Link EIO344 jest uruchomiony i gotowy do pracy.
√ Urządzenie znajduje się blisko urządzenia mobilnego (odległość: maks. 15 m).
√ ifm moneo|blue został uruchomiony.

▶ Sparuj stację bazową Bluetooth Mesh IoT z urządzeniem mobilnym, Łączenie z urządzeniem (→ 20).

▶ W nagłówku: Kliknij +.
▷ Stacja bazowa Bluetooth Mesh IoT skanuje środowisko w poszukiwaniu dostępnych adapterów. ▷ Wyświetlone zostaną wszystkie dostępne adaptery.

▶ Wybierz adapter Bluetooth Mesh IO-Link.

▷ Kliknij [Provision].

▷ Stacja bazowa Bluetooth Mesh IoT integruje adapter z siatką Bluetooth Mesh.

▷ ifm moneo|blue ma dostęp do adaptera Bluetooth Mesh IO-Link.

▷ Jeśli jest podłączony: ifm moneo|blue ma dostęp do podłączonego urządzenia IO-Link.

Po aprowizacji stacja bazowa Bluetooth Mesh IoT niezależnie nawiązuje połączenie ze wszystkimi aprowizowanymi adapterami Bluetooth Mesh IO-Link. Połączenie jest nawiązywane bezpośrednio lub za pośrednictwem innych adapterów Bluetooth Mesh IO-Link.

Adaptery Bluetooth Mesh IO-Link wysyłąją dane procesowe do stacji bazowej Bluetooth Mesh IoT cyklicznie w określonych odstępach czasu. Dane procesowe mogą być tam odczytywane i wykorzystywane do monitorowania systemu.

8.2.1.2 Usuwanie adaptera Bluetooth Mesh IO-Link z siatki

Aby usunąć adapter Bluetooth Mesh IO-Link z siatki Bluetooth Mesh:

▶ Zresetuj adapter Bluetooth Mesh IO-Link (Back-to-Box), → instrukcja obsługi EIO344.
▷ Adapter Bluetooth Mesh IO-Link jest usuwany z siatki Bluetooth Mesh.
▷ Kredyt wykorzystany do utworzenia rezerwy zostaje zwolniony.

8.2.2 Odczyt informacji identyfikacyjnych

Dostępne informacje:

Nazwa	Opis	Zakres wartości	Dostęp
[Numer seryjny]	Numer seryjny	np. 000022503648	ro 1
Wersja oprogramowania sprzętowego	Wersja oprogramowania sprzętowego	Np. V1.42	ro 1
[Bootloader revision]	Wersja programu rozruchowego	Np. V0.07	ro 1
[Wersja pamięci EEPROM]	Wersja EEPROM	Np. V0.03	ro 1
[Adres MAC]	Adres Bluetooth MAC	Np. B4-E3-F9-C7-54-43	ro 1
[Wersja sprzętu]	Wersja sprzętu	Np. AA	ro 1
[Dostawca]	Sprzedawca	ifm electronic gmbh	ro 1
[Nazwa produktu]	Numer artykułu	EIO404	ro 1

1 Tylko do odczytu

8.2.3 Konfiguracja ustawień IP

Aby skonfigurować ustawienia IP portu Ethernet:

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Adres IP]	Adres IP interfejsu IoT	np.: 192.168.0.100	rw 1
[Maska podsieci]	Maska podsieci sieci Ethernet	np.: 255.255.255.0	rw 1
[Brama domyślna]	Adres IP bramy sieciowej	np.: 192.168.0.1	rw 1
DHCP	Włączanie/wyłączanie klienta DHCP urządzenia	Statyczne IP Ustawienia IP są nadawane przez użytkownika (domyślnie)DHCP Ustawienia IP są ustawiane przez serwer DHCP w sieci.	rw 1

¹ Odczyt i zapis

8.2.4 Ustawianie nazwy siatki Bluetooth Mesh

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Nazwa siatki Mesh]	Nazwa siatki Bluetooth Mesh (maks. 32 znaki)	Np. Plant2 Hall3	rw 1

1 Odczyt i zapis

8.2.5 Ustawianie nazwy stacji Bluetooth

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Nazwa Bluetooth LE]	▷ Nazwa urządzenia w siatce Bluetooth LE (maks. 22 znaki)	Np. BaseStation	rw 1

¹ Odczyt i zapis

8.2.6 Konfigurowanie połączenia MQTT

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[MQTT Version]	Wersja MQTT	Np.: #3,1/1	ro 1
[Utrzymuj aktywne połączenie]	Maksymalny czas między 2 kolejnymi pakietami protokołu MQTT (wartość w s)	0: 0 s...10: 10 s...60: 60 s	rw 2

1 Tylko do odczytu
² Odczyt i zapis

8.2.7 Konfigurowanie kanału poleceń MQTT

Upewnij się, że można uzyskać dostęp do brokera MQTT i że wybrany port brokera MQTT jest zwolniony do przesyłania danych.

Symbole wieloznaczne "+" i "#" nie są obsługiwane w nazwach tematów.

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Broker IP]	Adres IP brokera MQTT	np.: 3.69.1.9	rw 1
[Port brokera]	Numer portu brokera MQTT	Np. 1883	rw 1
[Temat]	Nazwa tematu polecenia MQTT	Np. reqTopic	rw 1
[Antwort-Topic]	Nazwa tematu odpowiedzi MQTT	Np. resp Topic	rw 1
[Nazwa użytkownika]	Nazwa użytkownika	Np. user1	rw 1

1 Odczyt i zapis

8.2.8 Aktualizacja oprogramowania sprzętowego

ifm moneo|blue oferuje opcję aktualizacji oprogramowania stacji bazowej Bluetooth Mesh IoT.

▷ Nowe oprogramowanie sprzętowe dostępne na stronie szczegółów produktu urządzenia: documentation.ifm.com

Aktualizacja oprogramowania sprzętowego nie może zostać przerwana.

▶ Nie należy ponownie uruchamiać urządzenia podczas procesu aktualizacji.
▶ Poczekaj na zakończenie aktualizacji.

Wymagania:

√ Plik oprogramowania układowego stacji bazowej Bluetooth Mesh IoT jest przechowywany w systemie plików urządzenia mobilnego.
√ ifm moneo|blue został uruchomiony.
▶ Ustanowienie połączenia ze stacją bazową Bluetooth Mesh IoT.
▶ Wywołanie widoku edytora stacji bazowej Bluetooth Mesh IoT.
▶ W nagłówku: Kliknij ↑.

▷ Pojawi się okno dialogowe.

▶ Wybierz opcję [Update base station] .

▶ W oknie [Wybierz plik aktualizacji]: Kliknij [Browse].

▶ Wybierz nowy plik oprogramowania sprzętowego.

▷ Strona menu pokazuje wybrany plik oprogramowania sprzętowego.

▶ Kliknij [Import].

▷ Plik oprogramowania sprzętowego jest przesyłany do urządzenia.
▷ Pojawi się komunikat o konieczności zainstalowania nowego oprogramowania sprzętowego i ponownego uruchomienia urządzenia.

▶ Kliknij [OK], aby potwierdzić prompt.

▷ Oprogramowanie sprzętowe stacji bazowej Bluetooth Mesh IoT jest aktualizowane.

▷ Ponowne uruchomienie urządzenia

▷ Nowe oprogramowanie sprzętowe jest instalowane na stacji bazowej Bluetooth Mesh IoT.

8.2.8.1 Aktualizacja oprogramowania sprzętowego mastera IO-Link

ifm moneo|blue oferuje opcję aktualizacji oprogramowania sprzętowego podłączonych adapterów Bluetooth Mesh IO-Link za pośrednictwem stacji bazowej Bluetooth Mesh IoT.

▷ Nowe oprogramowanie sprzętowe dostępne na stronie szczegółów produktu urządzenia: documentation.ifm.com

Aby uzyskać informacje na temat aktualizacji oprogramowania sprzętowego pojedynczego adaptera Bluetooth Mesh IO-Link: Instrukcja obsługi EIO344

Aktualizacja oprogramowania sprzętowego nie może zostać przerwana.

▶ Nie należy ponownie uruchamiać urządzenia podczas procesu aktualizacji.
▶ Poczekaj na zakończenie aktualizacji.

Wymagania:

√ Plik oprogramowania układowego adaptera Bluetooth Mesh IO-Link jest zapisywany w systemie plików urządzenia mobilnego.
√ ifm moneo|blue został uruchomiony.
▶ Ustanowienie połączenia ze stacją bazową Bluetooth Mesh IoT.
▶ Wywołanie widoku edytora stacji bazowej Bluetooth Mesh IoT.
▶ W nagłówku: Kliknij ↑.

▷ Pojawi się okno dialogowe.

▶ Wybierz opcję [Update all connected mesh adapters].

▶ W obszarze [Select update file]: Kliknij [Browse].

▶ Wybierz nowy plik oprogramowania sprzętowego.

▷ Na stronie menu wyświetlany jest wybrany plik oprogramowania sprzętowego.

▶ Kliknij [Importuj].

▷ Plik oprogramowania sprzętowego jest przesyłany do stacji bazowej Bluetooth Mesh IoT.
▷ Pojawi się komunikat o dostępności nowego oprogramowania sprzętowego dla podłączonych adapterów.

▶ Kliknij [Update].

Nowe oprogramowanie sprzętowe jest przesyłane do wszystkich podłączonych adapterów Bluetooth Mesh IO-Link.
▷ Oprogramowanie sprzętowe zostało zaktualizowane.
▷ Wszystkie adaptery uruchamiają się ponownie.

Nowe oprogramowanie sprzętowe jest instalowane na wszystkich podłączonych adapterach Bluetooth Mesh IO-Link.

8.3 ifm IoT Core REST API

8.3.1 Rdzeń IoT firmy ifm: Informacje ogólne

Urządzenie posiada rdzeń ifm IoT-Core. Rdzeń ifm IoT-Core reprezentuje funkcjonalność urządzenia. Funkcjonalność składa się z zestawu danych, usług i zdarzeń. Elementy ifm IoT-Core są rozmieszczone w obiekcie JSON w hierarchicznej strukturze drzewa. Rdzeń ifm IoT udostępnia te elementy światu zewnętrznemu za pośrednictwem standardowych interfejsów (np. HTTP). Umożliwia to użytkownikowi i innym urządzeniom dostęp do danych (parametrów, danych procesowych), zdarzeń i funkcji (usług) urządzenia.

8.3.1.1 Dostęp do ifm IoT Core

Dowolny element ifm IoT Core jest dostępny poprzez jego adres (np. root/port1/pin2). Adres składa się ze ścieżki prowadzącej do elementu (root/port1) i identyfikatora elementu (pin2).

▷ Użytkownik może uzyskać dostęp do ifm IoT Core za pośrednictwem żądań HTTP. Obsługiwane są następujące metody.

Metoda GET

Dostęp Odczytaj

Składnia żądania:

http://ip/data_point/service 

Parametr	Opis
ip	Adres IP interfejsu IoT
data_point	Punkt danych, do którego ma zostać uzyskany dostęp
serwis	Serwis

Składnia odpowiedzi:

{
    "cid": id,
    "data": {"value":"resp_data"},
    "adr": "data_point/service",
    "code": diag_code
} 

Pole	Parametr	Opis
cid	identyfikator	Identyfikator korelacji dla przypisania żądania i odpowiedzi;
dane	resp_data	Wartość punktu danych; w zależności od typu danych punktu danych
adr	data_point	Dostępny punkt danych
	serwis	Usługa, która uzyskała dostęp do punktu danych
kod	diag_code

Przykład: Żądanie GET

- Żadanie (przez przeglądarkę):

http://192.168.0.79/deviceinfo/productname/getdata 

- Odpowiedź:

{
    "cid": -1,
    "data": {"value":"EI0404"},
    "adr": "/deviceinfo/productname/getdata",
    "code": 200
} 

Metoda POST

Dostęp czytanie, pisanie

Składnia żądania:

{
    "code":"code_id",
    "cid":id,
    "adr":"data_point/service",
    "data":{"req_data"},
    "auth":{"user":"usr_id","passwd":"password"}
} 

Pole	Parametr	Opis
kod	code_id	klasa serwisowa Zadanie: Zadanie Transakcja Transakcjazdarzenie zdarzenie
cid	identyfikator	Identyfikator korelacji dla przypisania zadania i odpowiedzi; identyfikator dowolnie wybierany przez użytkownika
adr	data_point	Punkt danych, do którego ma zostać uzyskany dostęp
	serwis	Ustuga dostępu do punktu danych
dane1	req_data	Dane przesłane do IoT Core (np. nowe wartości); składnia zależna od serwisu
auth2	usr_id	Nazwa użytkownika (zakodowana w BASE64); Domyślnie: Administrator
	Hasło	Hasło (zakodowane w BASE64)

1 (opcjonalnie) wymagane tylko w przypadku usług, które wysyłąją dane do IoT Core ifm (e.g. setdata)
² (opcjonalnie) wymagane tylko wtedy, gdy włączony jest tryb bezpieczeństwa

Składnia odpowiedzi:

{
    "cid": id,
    "data": {resp_data},
    "adr": "data_point/service",
    "code": diag_code
} 

Pole	Parametr	Opis
cid	identyfikator	Identyfikator korelacji dla przypisania żądania i odpowiedzi (→ Request)
dane1	resp_data	Wartości zwracane przez ifm IoT Core; składnia zależna od serwisu
adr	data_point	Dostępny punkt danych
	serwis	Ustługa, która uzyskała dostęp do punktu danych
kod	diag_code	Kody diagnostyczne

1 (opcjonalnie) wymagane tylko w przypadku usług, które odbierają dane z IoT Core ifm (e.g. getdata)

Przykład: Żądanie POST

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/deviceinfo/devicename/getdata"
} 

Odpowiedź:

{
    "cid": 1,
    "data": {
    "value": "New Base"
    },
    "adr": "/deviceinfo/devicename/getdata",
    "code": 200
} 

Kody diagnostyczne

Kod	Tekst	Opis
200	OK	Żądanie zostało pomyślnie przetworzone
400	Złe żądanie	Nieprawidłowe żądanie
403	Niedozwolone	Niedozwolone żądanie
404	Nie znaleziono elementu:	Podany adres nie istnieje
408	Przekroczenie limitu czasu żądania	Przekroczenie limitu czasu odpowiedzi na żądanie
404	Nie znaleziono elementu:	Żądana ustuga nie istnieje
413	Żądany ładunek zbyt duży	Żądane dane użytkownika zbyt duże
414	Żądany adres URL zbyt długi	Żądany adres URL zbyt długi
416	Żądany zakres niezadowalający	Żądany zakres wartości nie mieści się w dozwolonych granicach
422	Nieprawidłowy ładunek. Nieprawidłowy parametr	Przesłane dane / dane użytkownika są nieprawidłowe
423	Ustuga jest zajęta	Ustuga jest obecnie zablokowana, wyłączona lub zajęta
424	Niefunkcjonująca zależność:	Wykonanie ustugi jest obecnie niedozwolone (sprawdź zależności)
429	Zbyt wiele żądań	Zbyt wiele żądań
500	Wewnętrzny błąd serwera	Błąd wewnętrzny
501	Nie wdrożono	Nie wdrożono
502	Ustuga zdalna nie powiodła się z kodem:	Żądanie do urządzenia zdalnego nie powiodło się z komunikatem o błędzie
503	Ustuga niedostępna	Ustuga niedostępna
507	Niewystarczająca pamięć masowa	Niewystarczająca pamięć urządzenia
550	Nieudane wykonanie serwisu	Wykonanie serwisu nie powiodło się.
901	Już istnieje	Element lub link do elementu istnieje już w tej samej pozycji w drzewie IoT Core.

8.3.2 Skrócona instrukcja

ifm IoT Core zawiera elementy przeznaczone wyłącznie do użytku wewnętrznego przez ifm. Elementy te nie są wyprowadzane w zapytaniu z usługą gettree . Elementy są chronione przed nieautoryzowanym dostępem.

Aby wyświetlić pełną strukturę drzewa rdzenia IoT urządzenia, wyświetl następujące żądanie POST do rdzenia ifm IoT:

{
    "code":"request",
    "cid":-1,
    "adr":"/gettree"
} 

ifm IoT Core zwraca pełną strukturę drzewa jako ustrukturyzowany obiekt JSON.

▶ Zidentyfikuj wszystkie podstruktury i zawarte w nich punkty danych w strukturze drzewa obiektu JSON.
▶ Zidentyfikuj odpowiednie usługi dostępu do podstruktur i zawartych w nich punktów danych.

8.3.3 Funkcje ogólne

Urządzenie ma typ „device” (→ Typy ☐ 68). Następujące usługi mogą być zastosowane do elementu głównego drzewa urządzeń:

Serwis	Opis
../gettree	Podaj kompletne drzewo lub poddrzewo opisu urządzenia (JSON)
../getidentity	Odczyt informacji identyfikacyjnych urządzenia
../getdatamulti	Sekwencyjne odczytywanie wielu elementów
../getelementinfo	Odczytywanie szczegółowych informacji o elemencie
../getsubscriberlist	Drukowanie listy wszystkich aktywnych subskrypcji powiadomień
../querytree	Wyszukiwanie w opisie urządzenia określonych elementów

Następujące usługi mogą być stosowane do elementów typu data w zależności od skonfigurowanych praw dostępu:

Serwis	Opis
../getdata	Odczytywanie wartości elementu
../setdata	Zapis wartości elementu

8.3.3.1 Przykład: Zmiana wartości parametru

Zadanie: Parametrowi device name urządzenia należy nadać wartość "Nowa stacja bazowa".

Rozwiązanie: Zapisz nową wartość elementu deviceinfo/devicename za pomocą usługi setdata.

Żądanie:

{
    "code": "request",
    "cid": 4711,
    "adr": "/deviceinfo/devicename/setdata",
    "data": {
    "newvalue": "New Base Station",
    }
} 

Odpowiedź:

{
    "cid":4711,
    "adr":"/deviceinfo/devicename/setdata",
    "code":200
} 

8.3.3.2 Przykład: Odczyt wielu wartości parametrów jednocześnie

Zadanie: Odczytywane są następujące bieżące wartości urządzenia: temperatura, numer seryjny

Rozwiązanie: Odczytaj aktualne wartości parametrów za pomocą usługi getdatamulti (temperatura w ▷ punkcie danych: /processdatabasestation/temperature/cpu; numer seryjny punktu danych: /deviceinfo/serialnumber).

Żądanie:

{
    "code":"request",
    "cid":4711,
    "adr":"/getdatamulti",
    "data":{
    "datatosend":[
    "/processdatabasestation/temperature/cpu",
    "/deviceinfo/serialnumber"
    ]
    }
} 

Odpowiedź:

{
    "cid":4711,
    "data":{
    "processdatabasestation/temperature/cpu":{
    "code":200,
    "data":32
    },
    "deviceinfo/serialnumber":{
    "code":200,
    "data":"000174210147"
    }
},
"adr":"getdatamulti",
"code":200
} 

8.3.3.3 Przykład: Wyświetlanie poddrzewa

Zadanie: Wyświetl wszystkie bezpośrednie podelementy węzła sieci meshnetwork.

Rozwiązanie: Użyj usługi gettree, aby wyświetlić wymagane poddrzewo (węzeł główny: oprogramowanie sprzętowe, podpoziomy do wyświetlenia: 1).

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/gettree",
    "data": {
    "adr": "/meshnetwork/",
    "level": 1
    }
} 

Odpowiedź:

{
    "cid": 1,
    "data": {
    "identifier": "meshnetwork",
    "type": "structure",
    "subs": [
    {
    "identifier": "provisioning",
    "type": "structure",
    "profiles": [
    "wirelessprovisioning"
    ]
    },
    {
    "identifier": "mesh_adapter[1]",
    "type": "subdevice",
    "profiles": []
    },
    {
    "identifier": "adapter_update",
    "type": "structure",
    "profiles": [
    "software",
    "software/uploadablesoftware"
    ]
    }
    ]
},
"adr": "/gettree",
"code": 200
} 

8.3.3.4 Przykład: Przeszukiwanie IoT Core

Zadanie: Wymienione zostaną wszystkie elementy o profilu datarequired.

Rozwiązanie: Użyj usługi drzewa zapytań, aby wyszukać IoT Core urządzenia z parametrem datarequired (profile).

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/querytree",
    "data": {
    "profile": "datarequired"
    }
} 

Odpowiedź:

{
    "cid": 1,
    "data": {
    "adrList":[
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/ipaddress",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/subnetmask",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/dhcp",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/ipdefaultgateway"
    ]
},
"adr": "/querytree",
"code": 200
} 

8.3.4 Ethernet: Konfiguracja ustawień IP

Podstruktura: iotsetup/ethernet/network

▶ Zmieniaj punkty danych podstruktury network tylko zgodnie z ruchem wskazówek zegara za pomocą usługi setblock!

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../dhcp	Metoda konfiguracji ustawień IP interfejsu	0: Statyczne IP adresowanie statyczne (domyślne)1: DHCP adresowanie przez DHCP (protokół dynamicznej konfiguracji hosta)	rw 1
../ipaddress	Adres IP interfejsu	Np. 192.168.0.79 (domyślny)	rw 1\ 2
../subnetmask	Maska podsieci segmentu sieci	Np. 255.255.255.0 (domyślny)	rw 1\ 2
../ipdefaultgateway	Adres IP bramy sieciowej	Np. 192.168.0.100 (domyślny)	rw 1\ 2
../macaddress	Adres MAC interfejsu	Np. 00-02-01-42-DC-9D	ro 3

1 Odczyt i zapis

² Można zmienić tylko wtedy, gdy nie wybrano opcji DHCP.

³ Tylko do odczytu

Odpowiednie usługi:

Nazwa	Opis
setblock	Zapisz wszystkie punkty danych podstruktury blokowo

8.3.5 Ethernet: Konfigurowanie ochrony hasłem

Ochrona hasłem służy do zabezpieczenia urządzenia przed nieautoryzowanym dostępem za pośrednictwem interfejsu Ethernet.

Po ustawieniu hasła użytkownik musi również przesłać pole "auth" z prawidłową nazwą użytkownika ("user") i hasłem ("passwd") w celu uwierzytelnienia żądania POST.

Nazwa użytkownika to administrator. Nazwa użytkownika jest stała i nie można jej zmienić.

Nazwa użytkownika i hasło są reprezentowane jako łańcuchy zakodowane w Base64: Przykład: Żądanie z uwierzytelnieniem (→ ☐ 32)

Po włączeniu ochrony hasłem następujące żądania mogą być również wykonywane bez uwierzytełniania:

• getidentity
  • deviceinfo/vendor/getdata

• deviceinfo/productcode/getdata

Podstruktura: iotsetup/ethernet/security

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../password	Ustawienie hasła do uwierzytelniania (ciąg zakodowany w Base64)Min. długość: 6 Maks. długość: 32	Np. ZXRoX3 Bhc3N3b3Jk	wo 1

1 tylko zapis

Prawidłowy zestaw znaków dla hasła przed kodowaniem Base64: UTF-8 bez znaków sterujących

Odpowiednie usługi:

Nazwa	Opis
../resetpassword	Usuwanie hasła sieci Ethernet

8.3.5.1 Przykład: Ustawianie hasta sieci Ethernet

Zadanie: Połączenie Ethernet musi być chronione hasłem (password: eth_password)

Rozwiązanie: Korzystając z usługi setdata, wpisz hasło eth_password (zakodowane w Base64: ZXRoX3
Bhc3N3b3Jk) do punktu danych iotsetup/ethernet/security/password.

Żadanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/password/setdata",
    "data": {
    "newvalue": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Odpowiedź:

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/password/setdata",
    "code": 200
} 

Interfejs Ethernet jest chroniony hasłem. Usługa getidentity (→ Serwis: getidentity ☐ 70) pokazuje, że hasło jest ustawione.

8.3.5.2 Przykład: Żądanie z uwierzytelnieniem

Zadanie: Mamy odczytać temperaturę urządzenia. Hasło jest ustawione (hasło: eth_password).

Rozwiązanie: Korzystając z usługi getdata, odczytaj punkt danych processdatabasestation/temperature/cpu. Nazwa użytkownika i hasło są dostarczane jako łańcuchy zakodowane w Base64:

- Nazwa u żytkownika:

- administrator: YWRtaW5pc3RyYXRvcg==

- Hasło:

- eth_password: ZXRoX3
Bhc3N3b3Jk 

Żądanie:

{
    "code": "request",
    "cid": -1,
    "adr": "/processdatabasestation/temperature/cpu/getdata",
    "auth": {
    "user": "YWRtaW5pc3RyYXRvcg==",
    "passwd": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Odpowiedź:

{
    "cid": -1,
    "adr": "/processdatabasestation/temperature/cpu/getdata",
    "data": {
    "value": 37
    },
    "code": 200
} 

8.3.5.3 Przykład: Usuwanie hasła sieci Ethernet

Zadanie: Dostęp do urządzenia za pośrednictwem interfejsu Ethernet jest chroniony hasłem (hasło: eth_password). Hasło ma zostać usunięte.

Rozwiązanie: Używając usługi resetpassword, zapisz do podstruktury iotesetup/ethernet/security. Nazwa użytkownika i hasło są dostarczane jako łańcuchy zakodowane w Base64.

- Nazwa u żytkownika:

- administrator: YWRtaW5pc3RyYXRvcg== 

- Hasło:

- eth_password: ZXRoX3
Bhc3N3b3Jk 

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/resetpassword",
    "auth": {
    "user": "YWRtaW5pc3RyYXRvcg==",
    "passwd": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/resetpassword",
    "code": 200
} 

8.3.6 Bluetooth: Ustawianie nazwy stacji

Podstruktura: iotsetup/bluetooth_le

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../bluetooth_name	Nazwa stacji urządzenia (ciąg maks. 22 znaków)	np. eio404_base	rw 1

1 Odczyt i zapis

8.3.7 Bluetooth: Konfigurowanie ochrony hasłem

Zwróć uwagę na informacje dotyczące hasła Bluetooth: Hasło Bluetooth (→ 18).

Podstruktura: iotsetup/bluetooth_le/security

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../security/password	Ustaw hasło do uwierzytelniania za pomocą interfejsu Bluetooth LE (ciąg znaków zakodowany w Base64). Min. długość: 6 Maks. długość: 32UWAGA! Hasło nie ma wpływu na funkcjonalność siatki.	e.g. YmxIX3 Bhc3N3b3Jk	wo 1
../security/password_state	Bieżący stan hasła Bluetooth	0: Default Password - hasło ustawione fabrycznie (ostatnie 6 cyfr numeru seryjnego)1: User specific password - hasło specyficzne dla użytkownika	ro 2

¹ tylko zapis

² Tylko do odczytu

Prawidłowy zestaw znaków dla hasła przed kodowaniem Base64: UTF-8 bez znaków sterujących

Odpowiednie usługi:

Nazwa	Opis
../resetpassword	Resetowanie hasła do ustawień fabrycznych

8.3.7.1 Przykład: Zmiana hasła Bluetooth

Zadanie: Hasło Bluetooth powinno być ustawione na wartość ble_password.

Rozwiązanie: Korzystając z usługi setdata, wpisz hasło ble_password (zakodowane w Base64:

Ymx1X3
Bhc3N3b3Jk) do punktu danych /iotsetup/bluetooth_le/security/password.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "iotsetup/bluetooth_le/security/password/setdata",
    "data": {
    "newvalue": "Ymx1X3
Bhc3N3b3Jk"
    }
} 

Odpowiedź:

{
    "cid":1,
    "adr":"iotsetup/bluetooth_le/security/password/setdata",
    "code":200
} 

8.3.8 Zarządzanie siatkąBluetooth Mesh

Podstruktura: meshnetwork/provisioning

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../max_nodes	Maks. liczba węzłów	50	ro 1
../current_nodes	Aktualna liczba węzłów w siatce mesh	0...50	ro 1
../valid_credits_count	Bieżąca liczba wykorzystanych kredytów Bluetooth mesh	0...65535	ro 1

1 Tylko do odczytu

Odpowiednie usługi:

Nazwa	Opis
Skanuj	Skanowanie w poszukiwaniu dostępnych węzłów w pobliżu urządzenia
Zarejestruj	Rejestracja węzła w sieci mesh
../unregister	Wyrejestrowanie węzła z sieci mesh
Zastąp	Wymiana węzła sieci mesh
../get_credit	Żądanie uznania sieci mesh, aby móc dodać węzeł do sieci
../reset_credits	Zresetuj aktualnie wymagane kredyty

8.3.8.1 Przykład: Skanowanie w poszukiwaniu dostępnych adapterów mesh

Zadanie: Okolica urządzenia zostanie przeskanowana w poszukiwaniu dostępnych adapterów Bluetooth mesh.

Rozwiązanie: Uruchom usługę scan w strukturze podrzędnej meshnetwork/provisioning.

Żadanie:

{
    "code": "request",
    "cid": 4711,
    "adr": "/meshnetwork/provisioning/scan"
} 

Odpowiedź:

{
    "cid":4711,
    "data":[{
    "id": "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX",
    "name": "EIO344 ifm SN: 123456789011",
    "info": [
    {
    "key": "MAC Address",
    "value": "aa-bb-cc-dd-ee-ff"
    },
    {
    "key": "Signal Strength",
    "value": 77
    }
    ]
}],
"adr":"/meshnetwork/provisioning/scan",
"code":200
} 

Stacja bazowa znalazła adapter Bluetooth mesh z identyfikatorem UUID (pole "id") i nazwą (pole "name"). Adapter mesh ma adres MAC i siłę sygnału 77%.

8.3.8.2 Przykład: Zarejestruj adapter mesh w sieci mesh

Zadanie: Adapter mesh ma zostać zarejestrowany w sieci mesh Bluetooth przy użyciu danych wykrytych podczas skanowania sieci.

Rozwiązanie: Uruchom usługę register w strukturze podrzędnej meshnetwork/provisioning. Należy przekazać identyfikator UUID adaptera siatki.

Żądanie:

{
    "code":10,
    "cid": 4711,
    "adr":"/meshnetwork/provisioning/register",
    "data":{
    "id":"XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX"
    }
} 

Odpowiedź:

{
    "code":200,
    "cid":4711,
    "adr":"/meshnetwork/provisioning/register",
    "data":{
    "adr":"/meshnetwork/mesh_adapter[1]"
    }
} 

Po pomyślnym zarejestrowaniu adaptera Bluetooth mesh, jego drzewo IoT Core zostaje zintegrowane z drzewem IoT Core stacji bazowej Bluetooth mesh (podstruktura meshnetwork/mesh_adapter[x] (x: 1...50)).

8.3.8.3 Przykład: Wymiana adaptera mesh

Zadanie: Adapter mesh o identyfikatorze UUID "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX" zarejestrowany w sieci mesh Bluetooth ma zostać zastąpiony przez adapter mesh o identyfikatorze UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY".

Rozwiązanie: Uruchom usługę replace w strukturze podrzędnej meshnetwork/provisioning. Należy podać UUID dwóch adapterów mesh.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/meshnetwork/provisioning/replace",
    "data": {
    "old_id": "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX",
    "new_id": "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY"
    }
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/meshnetwork/provisioning/replace",
    "code": 200
} 

8.3.8.4 Przykład: Wyrejestrowanie adaptera mesh z sieci mesh

Zadanie: Adapter Bluetooth mesh o identyfikatorze UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY" ma zostać wyrejestrowany z sieci mesh.

Rozwiązanie: Uruchom usługę unregister w strukturze podrzędnej meshnetwork/provisioning. Należy przekazać identyfikator UUID adaptera siatki.

Żądanie:
Żądanie:

{
    "code": "request",
    "cid": 4711,
    "adr": "/meshnetwork/provisioning/unregister",
    "data": {
    "id": "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY"
    }
} 

Odpowiedź:

{
    "cid":4711,
    "adr": "/meshnetwork/provisioning/unregister",
    "code":200
} 

Podstruktura adaptera siatki (mesh_adapter[x] (x: 1...50)) jest usuwany z drzewa IoT Core stacji bazowej mesh.

8.3.9 Zarządzanie adapterami Bluetooth mesh IO-Link

Dla każdego adaptera Bluetooth mesh IO-Link zintegrowanego z siecią tworzona jest podstruktura mesh_adapter[x] (x:1...50) pod meshnetwork. Podstruktura zawiera IoT Core adaptera Bluetooth mesh IO-Link ze strukturami i punktami danych specyficznymi dla urządzenia.

Opis rdzenia IoT adapterów Bluetooth mesh IO-Link: → Instrukcja obsługi EIO344

Dostęp do rdzenia IoT adaptera Bluetooth mesh IO-Link można uzyskać tylko za pośrednictwem stacji bazowej Bluetooth mesh IoT. W tym celu adapter musi być zintegrowany z siatką Bluetooth mesh.

8.3.10 Konfigurowanie timerów

Urządzenie posiada 2 timery. Timery mogą być używane do wyzwalanej czasowo transmisji powiadomień (→ Korzystanie z powiadomień ☐ 39).

Podstruktura: timer[1] | timer[2]

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../counter	Odczyt licznika	0...4294967295	ro 1
../interval	Interwał zliczania (wartość w ms)	1000: 1000 ms86400000: 86400000 ms	rw 2
../interval/unit	Jednostka interwału zliczania	ms: milisekundach)	ro 1
../status	Stan licznika	0: stopped - licznik zatrzymany1: running - licznik uruchomiony	ro 1

1 Tylko do odczytu
² Odczyt i zapis

Odpowiednie usługi:

Nazwa	Opis
../status/start	Uruchomienie licznika
../status/stop	Zatrzymanie licznika

8.3.10.1 Przykład: Ustawianie interwału zliczania

Interwał zliczania timera 2 należy ustawić na 2,5 s.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/interval/setdata",
    "data": {
    "newvalue": 2500
    }
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/timer[2]/interval/setdata",
    "code": 200
} 

8.3.10.2 Przykład: Uruchomienie licznika

Licznik timera 2 jest skonfigurowany i ma zostać uruchomiony.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/status/start"
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/timer[2]/status/start",
    "code": 200
} 

8.3.10.3 Przykład: Zatrzymanie licznika

Licznik timera 2 działa i ma zostać zatrzymany.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/status/stop"
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/timer[2]/status/stop",
    "code": 200
} 

8.3.11 Korzystanie z powiadomień

Urządzenie obsługuje wysyłanie powiadomień. Powiadomienie może zawierać bieżące wartości pojedynczych lub wielu danych procesowych.

Dostępne typy powiadamiania:

• Powiadomienia wyzwalane zdarzeniami (→ 40)
• Powiadomienia wyzwalane czasowo (→ 40)

Powiadomienia są wysyłane na określony adres docelowy. Adres docelowy składa się z elementów protokołu transmisji, adresu IP, portu i tematu (np: http://192.168.100.254:80/myTopic)

Obsługiwane protokoły transmisji:

• http
• MQTT

Można ustawić czas aktywności powiadomienia.

Użytkownik może wyświetlić wszystkie aktywne powiadomienia za pomocą usługi getsubscriberlist.

8.3.11.1 Powiadomienia wyzwalane zdarzeniami

Wszystkie elementy ifm IoT Core z podelementem typu event mogą być używane jako wyzwalacze dla powiadomień wyzwalanych zdarzeniami.

Nazwa	Opis
../datachanged	Węzeł do wyświetlania zmian wartości nadrzędnego węzła danych
../eventcollection	Węzeł do wyświetlania zmian wartości wielu węzłów danych IoT Core
../treechanged	Węzeł do wyświetlania zmian strukturalnych w IoT Core

Odpowiednie usługi:

Nazwa	Opis
subscribe	Subskrybowanie powiadomień
unsubscribe	Rezygnacja z subskrypcji powiadomień

8.3.11.2 Powiadomienia wyzwalane czasowo

ifm IoT Core oferuje 2 timery, które mogą być używane jako wyzwalacze dla powiadomień wyzwalanych czasowo.

Nazwa	Opis
../timer[1]/counter/datachanged	Licznik timera 1
../timer[2]/counter/datachanged	Licznik timera 2

Czas interwału timerów można ustawić. Każdy impuls zliczający wyzwala powiadomienie.

Odpowiednie usługi:

Nazwa	Opis
subscribe	Subskrybowanie powiadomień
unsubscribe	Rezygnacja z subskrypcji powiadomień

8.3.11.3 Przykład: Tworzenie powiadomień wyzwalanych czasowo

Zadanie: Wartości poniższych parametrów mają być wysyłane do tematu myData na komputerze sieciowym o adresie IP 192.168.0.4 co 10 sekund:

- Dane wejściowe IO-Link czujnika do adaptera 1 Bluetooth mesh IO-Link

• Temperatura pracy stacji bazowej Bluetooth mesh IoT

Rozwiązanie: Rozwiązanie składa się z 3 podetapów:

▶ Ustawienie interwału zliczania timera 1 (10 s = 10000)

- Żadanie:

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/interval/setdata",
    "data": {
    "newvalue": 10000
    }
} 

▶ Start timera 1
- Żądanie:

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/start",
} 

▶ Aktywacja powiadomień

- Żądanie:

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData",
    "datatosend": [
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin",
    "/processdatabasestation/temperature/cpu"
    ]
    }
} 

Powiadomienie jest przesyłane w formacie JSON. Nagłówek ma następującą strukture

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "6317",
    "srcurl": "/timer[1]/counter/datachanged",
    "payload": {
    "/timer[1]/counter": {
    "code": 200,
    "data": 1
    },
    "/processdatabasestation/temperature/cpu": {
    "code": 200,
    "data": 39
    },
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin": {
    "code": 200,
    "data": "03B0"
    }
    }
    }
} 

8.3.11.4 Przykład: Utwórz powiadomienie wyzwalane zdarzeniem

Zadanie: W przypadku zmian w siatce Bluetooth, powiadomienie z liczbą zintegrowanych adapterów mesh ma zostać wysłane na serwer (adres IP serwera: 192.168.82.100, port: 80, topic: myData).

Rozwiązanie:

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/treechanged/subscribe",
    "data": {
    "callback": "http://192.168.82.100:80/myData"
    "datatosend": [
    "/meshnetwork/provisioning/current_nodes"
    ]
    }
} 

Odpowiedź:

{
    "cid": 1,
    "adr": "/treechanged/subscribe",
    "code": 200
} 

8.3.11.5 Przykład: Wyświetlanie aktywnych powiadomień

Zadanie: Wyświetlane będą wszystkie aktywne powiadomienia.

Rozwiązanie: Odczytaj wszystkie aktywne powiadomienia za pomocą usługi getsubscriberlist.

Żądanie:

{
    "code": "request",
    "cid": 4711,
    "adr": "/getsubscriberlist"
} 

Odpowiedź:

{
    "cid": 4711,
    "data": [
    {
    "adr": "00-02-01-0B-AA-06/timer[1]/counter/datachanged",
    "datatosend": [
    "00-02-01-0b-aa-06/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin",
    "00-02-01-0b-aa-06/processdatabasestation/temperature"
    ],
    "cid": 4711,
    "callbackurl": "http://192.168.0.4:80/myData",
    }
    ],
    "adr":"getsubscriberlist",
    "code": 200
} 

8.3.11.6 Przykład: Zmiana powiadomienia

Zadanie: Istniejąca subskrypcja ma zostać zmieniona. Zamiast temperatury stacji bazowej Bluetooth ma być przesyłane bieżące napięcie robocze.

Rozwiązanie: Nadpisz istniejącą subskrypcję. W tym celu wartości parametrów "cid" i "callback" w żądaniu muszą być identyczne z wartościami istniejącej subskrypcji.

Żądanie:

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData",
    "datatosend": [
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[2]/iolinkdevice/pdin",
    "/processdatabasestation/voltage/input"
    ]
    }
} 

Odpowiedź:

{
    "cid":4712,
    "adr":"/timer[1]/counter/datachanged/subscribe",
    "code":200
} 

8.3.11.7 Przykład: Usuwanie powiadomienia

Zadanie: Istniejące powiadomienie ma zostać usunięte.

Rozwiązanie: Użyj usługi anulowania subskrypcji, aby usunąć subskrypcję. W tym celu wartość parametru "callback" w żądaniu musi być równa wartości istniejącej subskrypcji.

Żądanie:

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/datachanged/unsubscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData"
    }
} 

8.3.12 Użyj MQTT

ifm IoT Core obsługuje protokół MQTT. MQTT pozwala klientowi komunikować się z ifm IoT Core za pośrednictwem brokera w celu żądania i odbierania danych. ifm IoT Core może publikować dane do brokera MQTT.

Aby włączyć komunikację MQTT, użytkownik musi skonfigurować kanał poleceń MQTT. Konfiguracja składa się z następujących podetapów:

▶ Sprawdź, czy broker MQTT jest osiągalny.
▶ Sprawdź, czy żądany port brokera MQTT jest otwarty.
▶ Aktywacja kanału poleceń MQTT.
▶ Konfiguracja kanału poleceń MQTT.
▶ Konfiguracja połączenia MQTT.

▷ Połączenie MQTT zostało skonfigurowane i aktywowane.

Po skonfigurowaniu kanału poleceń MQTT i połączenia MQTT dane mogą być publikowane do brokera MQTT za pomocą usługi subskrypcji.

8.3.12.1 Konfigurowanie połączenia MQTT

Poniższy diagram stanu pokazuje, w jaki sposób usługi start, stop i reset wpływają na bieżący stan połączenia MQTT:

Po udanej inicjalizacji w stanie init połączenie automatycznie przechodzi do stanu running.

Połączenie automatycznie przełącza się w stan error, jeśli wystąpi co najmniej jedno z poniższych zdarzeń:

- Nie można uzyskać połączenia z brokerem MQTT

Podstruktura: connections/mqttconnection

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../type	Typ połączenia (MQTT)	mqtt: Połączenie MQTT	ro 1
../status	Status połączenia MQTT	init: init stan – inicjalizacjastopped: stopped stan – połączenie przerwanerunning: running stan – połączenie działaerror: error stan	ro 1
../status/preset	Wstępne ustawienie stanu połączenia MQTT	running: running stan (domyślnie)	ro 1
../MQTTSetup	Podstruktura dla ogólnych ustawień MQTT
../MQTTSetup/QoS	Jakość usługi (QoS) połączenia MQTT	0: Poziom QoS 0 – PUBLIKUJ (bez potwierdzenia) (domyślnie)1: Poziom QoS 1 - PUBLIKUJ > PUBREC (pojedyncze potwierdzenie)2: Poziom QoS 2 - PUBLIKUJ > PUBREL > PUBCOMP (podwójne potwierdzenie)	rw 2
../MQTTSetup/version	Wersja MQTT	Np.: #3,1/1	ro 1
../MQTTSetup/KeepAlive	KeepAlive: Maksymalny czas między 2 kolejnymi pakietami protokołu MQTT (wartość w s)	0: dezaktywowany...10: 10 s (domyślnie)...60: 60 s	rw 2

1 Tylko do odczytu

² Odczyt i zapis

Odpowiednie usługi:

Nazwa	Opis
../status/start	Aktywacja MQTT.
../status/stop	Dezaktywacja MQTT.
../status/reset	Reset MQTT.

8.3.12.2 Konfigurowanie kanału poleceń MQTT

Kanał poleceń MQTT umożliwia wysyłanie i odbieranie powiadomień ifm IoT Core powiadomienia (→ Korzystanie z powiadomień ☐ 39).

Upewnij się, że można uzyskać dostęp do brokera MQTT i że wybrany port brokera MQTT jest zwolniony do przesyłania danych.

Symbole wieloznaczne "+" i "#" nie są obsługiwane w nazwach tematów.

Podstruktura: connections/mqttconnection/mqttcmdchannel

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../type	Typ kanału poleceń	mqtt: Kanał poleceń MQTT (domyślnie)	ro 1
../status	Status kanału poleceń	init: init stanstopped: stopped stanrunning: running stan (domyślnie)error: error stan	ro 1
../status/preset	Wstępnie ustawiony stan kanału	running: running stan (domyślnie)	ro 1
./mqtt CmdChannel Setup	Podstruktura dla ustawień kanału poleceń	--
./mqtt CmdChannel Setup/brokerIP	Adres IP brokera MQTT	np. 3.69.1.9	rw 2
./mqtt CmdChannel Setup/broker-Port	Numer portu brokera MQTT	Np. 1883	rw 2
./mqtt CmdChannel Setup/cmdTopic	Nazwa tematu polecenia MQTT	Np. reqTopic	rw 2
./mqtt CmdChannel Setup/default ReplyTopic	Nazwa standardowego tematu odpowiedzi MQTT	Np. resp Topic	rw 2
./mqttcmdchannelsetup/user	Nazwa użytkownika	np. użytkownik1	rw 2
./mqttcmdchannelsetup/password	Hasło (nie zakodowane w Base64)	Np. password123	rw 2

¹ Tylko do odczytu
² Odczyt i zapis

Odpowiednie usługi:

Nazwa	Opis
../status/start	Uruchomienie kanału MQTT
../status/stop	Zatrzymanie kanału MQTT
../status/reset	Resetowanie kanału MQTT

8.3.12.3 Przykład: Konfiguracja i aktywacja kanału poleceń MQTT

Zadanie: Należy skonfigurować kanał poleceń MQTT do brokera MQTT (adres IP: 192.168.82.100, port: 1883, temat polecenia: reqTopic, standardowy temat odpowiedzi: resp
Topic). Połączenie MQTT należy skonfigurować dla poziomu QoS 2.

Rozwiązanie: Rozwiązanie składa się z następujących podetapów:

▶ Sprawdź, czy można uzyskać dostęp do brokera MQTT i czy wymagany port został zwolniony.
▶ Aktywacja kanału poleceń.

Żądanie:

{
    "code": "request",
    "cid": 1,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/status/start"
} 

▶ Ustawienie adresu IP brokera MQTT.

Żądanie:

{
    "code": "request",
    "cid": 2,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/brokerIP/setdata",
    "data": {
    "newvalue": "192.168.82.100"
    }
} 

▶ Ustawienie portu brokera MQTT.

Żądanie:

{
    "code": "request",
    "cid": 3,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/broker
Port/setdata",
    "data": {
    "newvalue": 1883
    }
} 

▶ Ustawienie nazwy tematu.

Żądanie:

{
    "code": "request",
    "cid": 4,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/cmdTopic/setdata",
    "data": {
    "newvalue": "reqTopic"
    }
} 

▶ Ustawia nazwę standardowego tematu odpowiedzi.

Żądanie:

{
    "code": "request",
    "cid": 5,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/default
ReplyTopic/setdata",
    "data": {
    "newvalue": "resp
Topic"
    }
} 

▶ Ustawianie poziomu QoS.

Żądanie:

{
    "code": "request",
    "cid": 6,
    "adr": "connections/mqtt
Connection/MQTTSetup/QoS/setdata",
    "data": {
    "newvalue": 2
    }
} 

8.3.12.4 Przykład: Publikowanie temperatury urządzenia do brokera MQTT

Zadanie: Temperatura urządzenia ma być publikowana do brokera MQTT co 10 sekund (broker MQTT: 192.168.82.100, port: 1883, topic: devtemp).

Rozwiązanie:

Wymagania:

√ ▷ Połączenie MQTT zostało skonfigurowane.

√ ▷ Kanał poleceń MQTT jest skonfigurowany.

√ Interwał timera 1 jest ustawiony na 10 s.

√ Timer 1 został uruchomiony.

▶ Użyj usługi subskrypcji, aby opublikować wartość procesu do brokera MQTT.

Żadanie – broker MQTT nie jest chroniony hasłem:

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "mqtt://192.168.82.100:1883/devtemp",
    "datatosend": [
    "processdatabasestation/temperature/cpu"
    ]
    }
} 

Żądanie – broker MQTT jest chroniony hasłem (logon: user1, hasil: password123):

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "mqtt://user1:password123@192.168.82.100:1883/devtemp",
    "datatosend": ["processdatabasestation/temperature/cpu"]
    }
} 

Odpowiedź:

{
    "cid":4711,
    "adr":"/timer[1]/counter/datachanged/subscribe",
    "code":200
} 

Powiadomienie jest wysyłane w formacie JSON i ma następującą strukturę:

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "6317",
    "srcurl": "/timer[1]/counter/datachanged",
    "payload": {
    "/timer[1]/counter": {"code": 200, "data": 1},
    "/processdatabasestation/temperature/cpu": {"code": 200, "data": 39}
    }
    }
} 

8.3.13 Resetowanie, ponowne uruchamianie i lokalizowanie urządzenia

Podstruktura: oprogramowanie firmowe

Odpowiednie usługi:

Nazwa	Opis
../factoryreset	Resetuj urządzenie do ustawień fabrycznych.
../reboot	Uruchom ponownie urządzenie.
../signal	Wyzwolenie migania diody LED

8.3.14 Odczyt i zapis informacji o urządzeniu

Podstruktura: deviceinfo

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../serialnumber	Numer seryjny	Np. 000194610104	ro 1
../swrevision	Wersja oprogramowania sprzętowego	Np. V1.36	ro 1
../bootloaderrevision	Wersja programu rozruchowego	Np. V0.06	ro 1
../productinstanceuri	Nazwa węzła głównego w drzewie IoT Core	Np. B4-E3-F9-C7-54-43	ro 1
../eepromversion	Wersja EEPROM	Np. V0.02	ro 1
../btmacaddress	Adres MAC Bluetooth	Np. B4-E3-F9-C7-54-43	ro 1
../hwrevision	Wersja sprzętu	Np. AA	ro 1
../producttext	Oznaczenie produktu	Bluetooth Mesh IoT Basestation	ro 1
../vendor	Dostawca	ifm electronic gmbh	ro 1
../productname	Nazwa produktu	EIO404	ro 1
../productcode	Kod produktu	EIO404	ro 1
../devicename	Nazwa urządzenia specyficzna dla użytkownika	Np. mesh_base	rw 2

1 Tylko do odczytu
² Odczyt i zapis

8.3.15 Odczyt stanu i informacji diagnostycznych

Podstruktura: processdatabasestation

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
../temperature/cpu	Temperatura procesora urządzenia (wartość w °C)	-40: -40°C...85: 85°C	ro 1
../voltage/input	Napięcie wejściowe urządzenia (wartość w mV)	0: 0 mV...40000: 40000 mV	ro 1
../operatingstate	Stan pracy urządzenia	0: Urządzenie OK1: Bluetooth Mesh bez udostępnionego urządzenia2: Link Ethernet niepodłączony3: Temperatura elektroniki poza zakresem4: Bluetooth LE podłączone5: aktualizacja oprogramowania sprzętowego6: Błąd sprzętu7: Zbyt niskie napięcie	ro 1

¹ Tylko do odczytu

8.4 ifm moneo|configure

8.4.1 Łaczenie z urządzeniem

▶ Podczas początkowej konfiguracji należy zmienić ustawione fabrycznie hasło interfejsu Bluetooth, Bluetooth LE: Konfigurowanie ochrony hasłem (→ 54).
▶ Ustaw również hasło dla interfejsu Ethernet, IoT: Konfigurowanie ochrony hasłem (→ 53).

Wymagania:

√ Urządzenie jest podłączone do komputera/laptopa moneo za pośrednictwem interfejsu Ethernet.
√ ifm moneo|configure jest zainstalowany na laptopie/PC i licencjonowany, Instalacja ifm moneo|configure (→ 18).
▶ Uruchom moneo|configure ifm.
▶ Wyszukaj w sieci dostępne urządzenia (typ urządzenia: Generic IoT-Core device, Adres IP: 192.168.0.79).

▷ moneo|configure ifm wykrywa urządzenie.

▶ W kolumnie [Czynności]: Kliknij 📞.
▷ Zostanie wyświetlony edytor wartości parametrów urządzenia.

8.4.1.1 Udostępnianie adapterów Bluetooth Mesh IO-Link

Aby dodać adapter Bluetooth Mesh IO-Link do siatki Bluetooth Mesh, adapter musi zostać udostępniony na stacji bazowej Bluetooth Mesh IoT.

Wymagania:

√ moneo|configure ifm zostało uruchomione.
√ Urządzenie zostało wykryte podczas skanowania sieci.

▶ W kolumnie [Czynności]: Kliknij 🎩.

▷ Pojawi się okno dialogowe.

Stacja bazowa Bluetooth Mesh IoT przeszukuje okolicę w poszukiwaniu dostępnych adapterów Bluetooth Mesh IO-Link.
▷ Dostępne urządzenia są wyświetlane w zestawieniu.

▶ Wybierz wymagany adapter Bluetooth Mesh IO-Link.
▶ Kliknij na [Połącz].
▷ Wybrane adaptery Bluetooth Mesh IO-Link są udostępniane.
▷ Udostępnione urządzenia są uczestnikami siatki Bluetooth Mesh.
▷ W widoku ogólnym udostępnione adaptery są wyświetlane jako podwęzły stacji bazowej Bluetooth Mesh IoT.

Po aprowizacji stacja bazowa Bluetooth Mesh IoT niezależnie nawiązuje połączenie ze wszystkimi aprowizowanymi adapterami Bluetooth Mesh IO-Link. Połączenie jest nawiązywane bezpośrednio lub za pośrednictwem innych adapterów Bluetooth Mesh IO-Link.

Adaptery Bluetooth Mesh IO-Link wysyłąją dane procesowe do stacji bazowej Bluetooth Mesh IoT cyklicznie w określonych odstępach czasu. Dane procesowe mogą być tam odczytywane i wykorzystywane do monitorowania systemu.

8.4.1.2 Usuwanie adaptera Bluetooth Mesh IO-Link z sieci mesh

Wymagania:

√ moneo|configure ifm zostało uruchomione.
√ Urządzenie zostało rozpoznane podczas skanowania sieci.
√ Adapter Bluetooth Mesh IO-Link jest uczestnikiem siatki Bluetooth Mesh.

▶ W kolumnie [Czynności]: Kliknij 📋.
▷ Pojawia się uwaga dotycząca konsekwencji usunięcia.
▶ Kliknij [OK], aby potwierdzić usunięcie.
Adapter Bluetooth Mesh IO-Link jest usuwany z siatki Bluetooth Mesh.
▷ Kredyt wykorzystany do utworzenia rezerwy zostaje zwolniony.

8.4.2 Informacja: Odczyt informacji identyfikacyjnych

Dostępne informacje:

Nazwa	Opis	Zakres wartości	Dostęp
[Serial number]	Numer seryjny	np. 000022503648	ro 1
[SW-Revision]	Wersja oprogramowania sprzętowego	Np. V1.42	ro 1
[Bootloader revision]	Wersja programu rozruchowego	Np. V0.07	ro 1
[EEPROM revision]	Wersja EEPROM	Np. V0.03	ro 1
[Bluetooth MAC address]	Adres Bluetooth MAC	Np. B4-E3-F9-C7-54-43	ro 1
[HW-Revision]	Wersja sprzętu	Np. AA	ro 1
[Product text]	Oznaczenie produktu	Bluetooth Mesh IoT Basestation	ro 1
[Vendor]	Sprzedawca	ifm electronic gmbh	ro 1
[Product code]	Numer artykułu	EIO404	ro 1

1 Tylko do odczytu

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Info].
▷ Strona menu pokazuje informacje o urządzeniu.

8.4.3 IoT: Konfiguracja ustawień IP

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[IP address]	Adres IP interfejsu Ethernet	np.: 192.168.0.100	rw 1
[Subnet mask]	Maska podsieci sieci Ethernet	np.: 255.255.255.0	rw 1
[Default gateway IP address]	Adres IP bramy sieciowej	np.: 192.168.0.1	rw 1
[DHCP]	Włączanie/wyłączanie klienta DHCP urządzenia	Statyczne IP Ustawienia IP są nadawane przez użytkownika (domyślnie)DHCP Ustawienia IP są ustawiane przez serwer DHCP w sieci.	rw 1
[MAC address]	Adres MAC interfejsu	Np. 00-02-01-42-DC-B0	ro 2

¹ Odczyt i zapis
² Tylko do odczytu

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [IoT] .

▷ Strona menu pokazuje bieżące ustawienia interfejsu Ethernet.

▶ Ustawić parametry.
▶ Zapisać zmienione wartości w czujniku.
▷ Nowe ustawienia IP interfejsu Ethernet są aktywne.

8.4.4 IoT: Konfigurowanie ochrony hasłem

Ochrona hasłem służy do zabezpieczenia urządzenia przed nieautoryzowanym dostępem za pośrednictwem interfejsu Ethernet.

Po ustawieniu hasła użytkownik musi uwierzytełnić się za pomocą nazwy użytkownika i hasła podczas uzyskiwania dostępu do urządzenia za pośrednictwem interfejsu Ethernet.

Nazwa użytkownika to administrator. Nazwa użytkownika jest stała i nie można jej zmienić.

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Security password]	Hasło zabezpieczające dostęp do inter-fejsu Ethernet (dozwolona długość: 6 do 32 znaków)		wo 1

¹ tylko zapis

8.4.4.1 Ustawianie hasła sieci Ethernet

Aby ustawić hasło dla interfejsu Ethernet:

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [IoT] .
▷ Strona menu pokazuje bieżące ustawienia.
▶ Wprowadź hasło.
▶ Zapisać zmienione wartości w czujniku.
▷ Ochrona hasłem jest włączona.
▷ Następnym razem, gdy użytkownik uzyska dostęp do urządzenia, musi zalogować się przy użyciu swojej nazwy użytkownika i wybranego hasła.

8.4.4.2 Resetowanie hasta sieci Ethernet

Zresetowanie hasła dezaktywuje ochronę przed nieautoryzowanym dostępem do interfejsu Ethernet urządzenia.

Aby zresetować hało dla interfejsu Ethernet:

Wymagania:

√ Widok [ Konfiguracja urządzeń] jest otwarty.

√ Otwarty jest edytor wartości parametrów dla urządzenia.
√ Tryb zabezpieczeń interfejsu Ethernet jest włączony.

▶ Wybierz menu [IoT] . ▷ Strona menu pokazuje bieżące ustawienia.

▶ Kliknij [Reset password].

▷ Hasło zostanie usunięte.

▷ Ochrona hasłem jest wyłączona.

Użytkownik może uzyskać dostęp do urządzenia za pośrednictwem interfejsu Ethernet bez konieczności wprowadzania nazwy użytkownika i hasła.

8.4.5 Bluetooth LE: Ustawianie nazw stacji

Dostępne punkty danych:

Nazwa	Opis	Zakres wartości	Dostęp
[Bluetooth LE name]	Nazwa urządzenia w siatce Bluetooth LE (maks. 22 znaki)	Np. kolektor temperatury	rw 1

1 Odczyt i zapis

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Bluetooth LE].
▷ Strona menu pokazuje bieżące ustawienia.
▶ Wprowadź nazwę stacji.
▶ Zapisać zmienione wartości w czujniku.
▷ Nazwa urządzenia w siatce Bluetooth LE jest ustawiona.

8.4.6 Bluetooth LE: Konfigurowanie ochrony hasłem

Zwróć uwagę na informacje dotyczące hasła Bluetooth: Hasło Bluetooth (→ 18).

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Security password]	Ustaw hasło do uwierzytelniania w inter-fejsie Bluetooth LE• Min. długość: 6• Maks. długość: 32UWAGA! Hasło nie ma wpływu na funkcjonalność siatkimesh.		rw 1

¹ Odczyt i zapis

8.4.6.1 Zmiana hasła Bluetooth

Aby zmienić hasło dla interfejsu Bluetooth LE:

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Bluetooth LE].
▷ Strona menu pokazuje bieżące ustawienia.
▶ Wprowadź hasło.

▶ Zapisać zmienione wartości w czujniku.
▷ Nowe hasło jest aktywne.

8.4.7 Bluetooth Mesh: Zarządzanie siatką

Aby uzyskać informacje na temat adapterów mesh aktywnych w siatce:

Dostępne informacje:

Nazwa	Opis	Zakres wartości	Dostęp
[Max Mesh Nodes]	Maks. liczba węzłów	0...50	ro 1
[Current Mesh Nodes]	Aktualna liczba węzłów w siatce mesh	0...50	ro 1
[Taken Mesh Credits]	Bieżąca liczba kredytów wykorzystanych do tworzenia rezerw		ro 1

1 Tylko do odczytu

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Bluetooth Mesh] .
▷ Strona menu zawiera informacje o siatce mesh.

8.4.8 MQTT Konfigurowanie połączenia MQTT

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[MQTT Version]	Wersja MQTT	Np.: #3,1/1	ro 1
[Quality of Service]	Jakość usługi (QoS) połączenia MQTT	QoS 0: Poziom QoS 0 – PUBLIKUJ (bez potwierdzenia) (domyślnie)QoS 1: Poziom QoS 1 - PUBLIKUJ > PUBREC (pojedyncze potwierdzenie)QoS 2: Poziom QoS 2 - PUBLIKUJ > PUBREC > PUBREL > PUBCOMP (podwójne potwierdzenie)	rw 2
[Keep Alive]	Maksymalny czas między 2 kolejnymi pakietami protokołu MQTT (wartość w s)	0: 0 s...10: 10 s...60: 60 s	rw 2

1 Tylko do odczytu

² Odczyt i zapis

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Otwórz menu [MQTT].
▷ Strona menu pokazuje bieżącą konfigurację połączenia MQTT.
▶ Ustawić parametry.
▶ Zapisać zmienione wartości w czujniku.
Połączenie MQTT zostało skonfigurowane.

8.4.8.1 Kontrolowanie połączenia MQTT

Poniższy diagram stanu pokazuje, w jaki sposób usługi start, stop i reset wpływają na bieżący stan połączenia MQTT:

Po udanej inicjalizacji w stanie init połączenie automatycznie przechodzi do stanu running.

Połączenie automatycznie przełącza się w stan error, jeśli wystąpi co najmniej jedno z poniższych zdarzeń:

- Nie można uzyskać połączenia z brokerem MQTT

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
√ Połączenie MQTT zostało skonfigurowane.
▶ Otwórz menu [MQTT].

Aby włączyć połączenie MQTT:

▶ Kliknij [Start].
▷ Połączenie MQTT jest włączone.

Aby wyłączyć połączenie MQTT:

▶ Kliknij [Stop].
▷ Połączenie MQTT jest wyłączone.

Aby zresetować połączenie MQTT:

▶ Kliknij [Reset].
▷ Połączenie MQTT jest resetowane.

8.4.9 MQTT Konfigurowanie kanału poleceń

Upewnij się, że można uzyskać dostęp do brokera MQTT i że wybrany port brokera MQTT jest zwolniony do przesyłania danych.

Symbole wieloznaczne "+" i "#" nie są obsługiwane w nazwach tematów.

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Broker IP]	Adres IP brokera MQTT	np.: 3.69.1.9	rw 1
[Broker Port]	Numer portu brokera MQTT	Np. 1883	rw 1
[Topic]	Oznaczenie tematu MQTT	Np. reqTopic	rw 1
[Reply Topic]	Standardowy temat odpowiedzi	Np. resp Topic	rw 1
[Username]	Nazwa użytkownika	Np. user1	rw 1
[Password]	Hasło (nie zakodowane w Base64)	Np. hasło123	wo 2

1 Odczyt i zapis
² tylko zapis

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
Przejdź do [MQTT] > [MQTT Command Channel].
▷ Strona menu pokazuje bieżącą konfigurację kanału poleceń MQTT.
▶ Ustawić parametry.
▶ Zapisać zmienione wartości w czujniku.
▷ Kanał poleceń MQTT jest skonfigurowany.

8.4.9.1 Zarządzanie kanałem poleceń MQTT

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
√ ▷ Kanał poleceń MQTT jest skonfigurowany.
Przejdź do [MQTT] > [MQTT Command Channel].

Aby włączyć kanał poleceń MQTT:

▶ Kliknij [Start].
▷ Kanał poleceń MQTT jest włączony.

Aby wyłączyć kanał poleceń MQTT:

▶ Kliknij [Stop].
▷ Kanał poleceń MQTT jest wyłączony.

Aby zresetować kanał poleceń MQTT:

▶ Kliknij [Reset].
▷ Kanał poleceń MQTT został zresetowany.

8.4.10 Timer Konfigurowanie timerów

Urządzenie posiada 2 timery. Timery mogą być używane do wyzwalanej czasowo transmisji powiadomień.

Dostępne parametry:

Nazwa	Opis	Zakres wartości	Dostęp
[Interval]	Interwał zliczania (wartość w ms)	1000: 1000 ms86400000: 86400000 ms	rw 1

¹ Odczyt i zapis

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.

▶ Wybierz menu [Timer 1] / [Timer 2].
▷ Strona menu pokazuje bieżące ustawienia.

▶ Wprowadź interwał licznika.

▶ Zapisać zmienione wartości w czujniku.

▷ Ustawiony zostanie interwał wybranego licznika.

8.4.10.1 Uruchamianie timera

Timery [Timer 1] i [Timer 2] mogą być uruchamiane oddzielnie.

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
√ Ustawiony jest interwał licznika.
▶ Wybierz menu [Timer 1] / [Timer 2].
▷ Strona menu pokazuje bieżące ustawienia.
▶ Kliknij [Start].
▷ Wybrany timer zaczyna się od 0.
▷ Po upływie ustawionego interwału licznik generuje sygnał.

8.4.10.2 Zatrzymywanie timera

Timery [Timer 1] i [Timer 2] mogą być zatrzymywane oddzielnie.

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Timer 1] / [Timer 2].
▷ Strona menu pokazuje bieżące ustawienia.
▶ Kliknij [Stop].
▷ Timer jest zatrzymany.

8.4.11 Oprogramowanie sprzętowe: Resetowanie, ponowne uruchamianie i lokalizowanie urządzenia

Wymagania:

√ Otwarty jest edytor wartości parametrów dla urządzenia.
▶ Wybierz menu [Firmware].
▷ Strona menu pokazuje bieżące opcje.

Aby zlokalizować urządzenie:

▶ Kliknij [Signal].
▷ Diody LED na urządzeniu migają.

Aby zresetować urządzenie:

▶ Kliknij [Factory Reset].

▷ Następujące ustawienia zostaną przywrócone do ustawień fabrycznych:

Aby ponownie uruchomić urządzenie:

▶ Kliknij [Reboot].

▷ Ponowne uruchomienie urządzenia

8.5 Wizualizator rdzenia IoT:

Wizualizator IoT Core zapewnia graficzny interfejs użytkownika umożliwiający dostęp do funkcji IoT Core ifm.

8.5.1 Aby uruchomić wizualizator IoTCore:

Aby uruchomić wizualizator IoTCore:

Wymagania:

√ Urządzenie jest prawidłowo podłączone, Parametryzacja przez interfejs Ethernet (→ 17).
√ Interfejs Ethernet jest skonfigurowany.
▶ Uruchom przeglądarkę internetową.
▶ Przejdź do następującego adresu URL: http:// (w ustawieniach fabrycznych http://192.168.0.79).
Przegładarka internetowa wyświetla stronę startową IoT Core Visualizer.

Menu nawigacyjne zapewnia użytkownikowi dostęp do następujących funkcji:

• [Notification]: Zarządzanie powiadomieniami (→ 59)
• [Elements]: Dostęp do drzewa IoT Core (→ 61)
- [Update]:

8.5.2 Zarządzanie powiadomieniami

Strona menu [Notification] zapewnia dostęp do funkcji powiadomień IoT Core.

▶ Przestrzegaj uwag dotyczących powiadomień: Korzystanie z powiadomień (→ 39)

Wymagania:

√ Wizualizator lot-Core został uruchomiony.

▶ Wybierz menu [Notification].
▷ Zostanie wyświetlona strona menu zarządzania powiadomieniami.
▷ Tabela pokazuje wszystkie aktywne powiadomienia.

8.5.2.1 Tworzenie nowych powiadomień

Nowe powiadomienia są tworzone za pomocą kreatora.

W przypadku powiadomień uruchamianych w określonym czasie za pomocą timera 1 lub timera 2 użytkownik musi ustawić interwał czasu odpowiedniego timera.

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
√ Menu [Notification] jest aktywne.
▶ Kliknij przycisk + po prawej stronie tabeli.

▷ Pojawi się kreator tworzenia powiadomień.

▶ Użyj kreatora, aby krok po kroku wprowadzić wymagane parametry powiadomienia.
▷ Tabela przedstawia utworzone powiadomienie.

8.5.2.2 Usuwanie powiadomień

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
√ Menu [Notification] jest aktywne.
√ Utworzono co najmniej jedno powiadomienie.
Kliknij × w wierszu powiadomień w kolumnie [Unsubscribe].
▷ Wybrane powiadomienie zostanie usunięte.

8.5.3 Dostęp do drzewa IoT Core

Strona menu [Elements] zapewnia dostęp do drzewa IoT Core urządzenia.

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
▶ Wybierz opcję menu [Elements].
▷ Zostanie wyświetlona strona menu umożliwiająca dostęp do elementów drzewa rdzenia IoT.
▷ Wizualizowana jest struktura drzewa IoT Core urządzenia.

8.5.3.1 Wyszukiwanie elementów IoT Core

Strona menu [Elements] umożliwia przeszukiwanie drzewa IoT Core w poszukiwaniu elementów o określonych właściwościach i wyświetlanie wyników.

Wyszukiwane mogą być następujące właściwości:

• [identifier]: Nazwa elementu
• [profile]: Profil elementu
• [type]: Typ elementu

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
√ Menu [Elements] jest aktywne.

▶ Wybierz kryteria wyszukiwania dla wymaganego elementu na listach wyboru [identifier], [profile] i [type].
▶ Kliknij [Search for Elements].
▷ Wizualizator IoT-Core przeszuka opis urządzenia pod kątem elementów spełniających wybrane kryteria wyszukiwania.
▷ Lista wyników zawiera wszystkie znalezione elementy.

8.5.3.2 Dostęp do elementów IoT Core

Użytkownik może uzyskać dostęp do elementów IoT Core za pomocą usług obsługiwanych przez urządzenie.

▶ Aby uzyskać więcej informacji na temat funkcji ifm IoT Core, zobacz: ifm IoT Core REST API (→ 25)

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
√ Menu [Elements] jest aktywne.
▶ Opcjonalnie: Wyszukiwanie elementów IoT Core (→ ☐ 61)
▶ Przejdź do elementu.
▶ Kliknij symbol strzałki obok usługi.

▷ Pojawi się okno dialogowe.

▶ Opcjonalnie: W przypadku dostępu do zapisu wprowadź wymagane wartości w polu.
▶ Kliknij [Request], aby wykonać usługę.
▷ Usługa jest wykonywana na urządzeniu.

LUB

▶ Kliknij [Cancel], aby anulować proces.
▷ Usługa nie jest wykonywana.

8.5.4 Aktualizacja oprogramowania sprzętowego

Strona menu [Update] oferuje opcję aktualizacji oprogramowania sprzętowego stacji bazowej Bluetooth Mesh IoT i udostępnionych adapterów Bluetooth Mesh IO-Link.

Nowe oprogramowanie sprzętowe dostępne na stronie szczegółów produktu urządzenia: documentation.ifm.com

Aby uzyskać informacje na temat aktualizacji oprogramowania sprzętowego pojedynczego adaptera Bluetooth Mesh IO-Link: Instrukcja obsługi EIO344

Aktualizacja oprogramowania sprzętowego nie może zostać przerwana.

▶ Nie należy ponownie uruchamiać urządzenia podczas procesu aktualizacji.
▶ Poczekaj na zakończenie aktualizacji.

Wymagania:

√ Wizualizator lot-Core został uruchomiony.
√ Pobrano nowe oprogramowanie sprzętowe. documentation.ifm.com
▶ Wybierz menu [Update].

▷ Na stronie menu wyświetlane są informacje o bieżącej wersji oprogramowania sprzętowego stacji bazowej Bluetooth Mesh IoT (obszar [Base_update]).

▷ Na stronie menu wyświetlane są informacje o aktualnej wersji oprogramowania sprzętowego adapterów Bluetooth Mesh IO-Link zainstalowanych na stacji bazowej (obszar [Adapter_update]).

00-02-01-30-1A-00 - online						Visualizer v2.25.257
Notification	Elements	Update
Base_update
00-02-01-30-1A-00/firmware/base_update			Container
Version:	V1.54	G	Chunk size:	1024	G
Type:	firmware	G	Max size:	2621440	G
Load software file	choose software package		Size:	0	G
Update
Adapter_update
00-02-01-30-1A-00/meshnetwork/adapter_update			Container
Version:	unknown	G	Chunk size:	1024	G
Type:	firmware	G	Max size:	2621440	G
Load software file	choose software package		Size:	0	G
Update

Aby zaktualizować oprogramowanie sprzętowe stacji bazowej Bluetooth Mesh IoT:

▶ Przejdź do obszaru stacji bazowej Bluetooth Mesh IoT.
▶ Kliknij przycisk [Load software file] i wybierz nowy plik oprogramowania sprzętowego (*.bin).

▶ Kliknij przycisk [Update], aby rozpocząć proces aktualizacji.

Oprogramowanie sprzętowe stacji bazowej Bluetooth Mesh IoT jest aktualizowane.

▷ Wyświetlany jest postęp procesu aktualizacji.

▷ Po pomyślnej aktualizacji: Urządzenie uruchami się ponownie automatycznie.

Aby zaktualizować oprogramowanie sprzętowe wszystkich udostępnionych i podłączonych adapterów Bluetooth Mesh IO-Link:

▶ Przejdź do obszaru adaptera Bluetooth Mesh IO-Link.
▶ Kliknij przycisk [Load software file] i wybierz nowy plik oprogramowania sprzętowego (*.bin).

▶ Kliknij przycisk [Update], aby rozpocząć proces aktualizacji.

Oprogramowanie sprzętowe wszystkich udostępnionych i podłączonych adapterów Bluetooth Mesh IO-Link jest aktualizowane.

▷ Wyświetlany jest postęp procesu aktualizacji.

▷ Po pomyślnej aktualizacji: Urządzenia uruchomią się ponownie automatycznie.

9 Rozwiązywanie problemów

Błędy, ostrzeżenia i komunikaty o stanie są wskazywane przez diodę LED stanu: Wyświetlacz i przyciski sterujące (→ 16)

W przypadku wystąpienia błędu (dioda LED stanu miga na czerwono), status urządzenia dostarcza szczegółowych informacji diagnostycznych.

Opis błędu	Przyczyna usterki	Działania korekcyjne
Urządzenie jest podłączone do zasilania, dioda LED stanu jest wyłączona	Za niskie napięcie zasilania	► Sprawdź napięcie zasilania
Urządzenie jest podłączone do zasilania, dioda LED stanu świeci na czerwono	Bład sprzętowy, urządzenie jest uszkodzone	► Wymienić urządzenie.
Dioda LED stanu miga na czerwono, co oznacza stan urządzenia: [Over temperature] lub [Under temperature]	Temperatura płytki drukowanej poza zakresem tolerancji	► Sprawdź temperaturę otoczenia
Dioda LED stanu miga na czerwono, status urządzenia: [Bluetooth Mesh no device provisioned]	Brak połączenia z siatką Bluetooth Mesh	► Sprawdź odległości do adapterów Bluetooth Mesh IO-Link
Dioda LED stanu miga na czerwono, status urządzenia: [Ethernet link not connected]	Brak połączenia Ethernet	► Sprawdź okablowanie Ethernet

ifm moneo zapewnia dodatkowe informacje o stanie i diagnostyce w trybie online: → ifm moneo pomoc online

10 Konserwacja, naprawa, utylizacja

Urządzenie nie wymaga konserwacji.

▶ W przypadku awarii należy skontaktować się z ifm.
▶ Nie należy otwierać obudowy, ponieważ urządzenie nie zawiera żadnych elementów, które mogą być konserwowane przez użytkownika. Urządzenie może być naprawiane wyłącznie przez producenta.
▶ Urządzenie należy czyścić suchą szmatką.
▶ Urządzenie należy utylizować zgodnie z krajowymi przepisami dotyczącymi ochrony środowiska.

10.1 Aktualizacja oprogramowania sprzętowego

Oprogramowanie sprzętowe urządzenia można zaktualizować za pomocą następujących opcji:

• ifm moneo|blue: Aktualizacja oprogramowania sprzętowego (→ 23)
• Wizualizator IoT-Core: Aktualizacja oprogramowania sprzętowego (→ 63)

11 Dodatek

11.1 ifm IoT Core

11.1.1 Profile

Profil	Opis
blob	Duży obiekt binarny
comm Channel	Kanał komunikacji
comm Interface	Interfejs komunikacyjny
POŁĄCZ	Połączenia
const_value	Stały
datarequired	Wymagane dane
deviceinfo	Informacje identyfikacyjne
devicereset	Resetowalne oprogramowanie sprzętowe
devicestatus	Status urządzenia
eventcollection	Kolekcja wydarzeń
mqtt CmdChannel Setup	Ustawienia kanału poleceń MQTT
mqtt Setup	Ustawienia MQTT
sieć	Sieć
parameter	Parametr
processdata	Dane procesowe
runcontrol	Struktura sterowania
securityconfig_base	Ustawienia zabezpieczeń
oprogramowanie	Oprogramowanie
software/uploadable-software	Oprogramowanie z możliwością aktualizacji
subdatablock	Dane, które można zmieniać tylko blokowo
timer	Timer
wirelessprovisioning	Struktura zarządzania sieciami radiowymi

11.1.2 Typy

Typ	Opis
dane	Punkt danych
urządzenie	Element główny reprezentujący urządzenie
zdarzenie	Zdarzenie, które może być uruchamiane przez oprogramowanie sprzętowe i wysyła komunikaty.
serwis	Serwis jest usługą, która może być adresowana z sieci
struktura	Element struktury (np. folder w systemie plików)

11.1.3 Usługi

11.1.3.1 Serwis: Utwórz kopię zapasową

Nazwa: create_backup

Opis: Usługa tworzy kopię zapasową bieżących ustawień urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.2 Serwis: factoryreset

Nazwa: factoryreset

Opis: Usługa ustawia parametry urządzenia na ustawienia fabryczne.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.3 Serwis: get_credit

Nazwa: get_credit

Opis: Usługa odczytuje dostępny kredyt sieci Bluetooth.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
netkey	Obowiązkowe	CIĄG ZNA-KÓW	Klucz sieciowy
iv_key	Obowiązkowe	INT	Spis treści
appkey	Obowiązkowe	CIĄG ZNA-KÓW	Klucz aplikacji
Adres	Obowiązkowe	INT	Adres
expiry_time	Obowiązkowe	INT	Czas wygaśnięcia (wartość w s)

11.1.3.4 Serwis: getblobdata

Nazwa: getblobdata

Opis: Usługa odczytuje binarny duży obiekt (blob).

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
pos	Obowiązkowe	LICZBA	Pozycja bajtu
length	Obowiązkowe	LICZBA	Rozmiar obiektu (liczba bajtów)

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
dane	Obowiązkowe	CIĄG ZNA-KÓW	Dane do zdekodowania (zakodowane w BASE64)
crc	Opcjonalne	CIĄG SZES-NASTKOWY	CRC danych po zdekodowaniu
md5	Opcjonalne	CIĄG SZES-NASTKOWY	Suma kontrolna MD5 danych po zdekodowaniu

11.1.3.5 Serwis: getdata

Nazwa: getdata

Opis: Usługa odczytuje wartość punktu danych i podaje ją.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
wartość	Obowiązkowe	CIĄG ZNA-KÓW	Wartość punktu danych

11.1.3.6 Serwis: getdatamulti

Nazwa: getdatamulti

Opis: Usługa sekwencyjnie odczytuje wartości kilku punktów danych i dostarcza je. Dla każdego punktu danych podawana jest wartość i kod diagnostyczny.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
datatosend	Obowiązkowe	TABLICA CIĄGÓW ZNAKÓW	Lista punktów danych, których ma dotyczyć żądanie; punkty danych muszą obsługiwać usługę getdata ("datatosend":["url1", "url2",..., "ur-lx"])

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
url	Obowiązkowe	CIĄG ZNA-KÓW	Punkt danych, którego dotyczyło zapytanie
kod	Obowiązkowe	INT	Kod diagnostyczny żądania
dane	Obowiązkowe	CIĄG ZNA-KÓW	Wartość punktu danych

11.1.3.7 Serwis: getidentity

Nazwa: getidentity

Opis: Usługa pobiera informacje dotyczące tożsamości urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"):

Parametr	Pole obowiązkowe	Typ danych	Opis
iot		urządzenie	Opis urządzenia jako obiekt JSON
iot.name	obowiązkowe	CIĄG ZNA-KÓW	Typ elementu
iot.uid	opcja	CIĄG ZNA-KÓW
iot.version	obowiązkowe	CIĄG ZNA-KÓW
iot.catalogue	opcja	TABLICA OBIEKTÓW
iot.deviceclass	opcja	TABLICA CIĄGU ZNA-KÓW	Klasa urządzenia
iot.serverlist	opcja	TABLICA OBIEKTÓW
urządzenie	opcja		Numer artykułu
device.serialnumber	opcja		Numer seryjny
device.hwrevision	opcja		Wersja sprzętu
device.swrevision	opcja		Wersja oprogramowania
device.custom	opcja

Parametr security.isPasswd
Set zwraca stan hasła połączenia, za pośrednictwem którego uzyskiwany jest dostęp do usługi.

Przykład 1:

√ Ustawiono hasło dla połączenia Bluetooth.

▶ Wykonaj żądanie getidentity za pośrednictwem przeglądarki internetowej.

▷ security.isPasswd
Set = false

Przykład 2:

√ Ustawiono hasło dla połączenia Ethernet.
▶ Wykonaj żądanie getidentity za pośrednictwem przeglądarki internetowej.
▷ security.isPasswd
Set = true

11.1.3.8 Serwis: getsubscriberlist

Nazwa: getsubscriberlist

Opis: Usługa udostępnia listę wszystkich aktywnych subskrypcji.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
adr	obowiązkowe	STRING	Wyzwalacz powiadomienia
datatosend	obowiązkowe	ARRAY OF STRINGS	Lista z adresami URL elementów danych; Adresy URL są rozdzielane przecinkami
cid	obowiązkowe	STRING	Identyfikator aktywnego powiadomienia
callbackurl	obowiązkowe	STRING	Adres docelowy dla powiadomień
duration	obowiązkowe	STRING	Czas trwania aktywności

11.1.3.9 Serwis: gettree

Nazwa: gettree

Opis: Ustuga odczytuje opis urządzenia nadrzędnego IO-Link i wyprowadza go jako obiekt JSON. Dane wyjściowe mogą być ograniczone do poddrzewa opisu urządzenia.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
adr	Opcjonalne	CIĄG ZNA-KÓW	Element główny poddrzewa
level	Opcjonalne	CIĄG ZNA-KÓW	maks. poziom, do którego wyprowadzane jest poddrzewo• brak wpisu: wyświetlone zostaną wszystkie poziomy• 0: nie wyświetlaj podelementów ("subów")• 1: wyświetlaj podelementy• 2: wyświetlaj podelementy do 2. poziomu• 3: wyświetlaj podelementy do 3. poziomu...• 20: wyświetlaj podelementy do 20. poziomu

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
identifier	obowiązkowe	CIĄG ZNA-KÓW	Identyfikator elementu głównego
type	obowiązkowe	CIĄG ZNA-KÓW	Typ elementu
format	Opcjonalne	Obiekt JSON	Format zawartości
uid	Opcjonalne	CIĄG ZNA-KÓW
profiles	Opcjonalne	tablica JSON
subs	obowiązkowe	tablica JSON	Podelementy
hash	Opcjonalne	CIĄG ZNA-KÓW

11.1.3.10 Serwis: instalacja

Nazwa: install

Opis: Usługa instaluje oprogramowanie przechowywane w obszarze pamięci urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.11 Serwis: install_backup

Nazwa: install_backup

Opis: Usługa przywraca kopię zapasową przechowywaną w pamięci urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.12 Serwis: querytree

Nazwa: querytree

Opis: Usługa przeszukuje drzewo urządzeń pod kątem kryteriów profile, type and identifieri wyprowadza listę z adresami URL znalezionych elementów. Co najmniej jedno z kryteriów wyszukiwania musi być określone. Usługa może być wykonana tylko na węźle głównym urządzenia.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
profile	Opcjonalne	STRING	Profil żądanego elementu
type	Opcjonalne	STRING	Typ żądanego elementu
identifier	Opcjonalne	STRING	Nazwa żądanego elementu

Odpowiedź (pole "data"): brak

Parametr	Pole obo-wiązkowe	Typ danych	Opis
urllist	obowiązkowe	ARRAY	Tablica z adresami URL znalezionych elementów; Adresy URL są od-dzielone przecinkami

11.1.3.13 Serwis: uruchom ponownie

Nazwa: reboot

Opis: Usługa powoduje ponowne uruchomienie urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.14 Serwis: Zarejestruj

Nazwa: register

Opis: Usługa rejestruje obsługiwane urządzenie w sieci.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
identyfikator	Obowiązkowe	CIĄG ZNA-KÓW	Identyfikator urządzenia, które ma zostać zarejestrowane w sieci.

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
adr	Opcjonalne	CIĄG ZNA-KÓW	Ścieżka do urządzenia w strukturze sieci

11.1.3.15 Serwis: Zastąp

Nazwa: replace

Opis: Usługa wyrejestrowuje urządzenie z sieci i rejestruje w sieci urządzenie tego samego typu.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
old_id	Obowiązkowe	CIĄG ZNA-KÓW	Identyfikator urządzenia, które ma zostać wymienione
new_id	Obowiązkowe	CIĄG ZNA-KÓW	Identyfikator urządzenia, które ma zostać zarejestrowane

Odpowiedź (pole "data"): brak

11.1.3.16 Serwis: Resetuj

Nazwa: reset

Opis: Usługa resetuje połączenie do stanu inicjalizacji.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.17 Serwis: resetpassword

Nazwa: resetpassword

Opis: Usługa dezaktywuje tryb zabezpieczeń i resetuje hasło.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.18 Serwis: reset_credits

Nazwa: reset_credits

Opis: Usługa resetuje wszystkie wymagane kredyty adapterów Bluetooth zarejestrowanych w sieci mesh.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.19 Serwis: Skanuj

Nazwa: scan

Opis: Usługa wyszukuje obsługiwane urządzenia w pobliżu. Znalezione urządzenia i ich właściwości są wyświetlane.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
identyfikator	Obowiązkowe	CIĄG ZNA-KÓW	Identyfikator urządzenia
nazwa	Obowiązkowe	CIĄG ZNA-KÓW	Nazwa urządzenia
Informacje	Opcjonalne	TABLICA	Właściwości urządzenia• Obowiązkowe Siła sygnału

11.1.3.20 Serwis: setblock

Nazwa: setblock

Opis: Usługa jednocześnie ustawia wartości kilku punktów danych struktury.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
datatoset	obowiązkowe	ARRAY OF OBJECTS	Lista punktów danych i ich nowych wartości; punkty danych muszą ob-sługiwać usługę setdata
consistent	Opcjonalne	BOOL	Odpowiedź w określonym czasie

Odpowiedź (pole "data"): brak

11.1.3.21 Serwis: setdata

Nazwa: setdata

Opis: Usługa ustawia wartość punktu danych.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
newvalue	obowiązkowe	STRING	Nowa wartość elementu/punktu danych
duration	Opcjonalne	STRING	Czas przechowywania wartościlifetime: Wartość jest zapisywana w IoT Core; Wartość pozostaje ważna nawet po ponownym uruchomieniu urządzeniauptime: Wartość jest zapisywana do następnego ponownego uruchomienia urządzenia.

Odpowiedź (pole "data"): brak

11.1.3.22 Serwis: setdatamulti

Nazwa: setdatamulti

Opis: Usługa zapisuje sekwencyjnie wartości wielu punktów danych. Dla każdego punktu danych należy podać wartość docelową.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
datatosend	obowiązkowe	ARRAY OF STRINGS	Lista punktów danych i powiązanych wartości (zakodowanych) do zapisania; punkty danych muszą obsługiwać usługę setdata ("datatosend": ["url1": "value1", "url2": "value2", ..., "urlx": "valuex"]).

Odpowiedź (pole "data"): brak

11.1.3.23 Serwis: signal

Nazwa: signal

Opis: Usługa uruchamia miganie diod LED stanu urządzenia.

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.24 Serwis: /start

Nazwa: start

Opis: Ustuga uruchamia funkcję (np. połączenie, licznik czasu).

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.25 Serwis: start_stream_set

Nazwa: start_stream_set

Opis: Usługa rozpoczyna sekwencyjny transfer wielu fragmentów danych.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
size	obowiązkowe	STRING	Całkowita długość danych do przesłania (liczba bajtów)

Odpowiedź (pole "data"): brak

11.1.3.26 Serwis: stop

Nazwa: stop

Opis: Usługa zatrzymuje funkcję (np. połączenie, licznik czasu).

Żądanie (pole "dane"): brak

Odpowiedź (pole "data"): brak

11.1.3.27 Serwis: stream_set

Nazwa: stream_set

Opis: Usługa przesyła segment danych.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
value	obowiązkowe	BIN (BASE64)	Segment danych binarnych (zakodowanych w BASE64)

Odpowiedź (pole "data"): brak

11.1.3.28 Serwis: subscribe

Nazwa: subscribe

Opis: Usługa aktywuje powiadomienie.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
callback	Obowiązkowe	CIĄG ZNA-KÓW	Adres docelowy dla powiadomień; format URL:JSON: http://ipaddress:port/pathJSON: ws://pathMQTT mqtt://ipaddress:port/path
datatosend	Obowiązkowe	TABLICA CIĄGÓW ZNAKÓW	Lista z adresami URL elementów danych; Adresy URL są rozdzielane przecinkami; elementy muszą obsługiwać usługę getdata
czas trwania	Opcjonalne	CIĄG ZNA-KÓW	Okres ważności powiadomieniaczas używalności: logowanie pozostaje stale aktywne, również po ponownym uruchomieniu urządzeniaczas pracy urządzenia: Logowanie pozostaje aktywne do następnego ponownego uruchomienia urządzeniaraz: wysłanie tylko jednego powiadomienia, użytkownik musi natychmiast zrezygnować z subskrypcji

Odpowiedź (pole "data"): brak

Format powiadomienia: JSON

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "EventNo",
    "srcurl": "SrcURL",
    "payload": {
    "eventurl": {"code": Event
Status, "data": Event
Data},
    "datapointurl_1": {"code": DataStatus_1, "data": DataValue_1},
    "datapointurl_2": {"code": DataStatus_2, "data": DataValue_2}, ...
    }
    }
} 

11.1.3.29 Serwis: unregister

Nazwa: unregister

Opis: Usługa wyrejestrowuje urządzenie z sieci.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
identyfikator	opcjonalnie1	CIĄG ZNA-KÓW	Identyfikator urządzenia, które ma zostać wyrejestrowane z sieci.
adr	opcjonalnie1	CIĄG ZNA-KÓW	Ścieżka do urządzenia w strukturze sieci

¹ co najmniej jeden z dwu parametrów musi być podany.

Odpowiedź (pole "data"): brak

11.1.3.30 Serwis: unsubscribe

Nazwa: unsubscribe

Opis: Usługa usuwa aktywne powiadomienie. Podane wartości dla "cid" i "callback" muszą być identyczne z wartościami rejestracji powiadomienia (subskrypcji). Jeśli w wywołaniu zwrotnym podana zostanie wartość "DELETE", wszystkie aktywne subskrypcje zostaną usunięte.

Żądanie (pole "dane"):

Parametr	Pole obo-wiązkowe	Typ danych	Opis
callback	Obowiązkowe	CIĄG ZNA-KÓW	Adres docelowy dla powiadomień; format URL:JSON: http://ipaddress:port/pathJSON: ws://pathJSON: mqtt://ipadress:port/topic Usunięto: wszystkie aktywne powiadomienia zostaną usunięte

Odpowiedź (pole "data"): brak