How it Works
NXP
Loading...
GSMCUXCTUG
User Manual
143 pgs5.79 Mb0
Table of contents
Loading...

NXP GSMCUXCTUG User Manual

NXP Semiconductors Document identifier: GSMCUXCTUG
User's Guide Rev. 0, 1/2021
User Guide for MCUXpresso Config Tools (Desktop)
NXP Semiconductors

Contents

Chapter 1 Introduction........................................................................................... 5
1.1 Versions.....................................................................................................................................5
1.2 Tools localization.......................................................................................................................6
Chapter 2 User Interface ......................................................................................7
2.1 Start Development wizard......................................................................................................... 7
2.2 Creating, saving, and opening a configuration.......................................................................... 7
2.2.1 Creating a new configuration...................................................................................................... 8
2.2.1.2 Creating a new toolchain configuration........................................................................................10
2.2.1.3 Creating a new standalone configuration.....................................................................................10
2.2.2 Saving a configuration...............................................................................................................11
2.2.3 Opening an existing configuration.............................................................................................12
2.2.4 User templates.......................................................................................................................... 12
2.2.5 Importing sources......................................................................................................................14
2.2.5.1 Importing configuration................................................................................................................ 15
2.2.5.2 Importing registers....................................................................................................................... 16
2.2.6 Restoring configuration from source code................................................................................ 19
2.3 Menu bar................................................................................................................................. 19
2.4 Toolbar.................................................................................................................................... 21
2.4.1 Config Tools Overview.............................................................................................................. 22
2.4.2 Show Problems View................................................................................................................ 22
2.4.3 Update code..............................................................................................................................22
2.4.4 Functional groups......................................................................................................................25
2.4.4.1 Functional group properties......................................................................................................... 25
2.4.5 Undo/Redo actions....................................................................................................................28
2.4.6 Selecting the tools.....................................................................................................................28
2.5 Status bar................................................................................................................................ 28
2.6 Preferences............................................................................................................................. 28
2.6.1 Appearance...............................................................................................................................30
2.7 Configuration preferences....................................................................................................... 32
2.8 Problems view......................................................................................................................... 34
2.9 Registers view......................................................................................................................... 34
2.10 Log view................................................................................................................................ 36
2.11 Config tools overview............................................................................................................ 36
Chapter 3 Pins Tool............................................................................................. 38
3.1 Pins routing principle............................................................................................................... 38
3.1.1 Beginning with pin/internal signal selection...............................................................................38
3.1.2 Routing of peripheral signals.....................................................................................................39
3.2 Example workflow....................................................................................................................44
3.3 User interface.......................................................................................................................... 47
3.3.1 Pins view................................................................................................................................... 48
3.3.2 Package view............................................................................................................................ 49
3.3.3 Peripheral Signals view.............................................................................................................52
3.3.4 Routing Details view..................................................................................................................55
3.3.5 Expansion Header.....................................................................................................................57
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 2 / 143
NXP Semiconductors
Contents
3.3.6 Power groups............................................................................................................................ 63
3.3.7 Highlighting and color coding.................................................................................................... 64
3.4 Errors and warnings................................................................................................................ 66
3.4.1 Incomplete routing.....................................................................................................................66
3.5 Code generation......................................................................................................................67
3.6 Using pins definitions in code..................................................................................................68
Chapter 4 Clocks Tool......................................................................................... 69
4.1 Features.................................................................................................................................. 69
4.2 User interface.......................................................................................................................... 69
4.3 Details view............................................................................................................................. 70
4.4 Clock Consumers view............................................................................................................71
4.5 Clocks diagram........................................................................................................................71
4.5.1 Mouse actions in diagram......................................................................................................... 72
4.5.2 Color and line styles..................................................................................................................73
4.5.3 Clock model structure............................................................................................................... 73
4.6 Clock configuration..................................................................................................................75
4.7 Global settings.........................................................................................................................75
4.8 Clock sources..........................................................................................................................76
4.9 Setting states and markers......................................................................................................76
4.10 Frequency settings................................................................................................................ 77
4.10.1 Pop-up menu commands........................................................................................................ 78
4.10.2 Frequency precision................................................................................................................78
4.11 Dependency arrows...............................................................................................................78
4.12 Troubleshooting problems.....................................................................................................78
4.13 Code generation....................................................................................................................79
4.13.1 Working with the code.............................................................................................................80
Chapter 5 Peripherals Tool.................................................................................. 81
5.1 Features.................................................................................................................................. 81
5.2 Basic terms and definitions......................................................................................................81
5.3 Workflow..................................................................................................................................81
5.4 User interface.......................................................................................................................... 82
5.4.1 Toolbar (Peripherals)................................................................................................................ 83
5.4.2 Components view......................................................................................................................84
5.4.3 Peripherals view........................................................................................................................87
5.4.4 Settings Editor...........................................................................................................................87
5.4.5 Documentation view..................................................................................................................91
5.5 Problems................................................................................................................................. 92
5.6 Code generation......................................................................................................................92
Chapter 6 Device Configuration Tool...................................................................95
6.1 Device Configuration Data (DCD) view................................................................................... 95
6.1.1 Device Configuration Data (DCD) view actions........................................................................ 95
6.2 Code generation......................................................................................................................96
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 3 / 143
NXP Semiconductors
Contents
Chapter 7 Trusted Execution Environment Tool.................................................. 98
7.1 AHB with security extension-enabled devices.........................................................................99
7.1.1 User Memory Regions view...................................................................................................... 99
7.1.2 Security Access Configuration view........................................................................................ 101
7.1.3 Memory attribution map.......................................................................................................... 110
7.1.4 Access Overview.....................................................................................................................113
7.1.5 Code generation......................................................................................................................114
7.2 RDC-enabled devices............................................................................................................115
7.2.1 User Memory Regions view.................................................................................................... 115
7.2.2 Security Access Configuration view........................................................................................ 116
7.2.2.1.1 RDC Masters.............................................................................................................. 116
7.2.2.1.2 Memory Regions.........................................................................................................118
7.2.2.1.3 Peripherals..................................................................................................................119
7.2.2.2.1 MPU............................................................................................................................ 120
7.2.2.2.2 Domains......................................................................................................................122
7.2.2.2.3 Masters....................................................................................................................... 122
7.2.2.2.4 Peripherals..................................................................................................................124
7.2.2.2.5 Memory Regions.........................................................................................................126
7.2.2.2.6 Memory Slots.............................................................................................................. 127
7.2.3 Memory Attribution Map.......................................................................................................... 129
7.2.4 Access Overview.....................................................................................................................131
7.2.5 Domains Overview.................................................................................................................. 132
7.2.6 Code generation......................................................................................................................133
Chapter 8 Advanced Features........................................................................... 135
8.1 Switching the processor ....................................................................................................... 135
8.2 Exporting the Pins table.........................................................................................................136
8.3 Tools advanced configuration................................................................................................137
8.4 Generating HTML reports......................................................................................................137
8.5 Exporting sources..................................................................................................................137
8.6 Exporting registers.................................................................................................................139
8.7 Managing data and working offline........................................................................................139
8.7.1 Working offline........................................................................................................................ 139
8.7.2 Downloading data................................................................................................................... 139
8.7.3 Exporting data......................................................................................................................... 140
8.7.4 Importing data......................................................................................................................... 140
8.7.5 Updating data..........................................................................................................................140
Chapter 9 Support..............................................................................................142
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 4 / 143
NXP Semiconductors
Chapter 1 Introduction
The MCUXpresso Config Tools set is a suite of evaluation and configuration tools that help you from initial evaluation to production software development. Following tools are included:
Table 1. MCUXpresso Config Tools
Name Description
Pins Tool
Clocks Tool
Peripherals Tool Enable you to configure the initialization for the MCUXpresso SDK drivers.
Device Configuration Tool
TEE Tool Enables you to configure security policies of memory areas, bus masters, and peripherals, in order to
Enables you to configure the pins of a device. Pins tool enables you to create, inspect, change, and modify any aspect of the pin configuration and muxing of the device.
Enables you to configure initialization of the system clock (core, system, bus, and peripheral clocks) and generates the C code with clock initialization functions and configuration structures.
Enables you to generate a Device Configuration Data (DCD) image using the format and constrains specified in the Boot ROM reference manual.
isolate and safeguard sensitive areas of your application.

