芯片解決方案配置規則

• 芯片解決方案是指基于某款開發板的完整解決方案，包含驅動、設備側接口適配、開發板sdk等。
• 芯片解決方案是一個特殊的部件，源碼路徑規則為：device/{開發板}/{芯片解決方案廠商} 。
• 芯片解決方案部件會隨產品選擇的開發板默認編譯。
• 芯片解決方案目錄樹規則如下：
• 開發前請熟悉鴻蒙開發指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

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

注意 ：config.gni為開發板編譯相關的配置，編譯時會采用該配置文件中的參數編譯所有OS部件，編譯階段系統全局可見。

• config.gni的關鍵字段介紹如下：

kernel_type:            開發板使用的內核類型，例如：“liteos_a”, “liteos_m”, “linux”。
  kernel_version:         開發使用的內核版本，例如：“4.19”。
  board_cpu:              開發板CPU類型，例如：“cortex-a7”, “riscv32”。
  board_arch:             開發芯片arch, 例如： “armv7-a”, “rv32imac”。
  board_toolchain:        開發板自定義的編譯工具鏈名稱，例如：“gcc-arm-none-eabi”。若為空，則使用默認為ohos-clang。
  board_toolchain_prefix：編譯工具鏈前綴，例如：“gcc-arm-none-eabi”。
  board_toolchain_type：  編譯工具鏈類型，目前支持gcc和clang。例如：“gcc” ，“clang”。
  board_cflags：          開發板配置的c文件編譯選項。
  board_cxx_flags：       開發板配置的cpp文件編譯選項。
  board_ld_flags：        開發板配置的鏈接選項。

新增并編譯芯片解決方案

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

1. 創建芯片解決方案目錄。 按照芯片解決方案配置規則創建目錄，以芯片廠商realtek的“rtl8720“開發板為例, 在代碼根目錄執行：

   mkdir -p device/board/realtek/rtl8720
   

2. 創建內核適配目錄，并編寫開發板編譯配置config.gni文件。 以realtek的“rtl8720“開發板的liteos_a適配為例，device/board/realtek/rtl8720/liteos_a/config.gni的內容如下：

   # 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. 編寫編譯腳本。 在開發板目錄下創建BUILD.gn，target名稱應與開發板名稱一致。以realtek的rtl8720開發板為例，device/board/realtek/rtl8720/BUILD.gn內容可以是：

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

2. 編譯芯片解決方案。 在開發板目錄下執行hb build，即可啟動芯片解決方案的編譯。

審核編輯 黃宇