1. 開(kāi)發(fā)環(huán)境搭建

1.1 安裝 e2studio

e2studio是瑞薩基于Eclipse CDT開(kāi)發(fā)的一個(gè)完整的開(kāi)發(fā)和調(diào)試環(huán)境，它配合FSP(Flexible Software Package) 提供了眾多可提高效率的工具，用于開(kāi)發(fā)針對(duì)瑞薩電子RA 系列 MCU 設(shè)備的項(xiàng)目。e2 studio 集成系統(tǒng)開(kāi)發(fā)環(huán)境提供一個(gè)熟悉的開(kāi)發(fā)控制臺(tái)，從該控制臺(tái)中，可以管理項(xiàng)目創(chuàng)建、模塊選擇和配置、代碼開(kāi)發(fā)、代碼生成以及調(diào)試等關(guān)鍵步驟。FSP 使用圖形用戶(hù)界面 (GUI) 來(lái)簡(jiǎn)化高級(jí)模塊及其關(guān)聯(lián)應(yīng)用程序接口 (API) 的選擇、配置、代碼生成和代碼開(kāi)發(fā)，從而顯著加速開(kāi)發(fā)過(guò)程。

點(diǎn)此鏈接進(jìn)入e2studio官網(wǎng)下載地址，下載完成后雙擊 .exe 文件安裝即可。

1.2 安裝 FSP

瑞薩電子Flexible Software Package (FSP) 是一款增強(qiáng)型軟件包，旨在為使用瑞薩電子 RA 系列 ARM 微控制器的嵌入式系統(tǒng)設(shè)計(jì)提供簡(jiǎn)單易用且可擴(kuò)展的高質(zhì)量軟件。在全新 Arm? TrustZone? 和其他高級(jí)安全功能的支持下，F(xiàn)SP 提供一種快速、通用的方式，使用量產(chǎn)級(jí)驅(qū)動(dòng)程序、Azure RTOS、FreeRTOS? 和其他中間件協(xié)議棧來(lái)構(gòu)建安全、互聯(lián)的物聯(lián)網(wǎng)設(shè)備。

FSP 包括高性能、低內(nèi)存占用的業(yè)界一流的 HAL 驅(qū)動(dòng)程序。還包含集成了 Azure RTOS 和 FreeRTOS 的中間件協(xié)議棧，能夠簡(jiǎn)化通信和安全等復(fù)雜模塊的實(shí)現(xiàn)。e2 studio IDE 提供了對(duì)圖形化配置工具和智能代碼生成器的支持，從而使編程和調(diào)試變得更加輕松快捷。FSP 使用開(kāi)放式軟件生態(tài)系統(tǒng)，并且也為裸機(jī)編程提供了靈活性，客戶(hù)可以選擇使用 Azure RTOS 或 FreeRTOS、其他自選 RTOS、現(xiàn)有代碼和第三方生態(tài)系統(tǒng)解決方案。

點(diǎn)此鏈接進(jìn)入FSP官網(wǎng)下載地址，下載完成后雙擊 .exe 文件安裝即可。

在同一個(gè)系統(tǒng)上，我們可以安裝多個(gè)不同的FSP版本。如果我們想要使用某個(gè)指定版本，可則以在開(kāi)始菜單里找到該版本FSP，然后點(diǎn)擊相應(yīng)的圖標(biāo)啟動(dòng)e2studio，此后將會(huì)使用該版本FSP打開(kāi)或創(chuàng)建項(xiàng)目工程。

1.3 創(chuàng)建新工程

這里以 FSP V4.1.0 為例，創(chuàng)建 EK-RA6M4 開(kāi)發(fā)板的Led燈示例代碼。首先在PC上的某個(gè)項(xiàng)目路徑下，創(chuàng)建e2studio的工作區(qū)間文件夾(如workspace_fspv4.1.0)。

