芯片解決方案配置規(guī)則

• 芯片解決方案是指基于某款開(kāi)發(fā)板的完整解決方案，包含驅(qū)動(dòng)、設(shè)備側(cè)接口適配、開(kāi)發(fā)板sdk等。
• 芯片解決方案是一個(gè)特殊的部件，源碼路徑規(guī)則為：device/{開(kāi)發(fā)板}/{芯片解決方案廠商} 。
• 芯片解決方案部件會(huì)隨產(chǎn)品選擇的開(kāi)發(fā)板默認(rèn)編譯。
• 芯片解決方案目錄樹(shù)規(guī)則如下：
• 開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

device                                      
  └── board                                   
      └── company                            # 芯片解決方案廠商
           └──  hispark_aries                # 開(kāi)發(fā)板名稱(chēng)
                 ├── BUILD.gn                # 編譯腳本
                 ├── hals                    # OS南向接口適配
                 ├── linux                   # 可選，linux內(nèi)核版本
                 │   └── config.gni          # linux版本編譯配置
                 └── liteos_a                # 可選，liteos內(nèi)核版本
                     └── config.gni          # liteos_a版本編譯配置

注意 ：config.gni為開(kāi)發(fā)板編譯相關(guān)的配置，編譯時(shí)會(huì)采用該配置文件中的參數(shù)編譯所有OS部件，編譯階段系統(tǒng)全局可見(jiàn)。

• config.gni的關(guān)鍵字段介紹如下：

kernel_type:            開(kāi)發(fā)板使用的內(nèi)核類(lèi)型，例如：“l(fā)iteos_a”, “l(fā)iteos_m”, “l(fā)inux”。
  kernel_version:         開(kāi)發(fā)使用的內(nèi)核版本，例如：“4.19”。
  board_cpu:              開(kāi)發(fā)板CPU類(lèi)型，例如：“cortex-a7”, “riscv32”。
  board_arch:             開(kāi)發(fā)芯片arch, 例如： “armv7-a”, “rv32imac”。
  board_toolchain:        開(kāi)發(fā)板自定義的編譯工具鏈名稱(chēng)，例如：“gcc-arm-none-eabi”。若為空，則使用默認(rèn)為ohos-clang。
  board_toolchain_prefix：編譯工具鏈前綴，例如：“gcc-arm-none-eabi”。
  board_toolchain_type：  編譯工具鏈類(lèi)型，目前支持gcc和clang。例如：“gcc” ，“clang”。
  board_cflags：          開(kāi)發(fā)板配置的c文件編譯選項(xiàng)。
  board_cxx_flags：       開(kāi)發(fā)板配置的cpp文件編譯選項(xiàng)。
  board_ld_flags：        開(kāi)發(fā)板配置的鏈接選項(xiàng)。

新增并編譯芯片解決方案

編譯構(gòu)建支持添加新的芯片解決方案廠商，具體步驟如下：

1. 創(chuàng)建芯片解決方案目錄。 按照芯片解決方案配置規(guī)則創(chuàng)建目錄，以芯片廠商realtek的“rtl8720“開(kāi)發(fā)板為例, 在代碼根目錄執(zhí)行：

   mkdir -p device/board/realtek/rtl8720
   

2. 創(chuàng)建內(nèi)核適配目錄，并編寫(xiě)開(kāi)發(fā)板編譯配置config.gni文件。 以realtek的“rtl8720“開(kāi)發(fā)板的liteos_a適配為例，device/board/realtek/rtl8720/liteos_a/config.gni的內(nèi)容如下：

   # Kernel type, e.g. "linux", "liteos_a", "liteos_m".
   kernel_type = "liteos_a"
   
   # Kernel version.
   kernel_version = "3.0.0"
   
   # Board CPU type, e.g. "cortex-a7", "riscv32".
   board_cpu = "real-m300"
   
   # Board arch, e.g. "armv7-a", "rv32imac".
   board_arch = ""
   
   # Toolchain name used for system compiling.
   # E.g. gcc-arm-none-eabi, arm-linux-harmonyeabi-gcc, ohos-clang, riscv32-unknown-elf.
   # Note: The default toolchain is "ohos-clang". It's not mandatory if you use the default toochain.
   board_toolchain = "gcc-arm-none-eabi"
   
   # The toolchain path instatlled, it's not mandatory if you have added toolchian path to your ~/.bashrc.
   board_toolchain_path =
       rebase_path("http://prebuilts/gcc/linux-x86/arm/gcc-arm-none-eabi/bin",
                   root_build_dir)
   
   # Compiler prefix.
   board_toolchain_prefix = "gcc-arm-none-eabi-"
   
   # Compiler type, "gcc" or "clang".
   board_toolchain_type = "gcc"
   
   # Board related common compile flags.
   board_cflags = []
   board_cxx_flags = []
   board_ld_flags = []
   
   `HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
   

1. 編寫(xiě)編譯腳本。 在開(kāi)發(fā)板目錄下創(chuàng)建BUILD.gn，target名稱(chēng)應(yīng)與開(kāi)發(fā)板名稱(chēng)一致。以realtek的rtl8720開(kāi)發(fā)板為例，device/board/realtek/rtl8720/BUILD.gn內(nèi)容可以是：

   group("rtl8720") { # target類(lèi)型也可以shared_library, static_library, executable
     # 具體內(nèi)容
     ......
   }
   

2. 編譯芯片解決方案。 在開(kāi)發(fā)板目錄下執(zhí)行hb build，即可啟動(dòng)芯片解決方案的編譯。

審核編輯 黃宇