Instrukcja obsługi Podłączanie LinkIt 7688 (Duo) do QNAP NAS za pomocą QIoT Suite Lite

Pierwsze kroki z LinkIt 7688(Duo) (Python)​

W tym samouczku poznasz podstawy pracy z LinkIt 7688 (Duo) (działającym na OpenWRT). Następnie dowiesz się, jak bezproblemowo podłączyć urządzenia do serwera QNAP NAS przy użyciu QIoT Suite Lite.

Upewnij się, że LinkIt 7688 (Duo) i NAS są w tej samej sieci LAN.

1. Konfiguracja urządzenia​

1.1 Pierwsze kroki​

• Co będzie potrzebne
  1. LinkIt 7688 (Duo)
  2. Zasilacz:
     • LinkIt 7688 jest zasilany przez zasilacz USB Micro o natężeniu co najmniej 1A przy 5V.
  3. Punkt dostępowy Wi-Fi
• Włącz LinkIt 7688(Duo)
  Użyj złącza zasilania (PWR), a nie złącza hosta USB (HOST) znajdującego się obok przycisku resetowania MPU. Zielona dioda ON (zasilanie włączone) zaświeci się, a następnie zamiga pomarańczowa dioda Wi-Fi (inicjalizacja bootloadera). Po około 5 sekundach rozpocznie się uruchamianie urządzenia, a pomarańczowa dioda zaświeci się na stałe przez około 30 sekund.
  
  
  

1.2 Podłączanie LinkIt 7688(Duo) do sieci​

• Włącz tryb AP
  • Po uruchomieniu dioda Wi-Fi zgaśnie. Oznacza to, że system jest gotowy do nawiązania połączenia Wi-Fi.
  • Jeśli tak się nie stanie, naciśnij przycisk resetowania Wi-Fi przez co najmniej 5 sekund i zwolnij go, aby włączyć tryb AP.
    
    
    
• Zapoznaj się z poniższym obrazem, aby zobaczyć stan diody Wi-Fi oraz stan systemu. (źródło obrazu: Media Tek Lab)
  
  
  
• Przejdź do ustawień Wi-Fi i wybierz "LinkIt_Smart_7688_XXXXXXX". (gdzie "XXXXXXX" to adres MAC twojego LinkIt 7688 (Duo)).
  
  
  
• Po dołączeniu do sieci LinkIt Smart otwórz "http://mylinkit.local" lub "http://192.168.100.1" w przeglądarce internetowej.
  • Na stronie logowania ustaw hasło (lub wprowadź wcześniej ustawione hasło).
  • Domyślna nazwa użytkownika to root.
    
    
    
• Po zalogowaniu przejdź do karty "Network" i wybierz "Station Mode", aby skonfigurować punkt dostępowy Wi-Fi, z którym chcesz się połączyć. Twój komputer i urządzenie LinkIt muszą być w tej samej sieci. Kliknij "CONFIGURE & RESTART".
  
  
  
• Zmień sieć komputera na taką samą jak sieć LinkIt.

Aby uzyskać więcej informacji na temat konfiguracji LinkIt 7688(Duo), odwiedź: https://docs.labs.mediatek.com/resource/linkit-smart-7688/en/get-started

2. Tworzenie urządzenia w QIoT Suite Lite​

2.1 Instalacja QIoT Suite Lite​

• QIoT Suite Lite można zainstalować z App Center.
  
  
  
• Uruchom i zaloguj się do QIoT Suite Lite. Domyślna nazwa użytkownika i hasło to "admin".
  
  
  

2.2 Tworzenie nowej aplikacji IoT​

Aplikacje IoT to połączenie elementów Things, Rules i Dashboards. Zalecamy, aby najpierw utworzyć element "Things" w aplikacji IoT. Aplikacja IoT umożliwia przechowywanie rejestru wszystkich urządzeń podłączonych do serwera NAS.

Rules (reguły) umożliwiają tworzenie aplikacji IoT, które zbierają, przetwarzają, analizują i reagują na dane generowane przez podłączone urządzenia. Reguły mogą dotyczyć danych z jednego lub wielu urządzeń i mogą uruchamiać jedną lub wiele akcji równolegle.

