《瑞薩RA產(chǎn)品家族初學(xué)者指南》系列文章已收錄成合集，歡迎點(diǎn)擊上方查看合集并訂閱！

上一章中的練習(xí)已經(jīng)利用了瑞薩RA系列單片機(jī)（MCU）靈活配置軟件包（FSP）的很大一部分。在本章中，您將使用FreeRTOS實(shí)時(shí)操作系統(tǒng)創(chuàng)建一個(gè)小型應(yīng)用程序，利用線程控制LED并利用信號(hào)量實(shí)現(xiàn)與按鈕的同步。您將親身體驗(yàn)到這實(shí)際上僅需要幾個(gè)步驟。

首先，需要定義術(shù)語(yǔ)“線程”。如果您更習(xí)慣于“任務(wù)”這個(gè)表達(dá)方式，只需把線程看作是一種任務(wù)。有些人甚至互換使用這兩個(gè)短語(yǔ)。當(dāng)使用實(shí)時(shí)操作系統(tǒng)（RTOS）時(shí)，單片機(jī)上運(yùn)行的應(yīng)用程序?qū)⒉鸱譃閹讉€(gè)較小的半獨(dú)立代碼塊，每個(gè)代碼塊通常控制程序的一個(gè)方面。這些小片段稱(chēng)為線程。一個(gè)應(yīng)用程序中可以存在多個(gè)線程，但是在任何給定時(shí)間都只能有一個(gè)線程處于活動(dòng)狀態(tài)，因?yàn)镽A系列單片機(jī)是單核器件。每個(gè)線程都有自己的堆棧空間，如果需要安全的上下文，則可以將其置于MCU的安全側(cè)。每個(gè)線程還分配有優(yōu)先級(jí)（相對(duì)于應(yīng)用程序中的其他線程），并且可以處于不同的狀態(tài)，例如運(yùn)行、就緒、阻塞或暫停。在FreeRTOS中，可以通過(guò)調(diào)用eTaskGetState()API函數(shù)來(lái)查詢線程的狀態(tài)。線程間信號(hào)傳輸、同步或通信是通過(guò)信號(hào)量、隊(duì)列、互斥、通知、直接任務(wù)通知或者流和消息緩沖區(qū)來(lái)實(shí)現(xiàn)的。

允許的消息大小可在設(shè)計(jì)時(shí)通過(guò)FSP配置器指定。默認(rèn)項(xiàng)大小為4個(gè)字節(jié)，默認(rèn)隊(duì)列長(zhǎng)度（表示隊(duì)列中可存儲(chǔ)的項(xiàng)數(shù)）為20。所有項(xiàng)的大小必須相同。FreeRTOS中的隊(duì)列數(shù)沒(méi)有限制；惟一的限制是系統(tǒng)中可用的存儲(chǔ)空間。使用xQueueSend()函數(shù)將消息放入隊(duì)列中，并通過(guò)xQueueReceive()從隊(duì)列中讀取消息。與信號(hào)量一樣，函數(shù)有兩種版本：一種可以從線程的上下文調(diào)用，另一種可以從ISR內(nèi)部調(diào)用。

接下來(lái)的練習(xí)也是基于EK-RA6M4評(píng)估板。這次，我們將使用電路板左上方的藍(lán)色按鈕S1向應(yīng)用程序傳輸事件，應(yīng)用程序?qū)⑶袚Q綠色LED2進(jìn)行響應(yīng)。為實(shí)現(xiàn)目標(biāo)，我們將使用FreeRTOS，事件的處理將在線程內(nèi)進(jìn)行，并通過(guò)信號(hào)量進(jìn)行通知。

像往常一樣，第一步是使用項(xiàng)目配置器創(chuàng)建一個(gè)新項(xiàng)目，這已在第4章和第8章中做過(guò)練習(xí)。首先，轉(zhuǎn)到“File → New → C/C++ Project”（文件 → 新建 → C/C++項(xiàng)目）。在所出現(xiàn)窗口的側(cè)邊欄中選擇Renesas RA，并突出顯示“Renesas RA C/C++ Project”（瑞薩RA C/C++項(xiàng)目）條目。單擊“Next”（下一步）并在出現(xiàn)的屏幕上輸入項(xiàng)目名稱(chēng)，例如MyRtosProject。再次單擊“Next”（下一步）。此操作將轉(zhuǎn)到“Device and Tools Selection”（器件和工具選擇）窗口。首先，選擇一個(gè)電路板。選擇EK-RA6M4并將相應(yīng)的器件設(shè)置為R7FA6M4AF3CFB（如果尚未列出）。查看工具鏈：它應(yīng)顯示為GCC Arm Embedded。單擊“Next”（下一步）繼續(xù)操作。

