Canfuel

kicad

Printed circuit boards. A container for all projects, successor to the older eagle repo.

KiCad 10 — text formats, readable diffs, ERC and DRC running in CI through kicad-cli without a GUI. The CI container image tracks the local major version, because KiCad refuses to open files written by a newer one.

Boards

The canfuel board is finished: schematic and PCB complete, ERC and DRC clean with zero unconnected items, 24 parts on 55 × 45 mm and two layers, fab/ generated and committed. ⚠ While a fabrication order is outstanding, do not edit the board files — fab/ describes the commit that was sent, and an edit makes it stop describing what is being made.

The harness is built, fitted and measured — canfuel/docs/harness.md is the procedure. The whole build path, across all three repositories, is canfuel/docs/firmware/install.md; the steps this repository owns are the board and the loom.

Prerequisites

kicad-cli version          # must print 10.x

The major version is not a preference. KiCad refuses to open files written by a newer major version, so a mismatch is a hard failure rather than a warning. CI runs the kicad/kicad:10.0 container image and that image tracks whatever is installed locally — bump the two together, never separately.

Nothing here needs a licence, an account or a plugin. Making the board also needs no KiCad at all: fab/ is generated and committed, so a fab house can be given those files directly.

Layout

lib/                symbols and footprints shared across projects
<board>/
  *.kicad_pro       project
  *.kicad_sch       schematic
  *.kicad_pcb       board
  fab/              gerbers, BOM, CPL — committed
  docs/             design documents, datasheets, and how to build the harness

For the canfuel board specifically, canfuel/docs/ holds:

*.kicad_prl is local state and does not belong in the repo (it is gitignored).

fab/ is committed deliberately even though it is generated: for any board that has been ordered it must be possible to find out exactly what was sent to the fab.

CI

kicad-cli sch erc and kicad-cli pcb drc. Both must pass before boards are ordered. The workflow fails if it finds no design files, so a green run always means something was actually opened and checked.

Two project-specific checks run alongside them: check-netlist.py and check-placement.py.

Related repositories

The canfuel board is one third of a project that needs all three repositories. Clone them side by side.

Building one? canfuel/docs/firmware/install.md is the whole path from three clones to a working device, in the order it has to happen. Making up the harness — the part that lives in this repository — is step 3 of seven.

The coupling to canfuel is the pin assignment, and it is one-way: the firmware is written against the board, not the other way round. Changing it means changing the firmware in the same breath, and invalidates any fab/ already sent.

Licence

Apache License 2.0. Use it, change it, order the boards, sell them — the only obligations are to keep the copyright and licence notices and to say what you changed.

NOTICE lists what is not ours. The manufacturer datasheets under canfuel/docs/ belong to their manufacturers and are redistributed for reference only; the licence above does not cover them and does not claim to. Everything else in this repository is covered.

Questions, corrections and pull requests are welcome as issues on any of the three repositories, or by email to Lubos Housa luboshousa@gmail.com.