使用LiteFwLib原创固件库从零开始建工程
——基于Keil5和FRDM-KL25板
suyong_yq@126.com
2015年1月
前文提要:
原创飞思卡尔KL25
单片机固件库软件——基于FRDM-KL25
开发板
将FRDM-KL25的OpenSDA变身JLink
前文为大家带来了LiteFwLib固件库,可用于快速开始FRDM-KL25开发板的应用开发。在LiteFwLib固件库的开发包中,包含了一些example样例工程,让大家能够简单了解一下固件库里的驱动是怎么用的。然而,对于实际的应用来讲,工程师总会创建自己的应用工程。最快速创建工程的方法就是——“改”,根据实际应用的需要,找一个功能最接近的样例工程作为基础进行修改(别忘记备份原工程呦),这样最安全,而且见效快,省掉同编写程序不相干的步骤。然而,对于刚接触单片机开发的人来说,了解从零开始创建工程的全部过程是非常有必要的,知道如何配置工程和组织代码,才能随心所欲地于扩展程序的规模。
这里,我就跟大家描述一下基于Keil集成开发环境从零开始创建一个适用于FRDM-KL25板的工程。我们的起点是保证电脑上已经安装好了工具软件:
• 安装好Keil5的主程序及支持KL25芯片的插件包
• 安装好JLink的驱动程序(或者OpenSDA的驱动程序)
• 电脑上有一个串口终端软件,Putty或者Tera Term之类的软件,Windows自带的“超级终端”程序也可以,但是我不会用,呵呵。
我们的终点是让串口终端输出欢迎信息,然后回显在串口终端输入的任何字符。
需要预先准备的一些文件:
• CMSIS标准头文件
• 启动文件和典型的时钟配置文件
• 驱动固件库(可选)
实际上这些文件都可以用现成的,不用我们自己编写,变化最大的就是固件库,可是我也帮大家写好啦。至于链接命名文件和flash映像文件啥的先不去管它们,用Keil默认的就OK。但若是深度定制的应用,以后就需要手动更改了。不过即使需要手动改,变化也不大,框子都是一样的。那这些文件从哪里可以找到呢?
Keil软件真是一个藏宝箱,不仅提供了开发单片机所需要的所有工具,也为大家提供了创建基本工程所需要的全部文件。在Keil的安装目录下,就可以找到我们需要的大部分文件。
现在切换到目录“C:Keil_v5
ARMPackARMCMSIS4.2.0CMSISInclude”,这里假设你的Keil安装在C盘的根目录。
对于内核为ARM Cortex-M0+的KL25芯片来说,我们需要的只是其中的core_m0plus.h、core_cmFunc.h和core_cmInstr.h,这些头文件中包含了对ARM Cortex-M0+处理器内核中寄存器的定义及操作的函数。在LiteFwLib固件库中,这些文件已经被复制到“fsl_frdm_kl25include”目录下啦。
切换到目录“C:Keil_v5ARMPackKeilKine
tis_KLxx_DFP1.4.0DeviceInclude”,这里可以找到KL25芯片的头文件及CMSIS规范的系统启动头文件。
我们需要的是其中的MKL25Z4.h和system_MKL25Z4.h。这两个文件也已经被复制到LiteFwLib固件库的“fsl_frdm_kl25board”目录下啦。
再切换目录“C:Keil_v5ARMPackKeilKinetis_KLxx_DFP1.4.0DeviceSource”下,找到system_MKL25Z4.c文件和“ARM”子目录下的system_MKL25Z4.s文件,它们分别是启动系统时钟配置文件及适用于ARM编译器的启动汇编文件。同样,这两个文件也已经被复制到LiteFwLib固件库的“fsl_frdm_kl25board”目录下啦。
固件库软件使用LiteFwLib中的代码就好了,位于“fsl_frdm_kl25driver”目录下。
为了说明问题,这里我暂时不使用LiteFwLib中的“二段编译”,而是创建全部由源码文件构成的工程。
在“fsl_frdm_kl25example”目录下新建一个“MyFirstProject”的目录,再创建“build”和“application”两个子目录,分别存放我们新建的工程文件和本工程的应用程序源文件。为了节约大家从头开始敲代码的时间,我们直接从01_uart_hello工程中复制“application”目录下的源代码到新建工程的“application”中。这里的文件组织是按照LiteFwLib的统一风格设计的,大家也可以按照自己喜欢的目录结构进行组织。
启动Keil软件,创建一个空的工程。工程文件就存放在我们刚刚新建的“fsl_frdm_kl25exampleMyFirstProjectbuild”目录下。
在芯片类型选择对话框中选择“MKL25Z128xxx4”。这个是FRMD-KL25板子上的主控MCU。
后面出现的那个“Manage Run-Time Environment”的对话框,我也没用过,“确定”、“取消”或是右上角的小叉叉,随便戳一下把它赶跑就好。然后就是空白的工程。
用鼠标左键戳一下“Target 1”选中后按键盘上的“F2”键,开始改名字为“MyFirstProject”。然后在刚改好的工程名字上面用鼠标右键戳一下,在弹出菜单中选中“Manage Project Items ...”,出现“Manage Project Items”对话框,一眼就可以看出这是要在工程中创建目录和添加文件了。此处省略若干字,添加好工程后的工程组织结构如下:
这个时候编译肯定是不行的,会报错说是找不到某些文件。我们还需要配置一下头文件的搜索路径。用鼠标左键戳一下工具栏上的魔法棒(见上图红圈),就弹出一个工程选项的对话框,这个对话框我们在配置工程时会经常用到。
在“Target”标签页下,选中“Use MicroLib”,这是因为我们要使用Keil自带的标准输入输出组件stdio实现串口打印,用了这个,就可以在程序中使用printf和scanf啦,这么好的工具,LiteFwLib怎么能错过呢。
在”Output”标签页中,设定生成的obj文件存放在工程目录“build”中新建的子目录“output”下,把这些细碎的文件都整理到这个目录下,工程目录里会干净不少。当然,最后生成的可执行文件也在这里。“Creat HEX File”的功能我就不多说的,大家根据需要选择。
同样在“Listing”标签页下,设定生成的lst文件也存放在“output”目录下。
“C/C++”标签页下才是重点,在这里添加头文件的搜索路径。
Keil对路径管理还是相当智能的,在选择路径时,会自动将选中的绝对路径转换成相对路径,这样整个开发包就可以不依赖在电脑中的存放位置了。这里需要加的目录主要有本工程的“application”目录及LiteFwLib开发包提供的“include”、“driver”和“board”目录。
最后一步需要做的配置就是关于调试工具的。切换到“Debug”标签页下,选择使用JLink(这里已经将OpenSDA变身为JLink了,参见坛子里我的另一篇帖子),或者使用OpenSDA也是类似的。
到此为止,第一个工程就创建好啦。我们可以试着编译一下这个工程。
OK,无错无警告,Bingo!
确保把FRDM-KL25板子连接到电脑上,就可以下载运行了。
A oHo,可能会提示下载失败,这是因为刚接上的JLink可能默认识别使用“JTag”调试协议,我们需要把它改为“SWD”协议,OpenSDA变身的Jlink使用串行的调试
通信协议,更轻量级。在工程选项对话框中,“Debug”标签页下,我们刚才选择使用JLink的那个下拉菜单右边,有个“Settings”的按钮,戳它一下。
若是在使用JTag协议的情况下,是识别不出来与之对接的目标设备的。切换到“SW”,立马就有内核识别出来了。
使用OpenSDA变身的JLink,在每天第一次启动时都会出现一个提示对话框,“Accept”就OK。
最后,显示下载成功。
此时,打开串口终端软件,设定串口通信波特率为115200,8位有效数据,无校验,1位停止位。
然后幸福地戳一下FRDM-KL25板子上的复位按键,见证奇迹的时刻到啦。
终端上还打印出了这个工程在编译时电脑上的时间。后面的“bbs.elecfans.com”当然是我自己用键盘在终端里输入的啦。
大功告成!
4
评分
-
查看全部评分