Merge pull request #798 from adafruit/as5600

As5600

.github/workflows/build-clang-doxy.yml

@@ -5,6 +5,11 @@ name: WipperSnapper Build CI
 
 on:
   workflow_dispatch:
+    inputs:
+      board:
+        description: 'Build ONLY this board (must match a matrix entry exactly, or leave empty for all)'
+        required: false
+        default: ''
   pull_request:
   workflow_call:
     secrets:
@@ -18,19 +23,52 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arduino-platform: ["funhouse_noota"]
+        arduino-platform:
-        include:
+          [
-          - offset: "0x1000"
+            "feather_esp32s2",
+            "feather_esp32s2_reverse_tft",
+            "feather_esp32s2_tft",
+            "funhouse_noota",
+            "magtag",
+            "metroesp32s2",
+            "qtpy_esp32s2",
+            "esp32s3_devkitc_1_n8",
+            "feather_esp32s3_4mbflash_2mbpsram",
+            "feather_esp32s3_reverse_tft",
+            "feather_esp32s3_tft",
+            "qtpy_esp32s3_n4r2",
+            "xiao_esp32s3",
+          ]
+
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          WS_VERSION="unknown"
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            WS_VERSION=$(git describe --dirty --tags)
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -45,7 +83,8 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet --branch 2.2.54 https://github.com/adafruit/SdFat.git /home/runner/Arduino/libraries/SdFat
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
           git clone --quiet https://github.com/adafruit/Adafruit_HX8357_Library.git /home/runner/Arduino/libraries/Adafruit_HX8357_Library
           git clone --quiet https://github.com/adafruit/Adafruit_ILI9341.git /home/runner/Arduino/libraries/Adafruit_ILI9341
