Urządzenie wirtualne

Matter ; Home APIs

Matter urządzenia wirtualne są przydatne do tworzenia i testowaniaMatter rozwiązań. Można je wdrażać za pomocą Google Home app (GHA) i sterować nimi za pomocą GHA i Google Assistant, tak jak fizycznymi urządzeniami Matter.

Deweloperom aplikacji i innym osobom, które muszą testować lub emulować urządzenie wirtualne, ale nie mają zasobów, aby zbudować własne urządzenie fizyczne lub wirtualne, MatterGoogle oferuje Matter Virtual Device (MVD).Matter MVD to lekkie, samodzielne narzędzie na komputery z systemem Linux lub macOS, które symuluje różne typy wirtualnych urządzeń Matter i zapewnia graficzny interfejs użytkownika do sterowania stanami wirtualnego urządzenia Matter i wyświetlania ich.

W przeciwieństwie do fizycznego urządzenia Matter nie korzysta z Bluetootha® Low Energy (BLE) ani Thread®, aby dołączyć do sieci Matter.MVD Zamiast tego do uruchomienia używa istniejącego połączenia z siecią Wi-Fi na komputerze hosta z systemem Linux lub macOS.

W porównaniu z innymi narzędziami

MVD różni się od Virtual Device Controller (VDC) tym, że stanowi rozwiązanie autonomiczne, łączące urządzenie wirtualne z interfejsem użytkownika umożliwiającym jego sterowanie. Natomiast VDC służy do sterowania osobnym wirtualnym urządzeniem Matter.

MVD zawiera kilka różnych wstępnie skonfigurowanych urządzeń wirtualnych i obejmuje zintegrowany interfejs użytkownika umożliwiający ich uruchamianie i kontrolowanie.

Obsługiwane urządzenia

MVD obsługuje te typy urządzeń:Matter

Instalowanie MVD

MVD działa na 64-bitowych procesorach x86 z systemem Debian (13Trixie lub nowszym), Ubuntu (20.04Noble Numbat lub nowszym) lub macOS.

Linux

Pobierz pakiet MVD Debian (.deb)

Pobierz plik podpisu w formacie armored-ASCII (.asc)

Następnie uruchom dpkg, aby zainstalować pakiet Debian MVD (.deb):

sudo dpkg -i mvd_1.7.0_amd64.deb

macOS

Pobierz plik dmg MVD (macOS x86)

Pobierz plik dmg MVD (ARM64 M1)

Następnie kliknij dwukrotnie plik dmg, aby otworzyć okno instalacji.

Aby dokończyć instalację, wybierz i przeciągnij ikonę mvd do folderu Applications:

Sprawdź użycie portu

Moduł kontrolera w MVD używa portu TCP 33000 do wykonywania wywołań RPC do urządzenia wirtualnego, więc jeśli ten port jest już używany przez inny proces na Twoim komputerze, pamiętaj o jego zwolnieniu.

Aby sprawdzić, czy jakiś proces używa portu 33000:

sudo fuser -v 33000/tcp

lsof -i:33000

Możesz zabić dowolny proces korzystający z portu TCP 33000 za pomocą jednego polecenia:

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

Uruchom MVD

mvd

cd /Applications
open mvd.app

Skonfiguruj swoje urządzenie

Po uruchomieniu pojawia się ekran główny, na którym możesz skonfigurować urządzenie wirtualne:

• Typ urządzenia: Wybierz typ urządzenia (na przykład światło, przełącznik, czujnik itd.).
• Nazwa urządzenia: nadaj urządzeniu przyjazną dla użytkownika nazwę.
• Dyskryminator: 12-bitowa liczba używana do odróżniania wielu reklam urządzeń, za które można otrzymać prowizję. (Domyślnie: 3840).
• Matter Port: port do Matter uruchamiania i komunikacji w sieciach IP. Matter domyślnie używa portu TCP/UDP 5540, ale możesz skonfigurować urządzenie wirtualne tak, aby korzystało z innego portu, o ile nie jest on używany przez inną usługę.
• Identyfikator dostawcy: Obsługiwany jest tylko identyfikator dostawcy testowego 0xFFF1.
• Identyfikator produktu: obsługiwane są tylko identyfikatory produktów testowych od 0x8000 do 0x801F.

Konfigurowanie zapory sieciowej

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

Uruchom swoje urządzenie

Po skonfigurowaniu urządzenia kliknij Utwórz urządzenie. Po utworzeniu urządzenia pojawi się ekran Kontroler. W zależności od wybranego typu urządzenia możesz zobaczyć co najmniej jedno z tych ustawień:

• Włączanie i wyłączanie: dostępne na większości urządzeń.
• Poziom: np. światło może mieć suwak poziomu do regulacji jasności.
• Kolor: np. w przypadku kolorowego oświetlenia.
• Obecność: czujnik obecności oferuje tę opcję, aby symulować stan zajęty lub niezajęty.

Wszystkie urządzenia wirtualne mają te ustawienia:

• QRCode: wyświetla kod QR użyty do uruchomienia.
• Uruchom ponownie: ponownie uruchamia urządzenie wirtualne. Urządzenie zostanie na chwilę odłączone od sieci.
• Resetuj: przywraca bieżące urządzenie do ustawień fabrycznych i usuwa wszystkie stany, w tym stan konfiguracji, bieżący stan sterowania itp.
• Usuń: usuwa urządzenie i wraca do ekranu Utwórz urządzenie.

