Sparuj urządzenie z Matter. Aby to zrobić, potrzebujesz kodu QR do parowania. W zależności od platformy urządzeniaMatter może być konieczne samodzielne wygenerowanie tego kodu QR.
Uzyskiwanie kodu QR
Bouffalo Lab
BL602
Ciąg znaków kodu QR jest drukowany w konsoli szeregowej podczas uruchamiania urządzenia. Sprawdź konsolę szeregową. Powinny się w niej pojawić komunikaty podobne do tych:
Booting BL602 Chip... ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╔══██╗██║ ██╔════╝ ██╔═████╗╚════██╗ ██████╔╝██║ ███████╗ ██║██╔██║ █████╔╝ ██╔══██╗██║ ██╔═══██╗████╔╝██║██╔═══╝ ██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚══════╝ ... [INFO] ================================================== [INFO] chip-bl602-lighting-example starting [INFO] ================================================== ... [INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234] [INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code: [INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234 ...
Otwórz link w przeglądarce, aby wyświetlić kod QR.
BL702
Ciąg znaków kodu QR jest drukowany w konsoli szeregowej podczas uruchamiania urządzenia. Sprawdź konsolę szeregową. Powinny się w niej pojawić komunikaty podobne do tego:
[ 0][-][PROGR] ==================================================
[ 0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[ 0][-][PROGR] ==================================================
...
[ 1636][-][PROGR] Starting OpenThread task
[ 1655][DL][PROGR] Device Configuration:
[ 1703][DL][PROGR] Serial Number: TEST_SN
[ 1703][DL][PROGR] Vendor Id: 65521 (0xFFF1)
[ 1703][DL][PROGR] Product Id: 32773 (0x8005)
[ 1752][DL][PROGR] Hardware Version: 0
[ 1799][DL][PROGR] Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[ 1846][DL][PROGR] Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[ 1893][DL][PROGR] Manufacturing Date: (not set)
[ 1893][DL][PROGR] Device Type: 65535 (0xFFFF)
[ 1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[ 1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[ 1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
Espressif
Getting the QR code differs for each type of ESP32-based kit:
ESP32 DevkitC
- Connect the device to a host machine and use a serial
terminal to connect to it and display its logs. For example, on a
Linux host machine, you might use
screen /dev/ttyUSB0 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - A URL is displayed in the logs when the device is first booted.
Open the link in a web browser to display the QR code.
M5Stack ESP32
When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.
ESP32 WROVER Kit
The device shows the QR code immediately after booting.
Nordic Semiconductor
nRF52840
Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:
I: 1317 [SVR]SetupQRCode: [MT:I347HHY00 0C9SS0] I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code: I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0
Otwórz link w przeglądarce, aby wyświetlić kod QR.
NXP
K32W
Ciąg znaków kodu QR jest drukowany w konsoli szeregowej podczas uruchamiania urządzenia. Sprawdź konsolę szeregową. Powinny się w niej pojawić komunikaty podobne do tych:
[Info]Welcome to NXP Lighting Demo App [Info]OpenThread started: OK ... [Info]Server Listening... [Info]SetupQRCode: [MT:I34DVDY00 0C9SS0] [Info]Copy/paste the below URL in a browser to see the QR Code: [Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0 ...
Otwórz link w przeglądarce, aby wyświetlić kod QR.
Realtek
Ameba D
Kod QR jest zakodowany w adresie URL, który jest drukowany w konsoli szeregowej podczas uruchamiania płyty Ameba D:
Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code: 749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:
Otwórz link w przeglądarce, aby wyświetlić kod QR.
Silicon Labs
EFR32MG12
Po uruchomieniu płytki na małym wyświetlaczu LCD powinien pojawić się kod QR.
Telink
TLSR9518
Ciąg znaków kodu QR jest drukowany w konsoli szeregowej podczas uruchamiania urządzenia. Sprawdź konsolę szeregową. Powinien się w niej wyświetlać adres URL, który po otwarciu w przeglądarce pokaże kod QR:
*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626 *** I: Init CHIP stack I: Starting CHIP task … I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData I: 823 [DL]Setting device name to : "TelinkMatter" … I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234] I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code: I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234
Parowanie urządzenia
Urządzenie możesz sparować na 2 sposoby:
- Google Home app (GHA)
- Pakiety SDK Google Home Mobile i Thread NetworkAndroid (których można używać w aplikacji innej firmy)
Obie metody korzystają z tych samych interfejsów API sieci Matter i Thread.
Aplikacja Google Home
- Otwórz GHA.
- W lewym górnym rogu kliknij .
- Kliknij Skonfiguruj urządzenie.
- Kliknij Nowe urządzenie.
- Wybierz dom i kliknij Dalej.
- GHA przeskanuje urządzenie. Gdy pojawi się pytanie, czy chcesz skonfigurować urządzenie, kliknij Skonfiguruj inne urządzenie.
- Kliknij Matter urządzenie w przypadku dowolnego typu urządzenia. .
- Skieruj aparat na kod QR urządzenia (lub kod QR wygenerowany przez witrynę).
- Kontynuuj proces parowania zgodnie z instrukcjami w GHA procesie.
Jeśli podczas parowania z GHA na urządzeniu mobilnym wystąpią problemy:
- Upewnij się, że na urządzeniu mobilnym masz włączone opcje programisty.
- Natychmiast po nieudanej próbie parowania zapisz raport o błędzie.
Pakiety SDK na Androida
Android Pakiety SDK zostały udostępnione w Play services do testowania i parowania w aplikacji innej firmy.
Zacznij od Google Home Sample App for Matter, który pokazuje, jak zlecać, parować i kontrolować urządzenie z Matter w ekosystemie Google Home za pomocą tych pakietów SDK.
Dokumentacja referencyjna obu pakietów SDK jest dostępna w tej witrynie:
Ograniczenia parowania
Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych scenariuszach identyfikatora dostawcy i typu urządzenia.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenckim.
- Identyfikator VID wersji produkcyjnej musi być wydany przez Connectivity Standards Alliance (Alliance). Zanim będzie można użyć identyfikatora VID w Google Home Developer Console, Google zweryfikuje, czy jesteś jego właścicielem. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji dla tego identyfikatora VID.
- Na potrzeby programowania i Field Trial należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który uruchamia urządzenie, musi być członkiem projektu lub znajdować się na liście Field Trial użytkowników.
- Użytkownicy mogą korzystać z Twojego produktu dopiero po uzyskaniu przez niego certyfikatu Alliance.
Identyfikator VID i PID można wykorzystać tylko raz w przypadku jednej integracji. Jeśli chcesz użyć w integracji tego samego identyfikatora dostawcy lub produktu, musisz:
- Edytuj integrację za pomocą identyfikatora dostawcy lub produktu, aby zmienić go na inny.
- Usuń integrację za pomocą identyfikatora dostawcy lub produktu.
| Którzy użytkownicy mogą włączyć urządzenie do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikacji VID i integracji z konsolą | Wersja produkcyjna
(klienci indywidualni) |
Tworzenie
(Deweloperzy, Field Trial użytkowników) |
| Test | Brak integracji w Developer Console (nie można uzyskać certyfikatu) | ||
| Test | Integracja istnieje w Developer Console (nie można jej certyfikować) | ||
| Produkcja | Brak certyfikatu, integracja nie istnieje w Developer Console | ||
| Produkcja | Brak certyfikatu, integracja istnieje w Developer Console | ||
| Produkcja | Certyfikat w Alliance DCL, integracja nie istnieje w Developer Console | ||
| Produkcja | Certyfikat w zakresie Alliance DCL i integracja w Developer Console | ||
Informacje o urządzeniu
Informacje techniczne o sparowanym urządzeniu możesz wyświetlić w GHA.
- W GHA wybierz urządzenie.
- W prawym górnym rogu kliknij ikonę .
- Kliknij Informacje techniczne.
Identyfikatory takie jak Producent, Model i Wersja sprzętu pochodzą z Matter oprogramowania urządzenia, a nie z Developer Console. Na przykład wartości CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME i CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME w konfiguracji urządzenia w pakiecie SDK Matter.
Identyfikatory te mogą być przydatne do weryfikowania, które urządzenie zostało sparowane na potrzeby testu, zwłaszcza w przypadku używania testowego identyfikatora dostawcy i identyfikatora produktu (które mogą być powielane w różnych integracjach).
Rozwiązywanie problemów z parowaniem
Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się podczas próby testowania urządzenia za pomocą pakietu testowego w Developer Console, prawdopodobnie jest to spowodowane używaniem tej samej kombinacji testowych identyfikatorów VID i PID w wielu integracjach.
Aby rozwiązać problem, usuń wszystkie urządzenia testowe z usługi Developer Console i ponownie sparuj urządzenie, które chcesz przetestować.
Aby sprawdzić, czy urządzenie zostało prawidłowo sparowane, możesz ustawić informacje o producencie i modelu (CHIP_DEVICE_CONFIG_DEVICE_* wartości) urządzenia na unikalne wartości w oprogramowaniu testowym.
Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.