9. 整理工程文件

为降低难度,在之前章节我们把程序所有内容放在一个文件夹下。这样做存在两个主要问题,第一,代码存放混乱不易阅读。第二,程序可移植性差。本章将对代码进行简单的整理,让程序存放更有条理。

本章主要内容:

  • 创建文件夹分类存储代码
  • 修改makefile

配套源码以及下载工具: - 路径:~/embed_linux_tutorial/base_code/bare_metal/button_adj

9.1. 分类存储代码

本章程序基于按键检测程序。修改后的程序结构如下图所示。

未找到图片

结合上图说明如下:

  • base.lds,将button.lds更改为base.lds。连接脚本与具体的外 设无关,并且后面的程序我们几乎不会去修改链接脚本,这里把 它修改为base.lds,你也可以根据自己喜好命令,只要和makefile中一致即可。
  • device文件夹,保存外设驱动的源文件(.c文件)。
  • include文件夹,保存程序中使用的头文件。
  • makefile,主makefile 。在主makefile中会调用”device”文件夹下的子makefile.

9.2. 修改makefile

修改makefile主要包括两部分,第一部分,在”device”文件夹下添加并编写子makefile,第二部分,修改主makefile。

9.2.1. 编写子makefile

子makefile用于将”device”文件夹下的驱动源文件编译为一个”.o”文件,完整内容如下所示。

device文件夹下的子makefile
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
 /***************第一部分************/
 all : button.o  led.o (1)
   arm-none-eabi-ld -r $^  -o device.o

 /***************第二部分************/
 %.o : %.c
   arm-none-eabi-gcc ${CFLAGS} -c $^

 /***************第三部分************/
 %.o : %.S
   arm-none-eabi-gcc ${CFLAGS} -c $^

 .PHONY: clean
 clean:
   -rm -f *.o *.bak

 /***************第四部分************/
 #定义变量,用于保存编译选项和头文件保存路径
 header_file := -fno-builtin -I$(shell pwd)/include
 export header_file

结合代码,各部分简单说明如下:

  • 第一部分,链接生成最终目标”device.o”。如果程序中新增了某个外设驱动程序,只需要将对应的”.o”文件填入”依赖”处即可。
  • 第二部分,编译”device”文件夹下的所有”.c”文件并生成对应的”.o”文件。
  • 第三部分,编译”device”文件夹下的所有”.S”文件并生成对应的”.o”文件。
  • 第四部分,它是定义在主makefile中的变量,用”export”声明后可以在其他makefile中调用。

9.2.2. 修改主makefile

主makefile的改动主要有亮点,第一,在编译命令中指明头文件位置,第二,使用命令调用子makefile,生成依赖文件。完整的代码如下所示。

主makefile文件
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 /*******************第一部分*********************/
 #定义变量,用于保存编译选项和头文件保存路径
 header_file := -fno-builtin -I$(shell pwd)/include
 export header_file

 /*******************第二部分*********************/
 all : start.o main.o device/device.o
   arm-none-eabi-ld -Tbase.lds $^ -o base.elf
   arm-none-eabi-objcopy -O binary -S -g base.elf base.bin

 /*******************第三部分*********************/
 %.o : %.S
   arm-none-eabi-gcc -g -c $^
 %.o : %.c
   arm-none-eabi-gcc $( header_file) -c $^

 /*******************第四部分*********************/
 #调用其他文件的makefile
 device/device.o :
   make -C device all

 /*******************第五部分*********************/
 #定义清理伪目标
 .PHONY: clean
 clean:
   make -C device clean
   -rm -f *.o *.elf *.bin

结合代码,各部分简单说明如下:

  • 第一部分,定义变量 “CFLAGS”。在makefile中”变量”更 像C原因中的宏定义。”-fno-builtin”是一个编译选项,用于解 决库函数与自己编写函数同名问题。”-I$(shell pwd)/include”用于指定头文件路径。
  • 第二部分,makefile最终目标,与原文件相比,这里只是修改了文件的名字。
  • 第三部分,定义生成”.o”文件的相关内容
  • 第四部分,定义生成”device/device.o”的命令,”device.o”文件由子makefile生成,所以这里只需要调用子makefile即可。
  • 第五部分,定义清理伪目标。在清理命令中不但要 清理主makefile所在文件夹的内容还要调用子makefile的清理 命令以清理子makefile所在文件夹的内容。