Cechy charakterystyczne dla producenta

Cechy specyficzne dla producenta są obsługiwane przez interfejsy Home API na Androida i zapewniają dodatkowe funkcje wykraczające poza standardowe cechy w Matter. Aby przetestować urządzenie z cechą MS, MVD umożliwia interakcję z cechami w sekcji Niestandardowe klastry (patrz obraz powyżej).

Konfigurowanie urządzenia

Urządzenie jest gotowe do prowizji od momentu utworzenia.

Aby uruchomić urządzenie, musisz spełnić kilka wymagań wstępnych:

• Musisz mieć projekt w Google Home Developer Console. Ten projekt musi zawierać integrację Matter, która ma taką samą kombinację identyfikatora dostawcy i produktu (VID/PID) jak ta użyta podczas konfigurowania urządzenia wirtualnego. Więcej informacji znajdziesz w przewodniku po tworzeniu projektów.

• Musisz mieć Google Nest Hub, który obsługuje Matter.

• Musisz mieć telefon z Androidem 8.1 lub nowszym, na którym jest zainstalowana aplikacja GHA.

• Telefon z Androidem musi być połączony z tą samą siecią Wi-Fi co centrala.

• Urządzenie hosta musi być połączone z siecią Wi-Fi.

Aby uruchomić urządzenie za pomocą aplikacji GHA, kliknij QRCode, aby wyświetlić kod QR urządzenia, a następnie postępuj zgodnie z instrukcjami w artykule Parowanie urządzenia Matter, w którym wyjaśniono, jak zarejestrować urządzenie Matter za pomocą aplikacji GHA. Urządzenie można również uruchomić za pomocą Google Home Sample App for Matter.

Zobacz naszeMatter Elementarz nauczyć się jakMatter Prace uruchomieniowe.

Sterowanie urządzeniem

Po uruchomieniu urządzenia wirtualnego możesz nim sterować za pomocą aplikacji Google Home lub Asystenta Google za pomocą poleceń głosowych. Możesz:

• sterować urządzeniem za pomocą GHA lub Assistant, monitorując zmiany stanu na urządzeniu wirtualnym,
• Steruj urządzeniem za pomocą Sample App for Matter, monitorując zmiany stanu na urządzeniu wirtualnym, lub
• Steruj stanem urządzenia za pomocą MVD, a zmiany stanu monitoruj w GHA lub Assistant.

Test z urządzeniem

Do testowania za pomocą Assistant zalecamy używanie symulatora wypowiedzi, takiego jak Google Home Extension for VS Code lub Google Home Plugin for Android Studio.

Wyświetl szczegóły urządzenia

Ekran Szczegóły urządzenia wyświetla szczegółowe informacje o urządzeniu:

• Nazwa: przyjazna nazwa nadana urządzeniu.
• Typ urządzenia: wybrany typ urządzenia.
• Wyróżnik: bieżący wyróżnik urządzenia.
• Identyfikator dostawcy: Aktualny identyfikator dostawcy urządzenia.
• Identyfikator produktu: bieżący identyfikator produktu urządzenia.
• Port RPC: port RPC, za pomocą którego urządzenie komunikuje się z kontrolerami (GUI).
• Matter Port: port używany przez bieżące urządzenie do komunikacji w sieci IP.
• Kod dostępu: kod PIN używany do uruchomienia urządzenia w sieci.
• Folder konfiguracji: Folder, w którym urządzenie wirtualne przechowuje konfigurację.
• Informacje o prowizji: wyświetla strukturę, do której dołączyło urządzenie, oraz identyfikator węzła urządzenia w tej strukturze.

Wyświetlanie logów urządzenia

Jeśli uruchomisz MVD z terminala, dane wyjściowe logu pojawią się w stdout. Dzienniki urządzeń można również przeglądać na karcie Dzienniki urządzeń.

Zatrzymaj urządzenie

Aby zatrzymać i zniszczyć urządzenie, kliknij Usuń.

Zakończ aplikację

Zamknięcie okna sterowania powoduje zniszczenie urządzenia i zakończenie działania aplikacjiMVD. Jeśli uruchomiłeś aplikację z terminala, możesz ją również zamknąć, wpisując w terminalu kombinację klawiszy Ctrl-C.

Pomoc

Aby uzyskać pomoc dotyczącą MVD, zgłosić błąd lub poprosić o nową funkcję, skontaktuj się z osobą z zespołu pomocy Google.

Po kliknięciu przycisku pomocy help w prawym górnym rogu okna zostaniesz przeniesiony na tę stronę.

Zgłoś błąd

Jeśli uważasz, że w MVD występuje błąd, możesz go zgłosić, klikając przycisk Problem sms_failed w prawym górnym rogu okna.

Prześlij opinię

Aby podzielić się z nami swoją opinią o MVD lub o tym, jak możemy ulepszyć to narzędzie, wypełnij formularz opinii.

Formularz możesz otworzyć, klikając przycisk opinii sentiment_satisfied w prawym górnym rogu okna lub klikając przycisk poniżej.

Prześlij nam swoją opinię

Możesz również przesłać opinię za pomocą ankiety, która pojawia się na dole ekranu podczas korzystania z MVD.