# Designing with PCB Templates

Our prefabricated PCB templates are a great way to streamline your circuit prototyping and easily integrate circuits with many popular microcontroller development boards.

<div><figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FlASaOJE5NwdgbRf1uBhG%2FIMG_1000-edit-web2.webp?alt=media&#x26;token=c993f4f3-b76d-4a97-afcd-6d65dd666789" alt=""><figcaption></figcaption></figure> <figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2F4w3yNo5jB4bqdnl2lotL%2FIMG_1040-edit-web2.webp?alt=media&#x26;token=ed91041b-a986-40c1-913c-e8fad6ec881e" alt=""><figcaption></figcaption></figure></div>

This page will outline the best practises and helpful tips you should know when designing circuits for the V-One utilising the prefabricated substrate and template PCB's. The design files for all of the substrates and templates we offer can be found through the link below and purchased from the [materials section of our store](https://store.voltera.io/collections/materials?page=1).&#x20;

{% embed url="<https://docs.voltera.io/v-one/downloads/substrates-and-templates>" %}

## Designing With Templates&#x20;

{% hint style="warning" %}
This guide provides a general outline on how to design gerber files to use with our various  PCB templates. Specific PCB design softwares may not work with the following file import procedure suggestions.
{% endhint %}

### Import Design Files

{% tabs %}
{% tab title="EAGLE Library" %}
The EAGLE library containing all symbol and footprint files for the templates can be found in the [**Substrates and Templates**](https://docs.voltera.io/v-one/downloads/substrates-and-templates) download page.

Many PCB design programs allow you to import EAGLE libraries and use them. There is also a free online EAGLE library converter called [SnapEDA ](https://www.snapeda.com/home/)that can convert the EAGLE library into many different PCB design softwares native file format.&#x20;

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FcIfvsSiGHDllpzinhzMH%2Fimage.png?alt=media&#x26;token=aed72403-85f3-469c-8597-2a3b35b08fbc" alt=""><figcaption></figcaption></figure>

This method will allow you to work directly with the associated circuit schematic part when designing the circuit as well as the part footprint when designing the PCB.

{% hint style="info" %}
This is the recommended way to design for our substrates and templates.
{% endhint %}
{% endtab %}

{% tab title="Import BRD file" %}
Some PCB design softwares allow you to open a premade board (BRD) file and "append" it to your project. This allows you to place and use the board in your design and edit it's footprint.

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FhaJAPnTLDIZPztOq4x11%2Fimage.png?alt=media&#x26;token=c8faa9b5-d312-4756-92f4-be040087fded" alt=""><figcaption><p>Append board function in kiCAD</p></figcaption></figure>

#### Pre-plated Vias Templates

If you are working with either the pre-plated **distributed** or **clustered** vias templates you will need to remove both positive and negative signal traces from the board file before designing your circuit.&#x20;

These traces have already been fabricated into the PCB template and do not need to be printed. Leaving them in will cause interference when routing traces in your PCB design.&#x20;

<div><figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FUpAeAjMAxMtU2MNklTAC%2Fimage.png?alt=media&#x26;token=94069a34-769f-4e86-8432-0417e2b1e632" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FtDTlgbfOqywcJHpJYP4J%2Fimage%20(1).png?alt=media&#x26;token=75346adf-69e4-44fa-a476-1b8f3d0e9d72" alt="" width="369"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Import gerber files" %}
{% hint style="warning" %}
This method should only be attempted as a last resort.
{% endhint %}

1. Extract all of the gerber files for the chosen substrate or template contained in the compressed folder.

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FwzXJrJ2EvyorcH7hVX15%2Fimage.png?alt=media&#x26;token=46a4beed-f0ce-465b-8039-92c4ccc196ed" alt=""><figcaption></figcaption></figure>

2. Import the copper\_top (GTL) and copper\_bottom (GBR) layer into the PCB Editor under the correct corresponding layer dependent on your design software.

{% hint style="info" %}
This method will import all features of a layer as polygons in your design. You may need to replace via locations with actual vias in your design.&#x20;
{% endhint %}

3. Remove all unused features.

#### Pre-plated Vias Templates

If you are working with either the pre-plated **distributed** or **clustered** vias templates you will need to remove both positive and negative signal traces from the board file before designing your circuit.&#x20;

These traces have already been fabricated into the PCB template and do not need to be printed. Leaving them in will cause interference when routing traces in your PCB design.&#x20;

<div><figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2F9qHEHZygYrUzR5YO8DZj%2Fimage.png?alt=media&#x26;token=45ea21b9-0a00-4060-baf9-6b063f75512c" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FTGE3mvdmYx1uU2zZ7oJK%2Fimage%20(1).png?alt=media&#x26;token=ba9d1469-df50-46e7-90e6-9b9ad4ba2943" alt="" width="369"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

### Editing With Gerbv <a href="#debugging-with-gerbv" id="debugging-with-gerbv"></a>

[Gerbv](https://sourceforge.net/projects/gerbv/) is an open source Gerber viewer that also contains basic Gerber editing functionality including the ability to remove unwanted features from the Gerber file. If the template board footprint cannot be edited in your design software we suggest you use Gerbv to remove all of the unused template features so they are not printed by the V-One.

{% hint style="warning" %}
Editing the Gerber file is permanent! Make sure to use a copy of the original Gerber when editing.
{% endhint %}

1. Download and install [Gerbv](https://sourceforge.net/projects/gerbv/).&#x20;
2. Open the program and have a copy of your original Gerbers ready.
3. In the main window, navigate to *File>Open Layer(s)*.
4. Select the copied Gerber files you are working on. You will want to open both the copper and solder paste layers being used as well as the corresponding drill file. The Gerber files should now load in the Gerber viewer.

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FKXFT7UFuqax2Ni0pnu4G%2Fimage.png?alt=media&#x26;token=6e5e792b-81aa-4687-8360-78abd10dc82b" alt=""><figcaption></figcaption></figure>

**Remove Unused Features**

1. Select any unused traces, pads, and features by either clicking to select individual features or clicking and dragging to select multiple. You can also hold down the shift key to select multiple different groups.&#x20;
2. Delete the features by hitting the delete key or right clicking on the screen and selecting "delete selected object(s)".
3. Navigate to *File>Save Active Layer* or press Ctrl+S to save the edits.

{% hint style="info" %}
You can toggle which layers are visible in the layers menu to make editing easier and ensure all unused features have been removed.
{% endhint %}

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2FCVU1hNzPbw8XhEqfcUcU%2FGerbV%20Edit.jpg?alt=media&#x26;token=32a5562b-c6fa-46c9-bbd3-05d370163413" alt=""><figcaption></figcaption></figure>

## Printing Your Circuit

### Choosing Alignment Points

To ensure that your design aligns with the prefabricated pads on the template board we will be using the aligned print workflow. To ensure that your design is printed properly we want to align our print to the existing features on the template board. Use any pre-fabricated vias or pads to align the print in the V-One software.&#x20;

<figure><img src="https://2994552790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKMS1I2mCuOJeZyXjzOqV%2Fuploads%2F3J7eR5X8z0yYjBLKndQo%2Fimage.png?alt=media&#x26;token=5394845a-eba5-4dba-95e5-16dda0465938" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.voltera.io/docs/v-one/learn-v-one/circuit-design-for-v-one/designing-with-pcb-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
