mcuxpresso 配置工具用户指南（桌面版）这些工具套件称为mcuxpresso...

恩智浦半导体文档编号：GSMCUXCTUG

用户指南第 0 版，2019 年 11 月

MCUXpresso 配置工具用户指南（桌面版）

目录

MCUXpresso 配置工具用户指南（桌面版），第 0 版，2019 年 11 月

2 恩智浦半导体

目录

第 1 章简介 ........................................................................................................... 5 1.1 版本 ...................................................................................................................................................................... 5 1.2 工具本地化 ............................................................................................................................................................ 6

第 2 章用户界面 ................................................................................................... 7 2.1 开始开发窗口 ........................................................................................................................................................ 7 2.2 创建、保存和打开配置........................................................................................................................................... 7

2.2.1 新建配置 .................................................................................................................................................... 8 2.2.1.1 克隆 SDK 示例.................................................................................................................................. 8 2.2.1.2 新建工具链配置 ................................................................................................................................ 9 2.2.1.3 新建单独配置 ................................................................................................................................... 9

2.2.2 保存配置 .................................................................................................................................................. 10 2.2.3 打开现有配置 ............................................................................................................................................11 2.2.4 用户模板 ...................................................................................................................................................11 2.2.5 导入源 ...................................................................................................................................................... 12

2.2.5.1 导入配置 ........................................................................................................................................ 13 2.2.5.2 导入寄存器 ..................................................................................................................................... 14

2.2.6 使用源代码恢复配置 ................................................................................................................................. 16 2.3 主菜单 ................................................................................................................................................................. 17 2.4 工具栏 ................................................................................................................................................................. 19

2.4.1 选择工具 .................................................................................................................................................. 19 2.4.2 配置工具概述 ........................................................................................................................................... 19 2.4.3 显示问题视图 ........................................................................................................................................... 19 2.4.4 更新代码 .................................................................................................................................................. 19 2.4.5 功能组 ...................................................................................................................................................... 22

2.4.5.1 功能组属性 ..................................................................................................................................... 22 2.4.6 撤销/重做操作 .......................................................................................................................................... 25

2.5 状态栏 ................................................................................................................................................................. 25 2.6 首选项 ................................................................................................................................................................. 25

2.6.1 外观 ......................................................................................................................................................... 27 2.7 配置首选项 .......................................................................................................................................................... 29 2.8 问题视图 ............................................................................................................................................................. 30 2.9 寄存器视图 .......................................................................................................................................................... 31 2.10 日志视图 ........................................................................................................................................................... 33 2.11 配置工具概述 ..................................................................................................................................................... 33

第 3 章引脚工具 ................................................................................................. 35 3.1 引脚路由原理 ...................................................................................................................................................... 35

3.1.1 从外设选择开始 ........................................................................................................................................ 35 3.1.2 从引脚/内部信号选择开始 ......................................................................................................................... 36

3.2 工作流程 ............................................................................................................................................................. 36 3.3 用例 .................................................................................................................................................................... 37 3.4 用户界面 ............................................................................................................................................................. 39

3.4.1 功能 ......................................................................................................................................................... 40 3.4.2 封装 ......................................................................................................................................................... 41 3.4.3 路由的引脚视图 ........................................................................................................................................ 43

3.4.3.1 视图控件 ........................................................................................................................................ 43

目录


恩智浦半导体 3

3.4.3.2 过滤路由的引脚 .............................................................................................................................. 44 3.4.4 外设信号视图 ........................................................................................................................................... 45 3.4.5 引脚视图 .................................................................................................................................................. 47 3.4.6 标签和标识符 ........................................................................................................................................... 48 3.4.7 引脚视图和外设信号视图中的过滤功能 ..................................................................................................... 49 3.4.8 高亮显示和颜色编码 ................................................................................................................................. 50

3.5 错误和警告 .......................................................................................................................................................... 52 3.5.1 不完整路由 ............................................................................................................................................... 52

3.6 代码生成 ............................................................................................................................................................. 53

第 4 章时钟工具 ................................................................................................. 55 4.1 功能 .................................................................................................................................................................... 55 4.2 用户界面概述 ...................................................................................................................................................... 55 4.3 时钟配置 ............................................................................................................................................................. 56 4.4 时钟菜单 ............................................................................................................................................................. 57 4.5 全局设置 ............................................................................................................................................................. 57 4.6 时钟源 ................................................................................................................................................................. 57 4.7 设置状态和标记 ................................................................................................................................................... 57 4.8 频率设置 ............................................................................................................................................................. 58

4.8.1 弹出菜单命令 ........................................................................................................................................... 59 4.8.2 频率精度 .................................................................................................................................................. 59

4.9 依赖关系箭头 ...................................................................................................................................................... 59 4.10 详情视图 ........................................................................................................................................................... 59 4.11 时钟框图 ............................................................................................................................................................ 61

4.11.1 框图中的鼠标操作 ................................................................................................................................... 61 4.11.2 颜色和线条样式 ...................................................................................................................................... 62 4.11.3 时钟模型结构 .......................................................................................................................................... 62

4.12 时钟消耗件视图 ................................................................................................................................................. 64 4.13 故障排除 ........................................................................................................................................................... 65 4.14 代码生成 ........................................................................................................................................................... 66

4.14.1 使用代码 ................................................................................................................................................ 67

第 5 章外设工具 ................................................................................................. 68 5.1 功能 .................................................................................................................................................................... 68 5.2 基本术语和定义 ................................................................................................................................................... 68 5.3 工作流程 ............................................................................................................................................................. 68 5.4 用户界面概述 ...................................................................................................................................................... 69 5.5 常用工具栏 .......................................................................................................................................................... 69 5.6 文档视图 ............................................................................................................................................................. 70 5.7 外设视图 ............................................................................................................................................................. 71 5.8 组件视图 ............................................................................................................................................................. 72 5.9 设置编辑器 .......................................................................................................................................................... 74

5.9.1 快速选择 .................................................................................................................................................. 74 5.9.2 设置 ......................................................................................................................................................... 74 5.9.3 设置编辑器标头 ........................................................................................................................................ 76

5.10 问题 .................................................................................................................................................................. 76 5.11 代码生成 ............................................................................................................................................................ 77

第 6 章设备配置工具 .......................................................................................... 79 6.1 设备配置数据 (DCD) 视图 .................................................................................................................................. 79

6.1.1 设备配置数据 (DCD) 视图操作 ................................................................................................................ 79 6.2 代码生成 ............................................................................................................................................................. 80

目录



第 7 章可信执行环境工具 ................................................................................... 82 7.1 用户内存区域 ...................................................................................................................................................... 82 7.2 安全访问配置视图 ............................................................................................................................................... 84

7.2.1 主机/从机 ................................................................................................................................................. 85 7.2.2 MPC ......................................................................................................................................................... 86 7.2.3 中断 ......................................................................................................................................................... 88 7.2.4 引脚 ......................................................................................................................................................... 90 7.2.5 SAU .......................................................................................................................................................... 91 7.2.6 其他 ......................................................................................................................................................... 93

7.3 内存属性映射 ...................................................................................................................................................... 94 7.3.1 内核 0 ...................................................................................................................................................... 95 7.3.2 其他主机 .................................................................................................................................................. 96

7.4 访问概述 ............................................................................................................................................................. 98 7.5 代码生成 ........................................................................................................................................................... 100

第 8 章高级功能 ............................................................................................... 101 8.1 切换处理器 ........................................................................................................................................................ 101 8.2 导出引脚表格 .................................................................................................................................................... 102 8.3 工具高级配置 .................................................................................................................................................... 103 8.4 生成 HTML 报告 ................................................................................................................................................ 103 8.5 导出源文件 ........................................................................................................................................................ 103 8.6 导出寄存器 ........................................................................................................................................................ 104 8.7 命令行运行 ........................................................................................................................................................ 105

8.7.1 命令行运行 — 引脚工具 ........................................................................................................................ 107 8.7.2 命令行运行 — 时钟工具 ........................................................................................................................ 108 8.7.3 命令行运行 — 外设工具 ........................................................................................................................ 109 8.7.4 命令行运行 — 项目克隆器 ...................................................................................................................... 110

8.8 管理数据和离线工作 ........................................................................................................................................... 110 8.8.1 离线工作 ................................................................................................................................................. 111 8.8.2 下载数据 ................................................................................................................................................. 111 8.8.3 导出数据 ................................................................................................................................................. 111 8.8.4 导入数据 ................................................................................................................................................. 112 8.8.5 更新数据 ................................................................................................................................................. 112

第 9 章支持 ....................................................................................................... 113

版本



第 1 章简介 MCUXpresso 配置工具集是一套评估和配置工具，可帮助您完成从首次评估到生产软件开发的流程。该工具集包

括以下工具：

表 1. MCUXpresso 配置工具

名称说明

引脚工具可用于配置器件引脚。引脚工具可用于创建、检查、更改和修改器件的引脚配置和多路复用各个

方面。

时钟工具可用于配置系统时钟（内核、系统、总线和外设时钟）的初始化，并利用时钟初始化函数和配置

结构生成 C 代码。

外设工具可用于配置 MCUXpresso SDK 驱动器的初始化。

设备配置工具可用于利用 Boot ROM 参考手册中规定的格式和限制条件生成设备配置数据 (DCD) 图。

TEE 工具可用于配置内存区域、总线主机和外设的安全策略，以便隔离和保护应用的敏感区域。

1.1 版本这些工具套件称为 MCUXpresso 配置工具。这些工具在 MCUXpresso IDE 中作为在线网络应用或桌面应用或集成

版本提供。

备注

桌面版工具可连接恩智浦服务器，并提取可用处理器列表。使用后，可根据

需要检索处理器数据。

提示

如要在离线模式下使用桌面工具，则应在工具在线时为指定处理器创建一个

配置。然后，工具就会将处理器存储在本机用户文件夹中，实现更快速的访

问和离线使用。否则，可使用“导出”菜单下载和导出数据。

简介



图 1. 引脚工具的桌面版

1.2 工具本地化 MCUXpresso 配置工具只有英语和简体中文版。

MCUXpresso 配置工具的区域设置会自动复制电脑的全局设置。

如要手动设定区域设置，则在命令行中添加以下参数：

tools.exe -nl zh

您还可以通过添加下列行，在 tools.ini 文件中设定区域设置：

-Duser.language=zh

备注系统区域设置设定为中文将会使用本地化中文菜单项、工具提示和帮助自动

启动工具。您可能需要在切换语言后删除 [home_dir]/.nxp 文件夹，因为有

些菜单项可能已经缓存。

开始开发窗口



第 2 章用户界面 2.1 开始开发窗口启动 MCUXpresso 配置工具后，您会看到一个启动窗口。该窗口可用于新建配置，或打开已有配置。

备注

勾选“打开已有配置”下方的“总是打开最后一次配置”复选框，可禁用该

窗口。勾选“首选项”中的“自动打开先前使用的配置”复选框，也可禁用

该窗口。

图 2. 开始开发

备注该窗口的功能与从主菜单中选择“文件 > 新建”时打开的新配置窗口类似。

2.2 创建、保存和打开配置此处，配置是指存储在 MEX（微控制器导出配置）文件中的常用工具设置。MEX 文件包含所有可用工具的设置，

并可用于网络和桌面版本。

关键是在 MEX 所在的目录下正好有一个项目文件能够解析工具链项目（IAR EV 项目文件 EWP，或 MDK uVision UVPROJX 或 ARM GCC CMakeList.txt）。

用户界面



2.2.1 新建配置您可以通过“开始开发”对话框或从主菜单中选择“文件 > 新建”来新建配置。

如果您开始为恩智浦板或套件创建开发配置，则建议从 MCUXpresso SDK 示例开始，为板或套件新建配置。此类

配置包含板相关设置。如果您选择处理器，则配置将为空。

新建配置后，可以通过导入 MEX 文件中现有的配置继续操作。如果您已经有一个可用的配置，或者想要重复使用

以前的配置，这将非常有用。要导入 MEX 文件中现有的配置，请从主菜单中选择“文件 > 导入...> 导入配置 (*.mex)”。

2.2.1.1 克隆 SDK 示例您可以通过克隆 SDK 示例项目，为 IAR Embedded Workbench、Keil μVision 和/或 GCC ARM Embedded（命

令行）新建配置。生成的项目包括用于构建项目的所有源文件和库，且可以轻松地在版本系统下进行自定义、共

享或控制。

MCUXpresso SDK 2.2 及更高版本均支持 SDK 示例克隆。

备注

为了能够克隆 SDK 示例或创建“hello_world”项目，您必须先下载一个 SDK包。有关恩智浦半导体 SDK 包的更多信息，请访问 MXUXpresso 软件开发套

件网站。

图 3. 克隆 SDK

要克隆 SDK 示例，则按照下述步骤操作：

1. 在“开始开发”对话框中选择“基于 SDK 示例或 hello world 项目新建配置”选项。或者，您可以通过从

主菜单中选择“文件 > 新建”来选择该选项。

2. 单击“下一步”。

3. 指定 SDK 包的本地保存路径。

4. 选择要为其创建项目的工具链。

创建、保存和打开配置



5. 选择要克隆的 SDK 示例。

6. 指定一个用于保存项目的基本项目目录。

7. 指定项目名称。

8. 单击“完成”。

您无需从包中选择 SDK 示例也可以创建一个自定义程度最低的基本“hello_world”项目。要创建“hello_world”项目，则按照下述步骤操作：

1. 在“开始开发”对话框中选择“基于 SDK 示例或 hello world 项目新建配置”选项。或者，您可以通过从

主菜单中选择“文件 > 新建”来选择该选项。


