Create a new workspace

New workspaces are created with the Workspace Creation Wizard.

Launch the Workspace Creation Wizard

1. Click the CodeFusion Studio icon in the VS Code activity bar.

2. Click New Workspace.

   

Create a workspace

1. Choose a processor from the list. You can type a partial name to filter the options.
2. Choose a board and package. For an ADI board, select the desired board under Standard Boards and Packages. For a custom board, select it under Custom Board Packages.

3. Select a workspace template or choose to Manually configure the workspace

   

Manually configure the workspace

Choose this option to set up your system configuration step by step.

1. Select one or more cores to include in your workspace. The primary core is mandatory and must be enabled to proceed.

2. Select a Code Generation Plugin. Choose one of the following options:

   • MSDK: Generates projects for MSDK platforms.
   • Registers-only (bare-metal) Plugin: This is intended as a reference for advanced workflows. It enables code generation for platforms that do not use Zephyr or MSDK. The generated code references registers directly using MMR access. Build or debug support is not included as the generated register definitions are intended to be integrated into custom toolchains or external workflows.
   • Zephyr: Generates projects based on the Zephyr RTOS.

3. Define the Platform Options for each core as described below.

   Option	Description
   Project Name	Enter a unique name for each core to avoid issues during project generation. For example, use a core ID such as CM4 or RV to clearly distinguish projects associated with different cores.
   Zephyr Version	Select the Zephyr release version to target. The available versions depend on the installed packages.
   Build System	Choose a build system such as Ninja or Make. Ninja is recommended and selected by default.
   Board Name	Specify the board name. For MSDK projects, use standard board names such as EvKit_V1, APARD, or FTHR. For Zephyr projects, use the format <platform>/<soc>/<core> as defined by the identifier field in your Zephyr board’s YAML file. For example, the board name for the MAX32690 FTHR board is defined in <CFS-Install>/SDK/zephyr/zephyr/boards/adi/max32690fthr/max32690fthr_max32690_m4.yaml under identifier: max32690fthr/max32690/m4.
   Zephyr KConfig Flags	Add optional Zephyr configuration flags.
   Enable Core Dump	Enables generation of debug metadata for post-mortem crash analysis. Required for use with the Core Dump Analysis Tool.
   Zephyr Additional CMake Arguments	Provide extra compiler or linker options.

4. Click Continue to move to the next core configuration.

5. Repeat until all cores are configured.

   

Select a workspace template

Choose a pre-defined SoC template with ADI-recommended configuration options. You can choose from single or multi-core options.

Complete workspace setup

1. Enter the workspace name (use letters, numbers, underscores, dashes, and periods only. No spaces or other special characters are permitted).

2. Use the default location or uncheck the box to choose a different location.

   Note

   The workspace location can be edited manually or a new workspace location can be set using the Browse button.

3. Click Create Workspace.

4. If you receive the notification Do you trust the authors of the files in this workspace?, click Yes, I trust the authors to continue.
5. Once created, the workspace files will appear in the File Explorer, and the System Planner Configuration Tools dashboard will open. For information on using the dashboard, see System Planner Configuration Tools.
6. If generation fails, error messages will guide you to resolve issues before trying again.

Copy workspace settings

You can create new workspaces based on the settings of an existing workspace by clicking Configure Workspace in the CodeFusion Studio interface. This opens the workspace creation wizard, pre-filled using the settings stored in your selected .cfsworkspace file. You can then modify options such as processor selection, board configuration, core settings, and firmware platform.

For example, if you initially created a workspace for the MAX32690 EV kit using an MSDK template, you could use Configure Workspace to start from that setup but switch to a Zephyr template without starting from scratch.