

Board3 edit
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.mdskidl-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
git submodule init
git submodule update
mkdir BUILD
cd BUILD
cmake ../updater/
make installExample 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
refattribute (PMOD), this is essential to the inner workings ofskidl-updater: each component has to have a uniqueref. To generate the board we runpython 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. Howeverboard2.kicad_pcbhas 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 useskidl-updater:
skidl-updater -p board1.kicad_pcb -n board2.kicad_pcb -o board2_edit.kicad_pcb
- This command takes the content of
board1.kicad_pcbas reference and imports it intoboard2.kicad_pcbto obtainboard2_edit.kicad_pcb. We now can openboard2_edit.kicad_pcband 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.pyto obtainboard3.kicad_pcb, which has again lost all our edits.skidl-updaterto 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 useskidl-updaterto 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_pcbworks (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_pcband 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_pcband 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| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | 270 | R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | led0_r, led1_r, led2_r, led3_r |
| 4 | LED | LED_0805_2012Metric_Pad1.15x1.40mm_HandSolder | led0, led1, led2, led3 |
| 1 | Conn_01x06 | PinHeader_1x06_P2.54mm_Horizontal | PMOD |
More from sylefeb/skidl-tools
1- 2 layers

Similar boards
- 2 layers103 × 30.5 mm

- 2 layers31.8 × 47.6 mm

- 2 layers24 × 27.3 mm

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 mm

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 mm

Learnoliver
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
9 parts915 - 2 layers17.4 × 16.9 mm

- 2 layers9.8 × 108 mm

- 2 layers

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.