3. 指定 SDK 包的本地保存路径。

4. 选择要为其创建项目的工具链。

5. 选择创建“hello_world”项目选项

6. 指定一个用于保存项目的基本项目目录。

7. 指定项目名称。


2.2.1.2 新建工具链配置您可以为已有工具链项目创建配置。创建配置后，将直接更新项目相关的配置文件。

备注

MCUXpresso 配置工具目前支持以下第三方工具链： • IAR Embedded Workbench • Keil MDK uVision • ARM GCC

要基于现有 IDE/工具链项目创建配置，则按照下述步骤操作：

1. 在“开始开发”对话框中选择“基于现有 IDE/工具链项目新建配置”选项。或者，您可以通过从主菜单中

选择“文件 > 新建”来选择该选项。

2. 单击“浏览”按钮导航至您的项目文件，并单击“确定”。


2.2.1.3 新建单独配置您可以新建一个不属于任何工具链项目的配置。

稍后，您可以通过将配置 (MEX) 文件保存在工具链项目文件夹中，将此配置纳入项目中。

用户界面



图 4. 新建配置

要创建单独配置，则按照下述步骤操作：

1. 从“开始开发”对话框中选择“为处理器、板或套件新建单独配置”选项。或者，您可以通过从主菜单中

选择“文件 > 新建”来选择该选项。


3. 从列表中选择处理器、板或套件。

备注

如果离线工作，您将只能看到本地保存的选项。有关更多信息，请参见“离线

工作”章节。

4. 为您的配置命名。您也可以选择处理器封装、内核和 SDK 版本。

2.2.2 保存配置要保存您的配置以备将来使用，则从主菜单中选择“文件 > 保存”。

要保存配置备份，则按照下述步骤操作：

1. 从主菜单中选择“文件 > 将副本另存为”。

2. 指定配置的名称和目标位置。

3. 单击“保存”。

关键是在 MEX 所在的目录下正好有一个项目文件能够解析工具链项目（IAR EV 项目文件 EWP，或 MDK uVision UVPROJX 或 ARM GCC CMakeList.txt）。




2.2.3 打开现有配置要打开已有配置，则按照下述步骤操作：

1. 从“开始开发”对话框中选择“打开现有配置”选项。或者，您可以通过从主菜单中选择“文件 > 打开”

来选择该选项。

2. 单击“浏览”按钮导航至您的配置文件，并单击“打开”。

3. （可选）选择“始终打开最后一次配置”以跳过“开始开发”对话框，并默认加载最后保存的配置。

2.2.4 用户模板您可以将当前配置导出并存储为参考配置，供以后用作用户模板。

图 5. 导出模板

导出的模板在“新配置”对话框中可用，且可用于新建配置。您还可以在生成的代码中为引脚或#define 的标识符

前缀定义自定义标签。在“导出”对话框中选择“工具配置 > 导出配置为模板”选项可导出配置。

用户界面



图 6. 使用模板新建配置

备注

模板存储在本地硬盘中的以下位置：

{$user}/.nxp/{tools_folder}/{version}/templates。

2.2.5 导入源要导入源代码文件：

1. 从主菜单中选择“文件 > 导入...”。

2. 选择“MCUXpresso 配置工具 > 导入源”。




图 7. 导入源向导


4. 您可以使用“导出引脚源文件”窗口中的“浏览”按钮，选择导入一个或多个 C 文件。

5. 选择如何导入文件：

• 重命名 — 所有文件均合并到当前配置中，只可以导入所有函数。如果导入的函数与现有函数的名称相

同，则会自动重命名为索引名称。例如：如果配置中已经存在 BOARD_InitPins，则导入的函数将被重命

名为 BOARD_InitPins1。

• 覆盖 — 所有文件均合并到当前配置中，只可以导入所有函数。如果导入的函数与现有函数的名称相同，

则将现有函数替换为导入的函数。


备注

只可以导入含有效 YAML 配置的 C 文件。只导入配置，然后根据该设置重新创

建整个 C 文件。剩下的*.c 和*.dtsi 文件将被忽略。

2.2.5.1 导入配置要导入 MEX 文件中现有的配置，请从主菜单中选择“文件 > 导入...> 导入配置 (*.mex)”。

选择 MEX 文件后，工具及其功能组将出现在列表中。选择一个工具，以将其包含在新配置中。如果工具支持功能

组，则会出现一个覆盖功能组的选项。该选项将清除当前的工具变更，并导入所选 MEX 文件中的变更。如果选择

了选项重命名，则会对该工具的当前功能组进行重命名，且作为默认功能组，将导入所选 MEX 文件中的更改。如

果未显示任何选项，则意味着未找到该工具的功能组，并将覆盖当前配置。

用户界面



图 8. 导入配置

2.2.5.2 导入寄存器您可以从处理器内存转储中导入寄存器配置。

备注

目前，只可将寄存器配置导入到时钟工具中。

备注

导入寄存器配置时，要求处理器内存转储文件为 CSV 或 S19 格式。

图 9. 导入寄存器




要导入寄存器配置，则按照下述步骤操作：

1. 从主菜单中选择“文件 > 导入... > 导入寄存器”。或者，单击“寄存器”视图中的“导入寄存器配置”按

钮，或将内存转储文件拖放至“寄存器”视图中的任意位置。

图 10. 导入寄存器配置

用户界面



2. 在“导入寄存器”向导中，指定寄存器配置的位置。如果想要新建功能组，则选择该选项，并指定功能

组名称。


备注

无论寄存器与时钟配置有何关联，所有寄存器都是从转储文件中导入，因此列表中可能包含时钟工

具不需要的寄存器。

2.2.6 使用源代码恢复配置生成的代码包含工具（YAML 格式注释中的模块）中使用的时钟工具设置信息。

下面是生成的源代码中的设置信息示例。

主菜单



图 11. 源代码中的设置信息

如果该信息未被损坏，则可以使用以下步骤将时钟设置重新导入到工具中。

1. 选择“文件 > 导入…”

2. 选择“时钟工具/导入源文件”。


4. 单击“浏览”。

5. 导航并选择时钟工具之前生成的 clock_config.c 文件。

6. 如果设置解析成功，时钟配置就会添加到当前全局配置中。

2.3 主菜单本节介绍 MCUXpresso 配置工具可用的常用主菜单命令。

备注

菜单可能还包含工具相关命令。有关更多信息，请参见专门介绍各个工具的章节。

文件

— 新建...— 新建配置（适用于所有工具）。有关更多信息，请参见“配置”。

— 打开 — 从 MEX 文件中打开所有工具的配置设置。

— 保存 — 保存当前配置。

— 将副本另存为...— 创建当前配置的备份副本。

— 切换处理器 — 切换至另一个处理器。有关更多信息，请参见“切换处理器”章节。

— 切换封装 — 切换至另一个处理器封装。有关更多信息，请参见“切换处理器”章节。

— 选择内核 — 选择处理器内核，以备进一步配置。

— 数据管理器 — 管理本地数据。有关更多信息，请参见“管理数据和离线工作”章节。

用户界面



— 导入...— 从源文件导入设置。有关从旧式工具中额外导入引脚和时钟配置的更多信息，请参见“高级功

能”章节。

— 导出...— 导出源文件和其他工具信息。有关从旧式工具中额外导出引脚和时钟配置的更多信息，请参见

“高级功能”章节。

— 退出 — 退出应用。如果存在任何未保存的更改，则会提示您保存更改。

编辑

— 打开更新代码对话框—配置更改后更新代码。有关更多信息，请参见“更新代码”。

— 撤销 (...)— 取消上一步操作。要撤销的操作总是附加在此项后面。

— 重做 (...)— 取消上一步撤销操作。要重做的操作总是附加在此项后面。

— 复制 — 复制选定文本至剪贴板。

— 全选 — 选择当前字段/视图中的全部文本。

— 从默认初始化函数调用 — 设置从默认初始化函数调用的当前选定的功能组。

— 功能组属性 — 编辑功能组属性。

— 首选项 — 编辑首选项。有关更多信息，请参见“首选项”章节。

— 配置首选项 — 编辑配置首选项。有关更多信息，请参见“配置首选项”章节

工具 — 列出工具框架中可用的所有工具。使用该菜单切换工具。

引脚/时钟/外设/TEE/设备配置 — 工具相关菜单包含以下部分：

— 功能组 — 打开功能组属性窗口。

— 刷新 — 刷新生成的代码和整个 GUI。

— 重置为板默认值 — 重置板/套件默认值的配置。

— 重置为处理器默认值 — 重置处理器默认值的配置。

— 自动路由（仅限引脚）— 尝试解决路由问题。打开“自动路由”窗口，显示已经解决的路由问题和需要

手动纠正的路由问题。

— 解锁所有设置（仅限时钟）— 解锁所有当前有效的时钟。

— 解锁有效路径的设置（仅限时钟）— 解锁所选路径的所有设置。

— 清除所有命令（仅限设备配置）— 移除所有已输入的命令。

视图 — 包含以下部分：

— 工具相关可用视图列表。从列表中选择视图，将其打开。选择已打开的视图，以高亮显示该视图。

— 重置视图 — 将当前工具透视图重置为默认状态。

帮助

— 内容 — 显示产品的用户指南。

— 快速入门指南 — 打开产品快速入门指南 PDF 文件。

— 发布说明 — 显示已安装版本的发布说明。

— 社区 — 显示产品相关社区论坛的网页。

工具栏



— 处理器信息 — 显示包含当前所用处理器信息的网页。

— 套件/板信息 — 显示包含当前所用板或套件信息的网页。

— 打开 SDK API — 显示相关 SDK API 的文档。

— 检查更新 — 检查产品的新版本。如果有新版本，则会提示您确认并执行更新。

— 打开备忘录 — 显示备忘录，以便于使用工具。您还可以加载来自文件或 URL 的备忘录。

— 关于 — 显示一般产品信息。

2.4 工具栏工具栏位于窗口顶部，包含常用操作的按钮/菜单。

图 12. 工具栏

2.4.1 选择工具工具栏最右侧的按钮表示可用工具。单击图标可在引脚、时钟、外设、设备配置和 TEE 工具之间快速导航。

2.4.2 配置工具概述单击“配置工具概述”按钮打开“配置工具概述”，并检查配置、硬件和项目相关信息。有关更多信息，请参见“配

置工具概述”。

2.4.3 显示问题视图单击“显示问题”视图打开/高亮显示“问题视图”，并检查配置中的所有错误。有关更多信息，请参见“问题视图”。

按钮颜色取决于问题类型。红色代表至少存在一个错误，黄色代表至少存在一个警告。

2.4.4 更新代码要更新相关工具链项目中生成的代码，则单击“更新代码”按钮。在窗口中，选择要更新的工具或文件。如果已

自动更新了文件，按钮就会用黑色方块填充。工具提示中会显示原因。

用户界面



图 13. 更新文件窗口

要检查版本之间的代码差异，则单击“更改”链接。

工具栏



图 14. 显示差异

要在不打开“更新文件”窗口的情况下更新项目，则清除“更新代码前始终显示详细信息”选项。要通过“更新

代码”下拉菜单访问“更新代码”窗口，则选择“打开更新代码对话框”。

图 15. 更新代码下拉菜单

用户界面



备注

始终覆盖生成的代码。

备注

在覆盖当前文件之前，使用 BAK 扩展名复制该文件。

在下述条件下启用“更新代码”操作：

• MEX 配置文件保存在本地

• 如果 MEX 配置保存在工具链项目中，工具中选定的处理器与工具链项目中选定的处理器相匹配

• 选择了内核（适用于多核处理器）

2.4.5 功能组每个引脚/时钟/外设配置都可包含多个功能组。

这些组表示将生成源代码的功能。使用下拉菜单在功能组之间切换，并配置功能组。

图 16. 功能组

您可以使用两个附加按钮来进一步配置功能组：

表 2.功能组

图标说明

切换“从默认初始化函数调用”功能（在源代码中）

打开“功能组属性”窗口

备注

红色/橙色背景表示配置中的错误/警告。

2.4.5.1 功能组属性在“功能组属性”窗口中，您可以配置多个用于函数和代码生成的选项。每个设置适用于所选函数。您可以指定

所生成函数的名称，选择影响所生成源代码的内核（仅限多核处理器），或写入函数说明（该说明将在 C 文件中生

成）。您还可以根据需要添加、复制和移除功能组。

除了名称和说明，您还可以选择为所选功能组设置下列参数：

• 设置自定义#define 前缀 — 允许对源代码中的标识符使用指定前缀。您还可以修改函数顺序（在左侧），

该顺序可用于生成的代码。

备注

不是所有处理器都支持该选项。

• 从默认初始化函数调用 — 支持调用从默认初始化函数调用的函数。

• 时钟门控启用

工具栏



图 17. 引脚工具的功能组属性

用户界面



图 18. 时钟工具的功能组属性

图 19. 外设工具的功能组属性

状态栏



2.4.6 撤销/重做操作您可以通过单击下述按钮还原您的操作：

表 3.撤销/重做选项

图标说明

取消上一步操作

取消上一步撤销操作

2.5 状态栏状态栏显示在 GUI 的底部。状态栏指示当前所选功能组的错误和警告状态。

2.6 首选项要配置首选项，则从主菜单中选择“编辑 > 首选项”。“首选项”窗口将打开。

备注

您可以通过选择窗口右下角的“恢复默认值”将设置恢复为默认值。

用户界面



图 20. 首选项窗口

在此窗口中，您可以进行如下设置：

• 行尾样式 — 选择“Windows (CR + LF)”、“Linux/Mac (LF)”或“默认（基于主机）”。

