Přeskočit na hlavní obsah

Průvodce migrací na CHESTER SDK v4.0.0

CHESTER SDK v4.0.0 zvyšuje verzi použitého nRF Connect SDK z v2.9 na v3.4 (Zephyr 4.x, Zephyr SDK 1.0.1). Jde o vydání se zpětně nekompatibilními změnami: mění se toolchain Pythonu, Zephyr SDK a u aplikací mimo repozitář SDK také systém sestavení (sysbuild + rozdělení oddílů v DTS).

Vyjděte z workspace ve verzi v3.5.5 (poslední vydání s NCS v2.9). Ověřte, že se projekt sestaví, a teprve pak postupujte podle tohoto průvodce. Nepřecházejte ze starší workspace přímo na v4.0.0.

0. Aktualizace workspace​

Nejprve aktualizujte west.yml, aby ukazoval na CHESTER SDK v4.0.0:

  - name: chester
    remote: hardwario
    repo-path: chester-sdk
    revision: v4.0.0 # <-- Change here
    import: true

Poté aktualizujte workspace a nainstalujte potřebné toolchainy:

# Pull updated CHESTER SDK + all modules
west update

# Update/install required python packages
west packages pip --install -- -U

# Export the Zephyr CMake package
west zephyr-export

# Install the required version of Zephyr SDK
west sdk install -t arm-zephyr-eabi

Smažte případný existující adresář build a sestavte projekt znovu od začátku: sysbuild mění strukturu sestavení, takže inkrementální sestavení nad stromem s NCS v2.9 nefunguje.

Pokud sestavujete jen aplikace dodávané se SDK, máte hotovo. Katalogové aplikace jsou na verzi v4.0.0 už převedené. Zbytek tohoto průvodce se týká správců aplikací mimo repozitář SDK.

1. Migrace na sysbuild + oddíly v DTS​

NCS v3.4 sestavuje pomocí sysbuild a deska CHESTER nyní definuje rozvržení paměti flash v device tree místo nástroje Partition Manager (PM) od Nordicu. PM je pro tuto desku vypnutý, takže se pm_static.yml ani child_image/ už nečtou.

Každou aplikaci mimo repozitář SDK je nutné převést. Všechny katalogové aplikace převedl jediný commit, ze kterého můžete vyjít: ef27da1e applications: Migrate to sysbuild + DTS partitions.

Změny v každé aplikaci:

AkceCestaObsah
Přidatsysbuild.confSB_CONFIG_BOOTLOADER_MCUBOOT=y / SB_CONFIG_MCUBOOT_MODE_SWAP_SCRATCH=y / SB_CONFIG_MERGED_HEX_FILES=y
Přesunoutchild_image/mcuboot.conf → sysbuild/mcuboot.confpřidat CONFIG_BOOT_MAX_IMG_SECTORS_AUTO=n (nové, povinné)
Smazatchild_image/ (celý adresář)včetně child_image/mcuboot/boards/chester_nrf52840.overlay
Smazatpm_static.ymluž se nečte
Upravit app.overlayodstranit napojení PM na externí flashvypustit chosen node nordic,pm-ext-flash a ruční oddíl littlefs_storage na &spi_flash0. Obojí teď definuje DTS desky
Upravit prj.confodstranit Kconfig pro PMCONFIG_PM_OVERRIDE_EXTERNAL_DRIVER_CHECK / CONFIG_PM_PARTITION_REGION_LITTLEFS_EXTERNAL

Výchozí rozvržení v DTS desky (boards/hardwario/chester/chester_nrf52840.dts) odpovídá staré mapě PM, takže běžná aktualizace firmwaru zachová data na existujících zařízeních.

Nestandardní rozvržení: pokud vaše nasazená zařízení používala jinou mapu oddílů, bezdrátová aktualizace (OTA) by oddíly přesunula a uložená data by se ztratila. Starou mapu reprodukujte tím, že v app.overlay znovu definujete uzly oddílů (overlay aplikace má přednost před DTS desky). Vzor najdete v applications/control: oddíl littlefs-storage tam zůstává na původní velikosti 24 KB. Podrobnosti popisuje návod Migrating to sysbuild od Nordicu.

