tinyusb.git/docs, branch cdc_persistentUnnamed repository; edit this file 'description' to name the repository.http://cgit.235523.xyz/tinyusb.git/atom/docs?h=cdc_persistent2026-07-24T08:56:14Zdocs: plan for etm-trace tightening and target-debugger integration2026-07-24T08:56:14Zhathachthach@tinyusb.org2026-07-24T08:51:23Zurn:sha1:c962a0bf62f53d7bee42db7ff3bcd8f07ec23daaMerge pull request #3786 from hathach/claude/improve-debug-skill-agent2026-07-24T08:45:15ZHa Thachthach@tinyusb.org2026-07-24T08:45:15Zurn:sha1:24bb035be7881c2b4a95136bef4d03a91c9e31ce
docs(skills): debug-skill overhaul — role-neutral capture model, verified debugger arsenal, Espressif backenddocs: address Codex/Copilot review on #37862026-07-24T08:14:02Zhathachthach@tinyusb.org2026-07-24T08:14:02Zurn:sha1:154999dbac95484f3f9a02cbf7a7277d89e1e0e9
- target-debug: fault frame lives on PSP when EXC_RETURN bit2 set (FreeRTOS
tasks) — decode LR before choosing $msp/$psp (Codex; valid, our verify
happened to fault on MSP)
- esp-target-debug: show the Xtensa gdb for S3 in the attach recipe; clarify
adapter serial = USB-SJ iSerial (colon MAC, hardware-verified) vs the
CP2102N flasher uids in tinyusb.json (Codex; second half of the finding
had the identifiers inverted)
- esp plan: align serial form with the verified command; record the real
console-gate outcome (UART0, USB-SJ console untested) (Copilot)
- target-debug plan: Task 4 now consistently $JB/ARMv7-M matching the
executed JLinkExe path (Copilot)
- drop IDE-local .idea files swept in by the rename commit (Copilot)
docs(superpowers): esp-target-debug design spec + executed implementation plan2026-07-24T07:55:59Zhathachthach@tinyusb.org2026-07-24T07:55:59Zurn:sha1:df3cea3d0e12c155e2a2e7f81dec031da38ab328
Spec (brainstormed): own-skill backend decision, PHY-conflict map, six
verification gates, external-JTAG TODO. Plan executed same-day: all gates
run on the rig; apptrace resolved per its own gate rule as (untested).
docs(target-debug): vector catch, SWO trace, verifybin, FreeRTOS threads; table integration2026-07-24T07:55:59Zhathachthach@tinyusb.org2026-07-24T07:55:59Zurn:sha1:21bbcb5bbff18454979a1dc9aaa210e938a004b5
- Vector catch + Cortex-M fault autopsy, verified with a deliberate bad-load
on stm32f407disco: CFSR=0x8200 (BFARVALID|PRECISERR), BFAR = exact bad
address, stacked pc addr2lined to the faulting line; gotchas recorded
(stale FPB comparators fire phantom SIGTRAPs — scrub first; arm DEMCR
after reset; loads precise / stores imprecise; ARMv6-M has no CFSR/BFAR)
- SWO exception trace + hw PC sampling gate PASSED on F407: 680 KB of
packets in 3 s (0x17 PC samples in flash range, 0x0E SysTick enter/exit);
JLinkSWOViewerCL decodes stimulus only — raw SWORead is the recipe;
SWOStart needs an explicit speed headless
- verifybin 'Verify successful.'; FreeRTOS -rtos plugin lists all 6
cdc_msc_freertos tasks after a run->stop cycle (plain attach = 0xDEAD
placeholder); semihosting anti-note; monitor-mode pointer (untested)
- Intrusiveness table gains the new rows; agent playbook bullet updated;
retrieval gate 5/5 with a fresh reader; executed plan committed
Update docs2026-07-21T10:07:43ZJie Fenghjf3108@gmail.com2026-05-02T04:50:04Zurn:sha1:39312067903aa8ad34a3637723775714ffb28026misc fixes2026-07-19T12:38:54ZJie Fenghjf3108@gmail.com2026-06-18T09:28:49Zurn:sha1:9418aba918d7c4107026c894e863d9ef0ec5db81docs, udev: address Copilot review nits on PR #37752026-07-17T17:15:54Zhathachthach@tinyusb.org2026-07-17T17:15:54Zurn:sha1:277e61818638795b9d0f7b2ddc076036dda06d4e
- getting_started.rst: the reST inline-link markup rendered literally
inside the code-block (not a runnable command) and lacked sudo — use a
plain `sudo cp examples/device/99-tinyusb-examples.rules ...`.
- tools/88-tinyusb.rules: normalize the six MODE="666" entries to the
4-digit octal MODE="0666" used everywhere else in the file.
skill: add usb-sniffer — wire-level capture with the ataradov hardware tap2026-07-17T10:32:47Zhathachthach@tinyusb.org2026-07-16T07:11:43Zurn:sha1:e5b47c9306471b41bd2d2ecbbe9ea8932028b380
Fourth view in the USB debugging toolset (usbmon = host URBs, usb-debug =
host reasoning, usb-target-debug = device firmware, usb-sniffer = what
actually crossed D+/D-). Covers the ataradov/usb-sniffer analyzer:
headless pcapng capture (--speed ls/fs/hs, --fold, --limit self-exit),
Wireshark/tshark analysis recipes, and the wire realities that bite:
downstream broadcast, sniffer self-capture noise, xHCI devnum != wire
address, tap-point-dependent reset visibility (hub choreography anchors),
FS-behind-HS-hub splits. Every recipe hardware-validated on the rig,
including the capture-window floor (a 3 s window provably misses the
enumeration ladder; 3M packets minimum).
Two udev files with distinct audiences, not one:
- examples/device/99-tinyusb-examples.rules (renamed from 99-tinyusb.rules):
the user-facing rules the examples need — cafe VID access, hidraw, the
ModemManager blacklist, a couple of board probes. getting_started.rst,
the webusb_serial README and its source comment point here.
- tools/88-tinyusb.rules: the HIL rig's private probe/analyzer allowlist,
now with the sniffer (6666:6620 + blank FX2LP 04b4:8613). Installed on
the rig only; the usb-sniffer skill references it.
agent: add target-debugger — device-side root-cause loop on the HIL rig2026-07-17T09:48:03Zhathachthach@tinyusb.org2026-07-16T07:11:25Zurn:sha1:b9478a723b6335f3e670453b622d615cebbd7293
Opus-tier agent charter for backgrounding a long hardware debug session:
instrument -> build -> flash under one held board lock -> dual-side
capture -> correlate -> refine, strictly one instance, skills as source
of truth (usb-target-debug, usbmon, usb-debug, usb-sniffer, usb-recover,
hil). The charter encodes what dogfooding established:
- diagnosis standard: evidence must show the mechanism, or a fix must
flip the ORIGINAL failing case on hardware; stop after two
evidence-free cycles and hand back a partial diagnosis
- lock cadence: hold for the whole session, release around hil_test.py
runs (it self-locks per board)
- revert semantics: "fix stays, probe goes, re-verify clean" —
instrumentation reverted, candidate fix left uncommitted and
re-verified on a clean build, pristine firmware reflashed before
lock release
Returns a machine-parseable diagnosis report including ruledOut[] —
disproven hypotheses are deliverables. Spec roster updated (opus/xhigh,
effort requested per agent() call).