解決瑞薩RA2E1開發板在RT-Thread的版本中編譯報錯 error: 'board_cfg.h' file not found

1 寫在前面
既上上周在RA2E1上把RT-Thread跑起來之后，在上周日的晚上，馬不停蹄地給《致敬未來的攻城獅計劃》的小伙伴們開了一趟在線直播課，旨在輔導小伙伴們盡快上手基于RA2E1開發板的開發，同時也把基于RT-Thread的一些開發方法和基本操作流程給大家介紹了一遍。

期間遇到了一些小插曲，說起來還是有點尷尬，都怪我這個直播沒做好充足的準備，后面需要加強一下。

2 遇到問題
在直播課程中，我主要基于KEIL、RASC、FSP這幾個軟件給大家演示，介紹如何在KEIL中打開RASC，已經從零開始配置一個新的外設（以新增UART1為例）。在RASC中完成基本的配置之后，點擊右上角的 Generate Project Content 完成代碼生成，隨后回到KEIL這邊去編譯，沒想到遇到了一個很詭異的報錯，現場直播可把我整懵了?？创笠饩褪?board_cfg.h 頭文件沒找到。蒙頭一看，還不知道咋回事，整了兩下沒搞定，還是一樣的編譯報錯，那直播現場可是 大寫的尷尬 ！

../libraries/HAL_Drivers/config/ra2l1/uart_config.h(15): warning: In file included from...
./ra_genhal_data.h(5): warning: In file included from...
./ra/fsp/inc/apibsp_api.h(32): warning: In file included from...
ra_cfg/fsp_cfg/bspbsp_cfg.h(6): error: 'board_cfg.h' file not found
#include "board_cfg.h"
^~~~~~~~~~~~~

3 分析問題
現場直播的時候，我以為是我操作有誤，導致引入了什么配置失效；當時看到頭文件找不到，我第一時間想到的是 頭文件的路徑沒有添加進去，于是我去KEIL的配置中，新增頭文件搜索路徑，結果還是失?。?/p>

直播現場快速驗證發現不行，我就打圓場搪塞過去了，演示其他的了。

后面直播結束后，我以為記得這事，等到我有空坐下來的時候，我再好好思考并解決這個問題。

前段時間參加瑞薩的設計大賽，我用的 RA4M2 這塊開發板，基本也是KEIL+RASC的開發環境，但是印象中是沒有出現這種更新了RASC的配置，導致KEIL編譯不過的問題。我上網一搜，結果也是有人遇到類似的

原來是RASC搞的鬼！這么一說，我回到我的git環境一看：git status，果然是 board_cfg.h 被刪除了。

有點想不明白的是為何之前 RA4M2的開發配置卻沒有這樣的問題。

突然我想到調試RA2E1要求瑞薩的FSP整個配套版本都需要使用 3.5.0 版本，而之前我用的是4.x 的版本，難道是版本不一樣導致的問題？

于是我對比了一下，兩次KEIL工程里面對RASC/FSP版本的要求，確實不一樣：

打開那個工程綁定的RASC，版本也確實不一樣：

但我嘗試過，直接把RA2E1的FAP升級到RA4M2使用的版本，是不行的；這應該就是兩個大版本沒有做好兼容吧。

4 解決問題

明白了問題的根源，解決起來了就有思路了。

要解決這個問題，不外乎兩種方法：

第一種方式：就是每次執行完RASC的配置更新之后，手動把 board_cfg.h 文件恢復一下，再執行KEIL的編譯。這種方式是比較笨重的，每次都需要人去接入，非常地 “不程序猿”！

第二種方式：采用自動化腳本的方式來完成這個復制、還原的操作，使得在編譯過程無感知。作為程序猿，自然是要選擇這個方式比較聰明。

要使用這種方式，我想到了使用BAT腳本，這個腳本也很簡單，就是預先把board_cfg.h文件備份在一個目錄，然后使用腳本檢測對應目標目錄下的board_cfg.h是否存在，如果不存在，則拷貝過去。對應的BAT腳本如下：

@echo off
SET BoardCfgFile=board_cfg.h
SET SourceFile=ra_bak%BoardCfgFile%
SET DstFile=ra_cfgfsp_cfgbsp%BoardCfgFile%
if exist %SourceFile% (
if not exist %DstFile% (
echo f | xcopy %SourceFile% %DstFile% /i /y
) else (
echo %DstFile% is exist!
)
) else (
echo %SourceFile% is not exist!
)

把上面的腳本取名為 board_cfg.bat，在每次KEIL執行編譯前調用一下就可以了。

但是，還是要手動去執行一下這個BAT腳本？

這就需要了解一下KEIL里面有個配置，編譯前、編譯后，可以自定義腳本運行的小功能；在這里使用它就可以完美地解決我們的需求。見圖：

5 更多思考
其實，這個問題的引入本質還是一個 版本兼容的問題，由此我想到了幾點：

版本兼容始終是個大難題，無論是小廟還是大廠，都或多或少遇到這樣的困擾，如果大家有什么好的思路，可以在評論席一起交流交流。
學會精準地尋找問題的答案，你遇到的問題，保不準別人早已經遇到過；善于發現它們，并整理成文，方便更多的用它解決問題；
善于用腳本去解決一些機械操作的問題；靈活解放自己的雙手這很重要；如果是windows下開發，自然少不了BAT腳本；如果是linux下開發，少不了SHELL腳本；當然，如果你能掌握Python腳本開發，那就再好不過了；
涉及到編譯過程中，找不到頭文件的問題，需要多思考一步。