1.1 Versions

The suite of these tools is called MCUXpresso Config Tools. These tools are provided as an online Web application or as a desktop application or as integrated version in MCUXpresso IDE.
NOTE The desktop version of the tool contacts the NXP server and fetches the list of the available processors. Once used,
the processors data is retrieved on demand.
TIP To use the desktop tool in the offline mode, create a configuration for the given processor while online. The tool will
then store the processors locally in the user folder and enable faster access and offline use. Otherwise, it is possible
to download and export the data using the Export menu.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 5 / 143
NXP Semiconductors
Introduction
Figure 1. Desktop version of Pins tool

1.2 Tools localization

MCUXpresso Config Tools are available in English and Simplified Chinese only.
The locale of MCUXpresso Config Tools automatically copies the global settings of your computer.
To set the locale manually, add the following parameter to the command line:
tools.exe -nl zh
You can also set the locale in the tools.ini file by adding the following line:
-Duser.language=zh
NOTE Setting your system locale to Chinese will automatically launch the tool with localized Chinese menu items, tool
tips, and help. You may need to delete the
items may be cached.
[home_dir]/.nxp
folder after switching languages because some menu
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 6 / 143
NXP Semiconductors
Chapter 2 User Interface

2.1 Start Development wizard

Upon starting MCUXpresso Config Tools, you are automatically welcomed by a startup wizard. With this wizard, you can create a new configuration or open an existing one.
NOTE To skip the wizard on subsequent startups, select the Always open last configuration checkbox below the Open an
existing configuration option. You can also perform the same action by selecting the Automatically open previously
used configuration checkbox in Preferences.
Figure 2. Start development wizard
NOTE
The content of this wizard is similar to the wizard you open by selecting File > New in the Menu bar.

