Skip to main content

Panes

The Device Configurator tool contains the following primary panes that display information based on what is selected in a particular Resources tabs:

  • Parameters pane – This pane shows the various parameters for any specific resource enabled in one of the tabs.
  • Notice List – This pane shows any errors, warnings, tasks, and info for the application.
  • Code Preview pane – This pane shows a preview of the code that will be generated for the selected resource when you save the *.modus file.
  • Notes pane – This pane allows you to add notes for an enabled resource.

Panes layout and arrangement

By default, the panes are set to specific locations in the tool, as shown in the following image, with Parameters top right, with Notes as a sister tab, Code Preview below them, and Notice List bottom left.

You can re-arrange these panes to fit your preference by clicking in the pane header and dragging it to another location in the tool.

You can also click the Undock icon for an active Pane to enable moving it.

In this example, Notes, Code Preview, and Parameters are aligned at the top.

You can even drag a pane outside to the tool, as shown in this example:

You can show or hide panes using the View menu.

Use the View > Reset View menu item to restore the panes to their default locations.

Parameters pane

The Parameters pane contains all the parameters for a selected, enabled resource. This pane will show different parameters for each resource, grouped by various categories in nodes. For example, the parameters for the TCPWM peripheral are completely different than those for a pin resource.

This pane contains a few tools:

  • The filter box above the list of parameters allows you to limit the items shown in the pane and search for specific terms within the parameter descriptions.
    • You can search using plain text or regular expressions.
    • As you enter search items, they are saved in a list.
    • Use the up and down arrows to select previous searches.
    • Use the Erase button to clear the search.
  • The Reset button resets all parameter values in the current view to their defaults.
  • The Filter button toggles hides or shows non-editable parameters.
  • The - and + buttons collapse and expand all nodes.

Some resources also provide a link to Launch other configurators.

Configuration help

Nearly all resources provide a link to open the Peripheral Driver Library (PDL) documentation to the specific driver. This is the Doxygen-generated HTML file located in the installation directory. To see links to the documentation, simply highlight a resource; you do not need to enable it.

Parameter descriptions

As described under Icons, all parameters have a tooltip icon ../figures/image9.png to indicate there is information about the parameter. Hover the mouse cursor over the icon to display a description of the parameter.

Parameter values

Different parameter types have different ways to specify a value, as follows:

  • Pull-down Menu – For parameters with a specific set of values, use the pull-down menu to select the appropriate value.
  • Selection Box – For parameters with a variable set of values, click the ellipsis […] button to open a selection box. There, use the check boxes to select one or more appropriate values for the parameter.
    Note:
    After selecting these parameter types, use the Go To button to jump to the selected resource.
  • Check Box – For parameters with a true or false value, use the check box to enable or disable the parameter.
  • Text Box – For parameters with editable values, type the value in the text box.
Note:
Values preceded by '0' are interpreted as octal; values preceded by ‘0x’, ‘0X’, and ‘#’ are interpreted as hexadecimal.

Parameter notes

For any parameter, you can enter a note that makes sense to you. Parameter notes are shown in a pop-up dialog when you click the Pencil icon.

When you have entered a note for a parameter, the pencil icon will turn green, indicating that there is a note.

Signal Select Indicators

For parameters where you select a signal, there is a pull-down menu for single-select signals and a button to open a dialog for multi-select signals.

The signals have guidance icons next to them to indicate the status of the signal, as follows:

  • Green – preferred
  • Yellow – valid
  • Red – constrained

After selecting one or more signals, use the Go To ../figures/image14.png button to jump to the selected signal or open a dialog to select from multiple signals.

Launch other configurators

For peripherals with their own configuration tools (CapSense, SegLCD, etc.), the Device Configurator provides links to launch those separate configurators. After enabling the peripheral on the Peripherals tab, the Parameters pane contains a <Configurator> parameter, where <Configurator> is the name of the other configurator.

Click on [Launch < Configurator > . . .] to launch the configurator.

Note:
When launching another configurator from the Device Configurator, it passes information, such as the location of the *.modus file and any configuration data, to that other configurator. Those other configurators can be launched independently from the Device Configurator. When launched independently, you will need to either open or create the appropriate configuration file for that tool. If you want to use the configuration tools independently for the same application, make sure to save the source files in the correct "GeneratedSource" folder for the appropriate application.

Notice List

The Notice List pane combines notices (errors, warnings, tasks, and infos) from many places in your design into a centralized list. If a notice shows a location, you can double-click the entry to navigate to the error or warning.

Notices display in rows. Use the filters above the notices to show or hide different types of notices, as follows:

  • Errors – These indicate there is at least one problem that must be addressed before you can build your application. Typical errors could include compiler build errors and connectivity errors.
  • Warnings – These report unusual conditions that might indicate a problem, although you can usually build the application regardless.
  • Tasks – These are actions you need to perform to resolve an issue, such as enabling a resource. If you save without resolving a task, it becomes an error.
  • Infos – These are informational messages from the system to indicate something occurred.

The Notice List pane contains the following columns (each column header contains an arrow control to change the sorting of the notices in the table):

  • Icon – Displays the icons for the error, warning, task, or info.
  • Fix – This may display a wrench icon, which can be used to automatically address the required notice.
  • Description – Displays a brief description of the notice.
  • Location – Displays the specific line number or other location of the message, when applicable.

Fix a task/error

When a wrench icon ../figures/image32.png displays in the Fix column, click on it and select the appropriate action from the pull-down menu. When all related issues have been addressed, the notice will be removed from the Notice List pane.



Note:
The fixes listed are not necessarily the only way to fix the issue. They are merely common options. Also, if you save the *.modus file with outstanding tasks, they become errors saved in the GeneratedSource/cycfg_notices.h file.

Copy a notice

You can copy a notice to your system’s clipboard using [Ctrl]+[c] or right-click and select Copy. Then, paste the notice text into an email, document, and so on.

Code Preview pane

The Code Preview pane is a read-only preview of the code that will be generated for the currently selected resource when you save the *.modus file. As you update configuration options, the Code Preview pane updates the code and shows you the changes. This code will be written to the appropriate file(s) located in the GeneratedSource folder of your application.

The Orange and Blue Up and Down arrow buttons let you jump to the previous and next change in the code. Orange is the current change, and Blue is all changes. The Erase icon will clear all the changes shown.

Select and copy code from this pane using [Ctrl]+[c] keys or using the right-click menu option. The context menu has additional commands.

Use the Search feature to highlight instances of specific terms. Use the Find Next button to jump to the next search term.

Use the Toggle Word Wrap feature to fit long lines of code into the pane.

Notes pane

The Notes pane displays when you click the Pencil icon for any enabled resource. You can enter a note for a disabled resource.

Use the Search feature to find instances of specific terms in the note.

Use the Find Next button to jump to the next matching search term.

Use the Toggle Word Wrap feature to fit longer lines of text inside the pane.

Right-click inside the pane to view the context menu:

Last updated on