• 生成只读文件 — 防止意外修改源文件。生成的源文件标记为只读。

• 生成源文件夹 — 在构建之时，自动创建包含源文件的文件夹。

• 如果无可用 yaml，则创建空白配置 — 将生成一个配置，即使不存在 yaml 也会生成。

• 始终覆盖文件，无需询问 — 选择以自动更新现有文件，无需提示。

• 更新代码前始终显示详情 — 选择以在更新项目之前查看更改。

• 撤销历史操作范围 — 输入想要撤销的步骤数。输入 0 则会禁用。

• 代理连接

— 直接 — 选择以直接连接，并避免代理连接。

— 本机 — 选择以使用系统代理配置进行网络连接。

首选项



备注

代理设置可从操作系统设置中复制。如果出现错误，可在<install_dir>/bin/文件夹中

的 tools.ini 文件中指定代理信息。确保文件包含以下行： ◦ Djava.net.useSystemProxies=true（默认情况下已经存在） ◦ Dhttp.proxyHost=<somecompany.proxy.net> ◦ Dhttp.proxyPort=80

备注

不支持身份验证。

• 离线工作 — 选择以禁止连接至恩智浦云和下载处理器/板/套件数据。

• 处理器数据更新 — 从下列选项中进行选择：

— 自动更新 — 选择以自动更新处理器数据。

— 手动 — 选择以在确认后更新处理器数据。

— 禁用 — 选择以禁用处理器数据更新。

• 显示引脚标签和标识符表列（引脚工具）— 选择以在相关视图中显示引脚标签和标签标识符。

• 帮助我们改善工具 — 选择以发送设备配置和工具使用信息至恩智浦。发送该信息至恩智浦有助于修复问

题和改进工具。

• 启动时自动加载最后一次配置 — 选择以避免启动窗口，而是加载最后一次使用的配置。

2.6.1 外观在“外观”窗口中，您可以配置用户界面的观感。

用户界面



图 21. 外观

可使用下列选项：

• 启用主题（需要重启）

• 主题

• 颜色和字体主题

• 启用动画

• 标签使用的混合字体和颜色

• 显示最近使用的选项卡

此外，您还可以选择“颜色和字体”子窗口，以进一步指定界面元素的外观。

配置首选项



图 22. 颜色和字体

2.7 配置首选项在“配置首选项”窗口中，您可以设置配置存储文件 (MEX) 的首选项。要配置与配置相关的首选项，则从主菜单

中选择“编辑 > 配置首选项”。

用户界面



图 23. 配置首选项

可使用下列首选项：

• 仅验证启动初始化 — 选择仅根据“启动初始化”功能组验证工具的依赖关系。选择时，标记为默认初始

化的功能组必须满足所有工具的所有功能组的依赖关系。如果用户正在使用需在应用代码中交替功能组的复

杂场景，则清除该选项会隐藏警告。

• 生成 YAML — 选择以向 C 源文件中生成 YAML。

• 向标头文件中生成扩展信息 — 选择以向标头文件中生成扩展信息。对于在早期 MCUXpresso 版本中创建

的项目，默认选择该选项。

• 自定义源文件版权标头 — 选择以向未包含版权的已生成源文件中添加自定义版权标头。

• 仅为状态与重置后状态不同的寄存器生成代码 — 选择以便只为状态与重置后状态不同的寄存器生成代码。

对于在早期 MCUXpresso 版本中创建的项目，默认选择该选项。

警告

当源不包含 YAML 代码时，则无法导入。

2.8 问题视图该视图显示各个工具中的问题以及工具之间相互依赖关系中的问题。

寄存器视图



图 24. 问题视图

要打开“问题”视图，则单击“显示问题视图”按钮，或选择“视图 > 问题”。

该表包含以下信息：

• 级别 — 问题的严重性：信息、警告或错误。

• 问题 — 问题描述。

• 来源 — 依赖关系源相关信息。

• 目标 — 处理依赖关系及其解决方案的工具。

• 资源 — 问题相关的资源，如信号名称、时钟信号等。

• 类型 — 问题的类型。此项是检查工具之间依赖关系的验证，或是单个工具问题。

每个问题都有一个上下文菜单，可以通过右键单击表行来访问。使用该菜单访问问题相关信息，或应用快速修复

（如果适用）。您还可以右键单击行并选择“复制”或使用“Ctrl+C”快捷键来复制行，以备将来使用。您可以使

用“Ctrl+左键单击”快捷键来添加额外的行至所选项。

备注

快速修复仅适用于带有“灯泡”图标的高亮显示问题。

过滤按钮

过滤按钮在“问题”视图功能区的右侧。

•

– 启用“仅验证启动初始化”首选项。有关详细信息，请参见“配置首选项”章节。

•

– “问题”视图中的过滤消息。如果选择，则只显示有效工具的问题。有关详细信息，请参见“配置首选

项”章节。

2.9 寄存器视图 “寄存器”视图列出了工具模式处理的寄存器。您可以查看与当前配置设置相对应的处理器寄存器的状态，以及

重置后寄存器中的默认状态。寄存器值以十六进制和二进制格式显示。如果未定义寄存器（或位）值，则会显示

问号“?”而非值。

用户界面



图 25. 寄存器视图

寄存器视图包含以下部分：

• “外设过滤”下拉列表 — 用于列出所选外设的寄存器。选择“全部”以列出全部外设的寄存器。

• “仅显示已修改寄存器”复选框 — 选择该选项以隐藏处于重置后状态或未配置的寄存器。

• 文本过滤 — 用于按文本过滤内容。

下表列出了“寄存器”视图中使用的颜色高亮显示样式。

表 4.颜色码

颜色说明黄色背景表示位字段受工具中最后一次更改的影响。灰色文本颜色表示位字段未被编辑，且值为重置后的值。黑色文本表示工具修改的位字段。

备注

该视图包含所选工具的寄存器。视图将寄存器用作为内部参数，但可能不会处理代码

中需要的所有寄存器写入。寄存器写入在生成的代码调用的 SDK 函数内部完成。在设

置过程中，可能会在 SDK 代码中访问额外的寄存器，而且这种寄存器写入不为工具所

知晓，且不会显示在寄存器视图中。

日志视图



2.10 日志视图 “日志”视图显示与工具进度有关的用户特定信息。“日志”视图可按时间顺序显示所有工具的最多 100 条记录。

每条记录都是由时间戳、负责记录的工具名称、严重程度和实际消息组成。如果没有指定工具名称，则记录由共

享功能创建。

可使用组合框过滤“日志”视图的内容，以便仅显示特定工具和/或严重程度信息。不同工具的过滤功能可单

独设置。

使用清除按钮可清除缓冲日志记录。这会影响所有工具的“日志”视图。

图 26. 日志视图

2.11 配置工具概述配置工具概述提供有关当前有效配置、硬件和项目的一般信息。它还简要概述了已使用的/有效和未使用的/无效工

具、生成的代码和功能组。默认情况下，配置日志概述图标位于工具栏左侧。

创建和打开新配置时，会自动打开配置工具概述。您可以在首选项中禁用此行为。

配置工具概述包含以下选项：

• 配置 — 一般信息 — 显示当前配置的 MEX 文件名称及其路径。单击链接打开包含 MEX 文件的文件夹。

要导入额外的设置，则单击“导入额外设置至当前配置”按钮。

• 配置 — 硬件信息 — 显示当前配置的处理器、器件编号、内核和 SDK 版本信息。

• 项目 — 显示工具链项目信息。

• 引脚/时钟/外设/TEE/设备配置 — 显示引脚、时钟、外设、TEE 和设备配置工具相关的基本信息。

备注

如果您禁用了某个工具并想要重新打开该工具，则单击右上角的工具图标或从主菜单

中选择该工具。配置工具概述会自动打开。

• 要启用/禁用工具，则单击开关按钮。您可以单击工具图标导航至相应工具。此外，您还可以查看工具相关

的下述信息：

— 生成的代码 — 包含源代码文件列表。单击链接打开“代码预览”视图中的文件。

— 功能组 — 包含当前有效的功能组列表。要在工具栏中选择功能组选项卡中的组，则选择相关链接。

用户界面



要打开工具相关概述，则从主菜单中选择“视图 > 概述”。

图 27. 配置工具概述

备注

概述中不会显示不支持的工具。

引脚路由原理



第 3 章引脚工具引脚工具操作简单，可用于配置器件引脚。引脚工具软件有助于创建、检查、更改和修改引脚配置和器件复用的

任何元素。

图 28. 引脚工具

3.1 引脚路由原理引脚工具旨在配置将外设信号路由至引脚或内部信号。

内部信号是一种可连接外设信号的互连节点（无需任何引脚相互作用）。连接两个外设信号至内部引脚可使这两个

外设信号互连。

该路由配置可在以下任何一个视图中完成：

• 引脚

• 外设信号

• 封装

• 路由的引脚

以下两节介绍两种定义路由路径的方法。

3.1.1 从外设选择开始您可以在“路由的引脚”视图和“外设信号”视图中选择外设。

1. 选择外设。

2. 在“路由的引脚”视图中，选择一个可用信号，或在“外设信号”视图中展开外设。

引脚工具



3. 选择所需引脚/内部信号。

在“路由的引脚”视图，“路由至”列中的项（引脚/内部信号）具有如下修饰符：

• 感叹号和默认文本颜色表示选择该项会导致寄存器冲突，或该项无法路由至所选外设信号（可路由

至其他一些外设信号）。

• 感叹号和灰色文本颜色表示该项无法路由至所选外设的任何信号。该项可用于使用相同信号的不同

外设。

备注

“路由的引脚”视图中的“路由至”字段包含可连接至所选信号（如果适用，不带其通道）

的项。所以，当所选信号为“GPIO, 6”时，“路由至”提供可连接至“GPIO”的项。

备注

在“封装”视图中，当外设信号可连接至多个引脚/内部信号时，不可选择引脚/内部信号。

图 29. 定义路由路径

3.1.2 从引脚/内部信号选择开始您可以在“路由的引脚”视图中选择引脚或内部信号。

1. 选择引脚/内部信号（路由至）。

2. 选择一个可用外设。在“引脚视图”中，通过单击第一列中的复选框选择所有可用外设/信号，或将列滚动

至所需外设类型。

3. 针对所选外设，选择一个可用信号。

在“路由的引脚”视图中，“外设”列中的项带有如下符号：

• 感叹号和默认文本颜色表示选择该项会导致寄存器冲突，或该项不支持所选信号。

• 感叹号和灰色文本颜色表示该项无法路由至所选引脚/内部信号。该项可用于使用相同信号的不同引

脚/内部信号。

备注

在“引脚”视图和“封装”视图中，您只可以配置引脚，不可以配置内部信号。

3.2 工作流程下述步骤简要介绍引脚工具中的基本工作流程。

1. 在“引脚”视图的左侧找到表中的引脚和外设信号，并单击信号单元格来配置路由。

备注

在“外设信号”、“封装”、“路由的引脚”等其他视图中，可通过类似操作完成路由配置。

2. （可选）可在“路由的引脚”视图的中间部分选择所需状态来配置电气属性。

用例



备注

源代码会自动生成。

3. 打开“代码预览”视图，以检查源代码。

4. 通过从主菜单中选择“文件 > 导出”，导出源代码。

5. 单击工具栏中的“更新代码”按钮更新代码。

3.3 用例本节列出了创建示例引脚配置的步骤，这里创建的引脚配置随后可用于项目中。

在此例中，配置了板上的 3 个引脚（UART3_RX、UART3_TX 和 PTB20）。

您可以使用含应用代码的已生成文件。

1. 在“引脚”视图的左侧，选择 UART3_RX 和 TX 信号。为此，您可以单击单元格，使其变成“绿色”。

图 30. 引脚视图中的配置信号

2. 在中间视图中，名为“路由的引脚”的视图，选择 TX 和 PTB20 信号的输出方向。

图 31. 选择方向

引脚工具



备注

对于 GPIO 外设，您可以单击单元格并从下拉菜单中选择，以此设置“方向”。如果您选择

“输出”，您还可以单击“GPIO 初始状态”列中的单元格设置“GPIO 初始状态”。如果您

选择“输入”，您还可以单击“GPIO 中断”列中的单元格设置 GPIO 中断。

3. 引脚工具会为“代码预览”视图的右侧面板中的 pin_mux.c 和 pin_mux.h 自动生成源代码。

图 32. 生成的代码

4. 现在，您可以将源内容复制-粘贴至您的应用和 IDE 中。或者，您可以导出生成的文件。要导出文件，选

择菜单“文件 > 导出”（桌面版本）或选择菜单“引脚 > 导出”（网络版本）。在“导出”对话框中，展

开要导出源的工具的树控件，然后选择“导出源文件”选项。导出，选择“导出源文件”选项。

用户界面



图 33. 导出源文件

5. 单击“下一步”并指定要存储各个内核（如果为多核配置）导出文件的各个内核（多核配置中）目录。

6. 单击“完成”导出文件。

7. 将导出文件集成至您的应用中，并将其用作为源文件。

3.4 用户界面引脚工具由多个视图组成。

引脚工具



图 34. 引脚工具用户界面

图 35. 选择电源组

备注

并不是所有处理器都支持电源组。

3.4.1 功能 “功能”用于对一组路由的引脚进行分组，并在功能中为配置操作创建之后可被应用调用的代码。

该工具允许创建多个可用于配置引脚复用的功能。

引脚的使用情况在“引脚”、“外设信号”和“封装”视图中以 50%的不透明度表示。每个功能都可以定义一组路

由的引脚，或重新配置已路由的引脚。

