Merge pull request #61 from esp-cpp/feature/atopile-test

Add atopile / KiCAD version of the electronics

.github/workflows/atopile.yml

@@ -0,0 +1,35 @@
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Build atopile project
+        uses: sethfischer/atopile-action@main
+        with:
+          path: 'ecad/'  # atopile project directory
+
+      - name: Upload Combined Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ecad_build
+          path: 'ecad/build' # atopile build directory
+
+      - name: Attach files to release
+        uses: softprops/action-gh-release@v2
+        if: ${{ github.event.release && github.event.action == 'published' }}
+        with:
+          files: |
+            ecad/build/*

.github/workflows/build.yml

@@ -9,7 +9,7 @@ jobs:
 
     steps:
     - name: Checkout repo
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
       with:
         submodules: 'recursive'
 

.github/workflows/package_main.yml

@@ -14,7 +14,7 @@ jobs:
 
     steps:
     - name: Checkout repo
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
       with:
         submodules: 'recursive'
 
@@ -27,7 +27,7 @@ jobs:
         command: './patches.sh && idf.py build'
 
     - name: Upload Build Outputs
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: build-artifacts
         path: |
@@ -37,7 +37,7 @@ jobs:
           build/flash_args
 
     - name: Attach files to release
-      uses: softprops/action-gh-release@v1
+      uses: softprops/action-gh-release@v2
       if: ${{ github.event.release && github.event.action == 'published' }}
       with:
         files: |

ecad/.gitignore

@@ -0,0 +1,5 @@
+env/
+.ato
+fp-info-cache
+*.kicad_prl
+*.lck

ecad/README.md

@@ -18,3 +18,56 @@ The ESP-BOX-EMU contains a single circuit board with the following components:
 These features are supported in two different versions of the electronics, targeting:
 - ESP32-S3-Box
 - ESP32-S3-Box-3
+
+## Setup
+
+``` sh
+# one time steps on your machine
+pipx install atopile
+ato configure
+
+# one time steps in this folder
+ato install
+```
+
+## Build
+
+``` sh
+# build everything
+ato build -t all
+
+# build for ESP32-S3-BOX
+ato build -b box-emu -t all
+
+# build for ESP32-S3-BOX-3
+ato build -b box-3-emu -t all
+```
+
+Note: if you make changes to the electronics design (.ato files), you'll likely
+need to update the `box-emu-base` layout (or other affected layouts). After
+updating the affected layouts, make sure you import them into their parent
+modules. The tree is listed here:
+
+* box-3-emu
+  * box-3-connector
+  * box-emu-base
+    * gbc-dpad
+    * gbc-start-select
+    * gbc-a-b-x-y
+      * gbc-a-b
+* box-emu
+  * box-connector
+  * box-emu-base
+    * gbc-dpad
+    * gbc-start-select
+    * gbc-a-b-x-y
+      * gbc-a-b
+
+
+## View
+
+``` sh
+ato view -b box-emu
+# or
+ato view -b box-3-emu 
+```

ecad/ato-lock.yaml

@@ -0,0 +1,79 @@
+poses:
+  schematic:
+    1215c762:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 59.5
+        y: -127.0
+      rotation: 0
+    1a7d69e4:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: -1.0
+        y: -60.5
+      rotation: 0
+    259590ee:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: -1.5
+        y: -88.0
+      rotation: 0
+    345c82a9:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 89.0
+        y: -0.5
+      rotation: 0
+    427607c7:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 93.5
+        y: -30.0
+      rotation: 0
+    60c31b5b:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: -3.0
+        y: 31.5
+      rotation: 0
+    6e4b337c:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 2.0
+        y: 107.0
+      rotation: 0
+    734fb737:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 14.0
+        y: -29.5
+      rotation: 0
+    95025a74:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: -2.0
+        y: -398.8
+      rotation: 0
+    978a53d6:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: -1.0
+        y: 60.5
+      rotation: 0
+    b21f4dba:
+      mirror_x: false
+      mirror_y: false
+      position:
+        x: 56.0
+        y: -168.5
+      rotation: 0

ecad/ato.yaml

@@ -0,0 +1,28 @@
+ato-version: ^0.2.0
+builds:
+  gbc-dpad:
+    entry: elec/src/gbc-dpad.ato:GbcDpad
+  gbc-start-select:
+    entry: elec/src/gbc-start-select.ato:GbcStartSelect
+  gbc-a-b:
+    entry: elec/src/gbc-a-b.ato:GbcAB
+  gbc-a-b-x-y:
+    entry: elec/src/gbc-a-b-x-y.ato:GbcABXY
+  box-emu-base:
+    entry: elec/src/box-emu-base.ato:BoxEmuBase
+  box-3-emu:
+    entry: elec/src/box-3-emu.ato:Box3Emu
+  box-emu:
+    entry: elec/src/box-emu.ato:BoxEmu
+  box-connector:
+    entry: elec/src/box-connector.ato:BoxConnector
+  box-3-connector:
+    entry: elec/src/box-3-connector.ato:Box3Connector
+dependencies:
+- generics ^v3.0.0
+- tps63020dsjr ^v0.0.1
+- usb-connectors ^v2.0.2
+- name: qwiic-connectors
+  version_spec:
+  link_broken: true
+  path: elec/src/qwiic-connectors