:orphan:

.. title:: CONFIG_BUILD_OUTPUT_UF2_FAMILY_ID

.. kconfig:: CONFIG_BUILD_OUTPUT_UF2_FAMILY_ID

CONFIG_BUILD_OUTPUT_UF2_FAMILY_ID
#################################

*UF2 device family ID*

Type: ``string``

Help
====

.. code-block:: none

    UF2 bootloaders only accept UF2 files with a matching family ID.
    This can be either a hex, e.g. 0x68ed2b88, or well-known family
    name string. If the SoC in use is known by UF2, the Family ID will
    be pre-filled with the known value.

Direct dependencies
===================

\ :kconfig:`BUILD_OUTPUT_UF2 <CONFIG_BUILD_OUTPUT_UF2>`

*(Includes any dependencies from ifs and menus.)*

Defaults
========

- "0x1c5f21b0" if \ :kconfig:`SOC_ESP32 <CONFIG_SOC_ESP32>`
- "0xada52840" if \ :kconfig:`SOC_NRF52840_QIAA <CONFIG_SOC_NRF52840_QIAA>`
- "0x4fb2d5bd" if \ :kconfig:`SOC_SERIES_IMX_RT <CONFIG_SOC_SERIES_IMX_RT>`
- "0x2abc77ec" if \ :kconfig:`SOC_SERIES_LPC55XXX <CONFIG_SOC_SERIES_LPC55XXX>`
- "0x68ed2b88" if \ :kconfig:`SOC_SERIES_SAMD21 <CONFIG_SOC_SERIES_SAMD21>`
- "0x55114460" if \ :kconfig:`SOC_SERIES_SAMD51 <CONFIG_SOC_SERIES_SAMD51>`
- "0x647824b6" if \ :kconfig:`SOC_SERIES_STM32F0X <CONFIG_SOC_SERIES_STM32F0X>`
- "0x5d1a0a2e" if \ :kconfig:`SOC_SERIES_STM32F2X <CONFIG_SOC_SERIES_STM32F2X>`
- "0x6b846188" if \ :kconfig:`SOC_SERIES_STM32F3X <CONFIG_SOC_SERIES_STM32F3X>`
- "0x53b80f00" if \ :kconfig:`SOC_SERIES_STM32F7X <CONFIG_SOC_SERIES_STM32F7X>`
- "0x300f5633" if \ :kconfig:`SOC_SERIES_STM32G0X <CONFIG_SOC_SERIES_STM32G0X>`
- "0x4c71240a" if \ :kconfig:`SOC_SERIES_STM32G4X <CONFIG_SOC_SERIES_STM32G4X>`
- "0x6db66082" if \ :kconfig:`SOC_SERIES_STM32H7X <CONFIG_SOC_SERIES_STM32H7X>`
- "0x202e3a91" if \ :kconfig:`SOC_SERIES_STM32L0X <CONFIG_SOC_SERIES_STM32L0X>`
- "0x1e1f432d" if \ :kconfig:`SOC_SERIES_STM32L1X <CONFIG_SOC_SERIES_STM32L1X>`
- "0x00ff6919" if \ :kconfig:`SOC_SERIES_STM32L4X <CONFIG_SOC_SERIES_STM32L4X>`
- "0x04240bdf" if \ :kconfig:`SOC_SERIES_STM32L5X <CONFIG_SOC_SERIES_STM32L5X>`
- "0x70d16653" if \ :kconfig:`SOC_SERIES_STM32WBX <CONFIG_SOC_SERIES_STM32WBX>`
- "0x5ee21072" if \ :kconfig:`SOC_STM32F103XE <CONFIG_SOC_STM32F103XE>`
- "0x57755a57" if \ :kconfig:`SOC_STM32F401XC <CONFIG_SOC_STM32F401XC>` || \ :kconfig:`SOC_STM32F401XE <CONFIG_SOC_STM32F401XE>`
- "0x6d0922fa" if \ :kconfig:`SOC_STM32F407XE <CONFIG_SOC_STM32F407XE>`
- "0x8fb060fe" if \ :kconfig:`SOC_STM32F407XG <CONFIG_SOC_STM32F407XG>`

Kconfig definition
==================



At ``Kconfig.zephyr:459``

Included via ``Kconfig:8``

Menu path: (Top) → Build and Link Features → Build Options → Build a binary in UF2 format

.. code-block:: kconfig

    config BUILD_OUTPUT_UF2_FAMILY_ID
    	string "UF2 device family ID"
    	default "0x1c5f21b0" if SOC_ESP32
    	default "0xada52840" if SOC_NRF52840_QIAA
    	default "0x4fb2d5bd" if SOC_SERIES_IMX_RT
    	default "0x2abc77ec" if SOC_SERIES_LPC55XXX
    	default "0x68ed2b88" if SOC_SERIES_SAMD21
    	default "0x55114460" if SOC_SERIES_SAMD51
    	default "0x647824b6" if SOC_SERIES_STM32F0X
    	default "0x5d1a0a2e" if SOC_SERIES_STM32F2X
    	default "0x6b846188" if SOC_SERIES_STM32F3X
    	default "0x53b80f00" if SOC_SERIES_STM32F7X
    	default "0x300f5633" if SOC_SERIES_STM32G0X
    	default "0x4c71240a" if SOC_SERIES_STM32G4X
    	default "0x6db66082" if SOC_SERIES_STM32H7X
    	default "0x202e3a91" if SOC_SERIES_STM32L0X
    	default "0x1e1f432d" if SOC_SERIES_STM32L1X
    	default "0x00ff6919" if SOC_SERIES_STM32L4X
    	default "0x04240bdf" if SOC_SERIES_STM32L5X
    	default "0x70d16653" if SOC_SERIES_STM32WBX
    	default "0x5ee21072" if SOC_STM32F103XE
    	default "0x57755a57" if SOC_STM32F401XC || SOC_STM32F401XE
    	default "0x6d0922fa" if SOC_STM32F407XE
    	default "0x8fb060fe" if SOC_STM32F407XG
    	depends on BUILD_OUTPUT_UF2
    	help
    	  UF2 bootloaders only accept UF2 files with a matching family ID.
    	  This can be either a hex, e.g. 0x68ed2b88, or well-known family
    	  name string. If the SoC in use is known by UF2, the Family ID will
    	  be pre-filled with the known value.

*(The 'depends on' condition includes propagated dependencies from ifs and menus.)*