OTA'yı Nordic'te test et

Aşağıdaki talimatlarda, Nordic nRF52840 geliştirme kartıyla birlikte Matter SDK'sındaki aydınlatma uygulaması örneği kullanılmaktadır.

Ortam Kurulumu

Bu talimatlar, nRF Connect araç zincirinin Docker tabanlı kurulumunu temel alır. Docker'ı kullanmak istemiyorsanız nRF Connect'i ana makineye yerel olarak yükleme talimatlarını Nordic sitesinde bulabilirsiniz.

Matter SDK'sını inceleyin

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

Kullanılacak doğru Docker görüntüsünü kontrol edin. Matter SDK sürekli entegrasyonu için oluşturulan resimlerden birini kullanın.

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

Nordic kartını bilgisayara bağlayın. Seri arayüzünün USB numaralandırmasını kontrol edin:

macOS'te:

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

Linux'ta:

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

veya

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

Önceki komutta toplanan bilgileri kullanarak bir kapsayıcı çalıştırın. Ana makine Matter SDK klasörünü ve USB seri arayüzünü kapsayıcıya bağlamak için işaretleri iletin.

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

Matter Docker container'ını durdurma ve başlatma

docker run komutunu her çalıştırdığınızda, belirtilen görüntüyle yeni bir kapsayıcı oluşturursunuz. Bunu yaptığınızda, önceki bir kapsayıcı örneğine kaydedilen eski verileriniz kaybolur. Bazen yeni bir yüklemeyle başlamanıza olanak tanıdığı için bunun olmasını istersiniz. Ancak bu örnekte, oturumlar arasında çalışmanızı ve ortam yapılandırmanızı kaydetmek isteyebilirsiniz.

user@host> docker stop container_name

Tekrar çalıştırmaya hazır olduğunuzda container'ı başlatın ve bir terminal penceresi açın:

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

Aşağıdaki komutu kullanarak kapsayıcınızda ek terminal oturumları açabilirsiniz:

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

Alternatif olarak, aşağıdakileri kullanarak bir kök oturumu başlatabilirsiniz:

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

SDK'yı ilk kullanıma hazırlama

Kapsayıcıda, Matter SDK'sını ve Nordic nRF52 araç zinciri için ortam değişkenlerini ilk kullanıma hazırlayın. Matter SDK'sının başlatılması genellikle birkaç dakika sürer.

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

Derleme ve Flash

Cihazın VID ve PID'sini yapılandırın:

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

Etkileşimli menü seçeneklerinde:

  1. Modules --->

  2. connectedhomeip --->

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

  4. Device vendor ID (VID) ve Device product ID (PID) değerlerini 10 tabanlı tam sayı biçiminde girin.

  5. [*] Enable OTA requestor işaretinin seçili olduğundan emin olun.

  6. Yapılandırmayı kaydetmek için s tuşuna, onaylamak için Enter tuşuna, ardından menuconfig aracından çıkmak için q tuşuna basın.

Test sertifikaları oluşturma

CD, DAC ve PAI sertifikaları oluşturmak için Matter cihaz test sertifikaları oluşturma başlıklı makaledeki adımları uygulayın.

Cihazınızı oluşturma

west build -b nrf52840dk_nrf52840

Cihazınıza sistem görüntüsü yükleme

Bu işlem, Docker container'ında değil ana makinede yapılır.

nRFConnect komut satırı araçlarınız yoksa bunları indirip yükleyin.

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

Ana makinede veya container'da cihazınızla terminal bağlantısı açın. minicom veya GNU screen gibi tercih ettiğiniz terminal aracını kullanın.

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

OTA resmi oluşturma ve yükleme

Cihazınıza yükleme yaptıktan sonra, artırılmış cihaz yazılımı sürümüne sahip bir OTA görüntüsü oluşturmak için derleme ayarlarını bir kez daha değiştirin.

Zephyr menuconfig'ı başlatın:

west build -b nrf52840dk_nrf52840 -t menuconfig

Etkileşimli menü seçeneklerinde:

  1. Modules -->

  2. connectedhomeip -->

  3. Connected Home over IP protocol stack -->

  4. Device Software Version kelimesini 2 olarak değiştir.

  5. Device Software Version String kelimesini prerelease-2 olarak değiştir.

  6. Yapılandırmayı kaydetmek için s tuşuna, onaylamak için Enter tuşuna, ardından menuconfig aracından çıkmak için q tuşuna basın.

Yeni Matter OTA paketi dosyasını oluşturun. Çıkış, build/zephyr/zephyr.bin içine yerleştirilir.

/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

Oluşturulan Matter OTA paketi dosyanızın özelliklerini onaylayın:

/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

Matter SDK'sı, kapsayıcı ana makinenizden bağlandığı için OTA resmi, kapsayıcı ana makinenizde de kullanılabilir. OTA yükleme talimatlarını uygulayarak OTA resmini Google Home Developer Console cihazına yükleyin.

Cihazı devreye alın ve OTA sürecini gözlemleyin.

Ana makinede veya container'da cihazla terminal bağlantısı açın. minicom veya GNU screen gibi sık kullandığınız bir terminali kullanın:

minicom -c on -D /dev/ttyACM0 115200

Başlatma günlüklerini görmek için cihazın sıfırlama düğmesine basın.

Cihaz çıkışında, ayarladığınız VID ve PID'nin yanı sıra devreye alma QR kodunun URL'sini görürsünüz:

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

Hub'ınızın internete bağlı olduğundan emin olun ve günlükte bulunan bağlantıdaki QR kodunu kullanarak cihazı Google Home app (GHA) ile yetkilendirin.

Devreye alma işleminden sonra cihazın etkinliklerini günlüğe kaydetmeye devam etmesini sağlayın.

Cihaz günlüğünde aşağıdaki metni görmeniz gerekir:

/* 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

Resim uygulandıktan sonra cihaz yeniden başlatılır. Yeniden başlatmanın ardından, görüntünün derleme süresi Developer Console adresine yüklenen görüntünün derleme süresiyle eşleşmelidir.

OTA yazılım güncellemesini doğrulama

Cihaz yazılım sürümü, Google Home uygulaması (GHA) kullanılarak kontrol edilebilir. Cihaz yetkilendirildikten sonra aşağıdaki prosedürleri uygulayın:

  1. GHA ana ekranındaki cihaz simgesine uzun basın.
  2. Sağ üstteki simgesine dokunun.
  3. Teknik bilgiler'e dokunun.
  4. Yazılım sürümü alanını kontrol edin.

Yazılım sürümü alanını gösteren Google Home uygulaması ekranı