native_simulator_sb_extensions

Sysbuild extension commands for Native simulator - native_sim based targets.

These commands are used by the sysbuild.cmake file of a board or application that builds several images into a single native simulator executable. They are no-ops unless the board target is a native simulator or bsim based one.

native_simulator_set_final_executable(<final_image>)

Add a build target which copies the executable produced by <final_image> to the top level, as zephyr/zephyr.exe.

<final_image> is expected to have been set to assemble other dependent images into itself if necessary, by calling native_simulator_set_child_images().

This allows other tools, like twister or the bsim test scripts, as well as users, to find this final executable in the same place as for non-sysbuild builds.

native_simulator_set_child_images(<final_image> <child_image>)

Set <child_image> as a dependency of <final_image>, and configure the final image to assemble the child image into its final executable.

native_simulator_set_primary_mcu_index(<image> [<image2> ...])

Propagate the SB_CONFIG_NATIVE_SIMULATOR_PRIMARY_MCU_INDEX setting, if it is set, to the CONFIG_NATIVE_SIMULATOR_PRIMARY_MCU_INDEX of each given image.