i.MX RT1170评估套件快速入门

多核应用程序项目由两个(或多个)链接的项目组成， 一个项目包含主代码，另一个项目包含从代码。“主”项目包含一个指向“从”项目的链接，在构建主项目时，“从”项目的输出镜像将包含在“主”镜像中。构建主项目将触发先构建从项目。

RT1170 SDK提供了一系列多核示例应用程序。每个多核示例都有两个源目录，一个用于Arm CM7，一个用于Arm CM4。

构建并闪存多核应用

以下步骤将指导您使用MCUXpresso IDE来运行Multicore Hello World应用。

注：MCUXpresso IDE安装参见“快速入门”网页的“2. 获取软件”。

1. 打开MCUXpresso IDE。
2. 切换到MCUXpresso IDE窗口中"已安装SDK"视图。

3. 将MIMXRT1170-EVK SDK(压缩)文件拖放到已安装SDK视图中。
4. 您将看到以下弹出窗口。点击OK继续导入：

5. 已安装的SDK将显示在“已安装SDK”视图中，如下所示：

6. 在左下角找到快速启动面板。

7. 然后点击“导入SDK示例……”

8. 点击evkmimxrt1170板，选择导入可在该板上运行的示例，然后单击Next(“下一步”)。

9. 使用箭头按钮展开multicore_examples类别，然后点击hello_world_cm7旁的复选框选择该项目；您将注意到，选择cm7项目后，也将选择cm4项目。要使用UART进行打印(而不是默认的半主机)，请在项目选项下选择UART作为“SDK调试控制台”复选框。然后点击Finish。

10. 验证hello_world_cm7和hello_world_cm4现已包含在Project Explorer中。

11. 选择hello_world_cm7项目并构建它。注意：MCUXpresso将先构建hello_world_cm4项目，然后再构建hello_world_cm7。

12. 该项目将顺利构建。

运行示例应用

如需下载并运行该应用，请执行以下步骤：

1. 该板默认支持CMSIS-DAP/mbed/DAPLink硬件调试器。访问Windows串行配置，并按说明安装Windows^®操作系统串行驱动程序。如在Linux操作系统上运行，则无需执行这一步。
2. 将板连接到电脑。考虑以下内容：
   • 确保SW1设为0010，以便从QSPI启动
   • 将电源连接至J43(如果J38设为[1-2])
   • 使用微型USB至J11端口将PC与板连接起来。

3. 打开PC上的终端应用(如PuTTY或TeraTerm)，并连接到调试串行端口。采用以下设置配置终端：
   1. 波特率：115200(BOARD_DEBUG_UART_BAUDRATE)
   2. 无奇偶校验位
   3. 数据位为8
   4. 停止位为1。

4. 选择hello_world_cm7和应用到您的MIMXRT1170-EVK。

5. 选择DAPLink硬件调试器，然后点击“OK”。

6. 自动出现另一个“发现调试器”窗口，这用于hello_world_cm4项目。再次选择DAPLink硬件调试器，然后点击“OK”。
7. 点击“恢复”按钮，启动hello_world_cm7项目。

8. 点击“恢复”按钮，启动hello_world_cm4项目。

9. 现在两个内核都在运行。控制台应显示以下输出：

10. 点击multi core stop，退出调试会话。

参见SDK的/docs文件夹中的Getting Started with MCUXpresso SDK for MIMXRT1170-EVK.pdf，了解构建和运行示例应用的详细信息和指南。

构建示例应用

遵循以下步骤运行hello_world应用。对于其他示例应用，这些步骤可能会略有不同，因为某些应用的路径可能会有额外的文件夹层级。

1. 首先解压先前下载的SDK。
2. 如果还未完成，打开所需示例应用工作区：大多数示例应用演示工作区文件位于以下路径：

1复制 /boards/////iar 

以hello_world演示为例，路径为：

1复制 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/iar/hello_world.eww 

3. 从下拉列表中选择所需的构建目标。对于本示例，选择hello_world – debug

4. 要构建应用，点击"Make"按钮(下文中用红色突出显示)。

5. 构建将完成，并且不会报错。


注：如出现构建错误，请确保选择了正确的板，右击project >> Options >> General Options >> Target >> Device，选择NXP MIMXRT1176xxxA_M7，在IAR Embedded Workbench for Arm 8.50.6或更高版本中支持此板。

运行示例应用

如需下载并运行该应用，请执行以下步骤：

1. 该板默认支持CMSIS-DAP/mbed/DAPLink硬件调试器。访问Windows串行配置，并按说明安装Windows^®操作系统串行驱动程序。如在Linux操作系统上运行，则无需执行这一步。
2. 将板连接到电脑。考虑以下内容：
   • 确保SW1设为0010，以便从QSPI启动
   • 将电源连接至J43(如果J38设为[1-2])
   • 使用微型USB至J11端口将PC与板连接起来。

