feat: rpi hat pcb

.github/workflows/build-pcb.yml

@@ -0,0 +1,44 @@
+name: build-pcb
+
+on: [pull_request, push]
+
+jobs:
+  build-pcb:
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+
+      - name: Checkout LFS objects
+        run: git lfs checkout
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          poetry --version
+
+      - name: Install dependencies
+        run: poetry install --no-interaction
+
+      - name: Create mechanical files
+        run: poetry run make pcb-mech
+
+      - name: Build PCBs
+        uses: sethfischer/atopile-action@main
+        with:
+          path: "pcb/"
+
+      - name: Upload PCB artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: pcb-build
+          path: pcb/build/
+          if-no-files-found: error

.gitignore

@@ -3,6 +3,7 @@
 .mypy_cache
 .pytest_cache
 .venv
+.vscode/
 /_build
 /dist
 /docs/_build

Makefile

@@ -19,6 +19,10 @@ lint-python lint-shell:
 test:
 	pytest
 
+.PHONY: pcb-mech
+pcb-mech:
+	console pcb-outline --board="rpi_hat" > pcb/mech/rpi_hat.dxf
+
 
 .PHONY: _build/open-graph-card/final-assembly.png
 _build/open-graph-card/final-assembly.png:

README.rst

@@ -2,7 +2,7 @@
 sethfischer/rover
 =================
 
-|build-status| |lint-status| |test-status| |docs-status| |linkcheck-status|
+|build-status| |lint-status| |test-status| |docs-status| |linkcheck-status| |build-pcb-status|
 
 
 Quarter-scale Mars rover based on the NASA Mars 2020 Mission Perseverance Rover.
@@ -47,3 +47,6 @@ License
 .. |linkcheck-status| image:: https://github.com/sethfischer/rover/actions/workflows/linkcheck.yml/badge.svg
     :target: https://github.com/sethfischer/rover/actions/workflows/linkcheck.yml
     :alt: Link Check Status
+.. |build-pcb-status| image:: https://github.com/sethfischer/rover/actions/workflows/build-pcb.yml/badge.svg
+    :target: https://github.com/sethfischer/rover/actions/workflows/build-pcb.yml
+    :alt: PCB build status

docs/build-release.rst

@@ -37,6 +37,7 @@ Prerequisites
 * `Python`_ >=3.11, and python-venv.
 * `Poetry`_ for Python dependency management.
 * `Mayo 3D CAD viewer and converter`_ for exporting PNG images.
+* `KiCad EDA`_ v8 (a dependency of `atopile`_) for building PCB manufacturing files.
 * Optional:
    - `ImageMagick`_ for manipulating images.
    - `exiftool`_ for manipulating EXIF headers.
@@ -54,7 +55,7 @@ Install prerequisites
 
     sudo apt-get install git python3.11 python3.11-venv imagemagick optipng exiftool
 
-Poetry, Mayo, and git-lfs should be installed according to their respective documentation,
+Poetry, Mayo, git-lfs, and KiCad should be installed according to their respective documentation,
 and be available in your path.
 
 
@@ -114,6 +115,8 @@ Run linters and tests:
 .. _`Git`: https://git-scm.com/
 .. _`Poetry`: https://python-poetry.org/
 .. _`Mayo 3D CAD viewer and converter`: https://github.com/fougue/mayo
+.. _`KiCad EDA`: https://www.kicad.org/
+.. _`atopile`: https://atopile.io/
 .. _`ImageMagick`: https://imagemagick.org/
 .. _`exiftool`: https://exiftool.org/
 .. _`git-lfs`: https://git-lfs.com/

pcb/.gitignore

@@ -0,0 +1,39 @@
+# For PCBs designed using KiCad: https://www.kicad.org/
+# Format documentation: https://kicad.org/help/file-formats/
+
+# Temporary files
+*.000
+*.bak
+*.bck
+*.kicad_pcb-bak
+*.kicad_sch-bak
+*-backups
+*.kicad_prl
+*.sch-bak
+*~
+_autosave-*
+*.tmp
+*-save.pro
+*-save.kicad_pcb
+*.kicad_pcb.lck
+fp-info-cache
+
+# Netlist files (exported from Eeschema)
+*.net
+
+# Autorouter files (exported from Pcbnew)
+*.dsn
+*.ses
+
+# Exported BOM files
+*.xml
+*.csv
+
+# atopile
+.ato/
+build/
+elec/footprints/footprints.kicad_sym
+
+# Mechanical files built from source
+mech/**
+!mech/README.rst

pcb/ato.yaml

@@ -0,0 +1,7 @@
+ato-version: ^0.2.35
+builds:
+  rpi-hat:
+    entry: elec/src/rpi-hat.ato:RpiHat
+dependencies:
+  - generics
+  - rpi-header