2.2 Creating, saving, and opening a configuration

In this context, configuration stands for common tools settings stored in an MEX (Microcontrollers Export Configuration) file. This file contains settings of all available toolsand can be used in both web and desktop versions.
The folder with the saved MEX file must contain exactly one project file to be able to parse the toolchain project. The file type depends on the toolchain of the project and can be one of the following:
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 7 / 143
NXP Semiconductors
User Interface
Table 2. Supported toolchain project files
Toolchain Project file
IAR EW EWP
MDK μVision UVPROJX
ARM GCC CMakeLists.txt

2.2.1 Creating a new configuration

You can create a new configuration from the Start development wizard or by selecting File > New from the Menu bar.
If you start creating your development for any NXP board or kit, we recommended you start with an MCUXpresso SDK example to create a new configuration for a board or a kit. Such configuration contains board-specific settings. If you select a processor, the configuration will be empty.
After the new configuration is created, you can continue by importing an existing configuration from an MEX file. This is useful if you already have a configuration available or if you want to reuse a previous configuration. To import an existing configuration from an MEX file, select File > Import... > Import configuration (*.mex) from the Menu bar.
2.2.1.1 Cloning an SDK example
You can create a new configuration by cloning an SDK example project for IAR Embedded Workbench, Keil μVision and/or GCC ARM Embedded (command line). The resulting project contains all source files and libraries to build the project and can be easily customized, shared or put under control version system.
SDK example cloning is supported for MCUXpresso SDK 2.2 and higher.
NOTE To be able to clone an SDK example or create a “hello_world” project, you must first download an SDK package.
For more information about SDK packages offered by NXP Semiconductors, refer to the MXUXpresso Software
Development Kit website.
NOTE
If the server is unavailable, and device data is not cached, creating the project will fail.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 8 / 143
NXP Semiconductors
User Interface
Figure 3. Cloning SDK
To clone an SDK example, do the following:
1. In the Start development wizard, select Create a new configuration based on an SDK example or hello world project. Alternatively, in the Menu bar, select File > New.
2. Click Next.
3. Specify the path to your locally-saved SDK package.
4. Choose the toolchain you want to create the project for.
5. Choose the SDK example you want to clone.
6. Specify a base project directory to save your project to.
7. Specify project name.
8. Click Finish.
You can also create a basic, minimally-customized “hello_world” project without having to select an SDK example from the package.To create a “hello_world” project, do the following:
1. In the Start development wizard, select Create a new configuration based on an SDK example or hello world project. Alternatively, in the Menu bar, select File > New.
2. Click Next.
3. Specify the path to your locally-saved SDK package.
4. Choose the toolchain you want to create the project for.
5. Select Create “hello_world”.
6. Specify a base project directory to save your project to.
7. Specify project name.
8. Click Finish.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 9 / 143
NXP Semiconductors
User Interface
2.2.1.2 Creating a new toolchain configuration
You can create a configuration for an already existing toolchain project. Once done, configuration files associated with the project will be updated directly.
MCUXpresso Config Tools currently supports the following toolchains:
• MCUXpresso IDE
• Codewarrior
• IAR Embedded Workbench
• Keil MDK uVision
• ARM GCC
To create a configuration based on an existing IDE/Toolchain project, do the following:
1. In the Start development wizard, select the Create a new configuration based on an existing IDE/Toolchain projectelect Create a new configuration based on an SDK example or hello world project. Alternatively, in the Menu bar, select File > New.
2. Click Browse.
3. Select the project file and confirm by clicking OK.
4. Click Finish.
2.2.1.3 Creating a new standalone configuration
You can create a new configuration that isn’t part of any toolchain project.
You can later include this configuration in a project by saving the configuration (MEX) file in the toolchain project folder.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 10 / 143
NXP Semiconductors
User Interface
Figure 4. Creating a new configuration
To create a standalone configuration, do the following:
1. In the Start development wizard select Create new standalone configuration for processor, board or kit. Alternatively, in the Menu bar, select File > New.
2. Click Next.
3. Select the processor, board, or kit from the list.
NOTE If you’re working offline, you will only see locally-saved options. For more information, see the Working
offline section.
4. Name your configuration. Optionally, you can select processor package, core, and SDK version.
5. Click Finish.