如上節(jié)所示，在開(kāi)始菜單的FSP v4.1.0里點(diǎn)擊運(yùn)行e2studio。然后點(diǎn)擊 File -> Switch Workspace -> Other... ，然后選擇剛才創(chuàng)建的工作路徑并點(diǎn)擊 Launch啟動(dòng)。

接下來(lái)點(diǎn)擊 File -> C/C++ Project 創(chuàng)建 Renesas RA C/C++ Project 。接下來(lái)設(shè)置我們的項(xiàng)目名為 BlinkLed 。

在接下來(lái)的配置中，我們可以選擇相應(yīng)的開(kāi)發(fā)板或MCU，以及燒錄調(diào)試器的類(lèi)型。下一步我們就選擇 Flat (Non-TrustZone) Project 。

接下來(lái)我們可以選擇操作系統(tǒng)的類(lèi)型，這里就以 FreeRTOS 為例。

接下來(lái)，創(chuàng)建好的項(xiàng)目如下圖所示。點(diǎn)擊 “錘子” 圖標(biāo)就可以編譯相應(yīng)的工程文件了。

1.4 調(diào)試運(yùn)行

EK-RA6M4 開(kāi)發(fā)板上板載有J-link調(diào)試器，我們需要對(duì)工程的調(diào)試器作如下的配置，這樣就能夠調(diào)試、燒錄運(yùn)行上面編譯生成的代碼了。

接下來(lái)兩次點(diǎn)擊調(diào)試按鈕，將會(huì)開(kāi)始全速運(yùn)行程序。并可以看到開(kāi)發(fā)板上的三個(gè)Led燈同時(shí)閃爍。

1.5 導(dǎo)出工程

在前面我們開(kāi)發(fā)好BLinkLed的項(xiàng)目后，可以導(dǎo)出項(xiàng)目工程。點(diǎn)擊 File -> Export... ，這里我們選擇導(dǎo)出為壓縮包的形式。

配置好路徑后，點(diǎn)擊 Finish 按鈕即可。

接下來(lái)我們可以刪除 Workspace 下的該工程文件，嘗試導(dǎo)入之前導(dǎo)出的工程文件。首先點(diǎn)擊 File -> Import... ，這里我們需選擇" Existing Projects into Workspace "。

接下來(lái)選擇我們前面導(dǎo)出的壓縮包，并點(diǎn)擊 Finish 按鈕。

這樣，整個(gè)工程就重新導(dǎo)入成功了。

1.6 導(dǎo)入其它工程

瑞薩的官網(wǎng)提供了各個(gè)Demo開(kāi)發(fā)板的實(shí)例軟件包，這里以 EK-RA6M4 為例，可以從該開(kāi)發(fā)板的官網(wǎng)鏈接上下載它的實(shí)例軟件包。下載完成后，我們將其解壓到相應(yīng)的Workspace下。

接下來(lái)在e2studio上點(diǎn)擊 File -> Open Projects from File System 導(dǎo)入相應(yīng)的工程。

工程導(dǎo)入后，如果立即編譯將會(huì)出現(xiàn)找到頭文件 hal_data.h 的錯(cuò)誤。

該頭文件是由e2studio動(dòng)態(tài)生成的。如下圖所示，點(diǎn)擊 configuration.xml 文件，選擇相應(yīng)的 FSP 版本，然后點(diǎn)擊右上角的 Generate Project Content 按鈕重新生成代碼即可。

有時(shí)候在導(dǎo)入一些老的工程文件，編譯時(shí)可能會(huì)出現(xiàn)下面這個(gè)錯(cuò)誤:

[ERROR] Toolchain configured for project is not currently available. Please add/enable toolchain through Renesas Toolchain Management or select a different toolchain for this project.這是因?yàn)槔系墓こ炭赡苡昧艘粋€(gè)非當(dāng)前支持的交叉編譯器，這時(shí)需要在工程屬性窗口，如下配置一下交叉編譯器即可。