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.
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ń:
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
:
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
do0x801F
są obsługiwane.
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:
- Otwórz menu Apple i wybierz System Settings (Ustawienia systemu).
- Kliknij Sieć na liście na pasku bocznym.
- Kliknij Zapora sieciowa.
- 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.
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.