工程模板

使用工程模板有助于使用预定义设置设置新工程。 模板可能包含预定义的电路板边框,连接器位置,原理图元素,设计规则等。甚至可以包括用作新工程的种子文件的完整原理图和/或 PCB。

使用模板

文件→新工程→模板 菜单中的新工程将打开工程模板选择器对话框:

template selector

单击模板的图标将显示模板信息,再单击“确定”按钮将创建新工程。 模板文件将复制到新工程位置并重命名以反映新工程的名称。

选择模板后:

template selected

模板位置:

KiCad 在以下路径中查找模板文件:

  • 环境变量 KICAD_USER_TEMPLATE_DIR 中定义的路径

  • 环境变量 KICAD_TEMPLATE_DIR 中定义的路径

  • 系统模板:<kicad bin dir>/../share/kicad/template/

  • 用户模板:

    • Unix: ~/kicad/template/

    • Windows: C:\Documents and Settings\username\My Documents\kicad\template or C:\Users\username\Documents\kicad\template

    • Mac: ~/Documents/kicad/template/

创建模板

模板名称是存储模板文件的目录名称。 元数据目录是名为 meta 的子目录,其中包含描述模板的文件。

元数据由一个必需文件组成,可能包含可选文件。 所有文件必须由用户使用文本编辑器或以前的 KiCad 工程文件创建,并放入所需的目录结构中。

使用模板创建工程时,模板中的所有文件和目录都将复制到新的工程路径,但 meta 除外。包含模板名称的文件和目录将使用新的工程文件名重命名。

例如,从名为 示例 的模板创建名为 新工程 的工程:

模板 示例 目录中的文件。

在工程 新工程 目录中创建的文件

示例.kicad_pro
示例.kicad_sch
示例.kicad_pcb
示例-第一次.kicad_sch
第二次-示例.kicad_sch
第三次.kicad_sch
第三次.kicad_pcb

新工程.kicad_pro
新工程.kicad_sch
新工程.kicad_pcb
新工程-第一次.kicad_sch
第二次-新工程.kicad_sch
第三次.kicad_sch
第三次.kicad_pcb

模板不需要包含完整的工程,如果缺少所需的工程文件,KiCad 将使用其默认的创建工程行为创建该文件:

模板 示例 目录中的文件。

新工程 目录中创建的文件

示例.kicad_sch
第一次-示例.kicad_sch
第一次-示例.kicad_pcb
第二次-示例.kicad_sch
第二次-示例.kicad_pcb

新工程.kicad_sch
第一次-新工程.kicad_sch
第一次-新工程.kicad_pcb
第二次-新工程.kicad_sch
第二次-新工程.kicad_pcb
新工程.kicad_pro (默认)
新工程.kicad_pcb (默认)

作为模板名称重命名规则的例外,如果存在一个工程文件(.kicad_pro),并且其名称与模板名称不匹配,则 KiCad 将基于该工程文件名称进行重命名:

模板 示例 目录中的文件。

新工程 目录中创建的文件

示例.kicad_sch
示例.kicad_pcb
第一次-示例.kicad_pro
第一次-示例.kicad_sch
第一次-示例.kicad_pcb
第二次-示例.kicad_sch
第二次-示例.kicad_pcb

示例.kicad_sch
示例.kicad_pcb
新工程.kicad_pro
新工程.kicad_sch
新工程.kicad_pcb
第二次-示例.kicad_sch
第二次-示例.kicad_pcb

不建议创建包含多个工程文件的模板。

模板示例

这是一个显示 raspberrypi-gpio 模板的工程文件的示例:

template tree

和元数据文件:

template tree meta

所需文件:

meta/info.html

描述模板的 HTML 格式信息。

<title> 标记确定向用户公开以供选择模板的模板的实际名称。请注意,如果工程模板名称太长,它将被截断。

使用 HTML 意味着可以轻松地对图像进行内联,而无需发明新方案。 本文档中只能使用基本 HTML 标记。

这是一个示例 info.html 文件:

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  2. <HTML>
  3. <HEAD>
  4. <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html;
  5. charset=windows-1252">
  6. <TITLE>Raspberry Pi - 扩展板</TITLE>
  7. </HEAD>
  8. <BODY LANG="fr-FR" DIR="LTR">
  9. <P>这个工程模板是扩展板的基础
  10. <A HREF="http://www.raspberrypi.org/" TARGET="blank">Raspberry Pi $25
  11. ARM 板。</A> <BR><BR>该基础工程包括一个PCB边缘,
  12. 其尺寸与Raspberry-Pi PCB相同,
  13. 连接器正确放置以对齐两块板。Raspberry-Pi 板上的所有 IO 都通过
  14. 0.1&quot;连接到工程。扩展
  15. 头。 <BR><BR>板轮廓如下所示:
  16. </P>
  17. <P><IMG SRC="brd.png" NAME="brd" ALIGN=BOTTOM WIDTH=680 HEIGHT=378
  18. BORDER=0><BR><BR><BR><BR>
  19. </P>
  20. <P>(c)2012 Brian Sidebotham<BR>(c)2012 KiCad Developers</P>
  21. </BODY>
  22. </HTML>

可选文件:

meta/icon.png

一个 64 x 64 像素的 PNG 图标文件,用作 模板选择对话框中的可单击图标。

meta/info.html 使用的任何其他图像文件(例如上面对话框中的电路板文件图像)也会放在此文件夹中。