Skip to the content
2 layers19.6 × 18 mmBoard3 edit, the printed circuit board in 3D

A set of tool to interact with SKiDL and KiCad

Size
19.6 × 18 mm
Copper layers
2
Thickness
1.6 mm
Parts
9
Nets
2
Pads
22
Tracks, vias
0, 0
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
5 Sep 2024
Updated
21 May 2025

Overview

Board3 edit is an open-source printed circuit board by sylefeb, from the sylefeb/skidl-tools repository on GitHub. It is a 2-layer board of 19.6 × 18 mm with 9 parts on 2 nets.

README

README.md

skidl-tools

TL;DR

This tool helps doing iterative design between a PCB described in skidl (python code) and KiCad's PCB editor (PcbNew): start placing and routing, go back to code and add components, resume editing without loosing your previous changes.

Note: (thanks to TheZoq2 for pointing this out) In many cases you do not need this tool and can simply use generate_netlist() from skidl and use KiCad's Import > Netlist feature to merge changes with your current PCB design. Best to try that first as KiCad provides multiple options in dealing with conflicts.

What is in this repo?

A collection of tools (one for now!) to help with PCB design using KiCad and skidl.

The main tool is skidl-updater, it takes a previous design and a newly generated PCB from skidl, and remaps prior edits onto the new file. See Example workflow below.

This is very much work in progress, please see Limitations.

How to compile

text
git submodule init
git submodule update
mkdir BUILD
cd BUILD
cmake ../updater/
make install

Example workflow

This tutorial example walks through the process of progressively adding components to a board, using skidl-updater at each step to import prior changes to the PCB. For the sake of the tutorial the example is voluntarily cut into many small incremental steps.

Note: the tutorial assumes some familiarity with KiCad's layout editor (PcbNew).

This tutorial uses KiCad 7.

The goal is to design a simple 'half-PMOD' (using only one PMOD row) with four LEDs on it. All files are in examples/pmod_leds. Here is the workflow:

  • We start by a simple script defining VCC and GND nets and adding a connector, board1.py. Note how the connector is using a ref attribute (PMOD), this is essential to the inner workings of skidl-updater: each component has to have a unique ref. To generate the board we run python board1.py.

Note: the script has to be run from a special python environment provided by KiCad, please refer to skidl's documentation.

  • We open the generated board1.kicad_pcb, create a board contour and place the connector, save the board and exit.
  • Now, we add the LEDs in board2.py. We generate board2.kicad_pcb by running python board2.py. However board2.kicad_pcb has lost the contour and placement of the connector we did at step one. We don't want to redo what we just did, so we use skidl-updater:

skidl-updater -p board1.kicad_pcb -n board2.kicad_pcb -o board2_edit.kicad_pcb

  • This command takes the content of board1.kicad_pcb as reference and imports it into board2.kicad_pcb to obtain board2_edit.kicad_pcb. We now can open board2_edit.kicad_pcb and are ready to place the LEDs, prior edits have been imported! We now place the LEDs neatly on the board, save and exit.
  • We also need a resistor per LED, so we add them to obtain board3.py and run python board3.py to obtain board3.kicad_pcb, which has again lost all our edits. skidl-updater to the rescue!

skidl-updater -p board2_edit.kicad_pcb -n board3.kicad_pcb -o board3_edit.kicad_pcb

  • Final step, we need to connect everything together. Each LED will be lit by one of the four signals from the half-PMOD. We add the connections to obtain board4.py and generate the PCB with python board4.py. Again all changes are lost, and we use skidl-updater to save the day:

skidl-updater -p board3_edit.kicad_pcb -n board4.kicad_pcb -o board4_edit.kicad_pcb

The board is done! (maybe don't fab it, it's just a quick example ;) ).

Note: In the example we save each step, but of course you can start from the same file, running skidl-updater -p board_edit.kicad_pcb -n board.kicad_pcb -o board_edit.kicad_pcb works (it will rename the previous file as a .bak, in case something goes wrong).

Limitations

There are potential 'gotchas', be worried if kicad reports a warning when opening the PCB file.

Use at your own risks -- always double check your design and the nets.

Some known issues and workarounds:

  • Removing a component. The tool is geared towards the idea of progressively adding components to the board. When removing a component, that is the script no longer produce a component of a given ref, then edit the previous version .kicad_pcb and also delete the component from the board. Otherwise, the updater will keep bringing it back, introducing various problems with nets.

  • Swapping the footprint of a component. As with Removing a component, make sure to edit the previous version .kicad_pcb and delete the component first. You will have to place the new footprint again, but that guarantees the footprint is properly updated.

Found another limitation? Please fill-in an issue in github.

Parts

9
QtyValueFootprintReferences
4270R_0805_2012Metric_Pad1.20x1.40mm_HandSolderled0_r, led1_r, led2_r, led3_r
4LEDLED_0805_2012Metric_Pad1.15x1.40mm_HandSolderled0, led1, led2, led3
1Conn_01x06PinHeader_1x06_P2.54mm_HorizontalPMOD

More from sylefeb/skidl-tools

1
  • 2 layersBoard2, the printed circuit board in 3D

    Board2

    sylefeb/skidl-tools

    A set of tool to interact with SKiDL and KiCad

    5 parts6

Similar boards

  • 2 layers103 × 30.5 mmTS Back Endcap, the printed circuit board in 3D

    TS Back Endcap

    EEVengers/ThunderScope

    ThunderScope GitHub Repo

    9 parts1.3kMIT
  • 2 layers31.8 × 47.6 mmNGC 38 connector, the printed circuit board in 3D

    NGC 38 connector

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    9 parts1.2k
  • 2 layers24 × 27.3 mmExpansion Card Retrofit, the printed circuit board in 3D

    Expansion Card Retrofit

    FrameworkComputer/ExpansionCards

    Reference designs and documentation to create Expansion Cards for the Framework Laptop

    9 parts1.1kCC-BY-4.0
  • 2 layers15.6 × 17.3 mmSKR Mini TFT Thermistor Board, the printed circuit board in 3D

    SKR Mini TFT Thermistor Board

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    9 parts1.1kGPL-3.0
  • 2 layers39.1 × 49.5 mmLearnoliver, the printed circuit board in 3D

    Learnoliver

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    9 parts915
  • 2 layers17.4 × 16.9 mmToolhead, the printed circuit board in 3D

    Toolhead

    tanaes/whopping_Voron_mods

    9 parts787GPL-3.0
  • 2 layers9.8 × 108 mmExpander, the printed circuit board in 3D

    Expander

    wntrblm/Castor_and_Pollux

    A Juno-inspired dual oscillator

    9 parts587
  • 2 layersKeyboard after, the printed circuit board in 3D

    Keyboard after

    adamws/kicad-kbplacer

    KiCad plugin for automatic keyboard's key placement and routing

    9 parts547GPL-3.0

Questions

How big is the Board3 edit PCB?

It measures 19.6 × 18 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Board3 edit use?

9 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Board3 edit KiCad files?

From the sylefeb/skidl-tools repository on GitHub, at the commit this page was made from: the board is examples/pmod_leds/board3_edit.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Board3 edit design in my own project?

Its repository states no licence, so its author keeps all rights: ask sylefeb before reusing the design.