FRDM-KL27Z快速入门指南

了解详情。

• 通过SWD和JTAG支持调试
• 软件灵活性高
• 全套外设驱动程序，含源代码
• 应用示例和项目文件

了解详情 。

• 在线编译器，无SWD或JTAG调试
• 简单但高度抽象的编程接口
• 有用但受限的驱动程序，带源代码
• 技术社区提交的示例

导入MCUXpresso SDK

1. 打开MCUXpresso IDE
2. 切换到MCUXpresso IDE窗口中的“已安装SDK”视图
3. 打开Windows资源管理器，并将FRDM-KL27Z SDK (解压)文件拖放到“已安装SDK”视图中
4. 您将看到以下弹出窗口。点击“确定”继续导入：
5. 已安装的SDK将显示在“已安装SDK”视图中，如下所示：

构建示例应用

以下步骤将指导您打开hello_world示例。

1. 在左下角找到快速启动面板
2. 然后点击“导入SDK示例”
3. 点击frdmkl27z板，选择导入可在该板上运行的示例，然后点击Next (“下一步”)。
4. 使用箭头按钮展开"demo_apps"类别，然后点击hello_world旁边的复选框来选择该项目。要使用UART进行打印(而不是默认的半主机)，请清除项目选项下的“启用半主机”复选框。然后点击Next (下一步)。
5. 现在点击项目名称，然后点击Build(构建)图标，即可构建项目。
6. 您可以在“控制台”选项卡中查看构建的状态。

运行示例应用

1. 项目已经编译好了，现在您可以将其烧写到板上并运行它
2. 确保已连接FRDM-KL27Z板，然后点击快速启动面板中的"Debug" (调试)
3. MCUXpresso IDE将探测互联的板，并应查找MBED CMSIS-DAP硬件调试器，此硬件调试器是FRDM-KL27Z上OpenSDA集成电路的一部分。点击OK (确定)继续。
4. 固件将被下载到板上，调试器开始运行
5. 打开一个终端程序，并连接到板枚举的COM端口。使用115200波特率，数据位为8，无奇偶校验位，停止位为1。
6. 点击"Resume"(继续)按钮启动应用。
7. hello_world应用开始运行，标语显示在终端上。如未显示，请检查您的终端设置和连接
8. 使用菜单栏的控件暂停、单步进入和单步跳过指令，然后点击Terminate(终止)图标停止调试会话：

构建示例应用

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

1. 如果还未完成，在以下路径中打开所需的示例应用工作区：大多数示例应用工作区文件位于以下路径：

   /boards////iar

   以hello_world演示为例，路径为：

   /boards/frdmkl27z/demo_apps/hello_world/iar

2. 从下拉列表中选择所需的构建目标。在这个例子中，选择"hello_world-Debug"目标
3. 要构建应用，点击"Make"按钮(下文中用红色突出显示)。
4. 构建将完成，并且不会报错。

运行示例应用

FRDM-KL27Z板出厂时预装了mbed/CMSIS-DAP调试接口。如果您已经更改了板上的调试OpenSDA应用，请访问OpenSDA，了解如何更新板或将板恢复到出厂状态。

1. 通过板上SDAUSB USB端口和PC USB连接器之间的USB线缆，将开发平台连接到PC。
2. 打开PC上的终端应用(如PuTTY或Tera Term)，并连接到之前确定的调试COM端口。采用以下设置配置终端：
   • 波特率为115200
   • 无奇偶校验位
   • 数据位为8
   • 停止位为1
3. 点击"Download and Debug" (下载和调试)按钮，将应用下载到目标。
4. 然后，可将此应用下载到目标应用，并自动运行到main()函数。
5. 点击"Go"按钮运行代码，以启动应用。
6. hello_world应用开始运行，标语显示在终端上。如未显示，请检查您的终端设置和连接

安装CMSIS设备包

安装MDK工具后，必须安装Keil设备包，才能从调试方面完全支持设备。这些设备包内含存储器映射信息、寄存器定义和闪存编程算法。按照这些步骤安装相应的CMSIS包。

1. 打开名为µVision的MDK IDE。在IDE中，选择“Pack Installer”图标。
2. 在Pack Installer窗口中，搜索“kl27”以显示KL27Z系列。点击MKL27Z64xxx4名称，然后在右侧，您将看到NXP::MKL27Z644_DFP包。点击设备包旁的"Install"(安装)按钮。此流程需要连接互联网才能完成
3. 安装完成后，关闭Pack Installer窗口并返回到µVision IDE。

构建示例应用

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

1. 如果还未完成，在以下路径中打开所需的演示应用工作区：

   /boards////mdk

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

   /boards/frdmkl27z/demo_apps/hello_world/mdk/hello_world.uvmpw

2. 要构建演示项目，请选择用红色突出显示的"Rebuild"按钮。
3. 构建将完成，并且不会报错。

运行示例应用

FRDM-KL27Z板出厂时预装了mbed/CMSIS-DAP调试接口。如果您已经更改了板上的调试OpenSDA应用，请访问OpenSDA，了解如何更新板或将板恢复到出厂状态。