Dashboards (pulpity nawigacyjne) przekształcają dane w analizy i raporty zapewniające wgląd w czasie rzeczywistym.

Wszystkie te elementy zapewniają użytkownikowi kompletne środowisko aplikacji IoT.

• Kliknij "IoT Applications".
  
  
  
• Kliknij "Add IoT Application".
  
  
  
• W oknie "Create a New IoT application":
  • Wprowadź nazwę aplikacji IoT (na przykład: "myApp").
  • Nazwa reguły (Rule name) i nazwa pulpitu nawigacyjnego (Dashboard name) zostaną automatycznie wygenerowane na podstawie nazwy aplikacji IoT.
  • Kliknij "Create".
    
    
    
• Kliknij "+ Add Thing", aby dodać urządzenie do tej aplikacji.
  
  
  
• Kliknij "Add Thing", w oknie "Add Thing":
  • Wprowadź nazwę urządzenia (na przykład: "linkIt") oraz informacje o urządzeniu (takie jak numer seryjny i producent) w polu Add attribute.
  • Jeśli urządzenie jest już obsługiwane przez QIoT (Arduino Yun, Raspberry Pi, Edison i LinkIt 7688 (Duo)), wybierz predefiniowany typ Thing Type.
  • Kliknij Add.
    
    
    
• Kliknij "Thing Resource":
  
  
  
• W oknie "Thing Resources" kliknij "Add Resource":
  
  
  
• W oknie "Add Thing Resource":
  • Wprowadź nazwę i identyfikator czujnika w polach Resource Name i Resource ID. Należy pamiętać, że Resource ID będzie używany do utworzenia tematu (Topic) w brokerze QIoT. Identyfikator ten powinien być unikalny dla urządzenia i nie mogą istnieć jego duplikaty dla tego samego urządzenia.
    
    
    
• Jeśli chcesz dodać więcej zasobów, powtórz powyższe kroki. Po zakończeniu kliknij "Close".
  
  
  
• Przejdź do karty "Dashboard", gdzie zostanie utworzony przykładowy pulpit nawigacyjny.
  
  
  
• Przejdź do karty Rule, aby zdefiniować przepływ lub reguły dotyczące przetwarzania danych przesyłanych z urządzenia oraz sposobu ich prezentacji na pulpicie nawigacyjnym.
  
  
  

3. Podłączanie urządzenia do QIoT Suite Lite przy użyciu MQTTS​

3.1 Generowanie informacji o zasobach w QIoT Suite​

• Kliknij "Connect a Device":
  
  
  
• Wybierz MQTTS i kliknij "Generate a Device Certificate":
  
  
  
• W oknie "Download the files to connect" kliknij łącza, aby pobrać na komputer "Device Certificate", "CA Certificate" i "Private Key". Nie zmieniaj nazw tych plików. Kliknij "OK".
  
  
  
• Kliknij "Download JSON file".
  
  
  

3.2 Pobieranie przykładowego kodu​

• Pobierz przykładowy kod z repozytorium GitHub QNAP QIoT Suite Lite.
  • URL: GitHub - qnap-dev/qnap-qiot-sdks: QNAP QIoT - quickly structure your IoT environment and deployment
  • Ścieżka: python/device/mtk-linkit-7688-duo/examples
• Ustaw strukturę danych zgodnie z poniższym obrazem.
  • Plik „resource.json" musi być zapisany w folderze „res", a certyfikat urządzenia, certyfikat CA i klucz prywatny muszą być zapisane w folderze „ssl".
    
    
    
• Otwórz aplikację Terminal (np. WinSCP) na swoim komputerze i zaloguj się do urządzenia.
  • LinkIt 7688 obsługuje wyłącznie protokół SCP. SFTP można zainstalować za pomocą „openssh-sftp-server".
    
    
    
    
    
    
    
    
    
    
    
• Otwórz aplikację Terminal (np. PuTTY) na swoim komputerze. Połącz się z urządzeniem za pomocą SSH i przejdź do folderu, w którym przechowywany jest przykładowy kod (na przykład: /home/root/bundle).
  
  
  
• Aby zainstalować zależności przykładowego kodu, wprowadź następujące polecenia:
  
  
  
