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 browser 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. The Notice List pane displays by default.

  • 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.

Notice List​

The

Notice List

pane combines notices (errors, warnings, tasks, and infos) from many places in the configuration into a centralized list. You can double-click a notice location to show the parameter causing the error or warning. For more information about the Notice List, refer to

Device Configurator user guide

.

Toolbars​

Descriptor toolbar​

Provides the basic buttons from the

Menus

to create, open, edit, and save files.



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.



  • 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.



  • 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 – 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 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 – There are two types of read-only parameters: predefined

    bDescriptorType

    or auto-calculated

    bConfigurationValue

    .

  • Array – 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

    .