AWorksLP是采用面向框架的設計架構、支持組件平臺板卡“可插拔、可替換、可配置”，應用代碼可跨平臺復用的嵌入式實時操作系統。MR6450搭載AWorksLP將能發揮出最大的優勢。

?簡介

AWorksLP是一套完備的嵌入式實時操作系統，采用面向框架的設計架構，支持平臺組件“可插拔、可替換、可配置”、與硬件無關、與操作系統種類無關的方式設計，用戶只需修改相應的頭文件，即可實現應用代碼的跨平臺復用。他不僅僅包含實時內核（RTOS），還包含設備管理框架、豐富的網絡協議棧、大量高質量的組件，以及一整套構建、管理、運維系統。AWorksLPSDK的目錄結構及使用方式在不同平臺下完全一致（與硬件無關），本文將以MR6450平臺軟件為例，對AWorksLP SDK的開發使用進行簡單介紹。

?開發環境

Eclipse是一個開放源代碼、基于Java 的可擴展開發平臺，同時它也是著名的、跨平臺的自由集成開發環境。為避免在安裝開發環境軟件時出現問題，我司提供綠色免安裝包（解壓即用，無需其它任何安裝過程），其包含了Eclipse 軟件、java運行環境及相關的插件，解壓后eclipse目錄，如圖1所示，并約定{IDE}為該目錄路徑。

圖1 Eclipse開發環境軟件包

* RISC-V平臺與ARM平臺所使用Eclipse軟件版本不一致，下載使用時請注意區別版本；

* 該軟件包不能解壓到過深的路徑，否則會出現解壓失敗的問題。

eclipse:目錄下為綠色免安裝版本Eclipse軟件；

make: make工具包；

eclipse-aworks.bat:快速啟動腳本。

用戶需要使用時，僅需雙擊eclipse-aworks.bat腳本啟動Eclipse后，導入Eclipse工程即可進行編譯和調試。

2. AWorksLPSDK軟件包

SDK軟件包下載解壓后，其目錄結構如下圖所示，并約定以{SDK}指代該目錄。

圖2 SKD軟件目錄

components:組件，包含 Modbus、LUA、mbedtls 等組件；

demos:樣例目錄，包含外設、組件、應用樣例；

docs:文檔目錄；

frameworks:框架，包含 OS、IO、POSIX 等代碼；

packages:包目錄，包含編譯工具鏈以及編譯所需其他工具等;

platforms:平臺目錄，包含組件驅動，內置板卡等;

solution.json: Solution 詳細信息。

* SDK包需要拷貝并解壓到不含空格及英文括號目錄下，否則可能會在執行工程編譯時出現錯誤。

3. 調試軟件HPM平臺同時支持JLink以及OpenOCD兩種方式進行下載調試，因本文篇幅限制，僅介紹JLink方式，OpenOCD方式可參考《HPM平臺SDK快速入門手冊》進行設置。

3.1JLink添加芯片設備支持

JLink軟件位于{SDK}/platforms/platform-hpm-aworks-lp/tools/JLink目錄下，可直接雙擊軟件使用默認配置進行安裝即可，并約定{JLink}為Jlink軟件安裝路徑，若本地已存在大于V750a版本的JLink軟件，則可跳過軟件安裝步驟。

軟件安裝完成后，需增加HPM芯片設備支持，具體步驟如下：

3.1.1 拷貝{SDK}/platforms/platform-hpm-aworks-lp/tools/JLink/Hpmicro文件夾至{JLink}/Devices目錄下，如圖3所示：

圖3 拷貝Hpmicro燒寫算法

3.1.2 將{SDK}/platforms/platform-hpm-aworks-lp/tools/JLink/JLinkDevices.xml文件中芯片相關描述內容拷貝至{JLink}/JLinkDevices.xml中，具體見圖4。

圖4 添加HPM芯片信息

3.1.3 打開GDB Server軟件，型號選擇HPM6750XXXX，連接方式選擇JTAG，如圖5所示，使用Jlink連接上目標板，若如圖6所示，則表示正常連接。

圖5 GDBServer配置

圖6 GDBServer連接成功* RISCV平臺需JLink硬件調試器大于等于V11版本方能支持；
* 本節僅以HPM平臺為例進行說明，其他平臺請參考對應硬件環境配置說明文檔。

?SDK開發使用

本節將介紹如何使用AWorksLP SDK在Eclipse IDE上進行開發。

1.打開Eclipse并建立工作空間

首次使用Eclipse進行開發時，需要建立合適的工作空間。

打開{IDE}目錄，雙擊“startup_eclipse_riscv.bat”批處理腳本即可啟動Eclipse軟件，如圖7所示。

圖7 雙擊批處理啟動Eclipse軟件

如果第一次打開Eclipse 或者打開后沒有勾選默認工作空間，軟件會自動彈出默認工作空間界面，點擊【Browse】選擇Eclipse 的工作空間，用戶可自行決定路徑位置

* 工作空間路徑盡量不要有中文, 可以避免路徑識別問題。

如果不需要更改工作空間，勾選上圖中紅色框中的內容即可。然后點擊【OK】選項，如圖8所示。

圖8 建立工作空間

工作空間建立完成后，會進入Eclipse 界面，如圖9所示。

圖9 首次進入Eclipse顯示界面

根據圖9中的提示，點擊關閉【Welcome】，點擊后會自動打開左側的【Project explorer】選項框，如圖10所示。

