As part of a ModusToolbox™ application, the Device Configurator

design.modus

file is an integral part of the board support package (BSP) and requires an association to an application in order to obtain device configuration information.

Installation​

The Infineon Device Configurator is installed as part of the ModusToolbox™ tools package. There are no other requirements for installing this tool.

Launch the Device Configurator​

You can launch the Device Configurator in various ways as described in this section; however, the tool's configuration (

design.modus

) file requires an association to an application in order to obtain device configuration information.

The

design.modus

file contains all the required hardware configuration information about the device for the application. When you save updates, the Device Configurator generates/updates source code in the

GeneratedSource

directory next to the

design.modus

file. Applications use the

design.modus

file and generated source code in future application builds.

make command​

As described in the

ModusToolbox™ tools package user guide

build system chapter, you can run numerous make commands in the application directory, such as launching the Device Configurator. After you have created a ModusToolbox™ application, navigate to the application directory and type the following command in the appropriate bash terminal window:

make device-configurator

This opens the Device Configurator using the application's

design.modus

file.

Executable (GUI)​

If you don't have an application or if you just want to see what the configurator looks like, you can launch the Device Configurator GUI by running its executable as appropriate for your operating system (for example, double-click it or select it using the Windows

Start

menu). By default, it is installed here:

<install_dir>/ModusToolbox/tools_<version>/device-configurator-<version>

When launched this way, the Device Configurator opens without any configuration information. You can open a specific *.

modus

file using the "Open" link or clicking

File > Open

, and then navigating to the location of the *.

modus

file to open.

Executable (CLI)​

The Device Configurator executable can be run from the command line, and it also has a "cli" version of the executable as well. Running configurator executables from the command line can be useful as part of batch files or shell scripts to re-generate the source code based on the latest configuration settings. The exit code for the executable is zero if the operation is successful, or non-zero if the operation encounters an error. For more information about the command-line options, run the executable using the

-h

option.