Skip to content

Install required packages

This page helps you resolve missing or incompatible packages in CodeFusion Studio. You may arrive here from:

  • System Planner — when opening a .cfsconfig file that requires a missing data model or plugin version
  • Workspace Creation Wizard — when no workspace templates are available for your selected SoC

How to resolve missing packages

The resolution method depends on where you encountered the error:

  • From System Planner? Use the automated version resolution workflow (recommended)
  • From Workspace Creation Wizard? Use the Package Manager UI to install template plugins. For other options, see manual package installation.

    Platform compatibility

    Some workspace templates are only available on specific operating systems. For example, SHARC-FX templates are only supported on Windows. If the Workspace Creation Wizard shows that no workspace templates are available and you believe compatible plugins are already installed, the templates may not be available for your operating system.

When you open a .cfsconfig file in System Planner but do not have the required data model or plugin version, a Critical Error screen appears with automated resolution options.

System Planner Critical Error screen showing missing data model with resolution options menu System Planner Critical Error screen showing missing data model with resolution options menu

Resolution steps

  1. Review the error details
    The error screen displays:

    • The missing component type (Missing Data Model or Missing Plugin)
    • The missing component and required version (for example, System Planner requires MAX32690 TQFN data model version 1.2.100 which is not available)
  2. Select a resolution option from the menu
    Under Resolution Options, available options depend on what versions are installed locally and available remotely:

    • Upgrade to compatible locally-available version X.X.X
      A compatible version is already installed. System Planner updates your configuration file to use this version without downloading anything.

    No remote access or not logged in to myAnalog

    If CodeFusion Studio can't access the remote package repository — because of a network issue or because you aren't logged in to myAnalog — only locally installed compatible versions (if available) appear in the menu. See Troubleshooting if you're stuck.

    • Install requested version X.X.X
      The exact version you need is available remotely. System Planner downloads and installs it.

    • Upgrade to latest compatible downloadable version X.X.X
      A compatible version is available remotely, and either no compatible version is installed locally or the remote version is newer than the best compatible version installed locally. System Planner downloads and installs the latest compatible version.

  3. (Optional) Configure future version handling
    Check or uncheck Allow all future compatible versions:

    • Checked: Uses a version range (for example, ^1.2.148) to allow automatic compatibility with future updates
    • Unchecked: Uses an exact version (for example, 1.2.148) to prevent automatic updates
  4. Click Continue
    System Planner installs packages if needed and updates your configuration file. Click Continue to System Planner to proceed to the System Planner Configuration Tools dashboard.

Troubleshooting

If the automated resolution fails (no menu options appear, installation errors occur, or buttons are disabled), complete the following:

Manual package installation (fallback)

If the automated resolution prompt doesn't work, or you need to install packages outside of the System Planner error flow, see: