Notes about the structure of this repository
This repository contains all the necessary files and instructions for the PCBs that are designed using KiCad. Here is an overview of the main components:
- .github: Contains Github-specific configurations, including workflows (e.g. to export the BOMs) and Dependabot settings.
- bom_exports: Contains the Bill of Materials (BOM), all related documents (e.g. RoHS certificates) and the schematic for finished projects. The content will be automatically generated by a workflow.
- KiCad: Contains the KiCad project files.
- scripts: Contains utility scripts for tasks such as generating BOMs and exporting schematics.
How to get started with KiCad
- Install the latest version of KiCad.
- Install the latest release version of the
KiCad-Db-Lib.
- Clone this repo PCB_Designs.
- Clone the KiCad_Library
repository.
- Start KiCad and
- Click
Preferences -> Configure Paths...
- Replace the
KICAD8_FOOTPRINT_DIR by the absolute path of the
KiCad_Library/footprints, so for example:
C:\Robast\KiCad_Library\footprints
- Replace the
KICAD8_SYMBOL_DIR by the absolute path of the
KiCad_Library/symbols, so for example:
C:\Robast\KiCad_Library\symbols
- Click
Preferences -> Manage Symbol Libraries...
- Under Global Libraries click
Add existing library to table, go into
the KiCad_Library/output directory and select all files and press
open.
BOM Exports Including Datasheets And Certificates
Once a PCB is considered finished, there should be a BOM, that is exported within KiCad by
-
Go into the schematic of the project
-
Click Tools -> Generate Bill of Materials ...
-
Make a few settings here:
- Under
Export change the Output file to exactly the following string:
manufacturing/PCB Assembly/${PROJECTNAME}_BOM.csv
- Field delimiter:
,
- String delimiter:
"
- Reference delimiter:
,
- Format presets:
CSV
- Under
Edit:
| Field | Label | Show | Group By |
|---|
| Reference | Designator | Yes | No |
| Value | Comment | Yes | Yes |
| Footprint | Footprint | Yes | No |
| ${QUANTITY} | Qty | Yes | No |
| OC_LCSC | OC_LCSC | Yes | Yes |
| durability | durability | Yes | No |
| path_to_docs | path_to_docs | Yes | No |
-
Hit Apply, Save Schematic & Continue.
-
Hit Export.
Now that we there is a BOM and we push the BOM to the main, the workflow triggers to create a bom export which includes documents like datasheets and certificates.
Hint: Check that all relevant parts are exported and check that no part accidently has checked the EXCLUDE_FROM_BOM attribute. You can easily check all parts for that attribute if you add the field ${EXCLUDE_FROM_BOM} in the Generate Bill of Materials ... GUI.