Firmware 0.2.0

Update README.md
Update firmware with new timeout
2026-01-14 17:58:01 -05:00 · 2022-10-28 12:45:03 -07:00 · 2022-10-19 21:22:19 -07:00 · 2022-10-11 09:08:03 -07:00 · 2022-09-30 20:25:52 -07:00 · 2022-09-30 20:15:02 -07:00
16 changed files with 723 additions and 98 deletions
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@@ -7,11 +7,6 @@ jobs:
  build:
    name: Build Firmware
    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        desk_brand:
-          - uplift_v2
-          - fully_jarvis
    steps:
      - uses: actions/checkout@v2

@@ -22,12 +17,22 @@ jobs:
      - name: Install ESPHome
        run: pip install --user esphome
      
-      - name: Compile Firmware
+      - name: Compile Release Firmware
        working-directory: firmware
        run: |
-          esphome compile ${{ matrix.desk_brand }}.yaml
+          esphome compile config.yaml
          mkdir -p bin
-          cp .esphome/build/upsy-desky/.pioenvs/upsy-desky/firmware-factory.bin bin/stock-${{ matrix.desk_brand }}.bin
+          cp .esphome/build/upsy-desky/.pioenvs/upsy-desky/firmware-factory.bin bin/firmware-factory.bin
+          cp .esphome/build/upsy-desky/.pioenvs/upsy-desky/firmware.bin bin/firmware.bin
+
+      - name: Compile Debug Firmware
+        working-directory: firmware
+        run: |
+          rm -rf .esphome/build/upsy-desky
+          esphome compile debug.yaml
+          mkdir -p bin
+          cp .esphome/build/upsy-desky/.pioenvs/upsy-desky/firmware-factory.bin bin/debug-firmware-factory.bin
+          cp .esphome/build/upsy-desky/.pioenvs/upsy-desky/firmware.bin bin/debug-firmware.bin

      - name: Upload Firmware
        uses: skx/github-action-publish-binaries@release-1.3
--- a/README.md
+++ b/README.md
@@ -2,11 +2,13 @@

 This repository contains the source files for the Upsy Desky, a device which lets you connect your standing desk to any home automation system.