1. 通过板上SDAUSB USB端口和PC USB连接器之间的USB线缆，将开发平台连接到PC。
2. 打开PC上的终端应用(如PuTTY或Tera Term)，并连接到之前确定的调试COM端口。采用以下设置配置终端：
   • 波特率为115200
   • 无奇偶校验位
   • 数据位为8
   • 停止位为1
3. 应用构建完成后，点击"Download" (下载)按钮，将应用下载到目标。
4. 点击"Go"按钮运行代码，以启动应用。
5. hello_world应用开始运行，标语显示在终端上。如未显示，请检查您的终端设置和连接

安装工具链

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

安装GCC Arm嵌入式工具链

从GNU Arm Embedded Toolchain 下载并运行安装程序。这是实际的工具链(例如，编译器、链接器等)。GCC工具链应当对应最新的支持版本，参见Kinetis SDK版本说明。

安装MinGW

Minimalist GNU for Windows (MinGW)开发工具提供了一套独立于第三方C-Runtime DLL (如Cygwin)的工具。KSDK所用的构建环境无需使用MinGW Build工具，但充分利用了MinGW和MSYS的基础安装。MSYS提供了一个具有类UNIX界面和相关工具的基本Shell。

1. 从以下位置下载最新的 MinGW "mingw-get-setup"安装程序：MinGW - Minimalist GNU for Windows Files
2. 运行安装程序。推荐的安装路径为C:\MinGW，也可将其安装到任何位置

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

3. 确保在Basic Setup下选择了"mingw32-base"和"msys-base"
4. 点击"Installation"(安装)菜单中的"Apply Changes"(应用更改)，并按照其余指令完成安装

5. 在Windows操作系统的Path环境变量中添加相应的项目。可在Control Panel → System and Security → System → Advanced System Settings(控制面板→系统和安全→系统→高级系统设置)下的"Environment Variables..."(环境变量)部分找到它。路径为：

   \bin

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

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

   

为ARMGCC_DIR添加新环境变量

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

   C:\Program Files (x86)\GNU Tools Arm Embedded\4.9 2015q3

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

安装CMake

1. 从以下位置下载CMake 3.0.x：CMake
2. 安装CMake，确保安装时选择"Add CMake to system PATH"(在系统PATH中添加CMake)选项。由用户选择是为所有用户还是只为当前用户将其安装到PATH。在这个示例中，假设为所有用户安装了此应用
3. 按照安装程序的其余指令操作
4. 可能需要重启系统，才能使PATH更改生效

构建示例应用

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

1. 如未运行，则打开GCC Arm嵌入式工具链命令窗口。要启动该窗口，需从Windows操作系统的“开始”菜单，进入"Programs → GNU Tools Arm Embedded "，然后选择"GCC Command Prompt"

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

   /boards////armgcc

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

   /boards/frdmkl27z/demo_apps/hello_world/armgcc

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

运行示例应用

GCC工具需要J-Link调试接口。要将板上的OpenSDA固件更新为最新的J-Link应用，请访问OpenSDA。安装J-Link OpenSDA应用后，从Segger Downloads 下载J-Link驱动程序和软件包。

1. 通过板上SDAUSB USB端口和PC USB连接器之间的USB线缆，将开发平台连接到PC。
2. 打开PC上的终端应用(如PuTTY或Tera Term)，并连接到之前确定的调试COM端口。采用以下设置配置终端：
   • 波特率为115200
   • 无奇偶校验位
   • 数据位为8
   • 停止位为1
3. 打开J-Link GDB Server应用。假设已安装了J-Link软件，进入Windows操作系统的“开始”菜单并选择"Programs → SEGGER → J-Link J-Link GDB Server"，可以启动此应用。
4. 修改设置，如下所示。这个示例中所选的目标设备为“MKL27Z64xxx4”，并使用SWD接口
5. 设备连接后，屏幕显示如图：
6. 如未运行，则打开GCC Arm嵌入式工具链命令窗口。要启动该窗口，需从Windows操作系统的“开始”菜单，进入"Programs → GNU Tools Arm Embedded "，然后选择"GCC Command Prompt"

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

   /boards////armgcc/debug

   /boards////armgcc/release

   对于本指南，路径为：

   /boards/frdmkl27Z/demo_apps/hello_world/armgcc/debug

8. 运行命令"arm-none-eabi-gdb.exe .elf"。对于本示例，命令为"arm-none-eabi-gdb.exe hello_world.elf"
9. 运行以下命令：
   • target remote localhost:2331
   • monitor reset
   • monitor halt
   • load
   • monitor reset
10. 此应用已下载成功并停留在复位矢量。执行"monitor go"命令来启动示例应用
11. hello_world应用开始运行，标语显示在终端窗口上。

