IAR 9.1 版本创建 STM32F1 工程全解析（V3.6.0标准外设库）

一前言之前一直用的KEIL MDK 编译ST工程最近开始学习用IAR搭建工程先是不知道官网下载的V3.6.0标准外设库里面的文件该怎么挑、怎么放再是IAR 9.1版本和网上低版本教程不兼容一编译就报Pe147错误最后还搞混“工程”和“工作空间”到底啥关系建了几个实验工程就乱成一团。摸索了好几天终于把工程搭建规范摸透了也理清了所有文件的来源的路径现在把自己的学习历程和整理的经验记录下来既是给自己留个笔记也希望能帮到和我一样刚开始学IAR的人。先说明本文全程用的是IAR 9.1 版本标准外设库是从ST官网下载的STM32F10x_StdPeriph_Lib_V3.6.0。附IAR官网地址IAR 嵌入式工作台 |IARST标准外设库下载地址STM32标准外设软件库 - 意法半导体二IAR STM32 标准工程结构新建一个IAR_STM32F1_LED_Toggle文件夹里面新建五个如图所示的文件夹命名可根据喜好自行命名无需完全一致用于存放必需文件。每个文件所存放的内容如图所示其中Doc文件可选。IAR_STM32F1_LED_Toggle实验/ # 工程根目录命名清晰方便区分不同实验 ├─ CMSIS/ # 内核芯片底层文件来自V3.6.0标准库 ├─ STM32F10x_StdPeriph_Driver/ # 标准外设库文件来自V3.6.0标准库 ├─ User/ # 自己写的代码主函数、中断函数等 ├─ IAR_Project/ # IAR工程文件编译输出IAR自动生成集中存放 └─ Doc/ # 可选放原理图、 datasheet、自己的学习笔记三各文件夹作用详细说明以及从标准外设库的哪些文件夹获取1 CMSIS/内核芯片底层启动文件核心作用提供STM32F1的内核驱动、芯片寄存器定义、系统时钟初始化。文件来源标准库路径1内核和底层文件STM32F10x_StdPeriph_Lib_V3.6.0 → Libraries → CMSIS → CM3 → DeviceSupport → ST → STM32F10x标准库路径2启动文件STM32F10x_StdPeriph_Lib_V3.6.0\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\iar启动文件按芯片容量选md中容量hd大容量ld小容量我用的STM32F103C8T6所以选择中容量如果是F100系列的选择后面带vl后缀的。有些教程可能会复制core_cm3.h文件但IAR 9.1无需手动添加core_cm3.hIAR 9.1自带仅保留4个必要文件即可。最终CMSIS文件夹如图2 STM32F10x_StdPeriph_Driver/标准外设库核心作用提供STM32F1所有外设GPIO、UART、ADC等的驱动函数不用我们自己写驱动直接用标准库的就行这个文件夹的结构是固定的不要随意修改。标准库路径STM32F10x_StdPeriph_Lib_V3.6.0 → Libraries → STM32F10x_StdPeriph_Driver把这个路径下的“src”和“inc”两个文件夹直接复制到我们工程的STM32F10x_StdPeriph_Driver文件夹里不用做任何修改结构如下最终STM32F10x_StdPeriph_Driver文件夹如图根据之前keil的使用经验src文件夹里的.c文件不用全部添加到IAR工程比如做LED实验只加misc.c、stm32f10x_gpio.c、stm32f10x_rcc.c这3个就够了加太多会增加编译时间还容易混乱。3 User/自己写的代码核心目录核心作用存放自己编写的所有代码包括主函数、中断服务函数、自定义驱动比如延时函数是我们自己开发的核心区域这个文件夹的文件一部分来自标准库一部分是自己写的。标准库路径STM32F10x_StdPeriph_Lib_V3.6.0\Project\STM32F10x_StdPeriph_Examples\GPIO\IOToggle从这个路径里复制以下文件到我们工程的User文件夹。最终User文件夹如图stm32f10x_conf.h这个文件一定要有而且要放在User文件夹里它是标准库的“总开关”用来开启或关闭外设驱动没有它工程会报“找不到外设函数”的错误4 IAR_Project/IAR工程文件编译输出核心作用存放所有IAR工程相关文件和编译输出这个后续IAR新建工程会细讲。5 Doc/可放原理图及需求等此文件夹可按需建立不做讲解。四IAR新建STM32F1工作空间及工程一个工作空间可以放多个工程工程之间完全独立互不干扰切换工程不用重新打开IAR。6.2 官方定义概念后缀核心作用包含内容工作空间Workspace.eww管理多个工程方便切换不用反复打开IAR不包含任何代码只记录已添加的工程、当前激活的工程、窗口布局工程Project.ewp一个独立的STM32程序对应一个具体实验如LED、串口芯片型号、头文件路径、添加的.c文件、编译选项、最终生成的.hex文件每个工程都有自己独立的文件夹不要共用CMSIS、User文件夹否则会出现文件冲突一个工程报错其他工程也会受影响。1.新建工作空间打开IAR → File → New Workspace2.创建新项目Project - Create New Project3.选择ARM,空项目Empty project),点击ok4.选择保存项目的目录我们保存在刚刚准备的文件目录里面去然后项目名称命名为LED_Toggle然后保存。5.IAR添加文件和文件组点击工程然后右键选择添加三个和我们在工程目录下的文件组如下其中CMSIS组下还要再添加如图所示组6.添加相应文件然后在每个目录组里面添加工程目录对应文件下的.c文件依次添加CMSIS、标准固件库、还有User目录下的文件。最终添加成功应为如图所示结构其中CMSIS只添加启动文件和C文件USER只添加main文件驱动文件按需添加对应的.c和.h文件我这里直接全选添加了。到这里IAR新建工作空间和工程已经全部搞定了。五IAR工程选项配置1.配置内核和芯片型号点击工程然后右键选择Options…选项。然后配置芯片内核和型号如下图STM32F103C8T62.配置头文件包含路径C/C Compiler - preprocessor然后在里面添加我们所需要的头文件目录如下点击后会出现格式有误按图所示转换格式即可。把所有路径都添加成功后应如图所示。3 在Options配置中添加所需要的宏定义如图所示宏放在下方USE_STDPERIPH_DRIVER STM32F10X_MD4.配置调试器和相关配置5.配置是否使用IAR软件自带的一些库函数如果需要使用某些标准的库函数接口如我们使用的printf and scanf那么库就需要选择Full类型了如下图所示。使用新版本的IAR软件需要勾选 Use CMSIS微控制器软件接口标准的意思。如下图所示。6.编译下载程序编译程序工程下点击main.c,按F7编译程序此时会弹出个文件框意思是需要一个地方存放工作空间我们新建一个STM32F1_IAR_Study文件夹用于存放此工作空间建议不要与项目放在同一个文件夹且工程路径正确、无中文特殊符号之后弹出的信息可能会报错是因为标准库模板里的main.c会有#include stm32_eval.h这个是评估板专用的普通工程要删掉。删掉后再按F7就会提示编译成功。下载程序1、首先去掉Use flash loader选项的勾不去的话默认下载调试同时进行STLINK配置界面如图点击Project - Download - Downlaod active application 就可以下载程序了到这里IAR工程建立及编译下载程序已经全部完成了。六IAR常见报错及解决办法1Error[Pe147] 函数声明冲突报错示例declaration is incompatible with __nounwind __softfp unsigned int __iar_builtin_REV16(unsigned int)declared in iccarm_builtin.h刚开始跟着低版本教程把V3.6.0标准库CMSIS路径下的core_cm3.h文件复制到了工程里结果一编译就报这个错查了很久才知道IAR 9.1自带了这个文件两者冲突了。解决方法直接删除工程CMSIS文件夹里的core_cm3.h文件不用替换、不用下载IAR 9.1会自动调用自带的内核文件所有Pe147报错都会消失。2Fatal Error[Pe1696] 找不到 stm32_eval.h报错示例cannot open source file stm32_eval.h复制了V3.6.0标准库模板里的main.c没仔细看里面有一行#include stm32_eval.h编译的时候就报错以为是头文件路径没配好折腾了半天后来才知道这个文件是评估板专用的。解决方法打开User文件夹下的main.c文件删除一行代码#include stm32_eval.h保存后重新编译报错就没了。3Error[Li006] 重复定义报错示例duplicate definitions for AHBPrescTable; in XXX\CMSIS\system_stm32f10x.o, and XXX\User\system_stm32f10x.o搭建工程时不小心把CMSIS文件夹里的system_stm32f10x.c文件又复制了一份到User文件夹里还把这两个文件夹里的system_stm32f10x.c都添加到了IAR工程中结果一编译就报了4个Li006重复定义错误折腾了好久才找到原因。报错原因通俗理解system_stm32f10x.c文件里包含了AHBPrescTable、SystemCoreClock、SystemCoreClockUpdate、SystemInit这4个核心函数/变量你同时把这个文件放在了CMSIS和User两个文件夹还都添加到了IAR工程中IAR编译时会识别到两个相同的文件就会报“重复定义”错误。解决方法打开你的工程文件夹进入User文件夹找到并删除里面的system_stm32f10x.c文件这个文件本来就该放在CMSIS文件夹User文件夹里不需要打开IAR工程在左侧“Project”窗口找到“User”文件夹下的“system_stm32f10x.c”如果有的话右键点击 → Remove删除确保工程里只保留CMSIS文件夹下的system_stm32f10x.c保存工程重新编译Li006报错会全部消失。system_stm32f10x.c和system_stm32f10x.h只能放在CMSIS文件夹绝对不能复制到User文件夹也不能在工程中添加两个相同的文件这是新手最容易踩的坑之一。七写在后面本博客仅记录自己的学习进程无任何商业用途基于论坛上已经存在的内容结合自己实操过程完成了此博客自己也做了一些细节验证在此记录下来作为学习沉淀。如有侵权联系速删。