UM1727 用户手册

STM32 Nucleo板软件开发工具上手指南（中文版）

引言

STM32 Nucleo开发板是一个低成本且易于使用的开发平台， 可以用于快速评估和开始开发LQFP64封装的STM32微控制器。

本文档介绍了基于STM32 Nucleo板创建应用程序所需的软件环境和开发的建议。它为初学者提供了指导意见，包含如何建立和运行一个示例应用程序，并允许他们创造和构建自己的应用程序。具有以下的结构：

• 第一章介绍了软件和硬件要求（支持STM32家族的工具链，ST-LINK/ V2-1安装和固件包演示）。

• 第二章提供了分步指导如何使用工具执行和调试应用实例： - IAR systems公司的IAREmbedded Workbench® for ARM® (EWARM) - Keil公司的Microcontroller Development Kit for ARM® (MDK-ARM) - Atollic公司的TrueSTUDIO。

本手册并不包括所有与软件开发环境相关的主题，但是演示了要开始使用编译器/调试器的首个基本步骤，并提供需要充分地理解每一步的文档链接。

支持所有属于STM32 MCU Nucleo产品线的开发板。

图1.Nucleo开发工具

1 系统要求

运行应用程序之前，应该：

1.安装您的首选集成开发环境（IDE）。

2.ST-LINK/ V2-1驱动程序将会自动安装。如果遇问题，可以从工具链的安装目录中进行手动安装驱动程序（更多细节在第3节提供）。

3.在www.st.com/stm32nucleo下载STM32 Nucleo固件。

4.通过连接Nucleo板的CN1到PC的USB端口建立与STM32 Nucleo板的连接。

上述步骤将在以下章节进行详解。

图2.硬件环境

要运行和开发STM32 Nucleo板上的任何固件应用程序，最低要求如下：

• Windows PC (XP, 7, 8)

• A型USB转Mini-B电缆，用于从主机PC向电路板供电（通过USB连接器CN1）并连接嵌入的ST-LINK/ V2-1进行调试和编程。

2 支持STM32家族的IDE

基于32位ARM Cortex-M内核的微控制器的意法半导体STM32家族获得一系列软件工具的支持。包括传统的集成开发环境IDE，自带C/C++编译器和主要第三方的调试器（免费版本高达64KB的代码，取决于合作伙伴），并且包含意法半导体创新的工具。

支持所有Nucleo板的工具链：

• EWARM v7.10.3或更高版本(a)

– 30天评估版

– 32 KB限制快速入门版（16KB限制用于Cortex M0）

• MDK-ARM v5.01 或更高版本(a)(b)

– MDK-Lite（32KB代码大小限制）

• TrueSTUDIO v5 或更高版本(b)

– 32 KB限制（8KB用于Cortex-M0）

支持您的STM32器件的工具链版本的信息，请参看合作伙伴网站的工具链的发布说明（参见4.2节）。

在安装和使用该产品之前，请接受评估产品许可协议，该协议可以在ww.st.com/epla找到。

3 ST-LINK/V2-1安装

STM32 Nucleo板包含ST-LINK/V2-1嵌入式调试工具接口。该接口需要安装一个STLINK/V2-1专用的USB驱动。 这个驱动可以在ST的网站www.st.com获得，并且软件工具链支持该驱动。

•IAR Embedded Workbench® for ARM® (EWARM)

该工具链默认情况下安装在PC本地硬盘的C:\Program Files\IAR Systems\EmbeddedWorkbench x.x目录。

安装EWARM后, 通过运行Link \ST-Link_V2_USBdriver.exe安装ST-LINK/V2-1驱动，该文件位于[IAR_INSTALL_DIRECTORY]\Embedded Workbench x.x \arm\drivers\ST-Link \ST-Link_V2_USBdriver.exe。

• Keil Microcontroller Development Kit (MDK-ARM) 工具链

该工具链默认情况下安装在PC本地硬盘的C：\ Keil目录；安装程序在开始菜单会创建一个uVision快捷方式。当连接ST-LINK/ V2-1工具时，PC检测到新的硬件，并且需要安装ST-LINK_V2_USB驱动程序。 “找到新的硬件向导”出现并引导您完成从推荐的位置安装驱动程序所需的步骤。

• Atollic® TrueSTUDIO® STM32

该工具链默认情况下安装在PC本地硬盘的C:\Program Files\Atollic 目录。

安装软件工具链时，ST-Link_V2_USB.exe文件会自动安装。

注意:

固件包内容和STM32 Nucleo板需求的补充信息可以参看STM32固件入门。

嵌入式ST-LINK/ V2-1仅支持STM32器件的SWD接口。

4 固件包

以单个包装的形式提供STM32 Nucleo固件的应用、演示程序及IP核，并且以一个zip文件提供。 提取zip文件会生成一个STM32 Nucleo_FW_VX.YZ的文件夹，其中包含以下子文件夹（见图3）：

图3.包装内容

• Template project 是预配置的工程，带有一个空的main函数，该函数用户可以进行定制。有助于开始创建基于外设驱动程序自己的应用程序。

• Example project 包括每个随时可以执行的外设示例的工具链项目。

4.1 使用软件工具链执行和调试固件

4.1.1 EWARM工具链

下面的步骤介绍了如何编译/链接和执行现有EWARM工程。

下面的步骤可以应用到www.st.com网站的STM32_Nucleo_FW_VX.YZ固件中的已经存在的例子中、演示程序或者模板工程。

首先，你需要去看firmware/ readme.txt文件，其中包含固件说明和硬件/软件的要求。