当在配置中指定了多个功能时，“封装”视图主要显示所选功能的引脚和外设。不同功能的引脚和外设显示为低透

明度，且不能配置，直至切换至该功能。

用户界面



3.4.2 封装显示处理器封装的视图出现在“引脚工具”窗口的中间。处理器封装显示封装的整体概述，包括资源分配。

图 36. 处理器封装

该视图显示封装概述和引脚位置。中间是外设。

对于 BGA 封装，使用“资源”图标查看。

• 绿色表示路由的引脚/外设。

• 灰色表示未路由引脚/外设。

• 深灰色表示引脚/外设为专用，它默认进行路由，且对生成的代码没有影响。

该视图还显示封装变体和说明（类型和引脚数量）。

以下图标在工具栏中可用：

引脚工具



表 5.工具栏选项

图标说明

放大封装图像。

缩小封装图像。

旋转封装图像。

显示可以从底部看到的引脚。该选项只适用于 BGA 封装。

显示可以从顶部看到的引脚。该选项只适用于 BGA 封装。

显示资源。该选项只适用于 BGA 封装。

切换封装。

封装图例

备注

并不是所有视图都可用，具体取决于所选的处理器封装。

“切换封装”图标会启动“切换处理器封装”窗口。

图 37. 切换封装

用户界面



“切换处理器封装”窗口显示可用处理器封装列表，显示封装类型和引脚数量。

3.4.3 路由的引脚视图 “路由的引脚”视图显示路由的引脚列表，并允许进一步配置。该视图还允许配置引脚的电气属性，并显示所有

引脚。此外，还显示配置中可用的焊盘配置，其中每个引脚与信号名称和功能相关联。

备注

只可为表格中的引脚配置电气特性，例如：路由的引脚。

当创建了新配置时，表格为空，表明未配置任何引脚。每行代表单个引脚的配置，如果不存在冲突，则会立即更

新代码。板/套件的引脚已路由

使用表格下拉菜单配置引脚。要配置引脚，则从左到右开始 — 先选择外设，然后选择所需信号，最后选择路由

的引脚。

请参见表格右侧部分配置电气特性。

如果不支持该功能，则显示不适用。

图 38. 路由的引脚视图

灰色背景表示只读项。

斜体值表示值未配置并且它显示重置后的值，也未生成任何代码，所以配置依赖于重置后的值或通过不同功能配

置的值。

提示

• 斜体显示的值表示重置后的值。如果在其他功能中配置，则实际值可能会与重置后

的值不同。 • 使用下拉菜单选择所需值。 • 如果选择的值与重置后的值相同，则工具将始终生成代码以设置该功能。使用下拉

“重置”值将值重置为重置后状态。 • 如果项目不支持重置为重置后值，则“重置”菜单不可用。第一行显示 BGA 封装上

的引脚编号或坐标。

3.4.3.1 视图控件下图展示了“路由的引脚”视图控件。

引脚工具



图 39. 视图控件

添加/移除行：

• 要在表格结尾添加新行，则单击 [+] 按钮。 • 要移除所选行，则单击 [x] 按钮。

• 要删除特定行或插入新行至指定位置，则右键单击并使用弹出菜单命令。

添加指定数量的行或清除表格：

• 要添加指定数量的行，则指定行的确切数量。

• 要清除表格，则键入 0。

更改行顺序：

要更改行顺序，则使用箭头图标上下移动一行。

过滤表条目：

要按文本过滤表条目，则在“输入过滤文本”字段中输入文本字符串。

复制-粘贴行：

要复制行，则右键单击行中任意单元格，并选择“复制”。随后，您可以右键单击表格并选择“粘贴”，将复制的

行粘贴至另一功能组或配置的“路由的引脚”视图中。

3.4.3.2 过滤路由的引脚下图显示了“路由的引脚”视图的过滤区。

图 40. 过滤区

要立即过滤行，则在过滤区内输入文本或搜索词（输入过滤文本）。

移除所选行

更改行顺序单击标头启用按该列排序添加行

设定行数

用户界面



备注

当您输入搜索文本时，还会搜索引脚全称中的文本，并显示包含搜索文本的行。

3.4.4 外设信号视图 “外设信号”视图显示了外设列表及其信号。只有“外设信号和引脚”视图显示带状态的复选框（已分配）。

表 6.状态码

颜色码状态

错误

已配置

未配置

警告

专用：器件默认进行路由，且对生成的代码没有影响。

引脚工具



图 41. 外设信号视图

使用复选框路由/取消路由所选引脚。

要路由/取消路由多个引脚，则单击外设，并在“选择信号”窗口中选择选项。

用户界面



图 42. 选择信号窗口

3.4.5 引脚视图 “引脚”视图显示了表格式的所有引脚。

引脚工具



图 43. 引脚表格视图

该视图显示了指定器件上可用的所有引脚。“引脚名称”列显示了引脚的默认名称，或引脚是否已路由。如果引脚

已路由，则引脚名称变为显示所选外设的适用功能。表格的下面几列显示外设和指定外设上的引脚名称。最后一

列中累计了项数较少的外设。

要路由/取消路由引脚至指定外设，则选择“引脚”列中的相关单元格。路由的引脚高亮显示为绿色。如果存在路

由冲突，则引脚高亮显示为红色。

每个路由的引脚都会出现在“路由的引脚”表中。

当配置中指定了多项功能时，“引脚”视图主要显示所选功能的引脚。不同功能的引脚显示为低透明度，且不能配

置，直至切换至该功能。

您可以右键双击行，以打开提供以下选项的下拉菜单：

• 路由/取消路由引脚。

• 在“封装”视图中高亮显示引脚。

• 设置引脚的标签和标识符。

• 向引脚添加注释。随后，您可以在“代码预览”视图中检查注释。

提示

将更多信号路由至单个引脚的选项用省略号（...）表示。选择单元格打开一个对话框，

以便从多个可用信号中选择。对话框还会显示默认情况下路由的信号。

3.4.6 标签和标识符您可以定义可在用户界面中显示的任何引脚的标签，以便于识别。

板和套件均带有预定义引脚。但是，您也可以定义在“引脚”和“路由的引脚”视图中列出的引脚标签。要设置/更新“标签”和“标识符”列的可见性，可选择“编辑 > 首选项”。

引脚标识符用于在 pin_mux.h 文件中生成#define。但是，这只是可选参数。如果未定义参数，就不会生成#define的代码。此外，您可以定义多个标识符，使用“,”字符作为分隔符。您还可以通过在“引脚”和“路由的引脚”

视图中将标识符直接输入到“标识符”列的单元格中，设定标识符。

用户界面



图 44. 引脚标识符

在这种情况下，如果引脚已路由，可以从值中选择，请参见“路由的引脚表”。

图 45. 路由的引脚表中的标识符

检查以确认生成的定义在 pin_mux.h 文件中是否重复。这些重复项在标识符列中表示错误，请参见“标识符错误”。

图 46. 标识符错误

您还可以从“路由的引脚”视图中选择指定路由中使用的引脚。但是，标识符必须为有效的 C 标识符，且应用于

源代码。

图 47. 引脚宏前缀

如果使用了多个功能，则每个功能都可包含一个特殊的前缀。选择“引脚 > 功能组属性 > 设置自定义#define前缀”复选框，以在 pin_mux.h 文件生成的代码中使用的特定功能中输入宏前缀。输入的前缀文本必须为 C 标识

符。如果未勾选，则将功能名称用作为默认前缀。

3.4.7 引脚视图和外设信号视图中的过滤功能下图显示了“引脚”和“外设信号”视图中的过滤控件。

引脚工具



图 48. 过滤控件

输入任意文本，以在表格/树中搜索。这将搜索包含指定文本的引脚/外设信号。您还可以使用通配符“*”和“?”帮助过滤您想要的结果。同时搜索多个字符串时使用“空格”。

3.4.8 高亮显示和颜色编码使用高亮显示功能，可轻松地识别封装中路由的引脚/外设。默认情况下，当前选择（引脚/外设）在“封装”视图

中高亮显示。

• 引脚/外设在“封装”视图中用黄色边框高亮显示。如果选择了高亮显示的引脚/外设，则其周围会有蓝

色边框。

• 红色表示引脚存在错误。

• 绿色表示引脚已复用或已使用。

• 浅灰色表示引脚可用于复用，但未复用或未使用。

• 深灰色表示引脚/外设为专用，它默认进行路由，且对生成的代码没有影响。

显示带输入信号的引脚

显示具有低漏电源模式唤醒功能的引脚

显示带数字信号的

引脚

显示带模拟信号

的引脚

只显示具有中断功能的引脚

显示带输入/输出信号的引脚

显示带输出信号的引脚

显示未路由的引脚

显示专用引脚

显示路由的引脚

用户界面



图 49. 高亮显示和颜色编码

图 50. 引脚冲突

图 51. 警告

• 封装视图

— 单击外设或使用弹出菜单以高亮显示外设：

MK64FN1M0VLL12 – LQFP 100 封装

存在错误的外设

高亮显示的未路由引脚

未分配的外设

未路由引脚

专用引脚

存在错误的引脚

高亮显示的外设

专用外设

路由的引脚

已分配的外设

引脚工具



◦ 所有已分配的引脚（至所选外设）。

◦ 或者如果尚未分配，则是所有可用引脚。

— 单击引脚或使用弹出菜单以高亮显示引脚及其外设。

— 单击封装之外的区域，以取消高亮显示。

• 外设/引脚视图

— 外设和引脚操作如上图所示。

备注

下拉菜单在引脚上遍历期间，工具会高亮显示引脚。

3.5 错误和警告引脚工具会检查路由中是否存在冲突，以及配置中是否存在错误。如果将函数配置为 INIT 函数，则只对所选函数

或对所有 INIT 函数（默认初始化函数）进行路由冲突检查。可在不同功能中配置一个引脚的不同路由，以允许重

新配置动态引脚路由。

图 52. 错误和警告

如果出现错误或警告，则在行内的第一列中显示“路由的引脚”视图中的冲突，并在造成冲突的单元格中指示错

误/警告。上图中的前两行显示出现错误配置的外设/信号。第四行在未配置的标识符上显示警告，同时指定方向。

详细的错误/警告消息以工具提示的形式显示。

有关错误和警告颜色的更多信息，请参见“高亮显示和颜色编码”章节。

3.5.1 不完整路由带有不完整路由的单元格使用红色背景指示。要生成正确的引脚路由，请单击下拉箭头并选择适当的值。单元格

上的红色修饰符表示错误状态。

图 53. 不完整路由

单元格的工具提示显示冲突或错误的更多详细信息，通常会列出出现冲突的行。

您还可以从主菜单中选择“引脚 > 自动路由”来解决路由问题。

备注

并不是所有的路由问题都能够自动解决。在有些情况下，需要人工干预。

代码生成



3.6 代码生成如果设置正确，且未报告错误，则代码生成引擎会立即重新生成源代码。您可以在“引脚”工具的“代码预览”

视图中查看生成的代码。

“代码预览”会自动高亮显示代码的当前迭代和上次迭代之间的差异。您可以单击“设置源差异的查看样式”在

两种高亮显示模式之间进行选择。您还可以在相同的下拉菜单中一起禁用高亮显示。

对于多核，可为每个内核生成源。相关文件带有@Core #{number} 标记。

备注

标记名称可能会不同，取决于所选多核处理器系列/类型。

您还可以将生成的代码复制和粘贴至源文件中。视图会为每个函数生成代码。除了功能注释，工具配置也存储为

YAML 格式。该注释不可用于直接编辑，之后可用于恢复引脚配置。

图 54. 生成的代码

YAML 配置包含每个引脚的配置，只存储了非默认值。

引脚工具



提示

对于多核处理器，将为每个内核生成源文件。如果 SDK 支持处理器，则会默认从主菜单生

成的 BOARD_InitBootPins 函数调用。您可以为每个函数指定“从 BOARD_InitBootPins 调

用”，以便生成适当的函数调用。

功能



第 4 章时钟工具时钟工具配置系统时钟（内核、系统、总线和外设时钟）的初始化，并利用时钟初始化函数和配置结构生成 C代码。

4.1 功能以下为时钟工具的功能：

• 检查和修改从时钟源至内核/外设的时钟路径上的元件配置。

• 验证时钟元件设置，并计算生成的输出时钟频率。

• 使用 SDK 生成一个配置代码。

• 修改设置，并使用时钟元件及其参数的表格视图提供输出。

• 在“框图”视图中轻松导航、修改和显示重要设置和频率。

• 在“详情”视图中编辑详细的设置。

• 在“模块时钟”视图中检查外设与消耗时钟的互连。

• 帮助查找符合指定输出要求的时钟元件设置。

• 与其他工具一起完全集成至工具框架。

• 在“问题”视图中显示配置问题，并指导用户解决问题。

4.2 用户界面概述时钟工具可与 MCUXpresso 配置工具框架集成，并与其一起运行。关于通用界面和菜单项的文档，请参见“配置

工具用户界面”一章。

时钟工具



图 55. 用户界面

4.3 时钟配置每个时钟配置（功能组）都会列出整个时钟系统的设置，且是 MEX 文件中存储的全局配置的组成部分。首先，在

创建新时钟配置后，将其设置为反映处理器默认的重置后状态。

可由时钟工具处理一个或多个时钟配置。默认时钟配置使用“BOARD_BootClockRUN”名称创建。多个配置意味

着有多种选项可用于处理器初始化。

备注

所有时钟设置都针对每个时钟配置进行单独存储，所以每个时钟配置都是单独配置的。

时钟配置（功能组）显示在视图的顶部。您可以从下拉菜单中选择进行切换。

