Urządzenie wirtualne

Pakiet SDK urządzenia

Urządzenia wirtualne Matter przydają się do programowania i testowania Matter i można je uruchomić za pomocą Google Home app (GHA) i kontrolowany za pomocą GHA i Google Assistant, tak samo jak w wersji fizycznej Matter urządzenia.

Dla deweloperów aplikacji i innych osób, które chcą testować lub emulować wirtualną Matter urządzenie, ale nie ma zasobów, aby stworzyć własne fizyczne lub urządzenie wirtualne Matter, Google oferuje Matter Virtual Device (MVD). MVD to lekkie, niezależne narzędzie komputerowe z systemem Linux lub macOS, które symuluje różne typu „wirtualny Matter” i udostępnia do sterowania i wyświetlania stanów wirtualnych Matter na urządzeniu.

W odróżnieniu od fizycznego urządzenia Matter MVD nie korzysta z Bluetooth® Low Energy (BLE) ani Thread® aby połączyć tkaninę Matter. Zamiast tego używa hosta Istniejące połączenie sieciowe Wi-Fi na potrzeby uruchomienia komputera z systemem Linux lub macOS.

W porównaniu z innymi narzędziami

MVD różni się od Virtual Device Controller (VDC) w tym to samodzielne rozwiązanie, które łączy urządzenie wirtualne z interfejsem i ją kontrolować. Natomiast VDC służy do sterowania osobnym wirtualnym urządzeniem Matter, takim jak to, które tworzymy w Matter Virtual Device Development Environment (MVD-DE).

Być może masz już doświadczenie w ćwiczeniu z programowania MVD-DE. W tym w Codelabs, tworzysz jeden rodzaj urządzenia wirtualnego – inteligentną żarówkę. W MVD zawiera kilka gotowych komponentów urządzeń wirtualnych oraz zintegrowany interfejs do ich uruchamiania i sterowania.

Obsługiwane urządzenia

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

Zainstaluj MVD

MVD działa na komputerach z 64-bitowym procesorem x86 i systemem Debian (wersja 11 lub nowsza), Ubuntu (20.04 lub nowszy) lub macOS.

Linux

Pobierz pakiet MVD Debian (.deb)

Pobierz plik z panoramicznym podpisem ASCII (.asc)

Następnie uruchom polecenie dpkg, aby zainstalować: MVD Pakiet Debiana (.deb):

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

Pobierz plik dmg MVD (macOS x86)

Pobierz plik dmg MVD (ARM64 M1)

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

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

Sprawdź wykorzystanie portów

Moduł kontrolera w MVD używa portu TCP 33000 do wykonywania RPC do urządzenia wirtualnego, więc jeśli ten port jest już używany przez inne na komputerze, zwolnij go.

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

sudo fuser -v 33000/tcp

lsof -i:33000

Możesz zamknąć dowolny proces, używając portu TCP 33000 jednym poleceniem:

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

Uruchom MVD

mvd

cd /Applications
open mvd.app

Skonfiguruj urządzenie

Po uruchomieniu pojawi się ekran główny, który umożliwia skonfigurowanie urządzenia wirtualnego:

• Typ urządzenia: wybierz typ urządzenia (np. Światło, Przełącznik, Czujnik). i tak dalej).
• Nazwa urządzenia: nadaj urządzeniu przyjazną dla użytkownika nazwę.
• Diskryminator: 12-bitowa liczba używana do rozróżniania wielu elementów. reklam urządzeń objętych prowizją. (Domyślnie: 3840).
• Matter Port: port dla: Matter i komunikacji w ramach sieci IP. Matter domyślnie używa portu TCP/UDP 5540, ale możesz skonfigurować urządzenie wirtualne, aby o ile nie korzysta z niego żadna inna usługa.
• Identyfikator dostawcy: obsługiwany jest tylko testowy identyfikator dostawcy 0xFFF1.
• Identyfikator produktu: testuj tylko identyfikatory produktów od 0x8000 do 0x801F są obsługiwane.

Konfigurowanie zapory sieciowej

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

Uruchamianie urządzenia

Po skonfigurowaniu urządzenia kliknij Utwórz urządzenie. Gdy urządzenie jest zostanie wyświetlony ekran Kontroler. W zależności od typu urządzenia możesz zobaczyć następujące elementy sterujące:

• Wł./Wył.: typowe dla większości urządzeń.
• Poziom: na przykład światło może mieć suwak poziomu jasność.
• Kolor: ta opcja może być używana na przykład w przypadku światła kolorowego.
• Obecność: to ustawienie zapewnia Czujnik obecności, aby symulować stan okupowany lub pusty.

Wszystkie urządzenia wirtualne mają te elementy sterujące:

