OTA di prova per le campagne nordiche

Le seguenti istruzioni utilizzano il app illuminazione esempio dell'SDK Matter insieme a un ID nRF52840 nordico di sviluppo.

Configurazione dell'ambiente

Queste istruzioni si basano su un'installazione basata su Docker del Connessione nRF la toolchain. Se preferisci non usare Docker, vedi le istruzioni per installare nRF La connessione nativa su un computer host sul sito nordico.

Scopri l'SDK Matter

user@host> mkdir otaprep
user@host> cd otaprep
user@host> git clone https://github.com/project-chip/connectedhomeip.git
user@host> cd connectedhomeip/
user@host> git fetch origin v1.0-branch
user@host> git checkout FETCH_HEAD

Controlla l'immagine Docker corretta da utilizzare. Utilizza una delle immagini create per l'integrazione continua dell'SDK Matter.

user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
            image: connectedhomeip/chip-build-nrf-platform:0.5.99

Collega la tavola nordica al computer. Controlla l'enumerazione USB di la sua interfaccia seriale:

In MacOS:

user@host> ls /dev/tty.usbmodem*
/dev/tty.usbmodem0123456789000

Su Linux:

user@host> ls /dev/tty*AC*
/dev/ttyACM0

o

user@host> ls /dev/tty*USB*
/dev/ttyUSB0

Esegui un container utilizzando le informazioni raccolte con il comando precedente. Superato i flag per montare la cartella SDK Matter dell'host e il token usb un'interfaccia seriale nel container.

user@host> docker run --name container_name -it --user $(id -u):$(id -g) --mount source=$(pwd),target=/workspace,type=bind connectedhomeip/chip-build-nrf-platform:0.5.99 /bin/bash

arresta e avvia il container Docker Matter

Ogni volta che esegui un comando docker run, devi creare un nuovo container con dell'immagine specificata. Quando esegui questa operazione, i dati precedenti, che sono stati salvati su un l'istanza di container precedente viene persa. A volte è opportuno perché ti consente di iniziare con una nuova installazione. Ma in questo Ad esempio, potresti voler salvare la configurazione di lavoro e dell'ambiente tra una sessione e l'altra.

user@host> docker stop container_name

Quando vuoi eseguirlo di nuovo, avvia il container e apri un terminale finestra:

user@host> docker start container_name
user@host> docker exec -it container_name /bin/bash

Puoi aprire altre sessioni del terminale per il tuo container con:

user@host> docker exec -it container_name /bin/bash

Oppure avvia una sessione root utilizzando:

user@host> docker exec -u 0 -it container_name /bin/bash

Inizializzare l'SDK

Nel container, inizializza l'SDK Matter e la variabili di ambiente per la toolchain nRF52 nordica. La Matter L'inizializzazione dell'SDK spesso richiede diversi minuti.

$ cd /workspace
$ git submodule update --init --recursive
$ source ./scripts/bootstrap.sh
$ source ./scripts/activate.sh
$ export ZEPHYR_BASE=/opt/NordicSemiconductor/nrfconnect/zephyr
$ export GNUARMEMB_TOOLCHAIN_PATH="$PW_ARM_CIPD_INSTALL_DIR"
$ scripts/run_in_build_env.sh "python3 scripts/setup/nrfconnect/update_ncs.py --update --shallow"
$ source /opt/NordicSemiconductor/nrfconnect/zephyr/zephyr-env.sh

Creazione e Flash

Configura il VID e il PID per il dispositivo:

$ cd examples/lighting-app/nrfconnect
$ west build -b nrf52840dk_nrf52840 -t menuconfig

Nelle opzioni del menu interattivo:

  1. Modules --->

  2. connectedhomeip --->

  3. [*] Connected Home over IP protocol stack --->

  4. Inserisci Device vendor ID (VID) e Device product ID (PID) in base 10 formato intero.

  5. Assicurati che il flag [*] Enable OTA requestor sia selezionato.

  6. Premi s per salvare la configurazione, premi Invio per confermare, quindi q per uscire da menuconfig.

Configura i certificati di test

Segui i passaggi descritti in Creare certificati di test dei dispositivi Matter per creare certificati CD, DAC e PAI.

Crea il tuo dispositivo

$ west build -b nrf52840dk_nrf52840

Esegui il flashing del dispositivo

Questa operazione viene eseguita sul computer host, non nel container Docker.

Se non disponi già degli strumenti a riga di comando nRFConnect, scarica e installali.

user@host> nrfjprog --program build/zephyr/merged.hex --chiperase -f NRF52

Apri una connessione del terminale al tuo dispositivo sull'host o sulla containerizzato. Usa il tuo strumento Terminale preferito, come minicom o GNU screen.

user@host> minicom -c on -D /dev/ttyACM0 115200

user@host> screen /dev/ttyACM0 115200

Crea e carica immagine OTA

Dopo aver eseguito il flashing del dispositivo, modifica di nuovo le impostazioni di build per creare un'immagine OTA con una versione incrementata del software del dispositivo.

Avvia Zephyr menuconfig:

$ west build -b nrf52840dk_nrf52840 -t menuconfig