3. 打开PC上的终端应用(如PuTTY或TeraTerm)，并连接到调试串行端口。采用以下设置配置终端：
   1. 波特率：115200(BOARD_DEBUG_UART_BAUDRATE)
   2. 无奇偶校验位
   3. 数据位为8
   4. 停止位为1。

4. 点击"Download and Debug"按钮，将应用下载到目标。

5. 然后，可将此应用下载到目标应用，并自动运行到main()函数。
6. 点击"Go"按钮运行代码，以启动应用。

7. hello_world应用开始运行，标语显示在终端上。如未显示，请检查您的终端设置和连接。

参见SDK的/docs文件夹中的Getting Started with MCUXpresso SDK for MIMXRT1170-EVK.pdf，了解构建和运行示例应用的详细信息和指南。

安装CMSIS设备包

安装MDK工具后，必须安装Cortex^®微控制器软件接口标准(CMSIS)设备包，才能从调试角度来说完全支持该器件。这些器件包包括存储器映射信息、寄存器定义和闪存编程算法。按照这些步骤安装相应的CMSIS包。

1. 下载MIMXRT1171、MIMXRT1172、MIMXRT1173、MIMXRT1175和MIMXRT1176包。
2. 下载DFP后，双击进行安装。
3. 安装完成后，关闭Pack Installer窗口并返回到µVision IDE。

构建示例应用

遵循以下步骤打开hello_world_demo_cm7应用。

1. 在以下路径打开所需示例应用工作区：

1复制 /boards////mdk 

此工作区文件名为.uvmpw。在这个具体示例中，实际路径为：

1复制 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/mdk/hello_world_demo_cm7.uvmpw 

2. 要构建演示项目，请选择"Rebuild"，用红色突出显示。

3. 构建将完成，并且不会报错。

运行示例应用

本节将介绍使用J-Link GDB Server应用运行演示应用的步骤。要执行练习，确保以下几点：

如需下载并运行该应用，请执行以下步骤：

1. 该板默认支持CMSIS-DAP/mbed/DAPLink硬件调试器。访问Windows串行配置，并按说明安装Windows^®操作系统串行驱动程序。如在Linux操作系统上运行，则无需执行这一步。
2. 将板连接到电脑。考虑以下内容：
   • 确保SW1设为0010，以便从QSPI启动
   • 将电源连接至J43(如果J38设为[1-2])
   • 使用微型USB至J11端口将PC与板连接起来。

3. 打开PC上的终端应用(如PuTTY或TeraTerm)，并连接到调试串行端口。采用以下设置配置终端：
   1. 波特率：115200(BOARD_DEBUG_UART_BAUDRATE)
   2. 无奇偶校验位
   3. 数据位为8
   4. 停止位为1
   
4. 应用构建完成后，点击"Download"按钮，将应用下载到目标。

5. 点击“启动/停止调试会话”以打开调试视图。

6. 点击"Run"按钮运行代码，以启用应用。

7. hello_world_demo_cm7应用现已运行。

参见SDK的/docs文件夹中的Getting Started with MCUXpresso SDK for MIMXRT1170-EVK.pdf，了解构建和运行示例应用的详细信息和指南。

安装工具链

本节包含采用MCUXpresso SDK支持的Arm GCC工具链构建并运行MCUXpresso SDK演示应用所需的必要组件的安装步骤。Arm GCC工具有许多使用方式，但此例主要演示其在Windows环境中的使用。虽然这里未讨论，但GCC工具还可与Linux操作系统和Mac OSX配套使用。

安装GCC Arm嵌入式工具链

从launchpad.net/gcc-arm-embedded下载并运行安装程序。这是我们实际使用工具包(换句话说编译器、链接器等)。GCC工具链应当对应最新的支持版本，参见/docs文件夹中的MCUXpresso SDK Release Notes Supporting MIMXRT1170-EVK。

安装MinGW

Minimalist GNU for Windows(MinGW)开发工具提供了一套独立于第三方C-Runtime DLL(如Cygwin)的工具。MCUXpresso SDK所用的构建环境无需使用MinGW Build工具，但充分利用了MinGW和MSYS的基础安装。MSYS为与Unix类似的接口和工具提供基本的Shell。

1. 
   从sourceforge.net/projects/mingw/files/Installer/下载最新的MinGW mingw-get-setup安装程序。
2. 运行安装程序。推荐的安装路径为C:\MinGW，但是，您可以将其安装到任何位置。

注：此安装路径不包含任何空格。

3. 确保在 Basic Setup下选择了mingw32-base和msys-base 。

4. 在安装菜单中，点击Apply Changes，并按照其余指令完成安装。

5. 添加相应项目到Windows操作系统的Path环境变量。在Environment Variables...部分的Control Panel -> System and Security -> System -> Advanced System Settings下可找到它。路径为：

\bin

假设默认安装路径为C:\MinGW，此例如下所示。如果路径设置不正确，工具链将不起作用。

注：如果您的PATH变量中包含C:\MinGW\msys\x.x\bin(根据KSDK 1.0.0要求)，应删除该路径以确保新的GCC构建系统正常工作。