1. 打开MCUXpresso IDE
2. 在快速启动面板中点击“导入SDK示例”
3. 点击frdmkl27z板，选择导入可在该板上运行的示例，然后点击Next (“下一步”)。
4. 在搜索栏输入“LED”，并在GPIO驱动器示例下选择“gpio_led_output”项目。此特定项目不使用UART，但对于使用UART的项目，确保为“SDK调试控制台”选择“UART”选项。然后点击Finish(完成)。
5. 点击“Project Explorer”视图中的“frdmkl27z_gpio_led_output”项目，并如上所述构建、编译和运行演示
6. 您将看到LED红灯在板上闪烁。
7. 终止调试会话。

1. 打开MCUXpresso配置工具
2. 在弹出的向导中，浏览到解压MCUXpresso SDK的位置，然后选择“克隆SDK示例并创建一个新配置”单选按钮，然后点击“下一步”。
3. 在下一个窗口，选择之前已解压的MCUXpresso SDK的位置。然后选择正在使用的IDE
4. 选择要克隆的项目。对于这个例子，要使用LED项目。可以在筛选框中输入“led”，然后选择“gpio_led_output”项目来进行筛选。然后，还可以指定克隆项目的位置。接着，点击Finish (完成)。
5. 克隆后，转到您选择的目录，并打开IDE的项目。导入、编译和运行项目，如前几节所述
6. 您将看到LED红灯在板上闪烁。
7. 终止调试会话。
8. 返回MCUXpresso配置工具程序，继续下一节，学习如何使用引脚工具

1. 如果使用MCUXpresso IDE，右击"frdmkl27z_gpio_led_output"项目，选择“MCUXpresso配置工具” ，然后点击“打开引脚”，即可打开引脚工具
2. 如果使用MCUXpresso配置工具程序，而引脚工具尚未打开，则选择已克隆的项目。
3. 然后，从工具栏选择Tools->Pins (工具->引脚)，打开引脚工具。
4. 引脚工具现在应该显示“led_output”项目的引脚配置。
5. 在“引脚”视图中，查看“路由的引脚”勾选框，可看到该项目所有路由的引脚。可以看到与引脚相关联的外设、信号名称和引脚选项。
6. 在当前配置中，PTB18可路由为GPIO，以切换红色LED。在该示例中，我们将使用PTA13来驱动蓝色LED
7. 在“引脚”窗口中，向下滚动直到看到PTB18。点击其旁边的复选框以取消选中。
8. 将出现下面的对话框。点击PTB18旁边取消选择，然后点击“完成”
9. 搜索PTA13，然后点击PTA13旁边的复选框以使用该引脚，选择PTA13 GPIO引脚
10. PTA13已经为“led_output”示例配置的FRDM-KL27Z设置了一个定义的标识符(即LED_BLUE)。在引脚表中的PTA13旁，将标识符更改为My_LED
11. 现在是时候导出由引脚工具生成的最新pin_mux.c和pin_mux.h文件，将这些更改实施到GPIO项目中。在菜单栏中点击“更新项目”。
12. 弹出的窗口将显示正在更改的文件，您可以点击“diff”查看当前文件与引脚工具生成的新文件之间的差异。点击“确定”将新文件覆盖到项目中

注：时钟和外设文件也可能被标记为正在更新，因为标题已被更改。


13. 现在，在IDE中，打开“gpio_led_ouput.c”文件
14. 更改两个#defines，告知GPIO项目使用新的PTA13引脚。使用引脚工具创建的pin_mux.h中的#defines。

#define BOARD_LED_GPIO BOARD_INITPINS_MY_LED_GPIO
#define BOARD_LED_GPIO_PIN BOARD_INITPINS_MY_LED_PIN


15. 现在，和之前一样构建和运行该项目。您将看到蓝色LED在闪烁！

1. 如果使用MCUXpresso IDE，右击"frdmkl27z _gpio_led_output"项目，选择“MCUXpresso配置工具” ，然后点击“打开时钟”，即可打开时钟工具
2. 如果使用MCUXpresso配置工具程序，而时钟工具尚未打开，则选择已克隆的项目
3. 从工具栏选择Tools->Clocks (工具->时钟)，打开时钟工具。
4. "led_output"项目的时钟配置将显示在时钟工具中：
5. 点击左上角的选项卡，切换到Clocks Diagram (时钟图)视图。
6. 点击Core Clock (内核时钟)字段并输入“12”，以更改内核时钟频率。您将看到所有其他时钟值也会自动更改，以适应这个较慢的速度。完成后，显示如下：
7. 现在，是时候导出由时钟工具生成的最新的clock_config.c和clock_config.h文件，将这些更改实施到GPIO项目中。在菜单栏中点击“更新项目”。
8. 弹出的窗口将显示正在更改的文件，您可以点击“diff”查看当前文件与时钟工具生成的新文件之间的差异。点击“确定”将新文件覆盖到项目中

注：引脚和外设文件也可能被标记为正在更新，因为标题已被更改。


9. 现在，打开IDE中的led项目，并像以前一样构建、下载和运行项目。
10. 蓝色LED现在应以较慢的速度不断闪烁！