There are several ways to launch the USB Configurator, and those ways depend on how you use the various tools in ModusToolbox™.

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 USB 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 usbdev-configurator

This command opens the application USB Configurator GUI for an existing USB configuration (*.

cyusbdev

) file.

If there is no *.

cyusbdev

file, then this command launches the USB Configurator with default configuration. Open an existing *.

cyusbdev

file or create a new one for the application in which you want to configure the USB Configurator.

Executable (GUI)​

Also, you can simply launch the USB 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>/usbdev-configurator-<version>

On Windows, launch the tool from the

Start

menu. For other operating systems, navigate to the install location and run the executable. The USB Configurator opens with an untitled configuration file (*.

cyusbdev

). Save it as a new file and provide a file name, or open another existing *.

cyusbdev

file.

Executable (CLI)​

You can run the usbdev-configurator executable from the command line. There is also a usbdev-configurator-cli executable, which re-generates the source code based on the latest configuration settings from a command-line prompt or from within batch files or shell scripts. The exit code for the usbdev-configurator-cli executable is zero if the operation is successful, or non-zero if the operation encounters an error. To use the usbdev-configurator-cli executable, you must provide at least the

--config

argument with a path to the configuration file.

For more information about the command-line options, run the usbdev-configurator or usbdev-configurator-cli executable using the -h option.