domain - 2025.2 简体中文 - UG1400

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 简体中文

创建、配置、列出和报告域。

表 1. domain - 创建、配置、列出和报告域
XSCT 方法 实参 对应 Python API 实参 注释
domain create

-name <domain-name> 域的名称。

-display-name <display_name> 域的报告中显示的名称。

-desc <description> 有关该域的简要描述。

-proc <processor> 将用于创建域的处理器核。对于 SMP Linux,此处可显示处理器核的 Tcl 列表。

-arch <processor architecture> 32 位或 64 位。该选项仅对 A53 处理器有效。

-os <os> 操作系统类型。默认类型为独立 (standalone)。

platform.add_domain

必需实参:

cpu = <cpu_core> 将用于创建域的处理器核。对于 SMP Linux,此处可显示处理器核的列表

 
domain create (cont'd)

-support-app <app-name> 创建一个域,其中所含 BSP 设置全部是使用 <app-name> 指定的应用所需的设置。该选项仅适用于独立域。“repo -apps”命令可用于列出可用应用的列表。

-auto-generate-linux 自动生成 Linux 工件。

-sd-dir <location> 对于采用 Linux 作为操作系统的域,创建 PetaLinux 工程时,请使用该目录中预构建的 Linux 镜像。该选项仅适用于 Linux 域。

-sysroot <sysroot-dir> 将此 Linux sysroot 目录添加到平台中。此 sysroot 目录会在构建应用期间使用。

 

可选实参:

os = <os> 操作系统类型。默认操作系统设为独立 (standalone)。

name = <domain_name> 要添加的域的名称。

display_name = <display_name> 域的显示名称

support_app = ["app1",..]**创建一个域,其中所含 BSP 设置全部是使用 <app-name> 指定的应用所需的设置。该选项仅适用于独立域。

sd_dir = <location> 对于采用 Linux 作为操作系统的域,创建 PetaLinux 工程时,请使用该目录中预构建的 Linux 镜像。该选项仅适用于 Linux 域。

 
domain active domain-name platform.get_domain

必需实参:

name = <domain_name> 域的名称

Get 命令会返回可用于运行域命令的域对象。
domain config

-display-name <display name> 域的显示名称。

-desc <description> 有关该域的简要描述。

-sd-dir <location> 对于采用 Linux 作为操作系统的域,创建 PetaLinux 工程时,请使用该目录中预构建的 Linux 镜像。该选项仅适用于 Linux 域。

-generate-bif 为该域生成标准 BIF。域报告会显示生成的 BIF 的位置。该选项仅适用于 Linux 域。

-sw-repo <repositories-list> 存储库列表,此列表中的存储器用于在生成该域时提取软件组件,如驱动程序和库。存储库列表需为软件存储库路径的 Tcl 列表。

-mss <mss-file> 使用 <mss-file> 指定的 mss,代替为域生成 mss 文件。

-readme <file-name> 通过启动指令等为域添加 README 自述文件。

  1. update_name
  2. add_custom_dtb
  3. set_sd_dir
  4. add_boot_di
  5. add_bif
  6. add_qemu_args
  7. add_qemu_data
必需实参:
  1. name = <new_name> 域的新显示名称
  2. path = <dtb_file> 定制 DTB 文件的路径。
  3. path = <path> 预构建的 Linux 镜像目录的路径
  4. boot_dir = <boot_dir> 要添加的启动目录
  5. path = <file_path> 要添加的 Bif 文件
  6. qemu_option = <"PS"/"PMC"/"PMU"> 有效的 qemu 选项为 "PS"、"PMC" 或 "PMU"。

    file_name

    = <file_name> 此文件中会列出所有 pmu/pmc/ps qemu 实参。
  7. data_dir = <data_dir> 此目录包含 qemu-args 中提供的所有文件
 
domain config (cont'd)

-inc-path <include-path> 额外的 include 路径,构建为该域创建的应用时,需添加此路径。

-lib-path <library-path> 额外的库搜索路径,在为该域创建的应用的连接器设置中需添加此路径。

-sysroot <sysroot-dir> 需将此 Linux sysroot 目录添加到平台中。此 sysroot 目录会在构建应用期间使用。

-boot <boot-dir> 此目录用于在构建 Linux 镜像后生成组件。

-bif <file-name> 此 bif 文件用于为 Linux 启动创建启动镜像。

-qemu-args <file-name> 此文件中会列出所有 PS QEMU 实参。此文件用于启动 PS QEMU。

-pmuqemu-args <file-name> 此文件中会列出所有 PMC QEMU 实参。此文件用于启动 PMU QEMU。

-pmcqemu-args <file-name> 此文件中会列出所有 pmcqemu 实参。此文件用于启动 pmcqemu。

-qemu-data <data-dir> 此目录包含在 qemu-args 和 pmuqemu-args 选项中提供的文件名中列出的所有文件。

     
list   platform.list_domain    
report domain-name domain.report 必需实参:

name = <domain_name> 要删除的域的名称

 
remove domain-name