Urządzenie wirtualne

Sprawa 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ć. VDC jest natomiast używany do: sterować osobnym urządzeniem wirtualnym 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.

Tabela: porównanie narzędzia wirtualnego Matter
MVD VDC MVD-DE (ćwiczenie z programowania)
Emuluj urządzenie ze standardem Matter
Sterowanie emulowanym urządzeniem Matter
Wymagane nakłady pracy programistyczne
Pobierz mniej niż 100 MB 9 GB 20 GB

Obsługiwane urządzenia

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

Tabela: Matter urządzenie typy obsługiwane w przypadku MVD
Matter typ urządzenia Klastry aplikacji Typ ekosystemu domowego
Podstawowy odtwarzacz wideo 0x0006
0x0506
0x0509
Telewizor
Temperatura kolorów (jasny) 0x0300
0x0008
0x0006
Jasny
Czujnik kontaktu 0x0045
Czujnik
Przyciemnianie światła 0x0008
0x0006
Jasny
Zamek do drzwi 0x0101
Zablokuj
Rozszerzony jasny kolor 0x0300
0x0008
0x0006
Jasny
Wentylator 0x0202
0x0006
Fan
Czujnik przepływu 0x0404
Czujnik
Standardowy przełącznik 0x003b
Przełącz
Czujnik wilgotności 0x0405
Czujnik
Czujnik światła 0x0400
Czujnik
Czujnik obecności 0x0406
Czujnik
Włącz/wyłącz światło 0x0008
0x0006
Jasny
Przełącznik światła 0x0006
Przełącz
Jednostka wtyczki do włączania i wyłączania 0x0008
0x0006
Gniazdko
Czujnik ciśnienia 0x0403
Czujnik
Pompa 0x0006
0x0200
0x0402
0x0403
0x0404
Nie dotyczy
Odkurzacz automatyczny 0x0054
0x0055
0x0061
Odkurzanie
Klimatyzacja do pomieszczeń 0x0006
0x0201
0x0202
Ac
Czujnik dymu tlenku węgla 0x005C
Dyń
Czujnik dymu tlenku węgla 0x005C
Dyń
Czujnik temperatury 0x0402
Czujnik
Termostat 0x0201
Termostat
Osłony okien 0x0102
Żaluzje

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:

Instalacja systemu macOS

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:

Linux

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

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

Linux

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

Uruchom MVD

Linux

W systemie Linux uruchom aplikację MVD z poziomu folderu aplikacji lub terminal:

mvd

macOS

W systemie macOS otwórz MVD lub uruchom za pomocą Launchpada MVD z terminala:

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.

Konfiguracja urządzenia wirtualnego
Ekran

Konfigurowanie zapory sieciowej

Linux

Jeśli na komputerze działa zapora sieciowa, wyłącz ją lub zezwól na przychodzące połączenia TCP/UDP na porcie Matter.

Aby wyświetlić bieżący aktywny filtr netfilter reguły zapory sieciowej, uruchom:

sudo iptables -L -n

Jeśli używasz parametru „ufw”, możesz go wyłączyć za pomocą tych metod:

sudo ufw disable

Można ją ponownie włączyć za pomocą:

sudo ufw enable

macOS

Aby skonfigurować lub wyłączyć zaporę sieciową w systemie macOS:

  1. Otwórz menu  Apple i wybierz System Settings (Ustawienia systemu).
  2. Kliknij Sieć na liście na pasku bocznym.
  3. Kliknij Zapora sieciowa.
  4. Przesuń przełącznik Zapora sieciowa na Wył.

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: tę opcję może mieć na przykład kolorowe światło.
  • 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.
  • Restart: powoduje ponowne uruchomienie urządzenia wirtualnego. 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.

Sterowanie urządzeniami wirtualnymi
Ekran

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. Zobacz przewodnik po tworzeniu projektów.

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

  • Musisz mieć telefon z Androidem 8.1 lub nowszym oraz Aplikacja GHA została zainstalowana.

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

  • Host 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 zleceniu 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 przechowywane są urządzenia wirtualne. konfiguracji.
  • Informacje o prowizji: pokazuje tkaniny, z których korzystało urządzenie, oraz identyfikator węzła urządzenia w sieci szkieletowej.

Wyświetl dzienniki urządzenia

Jeśli uruchomisz aplikację MVD z terminala, pojawią się dane wyjściowe dziennika w dniu 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 w kliknij tę stronę w prawym górnym rogu okna.

Zgłoś błąd

Jeśli uważasz, że znaleziono wadę w pliku MVD, możesz zgłoś błąd, klikając Problem . 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 w w prawym górnym rogu okna lub klikając przycisk poniżej.

Prześlij nam swoją opinię