2.2.2 Saving a configuration

To save your configuration for future use, select File>Save from the Menu bar.
To save a back-up of your configuration, do the following:
1. In the Menu bar, select File>Save Copy As.
2. In the dialog, specify the name and destination of the configuration.
3. Click Save.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 11 / 143
NXP Semiconductors
User Interface
The folder with the saved MEX file must contain exactly one project file to be able to parse the toolchain project. The file type depends on the toolchain of the project and can be one of the following:
Table 3. Supported toolchain project files
Toolchain Project file
IAR EW EWP
MDK μVision UVPROJX
ARM GCC CMakeLists.txt

2.2.3 Opening an existing configuration

To open an already existing configuration, do the following:
1. In the Start development wizard, select Open an existing configuration. Alternatively, in the Menu bar, select File > Open.
2. Click Browse to navigate to your configuration file.
3. Select the configuration file and click Open.
4. Optionally, select Always open last configuration to skip the Start development wizard and load the last-saved configuration by default.

2.2.4 User templates

You can export and store the current configuration as a user template for later use as a reference configuration file.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 12 / 143
NXP Semiconductors
User Interface
Figure 5. Export template
The exported template is available in the New Configuration wizard and can be used to create a new configuration. You can also define custom labels for pins or identifiers prefixes for #define in generated code. You can export the configuration by selecting, in the Menu bar, File > Export > Tools Configuration > Export Configuration as Template.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 13 / 143
NXP Semiconductors
User Interface
Figure 6. Create a new configuration from the template
NOTE The templates are stored in at the following location on your local hard disk: {$user}/.nxp/{tools_folder}/
{version}/templates.

2.2.5 Importing sources

