本章介紹基礎(chǔ)的SDK編譯，打包等操作，方便快速上手 SDK 開發(fā)。

SDK 基礎(chǔ)知識

R128 平臺擁有三個核心，Cortex M33 核心作為啟動和安全核心，XuanTie C906 核心作為應(yīng)用核運行用戶 APP，HIFI5 作為算法核運行DSP算法。由于架構(gòu)不同，不同的核心需要運行不同的 RTOS。

其中 Cortex M33 和 C906 運行的是 FreeRTOS V10.4.3 同一個內(nèi)核支持兩個不同架構(gòu)的核心，其外設(shè)、組件、驅(qū)動是相同的。特性如下：

• 支持 Cortex-M33（Armv8-M）、C906（Riscv-64） 架構(gòu)
• FreeRTOS V10.4.3 內(nèi)核
• 支持標(biāo)準(zhǔn) posix 接口
• 支持系統(tǒng)接口，用于內(nèi)核以外的模塊調(diào)用內(nèi)核函數(shù)的接口
• 支持文件系統(tǒng)，包含設(shè)備管理器、分區(qū)管理器、文件系統(tǒng)實體管理器等，例如 littlefs、fat 等，實現(xiàn)對不同設(shè)備類型、分區(qū)類型、文件系統(tǒng)類型的集成
• 支持 newlibc 庫

而 HIFI5 運行的是 Cadence 所推薦的 FreeRTOS V10.2.0 內(nèi)核，其部分組件與 M33/C906 核心不同。特性如下：

• 支持 Xtensa HIFI5 架構(gòu)
• FreeRTOS V10.2.0 內(nèi)核
• 支持系統(tǒng)接口，用于內(nèi)核以外的模塊調(diào)用內(nèi)核函數(shù)的接口
• 支持 VFPU/NN 算法庫

所以在開發(fā)過程中，M33/C906 使用的是一套 FreeRTOS SDK，HIFI5 使用的是另外的一套 FreeRTOS SDK。這里將介紹 M33/C906 的開發(fā)入門，HIFI5的相關(guān)開發(fā)將在 DSP 章節(jié)介紹。

• 異構(gòu)計算相關(guān)在

SDK 目錄架構(gòu)

下表是簡化版本的 SDK 目錄結(jié)構(gòu)，具體的說明在 【SDK入門 - SDK 架構(gòu)與目錄結(jié)構(gòu)】中說明。

├── board               # 板級配置目錄
│   ├── common          # 公共板級配置目錄
│   │   ├── configs     # 公共板級配置
│   │   └── data        # 公共數(shù)據(jù)
│   └── r128s2          # R128 S2 芯片配置目錄
│       └── module      # R128 S2 Module 模塊板級配置目錄
├── lichee              # 系統(tǒng)源碼目錄
│   ├── brandy-2.0      # 啟動相關(guān)目錄
│   ├── dsp             # HIFI5 FreeRTOS 系統(tǒng)、組件、應(yīng)用
│   ├── rtos            # M33/C906 FreeRTOS 系統(tǒng)、組件、應(yīng)用
│   ├── rtos-components # 公共應(yīng)用組件，libc、多媒體、lvgl等
│   └── rtos-hal        # RTOS HAL驅(qū)動
├── out                 # 打包輸出的臨時文件與最終鏡像文件
└── tools               # 用于存放打包相關(guān)的腳本、工具

初始化SDK環(huán)境

在編譯之前，需要初始化 SDK 的環(huán)境，使用下列命令初始化環(huán)境。

source envsetup.sh

載入項目方案

使用下列命令載入方案

lunch_rtos

這里我們需要開發(fā)的是 r128s2_module_c906 方案，對應(yīng)的是 R128 模塊的最小化系統(tǒng)開發(fā)板的 C906 核心的 RTOS。輸入 1 回車即可。

第一次載入方案會解壓工具鏈，解壓完成后會提示方案載入成功：

第二次開始就會跳過解壓工具鏈，并且會記錄上一次選擇的方案。

更換項目方案

在開發(fā)過程中如果需要開發(fā) M33 核心方案，需要重新執(zhí)行 lunch_rtos 選擇 M33 方案。

配置 RTOS 基本設(shè)置與軟件包配置

SDK 提供了 mrtos_menuconfig 命令來配置基本SDK配置與軟件包。相關(guān)文檔位于 [RTOS軟件包配置]。下圖為進入的配置界面。

編譯系統(tǒng)

可以使用 m 命令或者 mrtos 命令編譯RTOS系統(tǒng)。

打包系統(tǒng)

使用 p 或者 pack 命令打包系統(tǒng)

注意，打包如果出現(xiàn)

err: failed to open bin file rtos_xxx.fex
Generate image file failed
ERROR: mkimage run error

則是因為系統(tǒng)配置勾選啟用了這個核心但是實際沒有編譯這個核心的 RTOS 系統(tǒng)，導(dǎo)致找不到這個核心的 RTOS 的固件。這時候需要編譯完成 RTOS 系統(tǒng)然后重新打包。例如報錯 err: failed to open bin file rtos_arm.fex

則需要編譯對應(yīng)的 arm 核心的固件，在這里是 m33 核心。lunch_rtos 選擇 M33 核心，然后 m 編譯。

此時 pack 就可以通過了

擴展命令

了解上面的命令即可開始開發(fā) RTOS ，不過 SDK 還提供了一些其他命令簡化使用。

一鍵編譯 + 打包

SDK 提供了 mp 命令以供一鍵編譯 + 打包方案。

編譯 U-boot

可以使用 muboot 命令編譯 u-boot

編譯完成后會自動拷貝生成的鏡像到指定位置等待打包

編譯 boot0

可以使用 mboot0 編譯 boot0，編譯完成后會自動拷貝生成的鏡像到指定位置等待打包

編譯 U-boot + boot0

可以使用 mboot 命令編譯 U-boot + boot0

編譯完成后會自動拷貝生成的鏡像到指定位置等待打包

文件夾跳轉(zhuǎn)快捷命令

- croot:        Jump to the top of the tree.
- cboot:        Jump to uboot.
- cboot0:       Jump to boot0.
- cbin:         Jump to uboot/boot0 bin directory.
- cconfigs:     Jump to configs of target.
- cout:         Jump to out directory of target.
- cdsp:         Jump to dsp.
- chal:         Jump to rtos-hal.
- ccomponents:  Jump to rtos-components.
- cbuild:       Jump to rtos build dir.
- cprojects:    Jump to rtos projects dir.

審核編輯：湯梓紅