MLD 关键字 - 2023.2 简体中文

MLD 文件中使用的关键字如下所述：

BEGIN

BEGIN 关键字表示以下任一操作开始：os、library、driver、block、category、interface 和 array。

END

END 关键字表示定义块结束。

PSF_VERSION

指定库的 PSF 版本。

DRC

指定 DRC 函数名称。这是全局 DRC 函数，由 Vitis IDE 配置工具或命令行工具来调用。当您输入所有参数，并且 MLD 或 MDD 写程序可验证使用给定参数可以生成有效的操作系统、库或驱动程序时，就会调用一次该 DRC 函数。

选项

指定紧接在 option 关键字之后的名称是一个 Vitis IDE 工具的选项。

OS

指定操作系统类型。如不指定，则假定操作系统为独立类型的操作系统。

COPYFILES

指定要为操作系统、库或驱动程序复制的文件。如果使用 ALL，那么该工具会复制所有操作系统、库或驱动程序文件。

DEPENDS

指定在构建操作系统或库之前需要编译的目录列表。

SUPPORTED_PERIPHERALS

指定操作系统支持的外设列表。该选项的值可以指定为列表或者正则表达式。例如：

option supported_peripherals = (microblaze)

指示操作系统支持所有版本的 MicroBlaze。可使用正则表达式来指定外设和版本。正则表达式 (RE) 构造如下：

• 单字符 RE：
  • 与自身匹配的任意字符，不得使用特殊字符（待定义）。
  • 反斜杠（后接任意特殊字符）即表示与文字字符本身相匹配。即，对特殊字符进行“转义”。
  • 特殊字符包括：+ * ? 。[ ] ^ $
  • 句点 (.) 与除换行外的任意字符相匹配。例如，.umpty 与 Humpty 和 Dumpty 均匹配。
  • 一组以括号 ([]) 括起的字符表示一个单字符 RE，与该组合中的任意字符相匹配。例如，[akm] 与单个“a”、“k”或“m”相匹配。
  • 可使用短划线来表示字符范围。例如，[a-z] 与任意小写字母相匹配。但如果字符集的第一个字符为插入符号 (^)，则表示 RE 与除该字符集内的字符之外的任意字符相匹配。它与空字符串不匹配。例如：[^akm] 与除“a”、“k”或“m”之外的任意字符相匹配。如果插入符号并非字符集的首个字符，则会丢失其特殊意义。
• 多字符 RE：
  • 单字符 RE 后接星号 (*) 表示与此 RE 出现 0（零）次或多次相匹配。因此，[a-z]* 与无小写字母或多个小写字符相匹配。
  • 单字符 RE 后接星号 (+) 表示与此 RE 出现 1 次或多次相匹配。因此，[a-z]+ 与 1 个小写字母或多个小写字符相匹配。
  • 问号 (?) 表示可选元素。在字符串中，前置 RE 最多只可能出现零次或一次。因此，xy?z 匹配 xyz 或 xz。
  • RE 并置表示 RE 与字符串的对应并置相匹配。例如，[A-Z][a-z]* 与任意大写词相匹配。
  • 例如，以下 RE 与 axidma 版本相匹配：

    option supported_peripherals = (axi_dma_v[3-9]_[0-9][0-9]_[a-z]
    axi_dma_v[3-9]_[0-9]);

LIBRARY_STATE

指定库的状态。以下是可分配给 LIBRARY_STATE 的值列表：

ACTIVE

处于活动状态的库。默认情况下，LIBRARY_STATE 的值为 ACTIVE。

DEPRECATED

该库已不推荐使用

OBSOLETE

该库已弃用，任何工具都无法识别该库。工具在已弃用的库上输出错误，应改用新的库。

APP_COMPILER_FLAGS

该选项指定使用此库时，必须添加到应用的编译器标志。例如：

option APP_COMPILER_FLAGS = “-D MYLIBRARY”

Vitis IDE 工具可以使用该选项值来为应用自动设置编译器标志。

APP_LINKER_FLAGS

该选项指定使用特定库或操作系统时，必须添加到应用的连接器标志。例如：

option APP_LINKER_FLAGS = “-lxilkernel”

Vitis IDE 工具可以使用该值来为应用自动设置连接器标志。

BSP

指定在 MLD 文件中可提供的布尔值关键字选项，用于识别何时将操作系统组件作为第三方 BSP 来处理。例如：

option BSP = true;

这表示 Vitis 工具将把该操作系统组件作为板级支持包来提供。如果设为 false，那么该组件将作为本机嵌入式软件平台来处理。

OS_STATE