Freescale Semiconductor Document Number: KSDK12GSUG User's Guide Rev 0, 4/2015 Kinetis SDK (KSDK) v.1.2 快速入门 1 概述 Kinetis SDK (KSDK) 是一款软件开发套件, 可为 Freescale Kinetis 器件提供全面的软件支持 KSDK 包括为每个外设提供的硬件抽象层 (HAL) 以及基于 HAL 的外设驱动程序 演示应用和驱动程序示例旨在演示驱动程序和 HAL 的用途以及突出显示受支持 SoC 的主要功能 此外,KSDK 还包括最新的 RTOS 内核 USB 协议栈 和其他中间件, 以支持在受支持的 Kinetis 器件上进行快速开发 下图突出显示了 KSDK 的层和功能 对于受支持工具链版本, 请参考 Kinetis SDK 版本说明 ( 文档 KSDK120RN) 如需最新版本以及其他 Kinetis SDK 文档, 请访问 Kinetis SDK 主页 www.freescale.com/ksdk 内容 1 概述......1 2 KSDK 演示应用和驱动程序示例...... 2 3 使用 IAR 运行演示应用... 5 4 使用 Keil MDK/μVision 运行演示应用...... 10 5 使用 Kinetis Design Studio IDE 运行演示应用...... 16 6 使用 Atollic TrueSTUDIO 运行演示应用...... 27 7 使用 ARM GCC 运行演示应用... 34 8 附录 A - 如何确定 COM 端口...... 44 9 附录 B - 默认调试接口...46 10 附录 C - 更新 OpenSDA 固件...... 47 11 修订历史记录...48 2015 Freescale Semiconductor, Inc.
KSDK 演示应用和驱动程序示例 用户应用程序 协议栈和中间件 OSA 外设驱动程序 开发板配置 硬件抽象层 系统服务 CMSIS 内核头文件 SOC 头文件 IP 扩展头文件 硬件 CMSIS DSP 图 1. KSDK 层 2 KSDK 演示应用和驱动程序示例 KSDK 提供两类软件示例 : 演示应用 : 功能完备的应用, 用于突出显示 MCU 的主要功能, 强调特定用例 驱动程序示例 : 简单应用, 用于准确地说明如何使用 KSDK 外设驱动程序 本章节介绍了演示应用和驱动程序示例如何与 KSDK 的其他组件互动 要全面了解所有 KSDK 组件及其文件夹结构, 请参见 Kinetis SDK API 参考手册 ( 文档 KSDK12APIRM) 演示应用和驱动程序示例位于与特定开发板对应的文件夹中 (<install_dir>/examples/<board_name>) 在每个开发板文件夹内, 有多个文件夹包含演示应用 (demo_apps 文件夹 ) 和驱动程序示例 (driver_examples 文件夹 ) 集 此文档重点介绍演示应用, 因为它们是功能完备的应用 适用于演示应用的任何内容均适用于驱动程序示例 打开开发板对应的文件夹 (<install_dir>/examples/<board_name>) 时, 将会看到以下目录结构 : 2 Freescale Semiconductor, Inc.
KSDK 演示应用和驱动程序示例 特定开发板演示应用 特定开发板驱动程序示例 Processor Expert 开发板配置文件 共享的特定开发板配置 / 初始化文件 图 2. 开发板文件夹结构 每个开发板文件夹顶层为演示应用和驱动程序示例使用的通用文件 可以修改这些文件以进行诸如更改引脚复用配置之类的操作 KSDK 中提供的所有开发板支持文件都是基于 *.peb 文件产生的, 这些支持文件包括 : board.c/h: 此头文件包含板级相关的配置宏, 用于配置调试终端 按键 LED 等 C 文件包含时钟和晶振的初始化函数 gpio_pins.c/h: GPIO 引脚定义, 包括按键和 LED, 也可以包括诸如外部传感器中断引脚之类的其他项目 pin_mux.c/h: 包含特定外设引脚复用配置 这些函数可供 hardware_init() 函数调用或单独由演示应用调用 Processor Expert PEB 文件 : 针对特定开发板的 Freescale Processor Expert 工具的参考文件 打开 demo_apps 文件夹, 通常目录结构如下图所示 : 工具链 /IDE 工程文件 特定演示应用的硬件初始化函数 演示应用 main() 函数 图 3. 演示应用文件夹结构 Freescale Semiconductor, Inc. 3
KSDK 演示应用和驱动程序示例 2.1 查找演示应用源文件 在任何受支持 IDE 中打开演示应用或驱动程序示例时, 可以看到工程使用到的源文件 了解这些源文件在 KSDK 目录结构中的位置, 以便在需要时将其复制或修改, 有助于后续为自定义硬件开发应用 此外, 许多文件是共享的, 如果修改, 将影响其他演示应用 因此, 用户应完全掌握 KSDK 结构, 以完全了解操作源文件的影响 KSDK 软件包中的另外两个文件夹为每个演示应用提供完整的源代码 : <install_dir>/platform: 包含特定 SoC 的共享链接文件 启动代码和源文件, 适用于 KSDK HAL 外设驱动程序和系统服务 <install_dir>/lib: 包含 KSDK 平台组件的编译库文件, 如 HAL 外设驱动程序 启动代码和系统服务 2.2 KSDK platform 文件夹 此文件夹是 KSDK 中最重要的文件夹 它是 KSDK 的基础, 包括 CMSIS 头文件 外设驱动程序 HAL OSA 操作系统抽象层 启动 系统服务和链接文件 成功编译演示应用需要上述大部分组件 可使用两种方法来编译使用 KSDK 平台组件的演示应用 : 方法 1, 将单独的源文件 ( 启动文件 驱动程序 ) 添加到工程中 ; 方法 2, 直接链接已包含所有组件的库文件 KSDK 中的所有演示应用均使用第二种方法 这可简化应用开发, 因为它只需要在工程文件中正确设置包含路径, 无需用户手动添加应用所需的每个文件 2.3 KSDK lib 文件夹 前面章节介绍了 KSDK 演示应用如何引用包含 platform 文件夹所有组件的库 这些库文件位于 lib 文件夹下的 ksdk_platform_lib 目录中 图 4. Lib 文件夹 Lib 文件夹中的每个库均包含所支持工具链的文件夹, 每个工具链文件夹均包含所支持 SoC 系列的文件夹 在使用演示应用时必须编译对应的 ksdk_platform_lib, 这将会在后面的工具链章节详细讨论 4 Freescale Semiconductor, Inc.
使用 IAR 运行演示应用 3 使用 IAR 运行演示应用 本章节介绍了编译 运行和调试 Kinetis SDK 中所提供的演示应用所需的步骤 本章节还介绍了如何编译演示应用所需使用的库 所用示例为 hello_world 演示应用, 针对带的 FRDM-K64F Freedom 硬件平台, 但这些步骤适用于 KSDK 中的任何演示或示例应用 3.1 编译平台库 以下步骤介绍了如何在 IAR Embedded Workbench 中打开演示应用工作空间 如何编译演示应用所需的平台库以及如何编译演示应用 1. 打开以下位置的演示应用工作空间 :<install_dir>/examples/<board_name>/demo_apps/<demo_name>/iar 此工作空间文件的名称为 <demo_name>.eww, 因此, 对于本特定示例, 实际路径为 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/iar/hello_world.eww 打开工作空间后, 将会显示两个工程 : 一个用于 KSDK 平台库, 另一个用于演示应用 此外, 平台库工程粗体显示表示其为活动工程 可以通过右键单击所需工程并选择 Set as Active 或者通过工作空间浏览器顶部的编译目标下拉菜单随时更改活动工程 图 5. 工作空间视图 2. 每个 KSDK 工程支持两种工程配置 ( 编译目标 ): 调试 (Debug) 编译优化设为低, 并且将为可执行文件生成调试信息 此目标应被选择用于开发和调试 发布 (Release) 编译优化设为高, 并且不会生成调试信息 此目标应被选择用于最终应用部署 此工具允许您根据每个工程情况选择调试或发布配置, 但由于演示应用对平台库具有依赖性, 因此, 必须为演示应用和平台库选择相同的配置 在下拉菜单中选择配置也会使选定的工程和配置成为活动工程 对于本示例, 请选择 ksdk_platform_lib Debug 目标 Freescale Semiconductor, Inc. 5
使用 IAR 运行演示应用 图 6. 选择平台库编译目标 3. 单击下面红色突出显示的 Make 按钮 图 7. 编译平台库 4. 编译完成之后, 将根据所选编译目标在以下其中一个目录下生成库 (libksdk_platform.a): <install_dir>/lib/ksdk_platform_lib/iar/<device_name>/debug <install_dir>/lib/ksdk_platform_lib/iar/<device_name>/release 3.2 编译演示应用 6 Freescale Semiconductor, Inc.
KSDK 演示应用基于 Kinetis SDK 平台库 ( 在上一章节中编译 ) 编译 如果不存在平台库, 链接器将会显示一则指示无法找到此库的错误信息 一种检查是否存在库的简单方法是展开 ksdk_platform_lib 工程中的输出文件夹, 如果未编译且不存在平台库二进制文件, 请按照章节 3.1 中的步骤进行编译 否则, 请继续执行以下步骤, 以编译所需的演示应用 1. 请打开所需的演示应用工作空间 可以使用以下路径找到演示应用工作空间文件 : <install_dir</examples/>board_name>/demo_apps/<demo_name>/iar 以 FRDM-K64F Freedom 开发板为例,hello_world 工作空间位于以下文件夹中 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/iar/hello_world.eww 2. 从下拉菜单中选择所需编译目标 对于本示例, 请选择 hello_world Debug 目标 使用 IAR 运行演示应用 图 8. 选择演示应用编译目标 3. 要编译演示应用, 请单击下面红色突出显示的 Make 按钮 4. 编译将完成且无错误 图 9. 编译演示应用 Freescale Semiconductor, Inc. 7
使用 IAR 运行演示应用 3.3 运行演示应用 要下载并运行此应用, 请执行以下步骤 : 1. 请参考附录 B 中的表来确定在特定硬件平台上加载的调试接口 对于带 CMSIS-DAP/mbed/DAPLink 接口的开发板, 请访问 developer.mbed.org/handbook/windows-serialconfiguration, 然后按照说明安装 Windows 操作系统串行驱动程序 对于带 P&E Micro 接口的开发板, 请访问 www.pemicro.com/support/downloads_find.cfm, 然后下载 P&E 硬件接口驱动程序包 对于 MRB-KW01 开发板, 请访问 www.freescale.com/usb2ser 以下载串行驱动程序 此板不支持 OpenSDA, 因此, 需要使用外部调试器 ( 例如 J-Link) 以下提及 OpenSDA 的步骤不适用于此板, 因为串行输出仅具有单个 USB 连接器 2. 通过 OpenSDA USB 连接器 ( 在部分开发板上可能名为 OSJTAG) 与 PC USB 连接器之间的 USB 线缆将开发平台与 PC 相连 3. 打开 PC 上的终端应用, 例如 PuTTY 或 TeraTerm, 然后连接至调试 COM 端口 ( 要确定 COM 端口号, 请参阅附录 A) 将终端配置为以下设置 : a. 115200 或 9600 波特率, 具体取决于开发板 ( 请参考 board.h 文件中的 BOARD_DEBUG_UART_BAUD 变量 ) b. 无校验 c. 8 个数据位 d. 1 个停止位 图 10. 终端 (PuTTY) 配置 8 Freescale Semiconductor, Inc.
使用 IAR 运行演示应用 4. 单击 Download and Debug 按钮以将应用下载到目标 图 11. Download and Debug 按钮 5. 应用随后将下载到目标并自动运行到 main() 函数 6. 通过单击 Go 按钮运行代码来启动应用 图 12. 运行调试时在 main() 处停止 图 13. Go 按钮 7. hello_world 应用现在正在运行且终端上显示 否则, 请检查您的终端设置和连接 图 14. hello_world 演示应用的文本显示 Freescale Semiconductor, Inc. 9
使用 Keil MDK/μVision 运行演示应用 4 使用 Keil MDK/μVision 运行演示应用 本章节介绍了编译 运行和调试 Kinetis SDK 中所提供的演示应用所需的步骤 本章节还介绍了如何编译演示应用所需使用的库 所用示例为 hello_world 演示应用, 针对带的 FRDM-K64F Freedom 硬件平台, 但这些步骤适用于 KSDK 中的任何演示或示例应用 4.1 安装 CMSIS 设备包 安装 MDK 工具后, 必须安装 Cortex 微控制器软件接口标准 (CMSIS) 设备包, 以完全支持设备调试 这些设备包中包含诸如内存映射信息 寄存器定义和闪存编程算法之类的信息 请按照这些步骤安装相应的 CMSIS 设备包 1. 打开被称为 μvision 的 MDK IDE 在 IDE 中, 选择 Pack Installer 图标 图 15. 启动 Pack installer 2. 在 Pack Installer 窗口中, 找到 Kinetis 设备包的部分 ( 以字母顺序排列 ) Kinetis 设备包以 Keil::Kinetis 开头, 后跟 MCU 系列名称, 例如 Keil::Kinetis_K60_DFP 本示例使用的是 FRDM-K64F 平台, 因此, 选择 K60 系列设备包 单击设备包旁边的 Install 按钮 此过程需要联网才能成功完成 图 16. 安装 Kinetis 设备包 3. 安装完成之后, 请关闭 Pack Installer 窗口并返回至 μvision IDE 4.2 编译平台库 以下步骤介绍了如何在 μvision 中打开演示应用工作空间 如何编译演示应用所需的平台库以及如何编译演示应用 1. 可使用以下路径查找演示应用工作空间文件 : <install_dir>/examples/<board_name</demo_apps/<demo_name>/<toolchain> 此工作空间文件的名称为 <demo_name>.uvmpw 对于本特定示例, 请访问实际路径 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/mdk/hello_world.uvmpw 10 Freescale Semiconductor, Inc.
使用 Keil MDK/μVision 运行演示应用 打开工作空间后, 将会显示两个工程 : 一个用于 KSDK 平台库, 另一个用于演示应用 默认情况下, 演示应用工程将被选作活动工程 图 17. 工作空间视图 2. 编译演示应用需要使用库, 因此, 请使平台库工程处于活动状态 要激活平台库工程, 请右键单击并选择 Set as Active Project 活动工程的名称周围具有黑色边框 激活后, 将会突出显示平台库工程 图 18. 将平台库设为活动工程 3. 每个 KSDK 工程支持两种工程配置 ( 编译目标 ): 调试 (Debug) 编译优化设为低, 并且将生成调试信息以便执行 此目标应被选择用于开发和调试 发布 (Release) 编译优化设为高, 并且不会生成调试信息 此目标应被选择用于最终应用部署 此工具允许根据活动工程选择编译目标, 因此, 如需更改平台库的配置, 其必须为活动工程 从下拉菜单中选择相应的编译目标 : Debug 或 Release 对于本示例, 请选择 ksdk_platform_lib Debug 配置 Freescale Semiconductor, Inc. 11
使用 Keil MDK/μVision 运行演示应用 图 19. 选择平台库编译目标 4. 通过左键单击红色突出显示的 Rebuild 按钮可以重新编译工程文件 图 20. 编译平台库 5. 编译完成之后, 将根据此编译目标在此目录下生成库 (libksdk_platform.lib): <install_dir>/lib/ksdk_platform_lib/mdk/<device_name>/debug <install_dir>/lib/ksdk_platform_lib/mdk/<device_name>/release 4.3 编译演示应用 12 Freescale Semiconductor, Inc.
KSDK 演示应用基于 Kinetis SDK 平台库 ( 在上一章节中编译 ) 编译 如果不存在平台库, 链接器将会显示一则指示无法找到此库的错误信息 如果未编译且不存在平台库二进制文件, 请按照章节 4.2 中的步骤进行编译 否则, 请继续执行以下步骤, 以编译所需的演示应用 1. 请在以下位置打开所需的演示应用工作空间 : <install_dir>/examples/<board_name>/demo_apps/<demo_name>/mdk 此工作空间文件的名称为 <demo_name>.uvmpw, 因此, 对于本特定示例, 实际路径为 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/iar/hello_world.uvmpw 2. 激活演示应用工程 使用 Keil MDK/μVision 运行演示应用 图 21. 激活演示应用工程 3. 要编译演示应用工程, 请选择红色突出显示的 Rebuild 按钮 4. 编译将完成且无错误 图 22. 编译演示应用 4.4 运行演示应用 要下载并运行此应用, 请执行以下步骤 : 1. 请参考附录 B 中的表来确定在特定硬件平台上加载的调试接口 对于带 CMSIS-DAP/mbed/DAPLink 接口的开发板, 请访问 mbed, 搜索 handbook/windows-serialconfiguration, 然后按照说明安装 Windows 操作系统串行驱动程序 对于带 P&E Micro 接口的开发板, 请访问 www.pemicro.com/support/downloads_find.cfm, 然后下载和安装 P&E 硬件接口驱动程序包 对于 MRB-KW01 开发板, 请访问 www.freescale.com/usb2ser 以下载串行驱动程序 此板不支持 OpenSDA, 因此, 需要使用外部调试器 ( 例如 J-Link) 以下提及 OpenSDA 的步骤不适用于此板, 因为串行输出仅具有单个 USB 连接器 对于带 OSJTAG 接口的开发板, 请通过 www.keil.com/download/docs/408 安装驱动程序 2. 通过 OpenSDA USB 连接器 ( 在部分开发板上可能名为 OSJTAG) 与 PC USB 连接器之间的 USB 线缆将开发平台与 PC 相连 3. 打开 PC 上的终端应用, 例如 PuTTY 或 TeraTerm, 然后连接至调试串行端口号 ( 要确定 COM 端口号, 请参阅附录 A) 将终端配置为以下设置 : a. 115200 或 9600 波特率, 具体取决于开发板 ( 请参考 board.h 文件中的 BOARD_DEBUG_UART_BAUD 变量 ) b. 无校验 Freescale Semiconductor, Inc. 13
使用 Keil MDK/μVision 运行演示应用 c. 8 个数据位 d. 1 个停止位 图 23. 终端 (PuTTY) 配置 4. 正确编译应用之后, 请单击 Download 按钮以将应用下载到目标 图 24. Download 按钮 5. 单击 Download 按钮后, 应用将下载到目标并运行 要调试此应用, 请单击红色突出显示的 Start/Stop Debug Session 按钮 14 Freescale Semiconductor, Inc.
使用 Keil MDK/μVision 运行演示应用 6. 通过单击 Run 按钮运行代码来启动应用 图 25. 运行调试时在 main() 处停止 图 26. Go 按钮 hello_world 应用现在正在运行且终端上显示 否则, 请检查您的终端设置和连接 Freescale Semiconductor, Inc. 15
使用 Kinetis Design Studio IDE 运行演示应用 图 27. hello_world 演示应用的文本显示 5 使用 Kinetis Design Studio IDE 运行演示应用 本章节介绍了配置 Kinetis Design Studio (KDS) IDE 以编译 运行和调试演示应用所需的步骤以及 KSDK 中提供的必要库 所用示例为 hello_world 演示应用, 针对带 MKL33Z64VLH4Freedom 硬件平台, 但这些步骤适用于 KSDK 中的任何演示或示例应用 5.1 选择工作空间位置 首次启动 KDS IDE 时, 系统将提示用户选择工作空间位置 KDS IDE 基于 Eclipse, 它使用工作空间来保存与当前配置以及 ( 在某些情况下 ) 工作空间中工程的源文件相关的信息 工作空间的位置可以是任意位置, 但建议将工作空间置于 KSDK 目录之外 5.2 安装 Eclipse 更新 将 KDS IDE 与 KSDK 结合使用之前, 必须安装 KSDK Eclipse 更新 如果没有此更新, 则 Eclipse 无法生成与 KSDK 兼容的工程 5.2.1 Windows 操作系统说明和 Mac 操作系统说明 注 Mac OS 所需的步骤与 Windows 操作系统所需步骤相同, 唯一的区别在于 IDE 稍有不同 要安装此更新, 请按照以下说明操作 : 1. 选择 Help -> Install New Software 16 Freescale Semiconductor, Inc.
使用 Kinetis Design Studio IDE 运行演示应用 图 28. 安装新软件 2. 在 Install New Software 对话框中, 单击右上角的 Add 按钮 然后, 在 Add Repository 对话框中, 选择 Archive 按钮 图 29. 为新软件添加存储库 3. 在 Repository archive 对话框中, 浏览 KSDK 安装目录 4. 输入 <install_dir>/tools/eclipse_update 文件夹并选择 KSDK_<version>_Eclipse_Update.zip 文件 5. 在 Add Repository 对话框中单击 Open 和 OK 按钮 6. KSDK 更新将显示在原始 Install 对话框列表中 Freescale Semiconductor, Inc. 17
使用 Kinetis Design Studio IDE 运行演示应用 图 30. 选择 Eclipse 更新 7. 选中 KSDK Eclipse 更新左边的方框, 然后单击右下角的 Next 按钮 8. 请按照剩下的说明完成更新安装 应用更新之后, 请重启 KDS IDE, 使更新生效 5.2.2 Linux 操作系统说明 请使用 Ubuntu 14.04 执行以下说明 这些步骤可能与其他 Linux 发行版稍有不同 要安装此更新, 请按照以下说明操作 : 1. 以根用户身份从命令行启动 KDS IDE 在命令行中, 使用此命令, 假定 KDS IDE 的默认安装路径为 : user@ubuntu:~$ sudo /opt/freescale/kds_x.x.x/eclipse/kinetis-design-studio KDS IDE 版本 ( 以上显示为 x.x.x) 应反映机器上安装的版本, 例如 3.0.0 2. 系统将会提示您输入根密码 3. 选择 Help -> Install New Software 图 31. 安装新软件 4. 在 Install New Software 对话框中, 单击右上角的 Add 按钮 然后, 在 Add Repository 对话框中, 选择 Archive 18 Freescale Semiconductor, Inc.
使用 Kinetis Design Studio IDE 运行演示应用 图 32. 为新软件添加存储库 5. 在 Repository archive 对话框中, 浏览 KSDK 安装目录 6. 输入 <install_dir>/tools/eclipse_update 文件夹并选择 KSDK_<version>_Eclipse_Update.zip 文件 7. 在 Add Repository 对话框中单击 Open 和 OK 8. KSDK 更新将显示在原始 Install 对话框列表中 图 33. 选择 Eclipse 更新 9. 选中 KSDK Eclipse 更新左边的方框, 然后单击右下角的 Next 按钮 10. 请按照剩下的说明完成更新安装 11. 应用更新之后, 请重启 KDS IDE, 使更改生效 12. 重启 KDS IDE 之后, 通过以非根用户身份启动 KDS IDE 来关闭 IDE 和重启 为此, 请执行步骤 1 中除了 sudo 命令之外的其他命令 Freescale Semiconductor, Inc. 19
使用 Kinetis Design Studio IDE 运行演示应用 5.3 编译平台库 以下步骤说明如何在 KDS IDE 中打开和编译平台库工程 此平台库为演示应用所需, 如果没有, 则无法编译 注 Linux OS 和 Mac OS 所需的步骤与 Windows 操作系统所需步骤相同 唯一的区别在于 IDE 稍有不同 1. 从 KDS IDE 菜单中选择 File->Import 在出现的窗口中, 展开 General 文件夹并选择 Existing Projects into Workspace 然后, 单击 Next 按钮 图 34. 在 KDS IDE 中选择正确的导入类型 2. 单击 Select root directory: 选项旁边的 Browse 按钮 20 Freescale Semiconductor, Inc.
使用 Kinetis Design Studio IDE 运行演示应用 图 35. 工程目录选择窗口 3. 指向对应设备的平台库工程, 路径如下 : <install_dir>/lib/ksdk_platform_lib/kds/<device_name> 对于本示例, 具体位置为 : <install_dir>/lib/ksdk_platform_lib/kds/k64f12 4. 指向正确的目录之后, Import Projects 窗口应如下图所示 单击 Finish 按钮 请勿选择 Copy projects... 选项 注 Freescale Semiconductor, Inc. 21
使用 Kinetis Design Studio IDE 运行演示应用 图 36. 选择 K64F12 平台库工程 5. 每个 KSDK 工程支持两种工程配置 ( 编译目标 ): 调试 (Debug) 编译优化设为低, 并且将为可执行文件生成调试信息 此目标应被选择用于开发和调试 发布 (Release) 编译优化设为高, 并且不会生成调试信息 此目标应被选择用于最终应用部署 6. 单击锤子图标旁边的向下箭头, 选择相应的编译目标 : Debug 或 Release, 如下所示 对于本示例, 请选择 Debug 目标 图 37. 在 KDS IDE 中选择编译目标 22 Freescale Semiconductor, Inc.
使用 Kinetis Design Studio IDE 运行演示应用 选择编译目标后, 库开始编译 要在将来重新编译库, 请单击锤子图标 ( 假设选择相同的编译目标 ) 5.4 编译演示应用 要编译演示应用, 请重复执行章节 5.3 中所列的步骤, 使用演示应用工程而非平台库工程 演示应用工程位于以下文件夹中 : <install_dir>/examples/<board_name>/demo_apps/<demo_name>/kds 对于本示例, 路径为 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/kds 5.5 运行演示应用 注 Linux OS 和 Mac OS 所需的步骤与 Windows 操作系统所需步骤相同, 唯一的区别在于 IDE 稍有不同 以下所列为特定于平台的相应步骤 要下载并运行此应用, 请执行以下步骤 : 1. 请参考附录 B 中的表来确定在特定硬件平台上加载的调试接口 对于 Windows 操作系统和 Linux OS 用户, 请下载与您的调试接口对应的驱动程序 : - 对于带 CMSIS-DAP/mbed/DAPLink 接口的开发板, 请访问 developer.mbed.org/handbook/windows-serialconfiguration, 然后按照说明安装 Windows 操作系统串行驱动程序 如果正在 Linux OS 上运行, 则无需执行此步骤 - 对于带 P&E Micro 接口的开发板, 请访问 www.pemicro.com/support/downloads_find.cfm, 然后下载和安装 P&E 硬件接口驱动程序包 - 如已使用 J-Link( 无论是单独的调试 pod 还是 OpenSDA), 请访问 www.segger.com/jlink-software.html - 对于 MRB-KW01 开发板, 请访问 www.freescale.com/usb2ser 以下载串行驱动程序 此板不支持 OpenSDA, 因此, 需要使用外部调试器 ( 例如 J-Link) 以下提及 OpenSDA 的步骤不适用于此板, 因为串行输出仅具有单个 USB 连接器 对于 Mac OS 用户,KDS 仅支持 J-Link OpenSDA 接口 - 请按照附录 C 中的说明更新 J-Link OpenSDA 应用的开发板 OpenSDA 接口 然后, 请访问 www.segger.com/jlink-software.html 以下载必要的软件和驱动程序 2. 通过 OpenSDA USB 连接器 ( 在部分开发板上可能名为 OSJTAG) 与 PC USB 连接器之间的 USB 线缆将开发平台与 PC 相连 3. 在 Windows 操作系统环境中, 打开 PC 上的终端应用, 例如 PuTTY 或 TeraTerm, 然后连接至调试串行端口号 ( 要确定 COM 端口号, 请参阅附录 A) 对于 Linux OS, 请打开终端应用并连接至相应的设备 将终端配置为以下设置 : a. 115200 或 9600 波特率, 具体取决于开发板 ( 请参考 board.h 文件中的 BOARD_DEBUG_UART_BAUD 变量 ) b. 无校验 c. 8 个数据位 d. 1 个停止位 Freescale Semiconductor, Inc. 23
使用 Kinetis Design Studio IDE 运行演示应用 图 38. 终端 (PuTTY) 配置 4. 在您的终端中运行以下命令 ( 仅限 Linux OS 用户 ) 这些命令会将 libudev 安装到您的系统, 而 KDS IDE 需要用其启动调试器 user@ubuntu:~$ sudo apt-get install libudev-dev libudev1 user@ubuntu:~$ sudo ln s /usr/lib/x86_64-linux-gnu/libudev.so /usr/lib/x86_64-linuxgnu/libudev.so.0 5. 请确保您尝试连接的目标的调试器配置正确 有关 KSDK 支持的各种硬件平台上的默认调试器应用的更多信息, 请参考附录 B a. 要检查可用调试器配置, 请单击绿色 Debug 按钮旁边的小向下箭头并选择 Debug Configurations 图 39. Debug Configurations 对话按钮 24 Freescale Semiconductor, Inc.
b. 在 Debug Configurations 对话框中, 选择与您使用的硬件平台对应的调试配置 在本示例中, 使用的是 FRDM-K64F, 因此要选择的接口是 OpenOCD 下的 CMSIS-DAP/DAPLink 选项 要确定其他硬件平台使用的接口, 请参考附录 B 选择调试器接口之后, 请单击 Debug 按钮以启动此调试器 使用 Kinetis Design Studio IDE 运行演示应用 6. 应用随后将下载到目标并自动运行到 main(): 图 40. 选择调试配置和启动调试器 Freescale Semiconductor, Inc. 25
使用 Kinetis Design Studio IDE 运行演示应用 7. 通过单击 Resume 按钮来启动应用 : 图 41. 运行调试时在 main() 处停止 图 42. Resume 按钮 hello_world 应用现在正在运行且终端上显示 否则, 请检查您的终端设置和连接 26 Freescale Semiconductor, Inc.
使用 Atollic TrueSTUDIO 运行演示应用 图 43. hello_world 演示应用的文本显示 6 使用 Atollic TrueSTUDIO 运行演示应用 本章节介绍了配置 Atollic TrueSTUDIO 以编译 运行和调试演示应用的步骤以及 KSDK 中提供的必要驱动程序库 所用示例为 hello_world 演示应用, 针对带 MKL33Z64VLH4FRDM-KL43Z Freedom 硬件平台, 但这些步骤适用于 KSDK 中的任何演示或示例应用 注 Atollic 并不需要 KDS IDE 工具链所需的 Eclipse 更新 6.1 选择工作空间位置 首次启动 TrueSTUDIO 时, 系统将提示用户选择工作空间位置 TrueSTUDIO 使用 Eclipse, 它使用工作空间来保存与当前配置以及 ( 在某些情况下 ) 工作空间中工程的源文件相关的信息 工作空间的位置可以是任意位置, 但建议将工作空间置于 KSDK 目录之外 6.2 编译平台库 以下步骤用于为您在 TrueSTUDIO 中打开和编译平台库工程提供指导 此平台库为演示应用所需, 如果没有, 则无法编译 1. 从 TrueSTUDIO 菜单中选择 File -> Import 展开 General 文件夹并选择 Existing Projects into Workspace 然后, 单击 Next 按钮 Freescale Semiconductor, Inc. 27
使用 Atollic TrueSTUDIO 运行演示应用 图 44. 在 TrueSTUDIO 中选择正确的导入类型 2. 单击 Select root directory: 选项旁边的 Browse 按钮 图 45. 工程目录选择窗口 28 Freescale Semiconductor, Inc.
使用 Atollic TrueSTUDIO 运行演示应用 3. 指向对应设备的平台库工程, 路径如下 : <install_dir>/lib/ksdk_platform_lib/atl/<device_name> 对于本示例, 具体位置为 : <install_dir>/lib/ksdk_platform_lib/atl/k64f12 4. 指向正确的目录之后, Import Projects 窗口应如此图所示 单击 Finish 按钮 图 46. 选择 K64F12 平台库工程 请勿选择 Copy projects... 选项 注 5. 每个 KSDK 工程支持两种工程配置 ( 编译目标 ): 调试 (Debug) 编译优化设为低, 并且将为可执行文件生成调试信息 此目标应被选择用于开发和调试 发布 (Release) 编译优化设为高, 并且不会生成调试信息 此目标应被选择用于最终应用部署 6. 通过单击 Manage build configurations 图标 ( 如下所示 ) 选择相应的编译目标 Debug 或 Release 对于本示例, 请选择 Debug 目标并单击 Set Active 默认配置为使用 Debug 目标, 因此, 无需进行更改 Freescale Semiconductor, Inc. 29
使用 Atollic TrueSTUDIO 运行演示应用 图 47. 在 TrueSTUDIO 中选择编译目标 7. 单击 Build 图标以编译库 6.3 编译演示应用 要编译演示应用, 请重复执行章节 6.2 中所列的步骤, 使用演示应用工程而非平台库工程 演示应用工程位于以下文件夹中 : <install_dir>/examples/<board_name>/demo_apps/<demo name>/atl 对于本示例, 路径为 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/atl 6.4 运行演示应用 Atollic 工具需要使用 J-Link 或 P&E Micro 调试接口 因此, 部分硬件平台需要更新开发板上的 OpenSDA 调试固件 要确定开发板的默认调试接口, 请参见附录 B 如果默认接口不是 J-Link 或 P&E Micro, 请参见附录 C, 了解有关如何安装这些调试接口的说明 本章节介绍了使用 J-Link 调试器 ( 尽管也支持 P&E Micro 接口 ) 运行演示应用的步骤 要使用 J-Link 接口执行此练习, 必须完成以下两项操作 : 安装 J-Link 软件 ( 驱动程序和实用程序 ), 可从 segger.com/downloads.html 中下载 请确保 : 已使用 J-Link OpenSDA 固件将开发板上的 OpenSDA 接口编程 要确定您的开发板是否支持 OpenSDA, 请参考附录 B 有关对 OpenSDA 接口重新编程的说明, 请参考附录 C 如果您的开发板不支持 OpenSDA, 则需要使用单独的 J-Link pod 您需将单独的 J-Link pod 连接至板的调试接口 请注意, 某些硬件平台需要对硬件进行调整, 以通过外部调试接口正确工作 此外, 还可以使用 P&E Micro 接口 要使用此接口 : 请安装 P&E Micro 硬件接口驱动程序, 可从 www.pemicro.com/support/downloads_find.cfm 下载这些程序 如果您的开发板未预载 P&E Micro 接口, 请使用 P&E Micro OpenSDA 固件重新编程 OpenSDA 接口 ( 如支持 ) 要确定您的开发板是否支持 OpenSDA, 请参考附录 B 有关对 OpenSDA 接口重新编程的说明, 请参考附录 C 30 Freescale Semiconductor, Inc.
对于 MRB-KW01 开发板, 请访问 www.freescale.com/usb2ser 以下载串行驱动程序 此板不支持 OpenSDA, 因此, 需要使用外部 J-Link 调试接口配置好并可供使用之后, 请按照以下步骤下载和运行此应用 : 使用 Atollic TrueSTUDIO 运行演示应用 1. 通过 OpenSDA USB 连接器 ( 在部分开发板上可能名为 OSJTAG) 与 PC USB 连接器之间的 USB 线缆将开发平台与 PC 相连 2. 打开 PC 上的终端应用, 例如 PuTTY 或 TeraTerm, 然后连接至调试串行端口号 ( 要确定 COM 端口号, 请参阅附录 A) 将终端配置为以下设置 : a. 115200 或波特率, 具体取决于开发板 ( 请参考 board.h 文件中的 BOARD_DEBUG_UART_BAUD 变量 ) b. 无校验 c. 8 个数据位 d. 1 个停止位 图 48. 终端 (PuTTY) 配置 3. 请确保您尝试连接的目标的调试器配置正确 a. 要检查调试器配置, 请单击 Configure Debug 图标 图 49. Debug Configurations 对话按钮 Freescale Semiconductor, Inc. 31
使用 Atollic TrueSTUDIO 运行演示应用 b. 在 Debug Configurations 窗口中, 选择与您使用的硬件平台对应的调试配置 Atollic 工具需要使用 J-Link 或 P&E Micro 调试接口, 因此, 部分硬件平台需要更新 OpenSDA 调试固件 要确定开发板的默认调试接口, 请参考附录 B 如果默认接口不是 J-Link 或 P&E Micro, 请参考附录 C, 了解有关如何安装这些调试接口的说明 重要提示 : 本示例假定已在 FRDM-K64F Freescale Freedom 开发板平台上安装 J-Link 接口 c. 选择 J-Link Debug 接口并单击 Debug 按钮 图 50. 在 Dedug Configuration 对话框中选择调试配置 4. 应用随后将下载到目标并自动运行到 main(): 32 Freescale Semiconductor, Inc.
使用 Atollic TrueSTUDIO 运行演示应用 5. 通过单击 Resume 按钮运行代码来启动应用 图 51. 运行调试时在 main() 处停止 图 52. Resume 按钮 hello_world 应用现在正在运行且终端上显示 否则, 请检查您的终端设置和连接 图 53. hello_world 演示应用的文本显示 Freescale Semiconductor, Inc. 33
使用 ARM GCC 运行演示应用 7 使用 ARM GCC 运行演示应用 本章节介绍了配置命令行 ARM GCC 工具以编译 运行和调试演示应用的步骤以及 KSDK 中提供的必要驱动程序库 所用示例为针对 FRDM-K64F Freedom 硬件平台的 hello_world 演示应用, 但这些步骤适用于 KSDK 中的任何开发板 演示或示例应用 7.1 设置工具链 本章节包含利用 KSDK 支持的 ARM GCC 工具链编译和运行 KSDK 演示应用时安装所需必要组件的步骤 可以通过多种方式使用 ARM GCC 工具, 本示例重点介绍 Windows 操作系统环境 尽管未在此处讨论, 但 ARM GCC 工具也可在 Linux OS 和 Mac OSX 中使用 7.1.1 安装 GCC ARM Embedded 工具链 从 launchpad.net/gcc-arm-embedded 处下载和运行安装程序 这是实际的工具箱 ( 即编译器 链接器等 ) GCC 工具链应与支持的最新版本对应, 如 Kinetis SDK v.1.2.0 版本记录 ( 文档 KSDK120RN) 所述 7.1.2 安装 MinGW Minimalist GNU for Windows (MinGW) 开发工具提供了一组独立于第三方 C 运行时 DLL( 如 Cygwin) 的工具 KSDK 使用的编译环境不使用 MinGW 编译工具, 但使用 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 注 图 54. 设置 MinGW 和 MSYS 4. 在 Installation 菜单中单击 Apply Changes, 然后按照剩下的说明完成安装 34 Freescale Semiconductor, Inc.
使用 ARM GCC 运行演示应用 图 55. 完成 MinGW 和 MSYS 安装 5. 为 Windows 操作系统路径环境变量添加相应项 该项可以通过控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 环境变量... 部分获取 路径如下 : <mingw_install_dir>\bin 假定默认安装路径为 C:\MinGW, 示例如下所示 如果路径未设置正确, 则工具链不会工作 注如果您的路径变量中含有 C:\MinGW\msys\x.x\bin ( 如 KSDK 1.0.0 所要求 ), 请将其删除, 以确保新的 GCC 编译系统正常工作 Freescale Semiconductor, Inc. 35
使用 ARM GCC 运行演示应用 图 56. 为系统环境添加路径 7.1.3 为 ARMGCC_DIR 添加新系统环境 创建新的系统环境变量并将其命名为 ARMGCC_DIR 此变量值应指向 ARM GCC Embedded 工具链安装路径, 对本示例来说为 : C:\Program Files (x86)\gnu Tools ARM Embedded\4.8 2014q3 请参考 GNU ARM GCC Embedded 工具的安装文件夹, 获取准确的安装路径名称 36 Freescale Semiconductor, Inc.
使用 ARM GCC 运行演示应用 图 57. 添加 ARMGCC_DIR 系统变量 7.1.4 安装 CMake 1. 从 www.cmake.org/cmake/resources/software.html 下载 CMake 3.0.x 2. 安装 CMake, 确保安装时选择选项 Add CMake to system PATH 将由用户决定是将其安装到供所有用户使用的路径下还是仅供当前用户使用的路径下 在本示例中, 假定将其安装到供所有用户使用的路径下 Freescale Semiconductor, Inc. 37
使用 ARM GCC 运行演示应用 图 58. 安装 CMake 3. 请按照安装程序剩下的说明进行操作 4. 您可能需要重启系统才能使路径更改生效 7.2 编译平台库 要编译平台库, 请按照以下说明操作 : 1. 打开 GCC ARM Embedded 工具链命令窗口 要启动此窗口, 请在 Windows 操作系统 开始 菜单中, 转至 程序 -> GNU Tools ARM Embedded < 版本 > 并选择 GCC Command Prompt 图 59. 启动命令提示符 2. 将命令窗口目录更改为 KSDK 中的平台库目录 : <install_dir>/lib/ksdk_platform_lib/armgcc/<device_name>/ 3. 每个 KSDK 工程支持两种工程配置 ( 编译目标 ): 38 Freescale Semiconductor, Inc.
调试 (debug) 编译优化设为低, 并且将为可执行文件生成调试信息 此目标应被选择用于开发和调试 发布 (Release) 编译优化设为高, 并且不会生成调试信息 此目标应被选择用于最终应用部署 提供的批处理文件用于编译两种配置 对于本示例, 编译的是 Debug 目标, 并在命令行上键入 build_debug.bat 如果需要的是 Release 目标, 则键入 build_release.bat 或者, 如果无需使用命令行, 则您可以在 Windows 操作系统资源管理器中双击批处理文件 使用 ARM GCC 运行演示应用 4. 编译完成后, 输出与下图类似 图 60. 编译平台库调试版本 图 61. KSDK 平台库编译成功 5. 根据编译目标在以下其中一个目录下生成库 (libksdk_platform.a): <install_dir>/lib/ksdk_platform_lib/armgcc/<device_name>/debug <install_dir>/lib/ksdk_platform_lib/armgcc/<device_name>/release 7.3 编译演示应用 KSDK 演示应用要求存在适合于相同编译目标 ( Debug 或 Release ) 的平台库 尝试编译演示应用之前, 请确保执行章节 7.2 中所示的步骤 要编译演示应用, 请执行以下步骤 1. 如果尚未运行, 请打开 GCC ARM Embedded 工具链命令窗口 要启动此窗口, 请在 Windows 操作系统 开始 菜单中, 转至 程序 -> GNU Tools ARM Embedded < 版本 > 并选择 GCC Command Prompt 图 62. 启动命令提示符 2. 将目录更改为演示应用工程的目录, 路径类似于 : <install_dir>/examples/<board_name>/demo_apps/<demo_name>/armgcc 对于本示例, 准确路径为 : Freescale Semiconductor, Inc. 39
使用 ARM GCC 运行演示应用 <install_dir>/examples/frdmk64f/demo_apps/hello_world/armgcc 3. 在命令行中键入 build_debug.bat 或在 Windows 操作系统资源管理器中双击 build_debug.bat 文件以执行编译 输出如下图所示 : 图 63. hello_world 演示应用编译成功 7.4 运行演示应用 本章节介绍了使用 J-Link GDB 服务器应用运行演示应用的步骤 要执行此练习, 必须完成以下两项操作 : 安装 J-Link 软件 ( 驱动程序和实用程序 ), 可从 www.segger.com/downloads.html 中下载 请确保 : 已使用 J-Link OpenSDA 固件将开发板上的 OpenSDA 接口编程 要确定您的开发板是否支持 OpenSDA, 请参考附录 B 有关对 OpenSDA 接口重新编程的说明, 请参考附录 C 如果您的开发板不支持 OpenSDA, 则需要使用单独的 J-Link pod 您需将单独的 J-Link pod 连接至板的调试接口 请注意, 某些硬件平台需要对硬件进行调整, 以通过外部调试接口正确工作 配置和连接 J-Link 接口之后, 请按照以下步骤下载和运行演示应用 : 1. 通过 OpenSDA USB 连接器 ( 在部分开发板上可能名为 OSJTAG) 与 PC USB 连接器之间的 USB 线缆将开发平台与 PC 相连 如果使用单独的 J-Link 调试 pod, 请同时将其连接至开发板的 SWD/JTAG 连接器 2. 打开 PC 上的终端应用, 例如 PuTTY 或 TeraTerm, 然后连接至调试串行端口号 ( 要确定 COM 端口号, 请参阅附录 A) 将终端配置为以下设置 : a. 115200 或 9600 波特率, 具体取决于开发板 ( 请参考 board.h 文件中的 BOARD_DEBUG_UART_BAUD 变量 ) b. 无校验 c. 8 个数据位 d. 1 个停止位 40 Freescale Semiconductor, Inc.
使用 ARM GCC 运行演示应用 图 64. 终端 (PuTTY) 配置 3. 打开 J-Link GDB 服务器应用程序 假定已安装 J-Link 软件, 则可通过访问 Windows 操作系统 开始 菜单并选择 程序 -> SEGGER -> J-Link < 版本 > J-Link GDB Server 来启动此应用程序 4. 按如下所示修改设置 本示例选择的目标器件为 MK64FN1M0xxx12 Freescale Semiconductor, Inc. 41
使用 ARM GCC 运行演示应用 5. 连接后, 屏幕应与下图类似 : 图 65. SEGGER J-Link GDB 服务器配置 42 Freescale Semiconductor, Inc.
使用 ARM GCC 运行演示应用 图 66. 成功连接后的 SEGGER J-Link GDB 服务器屏幕 6. 如果尚未运行, 请打开 GCC ARM Embedded 工具链命令窗口 要启动此窗口, 请在 Windows 操作系统 开始 菜单中, 转至 程序 -> GNU Tools ARM Embedded < 版本 > 并选择 GCC Command Prompt 图 67. 启动命令提示符 7. 更改包含演示应用输出的目录 可使用以下路径之一找到输出, 具体取决于选择的编译目标 : <install_dir/examples/<board_name>/demo_apps/<demo_name>/armgcc/debug <install_dir/examples/<board_name>/demo_apps/<demo_name>/armgcc/frdmk64f/release 对于本示例, 路径为 : <install_dir>/examples/frdmk64f/demo_apps/hello_world/armgcc/debug 8. 运行命令 arm-none-eabi-gdb.exe <demo_name>.elf 对于本示例, 请运行 arm-none-eabi-gdb.exe hello_world.elf Freescale Semiconductor, Inc. 43
附录 A - 如何确定 COM 端口 图 68. 运行 arm-none-eabi-gdb 9. 运行以下命令 : a. "target remote localhost:2331" b. "monitor reset" c. "monitor halt" d. "load" e. "monitor reset" 10. 此应用现已下载完毕并在复位向量处停止 执行 monitor go 命令以启动此演示应用 hello_world 应用现在正在运行且终端上显示 否则, 请检查您的终端设置和连接 图 69. hello_world 演示应用的文本显示 8 附录 A - 如何确定 COM 端口 本章节介绍了确定 Freescale 硬件开发平台的调试 COM 端口号所需的步骤 无论是基于 OpenSDA 还是传统的 P&E Micro OSJTAG 接口, 所有 Freescale 开发板均附带已出厂编程的板载调试接口 要确定特定开发板所附带的接口, 请参考附录 B 1. 要确定 COM 端口, 请打开 Windows 操作系统设备管理器 步骤如下 : 前往 Windows 操作系统 开始 菜单并在搜索栏中键入 设备管理器, 如下所示 : 44 Freescale Semiconductor, Inc.
附录 A - 如何确定 COM 端口 图 70. 设备管理器 2. 在设备管理器中, 展开 端口 (COM 和 LPT) 部分以查看可用端口 根据要使用的 Freescale 开发板 ( 请参考附录 B), 可以通过不同方式命名 COM 端口 : a. OpenSDA CMSIS-DAP/mbed/DAPLink 接口 : Freescale Semiconductor, Inc. 45
附录 B - 默认调试接口 图 71. OpenSDA CMSIS-DAP/mbed/DAPLink 接口 b. OpenSDA P&E Micro: c. OpenSDA J-Link: 图 72. OpenSDA P&E Micro d. P&E Micro OSJTAG: 图 73. OpenSDA J-Link e. MRB-KW01: 图 74. P&E Micro OSJTAG 图 75. MRB-KW01 9 附录 B - 默认调试接口 Kinetis SDK 可以支持各种 Kinetis 硬件平台出厂配置的不同调试接口 下表所列为 KSDK 支持的硬件平台 其默认调试接口以及帮助区分特定接口配置的版本信息 所有最新和未来的 Freescale 硬件平台均支持可配置的 OpenSDA 标准 表 1. KSDK 支持的硬件平台 硬件平台默认接口 OpenSDA 详细信息 FRDM-K22F CMSIS-DAP\mbed\DAPLink OpenSDA v2.1 FRDM-K64F CMSIS-DAP\mbed\DAPLink OpenSDA v2.0 FRDM-KL02Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KL03Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KL25Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KL26Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KL27Z P&E Micro OpenSDA OpenSDA v1.0 下一页继续介绍此表... 46 Freescale Semiconductor, Inc.
表 1. KSDK 支持的硬件平台 ( 继续 ) 附录 C - 更新 OpenSDA 固件 FRDM-KL43Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KL46Z P&E Micro OpenSDA OpenSDA v1.0 FRDM-KW24 CMSIS-DAP\mbed\DAPLink OpenSDA v2.1 MRB-KW01 N/A, 需要外部调试器 N/A TWR-K21D50M P&E Micro OSJTAG N/A TWR-K21F120M P&E Micro OSJTAG N/A TWR-K22F120M P&E Micro OpenSDA OpenSDA v1.0 TWR-K24F120M CMSIS-DAP\mbed OpenSDA v2.1 TWR-K60D100M P&E Micro OSJTAG N/A TWR-K64F120M P&E Micro OpenSDA OpenSDA v1.0 TWR-K65F180M P&E Micro OpenSDA OpenSDA v1.0 TWR-KL43Z48M P&E Micro OpenSDA OpenSDA v1.0 TWR-KV10Z32 P&E Micro OpenSDA OpenSDA v1.0 TWR-KV31F120M P&E Micro OpenSDA OpenSDA v1.0 TWR-KV46F150M P&E Micro OpenSDA OpenSDA v1.0 TWR-KW24D512 P&E Micro OpenSDA OpenSDA v1.0 10 附录 C - 更新 OpenSDA 固件 任何附带 OpenSDA 兼容调试接口的 Freescale 硬件平台均支持更新 OpenSDA 固件 这通常意味着将默认应用 (CMSIS-DAP/mbed/DAPLink 或 P&E Micro) 切换为 SEGGER J-Link 本章节包含将 OpenSDA 固件切换为 J-Link 接口的步骤 这些步骤同样适用于恢复原始映像 如需参考, 可在以下链接中找到 OpenSDA 固件文件 : J-Link: 从 www.segger.com/opensda.html 中下载相应的映像 请根据附录 B 中的表选相应的 J-Link 二进制文件 任何 OpenSDA v1.0 接口均应使用标准 OpenSDA 下载 ( 即无版本下载 ) 对于 OpenSDA 2.0 或 2.1, 请选择相应的二进制文件 CMSIS-DAP/mbed/DAPLink: 此接口用于支持 ARM mbed 初始化 导航至 developer.mbed.org/platforms 并选择硬件平台 特定平台 / 开发板页面提供了固件映像的链接和有关如何加载的说明, 说明与以下所述相同 P&E Micro: 下载 P&E Micro OpenSDA 固件映像需要在 P&E Micro(www.pemicro.com ) 注册 以下步骤所示为 Windows 操作系统和 Linux OS 用户如何更新开发板上的 OpenSDA 固件 : 1. 拔下开发板的 USB 线缆 2. 按下开发板的 Reset 按钮 按住此按钮时, 将板插回到 USB 线缆 3. 开发板重新枚举时, 它将作为名为 引导加载程序 (bootloader) 的磁盘驱动器显示 Freescale Semiconductor, Inc. 47
修订历史记录 图 76. 引导加载程序盘 4. 在 Windows 操作系统资源管理器中将新固件映像拖至引导加载程序盘, 方法与您将文件拖放至一般的 USB 闪存类似 注如果因任何原因导致固件更新失败, 则可以通过按住 Reset 按钮并重启使开发板始终重新进入引导加载程序模式 以下步骤所示为 Mac OS 用户如何更新开发板上的 OpenSDA 固件 : 1. 拔下开发板的 USB 线缆 2. 按下开发板的 Reset 按钮 按住此按钮时, 将板插回到 USB 线缆 3. 对于带 OpenSDA v2.0 或 v2.1 的开发板, 它将作为名为 引导加载程序 的磁盘驱动器显示在查找工具中 带 OpenSDA v1.0 的开发板可能显示, 也可能不显示, 具体取决于引导加载程序版本 如果您在查找工具中看到此盘, 则您可以转至下一步骤 如未看到, 则您必须使用 Windows 7 或更早版本的 PC 来更新 OpenSDA 固件或将 OpenSDA 引导加载程序更新到版本 1.11 或更高版本 可以从 P&E Microcomputer 网站获取引导加载程序更新说明和映像 4. 对于 OpenSDA v2.1 和 OpenSDA v1.0( 带引导加载程序 1.11 或更高版本 ) 用户, 请在查找工具中将新固件映像拖至引导加载程序盘, 方法与将文件拖放至一般的 USB 闪存中类似 5. 对于 OpenSDA v2.0 用户, 请在终端窗口中键入以下命令 : > sudo mount -u -w -o sync /Volumes/BOOTLOADER < cp -X <path to update file > /Volumes/BOOTLOADER 注如果因任何原因导致固件更新失败, 则可以通过按住 Reset 按钮并重启使开发板始终重新进入引导加载程序模式 11 修订历史记录 下表对本文档的修订进行了汇总 48 Freescale Semiconductor, Inc.
表 2. 修订历史记录 修订历史记录 修订版本号日期重大变更 1 2015 年 4 月 KSDK 1.2.0 版本 0 12/2014 首次发行 Freescale Semiconductor, Inc. 49
How to Reach Us: Home Page: freescale.com Web Support: freescale.com/support 本文档中的信息仅供系统和软件实施方使用 Freescale 产品 本文并未明示或者暗示授予利用本文档信息进行设计或者加工集成电路的版权许可 Freescale 保留对此处任何产品进行更改的权利, 恕不另行通知 Freescale 对其产品在任何特定用途方面的适用性不做任何担保 表示或保证, 也不承担因为应用程序或者使用产品或电路所产生的任何责任, 明确拒绝承担包括但不局限于后果性的或附带性的损害在内的所有责任 Freescale 的数据表和 / 或规格中所提供的 典型 参数在不同应用中可能并且确实不同, 实际性能会随时间而有所变化 所有运行参数, 包括 经典值 在内, 必须经由客户的技术专家对每个客户的应用程序进行验证 Freescale 未转让与其专利权及其他权利相关的许可 Freescale 销售产品时遵循以下网址中包含的标准销售条款和条件 :freescale.com/ SalesTermsandConditions. Freescale, the Freescale logo, and Kinetis are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. All other product or service names are the property of their respective owners. ARM, ARM powered logo, Keil, μvision, and Cortex are registered trademarks of ARM Limited (or its subsidiaries) in the EU and/or elsewhere. mbed is a trademark of ARM Limited (or its subsidiaries) in the EU and/or elsewhere. All rights reserved. 2015 Freescale Semiconductor, Inc. 2015 飞思卡尔半导体有限公司 Document Number KSDK12GSUG Revision 0, 4/2015