Adom USB - TI Sitara persona pack

@@ -1,3 +1,20 @@-# TI Sitara USB device test pack+# adom-usb-stub-ti-sitara -Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID — validate host enumeration.+**adom-usb firmware device-test pack — Texas Instruments.** Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID — validate host enumeration.++```bash+adompkg install adom-usb-stub-ti-sitara+```++## Personas++| id | flashes | enumerates as |+|---|---|---|+| `msc-disk` | Mass storage gadget | Mass storage |+| `cdc-rndis` | RNDIS ethernet gadget | CDC ethernet |+| `cdc-serial` | CDC ACM gadget | CDC serial |+| `hid-keyboard` | HID keyboard gadget | HID keyboard |++Chips: am335x, am437x, am57x, am62x · flash method: `openocd`.++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+# TI Sitara USB device test 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 openocd 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="openocd"+    # 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-ti-sitara 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-ti-sitara"+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-ti-sitara",   "title": "TI Sitara USB device test pack",-  "brief": "Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID — validate host enumeration.",+  "brief": "Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID \u2014 validate host enumeration.",   "version": "0.1.0",   "visibility": "public",   "hero": {@@ -11,10 +10,7 @@     "path": "screenshots/hero.png"   },   "install": {-    "binary_name": "adom-usb-stub-ti-sitara",-    "install_dir": "",-    "install_hint": "",-    "version_cmd": ""+    "binary_name": "adom-usb-stub-ti-sitara"   },   "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:54.916Z",-  "updated_at": "2026-06-20T02:58:54.916Z",-  "skills": []+  } }\ No newline at end of file

@@ -0,0 +1,56 @@+{+  "slug": "adom-usb-stub-ti-sitara",+  "name": "TI Sitara USB device test pack",+  "version": "0.1.0",+  "api_version": "1",+  "kind": "firmware",+  "entrypoint": "adom-usb-stub-ti-sitara",+  "vendor": "Texas Instruments",+  "chips": [+    "am335x",+    "am437x",+    "am57x",+    "am62x"+  ],+  "matches": {+    "vid": [+      "0451"+    ],+    "pid": [+      "*"+    ]+  },+  "flash_method": "openocd",+  "personas": [+    {+      "id": "msc-disk",+      "name": "Mass storage gadget",+      "usb_class": "Mass storage",+      "result_vid": "0451",+      "result_pid": "6500"+    },+    {+      "id": "cdc-rndis",+      "name": "RNDIS ethernet gadget",+      "usb_class": "CDC ethernet",+      "result_vid": "0451",+      "result_pid": "6501"+    },+    {+      "id": "cdc-serial",+      "name": "CDC ACM gadget",+      "usb_class": "CDC serial",+      "result_vid": "0451",+      "result_pid": "6502"+    },+    {+      "id": "hid-keyboard",+      "name": "HID keyboard gadget",+      "usb_class": "HID keyboard",+      "result_vid": "0451",+      "result_pid": "6503"+    }+  ],+  "description": "Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID \u2014 validate host enumeration.",+  "homepage": "https://wiki.adom.inc/john/adom-usb-stub-ti-sitara"+}\ No newline at end of file

@@ -0,0 +1,11 @@+---+name: adom-usb-stub-ti-sitara+description: >+  adom-usb firmware plugin. Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID — validate host enumeration. Trigger words: adom-usb-stub-ti-sitara, adom-usb plugin, usb firmware, flash usb persona, stub firmware, make device act like keyboard/disk/mouse.+---++# adom-usb-stub-ti-sitara++Load Linux USB-gadget / stub images onto a TI Sitara (AM335x/AM57x/AM62x) USB device controller to present MSC, RNDIS, CDC, or HID — validate host enumeration.++Install: `adompkg install adom-usb-stub-ti-sitara`. 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-ti-sitara" "${HOME}/.local/bin/adom-usb-stub-ti-sitara"+echo "Removed adom-usb-stub-ti-sitara"