03-create-hdl-files

aiv new:创建 HDL 文件创建文件AIV工具会自动根据创建HDL文件的后缀名找到对应的模版并把模版中的变量进行替换生成目标文件。aiv new rtl\control.svaiv new rtl\legacy.v aiv new include\types.svh当前内置模板覆盖.v、.sv、.vh和.svh。AIV 优先从目标文件所在目录向上查找最近的.aiv/templates/最后才使用内置模板。模板选择规则为查找default.目标后缀.j2如果没有默认模板但当前目录只有一个匹配*.目标后缀.j2的模板则使用它多个模板同时匹配时要求显式指定--template无后缀文件必须显式指定模板。显式指定模板aiv new generated\wrapper.any--template.\.aiv\templates\wrapper.j2--template会绕过目标后缀选择。相对路径会从当前目录、目标文件目录和可用模板目录中查找。自定义扩展名把模板保存为.aiv/templates/default.svi.j2之后即可执行aiv new rtl\bus_if.sviAIV 没有硬编码自定义后缀白名单是否可创建由匹配模板决定。模板变量当前模板渲染器支持以下标量变量变量来源year当前年份date当前时间格式由generation.date_format控制filename目标文件名module_name从文件名和命名配置推导authoruser.authoremailuser.emailcompanyuser.company未配置的作者、邮箱或公司会渲染为undefined。模板还支持{% include 文件名 %}形式的本地包含但不应假设支持完整 Jinja2 表达式、循环或条件语法。模块名规则AIV 用文件主名生成模块名非标识符字符转换为_连续_合并数字开头时添加naming.module_prefix默认M_naming.module_case可设为preserve、upper或lower。例如aivsetmodule_case upper aiv new rtl\axi-control.sv生成的模块名为AXI_CONTROL。