To import source code files, do the following:
1. In the Menu bar, select File > Import....
2. From the list, select MCUXpresso Config Tools>Import Source.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 14 / 143
NXP Semiconductors
User Interface
Figure 7. Import Source wizard
3. Click Next.
4. On the next page, click Browse to specify the location of the source file.
5. Select the source file you wish to import and click Open.
6. On the next page, select which functional groups to import (based on tools) by selecting the checkbox in the left column.
7. Define how to import the functional groups by selecting one of the two available options in the dropdown menu in the right column:
• Rename – All files are merged into the current configuration. It imports all the functions only. If the imported function has the same name as an existing one, it is automatically renamed to the indexed one. For example, if BOARD_InitPins already exists in the configuration then the imported function is renamed to BOARD_InitPins1.
• Overwrite – All files are merged into the current configuration. It imports all the functions only. If the imported function has the same name as an existing one, then the existing one is replaced with the imported one.
8. Click Finish.
NOTE Only C files with valid YAML configuration can be imported. It imports the configuration only, then the whole C file
is re-created based on this setting. The rest of the C and DTSI files are ignored.
2.2.5.1 Importing configuration
To import an existing configuration from an MEX file, do the following:
1. In the Menu bar, select File > Import...>.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 15 / 143
NXP Semiconductors
User Interface
2. In the Import wizard, select MCUXpresso Config Tools > Import configuration (*.mex).
3. Click Next.
4. On the next page, click Browse to specify the location of the registers file.
5. Select the MEX file you wish to import and click Open.
6. On the next page, select which functional groups to import (based on tools) by selecting the checkbox in the left column.
7. Define how to import the functional groups by selecting one of the two available options in the dropdown menu in the right column:
• Rename – All files are merged into the current configuration. It imports all the functions only. If the imported function has the same name as an existing one, it is automatically renamed to the indexed one. For example, if BOARD_InitPins already exists in the configuration then the imported function is renamed to BOARD_InitPins1.
• Overwrite – All files are merged into the current configuration. It imports all the functions only. If the imported function has the same name as an existing one, then the existing one is replaced with the imported one.
8. Click Finish.
Figure 8. Import configuration
2.2.5.2 Importing registers
You can import register configuration from a processor memory dump.
NOTE
Currently, register configuration can be imported into the Clocks tool only.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 16 / 143
NXP Semiconductors
A processor memory-dump file in the CSV or S19 format is required for importing register configuration.
Figure 9. Import Registers
NOTE
User Interface
To import register configuration, do the following:
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 17 / 143
NXP Semiconductors
User Interface
1. In the Menu bar, select File > Import…. Alternatively, click the Import Registers Configuration button in the Registers view, or drag-and-drop the memory dump file anywhere in the Registers view area.
Figure 10. Import Registers Configuration
2. In the Import wizard, select MCUXpresso Config Tools > Import Registers.
3. Click Next.
4. On the next page, click Browse to specify the location of the registers configuration.
5. Select the registers file you wish to import, and click OK.
6. By default, the imported register configuration will overwrite the existing functional group. If you want a new functional group to be created instead, select the Create new functional group option button, and specify the functional group name.
7. Click Finish.
NOTE All registers are imported from the dump file regardless of their relevance to clock configuration, therefore, the list
can contain registers not needed by the Clocks tool.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 18 / 143
NXP Semiconductors
User Interface

2.2.6 Restoring configuration from source code

The generated code contains information about the Clocks tool settings that are used in the tool (block within a comment in YAML format).
The following is an example of the settings information in the generated source code.
Figure 11. Setting Information in the source code
If this information is not corrupted, it's possible to re-import the clock settings into the tool using the following steps.
1. In the Menu bar, select File > Import….
2. From the list, select MCUXpresso Config Tools > Clocks Tool > Import Source Files.
3. Click Next.
4. Click Browse.
5. Navigate and select the
6. If the settings parse successfully, clock configurations are added into the current global configuration.
clock_config.c
file previously produced by the Clocks tool.

2.3 Menu bar

The Menu bar contains five menus: File, Edit, Tools, Views, Help and a tool-specific menu.
The File menu contains file management items.
Table 4. File menu
Menu item Description
New... Create a new configuration. For more information, see the Configuration section.
Open Open a configuration from an MEX file.
Save Save current configuration.
Save Copy As... Create a backup copy of the current configuration.
Table continues on the next page...
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 19 / 143
NXP Semiconductors
User Interface
Table 4. File menu (continued)
Menu item Description
Switch processor Switch to a different processor. For more information, see the Switching processor section.
Switch package Switch to a different processor package. For more information, see the Switching
processor section.
Select Core Select a processor core for further configuration.
Data Manager Manage local data. For more information, see the Managing data and working offline section.
Import... Import settings from source files. For more information, see the Advanced Features section.
Export... Export source files and other tool information. For more information, see the Advanced
Features section.
Exit Exit the application. If there are any unsaved changes, you are prompted to save the changes.
The Edit menu contains basic editing actions as well as items modifying the appearance and behavior of the whole framework.
Table 5. Edit menu
Menu item Description
Open Update Code Dialog Update code after configuration change. For more information, see the
Update code section.
Undo (...) Cancel a previous action. The action to be undone is always appended.
Redo (...) Cancel a previous undo action. The action to be redone is always appended.
Copy Copy the selected text to the clipboard.
Select All Select the whole text in the current field/view.
Call from default initialization function Set the currently selected functional group to be called from the default
initialization function.
Functional Group Properties Edit functional group properties.
Preferences Edit preferences. For more information, see the Preferences section.
Configuration Preferences Edit configuration preferences. For more information, see the Configuration
Preferences section.
The Tools menu lists all the tools available in the tools framework. Use this menu to switch between the tools.
The Tool-specific menu contains items tailor-made for individual tools. Only items pertinent to the currently active tool are displayed. The menu name copies the name of the currently active tool.
Table 6. Tool-specific menu
Item Description
Functional Groups Open the Functional group properties window.
Refresh Refresh both the generated code and the whole GUI.
Reset to Board Defaults Reset the configuration of the Board/Kit defaults.
Reset to Processor Defaults Reset the configuration of the processor's defaults.
Table continues on the next page...
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 20 / 143
NXP Semiconductors
User Interface
Table 6. Tool-specific menu (continued)
Item Description
Automatic Routing (Pins) Attempt to resolve routing issues. Opens the Automatic Routing dialog,
which displays routing issues that have been resolved and those which require manual correction.
Apply Expansion Board (Pins) Apply an expansion board to an already created expansion header
Unlock All Settings (Clocks) Unlock all currently active locks.
Unlock Settings on the Active Path (Clocks) Unlock all settings on the selected path.
Global Settings (Peripherals) Open a tab aggregating global settings of all configuration sets.
Open dialog to customize initialization
Open a dialog for customization of peripheral initialization order.
order (Peripherals)
Clear All Commands (Device Configuration) Remove all entered commands.
The Views menu contains a tool-specific list of available views. Select a view from the list to open it. Select an already opened view to highlight it. Choose Reset views to reset the current tool perspective to its default state.
The Help menu contains assistance and general information-related items.
Table 7. Help menu
Item Description
Contents Display the User Guide.
Quick Start guide Open a PDF file of the Quick Start guide.
Release Notes Display release notes of the installed version.
Community Display web pages of the product-related community forums.
Processor Information Display web pages containing information about the currently
used processor.
Kit/Board Information Display web pages containing information about the currently
used board or kit.
Open SDK API Display documentation of the relevant SDK API.
Check for updates Check for a newer version of the product. If a new version
is available, you are promopted to confirm and perform the update
Open Cheat Sheet Display a cheat sheet to help with using the tools. You can also
load a cheat sheet from a file, or from a URL.
About Display general product information.

