Adom USB - ESP32-S2/S3 persona pack

@@ -1,3 +1,21 @@-# ESP32-S2/S3 TinyUSB persona pack+# adom-usb-stub-esp32 -esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support.+**adom-usb firmware device-test pack — Espressif.** esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support.++```bash+adompkg install adom-usb-stub-esp32+```++## Personas++| id | flashes | enumerates as |+|---|---|---|+| `cdc-serial` | CDC serial (console) | CDC serial |+| `hid-keyboard` | HID keyboard | HID keyboard |+| `hid-mouse` | HID mouse | HID mouse |+| `msc-disk` | Mass storage | Mass storage |+| `midi` | USB-MIDI | Audio/MIDI |++Chips: esp32s2, esp32s3 · flash method: `esptool`.++Once installed, `adom-usb` shows a **Flash ▾** persona picker on matching devices. Pick a persona, the pack flashes the stub, and the device re-enumerates as that USB class so you can mount / test / sniff it. This package ships the flash **contract** (a reference template) — drop your real signed firmware artifacts in `firmware/<persona>.<ext>` and publish your own version. See the adom-usb wiki page → *Writing a packet-sniffer plugin* (firmware packs share the same lifecycle).

@@ -0,0 +1,28 @@+#!/usr/bin/env bash+# ESP32-S2/S3 TinyUSB persona pack — adom-usb FIRMWARE device-test pack (API v1). Implements: manifest, personas, flash.+# REFERENCE TEMPLATE: drop your real firmware artifacts in firmware/<persona>.<ext> and wire+# the esptool call below. Ships the flash CONTRACT; manufacturers ship the binaries.+set -euo pipefail; HERE="$(cd "$(dirname "$0")" && pwd)"+cmd="${1:-}"; shift || true+case "$cmd" in+  manifest) cat "$HERE/plugin.json";;+  personas) if command -v jq >/dev/null; then jq -c '.personas' "$HERE/plugin.json"; else grep -o '"personas".*' "$HERE/plugin.json"; fi;;+  flash)+    PERSONA="" VID="" PID="" BUSID="" TARGET=""+    while [ $# -gt 0 ]; do case "$1" in --persona)PERSONA="$2";shift 2;; --vid)VID="$2";shift 2;; --pid)PID="$2";shift 2;; --busid)BUSID="$2";shift 2;; --target)TARGET="$2";shift 2;; *)shift;; esac; done+    ART="$HERE/firmware/${PERSONA}.bin"; METHOD="esptool"+    # The real flash call (chip-specific). Degrades to a dry-run when the tool/artifact is absent.+    case "$METHOD" in+      uf2-bootsel) RUN="picotool load $HERE/firmware/${PERSONA}.uf2 -f && picotool reboot";;+      dfu-util)    RUN="dfu-util -a 0 -s 0x08000000:leave -D $ART";;+      esptool)     RUN="esptool.py --chip auto write_flash 0x0 $ART";;+      nrfutil)     RUN="nrfutil device program --firmware $ART";;+      openocd)     RUN="openocd -f board/ti_sitara.cfg -c 'program $ART verify reset exit'";;+      bossac)      RUN="bossac -e -w -v -R $ART";;+      wchisp)      RUN="wchisp flash $ART";;+      *)           RUN="<flash $ART via $METHOD>";;+    esac+    if [ -f "$ART" ] || [ -f "$HERE/firmware/${PERSONA}.uf2" ]; then eval "$RUN" >/dev/null 2>&1 && STATUS="flashed" || STATUS="flash-failed"; else STATUS="dry-run (no bundled artifact — template)"; fi+    printf '{"ok":true,"persona":"%s","method":"%s","status":"%s","command":"%s","summary":"%s: device will re-enumerate as the persona USB class — refresh adom-usb"}\n' "$PERSONA" "$METHOD" "$STATUS" "$RUN" "$PERSONA";;+  *) echo "usage: adom-usb-stub-esp32 manifest | personas | flash --persona <id> --vid <hex> --pid <hex> --busid <b> --target <host>" >&2; exit 2;;+esac