图 56. 默认时钟配置

备注

工具的代码生成引擎使用从时钟配置名称衍生而来的名称生成函数。

时钟菜单



4.4 时钟菜单时钟工具相关命令可在时钟菜单中找到，包括下述命令：

• 功能组 — 打开“功能组属性”对话框。

• 刷新 — 使用代码生成的显式调用功能刷新每个时钟配置。

• 重置为板默认值 — 将时钟模型重置为板默认值。

• 重置为处理器默认值 — 将时钟模型重置为处理器默认值。

• 解锁所有设置 — 解锁所有设置中的锁定。

4.5 全局设置全局设置（如运行模式和 MCG 模式）会影响整个时钟系统。建议先对其进行设置。全局设置可在“时钟表格”、

“时钟框图”和“详情”视图中修改。

备注

全局设置可随时更改。

图 57. 全局设置

4.6 时钟源时钟源表格位于“时钟表格”视图中。您还可以直接在“框图”视图或“详情”视图中编辑时钟源。

您可以配置外部时钟源的可用性（勾选复选框），并设置外部时钟源的频率。当您展开节点时，一些时钟源可能会

有其他设置。

如果外部晶振或系统振荡器时钟可用，则勾选时钟源行中的复选框，并指定频率。

图 58. 外部时钟源配置

备注

即使勾选了复选框，有些时钟源仍无效。这是因为时钟源功能取决于其他设置，

如电源模式或其他启用/禁用设置选项。您可以将光标悬停在设置上，以查看包含

元件信息和可能的限制/选项的工具提示。

4.7 设置状态和标记以下状态、样式和标记反映了设置表格中“设置”行显示的信息（时钟源、输出、详情或个别项）。

时钟工具



表 7.设置状态和标记

状态/样式/标记图标说明

错误标记表示设置中存在错误或错误相关的事项。详细信息请参见设置的工具提示。

警告标记

表示设置中存在警告或警告相关的事项。详细信息请参见设置的工具提示。

锁定图标

表示设置（可由工具自动调整）已锁定，以防止任何自动调整。如果设置可以锁

定，则会在您更改值的时候自动锁定。要手动添加/移除锁定，则使用弹出菜单命

令“锁定/解锁”。

备注

无法由工具自动调整的时钟元件设置其值保持不变，且不允许锁定。包括：时

钟源、时钟选择器和配置元素。

黄色背景表示前一个用户操作直接或间接更改了该字段。

灰色文本

表示设置值不会主动影响时钟。该项被禁用，或与无效时钟元件有关。例如：在

不可用时钟源或禁用元件后的时钟路径上。频率信号还会显示文本“无效”而非

频率。当值为只读状态时，该值也为灰色。在此状态下，不可以修改该值。

4.8 频率设置每次更改从时钟源至时钟输出的设置之后，时钟工具都会立即重新计算整个时钟系统的状态。

时钟源右侧的“时钟输出”视图列出了所有时钟输出的当前状态。显示的值可以是：

• 频率 — 表示时钟信号有效，且输出按显示的频率馈送。工具会自动选择适当的频率单位。如果数字太长或

有超过 3 位小数，则会将数字缩短，且只显示 2 位小数，后面用省略号（“...”）表示数字太长。

• “无效”文本 — 表示没有时钟信号传入时钟输出或由于某些设置而被禁用。

如果您对输出时钟有特定要求，则单击想要设置的频率，更改频率，然后按“Enter”键。

图 59. 设置内核时钟频率

如果工具已经达到所需频率，则会显示为锁定，如下所示：

图 60. 工具达到所需频率

如果工具无法达到所需频率，或出现一些其他问题，则显示如下：

图 61. 工具出现问题

依赖关系箭头



方括号 [ ] 中的频率值表示工具在计算中实际使用的值，而不是所请求的值。

备注

您可以只编辑或设置时钟源和输出频率要求。只有在未报告错误的情况下才可以

调整其他值。

4.8.1 弹出菜单命令 • 锁定/解锁 — 移除频率上的锁定，支持工具更改满足所有其他要求、限制和约束条件的任何有效值。

• 查找接近有效值 — 尝试查找接近指定值的有效频率，以防工具未能达到要求频率。

图 62. 弹出菜单命令

4.8.2 频率精度对于锁定的频率设置（用户请求特定值的情况下），还会显示频率精度值。默认情况下，该值为 0.1%，但可以通

过单击该值对其进行单独调整。

图 63. 频率精度

4.9 依赖关系箭头在“表格”视图中，时钟源和时钟输出之间的区域包含将时钟源指向输出的箭头。这些箭头从用于所选输出的当

前时钟源指向使用来自相同时钟源的信号的所有输出。当时钟源或共享时钟路径上的元件发生更改时，这可用于

确定依赖关系和影响。

图 64. 依赖关系箭头

4.10 详情视图 “详情”视图显示并允许更改时钟元件设置信息。

该信息也会根据“时钟框图”和“时钟表格”中的任何更改进行实时更新。

时钟工具



图 65. 详情视图

在“详情”视图中，您可以执行以下操作：

• 显示时钟元件信息 — 将鼠标光标指向时钟元件以显示时钟元件的一般信息。

• 在时钟框图或时钟表格中查看时钟元件 — 左键单击时钟元件以在“时钟框图”或“时钟表格”视图中高

亮显示，具体取决于当前有效的时钟元件。

• 查看详细的时钟元件信息 — 双击时钟元件以显示元件的详细信息，以及在“时钟框图”或“时钟表格”

中高亮显示元件，具体取决于当前有效的时钟元件。您还可以单击“详情”视图右上角的“在新窗口中打

开”按钮查看元件详细信息。

• 修改时钟元件设置 — 在“值”列中左键单击以更改时钟元件值（如频率），或从下拉菜单中选择一个选项。

• 锁定/解锁时钟元件 — 右键单击时钟元件以锁定/解锁元件。

• 过滤有效/锁定/错误的时钟元件 — 使用“详情”视图右上角的按钮过滤有效/锁定/错误的时钟元件，或移

除所有当前的过滤器。

时钟框图



4.11 时钟框图时钟框图显示整个时钟模型的结构，包括由工具处理的时钟功能。它可视化显示时钟信号从时钟源到时钟输出的

流程。每次更改后都会进行动态刷新，并始终反映时钟模型的当前状态。

与此同时，它还允许您编辑时钟元件的设置。

图 66. 时钟框图

4.11.1 框图中的鼠标操作您可以在“时钟框图”视图中执行以下操作。

• 将鼠标光标置于元件上，以查看包含时钟元件信息（如状态、说明、输出频率、约束条件和启用/禁用条件）

的工具提示。

• 单击输出频率或范围，以更改输出频率或范围。

• 单击锁定，以移除锁定。

• 双击元件，以在“详情”视图（如果视图已关闭或不可见，则强行打开视图）中显示元件设置。

• 单击元件，以在“详情”视图中显示元件设置。

• 单击所选时钟源，以显示用于启用或禁用源的下拉菜单。

• 单击所选时钟选择器，以显示选择器输入选项。

时钟工具



图 67. 框图中的时钟鼠标操作

• 右键单击元件、组件或时钟输出，可以看到包含以下选项的弹出菜单。

— 编辑 {element} 的设置 — 调用包含单个元件设置的浮动视图。

— 编辑所有设置 — 调用包含元件所有设置的浮动视图。

— 编辑至 {clock output} 的路径上的设置 — 调用包含指向所选时钟输出的时钟路径上所有元件设置

的浮动视图。

图 68. 浮动视图

4.11.2 颜色和线条样式不同颜色和线条样式表示元件和时钟信号路径的不同信息。

颜色和线条样式可表示：

• 所选输出的有效时钟路径

• 时钟信号路径状态 — 已使用/未使用/错误/不可用

• 元件状态 — 正常/已禁用/错误

要检查颜色和样式外观，则从主菜单中选择“帮助 > 显示框图图例”。

4.11.3 时钟模型结构时钟模型包含互连时钟元件。时钟信号通过各种时钟元件从时钟源传至时钟输出。时钟元件具有能够阻止信号传

至后续元件的特定启用条件。时钟元件还具有由时钟工具监视的特定约束条件和限制。要检查这些详细信息，将

光标置于时钟框图内的元件上，以显示工具提示。

以下为时钟模型元件。

时钟框图



• 时钟源 — 生成指定频率的时钟信号。如果为外部时钟源，则可以有一个或多个相关引脚。

图 69. 时钟源

• 时钟选择器（多路复用器）— 从多个输入中选择一个输入，并将信号传至输出。

图 70. 时钟选择器

• 预分频器 — 使用可选或固定比例进行分频或倍频。

图 71. 预分频器

• 锁频环 (FLL) — 使用给定系数倍增输入频率。

图 72. 锁频环

• 锁相环 (PLL) — 包含预分频器，因此能够使用给定值进行分频/倍频。

图 73. 锁相环

• 时钟门控 — 停止传播传入信号。

• 时钟输出 — 标记具有某个名称且能够由外设或处理器其他器件使用的时钟信号输出。您可以设置锁定和/或频率请求。

图 74. 时钟输出

时钟工具



• 时钟组件 — 由边框围住的一组时钟元件。时钟组件可以有一个或多个输出。时钟组件通常对应于处理器模

块或外设。组件输出可能与时钟门控类似，允许或阻止信号流出组件。

图 75. 时钟组件

• 配置元件 — 元件的额外设置。配置元件在框图中没有图示，它们显示在元件的设置表格中或元件所在时钟

路径上。

4.12 时钟消耗件视图 “时钟消耗件”视图概述了外设实例，还提供了时钟-时钟实例配对相关的信息。该视图不可编辑，只供参考。

备注

关于哪个外设消耗哪个输出时钟的信息可在时钟输出工具提示中找到。

故障排除



图 76. 时钟消耗件视图

4.13 故障排除使用时钟工具时可能会出现问题或冲突。此类问题和总体状态在时钟工具的中部状态栏上用红色表示。状态栏显

示所报告问题的全局信息。

您可能会遇到下述问题：

1. 无法满足要求：表示存在一个或多个锁定频率或频率约束条件，工具无法为其找到有效设置并满足这些

要求。

2. 无效设置或要求：[元件列表] — 表示设置值无效。例如：设置的当前状态超出可接受范围。

下面介绍了一些故障排除技巧。

1. 找到框图或表格中标记为错误的元件和设置，并在工具提示中查看详细信息。

2. 从只有一个锁定频率开始，并让工具查找和计算其他锁定频率。成功后，可以添加更多。

时钟工具



3. 如果有许多锁定输出，则仔细检查每项，并确认要求（有可能是所需频率错误、单位错误等）。

4. 如果可以获得所要求值的一个接近值，则右键单击并从弹出菜单中选择“时钟输出 > 查找接近值”。

5. 如果无法达到所需值，则查看指向要调整的时钟输出的时钟路径，并检查选择器是否可以切换至另一个

时钟源。

6. 尝试通过选择“时钟 > 解锁所有设置”移除锁定。如果要求进行许多更改，您可以只将模型重置为默认值，

并从头开始操作。要重置为默认值，选择“时钟 > 重置为处理器默认值”。

您可以使用“问题”视图解决大多数报告的问题。每个问题都列为单独一行。当您在“问题”视图中右键单击选

定的行时，会出现以下选项。

• 显示问题 — 在“时钟框图”视图中显示问题，如果有一个解决方案可行，则弹出菜单扩展为：

— 移除锁定 — 移除错误元件的锁定。

— 查找接近值 — 查找最接近的值。

图 77. 查找接近值对话框

◦ 解锁有效路径设置并重试 — 解锁指向选定输出的所有元件，并尝试重新计算。

◦ 解锁设置并重新尝试 — 解锁所有锁定的值，并尝试重新计算。如果自动值计算失败，则不会进

行任何更改。

◦ 取消 — 取消修改。

4.14 代码生成如果设置正确，且未报告错误，则工具的代码生成引擎会立即重新生成源代码。生成的代码可在“代码预览”视

图中找到。



代码生成



图 78. 代码预览

4.14.1 使用代码生成的代码与 SDK 一致。要使用代码和 SDK 项目，则需要将代码传输至您的项目结构中。

要将代码传输至项目中，则在“代码预览”视图中进行如下操作：

• 使用 COPY 命令复制内容，可通过按下 CTRL+C 键或使用选中整个文件后的弹出菜单。

• 使用导出命令。

• 单击“代码预览”视图中的“导出”按钮。

• 单击工具栏中的“更新代码”。

外设工具



第 5 章外设工具 5.1 功能外设工具具有如下功能：

• SDK 驱动器初始化配置

• 操作简单的用户界面，允许检查和修改设置

• 工具链项目中使用智能配置组件选择和 SDK 驱动器

• 即时验证配置中的基本约束条件和问题

• 使用 SDK 函数调用生成初始化源代码

• 针对初始化替代方案的多个功能组支持

• 配置问题显示在“问题”视图中，且在其他视图中标有修饰符

• 集成至 MCUXpresso 配置工具框架和其他工具中

• 中间件配置支持 (USB)

5.2 基本术语和定义下面是章节中使用的基本术语和定义：

• 功能组 — 表示初始化为组的一组外设。该工具会为每个包含本组外设实例初始化代码的功能组生成一个

C 函数。只可以选择一个功能组为默认初始化，其他功能组则视为默认情况下未初始化的替代方案。

• 外设实例 — 出现的特定类型的外设（器件）。例如：UART 外设在选定处理器上有 3 个实例，所以就会

出现 UART0、UART1 和 UART2 器件。

