TL7218X Retention Light-Switch App Build Guide

TL7218X Retention Light-Switch App Build Guide#

1. 2MB Flash (Matter only, NO OTA/MCUBoot, NO LZMA)#

Kconfig: boards/tl7218x_retention.conf (default)

  • CONFIG_CHIP_OTA_REQUESTOR=n

  • CONFIG_CHIP_DFU_OVER_BT_SMP=n, CONFIG_CHIP_DFU_OVER_BT_SMP_BUILD=n,

  • CONFIG_LZMA=n, CONFIG_COMPRESS_LZMA=n

  • CONFIG_DUAL_MODE=0

Note: This configuration disables OTA, does not use MCUBoot, and cannot be upgraded

DTS Overlay: src/platform/telink/tl7218x_2m_flash.overlay (default)

  • slot0: 0x15000, size 0xe5000 (916KB)

  • slot1: 0xfa000, size 0xe6000 (920KB)

Build:

west build -p -b tl7218x_retention -d build_tl7218x_retention_default -- \
> build_tl7218x_retention_default.log
# Kconfig: default (boards/tl7218x_retention.conf)
# DTS Overlay: default (src/platform/telink/tl7218x_2m_flash.overlay)

Output:

build_tl7218x_retention_default/zephyr/zephyr.bin          -> flash this

2. 2MB Flash (Matter only, enable BT DFU, LZMA compressed, SW - 1 and 2)#

IMPORTANT: LZMA compression is REQUIRED for 2MB flash with OTA.

Kconfig: boards/tl7218x_retention_ota_lzma.conf (explicitly specified)

  • CONFIG_CHIP_OTA_REQUESTOR=y

  • CONFIG_CHIP_DFU_OVER_BT_SMP=y, CONFIG_CHIP_DFU_OVER_BT_SMP_BUILD=y,

  • CONFIG_LZMA=y, CONFIG_COMPRESS_LZMA=y

  • CONFIG_DUAL_MODE=0

DTS Overlay: src/platform/telink/tl7218x_2m_flash_lzma.overlay (default)

Build Software Version 1:

west build -p -b tl7218x_retention -d build_tl7218x_retention_lzma_v1 -- \
-DCONF_FILE="prj.conf boards/tl7218x_retention_ota_lzma.conf" \
-DCONFIG_CHIP_DEVICE_SOFTWARE_VERSION=1 > build_tl7218x_retention_lzma_v1.log
# Kconfig: explicitly specified (-DCONF_FILE="prj.conf boards/tl7218x_retention_ota_lzma.conf")
# DTS Overlay: default (src/platform/telink/tl7218x_2m_flash_lzma.overlay)

Build Software Version 2:

west build -p -b tl7218x_retention -d build_tl7218x_retention_lzma_v2 -- \
-DCONF_FILE="prj.conf boards/tl7218x_retention_ota_lzma.conf" \
-DCONFIG_CHIP_DEVICE_SOFTWARE_VERSION=2 > build_tl7218x_retention_lzma_v2.log
# Kconfig: explicitly specified (-DCONF_FILE="prj.conf boards/tl7218x_retention_ota_lzma.conf")
# DTS Overlay: default (src/platform/telink/tl7218x_2m_flash_lzma.overlay)

Output:

build_tl7218x_retention_lzma_v1/zephyr/merged.bin          -> flash this
build_tl7218x_retention_lzma_v2/zephyr/merged_dfu.lzma.bin -> DFU over BLE SMP
build_tl7218x_retention_lzma_v2/zephyr/matter.ota          -> OTA upgrade