• QRCode: pokazuje kod QR używany do uruchomienia.
• Ponowne uruchamianie: uruchamia ponownie urządzenie wirtualne. Urządzenie jest odłączone od połączenia z siecią.
• Resetuj: resetuje bieżące urządzenie do ustawień fabrycznych i usuwa cały stan, w tym uruchomienia, bieżący stan kontroli itd.
• Usuń: niszczy urządzenie i wraca do ekranu Utwórz urządzenie.

Przekaż urządzenie

Można uruchomić prowizję od razu po utworzeniu urządzenia.

Aby urządzenie mogło zostać udostępnione do użytku, musi spełniać kilka warunków:

• Musisz mieć projekt w regionie Google Home Developer Console. Ten projekt musi zawierają integrację z funkcją Matter o tym samym identyfikatorze VID/PID jak ta użyta do skonfigurowania urządzenia wirtualnego. Szczegółowe informacje znajdziesz w przewodniku tworzenia projektu.

• Musisz mieć urządzenie Google Nest Hub obsługujące standard Matter

• Musisz mieć telefon z Androidem 8.1 lub nowszym z zainstalowaną aplikacją GHA.

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

• Komputer hosta musi być połączony z siecią Wi-Fi.

Aby uruchomić urządzenie za pomocą GHA, kliknij QRCode. wyświetl kod QR urządzenia, a następnie postępuj zgodnie z instrukcjami podanymi na stronie Sparuj Matter urządzenia, wyjaśniamy, jak zarejestrować urządzenie Matter za pomocą GHA Możesz też uruchomić urządzenie za pomocą Google Home Sample App for Matter

Zobacz Matter Primer – dowiedz się, jak działa prowizje w usłudze Matter.

Steruj urządzeniem

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

• Steruj urządzeniem za pomocą aplikacji GHA lub Assistant przy zmianie stanu monitorowania urządzenia wirtualnego,
• Steruj urządzeniem za pomocą Sample App for Matter podczas monitorowania stanu zmian na urządzeniu wirtualnym
• Kontroluj stan urządzenia za pomocą aplikacji MVD podczas monitorowania zmian stanu w GHA lub Assistant

Testowanie na urządzeniu

Aby przetestować funkcję Assistant, zalecamy użycie wypowiedzi symulatora, takiego jak Rozszerzenie strony głównej Google dla VS Code lub wtyczka Google Home do Android Studio.

Wyświetlanie szczegółów urządzenia

Na ekranie Szczegóły urządzenia są wyświetlane szczegółowe informacje o urządzeniu:

• Nazwa:przyjazna nazwa nadana urządzeniu.
• Typ urządzenia: wybrany typ urządzenia.
• Diskryminator: obecny dyskryminator urządzenia.
• Identyfikator dostawcy: obecny identyfikator dostawcy urządzenia.
• Identyfikator produktu: obecny identyfikator produktu urządzenia.
• Port RPC: port RPC, przez który urządzenie komunikuje się z kontrolerami (GUI).
• Matter Port: port używany przez bieżące urządzenie do komunikują się przez sieć IP.
• Kod dostępu: kod PIN używany do zlecenia urządzenia w sieci.
• Folder konfiguracji: folder, w którym urządzenie wirtualne przechowuje konfigurację.
• Informacje o prowizji: pokazuje tkaniny, z których korzystało urządzenie, oraz identyfikator węzła urządzenia w sieci szkieletowej.

Wyświetlanie logów urządzenia

Jeśli MVD została uruchomiona z poziomu terminala, dane wyjściowe dziennika pojawią się na stdout. Dzienniki urządzenia możesz też wyświetlać na karcie Dzienniki urządzenia.

Zatrzymaj urządzenie

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

Zamknij aplikację

Zamknięcie okna sterującego powoduje zniszczenie urządzenia i zakończenie MVD aplikacja. Jeśli terminal został uruchomiony z poziomu terminala, możesz zamknij też aplikację, naciskając Ctrl+C w terminalu.

Pomoc

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

Kliknij przycisk pomocy help w kliknij tę stronę w prawym górnym rogu okna.

Zgłoś błąd

Jeśli uważasz, że znaleziono defekt w pliku MVD, zgłoś błąd, klikając Problem sms_failed. znajdujący się w prawym górnym rogu okna.

Prześlij opinię

Napisz, co Ci się podoba w aplikacji MVD lub jak to jest możemy pomóc zwiększyć wygodę korzystania z narzędzia, wypełnij formularz opinii.

Formularz można uruchomić z poziomu opinii Przycisk sentiment_satisfied w w prawym górnym rogu okna lub klikając przycisk poniżej.

Prześlij nam swoją opinię