• 配置组件 — 提供用于配置 SDK 软件组件（例如：外设驱动器）的用户界面，并生成用于初始化的代码。

• 组件实例 — 配置组件可以具有多个不同设置的实例。（例如：UART0、UART1 之类的每个外设实例）。

• 组件模式 — 组件实例的具体用例（例如：DSPI 的 TRANSFER 模式，或基于中断的通信模式）。

5.3 工作流程下述步骤简要介绍外设工具中的基本工作流程。

1. 从工具框架主菜单中选择“工具 > 外设”，以打开“外设”工具。

2. 在“外设”视图中，选择想要配置的外设实例（使用复选框）。

3. 如果有多个组件可供外设使用，则会出现“选择组件”对话框。“选择组件”对话框会为与所选处理器的 SDK驱动器匹配的所选外设显示适用的配置组件列表。

4. 选择想要使用的组件，并单击“确定”确认。

5. 在自动打开的设置编辑器中，选择您想要使用的组件模式，并配置各个设置。

用户界面概览



备注

组件模式的选择可能会影响一些设置的外观。因此，模式的选择应始终是第一步。

6. 打开“代码预览”视图，并查看输出源代码。

备注

注：如果未报告错误，则在每次更改后都会自动生成源代码预览。

7. 您可以使用工具栏中的“更新代码”命令。如果没有，您可以通过从主菜单中选择“文件 > 导出...”来导

出源代码。

备注

注：您还可以单击“代码预览”视图中的“导出”按钮导出源代码。

8. 从主菜单中选择“文件 > 保存”可将设置保存为 MEX 格式（适用于所有工具的所有设置）。

5.4 用户界面概述

图 79. 用户界面

5.5 常用工具栏使用常用工具栏可访问所有 MCUXpresso 配置工具上下文中可用的命令和选择，它提供以下几项：

• 配置工具概述 — 打开包含当前所用工具相关信息的概述。

• 显示问题视图 — 打开“问题”视图。

• 更新代码 — 打开“更新”对话框，允许直接在指定工具链项目内更新生成的外设初始化代码。

• 全局设置 — 打开一个集合了所有配置集的全局设置的选项卡。

外设工具



• 功能组选择 — 外设工具中的功能组表示初始化为组的一组外设。该工具会为每个包含初始化代码的功能

组生成一个 C 函数。

• 功能组相关图标

— 从默认初始化调用 — 设置由默认初始化函数初始化的当前功能组。

— 功能组属性 — 打开“功能组属性”对话框，以修改功能组的名称和其他属性。

• 工具切换图标 — 包含各个工具的图标。单击这些图标以切换当前可见的工具。

• 撤销/重做 — 允许您撤销/重做最后一次操作。

备注

其他命令的详细信息，请参见工具栏

5.6 文档视图您可以打开“文档”视图显示组件相关文档。

备注

并不是所有组件都会启用这个选项。

外设视图



图 80. 文档视图

您可以使用以下三种不同的方法打开“文档”视图：

• 在“外设”视图中，右键单击外设复选框，并从列表中选择“文档”。

• 在“组件”视图中，右键单击组件复选框，并从列表中选择“文档”。

• 在“设置编辑器”中，单击组件名称旁边的“文档”按钮。

5.7 外设视图 “外设”视图包含一个表格，显示可由“外设”工具配置的当前所选处理器上的可用外设列表。如果为多核处理

器，则显示的外设也是特定于内核。

外设的每个实例（例如：UART0）占用一行。第一列包含外设名称和复选框，复选框指示组件实例是否使用

了外设。

第二列包含处理外设的组件实例名称。该名称可在设置编辑器中自定义，且可用于生成的代码。组件实例名称不

能包含空格。

勾选复选框，或单击组件实例设置编辑器中的开关，可启用实例。

外设工具



取消选择该复选框可禁用组件实例。

双击第二列打开组件实例的“设置编辑器”。

右键单击行打开上下文菜单。您可以使用上下文菜单进行如下操作：

• 打开 — 在设置编辑器中打开组件实例（如果已启用）。如果针对外设启用了多个实例，则需要在实例中

进行选择。

• 添加组件实例 — 添加组件实例至外设。

• 文档 — 打开“文档”视图（如果适用）。

• 移除 — 移除组件实例（如果使用了多个实例，则会出现一个确认窗口，允许您选择要移除的实例）。

• 迁移 — 将组件迁移至不同组件类型，或迁移至驱动器版本更新的组件。

• 编辑注释 — 添加/编辑组件实例的自定义注释。

• 启用/禁用 — 启用/禁用组件实例。如果针对外设启用了多个实例，则需要在实例中进行选择。

• 移动到 — 将组件实例移动到不同功能组。

• 复制到 — 将组件实例复制到另一个功能组。

5.8 组件视图组件视图显示了配置组件列表，按类型分为中间件/外设驱动器/其他。视图根据配置组件的状态以不同方式显示配

置组件：

• 已启用 — 将配置组件高亮显示为浅灰色。

• 已启用/带警告 — 将配置组件高亮显示为浅灰色，并带有警示符号。

• 已启用/带错误 — 将配置组件高亮显示为红色，并带有错误符号。

• 已禁用 — 将配置组件高亮显示为深灰色。

组件视图



图 81. 组件视图

在“组件”视图中，您可以执行以下操作：

• 显示配置组件信息 — 将鼠标光标指向配置组件，以显示配置组件的一般信息。

• 打开配置组件的设置编辑器 — 左键单击配置组件以打开其设置编辑器。

• 查看配置组件文档 — 右键单击配置组件，并从下拉菜单中选择文档以查看配置组件文档。如果配置组件

未存档，则该选项高亮显示为灰色。

• 从配置中移除组件 — 右键单击配置组件，并从下拉菜单中选择“移除”。

备注

如果组件具有任何全局设置，则会出现一个对话框，提示您确认移除。如果组件

没有任何全局设置，则在移除最后一个实例后删除组件。

• 迁移 — 右键单击配置组件，并选择“迁移”，以将组件迁移至不同组件类型，或迁移至驱动器版本更新

的组件。

• 编辑注释 — 右键单击配置组件，并选择“编辑注释”，以添加/编辑该组件的自定义注释。

• 启用/禁用配置组件 — 右键单击配置组件，并选择“启用”或“禁用”，以启用/禁用配置组件。

• 将配置组件移动到另一个功能组 — 右键单击配置组件，并选择“移动到”，从功能组列表中选择要将配

置组件移动到其中的功能组。

• 将配置组件复制到另一个功能组 — 右键单击配置组件，并选择“复制到”，从功能组列表中选择要将配

置组件复制到其中的功能组。

外设工具



• 添加新的配置组件 — 左键单击+按钮并从列表中选择，以添加新组件。您可以对列表进行过滤，以便只

显示工具链项目相关的组件，或最新版本的组件。您还可以单击中间件/外设驱动器/其他类别旁边的+按钮，

以直接添加新组件至其中。

• 按名称过滤配置组件 — 在搜索栏中输入一个用于过滤配置组件名称的文本字符串。

5.9 设置编辑器您可以在设置编辑器中编辑外设组件设置。打开的编辑器显示在屏幕的中间区域，每个编辑器都有自己的选项卡。

可同时打开多个编辑器。即使设置编辑器关闭，编辑器中所做的更改也会立即应用并保存。禁用的设置高亮显示

为灰色。如果禁用了某个组件实例，则所有设置都会高亮显示为灰色。当鼠标光标置于设置上时，会显示所有启

用设置的工具提示。

要打开设置编辑器，则进行如下操作：

• 在“外设”或“组件”视图中双击组件实例，以显示组件实例设置。

• 在“组件”视图中左键单击组件，以显示组件的全局设置。

5.9.1 快速选择设置分组到更大的组（配置集），这些组可能提供典型值的预设。用户可使用这些预设来快速设置所需的典型设置

组合或返回至默认状态。

图 82. 快速选择示例

5.9.2 设置编辑器中进行以下设置：

• 布尔值 — 两种状态设置（是/否、true/false）。

图 83. 布尔值设置示例

• 整数、浮点 — 整数或浮点数。

设置编辑器



图 84. 整数/浮点设置示例

• 字符串 — 文本输入。支持多个条目。

图 85. 字符串设置示例

• 枚举 — 从值列表中选择一项。

图 86. 枚举设置示例

• 集合 — 值列表，可多选。

图 87. 集合设置示例

• 结构 — 不同类型的多个设置组，可能包含任何类型（包括嵌套结构）的设置。

图 88. 结构设置示例

• 数组 — 同一类型的多个设置的数组，您可以添加/移除项。简单结构的数组也可以表示为表网格、主机—

细节以及单选按钮。

图 89. 数组

“+”按钮可在数组结尾添加一个新项。要重新排列位置或删除项，可右键单击项，并选择下列选项之一：上移、

下移、移至顶部、移至底部或移除。您还可以右键单击数组标签并选择“复制”，将数组从一个实例复制-粘贴至

另一个实例。然后，您可以导航至另一个实例数组，右键单击表格并选择“粘贴”以添加数组。

备注

系统剪贴板不可用于此目的。

外设工具



图 90. 数组设置示例

• 信息 — 用户只读的信息。

图 91. 数组设置示例

• 文件设置 — 链接/导入外部设置文件。

5.9.3 设置编辑器标头所有组件共用设置编辑器标头。在标头中，您可以查看和更改组件信息，启用或禁用组件，以及查看组件文档（如

果适用）。

图 92. 设置编辑器标头

设置编辑器标头包含：

• 说明 — 显示配置组件标题。

• 名称 — 显示组件实例名称。该名称以常量和函数标识符的形式用于生成的代码中，且是从外设名称衍生

出来。您可以单击“自定义名称”按钮并编辑字段，随时更改该名称。

• 模式 — 显示组件实例所需的用法，并会影响可用设置。可使用下拉菜单更改模式（如果适用）。

• 外设 — 显示要与组件实例关联的外设名称。可使用下拉菜单更改外设。

• 启用/禁用组件实例开关 — 使用该开关启用或禁用所选组件实例。请注意，禁用实例并不是将实例从工

具配置中移除，而是防止实例包含在生成的代码中。

• 文档按钮 — 在“文档”视图中单击该按钮可查看配置组件相关文档。请注意，并非所有配置组件都已存

档，所以并非所有设置标头都含有“文档”图标。

5.10 问题工具用于验证设置，而问题和错误则在“问题”视图报告。

如果存在与设置或组件相关的错误，则会在包含错误的元件旁显示一个错误修饰符。

代码生成



图 93. 错误修饰符

5.11 代码生成如果设置正确，且未报告错误，则工具的代码生成引擎会立即重新生成源代码。您可以在“外设”工具的“代码

预览”视图中查看生成的代码。



“外设”工具可生成以下 C 文件：

• peripherals.c

• peripherals.h

备注

对于多核处理器，则会为每个内核生成 peripherals.c/.h，包含与该内核相关的功能

组。这可在功能组属性中配置。

备注

一些组件（如 USB 或 FlexSPI）可能会生成额外的输出文件。

这些文件包含所选配置组件生成的外设初始化代码，包括：

• 标头文件中的常量和函数声明。

• 初始化的配置结构变量（常量）。

• 在初始化中使用的用户应用的全局变量。例如：处理和缓冲。

• 每个配置组件的初始化函数。

• 每个功能组的初始化函数。函数名称与功能组名称相同。这些函数包括执行所有已分配组件的初始化函数。

• 默认初始化函数包括调用初始化外设所选功能组的功能。

备注

全局定义（定义、常量、变量和函数）的前缀可在功能组属性中配置。

外设工具




设备配置数据 (DCD)视图



第 6 章设备配置工具设备配置工具可用于配置硬件内存接口的初始化。使用“设备配置数据 (DCD)”视图创建不同类型的命令，并指

定其序列，定义其地址、值、大小和轮询。

图 95. 设备配置工具

6.1 设备配置数据 (DCD) 视图 “设备配置数据 (DCD)”视图显示了当前有效配置的内存初始化命令。在这里，您可以创建新的命令组和命令，

并指定其参数。

6.1.1 设备配置数据 (DCD) 视图操作下面是您可以在“设备配置数据 (DCD)”视图中执行的命令和命令组相关操作列表：

• 新建命令组 — 右键单击表格，并从上下文菜单中选择“添加组”。

• 重命名命令组 — 左键单击命令组单元格，并输入需要的名称。

• 禁用命令组 — 右键单击命令组行，并从上下文菜单中选择“禁用组”。

• 移除命令组 — 右键单击命令组行，并从上下文菜单中选择“移除组”。

• 折叠所有命令组 — 右键单击表格，并从上下文菜单中选择“折叠所有组”。

• 展开所有命令组 — 右键单击表格，并从上下文菜单中选择“展开所有组”。

• 添加命令至组 — 右键单击表格，并从上下文菜单中选择“添加命令”。或者，在工具的工具栏中单击“添

加命令”按钮。

• 指定命令类型 — 左键单击行的“命令”单元格，并从下拉菜单中选择。

设备配置工具



• 指定命令的寄存器地址 — 左键单击行的“地址”单元格，并从下拉菜单中选择。

• 指定命令的值或掩码 — 左键单击行的“值/掩码”单元格，并输入所需值。

• 指定命令的读/写数据大小 — 左键单击行的“大小”单元格，并从下拉菜单中选择。

• 指定命令的轮询次数 — 左键单击行的轮询单元格，并输入所需值。

• 向命令添加注释 — 左键单击行的“注释”单元格。

• 移除命令 — 右键单击命令行，并从上下文菜单中选择“移除命令”。或者，在工具的工具栏中单击“移

除命令”按钮。

备注