-I will be selling them on Tindie, but if you're seeing this, it isn't available for purchase yet. You can sign up [here](https://forms.gle/285GffmpfHamryEu6) to get notified as soon as it is available. I anticipate starting sales sometime during the week of August 29th.
+You can buy one on Tindie:

-<!-- You can buy one on Tindie:
+<a href="https://www.tindie.com/products/tjhorner/upsy-desky/?ref=offsite_badges&utm_source=sellers_tjhorner&utm_medium=badges&utm_campaign=badge_large"><img src="https://d2ss6ovg47m0r5.cloudfront.net/badges/tindie-larges.png" alt="I sell on Tindie" width="200" height="104"></a>

-<a href="https://www.tindie.com/products/tjhorner/upsy-desky/?ref=offsite_badges&utm_source=sellers_tjhorner&utm_medium=badges&utm_campaign=badge_large"><img src="https://d2ss6ovg47m0r5.cloudfront.net/badges/tindie-larges.png" alt="I sell on Tindie" width="200" height="104"></a> -->
+## Need Support?
+
+If you need help with your Upsy Desky, please join the Upsy Desky [Discord server](https://discord.gg/ZHfXKQrSxF) where you can ask for help from the community and myself.

 ## Repository Structure

@@ -23,6 +25,7 @@ With these you can make your own Upsy Desky from scratch, or you can make change
 This is the successor to the [WiFi Standing Desk Controller](https://github.com/tjhorner/wifi-desk-controller), packed with improvements and bug fixes — most notably:

 - USB-C port for easy flashing (and because USB-C is cool 😎)
+- Runtime firmware configuration -- no more manual flashing or compiling ESPHome to change stuff
 - Improved enclosure design with a more snug fit and screw-mounted PCB, allowing for easier repairs and troubleshooting
 - Replacing the D1 Mini with an ESP32-WROOM module, providing hardware UART for more reliable desk connection
 - A catchier name, because "WiFi Standing Desk Controller" was a mouthful
@@ -54,4 +57,4 @@ You can find everything you need in the [GitHub wiki](https://github.com/tjhorne

 ## Licenses

-The ESPHome configs are licensed under MIT; everything else (enclosure and PCB design) are CC BY-NC-SA 4.0. The appropriate license files are available in the root of the repo.
+The ESPHome configs are licensed under MIT; everything else (enclosure and PCB design) are CC BY-NC-SA 4.0. The appropriate license files are available in the root of the repo.
--- a/firmware/_base.yaml
+++ b/firmware/_base.yaml
@@ -1,43 +0,0 @@
-substitutions:
-  name: "upsy-desky"
-
-esphome:
-  name: "${name}"
-  name_add_mac_suffix: true
-  project:
-    name: tj_horner.upsy_desky
-    version: "0.0.2"
-
-esp32:
-  board: esp32dev
-
-logger:
-  level: INFO
-
-wifi:
-  ap:
-    password: "hunter2hunter2"
-
-captive_portal:
-
-improv_serial:
-
-api:
-  password: ""
-  reboot_timeout: 0s
-
-web_server:
-  port: 80
-
-ota:
-  password: ""
-
-packages:
-  standing_desk: github://tjhorner/esphome-standing-desk/configs/template.yaml
-  presets_addon: github://tjhorner/esphome-standing-desk/configs/addons/presets.yaml
-
-light:
-  - platform: status_led
-    id: status
-    pin: GPIO23
-    restore_mode: ALWAYS_ON
--- a/firmware/config.yaml
+++ b/firmware/config.yaml
@@ -0,0 +1,132 @@
+substitutions:
+  name: "upsy-desky"
+  friendly_name: "Upsy Desky"
+
+  # Defaults
+  standing_desk_uart_rx_pin: "17"
+  standing_desk_up_pin: "21"
+  standing_desk_down_pin: "22"
+  standing_desk_variant: "uplift"
+  standing_desk_min_height: "25.2"
+  standing_desk_max_height: "50.8"
+
+  # Presets
+  button_bit1_pin: "21"
+  button_bit2_pin: "22"
+  button_bit4_pin: "19"
+  button_m_pin: "18"
+
+esphome:
+  name: "${name}"
+  name_add_mac_suffix: true
+  on_boot:
+    then:
+      # Wakes up the desk and reports height
+      - uart.write:
+          id: handset_tx
+          data: [ 0x0 ]
+  project:
+    name: tj_horner.upsy_desky
+    version: "0.2.0"
+
+dashboard_import:
+  package_import_url: github://tjhorner/upsy-desky/firmware/config.yaml
+
+uart:
+  id: handset_tx
+  tx_pin: 16
+  baud_rate: 9600
+
+esp32:
+  board: esp32dev
+
+logger:
+  level: INFO
+
+wifi:
+  ap:
+    password: "hunter2hunter2"
+
+captive_portal:
+
+improv_serial:
+
+api:
+  password: ""
+  reboot_timeout: 0s
+
+web_server:
+  port: 80
+
+ota:
+  password: ""
+
+packages:
+  standing_desk: github://tjhorner/esphome-standing-desk/configs/template.yaml@master
+  presets_addon: github://tjhorner/esphome-standing-desk/configs/addons/presets.yaml@master
+
+select:
+  - platform: template
+    name: "${friendly_name} Height Decoder Variant"
+    entity_category: "config"
+    optimistic: true
+    restore_value: true
+    options:
+      - uplift
+      - jarvis
+    initial_option: ${standing_desk_variant}
+    on_value:
+      then:
+        lambda: "id(desk_height)->set_decoder_variant(x);"
+  - platform: template
+    name: "${friendly_name} Height Units"
+    entity_category: "config"
+    optimistic: true
+    restore_value: true
+    options:
+      - in
+      - cm
+    initial_option: in
+    on_value:
+      then:
+        lambda: |
+          id(desk_height)->set_unit_of_measurement(x);
+          id(target_desk_height)->traits.set_unit_of_measurement(x);
+
+number:
+  - platform: template
+    name: "${friendly_name} Min Target Height"
+    entity_category: "config"
+    min_value: 0
+    max_value: 150
+    step: 0.1
+    optimistic: true
+    restore_value: true
+    initial_value: ${standing_desk_min_height}
+    on_value:
+      then:
+        lambda: |
+          id(target_desk_height)->traits.set_min_value(x);
+  - platform: template
+    name: "${friendly_name} Max Target Height"
+    entity_category: "config"
+    min_value: 0
+    max_value: 150
+    step: 0.1
+    optimistic: true
+    restore_value: true
+    initial_value: ${standing_desk_max_height}
+    on_value:
+      then:
+        lambda: |
+          id(target_desk_height)->traits.set_max_value(x);
+
+button:
+  - platform: restart
+    name: "${friendly_name} Restart"
+
+light:
+  - platform: status_led
+    id: upsy_desky_status_led
+    pin: GPIO23
+    restore_mode: ALWAYS_ON
--- a/firmware/debug.yaml
+++ b/firmware/debug.yaml
@@ -0,0 +1,13 @@
+packages:
+  base: !include config.yaml
+
+logger:
+  level: DEBUG
+
+debug:
+  update_interval: 5s
+
+text_sensor:
+  - platform: debug
+    device:
+      name: "${friendly_name} Device Info"
--- a/firmware/fully_jarvis.yaml
+++ b/firmware/fully_jarvis.yaml
@@ -1,19 +0,0 @@
-packages:
-  base_config: !include _base.yaml
-
-dashboard_import:
-  package_import_url: github://tjhorner/upsy-desky/firmware/fully_jarvis.yaml
-
-substitutions:
-  standing_desk_uart_rx_pin: "17"
-  standing_desk_up_pin: "21"
-  standing_desk_down_pin: "22"
-  standing_desk_variant: "jarvis"
-  standing_desk_min_height: "24.5"
-  standing_desk_max_height: "50.0"
-
-  # Presets
-  button_bit1_pin: "21"
-  button_bit2_pin: "22"
-  button_bit4_pin: "19"
-  button_m_pin: "18"
--- a/firmware/uplift_v2.yaml
+++ b/firmware/uplift_v2.yaml
@@ -1,19 +0,0 @@
-packages:
-  base_config: !include _base.yaml
-
-dashboard_import:
-  package_import_url: github://tjhorner/upsy-desky/firmware/uplift_v2.yaml
-
-substitutions:
-  standing_desk_uart_rx_pin: "17"
-  standing_desk_up_pin: "21"
-  standing_desk_down_pin: "22"
-  standing_desk_variant: "uplift"
-  standing_desk_min_height: "25.2"
-  standing_desk_max_height: "50.8"
-
-  # Presets
-  button_bit1_pin: "21"
-  button_bit2_pin: "22"
-  button_bit4_pin: "19"
-  button_m_pin: "18"
--- a/pcb/upsy-desky.kicad_sch
+++ b/pcb/upsy-desky.kicad_sch
@@ -1390,7 +1390,6 @@
    )
  )

-
  (junction (at 167.64 101.6) (diameter 0) (color 0 0 0 0)
    (uuid 01bbb46e-3b58-4196-a7fb-032f7bd4ca2f)
  )
@@ -2551,6 +2550,15 @@
    (property "Checked" "Y" (id 5) (at 254 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 254 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 254 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 254 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 3c2ee86b-a237-493a-9bfc-f17f3c1374d5))
    (pin "2" (uuid 4109720c-431d-42bd-8321-0dc06c678688))
  )
@@ -2572,6 +2580,12 @@
    (property "Checked" "Y" (id 5) (at 175.26 113.03 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 175.26 113.03 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 175.26 113.03 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid abe1a5c5-be1f-4ffb-aa79-9cbbc3178fde))
    (pin "2" (uuid 929d24e8-8fe4-429e-bba3-cdfa11602801))
    (pin "3" (uuid 5e8d48cb-7ace-4432-87c8-faa9d821d187))
@@ -2601,6 +2615,9 @@
    (property "Checked" "Y" (id 6) (at 29.21 38.1 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "TYPE-C-31-M-12" (id 7) (at 29.21 38.1 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "A1" (uuid 70f9fc47-c421-429e-8cdb-52e212c53c51))
    (pin "A12" (uuid 41d0f7aa-6d60-4806-babb-ee1da46b5dee))
    (pin "A4" (uuid c9270b5f-f6ab-401d-a4d8-de4d452bcd9a))
@@ -2689,6 +2706,15 @@
    (property "Checked" "Y" (id 5) (at 226.06 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 226.06 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 226.06 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 226.06 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid ff81e824-90ec-4ea5-aef3-cf8d2986d5c6))
    (pin "2" (uuid 112de0c2-f2ec-4afc-a215-108aff480703))
  )
@@ -2710,6 +2736,12 @@
    (property "Checked" "Y" (id 5) (at 107.95 22.86 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "AMS1117-3.3" (id 6) (at 107.95 22.86 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-223" (id 7) (at 107.95 22.86 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid a3603ebc-86bb-4e12-bb40-e1f69ed76995))
    (pin "2" (uuid 659f0c81-4190-4b23-b532-425566ba7717))
    (pin "3" (uuid c1cf450e-745c-46fc-8bdc-e99a7bec9948))
@@ -2760,7 +2792,7 @@
    (property "Datasheet" "~" (id 3) (at 25.4 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
-    (property "MANUFACTURER" "Assmann WSW Components" (id 4) (at 25.4 179.07 0)
+    (property "MANUFACTURER" "Amphenol ICC (FCI)" (id 4) (at 25.4 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
    (property "STANDARD" "Manufacturer recommendations" (id 5) (at 25.4 179.07 0)
@@ -2772,7 +2804,13 @@
    (property "PARTREV" "00" (id 7) (at 25.4 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
-    (property "Purchase" "https://www.digikey.com/en/products/detail/assmann-wsw-components/A-2004-2-4-LPS-N-R/2183638" (id 8) (at 25.4 179.07 0)
+    (property "Purchase" "https://www.digikey.com/en/products/detail/amphenol-cs-fci/54601-708LF/7589419" (id 8) (at 25.4 179.07 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "54601-708LF" (id 9) (at 25.4 179.07 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "LCSC" "C708595" (id 10) (at 25.4 179.07 0)
      (effects (font (size 1.27 1.27)) hide)
    )
    (pin "1" (uuid 817c96cc-52f1-4b20-a366-efc72380cd2d))
@@ -2906,6 +2944,15 @@
    (property "Checked" "Y" (id 5) (at 36.83 92.71 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 36.83 92.71 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 36.83 92.71 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402FR-1322K1L" (id 8) (at 36.83 92.71 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 54d0cebf-ca14-4db0-9910-22941bc45a98))
    (pin "2" (uuid 01f18b55-48d6-4a40-88ea-e5978dc6c964))
  )
@@ -2947,6 +2994,15 @@
    (property "Checked" "Y" (id 5) (at 194.31 35.56 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 194.31 35.56 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 194.31 35.56 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 194.31 35.56 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 2e495101-6933-4d80-8b8c-1a9cad519b2e))
    (pin "2" (uuid ecfa3825-28b9-436f-b39a-4145e7dd021a))
  )
@@ -2991,6 +3047,15 @@
    (property "Checked" "Y" (id 6) (at 90.17 27.94 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 7) (at 90.17 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 8) (at 90.17 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "GRM155R60J106ME05J" (id 9) (at 90.17 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 81f65caf-0943-4d2e-b216-fb25deb75888))
    (pin "2" (uuid 6d109e58-467a-4f10-9883-6809b5073c7f))
  )
@@ -3016,6 +3081,15 @@
    (property "Checked" "Y" (id 5) (at 248.92 34.29 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 6) (at 248.92 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 248.92 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "0402B104K160HI" (id 8) (at 248.92 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid e7541585-0d8e-4192-b14e-b98aab16e365))
    (pin "2" (uuid f0f6ec31-c79a-4444-bb20-3be60a386acb))
  )
@@ -3085,6 +3159,15 @@
    (property "Checked" "Y" (id 5) (at 58.42 90.17 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 58.42 90.17 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 58.42 90.17 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-131KL" (id 8) (at 58.42 90.17 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 6a78cc95-6a8d-490b-8546-cd7cc62745dc))
    (pin "2" (uuid 7d6c5239-9f90-4b86-ae57-8be9df0770cf))
  )
@@ -3126,6 +3209,15 @@
    (property "Checked" "Y" (id 5) (at 138.43 107.95 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 138.43 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 138.43 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 138.43 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 2775403a-8d7e-457c-8559-f9a5db3a5326))
    (pin "2" (uuid 4029856e-75c5-449a-8299-65507aedba62))
  )
@@ -3179,6 +3271,15 @@
    (property "Checked" "Y" (id 5) (at 139.7 50.8 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 139.7 50.8 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 139.7 50.8 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 139.7 50.8 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 45e7c1bd-d392-4c70-8ae4-52a45b72c121))
    (pin "2" (uuid b35a3200-ee9e-4b7d-a478-f115301c9002))
  )
@@ -3220,6 +3321,15 @@
    (property "Checked" "Y" (id 5) (at 167.64 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 167.64 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 167.64 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 167.64 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid ceff83c2-46ba-49ff-bc77-ecf71a244a15))
    (pin "2" (uuid 2fc1fa32-2bd3-4da2-987d-2d1acaa048e3))
  )
@@ -3245,6 +3355,15 @@
    (property "Checked" "Y" (id 5) (at 269.24 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 269.24 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 269.24 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 269.24 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid dc0d12e0-8ffa-4fdd-9b28-db4f8a5da7a8))
    (pin "2" (uuid d3532c7d-a86e-4361-ba76-af2b76e39912))
  )
@@ -3288,6 +3407,15 @@
    (property "Checked" "Y" (id 5) (at 182.88 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 182.88 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 182.88 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 182.88 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 47b2d71b-e235-42f1-828b-c7023aeec9ea))
    (pin "2" (uuid b51c4f4d-7150-44f1-bc6e-ac0259dfc865))
  )
@@ -3313,6 +3441,15 @@
    (property "Checked" "Y" (id 5) (at 210.82 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 210.82 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 210.82 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 210.82 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid d46f5cbe-2fa7-4a11-ab61-62e1bb71db26))
    (pin "2" (uuid 6751f218-2384-4861-9efe-d707faea70dd))
  )
@@ -3334,6 +3471,15 @@
    (property "Checked" "Y" (id 5) (at 154.94 176.53 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 154.94 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 154.94 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RMCF0402FT953R" (id 8) (at 154.94 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 7cc910f2-74fd-451b-bb1b-0a6c296c61e3))
    (pin "2" (uuid bcf6b6cb-d2d2-411f-b221-af728d1d11df))
  )
@@ -3362,6 +3508,15 @@
    (property "Checked" "Y" (id 6) (at 125.73 27.94 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 7) (at 125.73 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 8) (at 125.73 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "GRM155R60J106ME05J" (id 9) (at 125.73 27.94 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid db7e95b1-dce2-445a-aa08-5294ae36a194))
    (pin "2" (uuid 54aa8e25-acbe-4ef4-8b18-e83179f43ff1))
  )
@@ -3387,6 +3542,15 @@
    (property "Checked" "Y" (id 5) (at 182.88 107.95 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 182.88 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 182.88 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 182.88 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 1c6c0179-2f53-4366-9e1d-50fe662a9a7f))
    (pin "2" (uuid 49e20a68-b961-4f05-9966-a78a02545c8e))
  )
@@ -3408,6 +3572,15 @@
    (property "Checked" "Y" (id 5) (at 140.97 176.53 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any ~2.2V red LED is fine" (id 6) (at 140.97 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "LTST-C190KRKT" (id 7) (at 140.97 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0603" (id 8) (at 140.97 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 17bb024e-f4ea-4572-bdec-01014ec89aaa))
    (pin "2" (uuid 1c08a62f-4388-4a72-a5c0-7eb050521a80))
  )
@@ -3445,6 +3618,15 @@
    (property "Checked" "Y" (id 5) (at 128.27 176.53 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 128.27 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 128.27 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC1005J471CS" (id 8) (at 128.27 176.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 189e3a26-f141-4ece-bbe7-568436ea3ba1))
    (pin "2" (uuid ebe4e0d1-2708-4368-acbd-54ebbe5529d6))
  )
@@ -3470,6 +3652,15 @@
    (property "Checked" "Y" (id 5) (at 36.83 105.41 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 36.83 105.41 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 36.83 105.41 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "CR0402-FX-4752GLF" (id 8) (at 36.83 105.41 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid d58a7833-fa76-4cd8-8e45-85e8d4b1c178))
    (pin "2" (uuid c2f74e31-91e1-41dc-bd5c-9221879f24db))
  )
@@ -3495,6 +3686,15 @@
    (property "Checked" "Y" (id 5) (at 138.43 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 138.43 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 138.43 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 138.43 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid bce7ae27-baab-4204-b11a-3c3f781b87e0))
    (pin "2" (uuid 13b9607d-c3ef-495b-8916-1feeba3351f9))
  )
@@ -3516,6 +3716,15 @@
    (property "Checked" "Y" (id 5) (at 43.18 62.23 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 43.18 62.23 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 43.18 62.23 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-075R1L" (id 8) (at 43.18 62.23 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 85ea2a38-2023-42c8-94d0-f4a1def4e677))
    (pin "2" (uuid 52afdb4b-42cc-4670-b77e-18a3bc511d59))
  )
@@ -3537,6 +3746,12 @@
    (property "Checked" "Y" (id 5) (at 175.26 146.05 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 175.26 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 175.26 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 5d42c44e-7087-44c8-a462-56fda612a64e))
    (pin "2" (uuid b64604b9-aaa3-4f13-9f63-333ea99f4f56))
    (pin "3" (uuid 288f909e-e828-42ee-ab04-305b851c2c68))
@@ -3563,6 +3778,15 @@
    (property "Checked" "Y" (id 5) (at 123.19 107.95 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 123.19 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 123.19 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 123.19 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 4e1d2f63-4827-48a0-a981-e7a37e8d72a4))
    (pin "2" (uuid 233f75fa-26eb-4229-91d5-fbf071c3e180))
  )
@@ -3584,6 +3808,12 @@
    (property "Checked" "Y" (id 5) (at 130.81 146.05 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 130.81 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 130.81 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 2272c07a-35eb-4430-9338-b7538e533640))
    (pin "2" (uuid 5f27e367-b20f-4fbe-8661-1ff6078005a9))
    (pin "3" (uuid 851b2d2e-1657-419a-a67d-c279a5d3a66a))
@@ -3606,6 +3836,12 @@
    (property "Checked" "Y" (id 5) (at 261.62 146.05 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 261.62 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 261.62 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 3d7473b2-ab58-4017-9b39-95ffd7534d9e))
    (pin "2" (uuid 8595ed0c-44c2-4ff7-86e0-e2063dd1279a))
    (pin "3" (uuid aa3c2566-9cc0-4852-b662-262802c8f297))
@@ -3632,6 +3868,9 @@
    (property "Checked" "Y" (id 5) (at 78.74 114.3 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "CP2102N-A02-GQFN24" (id 6) (at 78.74 114.3 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid bde9cef2-abc7-4dd2-a325-cb48af34c27d))
    (pin "10" (uuid 9ad59a44-764e-4b19-9263-48e5d3e8a34d))
    (pin "11" (uuid 6f57e41e-935c-412e-8528-53b4d2323afb))
@@ -3680,6 +3919,12 @@
    (property "Checked" "Y" (id 5) (at 130.81 113.03 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 130.81 113.03 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 130.81 113.03 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid ec2ddb13-e9de-4d5a-b51b-d5398375255c))
    (pin "2" (uuid b42bc5af-40cb-49b9-8d09-3665b7d3969b))
    (pin "3" (uuid 3b6d7996-cb03-421c-89b7-14690c1f4b89))
@@ -3706,6 +3951,12 @@
    (property "Checked" "Y" (id 5) (at 151.13 50.8 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "MMBT3904" (id 6) (at 151.13 50.8 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 151.13 50.8 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 57a408f2-57c2-4dc9-811b-e782f143a76b))
    (pin "2" (uuid d8bc005c-f336-42bc-9ffa-cceb89979220))
    (pin "3" (uuid d9393e0b-3985-4a11-9cf7-356ac501a5b0))
@@ -3732,6 +3983,12 @@
    (property "Checked" "Y" (id 5) (at 151.13 68.58 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "MMBT3904" (id 6) (at 151.13 68.58 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 151.13 68.58 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid a4af360a-d487-4e4b-b3ce-9eadb2f43da3))
    (pin "2" (uuid cbd70d14-8f74-4a9d-92b8-875e4d9948fd))
    (pin "3" (uuid c6022a70-2902-45f3-a485-e8145329140e))
@@ -3792,6 +4049,15 @@
    (property "Checked" "Y" (id 5) (at 262.89 34.29 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 6) (at 262.89 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 262.89 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "GRM155R60J106ME05J" (id 8) (at 262.89 34.29 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 7503b3de-7b57-442e-9fef-a51c91b1e2b1))
    (pin "2" (uuid f4b85731-ab42-4e1c-9318-44e89caa1ae9))
  )
@@ -3813,6 +4079,15 @@
    (property "Checked" "Y" (id 5) (at 139.7 68.58 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 139.7 68.58 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 139.7 68.58 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 139.7 68.58 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 4c06cd58-d4c2-4f4c-a9dc-505bba16552c))
    (pin "2" (uuid 7a7246a5-a1d7-4aa4-bcf2-2dc60135f706))
  )
@@ -3828,7 +4103,7 @@
    (property "Datasheet" "~" (id 3) (at 62.23 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
-    (property "MANUFACTURER" "Assmann WSW Components" (id 4) (at 62.23 179.07 0)
+    (property "MANUFACTURER" "Amphenol ICC (FCI)" (id 4) (at 62.23 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
    (property "STANDARD" "Manufacturer recommendations" (id 5) (at 62.23 179.07 0)
@@ -3840,7 +4115,13 @@
    (property "PARTREV" "00" (id 7) (at 62.23 179.07 0)
      (effects (font (size 1.27 1.27)) (justify left bottom) hide)
    )
-    (property "Purchase" "https://www.digikey.com/en/products/detail/assmann-wsw-components/A-2004-2-4-LPS-N-R/2183638" (id 8) (at 62.23 179.07 0)
+    (property "Purchase" "https://www.digikey.com/en/products/detail/amphenol-cs-fci/54601-708LF/7589419" (id 8) (at 62.23 179.07 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "54601-708LF" (id 9) (at 62.23 179.07 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "LCSC" "C708595" (id 10) (at 62.23 179.07 0)
      (effects (font (size 1.27 1.27)) hide)
    )
    (pin "1" (uuid c2ffc237-b303-4544-ab28-a2edf18079b9))
@@ -3922,6 +4203,12 @@
    (property "Checked" "Y" (id 5) (at 55.88 22.86 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "1N5817" (id 6) (at 55.88 22.86 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOD-323" (id 7) (at 55.88 22.86 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 68be96d3-78b6-49e4-aa62-c44a62b47baf))
    (pin "2" (uuid fa8d0421-4928-4296-ab78-480460b6ccc7))
  )
@@ -3943,6 +4230,12 @@
    (property "Checked" "Y" (id 5) (at 218.44 146.05 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "2N7002" (id 6) (at 218.44 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "SOT-23" (id 7) (at 218.44 146.05 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 06264656-bee2-46d8-b648-c3f4a1c4413d))
    (pin "2" (uuid 38e7dfbd-c748-48f3-893d-9e74a2c326dd))
    (pin "3" (uuid a5549d79-e8b3-453e-80a3-d067db088357))
@@ -3969,6 +4262,15 @@
    (property "Checked" "Y" (id 5) (at 167.64 107.95 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 167.64 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 167.64 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 167.64 107.95 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 5c7ad7dd-899c-436a-bf20-d5de14d40886))
    (pin "2" (uuid 511824e4-e319-4f80-88cc-7a41e7867067))
  )
@@ -4008,6 +4310,15 @@
    (property "Checked" "Y" (id 5) (at 86.36 71.12 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 6) (at 86.36 71.12 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 86.36 71.12 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "GRM155R60J106ME05J" (id 8) (at 86.36 71.12 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid fe63110a-ba3c-4f74-a06b-d63014a53257))
    (pin "2" (uuid 20b580ab-5a4e-4700-a230-cadf4271fe0d))
  )
@@ -4045,6 +4356,15 @@
    (property "Checked" "Y" (id 5) (at 43.18 69.85 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 43.18 69.85 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 43.18 69.85 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-075R1L" (id 8) (at 43.18 69.85 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid d549192a-7cc3-40e7-998b-4f2547c01345))
    (pin "2" (uuid 2bc985a1-1f42-44c6-94da-7a0764d09e09))
  )
@@ -4070,6 +4390,15 @@
    (property "Checked" "Y" (id 5) (at 123.19 140.97 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated resistor will work fine" (id 6) (at 123.19 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 123.19 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "RC0402JR-1310KL" (id 8) (at 123.19 140.97 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 21c0379d-a792-4e27-8a21-51be3b14892e))
    (pin "2" (uuid 7487cf90-1770-4ba7-a800-a8c0facee5fa))
  )
@@ -4095,6 +4424,15 @@
    (property "Checked" "Y" (id 5) (at 186.69 49.53 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "Comment" "Any 5V or higher rated capacitor will work fine" (id 6) (at 186.69 49.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "Package" "0402" (id 7) (at 186.69 49.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
+    (property "MPN" "0402W105K100HI" (id 8) (at 186.69 49.53 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid 5ee748ad-d720-4dcf-b44f-bf0a6b0b8608))
    (pin "2" (uuid 1b028c75-2c5a-4964-b41b-e442a08732b1))
  )
@@ -4184,6 +4522,9 @@
    (property "Checked" "Y" (id 5) (at 215.9 73.66 0)
      (effects (font (size 1.27 1.27)) hide)
    )
+    (property "MPN" "ESP32-WROOM-32" (id 6) (at 215.9 73.66 0)
+      (effects (font (size 1.27 1.27)) hide)
+    )
    (pin "1" (uuid a0b2c350-56f5-4ce7-b1c5-997ea25f283a))
    (pin "10" (uuid 70fbb85f-3163-4abc-9c0a-a891d94f22b1))
    (pin "11" (uuid f2a3a761-fa15-4eb1-b5a7-276510d87105))
--- a/test-firmware/.gitignore
+++ b/test-firmware/.gitignore
@@ -0,0 +1,5 @@
+.pio
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+.vscode/ipch
--- a/test-firmware/.vscode/extensions.json
+++ b/test-firmware/.vscode/extensions.json
@@ -0,0 +1,10 @@
+{
+    // See http://go.microsoft.com/fwlink/?LinkId=827846
+    // for the documentation about the extensions.json format
+    "recommendations": [
+        "platformio.platformio-ide"
+    ],
+    "unwantedRecommendations": [
+        "ms-vscode.cpptools-extension-pack"
+    ]
+}
--- a/test-firmware/README.md
+++ b/test-firmware/README.md
@@ -0,0 +1,13 @@
+# Test Firmware
+
+This firmware is used to test assembled boards before shipping. In the future I'd like this process to be more automated but this is what I have for now.
+
+## Usage
+
+You will need 2 desk controller boards for this.
+
+1. Flash the `test_host` env to a board. This will be the known-good "host" board that will report the test results.
+2. Flash the `test_target` env to the board you want to test. Unplug both from the computer.
+3. Connect the host board to the target board with an RJ45 patch cable.
+4. Plug the target board into power using micro USB. This will provide power to both boards since the +5V line is shared between them.
+5. The LED on the host board should flash a total of 6 times. If it doesn't, this means one of the pins is not connected correctly. Troubleshoot accordingly.
--- a/test-firmware/include/README
+++ b/test-firmware/include/README
@@ -0,0 +1,39 @@
+
+This directory is intended for project header files.
+
+A header file is a file containing C declarations and macro definitions
+to be shared between several project source files. You request the use of a
+header file in your project source file (C, C++, etc) located in `src` folder
+by including it, with the C preprocessing directive `#include'.
+
+```src/main.c
+
+#include "header.h"
+
+int main (void)
+{
+ ...
+}
+```
+
+Including a header file produces the same results as copying the header file
+into each source file that needs it. Such copying would be time-consuming
+and error-prone. With a header file, the related declarations appear
+in only one place. If they need to be changed, they can be changed in one
+place, and programs that include the header file will automatically use the
+new version when next recompiled. The header file eliminates the labor of
+finding and changing all the copies as well as the risk that a failure to
+find one copy will result in inconsistencies within a program.
+
+In C, the usual convention is to give header files names that end with `.h'.
+It is most portable to use only letters, digits, dashes, and underscores in
+header file names, and at most one dot.
+
+Read more about using header files in official GCC documentation:
+
+* Include Syntax
+* Include Operation
+* Once-Only Headers
+* Computed Includes
+
+https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html
--- a/test-firmware/lib/README
+++ b/test-firmware/lib/README
@@ -0,0 +1,46 @@
+
+This directory is intended for project specific (private) libraries.
+PlatformIO will compile them to static libraries and link into executable file.
+
+The source code of each library should be placed in a an own separate directory
+("lib/your_library_name/[here are source files]").
+
+For example, see a structure of the following two libraries `Foo` and `Bar`:
+
+|--lib
+|  |
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |  |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html
+|  |
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |
+|  |- README --> THIS FILE
+|
+|- platformio.ini
+|--src
+   |- main.c
+
+and a contents of `src/main.c`:
+```
+#include <Foo.h>
+#include <Bar.h>
+
+int main (void)
+{
+  ...
+}
+
+```
+
+PlatformIO Library Dependency Finder will find automatically dependent
+libraries scanning project source files.
+
+More information about PlatformIO Library Dependency Finder
+- https://docs.platformio.org/page/librarymanager/ldf.html
--- a/test-firmware/platformio.ini
+++ b/test-firmware/platformio.ini
@@ -0,0 +1,20 @@
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; https://docs.platformio.org/page/projectconf.html
+
+[env]
+platform = espressif32
+board = esp32dev
+framework = arduino
+
+[env:test_host]
+build_flags = -D TEST_HOST
+
+[env:test_target]
+build_flags = -D TEST_TARGET
--- a/test-firmware/src/main.cpp
+++ b/test-firmware/src/main.cpp
@@ -0,0 +1,68 @@
+#include <Arduino.h>
+
+#define LED_BUILTIN 23
+
+// These correspond to RJ45 pins 1-6
+int pins_to_test[] = {
+  18,
+  17,
+  16,
+  19,
+  21,
+  22
+};
+
+void setup() {
+  Serial.begin(9600);
+
+  pinMode(LED_BUILTIN, OUTPUT);
+  
+#ifdef TEST_HOST
+  Serial.println("Initializing test host...");
+
+  for (int &pin : pins_to_test) {
+    pinMode(pin, INPUT);
+  }
+
+  digitalWrite(LED_BUILTIN, HIGH);
+
+  delay(100);
+
+  for (int &pin : pins_to_test) {
+    Serial.print("Waiting for pin ");
+    Serial.print(pin);
+    Serial.println();
+
+    while (digitalRead(pin) == LOW) {
+      delay(50);
+    }
+
+    digitalWrite(LED_BUILTIN, LOW);
+    delay(100);
+    digitalWrite(LED_BUILTIN, HIGH);
+  }
+#else
+  digitalWrite(LED_BUILTIN, HIGH);
+
+  Serial.println("Initializing test target...");
+
+  for (int &pin : pins_to_test) {
+    pinMode(pin, OUTPUT);
+    digitalWrite(pin, LOW);
+  }
+#endif
+}
+
+void loop() {
+#ifdef TEST_TARGET
+  for (int &pin : pins_to_test) {
+    Serial.print("Pulsing pin ");
+    Serial.print(pin);
+    Serial.println();
+
+    digitalWrite(pin, HIGH);
+    delay(1000);
+    digitalWrite(pin, LOW);
+  }
+#endif
+}
--- a/test-firmware/test/README
+++ b/test-firmware/test/README
@@ -0,0 +1,11 @@
+
+This directory is intended for PlatformIO Unit Testing and project tests.
+
+Unit Testing is a software testing method by which individual units of
+source code, sets of one or more MCU program modules together with associated
+control data, usage procedures, and operating procedures, are tested to
+determine whether they are fit for use. Unit testing finds problems early
+in the development cycle.
+
+More information about PlatformIO Unit Testing:
+- https://docs.platformio.org/page/plus/unit-testing.html
Author	SHA1	Message	Date
TJ Horner	82cacc03d4	Firmware 0.2.0	2022-10-28 12:45:03 -07:00
TJ Horner	f555c2829f	Update README.md	2022-10-19 21:22:19 -07:00
TJ Horner	a6fa7a360c	Update firmware with new timeout	2022-10-11 09:08:03 -07:00
TJ Horner	8cfc39eb1f	Add test firmware and pcb changes	2022-09-30 20:25:52 -07:00
TJ Horner	ad485e9d5b	add support email to readme	2022-09-30 20:15:02 -07:00
TJ Horner	7b82f71386	Debug firmware	2022-09-30 19:45:45 -07:00
TJ Horner	66c7e07592	Fix #10	2022-09-19 11:56:21 -07:00
TJ Horner	849b4d8896	readme update	2022-08-30 09:01:01 -07:00
TJ Horner	347db97405	update readme	2022-08-29 12:03:33 -07:00
TJ Horner	b9e4a9cb33	Runtime configuration variables for firmware	2022-08-28 19:06:59 -07:00
TJ Horner	5538ed83b2	Copypasta error	2022-08-28 15:28:28 -07:00
TJ Horner	93a7adb0d8	Bump firmware to 0.0.3	2022-08-28 15:24:01 -07:00
TJ Horner	7539c3c8e3	Update GitHub Actions workflow to publish both firmware.bin and firmware-factory.bin	2022-08-28 15:22:35 -07:00