Offline/SD - Fix PM25 sensor

[API v2]: Add support for I2C Output Components

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

@@ -1,16 +1,13 @@
-# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2023
+# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2023-2025
 #
 # SPDX-License-Identifier: MIT
 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:
+    branches-ignore:
+        - 'offline-mode'
   workflow_call:
     secrets:
       GH_REPO_TOKEN:
@@ -23,52 +20,19 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arduino-platform:
-          [
-            "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",
-          ]
-
+        arduino-platform: ["funhouse_noota"]
+        include:
+          - offset: "0x1000"
     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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -83,8 +47,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          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/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
@@ -143,7 +106,6 @@ 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
@@ -159,58 +121,6 @@ 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
@@ -226,17 +136,23 @@ 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: cp /home/runner/.arduino15/packages/esp32/hardware/esp32/*/tools/partitions/boot_app0.bin wippersnapper.${{ matrix.arduino-platform }}.fatfs.${{ env.WS_VERSION }}.boot_app0.bin
+        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
       - name: boot_app0 file from esp32 source bsp
         if: steps.check_files.outputs.files_exists == 'false'
-        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: 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: mv /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
         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 @new_flash_args
+          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_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 }}.*
@@ -264,36 +180,30 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -303,7 +213,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          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/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
@@ -376,48 +286,27 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -432,7 +321,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          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/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
       - name: Download stable Nanopb
         id: download-nanopb
@@ -465,7 +354,7 @@ jobs:
           mv nanopb/pb.h src/nanopb/nanopb.pb.h
       - name: Install Dependencies
         run: |
-          pip install esptool
+          pip install esptool==4.6
       - name: build ESP32 platforms
         run: python3 ci/build_platform.py ${{ matrix.arduino-platform }} --build_timeout 48000
       - name: Check artifacts
@@ -503,14 +392,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 \
-            --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}} \
+          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_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 }}.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 \
@@ -539,31 +428,15 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -575,8 +448,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 --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/PaulStoffregen/OneWire.git /home/runner/Arduino/libraries/OneWire
+          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
       - name: Download stable Nanopb
         id: download-nanopb
@@ -627,33 +500,17 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arduino-platform: ["picow_rp2040_tinyusb", "picow_rp2350_tinyusb", "fruit_jam_tinyusb"]
+        arduino-platform: ["picow_rp2040_tinyusb", "picow_rp2350_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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -716,31 +573,15 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -750,8 +591,8 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino library
         run: |
-          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/PaulStoffregen/OneWire.git /home/runner/Arduino/libraries/OneWire
+          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
       - name: Download stable Nanopb
         id: download-nanopb
         continue-on-error: true
@@ -810,7 +651,6 @@ jobs:
       matrix:
         arduino-platform:
           [
-            "esp32s3_devkitc_1_n8_debug",
             "feather_esp32s2_debug",
             "feather_esp32s2_tft_debug",
             "feather_esp32s3_debug",
@@ -821,31 +661,15 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -855,7 +679,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          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/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
@@ -933,31 +757,15 @@ 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 remote add adafruit https://github.com/adafruit/Adafruit_Wippersnapper_Arduino.git || true
-          git fetch --prune --unshallow --all --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"
+          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
@@ -972,7 +780,7 @@ jobs:
         run: bash ci/actions_install.sh
       - name: Install extra Arduino libraries
         run: |
-          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/pstolarz/OneWireNg.git /home/runner/Arduino/libraries/OneWireNg
       - name: Download stable Nanopb
         id: download-nanopb
@@ -1045,14 +853,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 \
-            --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}} \
+          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_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 }}.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 \
@@ -1120,10 +928,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/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/protos -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
+# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022-2024
 #
 # 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@v4
+        uses: actions/download-artifact@v2
         with:
-          path: .
+          name: build-files
       - name: List Files
         run: ls
       - name: Upload Assets to the GitHub Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v1
         if: startsWith(github.ref, 'refs/tags/')
         with:
           files: |
-                  build-files/wippersnapper.*.uf2
-                  build-files/wippersnapper.*.bin
-                  build-files/wippersnapper.*.zip
+                  wippersnapper.*.uf2
+                  wippersnapper.*.bin
+                  wippersnapper.*.zip

.github/workflows/release-caller.yml

@@ -1,21 +1,37 @@
-# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022
+# SPDX-FileCopyrightText: Brent Rubell for Adafruit Industries, 2022-2025
 #
 # 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
+
   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: call-workflow-build
-    uses: adafruit/Adafruit_Wippersnapper_Arduino/.github/workflows/release-callee.yml@main
+    needs: [check-branch, call-workflow-build]
+    if: needs.check-branch.outputs.should_run == 'true'
+    uses: adafruit/Adafruit_Wippersnapper_Arduino/.github/workflows/release-callee.yml@main

.github/workflows/release-offline.yml

@@ -0,0 +1,291 @@
+# 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
+        - offline-mode-*
+    pull_request:
+      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_offline_netiface.ino.uf2 wippersnapper.${{ matrix.arduino-platform }}.${{ env.WS_VERSION }}.uf2
+          mv examples/*/build/*/Wippersnapper_demo_offline_netiface.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_nonetiface.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,17 +39,30 @@ 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/
 
-# Secrets
+# These sometimes contain credentials, don't commit them!
+src/Wippersnapper_demo_wokwi.ino
 data/
+examples/Wippersnapper_demo_offline/.theia/
+examples/Wippersnapper_demo_offline/.vscode/
+examples/Wippersnapper_demo_offline/build/
 
-# Misc. Data
-tests/
-venv/
+# Test results
+report.xml
+
+# VSCode settings
+.vscode/settings.json
+
+CLAUDE.md

.vscode/settings.json

@@ -1,11 +1,23 @@
 {
     "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": true,
+    "C_Cpp.dimInactiveRegions": false,
     "dotnet.defaultSolution": "disable",
-    "cmake.configureOnOpen": false,
-    "C_Cpp.clang_format_fallbackStyle": "Google",
-    "C_Cpp.clang_format_style": "file"
+    "cmake.configureOnOpen": false
 }

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2021 Adafruit Industries
+Copyright (c) 2020-2024 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,25 +5,26 @@
 # 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 programming is required!
+Adafruit.io WipperSnapper is a firmware designed to turn any Wi-Fi capable board into an Internet-of-Things (IoT) device. No code required!
 
-WipperSnapper works with multiple microcontroller architectures such as ESP8266, ESP32, ESP32-Sx, ESP32-Cx, RP2040, RP2350, and ATSAMD51.
+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.
 
-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=). 
+A **free** [Adafruit IO](https://io.adafruit.com) account is required to use WipperSnapper.
 
 # 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-Sx, ESP32-C3 |
+|[ESP32-x](https://github.com/espressif/arduino-esp32)| ESP32, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6 |
 |[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) |
+|[RP2](https://github.com/earlephilhower/arduino-pico)| RP2040/RP2350 MCU w/WiFi (i.e: Pico W) |
 |[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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1 @@
+{"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

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

examples/Wippersnapper_NoFS/.feather_esp32s3_tft.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.feather_esp32s3_tft_debug.test.skip

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

examples/Wippersnapper_NoFS/.feather_esp8266.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.feather_rp2040_adalogger_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.feather_s2_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.funhouse.test.skip

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

examples/Wippersnapper_NoFS/.funhouse_noota.test.skip

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

examples/Wippersnapper_NoFS/.itsybitsy_esp32.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.magtag.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.metro_esp32s3.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.metro_esp32s3_debug.test.skip

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

examples/Wippersnapper_NoFS/.metro_m4_airliftlite_tinyusb.test.skip

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

examples/Wippersnapper_NoFS/.metro_rp2350_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.metroesp32s2.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.metroesp32s2_debug.test.skip

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

examples/Wippersnapper_NoFS/.pico_rp2040_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.pico_rp2350_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.picow_rp2040_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.picow_rp2350_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.qtpy_esp32.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.qtpy_esp32c3.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.qtpy_esp32s2.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.qtpy_esp32s3.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.qtpy_esp32s3_n4r2.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32c6_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.wippersnapper_feather_esp32s3_reverse_tft_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/.wippersnapper_qtpy_esp32c3.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_NoFS/Wippersnapper_NoFS.ino

@@ -0,0 +1,40 @@
+// 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

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.metro_rp2350_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.pico_rp2040_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.pico_rp2350_tinyusb.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.picow_rp2040_tinyusb.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.picow_rp2350_tinyusb.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.qtpy_esp32.generate

@@ -1 +0,0 @@
-

examples/Wippersnapper_demo/.qtpy_esp32c3.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo/.wippersnapper_feather_esp32s3_reverse_tft_debug.test.skip

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

examples/Wippersnapper_demo/Wippersnapper_demo.ino

@@ -1,33 +1,22 @@
-// 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 IO WipperSnapper
 //
 // 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, 2021-2022
+// Brent Rubell for Adafruit Industries, 2020-2025
 //
 // All text above must be included in any redistribution.
 
-#include "Wippersnapper_Networking.h"
-Wippersnapper_WiFi wipper;
+#include "ws_adapters.h"
+ws_adapter_wifi wipper;
 
-// Enable debug output for beta builds
-#define WS_DEBUG
+#define WS_DEBUG // Enable debug output!
 
 void setup() {
-  // Provisioning must occur prior to serial init.
-  wipper.provision();
-
   Serial.begin(115200);
-  //while (!Serial) delay(10);
-
+  wipper.provision();
   wipper.connect();
-
 }
 
 void loop() {

examples/Wippersnapper_demo/picow_rp2350_tinyusb.generate

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

examples/Wippersnapper_demo_offline_netiface/.feather_esp32.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32_v2.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32_v2_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2_reverse_tft.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2_tft.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2_tft_debug.skip

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

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s2_tft_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_4mbflash_2mbpsram.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_4mbflash_2mbpsram_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_debug.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_reverse_tft.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_tft.generate

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_esp32s3_tft_debug.test.skip

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

examples/Wippersnapper_demo_offline_netiface/.feather_esp8266.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_rp2040_adalogger_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.feather_s2_tinyusb.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.funhouse.test.skip

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

examples/Wippersnapper_demo_offline_netiface/.funhouse_noota.test.skip

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

examples/Wippersnapper_demo_offline_netiface/.itsybitsy_esp32.test.skip

@@ -0,0 +1 @@
+

examples/Wippersnapper_demo_offline_netiface/.magtag.test.skip

@@ -0,0 +1 @@
+