@@ -104,6 +143,7 @@ jobs:
           mv examples/Wippersnapper_demo/build/*/Wippersnapper_demo.ino.elf wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.elf
           mv examples/Wippersnapper_demo/build/*/Wippersnapper_demo.ino.map wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.map
           mv examples/Wippersnapper_demo/build/*/Wippersnapper_demo.ino.bootloader.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.bootloader.bin
+          mv examples/Wippersnapper_demo/build/*/Wippersnapper_demo.ino.merged.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.merged_auto.bin
           mv examples/Wippersnapper_demo/build/*/Wippersnapper_demo.ino.partitions.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.partitions.bin
       - name: Get Board Flash Parameters
         id: get_board_json
@@ -119,6 +159,58 @@ jobs:
             echo $content
             echo EOF
           } >> "$GITHUB_OUTPUT"
+      - name: fetch tinyuf2 combined.bin
+        run: |
+          BOARD_NAME="${{fromJson(steps.get_board_json.outputs.boardJson).bootloaderBoardName}}"
+          set +e
+          for attempt in 1 2 3; do
+            echo "Attempt $attempt: Fetching tinyuf2 release info for board $BOARD_NAME"
+            API_RESPONSE=$(curl --silent --fail https://api.github.com/repos/adafruit/tinyuf2/releases/latest)
+            if [ $? -ne 0 ]; then
+              echo "Attempt $attempt: curl failed to fetch release info."
+              if [ "$attempt" -eq 3 ]; then exit 1; else sleep $((60 + RANDOM % 40)); continue; fi
+            fi
+            DOWNLOAD_URL=$(echo "$API_RESPONSE" | jq -r '.assets[] | select(.browser_download_url | contains("tinyuf2-'$BOARD_NAME'-") and endswith(".zip")) | .browser_download_url // empty'); JQ_EXIT=$?
+            if [ $JQ_EXIT -ne 0 ] || [ -z "$DOWNLOAD_URL" ]; then
+              echo "Attempt $attempt: jq failed or no matching zip found."
+              if [ "$attempt" -eq 3 ]; then exit 1; else sleep $((60 + RANDOM % 40)); continue; fi
+            fi
+            echo "Attempt $attempt: Downloading $DOWNLOAD_URL"
+            wget "$DOWNLOAD_URL" -O tinyuf2.zip
+            if [ $? -eq 0 ]; then
+              unzip -o tinyuf2.zip -d .
+              if [ $? -ne 0 ]; then
+                echo "Attempt $attempt: unzip failed"
+                if [ "$attempt" -eq 3 ]; then exit 1; else sleep $((60 + RANDOM % 40)); continue; fi
+              fi
+              break
+            else
+              echo "Attempt $attempt: wget failed to download $DOWNLOAD_URL"
+              if [ "$attempt" -eq 3 ]; then exit 1; else sleep $((60 + RANDOM % 40)); fi
+            fi
+          done
+          set -e
+      - name: move partition and bootloader files for tinyuf2 (to match flash_args)
+        run: |
+          # Copy files where they're expected to make flash_args happy
+          mkdir bootloader
+          cp bootloader.bin bootloader/bootloader.bin
+          mkdir partition_table
+          cp partition-table.bin partition_table/partition-table.bin
+
+      - name: Create new_flash_args file from flash_args with added app bin + output file
+        run: |
+          # Create new_flash_args with esptool parameters first and output file
+          echo "--flash-mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}}" > new_flash_args
+          echo "--flash-freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}}" >> new_flash_args
+          echo "--flash-size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}}" >> new_flash_args
+          echo "-o wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.combined.bin" >> new_flash_args
+
+          # Append flash_args content to new_flash_args, skipping the first line
+          tail -n +2 flash_args >> new_flash_args
+
+          # Append main app to flash_args file
+          echo "0x10000 wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.bin" >> new_flash_args
       - name: Check boot_app0 file existence (esp32sx built from core, not-source)
         id: check_files
         uses: andstor/file-existence-action@v3
@@ -134,23 +226,17 @@ jobs:
           ls /home/runner/Arduino/hardware/espressif/esp32/tools/partitions
       - name: boot_app0 file from arduino-cli core
         if: steps.check_files.outputs.files_exists == 'true'
-        run: mv /home/runner/.arduino15/packages/esp32/hardware/esp32/*/tools/partitions/boot_app0.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin
+        run: cp /home/runner/.arduino15/packages/esp32/hardware/esp32/*/tools/partitions/boot_app0.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin
       - name: boot_app0 file from esp32 source bsp
         if: steps.check_files.outputs.files_exists == 'false'
-        run: mv /home/runner/Arduino/hardware/espressif/esp32/tools/partitions/boot_app0.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin
+        run: cp /home/runner/Arduino/hardware/espressif/esp32/tools/partitions/boot_app0.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin
-      - name: Create combined binary using Esptool merge_bin
+      - name: Copy boot_app0 file to ota_data_initial.bin (overwrite tinyuf2 boot preference)
+        run: cp wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin ota_data_initial.bin
+      - name: Create combined binary using Esptool merge-bin
         run: |
           echo ${{ steps.get_board_json.outputs.boardJson }}
           echo ${{ fromJson(steps.get_board_json.outputs.boardJson) }}
-          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge_bin \
+          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge-bin @new_flash_args
-            --flash_mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}} \
-            --flash_freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}} \
-            --flash_size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}} \
-            -o wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.combined.bin \
-            ${{ matrix.offset }} wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.bootloader.bin \
-            0x8000 wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.partitions.bin \
-            0xe000 wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin \
-            0x10000 wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.bin
       - name: Zip build artifacts
         run: |
           zip -r wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.zip wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.*
@@ -178,30 +264,36 @@ jobs:
       matrix:
         arduino-platform:
           [
-            "magtag",
-            "metroesp32s2",
             "metro_esp32s3",
-            "feather_esp32s2",
-            "feather_esp32s2_tft",
-            "feather_esp32s2_reverse_tft",
             "feather_esp32s3",
-            "feather_esp32s3_4mbflash_2mbpsram",
-            "feather_esp32s3_tft",
             "qtpy_esp32s3",
-            "qtpy_esp32s2",
-            "feather_esp32s3_reverse_tft",
-            "qtpy_esp32s3_n4r2",
           ]
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -211,7 +303,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
           git clone --quiet https://github.com/adafruit/Adafruit_HX8357_Library.git /home/runner/Arduino/libraries/Adafruit_HX8357_Library
           git clone --quiet https://github.com/adafruit/Adafruit_ILI9341.git /home/runner/Arduino/libraries/Adafruit_ILI9341
@@ -284,27 +376,48 @@ jobs:
           [
             "wippersnapper_feather_esp32",
             "qtpy_esp32",
+            "sparklemotionmini_esp32",
+            "sparklemotionstick_esp32",
             "feather_esp32_v2",
             "itsybitsy_esp32",
+            "dfrobot_beetle_esp32c3",
             "wippersnapper_qtpy_esp32c3",
             "wippersnapper_feather_esp32c6"
           ]
         include:
           - offset: "0x1000"
+          - offset: "0x0"
+            arduino-platform: "dfrobot_beetle_esp32c3"
           - offset: "0x0"
             arduino-platform: "wippersnapper_qtpy_esp32c3"
           - offset: "0x0"
             arduino-platform: "wippersnapper_feather_esp32c6"
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -319,7 +432,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
       - name: Download stable Nanopb
         id: download-nanopb
@@ -352,7 +465,7 @@ jobs:
           mv nanopb/pb.h src/nanopb/nanopb.pb.h
       - name: Install Dependencies
         run: |
-          pip install esptool==4.6
+          pip install esptool
       - name: build ESP32 platforms
         run: python3 ci/build_platform.py ${{ matrix.arduino-platform }} --build_timeout 48000
       - name: Check artifacts
@@ -390,14 +503,14 @@ jobs:
             echo $content
             echo EOF
           } >> "$GITHUB_OUTPUT"
-      - name: Create combined binary using Esptool merge_bin
+      - name: Create combined binary using Esptool merge-bin
         run: |
           echo ${{ steps.get_board_json.outputs.boardJson }}
           echo ${{ fromJson(steps.get_board_json.outputs.boardJson) }}
-          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge_bin \
+          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge-bin \
-            --flash_mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}} \
+            --flash-mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}} \
-            --flash_freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}} \
+            --flash-freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}} \
-            --flash_size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}} \
+            --flash-size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}} \
             -o wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.combined.bin \
             ${{ matrix.offset }} wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.bootloader.bin \
             0x8000 wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.partitions.bin \
@@ -426,15 +539,31 @@ jobs:
             "metro_m4_airliftlite_tinyusb",
           ]
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -446,8 +575,8 @@ jobs:
       - name: Install extra Arduino libraries
         run: |
           git clone --quiet https://github.com/adafruit/WiFiNINA.git /home/runner/Arduino/libraries/WiFiNINA
-          git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet https://github.com/PaulStoffregen/OneWire.git /home/runner/Arduino/libraries/OneWire
           git clone --quiet https://github.com/adafruit/Adafruit_TinyUSB_Arduino /home/runner/Arduino/libraries/Adafruit_TinyUSB_Arduino
       - name: Download stable Nanopb
         id: download-nanopb
@@ -498,17 +627,33 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arduino-platform: ["picow_rp2040_tinyusb", "picow_rp2350_tinyusb"]
+        arduino-platform: ["picow_rp2040_tinyusb", "picow_rp2350_tinyusb", "fruit_jam_tinyusb"]
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -521,7 +666,6 @@ jobs:
         run: |
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
           git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
-          git clone --quiet https://github.com/brentru/Adafruit_SPIFlash.git /home/runner/Arduino/libraries/Adafruit_SPIFlash
           git clone --quiet https://github.com/adafruit/Adafruit_TinyUSB_Arduino /home/runner/Arduino/libraries/Adafruit_TinyUSB_Arduino
       - name: Download stable Nanopb
         id: download-nanopb
@@ -572,15 +716,31 @@ jobs:
       matrix:
         arduino-platform: ["feather_esp8266"]
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -590,8 +750,8 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino library
         run: |
-          git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet https://github.com/PaulStoffregen/OneWire.git /home/runner/Arduino/libraries/OneWire
       - name: Download stable Nanopb
         id: download-nanopb
         continue-on-error: true
@@ -650,6 +810,7 @@ jobs:
       matrix:
         arduino-platform:
           [
+            "esp32s3_devkitc_1_n8_debug",
             "feather_esp32s2_debug",
             "feather_esp32s2_tft_debug",
             "feather_esp32s3_debug",
@@ -660,15 +821,31 @@ jobs:
             "metro_esp32s3_debug",
           ]
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -678,7 +855,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
           git clone --quiet https://github.com/adafruit/Adafruit_HX8357_Library.git /home/runner/Arduino/libraries/Adafruit_HX8357_Library
           git clone --quiet https://github.com/adafruit/Adafruit_ILI9341.git /home/runner/Arduino/libraries/Adafruit_ILI9341
@@ -756,15 +933,31 @@ jobs:
           - offset: "0x0"
             arduino-platform: "wippersnapper_feather_esp32c6_debug"
     steps:
+      - name: "skip if unwanted"
+        continue-on-error: true
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.board != '' &&
+          matrix.arduino-platform != github.event.inputs.board
+        run: |
+          echo "don't build this one!"; exit 1
       - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - uses: actions/checkout@v4
       - name: Get WipperSnapper version
         run: |
-          git fetch --prune --unshallow --tags
+          git remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git describe --dirty --tags
+          git fetch --prune --unshallow --all --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          if git describe --dirty --tags >/dev/null 2>&1; then
+            echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
+          else
+            # Fallback for forks: 1.0.0-{owner}-{short-sha}
+            REPO_OWNER=$(echo $GITHUB_REPOSITORY | cut -d'/' -f1)
+            SHORT_SHA=$(git rev-parse --short HEAD)
+            echo >>$GITHUB_ENV WS_VERSION="1.0.0-${REPO_OWNER}-${SHORT_SHA}"
+          fi
+          echo "WS_VERSION: $WS_VERSION"
       - uses: actions/checkout@v4
         with:
           repository: adafruit/ci-arduino
@@ -779,7 +972,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
+          git clone --quiet --branch v4.0.3 https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
           git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
       - name: Download stable Nanopb
         id: download-nanopb
@@ -852,14 +1045,14 @@ jobs:
             echo $content
             echo EOF
           } >> "$GITHUB_OUTPUT"
-      - name: Create combined binary using Esptool merge_bin
+      - name: Create combined binary using Esptool merge-bin
         run: |
           echo ${{ steps.get_board_json.outputs.boardJson }}
           echo ${{ fromJson(steps.get_board_json.outputs.boardJson) }}
-          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge_bin \
+          python3 -m esptool --chip ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.chip}} merge-bin \
-            --flash_mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}} \
+            --flash-mode ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashMode}} \
-            --flash_freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}} \
+            --flash-freq ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashFreq}} \
-            --flash_size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}} \
+            --flash-size ${{fromJson(steps.get_board_json.outputs.boardJson).esptool.flashSize}} \
             -o wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.combined.bin \
             ${{ matrix.offset }} wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.bootloader.bin \
             0x8000 wippersnapper.${{ matrix.arduino-platform }}.littlefs.${{ env.WS_VERSION }}.partitions.bin \
@@ -927,10 +1120,10 @@ jobs:
         run: bash ci/actions_install.sh
 
       - name: clang
-        run: python3 ci/run-clang-format.py -r -e "ci/*" -e "bin/*" -e src/nanopb -e src/protos -e src/wippersnapper -e src/pb.h -e src/provisioning/tinyusb  src/
+        run: python3 ci/run-clang-format.py -r -e "ci/*" -e "bin/*" -e src/nanopb -e src/wippersnapper -e src/pb.h -e src/provisioning/tinyusb  src/
 
       - name: doxygen
         env:
           GH_REPO_TOKEN: ${{ secrets.GH_REPO_TOKEN }}
           PRETTYNAME: "Adafruit.io WipperSnapper Library"
-        run: bash ci/doxy_gen_and_deploy.sh
+        run: bash ci/doxy_gen_and_deploy.sh

.github/workflows/release-callee.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022-2024
+# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022
 #
 # SPDX-License-Identifier: MIT
 name: WipperSnapper Release Callee
@@ -12,16 +12,16 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Download build artifacts from build-platform steps
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v4
         with:
-          name: build-files
+          path: .
       - name: List Files
         run: ls
       - name: Upload Assets to the GitHub Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         if: startsWith(github.ref, 'refs/tags/')
         with:
           files: |
-                  wippersnapper.*.uf2
+                  build-files/wippersnapper.*.uf2
-                  wippersnapper.*.bin
+                  build-files/wippersnapper.*.bin
-                  wippersnapper.*.zip
+                  build-files/wippersnapper.*.zip

.github/workflows/release-caller.yml

@@ -1,37 +1,21 @@
-# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022-2025
+# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022
 #
 # SPDX-License-Identifier: MIT
 name: WipperSnapper Release Workflow
+
 on:
   release:
     types: [published]
-  workflow_call:
     secrets:
       GH_REPO_TOKEN:
         required: true
-jobs:
-  check-branch:
-    runs-on: ubuntu-latest
-    outputs:
-      should_run: ${{ steps.check.outputs.should_run }}
-    steps:
-      - id: check
-        run: |
-          if [[ $GITHUB_REF == *"offline-mode"* ]]; then
-            echo "should_run=false" >> $GITHUB_OUTPUT
-          else
-            echo "should_run=true" >> $GITHUB_OUTPUT
-          fi
-        shell: bash
 
+jobs:
   call-workflow-build:
-    needs: check-branch
-    if: needs.check-branch.outputs.should_run == 'true'
     uses: adafruit/Adafruit_Wippersnapper_Arduino/.github/workflows/build-clang-doxy.yml@main
     secrets:
       GH_REPO_TOKEN: ${{ secrets.GH_REPO_TOKEN }}
-      
+
   call-workflow-release:
-    needs: [check-branch, call-workflow-build]
+    needs: call-workflow-build
-    if: needs.check-branch.outputs.should_run == 'true'
+    uses: adafruit/Adafruit_Wippersnapper_Arduino/.github/workflows/release-callee.yml@main
-    uses: adafruit/Adafruit_Wippersnapper_Arduino/.github/workflows/release-callee.yml@main

.github/workflows/release-offline.yml

@@ -1,287 +0,0 @@
-# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2025
-#
-# SPDX-License-Identifier: MIT
-name: WipperSnapper Release Workflow for "Offline Mode" Alpha Feature
-on:
-    push:
-      branches:
-        - offline-mode
-    release:
-      types: [published]
-      branches:
-        - offline-mode
-    workflow_call:
-      secrets:
-        GH_REPO_TOKEN:
-          required: true
-
-jobs:
-  clang:
-    name: 🔎 Clang
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.x"
-      - uses: actions/checkout@v4
-
-      - uses: actions/checkout@v4
-        with:
-          repository: adafruit/ci-arduino
-          ref: ci-wippersnapper
-          path: ci
-      - name: pre-install
-        run: bash ci/actions_install.sh
-      - name: clang
-        run: python3 ci/run-clang-format.py -r -e "ci/*" -e "bin/*" -e src/nanopb -e src/protos -e src/pb.h -e src/provisioning/tinyusb src/
-
-  test-offline-mode:
-    name: 🧪 Test Offline Mode
-    runs-on: ubuntu-latest
-    needs: clang
-    steps:
-      - name: Check out repository code
-        uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.13'
-      - name: Install Python dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r tests/requirements.txt
-      - name: Install Wokwi CI Server
-        uses: wokwi/wokwi-ci-server-action@v1
-      - name: Install Wokwi CLI
-        run: curl -L https://wokwi.com/ci/install.sh | sh
-      - name: Install PIO Libraries for esp32dev target
-        run: pio pkg install --environment=esp32dev
-      - name: Build PlatformIO Project
-        run: platformio run --environment esp32dev
-      - name: Move new build file to test folder
-        run: cp .pio/build/esp32dev/firmware.elf tests/bin/offline/firmware.elf
-      - name: Run Wokwi Tests
-        run: pytest tests/test_offline.py --junitxml=report.xml -v
-        env:
-          WOKWI_CLI_TOKEN: ${{ secrets.WOKWI_CLI_TOKEN }}
-      - name: Publish Wokwi Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          files: |
-            /home/runner/work/Adafruit_Wippersnapper_Arduino/Adafruit_Wippersnapper_Arduino/report.xml
-
-  build-esp32sx:
-    name: 🏗️ ESP32-Sx
-    runs-on: ubuntu-latest
-    needs: [clang]
-    strategy:
-      fail-fast: false
-      matrix:
-        arduino-platform:
-          [
-            "metroesp32s2",
-            "metro_esp32s3",
-            "feather_esp32s2",
-            "feather_esp32s2_tft",
-            "feather_esp32s2_reverse_tft",
-            "feather_esp32s3",
-            "feather_esp32s3_4mbflash_2mbpsram",
-            "feather_esp32s3_tft",
-            "qtpy_esp32s3",
-            "qtpy_esp32s2",
-            "feather_esp32s3_reverse_tft",
-            "qtpy_esp32s3_n4r2",
-          ]
-    steps:
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.x"
-      - uses: actions/checkout@v4
-      - name: Get WipperSnapper version
-        run: |
-          git fetch --prune --unshallow --tags
-          git describe --dirty --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
-      - uses: actions/checkout@v4
-        with:
-          repository: adafruit/ci-arduino
-          ref: ci-wippersnapper
-          path: ci
-      - name: Install CI-Arduino
-        run: bash ci/actions_install.sh
-      - name: Install extra Arduino libraries
-        run: |
-          git clone --quiet https://github.com/milesburton/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
-          git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
-          git clone --quiet https://github.com/adafruit/Adafruit_HX8357_Library.git /home/runner/Arduino/libraries/Adafruit_HX8357_Library
-          git clone --quiet https://github.com/adafruit/Adafruit_ILI9341.git /home/runner/Arduino/libraries/Adafruit_ILI9341
-          git clone --quiet https://github.com/adafruit/Adafruit_STMPE610.git /home/runner/Arduino/libraries/Adafruit_STMPE610
-          git clone --quiet https://github.com/adafruit/Adafruit-ST7735-Library.git /home/runner/Arduino/libraries/Adafruit-ST7735-Library
-          git clone --quiet https://github.com/adafruit/Adafruit_TouchScreen.git /home/runner/Arduino/libraries/Adafruit_TouchScreen
-          git clone --quiet https://github.com/adafruit/Adafruit_TinyUSB_Arduino /home/runner/Arduino/libraries/Adafruit_TinyUSB_Arduino
-          git clone --depth 1 --branch wippersnapper https://github.com/brentru/lvgl.git /home/runner/Arduino/libraries/lvgl
-          git clone --depth 1 --branch development https://github.com/brentru/Adafruit_LvGL_Glue.git /home/runner/Arduino/libraries/Adafruit_LittlevGL_Glue_Library
-      - name: Download stable Nanopb
-        id: download-nanopb
-        continue-on-error: true
-        run: |
-          wget https://jpa.kapsi.fi/nanopb/download/nanopb-0.4.8.tar.gz
-      - if: ${{ failure() || steps.download-nanopb.outcome != 'success' }}
-        name: Restore cached nanopb
-        id: cache-nanopb-restore
-        uses: actions/cache/restore@v4
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: ./nanopb-0.4.8.tar.gz
-          key: nanopb-0.4.8.tar.gz
-      - if: ${{ steps.download-nanopb.outcome == 'success' }}
-        name: Save nanopb to cache
-        id: cache-nanopb-save
-        uses: actions/cache/save@v4
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: ./nanopb-0.4.8.tar.gz
-          key: nanopb-0.4.8.tar.gz
-      - name: Install stable Nanopb
-        run: |
-          tar -xf nanopb-0.4.8.tar.gz
-          # Copy files to WipperSnapper's src/nanopb directory
-          cp nanopb/pb_common.* nanopb/pb_encode.* nanopb/pb_decode.* src/nanopb
-          mv nanopb/pb.h src/nanopb/nanopb.pb.h
-      - name: List all files in Adafruit_LittlevGL_Glue_Library folder
-        run: |
-          ls /home/runner/Arduino/libraries/Adafruit_LittlevGL_Glue_Library
-      - name: Copy lv_conf.h file in Adafruit_LittlevGL_Glue_Library to the arduino library folder
-        run: |
-          cp /home/runner/Arduino/libraries/Adafruit_LittlevGL_Glue_Library/lv_conf.h /home/runner/Arduino/libraries
-      - name: Build for ESP32-SX
-        run: |
-          python3 ci/build_platform.py ${{ matrix.arduino-platform }} --build_timeout 48000
-      - name: list files (tree)
-        run: |
-          tree
-      - name: Rename build artifacts to reflect the platform name
-        run: |
-          mv examples/*/build/*/Wippersnapper_demo.ino.uf2 wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.uf2
-          mv examples/*/build/*/Wippersnapper_demo.ino.bin wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.bin
-      - name: upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-files-${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}
-          path: |
-            wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.uf2
-            wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.bin
-
-  build-rp2040:
-    name: 🏗️ RP2040, RP2350
-    runs-on: ubuntu-latest
-    needs: [clang]
-    strategy:
-      fail-fast: false
-      matrix:
-        arduino-platform: ["pico_rp2040_tinyusb",
-                           "pico_rp2350_tinyusb",
-                           "feather_rp2040_adalogger_tinyusb",
-                           "metro_rp2350_tinyusb"
-                           ]
-    steps:
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.x"
-      - uses: actions/checkout@v4
-      - name: Get WipperSnapper version
-        run: |
-          git fetch --prune --unshallow --tags
-          git describe --dirty --tags
-          echo >>$GITHUB_ENV WS_VERSION=$(git describe --dirty --tags)
-      - uses: actions/checkout@v4
-        with:
-          repository: adafruit/ci-arduino
-          ref: ci-wippersnapper
-          path: ci
-      - name: Install CI-Arduino
-        run: bash ci/actions_install.sh
-        # manually install OneWireNG/TempControlLib for OneWireNg (RP2040 Supported OneWire w/backwards compat.)
-      - name: Install extra Arduino libraries
-        run: |
-          git clone --quiet https://github.com/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
-          git clone --quiet https://github.com/pstolarz/Arduino-Temperature-Control-Library.git /home/runner/Arduino/libraries/Arduino-Temperature-Control-Library
-          git clone --quiet https://github.com/adafruit/Adafruit_TinyUSB_Arduino /home/runner/Arduino/libraries/Adafruit_TinyUSB_Arduino
-          git clone --quiet --branch fix-for-pico https://github.com/brentru/SdFat.git /home/runner/Arduino/libraries/SdFat_-_Adafruit_Fork/
-      - name: Download stable Nanopb
-        id: download-nanopb
-        continue-on-error: true
-        run: |
-          wget https://jpa.kapsi.fi/nanopb/download/nanopb-0.4.8.tar.gz
-      - if: ${{ failure() || steps.download-nanopb.outcome != 'success' }}
-        name: Restore cached nanopb
-        id: cache-nanopb-restore
-        uses: actions/cache/restore@v4
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: ./nanopb-0.4.8.tar.gz
-          key: nanopb-0.4.8.tar.gz
-      - if: ${{ steps.download-nanopb.outcome == 'success' }}
-        name: Save nanopb to cache
-        id: cache-nanopb-save
-        uses: actions/cache/save@v4
-        env:
-          cache-name: cache-node-modules
-        with:
-          path: ./nanopb-0.4.8.tar.gz
-          key: nanopb-0.4.8.tar.gz
-      - name: Install stable Nanopb
-        run: |
-          tar -xf nanopb-0.4.8.tar.gz
-          # Copy files to WipperSnapper's src/nanopb directory
-          cp nanopb/pb_common.* nanopb/pb_encode.* nanopb/pb_decode.* src/nanopb
-          mv nanopb/pb.h src/nanopb/nanopb.pb.h
-      - name: build RP2040 platforms
-        run: python3 ci/build_platform.py ${{ matrix.arduino-platform }} --build_timeout 48000
-      - name: Rename build artifacts to reflect the platform name
-        run: |
-          mv examples/*/build/*/Wippersnapper_demo_offline.ino.uf2 wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.uf2
-      - name: upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-files-${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}
-          path: |
-            wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.uf2
-
-  merge-job-build-files:
-    name: Merge Artifacts for build-files
-    runs-on: ubuntu-latest
-    needs: [build-esp32sx, build-rp2040]
-    steps:
-      - name: Merge Artifacts from Builds
-        uses: actions/upload-artifact/merge@v4
-        with:
-          name: build-files
-          pattern: build-files-!(dev)-*
-          delete-merged: true
-
-
-  release-wippersnapper:
-    name: 🚀 Upload Release Files
-    runs-on: ubuntu-latest
-    needs: merge-job-build-files
-    if: github.event_name == 'release' && startsWith(github.ref, 'refs/tags/')
-    steps:
-      - name: Download build artifacts from build-platform steps
-        uses: actions/download-artifact@v4
-        with:
-          name: build-files
-      - name: List Files
-        run: ls
-      - name: Upload Assets to the GitHub Release
-        uses: softprops/action-gh-release@v1
-        if: startsWith(github.ref, 'refs/tags/')
-        with:
-          files: |
-                  wippersnapper.*.uf2
-                  wippersnapper.*.bin
-                  wippersnapper.*.zip

.gitignore

@@ -39,30 +39,17 @@ html/*
 # VSCode artifacts
 .vscode/*
 src/.vscode/settings.json
+
 .DS_STORE
+
 examples/Wippersnapper_demo/build/
 
-# Virtual environment directories
-.venv/
-venv/
-
-# Python artifacts
-tests/__pycache__/
-
 # Platformio artifacts
 .pio/
 
-# These sometimes contain credentials, don't commit them!
+# Secrets
-src/Wippersnapper_demo_wokwi.ino
 data/
-examples/Wippersnapper_demo_offline/.theia/
-examples/Wippersnapper_demo_offline/.vscode/
-examples/Wippersnapper_demo_offline/build/
 
-# Test results
+# Misc. Data
-report.xml
+tests/
-
+venv/
-# VSCode settings
-.vscode/settings.json
-
-CLAUDE.md

.vscode/settings.json

@@ -1,23 +1,11 @@
 {
     "files.associations": {
         "limits": "c",
-        "type_traits": "c",
+        "type_traits": "c"
-        "vector": "cpp",
-        "array": "cpp",
-        "deque": "cpp",
-        "string": "cpp",
-        "unordered_map": "cpp",
-        "string_view": "cpp",
-        "initializer_list": "cpp",
-        "span": "cpp",
-        "*.tcc": "cpp",
-        "list": "cpp",
-        "unordered_set": "cpp",
-        "format": "cpp",
-        "text_encoding": "cpp",
-        "regex": "cpp"
     },
-    "C_Cpp.dimInactiveRegions": false,
+    "C_Cpp.dimInactiveRegions": true,
     "dotnet.defaultSolution": "disable",
-    "cmake.configureOnOpen": false
+    "cmake.configureOnOpen": false,
+    "C_Cpp.clang_format_fallbackStyle": "Google",
+    "C_Cpp.clang_format_style": "file"
 }

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2024 Adafruit Industries
+Copyright (c) 2020-2021 Adafruit Industries
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -5,26 +5,25 @@
 # Adafruit WipperSnapper
 ![Build CI](https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/actions/workflows/build-clang-doxy.yml/badge.svg)[![Documentation](https://github.com/adafruit/ci-arduino/blob/master/assets/doxygen_badge.svg)](http://adafruit.github.io/Adafruit_Wippersnapper_Arduino/html/index.html)
 
-Adafruit.io WipperSnapper is a firmware designed to turn any Wi-Fi capable board into an Internet-of-Things (IoT) device. No code required!
+Adafruit.io WipperSnapper is a firmware designed to turn any Wi-Fi-capable board into an Internet-of-Things (IoT) device. No programming is required!
 
-WipperSnapper works with [multiple microcontroller architectures](https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/?tab=readme-ov-file#supported-platforms) and development boards. It is designed to be easily extensible to support new sensors, inputs, and outputs.
+WipperSnapper works with multiple microcontroller architectures such as ESP8266, ESP32, ESP32-Sx, ESP32-Cx, RP2040, RP2350, and ATSAMD51.
 
-A **free** [Adafruit IO](https://io.adafruit.com) account is required to use WipperSnapper.
+You will need a **free** [Adafruit IO](https://io.adafruit.com) account to use WipperSnapper.
+
+**NOTE: WipperSnapper firmware is in beta** and is actively being developed. Please [report bugs via the issues page on this repository](https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=). 
 
 # Get Started
 [Learn how to install and use WipperSnapper by following this guide on the Adafruit Learning System - QuickStart: Adafruit IO WipperSnapper](https://learn.adafruit.com/quickstart-adafruit-io-wippersnapper).
 
-
-## Get WipperSnapper
-Pre-compiled binaries and UF2 files for supported hardware are provided on the [releases page](https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/releases) of this repository.
-
 ## Supported Platforms
 
 |Platform| MCU(s) |
 |--|--|
-|[ESP32-x](https://github.com/espressif/arduino-esp32)| ESP32, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6 |
+|[ESP32-x](https://github.com/espressif/arduino-esp32)| ESP32, ESP32-Sx, ESP32-C3 |
 |[ESP8266](https://github.com/esp8266/Arduino)| ESP8266 |
 |[RP2040](https://github.com/earlephilhower/arduino-pico)| RP2040 MCU w/WiFi (i.e: Pico W) |
+|[RP2350](https://github.com/earlephilhower/arduino-pico)| RP2350 MCU w/WiFi (i.e: Pico 2W) |
 |[ATSAMD](https://github.com/adafruit/ArduinoCore-samd/)|  SAMD51 MCU w/separate WiFi Co-Processor (i.e: Adafruit "AirLift")|
 
 ## Contributing to Adafruit.io and WipperSnapper

config.json

@@ -1 +0,0 @@
-{"exportVersion": "1.0.0", "exportedBy": "tester", "exportedAt": "2024-10-28T18:58:23.976Z", "exportedFromDevice": {"board": "metroesp32s3", "firmwareVersion": "1.0.0-beta.93", "referenceVoltage": 2.6, "totalGPIOPins": 11, "totalAnalogPins": 6, "rtc": "DS3231", "statusLEDBrightness": 0.1}, "components": [{"componentAPI": "analogio", "name": "Analog Pin", "pinName": "A0", "type": "analog_pin", "mode": "ANALOG", "direction": "INPUT", "sampleMode": "TIMER", "analogReadMode": "PIN_VALUE", "period": 30}, {"componentAPI": "ds18x20", "name": "DS18B20: Temperature Sensor (\u00b0F)", "sensorTypeCount": 2, "sensorType1": "object-temp-fahrenheit", "sensorType2": "object-temp", "pinName": "D4", "sensorResolution": 12, "period": 30}], "checksum": 236}

data.json

@@ -1 +0,0 @@
-{"exportVersion": "1.0.0", "exportedBy": "wokwi", "exportedAt": "2024-10-28T18:58:23.976Z", "exportedFromDevice": {"board": "metroesp32s3", "firmwareVersion": "1.0.0-beta.93", "referenceVoltage": 2.6, "totalGPIOPins": 11, "totalAnalogPins": 6}, "components": [{"componentAPI": "digitalio", "name": "Button (D4)", "pinName": "D4", "type": "push_button", "mode": "DIGITAL", "sampleMode": "TIMER", "direction": "INPUT", "period": 5, "pull": "UP", "isPin": true}]}

examples/Wippersnapper_NoFS/.feather_esp32s2_tft_debug.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.feather_esp32s3_tft.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.feather_esp32s3_tft_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.feather_esp8266.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.feather_rp2040_adalogger_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.feather_s2_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.funhouse.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.funhouse_noota.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.itsybitsy_esp32.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.magtag.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.metro_esp32s3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.metro_esp32s3_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.metro_m4_airliftlite_tinyusb.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.metro_rp2350_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.metroesp32s2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.metroesp32s2_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_NoFS/.pico_rp2040_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.pico_rp2350_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.picow_rp2040_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.picow_rp2350_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.qtpy_esp32.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.qtpy_esp32c3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.qtpy_esp32s2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.qtpy_esp32s3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.qtpy_esp32s3_n4r2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32c6_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32s3_reverse_tft_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/.wippersnapper_qtpy_esp32c3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_NoFS/Wippersnapper_NoFS.ino

@@ -1,40 +0,0 @@
-// Adafruit IO WipperSnapper
-//
-// This sketch is for devices which lack USB-MSD or LittleFS support such
-// as the ESP32Dev for Wokwi Simulator
-//
-// Adafruit invests time and resources providing this open source code.
-// Please support Adafruit and open source hardware by purchasing
-// products from Adafruit!
-//
-// Brent Rubell for Adafruit Industries, 2025
-//
-// All text above must be included in any redistribution.
-
-#include "ws_adapters.h"
-#define WS_DEBUG // Enable debug output
-/************************ Adafruit IO Config *******************************/
-
-// Visit io.adafruit.com if you need to create an account,
-// or if you need your Adafruit IO key.
-#define IO_USERNAME "YOUR_AIO_USERNAME"
-#define IO_KEY "YOUR_AIO_KEY"
-#define IO_URL "io.adafruit.com"
-#define IO_PORT 8883
-/**************************** WiFi Config ***********************************/
-#define WIFI_SSID "YOUR_WIFI_SSID"
-#define WIFI_PASS "YOUR_WIFI_PASSWORD"
-
-ws_adapter_wifi wipper(IO_USERNAME, IO_KEY, WIFI_SSID, WIFI_PASS, IO_URL, IO_PORT);
-
-void setup() {
-  // Provisioning must occur prior to serial init.
-  wipper.provision();
-
-  Serial.begin(115200);
-  // while (!Serial) delay(10);
-
-  wipper.connect();
-}
-
-void loop() { wipper.run(); }