圖10 Eclipse顯示界面

2.創建Eclipse工程

Eclipse工程在AWorksLP SDK中為使用時立即構建生成，即用時構建模式。在使用Eclipse進行開發前需構建應用工程，本文以GPIO例程為例進行舉例說明，其目錄為{SDK}/demos/peripheral/gpio，并約定使用{app}代指該目錄。

2.1 {app}目錄下文件結構如圖11所示。

圖11 gpio例程目錄

各目錄和文件簡介如下：

script:應用編譯腳本;

src:例程源碼;

axio.toml:存放axio編譯時需要的配置信息;

aworks_lp_platform-hpm-aworks-lp_xxxx.config:使用xxx板卡運行該例程時配置文件。

* aworks_lp_platform-hpm-aworks-lp_xxxx.config文件在不同的例程下可能存在多個，代表不同的板卡運行該例程時的配置，若無對應板卡的配置文件，可參照已有板卡進行配置，SDK中會保證所有例程都有我司標準開發板的工程配置。

2.2 進入{app}\script目錄下，該目錄存放例程編譯相關腳本，如圖12所示。

圖12 script目錄

各個腳本簡介如下：

• application_build.bat:編譯并生成工程；
• application_clean.bat:清除編譯中間文件；
• application_config.bat:調整應用配置。

若執行config腳本對應用配置后，需重新執行build腳本進行工程刷新。

2.3 使用管理員身份運行 application_build.bat腳本，會彈出CMD編譯窗口，如圖13所示，會要求選擇運行該例程的板卡，按照實際需求選擇即可，本文選擇EPC6450-AWI工控板。

圖13 板卡及編譯類型選擇

2.4 選擇完板卡后，會要求選擇默認優化等級，本文選擇debug優化等級，選擇完成后編譯界面如圖14所示。

圖14 編譯界面

2.5 編譯完成后，若提示界面如圖15所示（結果中包含綠色SUCCESS字樣），則表示工程生成成功。

圖15 編譯完成

2.6 腳本執行完畢后，輸入任意鍵即可退出CMD窗口，此時{app}路徑下生成project_eclipse目錄，該目錄下為生成的Eclipse工程，如圖16所示。

圖16 Eclipse工程

.axiodeps、.axioenvs為編譯時臨時文件目錄，使用時不需要關心；

如果需要生成多種配置項的工程，則可在步驟4中選擇“A. All buildsets”；

Build操作只有在例程首次執行時才會選擇板卡，重復編譯時會默認使用首次選擇的板卡；若要重新選擇板卡，可將{APP}/axio_board_set.bat刪除后重新編譯即可。

3.導入SDK工程

3.1 在Eclipse的【Project explorer】選項框中選擇“Import Project”后，彈出如圖17所示的界面，依次點擊“General”->“Existing Projects into Workspace”->“Next”；

圖17 彈出導入工程對話框

3.2將{app}\project_eclipse填入，并選擇需要導入的工程，然后點擊【Finish】即可完成工程導入，如圖18所示；

圖18 選擇待導入的工程

3.3導入成功后界面如圖19所示。

圖19導入工程

4.編譯SDK工程

4.1在Eclipse選中左側的工程，然后點擊【編譯】按鈕的下拉菜單，將顯示出當前工程支持的編譯方式，如圖20所示，點擊對應Label即可進行編譯。

圖20 編譯SDK工程

4.2點擊編譯按鈕后，工程執行編譯，如圖21所示，在【Console】窗口，可查看編譯LOG信息，在【Problems】窗口可以查看錯誤警告信息。

圖21 編譯進行中

4.3 工程編譯成功后如圖22所示，生成最終可執行文件。

圖22 編譯成功

4.4 同時在工程目錄下會生成與編譯選擇項名相同的目錄，在該目錄存放編譯臨時文件以及應用固件，如圖23所示。

圖23 編譯目錄

4.5 如果編譯成功后，若編譯目錄下不存在應用固件，則選中工程目錄，右鍵打開選項卡選擇刷新工程，如圖24所示。刷新完成后，即可看到對應文件。

圖24 刷新工程

5.在線調試

5.1調試配置

在工程中點擊【調試】按鈕的下拉菜單，菜單中有工程支持的所有調試選項，如圖25所示，調試列表中選項名帶jlink字樣的為Jlink專用調試項，其他的則為OpenOCD調試項。

圖25 查看調試的配置

若下拉列表為空，則是由于Eclipse 的工作空間未刷新導致，需重新打開工程，參照下面步驟操作即可：

• 選中工程后，打開右鍵選項卡，點擊【Close Project】關閉工程；
  
• 然后在雙擊工程即可重新打開，再次選擇上文中下拉菜單，即可看到SDK工程中已經加載調試配置選項。

* 調試配置選項是根據編譯時輸入的編譯信息生成的調試版本，可能是可選擇優化等級中的一種或多種。

5.2使用JLink調試

5.2.1 按照環境搭建章節所介紹內容，使用JLink連接目標板卡，連接完成后界面如圖26所示。

圖26 JLink調試軟件界面

5.2.2 點擊需要下載的調試選項即可下載編譯的固件到硬件中，如圖27所示，當前代碼運行位置為main函數。

圖27 JLink調試下載運行成功

至此，AWorksLP中SDK中的一個簡單Demo已經能正常運行起來了，更多的樣例及特性請關注后續推文解鎖。