Nelle opzioni del menu interattivo:

  1. Modules -->

  2. connectedhomeip -->

  3. Connected Home over IP protocol stack -->

  4. Cambia Device Software Version in 2.

  5. Cambia Device Software Version String in prerelease-2.

  6. Premi s per salvare la configurazione, premi Invio per confermare, quindi q per uscire da menuconfig.

Crea il nuovo file del bundle OTA di Matter. L'output viene posizionato nel seguente paese: build/zephyr/zephyr.bin.

$ /workspace/src/app/ota_image_tool.py create -v hex_VID -p hex_PID -vn version_no -vs version_string path_to_binary -da digest_algorithm path_to_ota_file

Conferma le proprietà del bundle OTA Matter generato file:

/workspace/examples/lighting-app/nrfconnect# /workspace/src/app/ota_image_tool.py show firmware-ota-update-test.bin
Magic: 1beef11e
Total Size: 951784
Header Size: 72
Header TLV:
  [0] Vendor Id: XXXXX (0xXXXX)
  [1] Product Id: 32768 (0x8000)
  [2] Version: 2 (0x2)
  [3] Version String: prerelease-2
  [4] Payload Size: 951696 (0xe8590)
  [8] Digest Type: 1 (0x1)
  [9] Digest: 75f2e8b0c8e922b8bb3841504190bcdd83533e936a284c7254d29327d605c930

Poiché l'SDK Matter viene montato dall'host del container, l'immagine OTA è disponibile anche sull'host del container. Carica l'immagine OTA su Google Home Developer Console seguendo il caricamento OTA istruzioni.

Metti in servizio il dispositivo e osserva la procedura OTA.

Apri una connessione del terminale al dispositivo sull'host o sul containerizzato. Usa il tuo terminale preferito, come minicom o GNU screen:

$ minicom -c on -D /dev/ttyACM0 115200

Premi il pulsante di ripristino del dispositivo per visualizzare i log dall'avvio.

Nell'output del dispositivo, dovresti vedere il VID e il PID che hai impostato, oltre a l'URL del codice QR di messa in servizio:

I: nRF5 802154 radio initialized
I: 4 Sectors of 4096 bytes

(...)

I: 681 [SVR]Server Listening...
I: 684 [DL]Device Configuration:
I: 687 [DL]  Serial Number: 11223344556677889900
I: 692 [DL]  Vendor Id: XXXXX (0xXXXX)
I: 695 [DL]  Product Id: XXXXX (0xXXXX)
I: 699 [DL]  Hardware Version: 0
I: 702 [DL]  Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
I: 708 [DL]  Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
I: 714 [DL]  Manufacturing Date: (not set)
I: 718 [DL]  Device Type: 65535 (0xFFFF)
I: 723 [SVR]SetupQRCode: [MT:6FCJ142C00KA0648G00]
I: 727 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 733 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%000000000000000000000
I: 742 [SVR]Manual pairing code: [30900112302]
I: 747 [DL]CHIP task running
I: 752 [DL]CHIPoBLE advertising started
I: 757 [DL]NFC Tag emulation started

Assicurati che l'hub sia online e metti in servizio il dispositivo con Google Home app (GHA) utilizzando il codice QR del link trovato nel log.

Lascia il dispositivo a registrare le sue attività dopo la messa in servizio.

Nel log del dispositivo dovrebbe essere visualizzato il seguente testo:

/* Hub OTA provider identification */
I: 69642 [SWU]OTA Requestor received AnnounceOTAProvider
D: 69647 [SWU]  FabricIndex: 1
D: 69649 [SWU]  ProviderNodeID: 0x00000000XXXXXXXX
D: 69654 [SWU]  VendorID: 0x6006
D: 69657 [SWU]  AnnouncementReason: 0
D: 69660 [SWU]  Endpoint: 2
...
D: 69799 [SWU]Establishing session to provider node ID 0x00000000FC843D94 on fabric index 1
...
D: 262265 [SWU]QueryImageResponse:
D: 262268 [SWU]  status: 0
D: 262271 [SWU]  imageURI: bdx://00000000FC843D94/37f09fd6-0000-0000-0000-000000000000
D: 262278 [SWU]  softwareVersion: 2
D: 262281 [SWU]  softwareVersionString: 2
D: 262285 [SWU]  updateToken: 36
D: 262288 [SWU]  userConsentNeeded: 0
D: 262292 [SWU]Update available from version 0 to 2
...
D: 262372 [SWU]Establishing session to provider node ID 0x00000000FC843D94 on fabric index 1
...
D: 262409 [SWU]BDX::SendMessage

Una volta applicata l'immagine, il dispositivo si riavvia. Dopo il riavvio, il tempo di compilazione dell'immagine deve corrispondere a quella caricata Developer Console.

Convalidare l'aggiornamento software OTA

La versione software del dispositivo può essere controllata utilizzando l'app Google Home (GHA). Dopo la messa in servizio di un dispositivo, segui queste procedure:

  1. Tieni premuto a lungo il riquadro del dispositivo sulla schermata principale di GHA
  2. Tocca l'icona in alto a destra.
  3. Tocca Informazioni tecniche.
  4. Controlla il campo Versione software

Schermata dell'app Google Home che mostra il campo della versione software