在主菜单中单击“设备配置”并从下拉菜单中选择“清除所有命令”，可移除所

有命令。

6.2 代码生成如果设置正确，且未报告错误，则代码生成引擎会立即重新生成源代码。您可以在“设备配置”工具的“代码预

览”视图中查看生成的代码。



设备配置源代码可生成为 C 数组（默认）或二进制格式。

C 数组格式代码生成在两个文件中：

• dcd.c

• dcd.h

二进制格式代码生成在单个文件中：

• dcd.bin

要更改代码格式，则从“设备配置数据 (DCD)”视图的下拉菜单中选择所需选项。

代码生成




可信执行环境工具



第 7 章可信执行环境工具在可信执行环境或 TEE 工具中，您可以配置内存区域、总线主机和外设的安全策略，以便隔离和保护应用的敏感

区域。

您可以在“安全访问配置”视图及其子视图中设置应用的不同组件的安全策略，并在“内存映射”和“访问概述”

视图中检查这些策略。使用“用户内存区域”视图创建内存区域及其安全等级的简要概述。

您还可以在“寄存器”视图中查看由 TEE 工具处理的存储器，并在“代码预览”工具中检查代码。

备注

为了使您的配置生效，确保在“安全访问配置”视图的“其他”子视图中已启用了相关启用安全

检查选项。

图 97. TEE 工具用户界面

7.1 用户内存区域在“用户内存区域”视图中，您可以创建和维护内存区域的高级配置及其安全等级。您可以创建区域，命名区域，

指定区域地址、大小、安全等级，并提供区域说明。然后，您可以利用“问题”视图，修复设置中的任何错误。

通过单击视图标头中的“添加新的内存区域”按钮来新建内存区域。

通过单击内存区域行的单元格，输入/更改内存区域的参数。在“安全等级”列中，您可以选择以下选项：

• NS-User — 非安全用户

• NS-Priv — 非安全权限

用户内存区域



• S-User — 安全用户

• S-Priv — 安全权限

• NSC-User — 非安全可调用的用户

• NSC-Priv — 非安全可调用的权限

• 任意

通过选择表格行并单击视图标头中的“移除所选内存区域”按钮，可移除内存区域。




图 98. 用户内存区域

7.2 安全访问配置视图在“安全访问配置”视图中，您可以通过多种方式配置应用的安全策略。更多详细信息，请参见以下部分。

安全访问配置视图



7.2.1 主机/从机在“主机/从机”子视图中，您可以配置总线主机和从机的安全等级。

通过左键单击“安全等级”列中的相关单元格并从下拉列表中选择，可设置总线主机/从机安全等级。或者，您也

可以右键单击“主机/从机”列中的相关单元格，并从上下文菜单中的安全等级中选择。要选择多个条目，可使用

Ctrl+左键单击快捷键，然后右键单击选定区域弹出上下文菜单。

有四个安全等级可供您选择，按安全等级升序排列：





您可以选择以下选项，进一步指定主机和从机安全等级之间的相互关系：

• 严格模式下的简单主机 — 选择该选项，简单总线主机只可在相同等级上读写。取消选择该选项，可在相

同和更低等级上读写。

• 严格模式下的智能主机 — 选择该选项，智能总线主机只可对相同等级的内存进行执行、读取和写入操作。

取消选择该选项，只可在相同等级上执行，并在相同和更低等级上读写。

备注

指令类型的总线主机安全等级必须与总线从机安全等级相同。数据和其他类型的总线主机安全等

级必须与总线从机安全等级相同或更高。




图 99. 主机/从机

7.2.2 MPC 在 MPC（内存保护检查器）子视图中，您可以根据物理地址的定义设置整个内存扇区的安全策略。




通过左键单击“安全等级”列中的相关单元格并从下拉列表中选择，可设置内存扇区安全等级。或者，您也可以

右键单击“扇区”列中的相关单元格，并从上下文菜单中选择安全等级。要选择多个条目，可使用 Ctrl+左键单击

快捷键，然后右键单击选定区域弹出上下文菜单。

有四个安全等级可供您选择，按安全等级升序排列：








图 100. MPC

7.2.3 中断在“中断”子视图中，您可以为器件的外设中断设置安全标示。如果处理器包含不止一个内核或处理单元，可能

会出现额外的“由内核处理”表格。在这些表格中，您可以指定是否由内核或处理单元处理外设发出的中断命令。




所有中断默认设为“安全”。如果您想要更改中断源的安全标示，则左键单击中断的“安全”单元格，并从下拉菜

单中选择。或则，右键单击中断的“名称”单元格，并从上下文菜单中选择安全标示。要选择多个条目，可使用

Ctrl+左键单击快捷键，然后右键单击选定区域弹出上下文菜单。

图 101. 中断




7.2.4 引脚在“引脚”子视图中，您可以指定允许或拒绝 GPIO 状态。

所有引脚的读取 GPIO 状态默认设为“允许”。如果您想要更改引脚读取 GPIO 状态，则左键单击引脚的“读取

GPIO 状态”单元格，并从下拉菜单中选择。或则，右键单击引脚的“名称”单元格，并从上下文菜单中选择读取

GPIO 状态。要选择多个条目，可使用 Ctrl+左键单击快捷键，然后右键单击选定区域弹出上下文菜单。




图 102. 引脚

7.2.5 SAU 在 SAU 子视图中，您可以启用和配置 SAU（安全属性单元）。




启用时，您可以设置 SAU 内存区域，指定其起始地址和大小或结束地址，并指定其安全等级。禁用时，SAU 会

将整个内存空间自动设置的严重程度设置为安全。启用但未设置内存区域时，它还会将整个内存空间设置为的安

全等级设置为安全。

您可以从以下两个安全等级中选择：

• NS — 非安全

• NSC — 非安全可调用

或者，您可以通过选择“全部为非安全”将所有 SAU 内存区域的安全等级设置为非安全。

备注

该选项仅在禁用 SAU 时可用。

您还可以通过选择“为禁用区域生成源”选项决定为禁用的内存区域生成代码。




图 103. SAU/IDAU

7.2.6 其他在“其他”子视图中，您可以设置各种配置选项。选项列表取决于处理器数据，并且存在很大的差异。所有选项

都会影响您的寄存器设置，并且可以在“寄存器”视图中对其进行检查。只有一些选项会直接影响您在“安全访

问配置”视图中进行的配置。将指针指向各个选项，以显示介绍每个选项功能的工具提示。




图 104. 其他条款

7.3 内存属性映射在“内存属性映射”中，您可以查看为内存区域设置的安全等级。该视图为只读。

内存属性映射



7.3.1 内核 0 在“内核 0”子视图中，您可以查看为内核 0 的代码、数据和外设内存区域设置的安全等级。该表格为只读。

“按主机访问”表格显示了 MSW 或 SAU_IDAU、MPC（内存保护检查器）安全等级，以及所列出的代码、数据

和外设内存区域的“生成的安全等级”状态及其物理地址。

要设置显示选项，则进行如下操作：

1. 勾选“过滤访问”复选框，以启用过滤选项。

2. 从主机下拉菜单中选择想要查看的主机安全访问。

3. （可选）通过从安全模式下拉菜单中选择，设置所选主机的安全等级。该设置不会影响配置。

4. （可选）通过取消选择“显示详情”和“合并的 SAU+IDAU”选项，自定义输出。

5. （可选）在过滤区内过滤显示的内存区域。

将指针指向颜色代码单元格，以显示包含安全等级组合相关信息的工具提示。双击单元格，以打开“安全访问配

置”中的相关设置。




图 105. 内核 0

7.3.2 其他主机在“其他主机”子视图中，您可以查看与非内核 0 主机访问权限相关的内存安全属性。该表格为只读。

要设置显示选项，则进行如下操作：

内存属性映射



1. 勾选“过滤访问”复选框，以启用过滤选项。

2. 从“主机”下拉菜单中选择想要查看的主机安全访问。

3. （可选）通过取消选择“显示详情”、“显示代码”、“显示数据”和“显示外设”选项，自定义输出。

4. （可选）在过滤区内过滤显示的内存区域。

将指针指向颜色代码字段，以显示包含安全等级组合相关信息的工具提示。双击单元格，以打开“安全访问配置”

中的相关设置。




图 106. 其他主机

7.4 访问概述在“访问概述”视图中，您可以查看在“安全访问配置”视图中设置的安全策略。

横轴显示了所有主机，根据其安全设置分为不同颜色代码组。

纵轴显示了内存范围和从机总线/外设。

访问概述



将指针指向一个条目，以显示包含条目相关信息的工具提示。

您可以使用工具栏右侧的按钮，按安全性或按主机对显示的信息分组。

图 107. 访问概述




7.5 代码生成如果设置正确，且未报告错误，则代码生成引擎会立即重新生成源代码。您可以在“设备配置”工具的“代码预

览”视图中查看生成的代码。



切换处理器



第 8 章高级功能 8.1 切换处理器您可以将当前配置的处理器或封装切换为另一个处理器或封装。但是，切换至完全不同的处理器可能会出现问题，

如无法访问引脚路由或时钟输出频率不符合要求。在这种情况下，需要手动修复问题。例如：前往“引脚路由”

表格，并重新配置报告了错误或冲突的所有引脚。或者，您可能需要更改时钟输出所需的频率。

选择“文件 > 切换处理器”菜单，更改所选配置中的处理器。

图 108. 切换处理器

选择“文件 > 切换封装”以更改当前处理器的封装。

高级功能



图 109. 切换封装

8.2 导出引脚表格要导出引脚表格，则进行如下操作：

1. 从主菜单中选择“文件 > 导出”。

2. 在“导出”对话框中，选择“以 CSV（逗号分隔值）格式导出引脚”选项。


4. 选择文件夹，并指定要导出至的文件名称。

5. 导出的文件包含当前引脚视图表的内容，以及功能列表和所选的路由的引脚。

图 110. 导出的文件内容

工具高级配置



导出的内容可用于其他工具中，以便后续处理。例如：代码块对齐后（下图）查看导出的内容。

图 111. 代码块对齐

8.3 工具高级配置使用 tools.ini 文件配置处理器数据目录位置。您可以定义“com.nxp.mcudata.dir”属性，以设置数据目录位置。

例如：-Dcom.nxp.mcudata.dir=C:/my/data/directory.

8.4 生成 HTML 报告选择“导出 > 引脚/时钟/外设工具 > 导出 HTML 报告”以生成报告。

8.5 导出源文件可使用“导出”向导来导出生成的源文件。

要启动“导出”向导，则进行如下操作：


2. 选择“导出源文件”。

高级功能



图 112. 导出向导


4. 选择要存储已生成文件的目标文件夹。

图 113. 选择目标文件夹

5. 如果为多核处理器，则选择想要导出的内核。


8.6 导出寄存器您可以使用“导出”向导来导出工具修改的寄存器数据内容。

要导出寄存器，则按照以下步骤操作：

命令行运行




2. 选择“引脚工具 > 导出寄存器”选项。


4. 选择要导出已修改寄存器内容的目标文件路径。


8.7 命令行运行本节介绍桌面应用支持的命令行接口 (CLI) 命令。

您可以利用这些参数在命令行上运行 MCUXpresso 配置工具： tools.exe -noSplash -application com.nxp.swtools.framework.application [tools commands]。

关于命令行运行的注意事项：

• HeadlessTool 命令用作为每个命令链的分隔符。

• 每个命令链都单独工作。

• 每个命令链都以-HeadlessTool 命令开始，然后继续至下一个-HeadlessTool 命令，或者结束。（框架发出

的命令是唯一例外，此类命令无需-HeadlessTool 命令）。

• 如果形成命令链，则无需-HeadlessTool 命令的命令可置于第一个-HeadlessTool 命令之前，或者在未形

成命令链时，无需使用-HeadlessTool 命令。

• 每个工具发出的命令都按照指定顺序执行。

• 框架发出的命令不是按照指定顺序执行。

• 下述命令不是按照指定顺序执行：

— ImportProject

— Export MEX

— ExportAll

• 当出现意外行为时：缺少 hen 参数，可使用以下代码退出应用：

— 当缺少参数时：1

— 当出现工具错误时：2

命令示例：

-HeadlessTool Clocks -MCU MKL43Z256xxx4 -SDKVersion ksdk2_0 -ExportSrc C:/exports/src -HeadlessTool Pins -MCU MK65FN2M0xxx18 -SDKVersion ksdk2_0 -ExportSrc C:/exports/src -HeadlessTool Peripherals -MCU MK64FX512xxx12 -SDKVersion ksdk2_0 -ExportSrc C:/exports/src

框架中支持以下命令：

表 8.框架支持的命令

命令名称定义和参数说明限制示例强制语言 -nl {lang} 强制设置语言

{lang} 符合 ISO-639-1 标准建议将“.nxp”文件夹从主目

录中移除，因为可能会缓存一

些文本

-nl zh

表格接下页……

高级功能



表 8.框架支持的命令（上续）

仅支持“zh”和“en”

显示控制台 -consoleLog 日志输出也被发送至 Java的 System.out （通常返回至命令 shell，如果存在的话）

无

选择 MCU -MCU 将由框架选择的 MCU 需要-SDKversion 命令 -MCU MK64FX512xxx12

选择 SDK 版本 -SDKversion 将由框架选择的 MCU 版本需要-MCU 命令 -SDKversion test_ksdk2_0

选择器件编号 -PartNum 选择特定的 MCU 封装需要 -MCU 和 -SDKversion命令

-PartNum MK64FX512VLL12

配置名称 -ConfigName 新建配置的名称 — 用于

导出当新配置是由 -MUC 和

-SDKversion 命令创建的