2. Zbývající změny ve zdrojových kódech a Kconfigu​

2a. Odstraňte zastaralý Kconfig (prohledejte celý strom aplikace, ne jen prj.conf)​

NCS 3.0 knihovnu TinyCrypt odstranilo; BLE host teď používá PSA Crypto.

-CONFIG_TINYCRYPT=y
-CONFIG_TINYCRYPT_SHA256=y
-CONFIG_ADC_TLA2021_INIT_PRIORITY=60

U aplikací založených na generátoru odstraňte z project.yaml funkce subsystem-tinycrypt* / řádky extras: a znovu vygenerujte projekt, nebo smažte ony tři řádky z prj.conf ručně (ne obojí). Aplikace, které používají pouze CONFIG_CTR_CLOUD / CONFIG_CTR_BLE, přejdou na PSA automaticky.

2b. Podmíněné změny: jen pokud danou funkci používáte​

Pokud…Změna
ovládáte integrovanou PWM/RGB LED (ctr_led)deska má pwm_leds vypnuté, znovu je zapněte v app.overlay a nastavte zephyr,user { ctr_leds = <&gpio_leds>, <&pwm_leds>; } (viz samples/ctr_led)
vkládáte TinyCrypt v src/*.cnepoužívané #include <tinycrypt/...> → smazat; skutečné hashování → PSA Crypto (<psa/crypto.h>, CONFIG_NRF_SECURITY=y, CONFIG_PSA_WANT_ALG_SHA_256=y)
inicializujete UART/Modbus struct uart_config.stop_bits_client → .stop_bits
používáte světelný senzor OPT3001CONFIG_OPT3001=y → CONFIG_OPT300X=y
máte pevně zapsaný compatible pro TLA2024ti,tla2024 → hardwario,tla2024 (bateriový ti,tla2021 bez změny)
píšete surový BLE / nízkoúrovňový kódBT_LE_ADV_OPT_CONNECTABLE→BT_LE_ADV_OPT_CONN; vypustit USE_NAME/FORCE_NAME_IN_AD (přidat BT_DATA_NAME_COMPLETE); odstraněno: CONFIG_BT_FIXED_PASSKEY, CONFIG_BT_CTLR, CONFIG_BT_TINYCRYPT_ECC; zvyšte CONFIG_BT_BUF_EVT_RX_COUNT, pokud jste ho snižovali; callback shell_set_bypass() získal void *user_data; #include <nrf52840.h> → #include <soc.h>

Aplikace, které tyto funkce používají jen přes API subsystémů CHESTER (ctr_cloud, ctr_radon, …), měnit nemusíte. Úprava je přímo v SDK.

Kontrolní seznam​

  • Začněte z funkční aplikace ve verzi v3.5.5 (NCS v2.9)
  • Aktualizujte west.yml na v4.0.0
  • west update → west zephyr-export → west sdk install -t arm-zephyr-eabi → west packages pip --install -- -U
  • rm -rf build a sestavení načisto
  • (aplikace mimo repozitář SDK) přidejte sysbuild.conf; přesuňte konfiguraci mcuboot + přidejte CONFIG_BOOT_MAX_IMG_SECTORS_AUTO=n; smažte child_image/ a pm_static.yml; odstraňte napojení PM z app.overlay/prj.conf (referenční commit ef27da1e)
  • (nestandardní rozvržení) reprodukujte starou mapu oddílů v app.overlay
  • Odstraňte CONFIG_TINYCRYPT* / CONFIG_ADC_TLA2021_INIT_PRIORITY
  • Proveďte změny z bodu 2b, které se vaší aplikace týkají
  • Před nasazením ověřte mapu oddílů / kompatibilitu OTA