• Uruchom przykładowy kod
  
  
  
• Urządzenie wyśle wiadomość do tematu „temp" (lub tematu zdefiniowanego przez użytkownika).
  
  
  

3.3 Korzystanie z innego protokołu​

• Kliknij „Połącz urządzenie".
  
  
  
• Możesz wybrać inny protokół.
  
  
  
• Połącz się z urządzeniem za pomocą SSH i wprowadź następujące polecenia:
  
  
  

4. Integracja z Power BI​

4.1 Utwórz pierwsze konto Power BI​

• Zarejestruj bezpłatne konto PowerBI na stronie Power BI - Data Visualization | Microsoft Power Platform
  
  
• Po rejestracji strona przekieruje Cię do poniższej strony. Kliknij „My workspace", a następnie kliknij „Skip for now".
  
  
  

4.2 Skonfiguruj interfejs API przesyłającego strumieniowo zestawu danych​

• Utwórz „Datasets"
  • Kliknij „Create" w prawym górnym rogu
  • Kliknij „Streaming dataset"
    
    
    
• Wybierz „API" jako źródło danych i kliknij „Next".
  
  
  
• Zdefiniuj wartości ze strumienia (np. temp, max, min), a w polu tekstowym zostanie wyświetlony wynik w formacie JSON. Użyjemy tego kodu JSON do przesyłania danych do aplikacji QIoT Suite Lite. Kliknij „Create", aby zakończyć.
  
  
  
• Po utworzeniu strumienia danych otrzymasz adres URL interfejsu API REST, który aplikacje IoT mogą wywoływać za pomocą żądań POST w celu przesyłania danych na żywo do utworzonego przesyłającego strumieniowo zestawu danych.
  
  
  

4.3 Konfiguracja węzłów Node-RED w aplikacji IoT​

• Utwórz aplikację IoT w QIoT Suite.
• Poniżej przedstawiono pierwszy przepływ Node-RED, od którego możesz zacząć tworzyć własny przepływ IoT. Więcej informacji o Node-RED znajdziesz na stronie Low-code programming for event-driven applications : Node-RED
  
  
  
• Przed rozpoczęciem przesyłania danych na żywo do Power BI potrzebny jest węzeł „function", który przekonwertuje dane IoT na przesyłający strumieniowo zestaw danych. W tym miejscu możesz zastąpić msg.payload własnym zestawem danych JSON.
  
  
  
• Wprowadź kod jak poniżej:
  
  
  
• Potrzebny jest węzeł „http request", który pomoże przesyłać dane na żywo do Power BI. Przeciągnij i upuść węzeł „http request" i połącz go z końcem węzła „function".
  
  
  
• Skopiuj i wklej adres URL interfejsu API REST z konsoli Power BI, a następnie ustaw metodę HTTP na POST. Kliknij „Deploy".
  
  
  
• Twój przepływ Node-RED będzie wyglądał jak poniżej.
  
  
  

4.4 Dodawanie kafelka do wyświetlania danych w czasie rzeczywistym​

• Utwórz „Dashboard"
  • Kliknij „Create" w prawym górnym rogu
  • Kliknij „Dashboard"
  • Wprowadź nazwę pulpitu nawigacyjnego i kliknij „Create".
    
    
    
    
    
    
    
• Kliknij „Add tile" w prawym górnym rogu
  
  
  
• Wybierz „CUSTOM STREAMING DATA" i kliknij „Next".
  
  
  
• Wybierz zestawy danych i kliknij „Next".
  
  
  
• Wybierz typ wizualizacji i ustaw wartość minimalną oraz maksymalną.
  
  
  
• Teraz będziesz mieć przesyłający strumieniowo zestaw danych do pracy. Możesz uzyskać wskaźnik czasu rzeczywistego wyglądający jak poniżej.
  
  
  

• Odwiedź repozytorium GitHub firmy QNAP, aby uzyskać przykładowy kod QIoT Suite Lite:
  „ GitHub - qnap-dev/qnap-qiot-sdks: QNAP QIoT - quickly structure your IoT environment and deployment"
• Aby uzyskać więcej informacji o QIoT Suite Lite, odwiedź stronę
  Support