Lines Matching +full:patch +full:- +full:schema
1 # SPDX-License-Identifier: Apache-2.0
14 # 1. Zephyr-aware extensions
21 # 2. Kconfig-aware extensions
23 # 3. CMake-generic extensions
44 # 1. Zephyr-aware extensions
49 # "zephyr". zephyr is a catch-all CMake library for source files that
52 # [0] https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html
66 # As a very high-level introduction here are two call graphs that are
72 # zephyr_library_compile_options() --> target_compile_options()
75 # zephyr_cc_option() ---> target_cc_option()
78 # zephyr_cc_option_fallback() ---> target_cc_option_fallback()
81 # zephyr_compile_options() ---> target_compile_options()
178 # - include_directories # -I directories
179 # - system_include_directories # -isystem directories
180 # - compile_definitions # -D'efines
181 # - compile_options # misc. compiler flags
184 # - the empty string '', signifying that it should be returned as a list
185 # - _as_string signifying that it should be returned as a string
188 # - C
189 # - CXX
190 # - ASM
195 # to a compiler, e.g. prefixed with -D, or -I, but it is possible to
201 # writes "-Isome_dir;-Isome/other/dir" to x
243 set(result_output_list "-I$<JOIN:${genexp_output_list},$<SEMICOLON>-I>")
248 set(result_output_list "-I$<JOIN:${genexp_output_list},${args_DELIMITER}-I>")
261 …ult_output_list "$<$<BOOL:${genexp_output_list}>:-isystem$<JOIN:${genexp_output_list},${args_DELIM…
274 set(result_output_list "-D$<JOIN:${genexp_output_list},${args_DELIMITER}-D>")
318 # $<$<COMPILE_LANGUAGE:CXX>:-fno-exceptions>
325 # https://cmake.org/cmake/help/v3.3/manual/cmake-generator-expressions.7.html
339 # SHELL is used to avoid de-duplication, but when process flags
414 # methods have the signature: zephyr_library_<target-function>
417 # https://cmake.org/cmake/help/latest/manual/cmake-commands.7.html for
429 # Constructor with a directory-inferred name
465 # Provides amend functionality to a Zephyr library for out-of-tree usage.
607 "-l" $<TARGET_FILE_NAME:${ZEPHYR_CURRENT_LIBRARY}> "${partition}")
638 # ensure that when a user KConfig-enables a library then the header
643 # functions out-of-the box.
682 --file ${source_file}
726 # - Board runners
727 # - Board revision
813 # board_runner_args(runner "--some-arg=val1" "--another-arg=val2")
817 # --some-arg=val1 --another-arg=val2
823 # board_runner_args(runner "--some-app-setting=value")
848 # board_runner_args(runner "--some-arg=default-value")
924 # board_check_revision(FORMAT <LETTER | NUMBER | MAJOR.MINOR.PATCH>
935 # The function will check the revision from `-DBOARD=<board>@<revision>` that
940 # FORMAT <LETTER | NUMBER | MAJOR.MINOR.PATCH>: Specify the revision format.
941 # LETTER: Revision format is a single letter from A - Z.
943 # MAJOR.MINOR.PATCH: Revision format is three numbers, separated by `.`,
967 # revisions 0.x.0-0.99.99 and 1.0.0-1.99.99, and it is expected
999 requires a revision. Please use: `-DBOARD=${BOARD}@<revision>`")
1008 ((BOARD_REV_FORMAT MATCHES "^MAJOR\.MINOR\.PATCH$") AND
1018 set(revision_regex "([A-Z])")
1020 set(revision_regex "([0-9]+)")
1021 elseif(BOARD_REV_FORMAT MATCHES "^MAJOR\.MINOR\.PATCH$")
1022 set(revision_regex "((0|[1-9][0-9]*)(\.[0-9]+)(\.[0-9]+))")
1025 if(BOARD_REVISION MATCHES "((0|[1-9][0-9]*)(\.[0-9]+)?(\.[0-9]+)?)")
1037 `board_check_revision(FORMAT <LETTER | NUMBER | MAJOR.MINOR.PATCH>)`")
1066 if((BOARD_REV_FORMAT MATCHES "^MAJOR\.MINOR\.PATCH$") AND
1108 # again wraps the CMake-builtin's check_c_compiler_flag and
1132 # the file contents are the values in this key-value store.
1167 # Flags that start with -Wno-<warning> can not be tested by
1168 # check_compiler_flag, they will always pass, but -W<warning> can be
1169 # tested, so to test -Wno-<warning> flags we test -W<warning>
1171 if("${option}" MATCHES "-Wno-(.*)")
1172 string(REPLACE "-Wno-" "-W" possibly_translated_option "${option}")
1223 # the test. Exclude them by toolchain-specific blocklist.
1246 # currently only available on ARM Cortex-M, ARM Cortex-R,
1247 # x86, ARC, openisa_rv32m1, and RISC-V.
1264 # given, the key 'default' is used. Keys are case-sensitive.
1275 # _mysection_size = ABSOLUTE(_mysection_end - _mysection_start);
1285 # _mysection_size = _mysection_end - _mysection_start;
1297 set(sections_path "${snippet_base}/snippets-sections.ld")
1298 set(rom_sections_path "${snippet_base}/snippets-rom-sections.ld")
1299 set(ram_sections_path "${snippet_base}/snippets-ram-sections.ld")
1300 set(data_sections_path "${snippet_base}/snippets-data-sections.ld")
1301 set(rom_start_path "${snippet_base}/snippets-rom-start.ld")
1302 set(noinit_path "${snippet_base}/snippets-noinit.ld")
1303 set(rwdata_path "${snippet_base}/snippets-rwdata.ld")
1304 set(rodata_path "${snippet_base}/snippets-rodata.ld")
1305 set(ramfunc_path "${snippet_base}/snippets-ramfunc-section.ld")
1306 set(nocache_path "${snippet_base}/snippets-nocache-section.ld")
1307 set(itcm_path "${snippet_base}/snippets-itcm-section.ld")
1308 set(dtcm_path "${snippet_base}/snippets-dtcm-section.ld")
1310 set(pinned_ram_sections_path "${snippet_base}/snippets-pinned-ram-sections.ld")
1311 set(pinned_data_sections_path "${snippet_base}/snippets-pinned-data-sections.ld")
1312 set(pinned_rodata_path "${snippet_base}/snippets-pinned-rodata.ld")
1449 # - NOCOPY: this flag indicates that the file data does not need to be copied
1451 # - NOKEEP: suppress the generation of KEEP() statements in the linker script,
1453 # - PHDR [program_header]: add program header. Used on Xtensa platforms.
1485 set(src_list_abs "$<FILTER:${genex_src_list},INCLUDE,^[A-Za-z]\:>")
1486 set(src_list_rel "$<FILTER:${genex_src_list},EXCLUDE,^[A-Za-z]\:>")
1526 # using set_property(APPEND) to produce a ";"-separated CMake list. This way,
1537 # check_dtc_flag("-Wtest" DTC_WARN_TEST)
1546 ${DTC} ${flag} -v
1575 math(EXPR x "${${n}} & (${${n}} - 1)")
1601 # - Normalized board target build string, this includes qualifiers and revision
1602 # - Build string with board variants removed in addition
1603 # - Build string with cpuset removed in addition
1604 # - Build string with soc removed in addition
1608 # non-revisioned entry for each entry.
1611 # zephyr_build_string(<out-variable>
1613 # [SHORT <out-variable>]
1618 # zephyr_build_string(<out-variable>
1623 # <out-variable>: Output variable where the build string will be returned.
1624 # SHORT <out-variable>: Output variable where the shortened build string will be returned.
1811 COMMAND ${WEST} blobs list ${BLOBS_VERIFY_MODULE} --format "{status} {abspath}"
1862 # 2. Kconfig-aware extensions
1890 ENCODING "UTF-8"
1954 # 3. CMake-generic extensions
1982 # "<function-name>_ifdef(CONDITION args)"
1986 # <function-name>(args)
1990 # ifdef functions are added on an as-need basis. See
1991 # https://cmake.org/cmake/help/latest/manual/cmake-commands.7.html for
2289 # 3.3. *_option Compiler-compatibility checks
2293 # cc-option in
2305 # check_compiler_flag(C "-Wall" my_check)
2393 # 'gcc -M'.
2460 if(NOT "${var}" STREQUAL "var-NOTFOUND")
2516 # compiler-cpp targets.
2528 set(APPEND-CPP "APPEND")
2532 set_property(TARGET compiler-cpp ${APPEND} PROPERTY ${COMPILER_PROPERTY_PROPERTY})
2536 # flag and only set the compiler or compiler-cpp property if the check succeeds
2540 # before setting the property on compiler or compiler-cpp targets.
2542 # To test flags together, such as '-Wformat -Wformat-security', an option group
2543 # can be specified by using shell-like quoting along with a 'SHELL:' prefix.
2545 # '"SHELL:-Wformat -Wformat-security"' becomes '-Wformat -Wformat-security' for
2558 set(APPEND-CPP "APPEND")
2574 set_property(TARGET compiler-cpp ${APPEND-CPP} PROPERTY ${property} ${option})
2575 set(APPEND-CPP "APPEND")
2650 # those paths that are defined with `-D<path>=<val>`
2653 # by user with `-D<path>`
2654 # BASE_DIR <base-dir>: convert paths relative to <base-dir>
2668 # - DTS: Overlay files (.overlay)
2669 # - Kconfig: Config fragments (.conf)
2670 # - defconfig: defconfig files (_defconfig)
2722 # Note: user can do: `-D<var>=<relative-path>` and app can at same
2723 # time specify `list(APPEND <var> <abs-path>)`
2724 # Thus need to check and update only CACHED variables (-D<var>).
2727 # The cached variable is relative path, i.e. provided by `-D<var>` or
2748 Relative paths are only allowed with `-D${ARGV1}=<path>`")
2978 COMMAND ${CMAKE_COMMAND} -E ${copy_file_command} ${oldname} ${newname}
3034 # zephyr_string(<mode> <out-var> <input> ...)
3051 # characters. Special characters, such as -, +, =, $, etc. are
3055 # characters. Special characters, such as -, +, =, $, etc. are
3076 string(REGEX REPLACE "[^a-zA-Z0-9_]" "_" work_string ${work_string})
3085 # \\1 and \\2 are keeping the match patterns, the \\\\ --> \\ meaning an escaped '\',
3103 # for storing current and future Zephyr-related extensions for list
3107 # converts the argument list <list> to a ;-list with
3110 # may be whitespace- or semicolon-separated.
3189 # - Sysbuild defined when sysbuild is used.
3192 # - BOARD is considered a global sysbuild cache variable
3193 # - blinky_BOARD is considered a local sysbuild cache variable only for the
3198 # - CMake cache, set by `-D<var>=<value>` or `set(<var> <val> CACHE ...)
3199 # - Environment
3200 # - Locally in CMakeLists.txt before 'find_package(Zephyr)'
3204 # using `-DZEPHYR_TOOLCHAIN_VARIANT=<val>`, then the value from the cache is
3407 # - BOARD
3408 # - SHIELD
3418 # - Using CMake argument, -D<variable>
3419 # - Using an environment variable
3420 # - In the project CMakeLists.txt before `find_package(Zephyr)`.
3430 # E.g. always specifies -D<variable>= on the command line,
3457 # If user uses -D<variable>=<new_value>, then cli_argument will hold the new
3498 message(FATAL_ERROR "${variable} is not being defined on the CMake command-line,"
3553 # Get build targets for a given directory and sub-directories.
3587 # This function allows samples that are multi-image samples by nature to ensure
3601 "For correct user-experiences, please build '${PROJECT_NAME}' "
3625 POST_BUILD COMMAND ${CMAKE_COMMAND} -E true
3634 # RESULT <out-variable>)
3713 # build_info(vendor-specific foo VALUE bar)
3717 # <tag>...: One of the pre-defined valid CMake keys supported by build info or vendor-specific.
3718 # See 'scripts/schemas/build-schema.yml' CMake section for valid tags.
3727 if(index EQUAL -1)
3732 if(index EQUAL -1)
3746 yaml_load(FILE ${ZEPHYR_BASE}/scripts/schemas/build-schema.yml NAME build_info_schema)
3756 list(SUBLIST arg_list ${index} -1 values)
3768 if(ARGV0 STREQUAL "vendor-specific")
3774 if(check MATCHES ".*-NOTFOUND")
3798 # - In CMake, we refer to the nodes using the node's path, therefore
3802 # - As another difference from the C API, you can generally use an
3817 # nvic: interrupt-controller@e000e100 { ... };
3823 # # Sets 'nvic_path' to "/soc/interrupt-controller@e000e100"
3831 # REQUIRED : Generate a fatal error if the node-label is not found
3850 if(${${var}} STREQUAL ${var}-NOTFOUND)
3871 # # alias "does-not-exist".
3872 # dt_alias(path PROPERTY "does-not-exist")
3898 if(${${var}} STREQUAL ${var}-NOTFOUND)
3915 # - absolute path to a node, like '/foo/bar'
3916 # - a node alias, like 'my-alias'
3917 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
3952 # - exists in the devicetree, and
3953 # - has a status property matching the <status> argument
3959 # - absolute path to a node, like '/foo/bar'
3960 # - a node alias, like 'my-alias'
3961 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
4013 # - absolute path to a node, like '/foo/bar'
4014 # - a node alias, like 'my-alias'
4015 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
4018 # devicetree binding types: string, int, boolean, array, uint8-array,
4019 # string-array, path.
4021 # For array valued properties (including uint8-array and
4022 # string-array), the entire array is returned as a CMake list unless
4033 # dt_prop(reserved_ranges PATH "/soc/gpio@deadbeef" PROPERTY "gpio-reserved-ranges")
4035 # # Node exists and has the "gpio-reserved-ranges" property.
4042 # dt_prop(reserved_ranges PATH "/soc/gpio@deadbeef" PROPERTY "gpio-reserved-ranges")
4044 # # Node "/soc/gpio@deadbeef" exists and has the "gpio-reserved-ranges" property
4164 # - absolute path to a node, like '/foo/bar'
4165 # - a node alias, like 'my-alias'
4166 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
4203 # - absolute path to a node, like '/foo/bar'
4204 # - a node alias, like 'my-alias'
4205 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
4208 # - The base address of the register block
4209 # - <var> will be undefined if node does not exists or does not have a register
4239 if(DT_REG_INDEX EQUAL "-1")
4268 # - absolute path to a node, like '/foo/bar'
4269 # - a node alias, like 'my-alias'
4270 # - a node alias followed by a path to a child node, like 'my-alias/child-node'
4299 if(DT_REG_INDEX EQUAL "-1")
4319 dt_prop(reg_names PATH "${path}" PROPERTY "reg-names")
4321 set(index "-1")
4371 if(${exists} STREQUAL exists-NOTFOUND)
4406 if(${${var}} STREQUAL ${var}-NOTFOUND)
4422 # my-label: bar {
4427 # my-alias = &my-label;
4434 # dt_path_internal(ret "my-alias") # sets ret to "/foo/bar"
4435 # dt_path_internal(ret "my-alias/baz") # sets ret to "/foo/bar/baz"
4457 if (NOT "${slash_index}" EQUAL -1)
4458 string(SUBSTRING "${path}" "${slash_index}" -1 rest)
4574 list(APPEND include_opts -isystem ${dir})
4579 list(APPEND source_opts -include ${file})
4584 list(APPEND deps_opts -MD -MF ${DT_PREPROCESS_DEPS_FILE})
4596 -x assembler-with-cpp
4597 -nostdinc
4601 -D__DTS__
4603 -E # Stop after preprocessing
4605 -o ${DT_PREPROCESS_OUT_FILE}
4702 # r: Read-only region
4703 # w: Read-write region
4788 dt_prop(name PATH ${DTS_SECTION_PATH} PROPERTY "zephyr,memory-region")
4791 "\"zephyr,memory-region\" property"
4857 dt_prop(name PATH ${DTS_MEMORY_PATH} PROPERTY "zephyr,memory-region")
4860 "\"zephyr,memory-region\" property"
4865 dt_prop(flags PATH ${DTS_MEMORY_PATH} PROPERTY "zephyr,memory-region-flags")
4928 # +-----------------+
4931 # | +-------------+ |
4933 # | +-------------+ |
4935 # | +-------------+ |
4937 # | +-------------+ |
4939 # +-----------------+
4948 # +---------------------+
4951 # | +-----------------+ |
4954 # | | +-------------+ | |
4956 # | | +-------------+ | |
4958 # | +-----------------+ |
4960 # +---------------------+
5089 - (${CONFIG_SRAM_BASE_ADDRESS} + ${CONFIG_SRAM_OFFSET})"
5151 # of equally-sized data structures. For use with STRUCT_SECTION_ITERABLE.
5185 # ToDo - Should we use ROM, RAM, etc as arguments ?
5368 # `+, -, *` and similar. The expression will go directly into the
5397 # The macro will create a list of argument-value pairs for defined arguments
5599 # - lib_target Target name for the source compilation and/or link step.
5600 # - lib_output The binary file resulting from compilation and/or
5602 # - pkg_input The file to be used as input for the packaging step.
5603 # - pkg_output The final .llext file.
5654 # a "-shared" flag to the linker command line which does firmly
5655 # conflict with "-r".
5720 # they will take care of this and the default copy is replaced by a no-op.
5722 set(noop_cmd ${CMAKE_COMMAND} -E true)
5723 set(copy_cmd ${CMAKE_COMMAND} -E copy ${llext_lib_output} ${llext_pkg_input})
5741 --elf-file ${llext_pkg_output}
5744 set(slid_inject_cmd ${CMAKE_COMMAND} -E true)
5761 # Add user-visible target and dependency, and fill in properties
5784 # can refer to <target>'s properties for build-specific details.
5787 # - PRE_BUILD: Before the llext code is linked, if the architecture uses
5790 # - POST_BUILD: After the llext code is built, but before packaging
5793 # - POST_PKG: After the .llext file has been created. This can operate on
5796 # Anything else after COMMAND will be passed to add_custom_command() as-is
5801 # COMMAND and other options are passed to add_custom_command() as-is
5824 # - execute user command(s) before the lib target's link step.
5829 # - stop default file copy to prevent user files from being clobbered;
5830 # - execute user command(s) after the (now empty) `llext_proc_target`.
5836 # - execute user command(s) after the main target is done.
5904 # are: package_helper.cmake, verify-toolchain.cmake, llext-edk.cmake