为ARMGCC_DIR添加新环境变量

创建新的系统环境变量并命名为ARMGCC_DIR。此变量的值应当指向Arm GCC嵌入式工具链安装路径，此例中的安装路径为：

1复制 C:\Program Files (x86)\GNU Tools ARM Embedded\ 

参考GNU Arm GCC嵌入式工具的安装文件夹，获得确切的安装路径名。

安装CMake

1. 从
   CMake下载中下载CMake 3.0.x。
2. 安装CMake，确保安装时选择Add CMake to system PATH(将CMake添加到系统PATH)。由用户选择是为所有用户还是只为当前用户将其安装到PATH。在这个示例中，假设为所有用户安装了此应用。

3. 按照安装程序的其余指令操作。
4. 可能需要重启系统，才能使PATH更改生效。
5. 确保 Environment Variable PATH中没有sh.exe。这是mingw32-make的限制。

构建示例应用

要构建示例应用，请按照这些步骤操作。

1. 打开GCC Arm嵌入式工具链命令窗口。要启动窗口，需从Windows操作系统Start菜单进入“Programs -> GNU Tools Arm Embedded ”，然后选择“GCC Command Prompt”。

2. 将目录更改为示例应用项目目录，它有如下路径：

1复制 /boards////armgcc 

对于本指南，确切的路径为：

1复制 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/armgcc 

3. 在命令行键入"build_debug.bat"或双击Windows操作系统Explorer中的"build_debug.bat"文件，执行构建。输出显示如图：

运行示例应用

本节将介绍使用J-Link GDB Server应用运行演示应用的步骤。要执行练习，确保以下几点：

• 板上的Freelink/LPC-Link2接口已编程了J-Link固件。如果您的板不支持Freelink/LPC-Link2接口，则需要单独的J-Link pod。
• 您拥有独立的J-Link Pod，并且连接至板的调试接口。

注：某些硬件平台需要修改硬件，以便通过外部调试接口正常运行。

使用J-Link固件配置Freelink/LPC-Link2接口的步骤：

1. 为MIMXRT1170-EVK断电
2. 将跳线连接至J22头，进入DFU引导模式。
3. 为MIMXRT1170-EVK通电
4. 通过J11端口连接到PC
5. 从LPCScrypt v2.1.2下载并安装LPCScrypt
6. 从LPCScrypt位置前往脚本文件夹。
   即C:/NXP/LPCScrypt_2.1.1_15/scripts
7. 运行“program_JLINK.cmd”脚本
8. 脚本完成后，关闭LPCScrypt窗口
9. 为MIMXRT1170-EVK断电
10. 从J22头拔下跳线
11. 为MIMXRT1170-EVK通电
12. 验证设备管理器现在列出了J-Link接口

配置并连接J-Link接口之后，按照以下步骤下载并运行演示应用：

1. 通过LPC-Link2(J11) USB接头和PC USB接头之间的USB线缆，将开放平台连接到PC。如果使用独立的J-Link调试Pod，也要将其连接至板的SWD/JTAG接头。

2. 打开J-Link GDB服务器应用。假设已安装了J-Link软件，进入Windows操作系统“开始”菜单并选择"Programs -> SEGGER -> J-Link J-Link GDB Server"，可以启动此应用。
3. 选择设备“MIMXRT1176xxxA_M7”和目标接口到SWD。

4. 验证GDB服务器在等待GDB连接。

5. 打开PC上的终端应用(如PuTTY或TeraTerm)，并连接到调试串行端口。采用以下设置配置终端：
1. 115200(参考board.h文件中的BOARD_DEBUG_UART_BAUDRATE)
2. 无奇偶校验位
3. 数据位为8
4. 停止位为1

6. 如果没有运行，则打开GCC Arm嵌入式工具链命令窗口。要启动窗口，需从Windows操作系统“开始”菜单进入“Programs -> GNU Tools Arm Embedded ”，然后选择“GCC Command Prompt”。

7. 更改为包含演示应用输出的目录。根据所选的构建目标，使用以下2个路径中的一个可以找到此输出：

1复制 /boards////cm7/armgcc/debug 

1复制 /boards////cm7/armgcc/release 

对于本指南，路径为：

1复制 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/armgcc/debug 

8. 运行arm-none-eabi-gdb.exe .elf。对于本示例，命令为arm-none-eabi-gdb.exe hello_world.elf。

9. 在GCC Command Prompt运行这些命令：
   • target remote localhost: 2331
   • monitor reset
   • monitor halt
   • load
10. 此应用已下载成功并停留在复位矢量。
    执行"monitor go"命令来启动演示应用。

hello_world应用开始运行，标语显示在终端上。如未显示，请检查您的终端设置和连接。

参见SDK的/docs文件夹中的Getting Started with MCUXpresso SDK for MIMXRT1170-EVK.pdf，了解构建和运行示例应用的详细信息和指南。