En las siguientes instrucciones, se usa el ejemplo de la app de iluminación del SDK de Matter, junto con la placa de desarrollo nRF52840 nórdica.
Configuración del entorno
Estas instrucciones se basan en una instalación basada en Docker de la cadena de herramientas nRF Connect. Si prefieres no usar Docker, las instrucciones para instalar nRF Connect de forma nativa en una computadora host se encuentran en el sitio nórdico.
Consulta el SDK de 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
Verifica la imagen de Docker correcta que se usará. Usa una de las imágenes creadas para la integración continua del SDK de Matter.
user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
image: connectedhomeip/chip-build-nrf-platform:0.5.99
Conecta la placa nórdica a la computadora. Verifica la enumeración USB de su interfaz en serie:
En macOS:
user@host> ls /dev/tty.usbmodem*
/dev/tty.usbmodem0123456789000
En Linux:
user@host> ls /dev/tty*AC*
/dev/ttyACM0
o
user@host> ls /dev/tty*USB*
/dev/ttyUSB0
Ejecute un contenedor con la información recopilada en el comando anterior. Pasa las marcas para activar la carpeta del SDK Matter del host y la interfaz serial USB en el contenedor.
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
Inicia y detén el contenedor de Docker de Matter
Cada vez que ejecutes un comando docker run
, crearás un contenedor nuevo con la imagen especificada. Cuando lo haces, se pierden los datos anteriores, que se guardaron en una instancia anterior del contenedor. A veces, esto es lo que deseas hacer, porque te permite comenzar con una instalación nueva. Sin embargo, en este ejemplo, es probable que quieras guardar la configuración de tu trabajo y del entorno entre sesiones.
user@host> docker stop container_name
Cuando quieras volver a ejecutar, inicia el contenedor y abre una ventana de la terminal:
user@host> docker start container_name
user@host> docker exec -it container_name /bin/bash
Puedes abrir sesiones de terminal adicionales en tu contenedor con las siguientes opciones:
user@host> docker exec -it container_name /bin/bash
También puedes iniciar una sesión raíz con el siguiente comando:
user@host> docker exec -u 0 -it container_name /bin/bash
Inicializa el SDK
En el contenedor, inicializa el SDK de Matter y las variables de entorno para la cadena de herramientas nRF52 nórdica. La inicialización del SDK de Matter suele tardar varios minutos.
$ 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
Compilación y escritura en la memoria flash
Configura el VID y el PID del dispositivo:
$ cd examples/lighting-app/nrfconnect
$ west build -b nrf52840dk_nrf52840 -t menuconfig
En las opciones del menú interactivo:
Modules --->
connectedhomeip --->
[*] Connected Home over IP protocol stack --->
Ingresa el
Device vendor ID
(VID) yDevice product ID
(PID) en formato de número entero de base 10.Asegúrate de que la marca
[*] Enable OTA requestor
esté seleccionada.Presiona s para guardar la configuración, presiona Intro para confirmar y, luego, q para salir de
menuconfig
.
Configura certificados de prueba
Sigue los pasos que se indican en Crea certificados de prueba de dispositivos para crear certificados de CD, DAC y PAI.
Crea tu dispositivo
$ west build -b nrf52840dk_nrf52840
Escribe en la memoria flash del dispositivo
Esto se hace en la computadora host, no en el contenedor de Docker.
Si aún no tienes las herramientas de línea de comandos de nRFConnect, descárgalas y instálalas.
user@host> nrfjprog --program build/zephyr/merged.hex --chiperase -f NRF52
Abre una conexión de terminal en tu dispositivo, ya sea en el host o en el contenedor. Usa tu herramienta de terminal favorita, como minicom
o screen
de GNU.
user@host> minicom -c on -D /dev/ttyACM0 115200
user@host> screen /dev/ttyACM0 115200
Crea y sube una imagen inalámbrica
Una vez que lo hayas instalado, vuelve a cambiar la configuración de compilación para crear una imagen inalámbrica con una versión de software del dispositivo incremental.
Inicia Zephyr menuconfig
:
$ west build -b nrf52840dk_nrf52840 -t menuconfig
En las opciones del menú interactivo:
Modules -->
connectedhomeip -->
Connected Home over IP protocol stack -->
Cambia
Device Software Version
por2
.Cambia
Device Software Version String
porprerelease-2
.Presiona s para guardar la configuración, presiona Intro para confirmar y, luego, q para salir de
menuconfig
.
Compila el nuevo archivo de paquete inalámbrico de Matter. El resultado se coloca en 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
Confirma las propiedades del archivo de paquete inalámbrico Matter generado:
/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
Debido a que el SDK de Matter se activa desde el host del contenedor, la imagen inalámbrica también está disponible en el host del contenedor. Para subir la imagen inalámbrica a Google Home Developer Console, sigue las instrucciones de carga inalámbrica.
Ponga en marcha el dispositivo y observe el proceso inalámbrico.
Abre una conexión de terminal en el dispositivo, ya sea en el host o el contenedor. Usa tu terminal favorita, como minicom
o GNU screen
:
$ minicom -c on -D /dev/ttyACM0 115200
Presiona el botón de restablecimiento del dispositivo para ver los registros del inicio.
En el resultado del dispositivo, deberías ver el VID y el PID que configuraste, así como la URL para el código QR de comisión:
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
Asegúrate de que tu Hub esté en línea y encarga el dispositivo con el Google Home app (GHA) mediante el código QR del vínculo que se encuentra en el registro.
Deja que el dispositivo registre sus actividades después de la puesta en marcha.
Deberías ver el siguiente texto en el registro del dispositivo:
/* 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 vez que se aplique la imagen, se reiniciará el dispositivo. Después del reinicio, el tiempo de compilación de la imagen debe coincidir con el que se subió a Developer Console.
Valida la actualización del software inalámbrica
Puedes consultar la versión de software del dispositivo con la app de Google Home (GHA). Una vez que se seleccione un dispositivo, sigue estos procedimientos:
- Mantén presionada la tarjeta del dispositivo en la pantalla principal de GHA
- Presiona el ícono en la parte superior derecha
- Presiona Información técnica.
- Verifica el campo Versión de software.