STM32高级开发(6)-makefile与调试器驱动_跟我一起写makefile stm32

最新推荐文章于 2025-07-15 13:39:07 发布

原创最新推荐文章于 2025-07-15 13:39:07 发布 · 312 阅读

CC 4.0 BY-SA版权

文章标签：


先说说这个文件怎么用吧，我们进入工程目录后使用make指令来执行它(Ubuntu是自带make工具的，所以不用下载安装)，make工具就会调用目录下名为Makefile的文件，并根据其中的设置来执行指令。在这个makefile中就是生成hex和bin文件。

make


关于makefile的具体说明和教程，论坛大神**陈皓**曾经写过一个系列[跟我一起写 Makefile](https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0)其中把Makefile的功能和用法写的已经十分详尽了，大家可以去他的博客阅读学习或是百度下载一个网友总结好的PDF文档来学习。基本上看完前20%，你就可以理解上面这个makefile的意思和作用了。  
 ![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjIxMDE0NTk2?x-oss-process=image/format,png)


在这篇中我们重点讲述软件的安装和功能介绍，其具体的用法会在之后的篇章中慢慢讲解。所以接下来我们先来看调试器驱动的介绍。




---


#调试器驱动  
 虽然我更建议大家且实际经常使用的是OpenOCD作为调试器驱动，但是我仍然会为大家讲解一下其他的驱动方式。




---


##st-link  
 在Linux上，st-link是有是一个专门的驱动的，在用户文件夹下输入git指令，从GitHub上下载驱动或直接打开网页下载也行。当然啦在使用git工具前首先要安装它。

$ sudo apt-get install git
$ git clone https://github.com/texane/stlink.git



> 
> https://github.com/texane/stlink
> 
> 
> 


