The USB Configurator GUI contains

Menus

,

Toolbars

,

Panes

, and a subpane used to configure device descriptors.

File

  • New

    – Creates a new file with new configuration.

  • Open…

    – Opens the configuration file.

  • Save

    – Saves the existing file.

  • Save As…

    – Saves the existing file under a different name.

  • Open in System Explorer

    – Opens your computer’s file explorer tool to the folder that contains the *.

    cyusbdev

    file.

  • Load descriptor

    – Loads a descriptor under the selected descriptor.

  • Save descriptor

    – Saves the selected descriptor.

  • Recent files

    – Shows recent files that you can open directly.

  • Exit

    – Closes the configurator.

Edit

  • Undo

    – Undoes the last action or sequence of actions.

  • Redo

    – Redoes the last undone action or sequence of undone actions.

View

  • Notice List

    – Shows/hides the Notice List. For details, refer to the

    Device Configurator user guide

    .

  • Toolbar

    – Shows/hides the toolbar.

  • Reset View

    – Resets the view to the default.

Help

  • View Help

    – Opens this document.

  • About USB Configurator

    – Opens the About box for version information, with links to open

    https://www.infineon.com

    and the current session log file.

Toolbars​

Descriptor toolbar​

Provides the basic buttons from the

Menus

to create, open, edit, and save files.


../figures/image8.png

Also, the descriptor toolbar provides buttons to configure the descriptors hierarchy:

  • Add new descriptor

    – Click this button to create a new descriptor.

  • Delete selected descriptor

    – Removes the selected descriptor.

  • Import descriptor

    – Select a descriptor from the pull-down menu to transfer it into the configuration.

  • Expand all tree items

    – Clicking this button displays all the items in the Device Descriptors Tree.

  • Collapse all tree items

    – Clicking this button leaves only the Device Descriptors Tree visible.

  • Move up

    – Shifts up the selected descriptor.

  • Move down

    – Shifts down the selected descriptor.

HID Report toolbar​

The HID Report toolbar provides the buttons to configure an HID descriptor report.


../figures/image9.png

  • Add HID report item

    – Creates a new HID report item.

  • Delete HID report item

    – Removes the selected HID report item.

  • Load HID report

    – Opens an HID report file into the current HID Descriptor.

  • Import HID report

    – Transfers an HID report item into the configuration for the current HID Descriptor.

  • Move up HID report item

    – Shifts up an IDHIFDHID report item.

  • Move down HID report item

    – Shifts down an IDHIFDHID report item.

Array editor toolbar​

The Array editor toolbar provides the buttons to edit array elements.


../figures/image10.png

  • Add new element

    – Creates a new element.

  • Delete element

    – Removes the selected element.

  • Move up element

    – Shifts up an element.

  • Move down element

    – Shifts down an element.

Panes​

The USB Configurator contains two panes that display information about descriptors and their parameters:

Device Descriptors Tree pane​

This pane shows the descriptors hierarchy:

  • All the descriptors have their own hierarchy that can be created when their parent is selected. However, the Device Descriptors Tree is the root descriptor.

  • This pane shows the descriptors hierarchy:

To add specific descriptors, for example, CDC Interface descriptor or HID descriptor, add a special parent descriptor:

  • Add CDC interface descriptor for CDC descriptor.

  • Add HID alternate settings for HID descriptor.

Parameters pane​

This pane shows configuration information for the selected descriptor.

Note:

The Parameters pane has different controls to edit different parameters (text box, combo box, or multi-line text box). Most parameters have a text box as the editing control.

  • Vendor-defined items – Some string parameters or HID report items, such as iSerialNumber, have a combo box with a list of predefined items. The “Empty” value is selected by default. To specify a value that is not on the list, select “Vendor-defined.” The combo box will change to a text box to type an appropriate value. To return to the combo box, erase the value and leave the control.

  • String pool – Parameters such as iChannelNames in AC Processing Unit of Audio Interface descriptor 1.0 support a string pool and require a multi-line text box. To insert several strings, use an end-line separator.

  • Read-only parameters – There are two types of read-only parameters: predefined bDescriptorType or auto-calculated bConfigurationValue.

  • Array parameters – Parameters such as bSubordinateInterface in union with Communication Alternate Settings is an array. Use “;” to separate elements. Also, you can open the

    Array editor toolbar

    dialog to set the parameters using the [ . . . ] button.

  • Hexadecimal/Decimal – When a value starts with “0x,” it is parsed as a hexadecimal value. Otherwise, it is parsed as a decimal.

  • Map and bit fields – Some parameters, such as bmAttributes, are read-only by themselves. However, you can insert them using the related bit fields below them in the parameters list. The bit fields size is 0B. Their name starts with the name of a field whole part, plus the bits for which they are responsible. For example, bmAttributes(1-0): Transfer Type.

Notice List​

The Notice List combines notices (errors, warnings, tasks, and notes) from many places in the configuration into a centralized list. If a notice shows a location, double-click that entry to display the parameter causing the error or warning. Also, you can read an error message in a tooltip.

For more information about the Notice List, refer to the

Device Configurator user guide

.