Advanced installation instructions
These sections contain additional instructions for various cases.
Installing using non-silent option
The base tools package installs in your home directory on Windows by default. If your user home directory contains spaces or illegal characters, or if you need to install for all users, you will need to select the Non-silent install option on the installer page of the Setup program.
If possible, create a new user account and user home directory that doesn’t contain spaces or illegal characters. Then, you can just use the default process for that account. If you cannot create a new user home directory, then you must perform some extra installation steps.
When the Setup program begins to install the tools package, it will revert to the package installer program.
We recommend to install for the current user, but if you need to install for all users, then Admin permission will be required. Follow the instructions in this section to proceed.
Accept the license agreement and click Next.
Choose the Custom Installation option, and click Next.
Review the user guide, release notes, and other information on Infineon.com, as needed, and click Next.
On this next screen, specify the location to install the tools package.
Specify a path that does not include spaces. For example: C:\Infineon\ModusToolbox
Any path without spaces or illegal characters will work. The same is true if you install for all users in a non-default user home directory.
Click Next and a notice like the following will display to confirm that you are installing in a non-default location:
Click OK to proceed.
Specify the Start menu folder options, if needed, and click Next.
Select or deselect various install options and click Next.
If you have never installed ModusToolbox™ software before, leave the Other tasks selected to ensure a correct installation.
Review the settings and click Install to begin the installation, or click Back to go back to previous pages to make changes.
After installation is complete, review and follow the instructions in the following subsections as applicable.
Create directories
When installing in a non-default location, you should create a couple directories. You can choose any path as long as it doesn’t contain spaces.
-
Create a hidden "dot" directory named " . modustoolbox" for variable locations described later in this section. For example:
C:\MyPath*.*modustoolbox
-
Also, create a directory to store your workspaces. For example:
C:\MyPath\mtb-projects
Create variable to specify the path to Tools
Because you are installing ModusToolbox™ into a non-default location, you need to specify the path to your "tools" directory using an Environment Variable. Open the Environment Variables dialog, and create a new System or User Variable, depending on your installation type (current user or all users). For example:
CY_TOOLS_PATHS = C:/MyPath/ModusToolbox/tools_[version]
Use a Windows-style path (not Cygwin-style, like /cygdrive/c/). Also, use forward slashes.
Create variable to specify the global path
You also need to specify the global path using an Environment Variable. Open the Environment Variables dialog, and create a new System or User Variable, depending on your installation type (current user or all users). For example:
CY_GETLIBS_GLOBAL_PATH = C:/MyPath/.modustoolbox/global
Use a Windows-style path (not Cygwin-style, like /cygdrive/c/). Also, use forward slashes.
You can set this value using the Settings program instead of using a environment variable.
Specify the custom path to use for Local Content Storage
If you use Local Content Storage (LCS) to enable work without access to the Internet, set this variable to specify where the content will be stored. For example:
MTB_LOCAL_CONTENT_PATH = C:/MyPath/.modustoolbox/lcs
Use a Windows-style path (not Cygwin-style, like /cygdrive/c/). Also, use forward slashes.
You can set this value using the Settings program instead of using a environment variable.
Installing with previous versions
The ModusToolbox™ tools package installs alongside previous versions of the software (version 3.2, 3.0, 2.4, 2.3, etc.); therefore, all versions can be used independently. However, be aware that various programs including the Eclipse IDE and the build system will detect and use the most current version of the "tools" directory by default. For example, if you have both versions 3.4 and 3.3 installed, and if you launch the Project Creator from the Eclipse IDE for version 3.3, it will open the version from the "tools_3.4" directory instead of the "tools_3.3" directory.
To control this behavior, use the environment variable CY_TOOLS_PATHS as described in the "Product Versioning" section in the tools package user guide. This variable applies to all versions of the ModusToolbox™ tools package, so you will have to update it as you work with different versions. You can add this variable as an environment variable for all applications, or add it to a specific application only in the Makefile.
Installing with firewall or lack of web access
After the ModusToolbox™ software is installed, you will need access to the web to create applications, which download libraries from GitHub.com. If your site is behind a firewall, you can set up proxy information using the Project Creator tool. If GitHub.com is blocked for your site, you can use the Manifest DB Settings to point to a mirror or custom site. Refer to the Project Creator user guide for more information.
If you have no access to the web at all, you can use the Local Content Storage (LCS) Manager feature to create a copy of the database on your system. You will need one-time web access to set it up. Refer to the LCS Manager CLI user guide for more information.
Installing without the Setup program (offline installation)
ModusToolbox™ software consists of many packages and packs that can be downloaded and installed individually. In some cases, you may not want to use the Setup program to install the ModusToolbox™ software. We refer to this as "offline installation." You need to download and install the packages you want, or install them with the Infineon Developer Center (IDC) locally or on the web. Just be aware that some ModusToolbox™ packages have dependencies on others. So, you’ll have to install dependencies as well.
For detailed instructions about how to install without the Setup program, refer to https://community.infineon.com/t5/Knowledge-Base-Articles/Installing-ModusToolbox-software-without-the-Setup-program/ta-p/945668.