[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fxKoejUu-1572081861901)(https://img-blog.csdn.net/20170130230840843?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhlbmd5YW5nbGl1MTIz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)]


在使用git下载命令后或下载好压缩包解压后我们就会得到一个文件夹，使用终端进入文件夹后，首先执行一下指令安装libusb和cmake程序，这2个程序是st-link驱动编译时需要的，所以需要先安装它。

$ sudo apt-get install libusb-1.0.0-dev
$ sudo apt-get install cmake


在安装完后，使用终端进入st-link驱动的文件夹执行指令：

$ cd ./stlink
$ make
$ cd ./build/Release
$ sudo make install


![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjMwNzE3NDc3?x-oss-process=image/format,png)


![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjMxNTQzMDgx?x-oss-process=image/format,png)


到这里st-link的驱动就安装完成了，下载的文件此时就可以删除了。这时连接st-link调试器，用lsusb命令就可以查看到相关的设备已经连接上，如下图。  
 ![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjIzMDUxOTI4?x-oss-process=image/format,png)


**注意在设备插上计算机后，要在虚拟机右下脚将st-link连接到虚拟机上**  
 ![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjMyMDAwMzg1?x-oss-process=image/format,png)


驱动程序可以通过终端指令来使用，如下载bin程序

$ st-flash write $hello.bin 0x8000000


在比如开启调试器将它接在计算机网络端口：4242上

$ sudo st-util




---


##j-link


Ubuntu下jlink的驱动安装可以参考这个文章，我之前安装过但好久没用了，所以不确定这篇文章的正确性，只是看着应该没有问题：[（转载）JLink - JLink for Ubuntu](https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0)




---


##OpenOCD  
 接下来就到了我们的重头戏了，OpenOCD，这绝对是是一个神一样的存在，忘了是在那里看到的简介了，如果没记错的话，这是一个国外研究生在上学时构思与完成的软件，它在Linux上运行并且支持几乎所有你见过的arm调试器，它在国内的介绍网页是这个：[开源的JTAG上位机程序 OpenOCD](https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0)


安装好它也就是说，不管什么st-link，j-link，open j-link之流的调试器，只要有OpenOCD就能驱动，就能使用，哈~这软件够强大吧。


下面我们就来介绍它的安装方式：


1. 下载openocd  
 网址： http://sourceforge.net/projects/openocd/
2. 解压
3. 进入解压之后的目录 cd /openocd-0.10.0
4. 进行配置

$ ./configure


如果这个时候出现错误提示 找不到usb.h,原因是没有安装libusb的库  
 下面安装Libusb库即可解决。


5. 安装libusb库

$ sudo apt-get install libusb+±dev
$ ./configure


![这里写图片描述](https://imgconvert.csdnimg.cn/aHR0cDovL2ltZy5ibG9nLmNzZG4ubmV0LzIwMTcwMTMwMjMyODMzNTIx?x-oss-process=image/format,png)  
 在最后我们可以看到这个配置支持的调试器类型，有些偏门的调试器在默认设置下是没有打开的，我们可以通过类似于 ./configure --enable-jlink 的配置指令打开。


6.

$ make

7.

$ sudo make install


至此OpenOCD的安装便完成了，可以删除下载的文件了。完成安装后，我们可以在\*\*/usr/local/share**的路径下看到一个**openocd\*\*文件夹，在其下scripts文件夹下保存着我们以后使用OpenOCD连接调试器的配置文件。


如，在连接 stlink-V2+stm32f1xx 的硬件系统时我们使用指令来加载配置文件，从而下载程序：

openocd -f /usr/share/openocd/scripts/interface/stlink-v2.cfg -f /usr/share/openocd/scripts/target/stm32f1x_stlink.cfg -c init -c halt -c “flash write_image erase $(TOP)/LED_project.hex” -c reset -c shutdown


*后加：有些同学的安装目录可能在其他位置，为了避免安装目录不同的影响，我们在运行openocd时可以简写路径，openocd会自动在其script路径下搜索脚本：*

openocd -f interface/stlink-v2.cfg -f target/stm32f1x_stlink.cfg -c init -c halt -c “flash write_image erase $(TOP)/LED_project.hex” -c reset -c shutdown




---


#编译第一个程序


不论大家是否学会了使用前面那些工具，我们先放放让我们来编译一个小的流水灯工程来体会一下我们之前安装好的软件的功能吧。同时也体会一下在实际开发中，编译与下载程序的方式。


1. 首先在用户目录下创建一个新的文件夹：workspace ，作为我们以后的编程工作目录

$ mkdir ~/workspace


1. 进入workspace 文件夹，使用git指令下载我在GitHub上托管的一个简单的例程

$ cd ~/workspace
$ git clone https://github.com/zhengyangliu/simple-gcc-stm32-project.git


3. 进入样例工程的文件夹

$ cd ./simple-gcc-stm32-project


3. 使用文件浏览器打开工程目录，此工程目录结构与**原子开发板**教程配置的工程结构相同，我们打开**user**目录下的**main.c**文件，将其中的流水灯的GPIO口配置根据自己的 stm32f103 开发板修改。如果你是用的是原子的stm32f1战舰开发板V1版本，那么恭喜你，你不需要做任何的修改就可以使用了。
4. 修改后我们使用终端在工程目录下执行make指令，生成hex和bin文件

$ make


6. 此时我们就可以将生成的**LED\_project.hex**文件拷贝到宿主机上，通过ISP软件下载入单片机了。或者我们通过stlink，将st-link插上，在VMware右下角设置中接到虚拟机上，然后通过指令调OpenOCD连接st-link调试器下载。

make update


在下载完成后我们便能看到开发板上的LED闪烁了。




---


#总结


教程至此，我们已经将最基本开发环境的软件安装配置完成，而且也学到了很多新的指令如git、mkdir、make 等，也尝试了一个简单的流水灯工程的编译。但是我想大家距离理解这个开发环境的程度还很远，首先就是我们不理解makefile文件的语法和用法。这点就要求大家必须要去看至少20%的那篇**跟我一起写 Makefile**的文章，只有粗略的看得懂makefile我们才有继续下去的资本。


在你能多少理解makefile语法的基础上，我们接下来的几篇会为大家讲述编译器的指令和编译器的输入参数，同时我们会结合这篇中最后提供的样例工程中的makefile来分析在这个工程中makefile的意思和用法。




---


参考文章：  
 http://blog.163.com/brave\_smile\_heart/blog/static/187238171201261884412718/  
 http://blog.csdn.net/xiaofeng1234/article/details/38083211