本教程基于韋東山百問網(wǎng)出的 DShanMCU-RA6M5開發(fā)板 進(jìn)行編寫，需要的同學(xué)可以在這里獲?。?https://item.taobao.com/item.htm?id=728461040949
配套資料獲?。篽ttps://renesas-docs.100ask.net
瑞薩MCU零基礎(chǔ)入門系列教程匯總： https://blog.csdn.net/qq_35181236/article/details/132779862
第3章 開發(fā)環(huán)境搭建與體驗(yàn)
本章目標(biāo)：
- 搭建 Renesas 的開發(fā)環(huán)境
- 使用 e2 studio 創(chuàng)建工程和編寫代碼
- 使用 RA Smart Configurator 創(chuàng)建 MDK 工程
3.1 認(rèn)識瑞薩處理器的開發(fā)環(huán)境
瑞薩處理器的軟件開發(fā)支持多種集成開發(fā)環(huán)境，比如瑞薩官方的 e2 studio，還有使用非常廣泛的 Keil MDK。
本節(jié)對這些開發(fā)軟件進(jìn)行簡單介紹，比較 e2 studio 和 MDK 這兩個(gè) IDE，提供選擇建議。
3.1.1 瑞薩的開發(fā)軟件
- 靈活配置軟件包（FSP）
靈活配置軟件包（FSP)是一款綜合性軟件，旨在以較低的內(nèi)存占用量提供快速高效的驅(qū)動程序和協(xié)議棧，專門針對 RA 產(chǎn)品家族 MCU 的架構(gòu)進(jìn)行優(yōu)化，RA 產(chǎn)品家族 MCU 的開發(fā)也充分兼顧該軟件的特性。在開發(fā) FSP 的過程中，首要目標(biāo)是為工程師提供簡單高效的功能和驅(qū)動程序，以簡化嵌入式系統(tǒng)中常見用例（如通信和安全）的實(shí)現(xiàn)。它們構(gòu)成了一個(gè)開放的軟件生態(tài)系統(tǒng)，可以靈活使用舊代碼并與第三方工具結(jié)合使用。
FSP 集成了中間件協(xié)議棧、獨(dú)立于 RTOS 的硬件抽象層(HAL)驅(qū)動程序（適用于生產(chǎn)），以及作為所有這些組件基礎(chǔ)工具的板級支持包(BSP)，還有廣泛使用的來自 Amazon Web Services 的 FreeRTOS"M 實(shí)時(shí)操作系統(tǒng)(RTOS)。以此為嵌入式系統(tǒng)設(shè)計(jì)提供了一個(gè)經(jīng)過優(yōu)化且易于使用的高質(zhì)量軟件包，該軟件包可擴(kuò)展，并且可以通過操作簡單而功能強(qiáng)大的應(yīng)用程序編程接口（APl）調(diào)用來訪問所有功能，從而輕松實(shí)現(xiàn)互換性，可滿足嵌入式系統(tǒng)軟件開發(fā)階段的大多數(shù)需求。
FSP 的層次劃分和功能如下圖所示：
它包括以下部分：
- 板級支持包(BSP)，針對每個(gè)硬件評估板和RA產(chǎn)品家族的微控制器進(jìn)行定制。它為所有支持的模塊提供起始代碼并作為這些模塊的基礎(chǔ)，以確保 FSP 模塊順利運(yùn)行。使用自定義硬件的開發(fā)人員也可以充分利用BSP，因?yàn)殚_發(fā)人員可以借助e2studio中內(nèi)置的User Pack Creator 針對其最終產(chǎn)品和電路板來定制 BSP。
- 獨(dú)立于 RTOS 的硬件抽象層(HAL）驅(qū)動程序，以較少的內(nèi)存占用量為所有片上外設(shè)和系統(tǒng)服務(wù)提供高效的驅(qū)動程序。它們可以從您的硬件中提取位設(shè)置和寄存器地址，因此無需對微控制器中底層硬件的文檔進(jìn)行大量的深入研究。
- 中間件棧和協(xié)議，可以獨(dú)立使用或與RTOS結(jié)合使用，使用 Arm°提供的統(tǒng)一APl。它們簡化了連接功能的實(shí)現(xiàn)，如 WiFi、Bluetooth@低功耗或到云服務(wù)的 MQTT 連接。還包括其他協(xié)議棧，例如支持USB傳輸、圖形處理或電容式觸摸的協(xié)議棧。
- FreeRTOST 實(shí)時(shí)操作系統(tǒng)提供可進(jìn)行多任務(wù)處理的實(shí)時(shí)內(nèi)核（采用搶占式調(diào)度形式），面向?qū)ο蟮撵`活RAM分配，以及用于任務(wù)通知、隊(duì)列、信號量和緩沖區(qū)的不同實(shí)現(xiàn)方法。FreeRTOS+FAT 和 FreeRTOS+TCP庫為需要網(wǎng)絡(luò)連接的應(yīng)用提供額外的功能。用戶可自行選擇是否使用 FreeRTOS：FSP也可以與裸機(jī)系統(tǒng)或任何其他RTOS一起使用。
- FSP 中還包含其他第三方軟件解決方案。例如，ArmCortex微控制器軟件接口標(biāo)準(zhǔn)（CMSIS）硬件抽象層、Arm MbedTM Crypto 和TLS 加密庫、Arm Littlefs故障安全文件系統(tǒng)、emWin 嵌入式圖形庫和 Segger的J-Link調(diào)試器軟件，以及 TES DIAVE 2D 圖形渲染庫。
在FSP開發(fā)過程中要實(shí)現(xiàn)的一個(gè)目標(biāo)是，創(chuàng)建簡單易用的軟件以及條理清晰、整齊劃一的API，并進(jìn)行規(guī)范的文檔記錄。工程師針對每個(gè)模塊都編制了詳細(xì)的用戶文檔（包括示例代碼），位于GitHub資源庫中或通過e2 studio的智能手冊功能，可在需要的位置（即開發(fā)環(huán)境內(nèi)部）顯示信息。FSP使用Doxygen作為默認(rèn)的文檔工具，因此各模塊源代碼的Doxygen 注釋中也提供了其他詳細(xì)信息。
- 集成開發(fā)環(huán)境e2 studio
e2 studio 由瑞薩開發(fā)和維護(hù)，其依托于 Eclipse。Eclipse是一種時(shí)下流行且用途廣泛的開源集成開發(fā)環(huán)境，可用于不同的編程語言和目標(biāo)平臺。Eclipse可以輕松進(jìn)行定制和擴(kuò)展，因此成為全球成千上萬開發(fā)人員的首選IDE，并且成為了一個(gè)事實(shí)上的標(biāo)準(zhǔn)。
e2 studio充分利用Eclipse的所有優(yōu)點(diǎn)，并加入了額外的視圖和配置器透視圖，以支持 RA 產(chǎn)品家族的所有功能。它包含創(chuàng)建、編譯和調(diào)試任意大小和復(fù)雜程度的項(xiàng)目所需的所有工具，并指導(dǎo)開發(fā)人員完成軟件設(shè)計(jì)的三個(gè)階段：準(zhǔn)備、構(gòu)建和調(diào)試。而且，它會定期更新，從而能夠使用最新的Eclipse SDK和CDT工具。
e2 studio包含為 RA產(chǎn)品家族單片機(jī)創(chuàng)建、編譯和調(diào)試項(xiàng)目所需的所有必要工具。它基于時(shí)下流行的Eclipse IDE，但瑞薩在其中加入了一些面向解決方案的組件和插件，使其功能更加強(qiáng)大。配置器尤為如此，它提供了生成新項(xiàng)目的簡單方法，并能以圖形訪問方式輕松訪問不同的硬件和軟件功能，如引腳配置或添加軟件堆，無需深入研究用戶手冊。這些配置器將自動創(chuàng)建所有必要的設(shè)置和初始化代碼，其中還加入了錯(cuò)誤檢查功能，在設(shè)計(jì)時(shí)就能檢測出有問題的組合，從而節(jié)省大量可能會浪費(fèi)在編寫和/或調(diào)試對應(yīng)用程序并無意義的代碼上的時(shí)間。
- RA Smart Configurator
RA Smart Configurator，簡稱RASC，是瑞薩官方推出的一款配置瑞薩RA系列處理器的桌面應(yīng)用工具。它集成了FSP，可以配置處理器的時(shí)鐘、引腳、事件與中斷和外設(shè)參數(shù)，并且將這些配置生成為代碼，同時(shí)適配Keil MDK和IAR兩種應(yīng)用廣泛的集成開發(fā)環(huán)境。
當(dāng)開發(fā)者的硬件板卡設(shè)計(jì)在e2 studio中無法滿足調(diào)試下載時(shí)，就可以選擇使用RASC配合Keil MDK或者IAR進(jìn)行調(diào)試下載。
3.1.2 e2 studio和Keil MDK的區(qū)別和選擇
e2 studio是瑞薩電子的一款包含代碼開發(fā)、構(gòu)建和調(diào)試的開發(fā)工具，是基于開源Eclipse IDE和與之相關(guān)的C/C++開發(fā)工具。e2 studio 托管了瑞薩的FSP靈活配置軟件包，這是一個(gè)用于支持瑞薩MCU開發(fā)的固件庫。通過使用FSP庫，我們可以輕松配置和管理瑞薩MCU，從而輕松實(shí)現(xiàn)復(fù)雜的應(yīng)用程序。
Keil 也稱為 KEIL MDK-ARM、KEIL MDK、Keil uVision5 等，是ARM官方的一款專為微控制器應(yīng)用而設(shè)計(jì)的集成開發(fā)工具。Keil軟件為基于Cortex-M、Cortex-R4、ARM7、ARM9 處理器設(shè)備提供了一個(gè)完整的開發(fā)環(huán)境，功能強(qiáng)大，能夠滿足大多數(shù)的嵌入式應(yīng)用。我們在使用Keil軟件開發(fā)瑞薩RA MCU時(shí)，為了方便配置芯片和生成FSP庫代碼，需要配合RA Smart Configurator(RASC)軟件一起使用。
本書使用的e2 studio版本是V2023-01，已經(jīng)默認(rèn)支持除瑞薩自身的調(diào)試器和J-Link。本書使用的開發(fā)板集成了DAP調(diào)試器，要在e2 studio上使用DAP需要按照后續(xù)章節(jié)進(jìn)行配置。相比如Keil MDK，e2 studio提供了開發(fā)者助手，它會列出模塊的所有函數(shù)，可以、拖拽這些函數(shù)就可以生成代碼，它也更耗系統(tǒng)資源。
而Keil MDK已經(jīng)支持DAP調(diào)試器。
請根據(jù)個(gè)人愛好進(jìn)行選擇。
3.2 e2 studio的安裝
本節(jié)的主要內(nèi)容就是講解e2 studio的安裝及其工程的創(chuàng)建。
3.2.1 獲取e2 studio安裝軟件
打開https://github.com/renesas/fsp/releases，往下拉找到“Assets”，點(diǎn)擊下載文件“setup_fsp_v4_3_0_e2s_v2023-01.exe”：
3.2.2 e2 studio安裝步驟
雙擊運(yùn)行setup_fsp_v4_3_0_e2s_v2023-01.exe，首先會彈出一個(gè)軟件內(nèi)容讀取進(jìn)度條，隨后會要求用戶選擇安裝權(quán)限，一般選擇“All Users”，如下圖所示：
在隨后出現(xiàn)的界面里，選擇“Quick Install”：
隨后安裝軟件會掃描當(dāng)前電腦的環(huán)境是否支持安裝，支持的話會全部顯示綠色?，然后點(diǎn)擊“Next”開始下一步安裝，如下圖所示：
在隨后出現(xiàn)的界面勾選“I accept the terms of the Software Agreements”，然后一路使用默認(rèn)選擇即可開始安裝。
安裝完成后，可以得到如下界面：
3.3 e2 studio使用指南
3.3.1 創(chuàng)建e2 studio工程
如果是首次打開e2 studio，會要求選擇工作空間（本書使用e:\e2_projects）和指定工具鏈（使用默認(rèn)值），如圖所示：
接著就會顯示一個(gè)歡迎界面，可以在此界面選擇點(diǎn)擊“Create a new C/C++ project”創(chuàng)建一個(gè)工程：
然后在彈出的界面的左側(cè)選擇“Renesas RA”,然后在右側(cè)選擇“Renesas RA C/C++ Project”后點(diǎn)擊“下一步”開始創(chuàng)建工程，如圖所示：
在以后的使用中，建議從菜單欄的“文件”處創(chuàng)建工程（后續(xù)操作是一樣的），如下圖所示：
接下來開始創(chuàng)建工程。
- 設(shè)置工程名稱
首先彈出的是設(shè)置工程名稱的界面：
開發(fā)者可以在這里設(shè)置工程的名稱以及該工程保存的位置，注意不要有中文。默認(rèn)情況下保存在缺省位置處。
當(dāng)設(shè)置好工程名稱和工程保存位置后點(diǎn)擊“下一步”開始設(shè)置工程的細(xì)節(jié)。
- 選擇芯片及工具
在此頁面可以指定FSP版本、指定芯片型號（本書使用R7FA6M5BF2CBG），其他都使用默認(rèn)值即可，如下圖所示：
![](http://photos.100ask.net/renesas-docs/DShanMCU_RA6M5/object_oriented_module_programming_method_in_ARM_embedded_system/chapter-3/image15.png" />
注意：本書配套的板子沒有繼承J-Link，本章節(jié)僅供參考。
- 選擇工程類別
e2 studio的工程類別有Flat、TrustZone Secure和TrustZone Non-secure三種，在沒有涉及程序保密等安全需求下，選擇Flat簡單類別的工程即可。
- 選擇工程編譯結(jié)果
如下圖選擇，表示它是一個(gè)不含RTOS代碼的可執(zhí)行程序：
- 工程模板設(shè)定
如果開發(fā)者在板卡選擇那里沒有使用官方板卡的話，這里只有一種選擇：最小系統(tǒng)初始化：
- 使用FSP配置外設(shè)
當(dāng)工程創(chuàng)建完畢后會彈出一個(gè)提示框提示開發(fā)者是否打開透視圖：
這個(gè)透視圖就是FSP的配置界面：
這個(gè)工程已經(jīng)可以編譯了，如下圖操作：
![](http://photos.100ask.net/renesas-docs/DShanMCU_RA6M5/object_oriented_module_programming_method_in_ARM_embedded_system/chapter-3/image21.png" />
如何使用e2 studio配置硬件、生成代碼，請參考后續(xù)章節(jié)。
3.3.2 e2 studio界面說明
當(dāng)創(chuàng)建好工程并且打開透視圖之后，呈現(xiàn)在讀者面前的是這樣一個(gè)界面：
菜單欄和工具快捷欄讀者可以自行點(diǎn)擊查看支持的功能，本節(jié)講一下e2 studio的視圖切換及各視圖的公用區(qū)別。
切換視圖的快捷鍵在工具快捷欄的最右側(cè)，如下圖所示：
“C”是切換到代碼編寫視圖，在此視圖下，隨意打開一個(gè)源文件或頭文件，最左側(cè)的框圖將由初始頁面的FSP可視化頁面變?yōu)樵次募蝾^文件的大綱頁面，顯示出文件內(nèi)包含的頭文件、宏定義、函數(shù)聲明等，例如在此視圖下打開hal_entry.c，其表現(xiàn)如圖所示：
通過大綱提示，開發(fā)者可以很快的瀏覽了解該文件的主要內(nèi)容。
3.3.3 FSP配置
“FSP Configuration”是切換到FSP的配置頁面，打開FSP配置界面，初始界面如下圖所示：
左側(cè)框圖是開發(fā)者配置處理器及其外設(shè)的主要操作窗口，它有支持的配置項(xiàng)如下：
- Summary：關(guān)于當(dāng)前處理器或辦卡的信息總結(jié)，包括處理器型號、工具欄及其版本、FSP版本、組件版本等等；
- BSP：板級支持包（BSP）配置頁，用以選擇FSP版本、板卡型號、和處理器型號等；
- Clocks：時(shí)鐘配置頁，用以配置時(shí)鐘源、PLL分倍頻系數(shù)，來配置系統(tǒng)時(shí)鐘和各總線時(shí)鐘；
- Pins：引腳配置頁，用以配置某個(gè)引腳的功能或者配置某個(gè)硬件外設(shè)的具體功能的引腳選擇；
- Interrupts：中斷配置頁，用戶可以在這里查看到已經(jīng)配置的所有事件/中斷及其在程序中的中斷服務(wù)函數(shù)命；用戶也可以在此處添加自己的事件/中斷，并為其中斷服務(wù)函數(shù)自定義名稱；
- Event Links：事件鏈接配置頁，這是一個(gè)生產(chǎn)者-消費(fèi)者模型，目的是讓事件產(chǎn)生者去觸發(fā)一個(gè)事件消費(fèi)者的中斷，配置此項(xiàng)還需要在之后的Stacks出添加ELC配置項(xiàng)；
- Stacks：堆棧配置頁，用以配置具體硬件外設(shè)的參數(shù)，例如IO的ELC觸發(fā)源、UART的波特率等等；初始情況只有IO的堆棧配置，當(dāng)需要配置其它外設(shè)參數(shù)時(shí)點(diǎn)擊該頁左上方的“New Stack”來添加外設(shè)配置；
- Components：組件配置頁，在此處添加瑞薩官方FSP、官方HAL庫、第三方中間件和第三方RTOS等；
右側(cè)框圖是FSP的可視化配置圖，可以在這個(gè)芯片圖中右鍵選中某個(gè)引腳來配置其功能（跟在Pins頁面配置引腳是一樣的效果），以P402引腳為例，如下圖所示：
3.3.4 e2 studio工程結(jié)構(gòu)說明
當(dāng)創(chuàng)建好一個(gè)e2 studio工程后，其初始的工程結(jié)構(gòu)如下圖所示：
依次來看下這個(gè)結(jié)構(gòu)中各文件夾和文件的主要內(nèi)容和作用：
- Includes：此處顯示了工程使用到的所有頭文件所在的路徑；
- ra：此文件夾中包含的是ARM內(nèi)核支持的CMSIS接口的頭文件以及瑞薩的FSP源文件和頭文件；
- ra_gen：此文件夾包含的是經(jīng)FSP配置后生成工程內(nèi)容后的代碼源文件；
- src：初始情況下此文件夾下只有一個(gè)hal_entry.c源文件，其中實(shí)現(xiàn)了入口函數(shù)hal_entry()和系統(tǒng)初始化會調(diào)用的一個(gè)函數(shù)R_BSP_WarmStart();
- Debug：此文件夾下包含的是內(nèi)存寄存器地址鏈接文件，不可更改，如圖所示：
- ra_cfg：此文件夾下包含的是fsp配置后的頭文件，其中是對fsp配置參數(shù)的宏定義或聲明；
- script：此文件夾下是整個(gè)工程編譯所需要的鏈接文件；
- configuration.xml：FSP配置頁面的xml文件，如果開發(fā)過程中將FSP配置頁面關(guān)閉了可以雙擊此文件重新打開；
- xxx Debug_Flat.lunch：工程調(diào)試運(yùn)行信息；
- Developer Assistance：開發(fā)者助手，此處會將在FSP的Stacks中配置的外設(shè)所支持的所有HAL庫函數(shù)顯示出來，并且可以讓開發(fā)者將庫函數(shù)直接拖拽到代碼文件中進(jìn)行編輯，如下圖所示：
將“Call_R_IOPORT_Open”往hal_entry()的代碼編輯處拖拽過去后，其調(diào)用方式直接就生成到了代碼中，開發(fā)者只需要重新編輯該函數(shù)的參數(shù)和返回值即可，非常的方便快捷。
3.3.5 e2 studio開發(fā)者助手
在上一小節(jié)已經(jīng)簡單演示了開發(fā)者助手在開發(fā)過程中的妙用，它不僅能讓開發(fā)者快速的了解某個(gè)外設(shè)所支持的庫函數(shù)有哪些，還能直接拖拽到函數(shù)中進(jìn)行使用，極大的方便了開發(fā)。
要在開發(fā)者助手中了解某個(gè)外設(shè)的庫函數(shù)和拖拽使用，必須要先在FSP的配置界面中的Stacks中添加該外設(shè)才行，默認(rèn)情況下只有IOPORT，本書以SCI中的UART為例來簡單講解下Stacks和開發(fā)者助手的配合使用。
- Stacks中添加外設(shè)
去FSP的Stacks中點(diǎn)擊“New Stack”，然后選擇其中的“Connectivity”，再選擇其中的“UART”，如圖所示：
選擇之后在Stacks頁面的“HAL/Common Stacks”中將會新增一個(gè)UART的堆棧配置：
選中新增的UART的堆棧配置，在“屬性”頁可以配置這個(gè)UART的具體參數(shù)，如下圖所示：
如果e2 studio的整個(gè)頁面沒有“屬性”頁，可以在e2 studio的菜單欄點(diǎn)開“窗口”，選擇其中的“顯示視圖”，然后點(diǎn)擊其中的“屬性”，即可打開屬性頁，如下圖所示：
- 開發(fā)者助手中使用外設(shè)庫函數(shù)
在Stacks中配置好外設(shè)的參數(shù)后，點(diǎn)擊“Generate Project Content”,隨后在展開工程中的開發(fā)者助手“Developer Assistance”，繼續(xù)展開其中的“HAL/Common”，就能看到其中增加了配置的那個(gè)外設(shè)的庫函數(shù)，如圖所示：
開發(fā)者只需要將庫函數(shù)拖拽到代碼中再重新編輯參數(shù)和返回值即可完成庫函數(shù)的調(diào)用。
3.3.6 e2 studio中配置DAP調(diào)試
e2 studiostudio本身尚未支持DAP調(diào)試工具，需要開發(fā)者自行安裝。本節(jié)介紹如何安裝Pyocd軟件以支持板載的DAP調(diào)試器。
- 在Windows安裝python
Pyocd的運(yùn)行需要python環(huán)境。如果讀者的Windows不支持python，即使用Windows的CMD執(zhí)行python后沒有顯示版本和python運(yùn)行符的話，需要先去安裝最新版本的python（請自行安裝）。
- 在Windows安裝pyocd
Pyocd的官網(wǎng)網(wǎng)址：https://pyocd.io。 讀者可以在官網(wǎng)中獲取pyocd的安裝方法和支持的指令，如下圖所示：
在支持python（3.7版本以上）的Windows中，按下Win+R，輸入CMD打開命令行：
然后輸入指令：python3 -m pip install -U pyocd等待安裝完成即可，有些環(huán)境下可能python3無法生效，則換成python -m pip install -U pyocd執(zhí)行即可：如下圖所示：
安裝完成之后，在命令行執(zhí)行pyocd -V查看版本來驗(yàn)證pyocd是否安裝成功，如下圖所示：
在后續(xù)e2 studio中配置pyocd環(huán)境的時(shí)候，還需要知道pyocd-gdbserver所在路徑，同樣的可以在命令行執(zhí)行where.exe pyocd-gdbserver獲取路徑，如下圖所示：
圖中劃線部分就是后續(xù)需要的路徑。
- 使用Pyocd查看處理器型號
先查看pyocd的target命令用法，特別是其中的子命令“pack”的用法：
![](http://photos.100ask.net/renesas-docs/DShanMCU_RA6M5/object_oriented_module_programming_method_in_ARM_embedded_system/chapter-3/image42.png" />
我們需要先獲取瑞薩處理器的PACK包，打開https://github.com/renesas/fsp/releases，往下拉找到“Assets”，點(diǎn)擊下載這MDK_Device_PACKS_vxxx.zip，如下圖所示：
將此壓縮包解壓出來，比如放到桌面，打開解壓出來的文件夾，按住shift然后點(diǎn)擊鼠標(biāo)右鍵：
隨后在打開的powershell命令行中執(zhí)行下面這條指令查看這個(gè)pack文件支持的瑞薩處理器型號：
pyocd list --target --pack Renesas.RA_DFP.4.3.0.pack
如下圖所示：
在這里可以看到瑞薩處理器的這個(gè)pack文件支持的所有的處理器型號，在后續(xù)配置pyocd調(diào)試的時(shí)候需要填寫型號，內(nèi)容就是從這里得來，以本書使用的R7FA6M5BF2CBG為例，需要的型號名稱就是“r7fa6m5bf”或者“R7FA6MFBF”。
解壓出來的Renesas.RA_DFP.4.3.0.pack，要記住它的目錄，后面配置調(diào)試信息時(shí)要使用。
- e2 studio安裝GDB Toolchain
搭建好pyocd環(huán)境之后，就需要在e2 studio中進(jìn)行配置了。在e2 studio配置pyocd的前提是安裝好GNU ARM C/C++ Cross Development Tools。
打開e2 studio，點(diǎn)擊“幫助”，選擇“安裝新軟件……”，如下圖所示：
在彈出的窗口中，于“Work with”后面的文本框中填入以下鏈接后按下回車鍵，獲取安裝信息：
http://sourceforge.net/projects/gnuarmeclipse/files/Eclipse/updates/
這會得到GNU ARM交叉編譯工具鏈的安裝信息，如下圖所示：
如果只需要pyocd的話就只選擇安裝GNU ARM C/C++ Pyocd Debugging即可，如果實(shí)在不清楚，可以全選安裝。選擇好之后點(diǎn)擊右下角的“下一步”開始安裝：
隨后等待安裝完成即可：
安裝過程中會彈出“Trust”窗口，勾選其中的選項(xiàng)然后點(diǎn)擊“Trust Selected”繼續(xù)安裝，如下圖所示：
安裝完成之后會要求重啟e2 studio軟件，點(diǎn)擊重啟：
- e2 studio配置pyocd
e2 studio安裝了GNU ARM Pyocd軟件成功且重啟軟件之后，點(diǎn)擊菜單欄的“窗口”，選擇其中的“首選項(xiàng)”：
在彈出的窗口中展開“運(yùn)行/調(diào)試”，找到里面的“PyOCD”，在“Executable”中填入“pyocd-gdbserver.exe”，在“Folder”中填入pyocd-gdbserver.exe所在路徑，也就是前文講到的那個(gè)路徑，配置如下圖所示：
至此pyocd在e2 studio中的環(huán)境配置就設(shè)置好了，下面開始設(shè)置調(diào)試。
- e2 studio設(shè)置基于pyocd的調(diào)試器
首先打開一個(gè)e2 studio的工程，然后點(diǎn)擊e2 studio中菜單欄的“運(yùn)行”，選擇其中的“調(diào)試配置”，如下圖所示：
![](http://photos.100ask.net/renesas-docs/DShanMCU_RA6M5/object_oriented_module_programming_method_in_ARM_embedded_system/chapter-3/image54.png" alt=“img” />
在彈出的窗口中選擇“GDB PyOCD Debugging”后鼠標(biāo)右鍵，選擇“新建配置”，如下圖所示：
稍微等待一會兒，右側(cè)會更新為GDB Pyocd的調(diào)試配置界面，如下圖所示：
在主要這一欄，如果是選擇了具體的工程后新建的配置，則會自動搜索指定該項(xiàng)目及其編譯的elf文件，如果沒有選擇具體的工程，那么這一項(xiàng)會為空。
需要重點(diǎn)關(guān)注的是Debugger這一欄，其默認(rèn)參數(shù)基本不需要修改，需要用戶選擇填寫的是調(diào)試器、調(diào)試目標(biāo)處理器型號以及參數(shù)指令，如下圖所示：
- Board：DAP調(diào)試器；
- Override target:調(diào)試處理器型號，需要勾選后再填寫；
- Other options：PyOCD的—pack指令指定處理器所在pack包；
配置好之后直接點(diǎn)擊“運(yùn)行”即可使用DAP調(diào)試代碼了。
- 指定Renesas.RA_DFP.4.3.0.pack
3.4 RASC和Keil MDK的安裝
3.4.1 獲取RASC和MDK的安裝軟件
需要下載3個(gè)軟件：
- MDK_Device_Packs_v4.3.0.zip：它是MDK使用的瑞薩MCU支持包
- setup_fsp_v4_3_0_rasc_v2023-01.exe：它是RASC的安裝軟件
- Keil MDK：它是一個(gè)集成開發(fā)工具
下載之后，先安裝Keil MDK，再安裝MDK_Device_Packs_v4.3.0.zip。setup_fsp_v4_3_0_rasc_v2023-01.exe的安裝順序不重要。
- RA Smart Configurator
打開https://github.com/renesas/fsp/releases，往下拉找到“Assets”，點(diǎn)擊下載這兩個(gè)文件：
- Keil MDK
在官網(wǎng)www.keil.com首頁點(diǎn)擊“Downloads”進(jìn)入下載鏈接，隨后選擇“MDK-Arm”，如下圖所示：
然后填寫基本信息提交后，進(jìn)入exe下載頁，點(diǎn)擊“MDKxxx.EXE”開始下載，如下圖所示：
3.4.2 Keil MDK的安裝步驟
先安裝MDKxxx.EXE，然后再安裝PACKS。
- 安裝Keil MDK
MDK的安裝比較簡單，安裝步驟主要是下圖所示的6步：
- 安裝首頁，點(diǎn)擊“Next”開始下一步安裝；
- 協(xié)議知情書，勾選“I agree……”后點(diǎn)擊“Next”開始下一步安裝；
- Keil MDK核心文件和Keil MDK 的設(shè)備Packs包安裝路徑，可以自定義，注意不要帶有中文；設(shè)置好之后點(diǎn)擊“Next”開始下一步安裝；
- 基本信息收集，隨意填寫即可，填寫好之后點(diǎn)擊“Next”開始安裝；
- 安裝進(jìn)度，等待安裝完成即可；安裝過程中如果彈出需要安裝xxx軟件，點(diǎn)擊安裝即可；
- 安裝完成，點(diǎn)擊“Finish”結(jié)束安裝；
Keil MDK主體安裝完成之后會彈出一個(gè)“Pack Installer”，它會刷新和安裝最新的ARM編譯器、CMSIS固件等。
- 安裝RA Packs
解壓MDK_Device_Packs_v4.3.0.zip后，雙擊安裝即可。安裝步驟如圖所示：
只需要點(diǎn)擊“Next”后等待安裝完成即可，安裝完成后點(diǎn)擊“Finish”結(jié)束pack的安裝。
3.4.3 RASC的安裝步驟
雙擊setup_fsp_v4_3_0_rasc_v2023-01.exe即可安裝，一開始會彈出一個(gè)進(jìn)度條然后選擇用戶安裝權(quán)限：
選擇“All Users”，然后開始安裝流程。
- 首先依然是環(huán)境掃描和協(xié)議告知，依次點(diǎn)擊“Next”、勾選“I accept……”后點(diǎn)擊“Next”：
- 隨后設(shè)置在開始菜單中的安裝組，默認(rèn)就好，然后點(diǎn)擊“Install”開始安裝，等待進(jìn)度條執(zhí)行完后就安裝完成了：
- 安裝完成，點(diǎn)擊“OK”結(jié)束安裝：
3.4.4 將RASC集成到Keil MDK
將RASC集成到Keil MDK后，可以在MDK中直接啟動RASC進(jìn)行配置。安裝好RASC后，可以開始菜單看到如下指引，本節(jié)內(nèi)容來自這個(gè)指引：
首先運(yùn)行Keil MDK，在菜單欄點(diǎn)擊‘Tools’，然后選擇“Customize Tools Menu…”，如下圖所示：
然后在彈出的窗口中點(diǎn)擊“New”圖標(biāo)新建一個(gè)菜單項(xiàng)，參考下表進(jìn)行填寫：
| 目錄 | 內(nèi)容 |
|---|---|
| Menu Content | RA Smart Configurator |
| Command | C:\path\to\rasc.exe （rasc.exe的完整路徑） |
| Initial Folder | $P |
| Arguments | –device $D --compiler ARMv6 configuration.xml |
| Run Independent | ? |
最終結(jié)果如下圖所示：
![](http://photos.100ask.net/renesas-docs/DShanMCU_RA6M5/object_oriented_module_programming_method_in_ARM_embedded_system/chapter-3/image70.png" />
使用同樣的辦法繼續(xù)添加其他兩個(gè)菜單項(xiàng)：Smart Bundle Viewer、Device Partition Manager，參考下面2個(gè)表格。
l Smart Bundle Viewer的配置項(xiàng)：
| 區(qū)域 | 內(nèi)容 |
|---|---|
| Menu Content | Smart Bundle Viewer |
| Command | C:\path\to\rasc.exe （rasc.exe的完整路徑） |
| Initial Folder | $P |
| Arguments | -nosplash --viewsmartbundle “$L@L.sbd” |
| Run Independent | ? |
l Device Partition Manager的配置項(xiàng)：
| 區(qū)域 | 內(nèi)容 |
|---|---|
| Menu Content | Device Partition Manager |
| Command | C:\path\to\rasc.exe （rasc.exe的完整路徑） |
| Initial Folder | $P |
| Arguments | -application com.renesas.cdt.ddsc.dpm.ui.dpmapplication configuration.xml"$L%L" |
| Run Independent | ? |
配置完成后，可以在Tools菜單看到如下三個(gè)菜單項(xiàng)：
以后使用Keil打開工程后，點(diǎn)擊“Tools > RA Smart Configurator”即可打開RASC。
3.5 RASC和Keil MDK使用指南
3.5.1 使用RASC創(chuàng)建MDK工程
先啟動RASC，如下圖所示：
RASC啟動后，它彈出如下對話框，開始新建工程。以“0301_mdk_demo”工程為例，如下圖輸入各項(xiàng)參數(shù)：
點(diǎn)擊Next按鈕，進(jìn)一步配置：選擇單板、芯片、IDE等。本例程使用的芯片是R7FA6M5BF2CBG、IDE是“Keil MDK Version 5”，如下圖所示：
繼續(xù)點(diǎn)擊Next按鈕，在后續(xù)的3個(gè)頁面中如下圖設(shè)置：
創(chuàng)建完成后得到如下的界面,點(diǎn)擊“Summary”項(xiàng)中“Location”處最右端的跳轉(zhuǎn)圖標(biāo)可以打開工程所在文件夾：
雙擊“0302_mdk_demo.uvprojx”文件即可打開此Keil工程，它并沒有做實(shí)際的事情，后續(xù)可以參考《第5章 GPIO輸入輸出》添加LED的控制代碼。但是，現(xiàn)在這個(gè)工程已經(jīng)可以編譯、下載、運(yùn)行了。在Keil菜單中點(diǎn)擊一下按鈕即可編譯程序：
3.5.2 配置MDK工程
使用RASC創(chuàng)建的MDK工程可以編譯通過，但是無法直接燒寫，需要進(jìn)一步配置。先使用USB線把板子的“UART&DAP”口連接到電腦，然后打開MDK工程。
使用RASC創(chuàng)建的MDK工程，它的默認(rèn)配置里沒有為芯片添加配置（比如Flash的燒寫算法）。我們可以先選擇任意其他芯片，再選擇回我們所使用的芯片，MDK就會為這個(gè)芯片添加配置。
方法為：先點(diǎn)擊“魔術(shù)棒”，再點(diǎn)擊“Device”，本教程使用的是下圖編號④的R7FA6M5BF，故意先點(diǎn)擊編號③的其他芯片，再點(diǎn)擊編號④的芯片，就可以讓MDK為R7FA6M5BF添加芯片配置信息了。如下圖所示：
這時(shí)，點(diǎn)擊“Debug”頁面，選擇DAP調(diào)試器，然后點(diǎn)擊“Setting”，如下圖所示：
在設(shè)置界面，確認(rèn)“SWJ”被勾選、Port被選為“SW”（下圖編號⑧），并且識別出了芯片（下圖編號⑨），如下圖所示：
繼續(xù)點(diǎn)擊上圖的“Flash Download”，勾選“Reset and Run”；并確?！癙rogramming Algorithm”里不是空白的，否則就要回到剛開始的步驟故意切換為其他芯片再切換回R7FA6M5BF。如下圖所示：
3.5.3 編譯和調(diào)試下載程序
Keil MDK的編譯可以使用快捷鍵“F7”來進(jìn)行，也可以使用快捷欄圖標(biāo)進(jìn)行編譯和全部重新編譯，如下圖所示：
燒寫代碼可以點(diǎn)擊上圖中的“LOAD”雙向下箭頭圖標(biāo)進(jìn)行程序燒寫，也可以使用快捷鍵“F8”來燒寫。
Keil MDK的調(diào)試按鈕在快捷欄圖標(biāo)的左側(cè)，如下圖所示：
點(diǎn)擊調(diào)試按鈕即可進(jìn)入調(diào)試界面，如下圖所示：
上圖各個(gè)區(qū)域講解如下：
a) 寄存器區(qū)：當(dāng)前內(nèi)核寄存器值；
b) 匯編區(qū)：顯示當(dāng)前MDK指針?biāo)谖恢煤痛a的匯編內(nèi)容；
c) 代碼區(qū)：此窗口左側(cè)深灰色表示可以在該處打斷點(diǎn)，右側(cè)只是實(shí)際代碼；
MDK支持的調(diào)試手段如下圖所示：文章來源：http://www.zghlxwxcb.cn/news/detail-704658.html
文章來源地址http://www.zghlxwxcb.cn/news/detail-704658.html
- Reset：復(fù)位，讓程序重新運(yùn)行；
- Run：全速運(yùn)行，如果有斷點(diǎn)則運(yùn)行到斷點(diǎn)處才停止；
- Stop：停止運(yùn)行程序，停止后可以觀察寄存器、內(nèi)存等信息；
- Step：單步運(yùn)行，此單步是以一句指令為最小單位，遇到函數(shù)調(diào)用會跳轉(zhuǎn)進(jìn)入函數(shù)內(nèi)；
- Step Over：單步跳過運(yùn)行，此單步遇到函數(shù)調(diào)用不會進(jìn)入被函數(shù)內(nèi)，而是全速執(zhí)行完函數(shù)后停止；如果函數(shù)內(nèi)有斷點(diǎn)，運(yùn)行到斷點(diǎn)時(shí)會停止；
- Step Out：單步跳出運(yùn)行，會將當(dāng)前函數(shù)剩下的指令全速執(zhí)行完，跳出函數(shù)后停止；
- Run to Cursor Line：直行到指定行，先用鼠標(biāo)點(diǎn)擊源碼某行，再點(diǎn)擊此按鈕就會運(yùn)行到這行。
到了這里，關(guān)于第3章_瑞薩MCU零基礎(chǔ)入門系列教程之開發(fā)環(huán)境搭建與體驗(yàn)的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
