c2b.configureMulticoreOptions

R2026b

Configure multicore options for Texas Instruments C2000 target hardware

Since R2026b

collapse all in page

Syntax

c2b.configureMulticoreOptions(configSetOrModel)
c2b.configureMulticoreOptions(configSetOrModel,Name=Value)
status = c2b.configureMulticoreOptions(___)
[status,statusMessage] = c2b.configureMulticoreOptions(___)

Description

c2b.configureMulticoreOptions(configSetOrModel) retrieves and displays the current multicore option settings for the specified multiprocessor model or configuration set.

For a multiprocessor model configured for the SoC Builder, you can configure these multicore options before building and deploying the model:

  • Generate unused models for the cores not modeled in the model reference workflow.

  • Build with core synchronization between the primary and secondary cores of the multicore processor board. This synchronization occurs at the boot-level, model initialization, and application-level.

example

c2b.configureMulticoreOptions(configSetOrModel,Name=Value) sets the specified multicore options using name-value arguments.

example

status = c2b.configureMulticoreOptions(___) returns a logical status indicating success (true) or failure (false) instead of throwing an error.

[status,statusMessage] = c2b.configureMulticoreOptions(___) additionally returns a character vector containing status or error messages. When you specify output arguments, the function suppresses status messages from the MATLAB® Command Window.

example

Examples

collapse all

Display the current unused model generation and build with synchronization settings for a loaded top-level model.

load_system('myTopModel');
c2b.configureMulticoreOptions('myTopModel')
Unused model generation and build with core synchronization are already disabled for myTopModel and will be retained.

Enable both settings for a model configured for a C2000 multicore processor like a TI F2838x board.

c2b.configureMulticoreOptions('myTopModel', ...
    GenerateUnusedModels=true, BuildWithSynchronization=true)
Unused model generation and build with core synchronization enabled for myTopModel. To retain these settings click Save.

Disabling unused model generation automatically disables build with synchronization on C2000 multicore processor boards.

c2b.configureMulticoreOptions('myTopModel', ...
    GenerateUnusedModels=false)
Unused model generation and build with core synchronization disabled for myTopModel. To retain these settings click Save.

When you provide output arguments, the function returns messages as variables instead of printing them.

[status, msg] = c2b.configureMulticoreOptions('myTopModel', ...
    GenerateUnusedModels=true, BuildWithSynchronization=true);
disp(status)
disp(msg)
    1

    Unused model generation and build with core synchronization enabled for myTopModel. To retain these settings click Save.

Pass a configuration set object instead of a model name.

cs = getActiveConfigSet('myTopModel');
c2b.configureMulticoreOptions(cs, GenerateUnusedModels=true)

Input Arguments

collapse all

Simulink® configuration set, configuration set reference, or model name specifying the SoC top model to configure.

The model must be a top model with its processing unit set to 'None'. Passing a flat model (non-SoC) or a reference model results in an error:

Invalid model ref_cpu1. First argument must be a top model with processing unit set to 'None'.

The model must be loaded before calling this function.

Example: 'myTopModel'

Data Types: Simulink.ConfigSet | Simulink.ConfigSetRef | char

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: c2b.configureMulticoreOptions('myModel', GenerateUnusedModels=true, BuildWithSynchronization=false)

When true, the function generates code for cores not modeled in the model reference workflow. This produces unused model .slx and build artifacts (.elf, .hex, .out) for unmodeled cores.

When set to false, the function also disables BuildWithSynchronization (F28x boards only).

This option is supported on all multicore C2000™ boards (both F28x and F29x families).

Data Types: logical

When true, the function enables synchronization at the boot-level, model initialization, and application-level.

Set this argument to true only when GenerateUnusedModels is true. If unused model generation is disabled, the function throws an error.

This option is supported on F28x multicore boards only.

Data Types: logical

Output Arguments

collapse all

Returns true if the configuration succeeded, false otherwise. When you specify output arguments, the function does not throw errors — it returns errors through status and statusMessage instead.

Data Types: logical

Character vector describing the configuration result or error details. When you do not specify output arguments, the function prints this message directly to the MATLAB Command Window.

Data Types: char

Limitations

  • The model must be loaded before calling this function.

  • You cannot enable BuildWithSynchronization unless GenerateUnusedModels is also enabled, because core synchronization depends on the generated unused model code.

  • C29x based hardware boards (for example, TI F29H85x) support only GenerateUnusedModels. If you specify BuildWithSynchronization for a model configured for a C29x board, the function throws an error.

  • Single-core boards (for example, TI Delfino F2837xS) do not support this function.

  • The function dirties the model. You must save the model to retain the configured settings across sessions.

Tips

  • Call this function without arguments to query the current state without modifying anything.

  • After you configure multicore options, save the model (save_system) to persist the settings.

  • For pre-R2026b models, both options are enabled by default on model load to preserve legacy behavior. Use this function only if you need to change those defaults.

Version History

Introduced in R2026b

expand all