时，使用该名称

-ConfigName "MyConfig"

选择工具 -HeadlessTool 选择以 headless 模式运行

的工具无 -HeadlessTool Clocks

加载配置 -Load 加载 (*.mex) 文件中的现

有配置无 -Load C:/conf/conf.mex

导出 Mex -ExportMEX 工具运行后导出.mex 配置

文件自变量为文件夹名称

无 -MCU xxx -SDKversion xxx -ExportMEX C:/exports/my_config_folder

导出所有生成的

文件 -ExportAll 导出生成的文件（含源代码

等）。导出之前重新生成代

码包括-ExportSrc，且在框架

中，-ExportMEX 自变量为

文件夹名称。自变量为文件夹名称

需要-HeadlessTool 命令 -HeadlessTool Pins -ExportAll C:/exports/generated

通过导入工具链

项目新建配置 -ImportProject {path}

通过导入工具链项目新建

配置参数为至工具链项目根目

录的路径

需要-HeadlessTool 命令 -HeadlessTool Pins -ImportProject c:\test\myproject

指定 SDK 路径 -SDKpath {path}

指定至 SDK 包根目录的绝

对路径。 @since v3.0 -SDKpath

c:\nxp\SDK_2.0_MKL43Z256 xxx4

命令行运行



8.7.1 命令行运行 — 引脚工具本节介绍引脚工具中支持的命令行接口 (CLI) 命令。

表 9.引脚支持的命令

命令名称定义和参数说明限制示例

导入 C 文件 -ImportC 将.c 文件导入到配置中在加载 mex 之后以及生成输出

之前完成导入

需要-HeadlessTool 引脚 -HeadlessTool Pins -ImportC C:/imports/file1.c C:/imports/file2.c

导入 DTSI 文件 -ImportDTSI 将.dtsi 文件导入到配置中在加载 mex 之后以及生成输出

之前完成导入

需要-HeadlessTool 引脚 -HeadlessTool Pins -ImportDTSI C:/imports/file1.dtsi C:/imports/file2.dtsi


文件（用于将所

有导出命令简化

为一个命令）

-ExportAll 导出生成的文件（含源代码等）导出之前将重新生成代码包括-ExportSrc、-ExportCSV、-ExportHTML，且在框架中，-ExportMEX 自变量为文件夹名称

需要-HeadlessTool 引脚 -HeadlessTool Pins -ExportAll C:/exports/generated

导出源文件 -ExportSrc 导出生成的源文件。导出之前将重新生成代码自变量为文件夹名称

需要-HeadlessTool 引脚 -HeadlessTool Pins -ExportSrc C:/exports/src

导出 CSV 文件 -ExportCSV 导出生成的 csv 文件。导出之前将重新生成代码自变量为文件夹名称


导出 HTML 报告

文件 -ExportHTML 导出生成的 html 报告文件。

导出之前将重新生成代码自变量为文件夹名称

需要-HeadlessTool 引脚 -HeadlessTool Pins -ExportHTML C:/exports/html

导出寄存器 -ExportRegisters 导出寄存器选项卡至文件夹中。导出之前将重新生成代码自变量为文件夹名称

需要-HeadlessTool 引脚 -HeadlessTool Pins -ExportRegisters C:/exports/regs

高级功能



8.7.2 命令行运行 — 时钟工具本节介绍时钟工具支持的命令行接口 (CLI) 命令。

表 10.时钟支持的命令

命令名称定义和参数说明限制示例导入 C 文件 -ImportC 将.c 文件导入到配置中

在加载mex之后以及生成输出之

前完成导入

需要-HeadlessTool 引脚 -HeadlessTool Pins -ImportC C:/imports/file1.c C:/imports/file2.c

导入 DTSI 文件 -ImportDTSI 将.dtsi 文件导入到配置中在加载mex之后以及生成输出之

前完成导入

需要-HeadlessTool 引脚 -HeadlessTool Pins -ImportDTSI C:/imports/file1.dtsi C:/imports/file2.dtsi


文件（用于将所有

导出命令简化为

一个命令）

-ExportAll 导出生成的文件（含源代码等）导出之前将重新生成代码包括-ExportSrc、-ExportCSV、

-ExportHTML，且在框架中，-ExportMEX 自变量为文件夹名称

需要-HeadlessTool 引脚 -HeadlessTool Pins -ExportAll C:/exports/generated

导出源文件 -ExportSrc 导出生成的源文件。导出之前将重新生成代码自变量为文件夹名称


导出 HTML 报告

文件 -ExportHTML 导出生成的 html 报告文件。

导出之前将重新生成代码自变量为文件夹名称

需要-HeadlessTool 时钟 -ExportHTML C:/exports/html

命令行运行



8.7.3 命令行运行 — 外设工具本节介绍外设工具支持的命令行接口 (CLI) 命令。

表 11.外设工具中支持的命令

命令名称定义和参数说明限制示例导出所有生成的文

件（用于将所有导出

命令简化为一个命

令）

-ExportAll 导出生成的文件（含源代码

等）导出之前将重新生成代码包括 -ExportSrc 、

-ExportHTML，且在框架中，-ExportMEX 自变量为文件夹

需要-HeadlessTool 外设 -HeadlessTool Peripherals -ExportAll C:/exports/generated

导出源文件 -ExportSrc 导出生成的源文件。导出之前将重新生成代码自变量为文件夹

需要-HeadlessTool 外设 -HeadlessTool Peripherals -ExportSrc C:/exports/src

* 对于内部命令，必须在生产应用中安装内部插件

高级功能



8.7.4 命令行运行 — 项目克隆器本节介绍项目克隆器支持的命令行接口 (CLI) 命令。

表 12.项目克隆中支持的命令

命令名称定义和参数说明限制示例指定 SDK 路

径 -SDKpath {path} 指定至 SDK 包根目录的绝

对路径 @since v3.0 -SDKpath c:\nxp

\SDK_2.0_MKL43Z256 xxx4

克隆 SDK 示

例项目 -PG_clone {board}{example} {toolchain}{wrkspc} {prjName}

将指定的 SDK 示例项目克

隆到新名称下 1. {board} — SDK 包中

板的子目录 2. {example} — 自板子

目录的相对路径，以及

示例名称，例如：demo_apps/hello_world；使用“/”为路径

分隔符 3. {toolchain} — 用于

创建项目的工具链 id（参见“工具链 - 工具链 - id）

4. {wrkspc} — 创建新

项目的绝对路径，例

如：项目工作区 5. {prjName} — 新项目

的名称

需要-HeadlessTool PrjCloner 和-SDKpath {path} @since v3.0

-HeadlessTool PrjCloner -SDKpath c:\nxp\SDK_2.0_MKL43Z256 xxx4 -PG_clone twrk64f120m demo_apps/hello kds c:\tmp exmpl

8.8 管理数据和离线工作您可以使用数据管理器下载、导入和导出处理器数据。如果您想要在离线时充分利用工具，那么这个功能非

常有用。

管理数据和离线工作



图 114. 数据管理器

8.8.1 离线工作即使不联网，您也可以使用缓存的处理器数据来新建配置。为此，您必须在离线工作之前下载处理器相关数据，

或导入从在线计算机上下载和导出的数据。

要离线工作，则从主菜单中选择“编辑 > 首选项 > 离线工作”。

8.8.2 下载数据您可以使用数据管理器下载所需的处理器数据。

备注

默认情况下，在为处理器、板或套件进程新建单独配置期间，会自动下载和

缓存数据。

要下载处理器数据，则进行如下操作：

备注

数据下载需要联网。

1. 在数据管理器中，从列表中选择想要操作的处理器/板/套件。

2. 单击“更新/下载”，并确认。

数据现已下载至您的本地计算机，如数据管理器中缓存的状态所示。

8.8.3 导出数据您可以使用数据管理器以 ZIP 格式导出已下载的处理器数据。

要导出数据，则进行如下操作：

1. 在数据管理器中，单击“导出”。

2. 在“导出处理器数据”窗口中，选择想要导出的处理器数据。

3. 单击“浏览”以指定所生成的 ZIP 文件的位置和名称。

高级功能




ZIP 格式的数据现已保存在您的本地计算机上。您可以采用物理方式（例如：使用 U 盘）将数据移至离线

计算机上。

备注

您还可以从主菜单中选择“文件>导出>处理器数据>导出处理器数据”，导出

已下载的数据。

8.8.4 导入数据您可以使用数据管理器从另一台计算机导入处理器数据，前提是可在本地获得该数据。要导入数据，则进行如下

操作：

1. 在数据管理器中，选择“导入”。

2. 在“导入处理器数据”窗口中，指定想要导入的 ZIP 文件的地址。

3. 通过勾选复选框来选择要导入的数据。


数据现已导入至您的离线计算机，如数据管理器中缓存的状态所示。现在，您可以通过选择“新建...>为处

理器、板或套件新建单独配置”处理数据。

8.8.5 更新数据您可以使用数据管理器更新缓存的数据。

备注

数据更新需要联网。

要更新缓存的数据，则进行如下操作：

1. 在数据管理器中，通过单击“选择过时的数据”过滤掉过时的数据。

2. 单击“更新/下载”，并确认。

您可以单击“仅限缓存的数据”并比较“本地版本”和“远程版本”列中的版本信息来检查数据的版本。

您可以选择“清除缓存的数据”清除所有缓存的数据。这将移除您计算机上的所有处理器、板、套件和组

件数据，以及 SDK 信息文件。

备注

不影响用户模板。



第 9 章支持如果您有任何问题或需要额外帮助，可在论坛中搜索或发布新问题。访问：

https://community.nxp.com/community/mcuxpresso/mcuxpresso-config。

https://community.nxp.com/community/mcuxpresso/mcuxpresso-config

如何联系我们

主页：

nxp.com

网络支持：

nxp.com/support

本文档中的信息仅供系统和软件实施人员使用恩智浦产品时参考。本文档没有

授予根据本文档中的信息设计或制造任何集成电路的任何明示或暗示的版权许

可。恩智浦保留对本文档提及的任何产品进行更改的权利，恕不另行通知。

恩智浦不对其产品的特殊用途适用性做出任何担保、表示或保证，也不承担因

应用或使用任何产品或电路而产生的任何责任，特别要拒绝承担任何责任，包

括但不限于间接损害或无意损害。“典型值”参数可能在恩智浦数据手册和/或规格中提供，这些参数在不同应用中可能有所不同，实际性能可能随着时间推

移而变化。所有工作参数，包括“典型值”，必须针对每种客户应用，由客户的

技术专家进行验证。恩智浦不会转让其专利权或他方权利下的任何许可。恩智

浦按照标准销售条款和条件销售产品，具体条款内容请访问：

nxp.com/SalesTermsandConditions。

虽然恩智浦实施了高级安全功能，但所有产品都可能存在尚未明确的漏洞。客

户需要对其应用和产品的设计和运行负责，减少这些漏洞对客户应用和产品的

影响；恩智浦对发现的任何漏洞不承担任何责任。客户须实施适当的设计和操

作安全保障措施，以尽可能降低与应用和产品相关的风险。

恩智浦、恩智浦徽标、恩智浦“智慧生活，安全连结”、COOLFLUX、EMBRACE、GREENCHIP、HITAG、I2C BUS、ICODE、JCOP、LIFE VIBES、MIFARE、MIFARE CLASSIC、MIFARE DESFire、MIFARE PLUS、MIFARE FLEX、MANTIS、MIFARE ULTRALIGHT、MIFARE4MOBILE、MIGLO、NTAG、

ROADLINK、SMARTLX、SMARTMX、STARPLUG、TOPFET、TRENCHMOS、UCODE、飞思卡尔、飞思卡尔徽标、AltiVec、C-5、CodeTEST、CodeWarrior、ColdFire、ColdFire+、C-Ware、高能效解决方案徽标、Kinetis、Layerscape、MagniV、mobileGT、PEG、PowerQUICC、Processor Expert、QorIQ、QorIQ Qonverge、Ready Play、SafeAssure、SafeAssure 徽标、StarCore、Symphony、VortiQa、Vybrid、Airfast、BeeKit、BeeStack、CoreNet、Flexis、MXC、Platform in a Package、QUICC Engine、SMARTMOS、Tower、TurboLink 和 UMEMS是 NXP B.V.的商标。所有其他产品或服务名称均为其各自所有者的财产。

AMBA、Arm、Arm7、Arm7TDMI、Arm9、Arm11、Artisan、big.LITTLE、Cordio、CoreLink、CoreSight、Cortex、DesignStart、DynamIQ、Jazelle、Keil、Mali, Mbed、Mbed Enabled、NEON、POP、RealView、SecurCore、Socrates、Thumb、TrustZone、ULINK、ULINK2、ULINK-ME、ULINK-PLUS、ULINKpro、µVision、Versatile 是 Arm Limited（或其子公司）在美国和/或其他地区的商标

或注册商标。相关技术可能受任何或所有专利、版权、设计和商业机密的保护。

保留所有权利。Oracle 和 Java 是 Oracle 和/或其关联公司的注册商标。Power Architecture 和 Power.org 文字标记、Power 和 Power.org 徽标及相关标记是

Power.org 的授权商标和服务标记。

© NXP B.V. 2016-2019. 保留所有权利。欲了解更多信息，请访问：http://www.nxp.com

欲咨询销售办事处地址，请发送电子邮件至：[email protected]

发布日期：2019 年 11 月文档编号：GSMCUXCTUG

mcuxpresso 配置工具用户指南 （桌面版）这些工具套件称为mcuxpresso...

Documents

mcuxpresso 配置工具用户指南（桌面版）这些工具套件称为mcuxpresso...