2.4 Toolbar

The toolbar is located on the top of the window and includes buttons/menus of frequently used actions common to all tools. See the following sections for more information.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 21 / 143
NXP Semiconductors
User Interface
Table 8. Toolbar
Item Description
Config Tools Overview Open the Overview dialog with information about currently-used tools.
Show Problems View Open the Problems view.
Update Code Open the update dialog allowing you to update generated peripheral initialization code
directly within specified toolchain project.
Functional group selection Select functional group. Functional group in the Peripherals tool represents a group
of peripherals that are initialized as a group. The tool generates a C function for each function group that contains the initialization code.
Call from default initialization Set the current functional group to be initialized by the default initialization function.
Functional group properties Open the Functional group properties dialog to modify name and other properties of
the function group.
Tool selection Display icons of individual tools. Use them to switch between tools.
Undo/Redo Undo/Redo last action.
In addition, the toolbar may contain additional items depending on the selected tool. See the chapters dedicated to individual tools for more information.

2.4.1 Config Tools Overview

Click the Config Tools Overview button to open Config Tools Overview and inspect information about the configuration, hardware, and project. For more information, see the Config Tools Overview section.

2.4.2 Show Problems View

Click the Show Problems View to open/highlight the Problems view and inspect any errors in your configuration. See Problems
view for more information.
Button color depends on issue type. Red indicates the presence of at least one error, yellow indicates the presence of at least one warning.

2.4.3 Update code

To update the generated code in the related toolchain project, click the Update Code button. In the window, select the tools or files you want to update. If the file is updated automatically, the button is filled with a black square. The reason is displayed in the tooltip.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 22 / 143
NXP Semiconductors
User Interface
Figure 12. Update Files window
To inspect the code difference between the versions, click the change link.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 23 / 143
NXP Semiconductors
User Interface
Figure 13. Show differences
To update the project without opening the Update Files dialog, deselect the Always show details before Update Code checkbox.
To access the Update Code dialog from the Update Code dropdown menu, select Open Update Code Dialog.
Figure 14. Update Code dropdown menu
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 24 / 143
NXP Semiconductors
User Interface
NOTE
The generated code is always overwritten.
NOTE
Before the current file is overwritten, it's copied with a BAK extension.
The Update Code action is enabled under following conditions:
• MEX configuration file is saved locally
• If the MEX configuration is saved in a toolchain project, the processor selected in the tool matches with processor selected in the toolchain project
• Core is selected (for multicore processors)

2.4.4 Functional groups