在當(dāng)前出現(xiàn)的屏幕中，可以在非TrustZone與安全和非安全TrustZone項(xiàng)目之間進(jìn)行選擇。保持“Flat（NonTrustZone）Project”（扁平化（非TrustZone）項(xiàng)目）處于選中狀態(tài)，然后單擊“Next”（下一步）。隨即出現(xiàn)“Build Artifact andRTOSSelection”（構(gòu)建工件和RTOS選擇）窗口。保持設(shè)置不變，即在“Build Artifact Selection”（構(gòu)建工件選擇）下選擇“Executable”（可執(zhí)行文件），在“RTOS Selection”（RTOS選擇）下選擇FreeRTOS。單擊“Next”（下一步），轉(zhuǎn)到下一個(gè)名為“Project Template Selection”（項(xiàng)目模板選擇）的屏幕。在此，選擇“FreeRTOS – Minimal – Static Allocation”（FreeRTOS – 最小化 – 靜態(tài)分配）。

最后，單擊“Finish”（完成），在配置器生成項(xiàng)目后，e² studio將詢問(wèn)您是否切換到“FSP Configuration”（FSP配置）透視圖。透視圖出現(xiàn)后，直接轉(zhuǎn)到“Stacks”（堆）選項(xiàng)卡。該選項(xiàng)卡將在“Threads”（線程）窗格中顯示“HAL/Common”（HAL/通用）線程的單個(gè)條目，其中包含I/O端口的驅(qū)動(dòng)程序。單擊窗格頂部的“New Thread”（新線程）圖標(biāo)（請(qǐng)參見(jiàn)圖9-1添加新線程）。

現(xiàn)在，在“Properties”（屬性）視圖中更改新線程的屬性：將“Symbol”（符號(hào)）重命名為led_thread，將“Name”（名稱(chēng)）重命名為LED Thread。其他屬性保持默認(rèn)值。在“LED Thread Stack”（LED線程堆）窗格中，單擊“New Stack”（新線程）按鈕圖標(biāo)，選擇“Driver → Input → External IRQ Driver on r_icu”（驅(qū)動(dòng)程序 → 輸入 → r_icu 上的外部IRQ驅(qū)動(dòng)程序）（請(qǐng)參見(jiàn)圖9-2）。

為中斷分配優(yōu)先級(jí)12，啟動(dòng)期間FSP將不會(huì)允許該中斷。也可以選擇任何其他優(yōu)先級(jí)，但開(kāi)始時(shí)最好選擇優(yōu)先級(jí)12，因?yàn)榧词乖谳^大的系統(tǒng)中，也很少會(huì)遇到中斷優(yōu)先級(jí)沖突。請(qǐng)注意，優(yōu)先級(jí)15是為系統(tǒng)時(shí)鐘節(jié)拍定時(shí)器（systick）保留的，因此不應(yīng)被其他中斷使用。

將“Trigger”（觸發(fā)器）從“Rising”（上升）更改為“Falling”（下降）以捕捉按鈕激活操作，并將“Digital Filtering”（數(shù)字濾波）從“Disabled”（禁用）更改為“Enabled”（啟用）。始終將“Digital Filtering Sample Clock”（數(shù)字濾波采樣時(shí)鐘）設(shè)置為PCLK/64。這將有助于對(duì)按鈕去抖。最后，用external_irq10_callback替換Callback行中的NULL。每次按下S1都會(huì)調(diào)用此函數(shù)。在稍后創(chuàng)建應(yīng)用程序時(shí)，我們將為回調(diào)函數(shù)本身添加代碼。圖9-4給出了必要設(shè)置的摘要。

接下來(lái)，只需要執(zhí)行幾個(gè)步驟，即可編譯和下載程序。