设备建模语言(DML)是一种领域特定语言,用于为虚拟平台编写快速的功能级或事务级设备模型。DML 提供了适用于功能设备模型的高层抽象,包括寄存器组、寄存器、位域、事件发布、模型间接口和日志记录等构造。DML 代码由 DML 编译器(DMLC)编译,生成带有针对特定模拟器定制 API 调用的 C 代码。
目前,该编译器支持为 Intel® Simics® 模拟器构建模型,但未来可能会添加其他后端。
要构建 DMLC,你需要安装 Simics 模拟器并设置好 Simics 项目。
如果你尚未安装 Simics 模拟器,或无法通过商业渠道访问 Simics 模拟器,请安装 Intel Simics 模拟器的公开发行版 并创建一个 Simics 项目(在默认安装流程中会自动完成)。
你的 Simics 项目必须设置为使用主机 Python(通过向 project-setup 传递 --python),并且其 requirements.txt 文件中不得固定 ply==3.4。
在该项目中,将 DML 仓库检出到 modules/dmlc 目录。然后配置 CMake*(参见 Using CMake with the Intel Simics Simulator),传递 -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin 以确保你通过 CMake 构建的设备使用本地 DMLC。之后,可以通过 cmake --build bt --target dmlc 构建 DMLC。
要运行 DMLC 提供的单元测试,请在项目的顶层目录运行
bin/test-runner --suite modules/dmlc/test。
以下环境变量在开发 DMLC 时非常有用。如果你经常使用本地构建的 DMLC,可以考虑在 .bashrc 中设置变量 DMLC_DIR、T126_JOBS、DMLC_PATHSUBST 和 PY_SYMLINKS。其余变量最好仅在需要时启用。
构建 DMLC 后,你需要在后续调用 make 时将 DMLC_DIR 设置为 <your-project>/<hosttype>/bin,以便使用本地构建的编译器构建设备。<hosttype> 根据你的主机类型为 linux64 或 win64。
设置后,将并行运行指定数量的测试。
DMLC 构建会将一些 DML 库文件(例如 dml-builtins.dml)复制到 <hosttype>/bin。当发生编译错误时,错误消息通常会指向此副本而非源文件。通过将 DMLC_PATHSUBST 设置为 <hosttype>/bin/dml=modules/dmlc/lib,错误消息将被重写为指向源文件。<hosttype> 根据你的主机类型为 linux64 或 win64。
当设置为 1 时,make dmlc 将创建 Python 文件的符号链接而不是复制它们。这有两个效果:Python 回溯将带你到仓库中的源文件,并且编辑 Python 文件后无需重新运行 make。
当设置为 1 时,编译器中的意外异常将回显到 stderr。默认情况下,回溯信息会隐藏到文件 dmlc-error.log 中。
在单元测试中覆盖默认编译器。
设置后,DMLC 会进行自我分析并将分析结果写入 .prof 文件。
设置后,DMLC 会生成一个 .tar.bz2 归档文件,其中包含所有 DML 源文件,并以可独立编译的形式打包。当 DML 问题出现在复杂的构建环境中,而你想在隔离环境中复现该问题时,这非常有用。在创建的归档文件中,所有 DML 文件都位于同一目录下(要么在顶层,要么位于一系列名为 _ 的子目录下),并且相对导入通过同时在归档中包含符号链接来处理。在 Windows 上,DMLC 有时无法正确解析这些符号链接;因此,建议仅在 Linux 上解压并编译该归档文件。
设置后,DMLC 会输出一个以 -size-stats.json 结尾的文件,其中显示有助于减少生成代码大小并提高编译速度的代码生成统计信息。该文件列出了为每个 DML 方法生成了多少 C 代码。输出是一个三元组列表 [tot_size, location, num],其中 tot_size 是从一个方法声明生成的 C 代码的总字节数,num 是从该声明生成 C 代码的次数(因为它被模板展开),而 location 是该声明的源代码位置。
tot_size 很大且 num 也很大的条目可以通过将该方法声明为 shared 来减少;这大致会将大小除以 num。tot_size 很大但 num 等于 1 的条目通常意味着该方法主要由 #foreach 或 #select 之类的结构占据,可以通过将循环体拆分到单独的方法中,或以其他方式将循环改写为 foreach 之类的其他结构来减少。
请注意,统计信息仅包含直接从方法声明生成的代码;总代码大小包含的内容要多得多。来自方法声明的一兆字节代码大小通常会导致几秒钟的编译时间。