Every Pins/Clocks/Peripherals configuration can contain several functional groups.
These groups represent functions which will be generated into source code. Use the dropdown menu to switch between functional groups and configure them.
Figure 15. Functional groups
You can use two additional buttons to further configure functional groups:
Table 9. Functional Groups
Icon Description
Toggle "Called from default initialization function" feature (in source code)
Opens the Functional group properties window
NOTE
Red/orange background indicates errors/warnings in the configuration.
2.4.4.1 Functional group properties
In the Functional Group Properties window, you can configure several options for functions and code generation. Each settings is applicable for the selected function. You can specify generated function name, select core (for multicore processors only) that is affecting the generated source code, or write function description (this description will be generated in the C file). You can also add, copy, and remove functional groups as needed.
Aside from name and description, you can choose to set the following parameters for selected functional groups:
• Set custom #define prefix - Enable to use the specified prefix for the identifiers in the source code. You can also modify the functions order (on the left), the order is applied in the generated code.
NOTE
Not all processors support this option.
• Called from default initialization function - Enable to call the function is called from the default initialization function.
• Clock gate enable
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 25 / 143
NXP Semiconductors
User Interface
Figure 16. Functional group properties for the Pins tool
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 26 / 143
NXP Semiconductors
User Interface
Figure 17. Functional group properties for the Clocks tool
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 27 / 143
NXP Semiconductors
User Interface
Figure 18. Functional group properties for Peripherals Tool

2.4.5 Undo/Redo actions

You can reverse your actions by using Undo/Redo buttons available in the Toolbar. You can also perform these actions from the Edit menu in the Menu bar.
Table 10. Undo/reto actions
Icon Description
Cancels the previous action
Cancels the previous undo action

2.4.6 Selecting the tools

Buttons on the extreme right-hand side of the toolbar represent available tools. Click the icons to quickly navigate between Pins, Clocks, Peripherals, Device Configuration, and TEE tools.

2.5 Status bar

The status bar is visible at the bottom part of the GUI. Status bar indicates error and warning state of the currently selected functional group.

2.6 Preferences

To configure preferences in the Preferences dialog, select Edit>Preferences from the Menu bar.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 28 / 143
NXP Semiconductors
NOTE
You can restore settings to default by selecting Restore Defaults in the lower right corner of the dialog.
User Interface
Figure 19. Preferences
Several settings are available.
Table 11. Preferences
Item Description
Line ending style Select between Windows (CR + LF), Linux/Mac (LF), or Default
(based on host).
Generate files read-only Prevent modifying the source files unintentionally. Generated
source files are marked as read-only.
Generate source folder At build time, automatically create a folder including
source files.
Create empty configuration if no yaml is available Generates a configuration even if no yaml is present.
Table continues on the next page...
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 29 / 143
NXP Semiconductors
User Interface
Table 11. Preferences (continued)
Item Description
Always overwrite files without asking Update existing files automatically, without prompting.
Always show details before Update Code Review changes before the project is updated.
Undo history size Enter the maximum number of steps that can be undone. Enter
0 to disable.
Proxy connection
• Direct – Connect directly and avoid a proxy connection.
• Native – Use system proxy configuration for network connection.
NOTE The proxy settings are copied from operating
system settings. In case of error, you can specify
proxy information in the tools.ini file, located in the
<install_dir>/bin/ folder. Make sure the file contains
the following lines:
— Djava.net.useSystemProxies=true (already
present by default)
— Dhttp.proxyHost=<somecompany.proxy.net>
— Dhttp.proxyPort=80
NOTE
Authentication is
not supported.
Work Offline Disable both the connection to NXP cloud and the download of
processor/board/kit data.
Processor data update Select from the following options:
• Auto Update – Update the processor data automatically.
• Manual – Update processor data after confirmation.
• Disabled – Disable processor data update.
Show pin label & identifier table columns (Pins tool) Select to show the pin label and the label identifier in the
relevant views.
Show Overview window on opening configuration for the first time
Open the Overview dialog on opening configuration for the first time.
Help us to improve the tool Send device-configuration and tool-use information to NXP.
Sending this information to NXP helps fix issues and improve the tools
Automatically load last configuration on startup Avoid the startup window and load the last used
configuration instead.

2.6.1 Appearance

In the Appearance window, you can configure the look and feel of the user interface.
User Guide for MCUXpresso Config Tools (Desktop), Rev. 0, 1/2021
User's Guide 30 / 143
Loading...
+ 113 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use