1.主题

FreeRTOS_R128_如何对代码源文件进行快速预处理

2.问题背景

硬件：R128
软件：FreeRTOS

客户在日常的开发过程中，会碰到源文件中有许多的宏或许多条件编译的代码，有时候需要快速确认多个宏展开后的内容或快速确认条件编译到底编译的是哪一部分代码。

那么如何在现有SDK环境下对代码源文件进行快速的预处理？

3.问题分析

预处理思路：

目前R128的SDK使用了修改后的kbuild构建框架(原始kbuild构建框架来自linux kernel)，kbuild构建框架在编译每个源文件时会同时生成一个.xxx.o.cmd文件，

这个文件里包含了编译此源文件时依赖的一些头文件以及编译时使用的编译命令，通过修改编译命令将编译时的-c参数修改为-E参数即可完成对源文件的预处理。

4.解决办法

可以手动从.xxx.o.cmd文件中拿到编译命令并修改，但这适用于要预处理的文件比较少的情况，且各个源文件的编译命令的修改过程基本相同，

因此可以使用shell脚本自动预处理来代替人工手动预处理。
这里提供一个generate_preprocess_file.sh脚本(脚本文件见附件)，脚本使用方法为：

./generate_preprocess_file.sh 

脚本输出的日志中最后2行会有生成的预处理文件的路径。
注意：脚本中调用了astyle工具将生成的预处理文件进行代码格式化，请在使用前安装astyle工具，否则脚本输出日志的最后一行将会报错。

下面具体描述下对各个核心的代码源文件进行自动预处理的步骤。

M33核和C906核代码源文件自动预处理步骤

1. 拷贝generate_preprocess_file.sh脚本到lichee/rtos目录，并执行命令chmod +x ./generate_preprocess_file.sh确保脚本文件有可执行权限
2. 执行lunch_rtos选择对应方案的M33核或者C906核
3. 执行./generate_preprocess_file.sh xxx.c命令对某个源文件进行预处理

DSP核代码源文件自动预处理步骤

1. 拷贝generate_preprocess_file.sh脚本到lichee/dsp目录，并执行命令chmod +x ./generate_preprocess_file.sh确保脚本文件有可执行权限
2. 执行./generate_preprocess_file.sh xxx.c命令对某个源文件进行预处理

脚本使用示例

下面是对M33核代码源文件arch/arm/armv8m/sun20iw2p1/sun20i.c进行预处理的结果

可以看到最终生成的预处理文件有如下2个：

build/r128s2_pro_m33/arch/arm/armv8m/sun20iw2p1/sun20i.i
build/r128s2_pro_m33/arch/arm/armv8m/sun20iw2p1/sun20i.i.orig

其中xxx.i.orig表示最原始的由编译器生成的预处理文件，xxx.i表示进行代码格式化后的预处理文件。

用vi打开对应的预处理文件后可以看到代码中的宏以及条件编译已全部展开：