examples/Wippersnapper_demo/.feather_rp2040_adalogger_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.metro_rp2350_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.pico_rp2040_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.pico_rp2350_tinyusb.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.picow_rp2040_tinyusb.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.picow_rp2350_tinyusb.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.qtpy_esp32.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.qtpy_esp32c3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.wippersnapper_feather_esp32s3_reverse_tft_debug.test.skip

@@ -1 +1,3 @@
 
+
+

examples/Wippersnapper_demo/Wippersnapper_demo.ino

@@ -1,22 +1,33 @@
-// Adafruit IO WipperSnapper
+// Adafruit IO WipperSnapper Beta
+//
+//
+// NOTE: This software is a BETA release and in active development.
+// Please report bugs or errors to https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/issues
+//
 //
 // Adafruit invests time and resources providing this open source code.
 // Please support Adafruit and open source hardware by purchasing
 // products from Adafruit!
 //
-// Brent Rubell for Adafruit Industries, 2020-2025
+// Brent Rubell for Adafruit Industries, 2021-2022
 //
 // All text above must be included in any redistribution.
 
-#include "ws_adapters.h"
+#include "Wippersnapper_Networking.h"
-ws_adapter_wifi wipper;
+Wippersnapper_WiFi wipper;
 
-#define WS_DEBUG // Enable debug output!
+// Enable debug output for beta builds
+#define WS_DEBUG
 
 void setup() {
-  Serial.begin(115200);
+  // Provisioning must occur prior to serial init.
   wipper.provision();
+
+  Serial.begin(115200);
+  //while (!Serial) delay(10);
+
   wipper.connect();
+
 }
 
 void loop() {

examples/Wippersnapper_demo/picow_rp2350_tinyusb.generate

@@ -1 +0,0 @@
-picow_rp2350_tinyusb

examples/Wippersnapper_demo_offline/.feather_esp32.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32_v2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32_v2_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s2_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s2_reverse_tft.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s2_tft.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s2_tft_debug.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.feather_esp32s2_tft_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_4mbflash_2mbpsram.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_4mbflash_2mbpsram_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_debug.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_reverse_tft.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_tft.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_esp32s3_tft_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.feather_esp8266.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_rp2040_adalogger_tinyusb.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.feather_s2_tinyusb.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.funhouse.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.funhouse_noota.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.itsybitsy_esp32.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.magtag.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.metro_esp32s3.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.metro_esp32s3_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.metro_m4_airliftlite_tinyusb.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.metro_rp2350_tinyusb.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.metroesp32s2.test.skip

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo_offline/.metroesp32s2_debug.test.skip

@@ -1,2 +0,0 @@
-
-

examples/Wippersnapper_demo_offline/.pico_rp2040_tinyusb.generate

@@ -1 +0,0 @@
-