There are two basic steps to get started using local content:

  1. Create a local database (full or partial).

  2. Update your settings.

Create full database​

To create a local copy of the entire database, run this command:

$HOME/ModusToolbox/tools_3.4/lcs-manager-cli/lcs-manager-cli –-add-all

This creates a copy of the entire database from the remote manifest. It may take a long time depending on how many repos are in the manifest.

Create partial database​

To create a local copy of a partial database, specify a particular BSPs using this command:

$HOME/ModusToolbox/tools_3.4/lcs-manager-cli/lcs-manager-cli --add-bsp<BSP Name>

Where

<BSP Name>

is a valid name of a BSP from the remote manifest. The specified BSP will be added to a file named

watchlist.json

in the

lcs

directory, and the BSP and all dependencies will be downloaded into local content storage.

Note:

In some cases when you use the

--add-bsp

command, the tool may not download all the necessary dependencies, resulting in situations where you cannot create the desired application. This can happen if a dependency is referenced by a .mtb file and not in the manifest. To solve this problem, we recommend running lcs-manager-cli with the

--add-all

option to download the full database.

Examples of valid BSP names include CYW943907AEVAL1F, TARGET_PMG1-CY7112, and CY8CKIT-062S2-43012. See

GitHub manifest file

for an example of a BSP manifest.

Update settings to use local content​

Beginning with the 3.5.0 tools package, there is a ModusToolbox™ Settings tool to configure a wide range of settings for your environment, including LCS settings. You can run the settings tool as a GUI or from the command line. See the Settings tool user guide for more details on specific features.

GUI option​

Launch the Settings tool GUI as applicable for your operating system. You can launch it from various tools like Project Creator and Library Manager. Once open, select

Operating Mode > Local Content Mode

to set the LCS mode for all tools.

If your LCS directory is located in a non-default location, use the

Local Content Storage Location

option to specify the location of the

.

modustoolbox/lcs

directory.

Command-line option​

Run the Settings tool CLI (mtb-settings-cli) in a terminal (modus-shell on Windows) using the following command:

cd [path to mtb-settings]
./mtb-settings-cli --set operating_mode=local

If your LCS directory is located in a non-default location, also use this command to specify the location of the

.

modustoolbox/lcs

directory:

./mtb-settings-cli --lcs_path="[path to LCS dir]"