@@ -0,0 +1,9 @@+#!/bin/bash+set -euo pipefail+DIR="$(cd "$(dirname "$0")" && pwd)"; SLUG="adom-usb-stub-esp32"+PDIR="${HOME}/.adom/usb-plugins/${SLUG}"; mkdir -p "$PDIR" "${HOME}/.local/bin"+install -m 0644 "$DIR/plugin.json" "$PDIR/plugin.json"+install -m 0755 "$DIR/$SLUG" "$PDIR/$SLUG"+[ -d "$DIR/firmware" ] && cp -r "$DIR/firmware" "$PDIR/" || true+ln -sf "$PDIR/$SLUG" "${HOME}/.local/bin/$SLUG"+echo "Installed plugin $SLUG -> $PDIR (adom-usb discovers it on next refresh)"

@@ -1,9 +1,8 @@ {-  "schema_version": 1,   "type": "app",   "slug": "adom-usb-stub-esp32",   "title": "ESP32-S2/S3 TinyUSB persona pack",-  "brief": "esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support.",+  "brief": "esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI \u2014 validate native-USB host support.",   "version": "0.1.0",   "visibility": "public",   "hero": {@@ -11,10 +10,7 @@     "path": "screenshots/hero.png"   },   "install": {-    "binary_name": "adom-usb-stub-esp32",-    "install_dir": "",-    "install_hint": "",-    "version_cmd": ""+    "binary_name": "adom-usb-stub-esp32"   },   "metadata": {     "version": "0.1.0",@@ -29,18 +25,5 @@       "flash usb persona",       "test usb device"     ]-  },-  "author": {-    "id": "6738b00a4dc87b8adbb0a5a3",-    "name": "John Lauer",-    "email": "[email protected]"-  },-  "tags": [],-  "license": "proprietary",-  "sample_prompts": [],-  "discovery_triggers": [],-  "discovery_pitch": null,-  "created_at": "2026-06-20T02:58:35.538Z",-  "updated_at": "2026-06-20T02:58:35.538Z",-  "skills": []+  } }\ No newline at end of file

@@ -0,0 +1,61 @@+{+  "slug": "adom-usb-stub-esp32",+  "name": "ESP32-S2/S3 TinyUSB persona pack",+  "version": "0.1.0",+  "api_version": "1",+  "kind": "firmware",+  "entrypoint": "adom-usb-stub-esp32",+  "vendor": "Espressif",+  "chips": [+    "esp32s2",+    "esp32s3"+  ],+  "matches": {+    "vid": [+      "303a"+    ],+    "pid": [+      "*"+    ]+  },+  "flash_method": "esptool",+  "personas": [+    {+      "id": "cdc-serial",+      "name": "CDC serial (console)",+      "usb_class": "CDC serial",+      "result_vid": "303a",+      "result_pid": "1001"+    },+    {+      "id": "hid-keyboard",+      "name": "HID keyboard",+      "usb_class": "HID keyboard",+      "result_vid": "303a",+      "result_pid": "4004"+    },+    {+      "id": "hid-mouse",+      "name": "HID mouse",+      "usb_class": "HID mouse",+      "result_vid": "303a",+      "result_pid": "4005"+    },+    {+      "id": "msc-disk",+      "name": "Mass storage",+      "usb_class": "Mass storage",+      "result_vid": "303a",+      "result_pid": "4002"+    },+    {+      "id": "midi",+      "name": "USB-MIDI",+      "usb_class": "Audio/MIDI",+      "result_vid": "303a",+      "result_pid": "4006"+    }+  ],+  "description": "esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI \u2014 validate native-USB host support.",+  "homepage": "https://wiki.adom.inc/john/adom-usb-stub-esp32"+}\ No newline at end of file

@@ -0,0 +1,11 @@+---+name: adom-usb-stub-esp32+description: >+  adom-usb firmware plugin. esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support. Trigger words: adom-usb-stub-esp32, adom-usb plugin, usb firmware, flash usb persona, stub firmware, make device act like keyboard/disk/mouse.+---++# adom-usb-stub-esp32++esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support.++Install: `adompkg install adom-usb-stub-esp32`. adom-usb discovers it automatically (scans `~/.adom/usb-plugins/`) and shows a Flash persona picker on matching devices. See the adom-usb wiki page for the plugin API.

@@ -0,0 +1,4 @@+#!/bin/bash+set -euo pipefail+rm -rf "${HOME}/.adom/usb-plugins/adom-usb-stub-esp32" "${HOME}/.local/bin/adom-usb-stub-esp32"+echo "Removed adom-usb-stub-esp32"