> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 添加自定义机器配置

本文说明如何定义自定义机器配置并构建自定义镜像。

## **机器配置概念**

机器配置文件（`.conf`）描述目标硬件：SoC 系列、内核、引导加载程序、设备树和存储类型。选择机器会告知 BitBake 应用哪些硬件特定的设置。

机器配置文件位于 `meta-qcom/conf/machine/`。`include` 子目录包含共享的 `.inc` 文件，这些文件为每个 SoC 系列定义通用变量。有关受支持机器及其配置文件的完整列表，请参阅 [meta-qcom](./meta-qcom#machine-configurations)。

## **支持的 SoC 和开发套件**

有关机器配置与开发套件的映射关系，请参阅 [Qualcomm Linux 发行说明](https://dragonwingdocs.qualcomm.com/Key-Documents/Software-Release-Notes/introduction)第 4.2 节。有关支持的硬件 SoC，请参阅硬件 SoC [IQ-9075](https://docs.qualcomm.com/nav/home?product=1601111740076079) 和 [IQ-8275](https://docs.qualcomm.com/nav/home?product=1601111740085228)。

## **前提条件**

要下载 Qualcomm Yocto 和配套的 meta 层，请参阅[构建 BSP 镜像](https://dragonwingdocs.qualcomm.com/Key-Documents/Firmware-Guide/build-firmware#build-bsp-image)。

## **添加自定义机器配置并重新构建工作区**

要添加自定义机器配置并重新构建工作区，请执行以下操作：

1. 要添加机器，请在 `layers/meta-qcom/conf/machine/` 中添加新的机器配置文件；例如 `layers/meta-qcom/conf/machine/test-board.conf`。
2. 如果新机器使用 QCS6490 硬件片上系统（SoC），请在创建的文件中添加以下内容：
   ```text theme={null}
   #@TYPE: Machine
   #@NAME: TestBoard
   #@DESCRIPTION: Machine configuration for a development board, based on Qualcomm QCS6490
   require conf/machine/include/qcom-qcs6490.inc
   ```
   在 `meta-qcom/ci` 目录下为 `test-board` 配置文件添加 CI 文件。
3. 加载环境：
   ```text theme={null}
   kas shell meta-qcom/ci/test-board.yml:meta-qcom/ci/qcom-distro-sota.yml
   ```
4. 要为添加的机器构建镜像，请运行以下命令：
   ```text theme={null}
   bitbake qcom-multimedia-image
   ```