1.打开IAR Embedded Workbench for ARM (EWARM)。图4显示了本文档中提及的窗口的基本名称：

图4. IAR Embedded Workbench IDE

2.在File菜单中，选择Open，然后单击Workspace显示Open Workspace对话框。浏览选择一个例子或演示程序或模板的工作区文件，然后单击Open，在项目窗口启动。

3.在 Project菜单中，选择Rebuild All编译您的项目。

4.如果你的项目成功编译，图5将会显示。

图5. EWARM项目编译成功

如果您需要更改项目设置（Include和预处理定义），通过以下项目的选项实现：

– 对于Include路径：

Project>Options…>C/C++ compiler>

– 对于预处理定义：

Project>Options…C/C++ compiler>pre-processor>

5.在IAR Embedded Workbench IDE，从Project菜单，选择Download and Debug，或者点击工具栏中的Download and Debug 按钮，来实现编程闪存，并开始调试。

图6. Download and Debug按钮

6. IAR Embedded Workbench的调试器可以用来调试C语言和汇编格式的源代码，设置断点、监视各个变量并且可以查看代码执行过程中的事件。

图7. IAR Embedded Workbench调试器窗口

7. 运行您的应用程序可以在Debug菜单下选择Go。也可以点击工具栏的Go按钮来运行您的应用程序。

图8. Go按钮

4.1.2 MDK-ARM工具链

1.打开Keil MDK-ARM Microcontroller Development Kit。图9显示本文档中提到的"Keil μvision5"窗口的基本名称。

图9. μvision5 IDE

2.在Project菜单中，选择Open Project... 。浏览选择一个例子或演示程序或模板的工作区文件，然后单击Open，在 Project window启动该工程。

3.在 Project菜单中，选择Rebuild All target编译您的工程。

4.如果你的项目成功编译，将会显示以下窗口。

图10. MDK-ARM项目成功编译

如果您需要更改项目设置（Include和预处理定义），通过以下项目的选项实现：

– 对于Include路径：

Project>Options for Target > C/C++ > Include Paths

– 对于预处理定义：

Project>Options for Target > C/C++ > Preprocessor symbols > Define

5.在MDK-ARM IDE，从Debug菜单，选择Start/Stop Debug Session，或者点击工具栏中的Start/Stop Debug Session 按钮，来实现编程闪存，并开始调试。

图11. Start/Stop Debug Session按钮

6.MDK-ARM的调试器可以用来调试C语言和汇编格式的源代码，设置断点、监视各个变量并且可以查看代码执行过程中的事件。

图 12. MDK-ARM调试器窗口

运行您的应用程序可以在Debug菜单下选择Run。也可以点击工具栏的Run按钮来运行您的应用程序。

图13. Run按钮

4.1.3 TrueSTUDIO工具链

1.打开Atollic TrueSTUDIO® for ARM® 。该程序将启动，并要求工作区位置。

图14. TrueSTUDIO workspace launcher对话框

2.浏览并选择一个示例或者演示程序或者模板的工作区文件的TrueSTUDIO工作区，然后单击OK加载。

3.在选择的工作区加载一个已存在的工程，选择File菜单的 Import，显示Import 对话框。

4.在Import窗口，打开General，选择Existing Projects into Workspace 然后点击Next。

图15. Atollic TrueSTUDIO import source select对话框

5.点击Slect root directory并且浏览至TrueSTUDIO 工作区文件夹。

图 16. Atollic TrueSTUDIO import projects对话框

6.在Projects面板，选择工程，然后点击Finish。

7.在Project Explorer选择该工程，打开Project菜单，然后点击Build Project。

8.如果你的工程成功编译，下面的消息将显示在控制台窗口。

图17. TrueSTUDIO 工程编译成功

如果您需要更改项目设置（Include和预处理定义），通过 Project>roperties 和选择左侧面板的C/C++ Build>Settings实现：

– 对于Include路径：

C Compiler>Directories>Include path

– 对于预处理定义：

C Compiler>Symbols> Defined symbols

9.调试和运行应用程序，选择Project Explorer 的项目，然后按下F11启动调试。

图18. TrueSTUDIO 调试窗口

Atollic TrueSTUDIO的调试器可以用来调试C语言和汇编格式的源代码，设置断点、监视各个变量并且可以查看代码执行过程中的事件。

运行你的应用程序，可以在Run菜单选择Resume, 或者点击工具栏的Resume按钮。

4.2 软件工具链有帮助的参考和网站

表1给出了有关本文档中描述的集成开发环境有帮助的参考。

表1.参考和网站

工具链	网站
EWARM	www.iar.com
MDK-ARM	www.keil.com
TrueSTUDIO	www.atollic.com

5 修订记录

表2.文档修订历史记录

日期	版本号	变更内容
2014-05-19	1	首次发布
2014-06-20	2	封面页增加新的器件号。 删除表1 Nucleo板基本信息。
2014-09-09	3	使用STM32 MCU Nucleo替代所有的NUCLEO。

相关文件：

1.  STM32 Nucleo板软件开发工具上手指南 Rev3：

中文版： STM32 Nucleo开发板软件开发工具上手指南（中文版）.pdf (1.52 MB, 下载次数: 21, 售价: 10 金币)

2015-7-17 10:47 上传

点击文件名下载附件

英文版： DM00105928.pdf (1.37 MB, 下载次数: 5)

2015-7-17 10:46 上传

点击文件名下载附件

2. STM32 Nucleo板软件开发工具上手指南 Rev2：

英文版：