usb-debugging
/usb-debugging
Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.
- Author
- wedsamuel1230 ↗
- Repository
- embedded-engineering-skills ↗
- Licence
- MIT
- Last repository change
- 15.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 15.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.
Original author description
Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.
How it works
SKILL.md has no level-two headings · 30 lines, 197 words
SKILL.md preview
---
name: usb-debugging
description: Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.
metadata: {triggers: "USB Debugging, embedded diagnosis"}
---
# USB Debugging
Read [the shared embedded contract](../../docs/arduino-skill-contract.md) and
keep source/build, device and physical evidence separate.
Read [USB diagnosis](references/workflow.md). Identify connector, data-capable
cable, power path, native USB controller versus UART bridge, VID/PID, interfaces,
serial identity and host OS. Record enumeration before and after the event;
a changing port name is not necessarily a different physical board.
Separate no electrical connection, failed enumeration, missing driver/interface,
port ownership and application protocol. Record descriptors, endpoint types,
configuration and host logs with credentials/private serials redacted in public
reports. Check D+/D- wiring, clock/PHY/VBUS expectations and power externally
only against the exact board design.
Close conflicting serial monitors before a selected REPL/debug session.
MicroPython raw REPL and auto-reset tools can change runtime state. Native
USB may disappear during reset, breakpoint halt or firmware reconfiguration;
a UART bridge can remain enumerated while the MCU is stopped.
Use the matching platform skill for USB stack configuration. Deliver the layer
where evidence stops, a reproducible host check and the next targeted test.
Do not erase firmware or reinstall arbitrary drivers to fix an unidentified
transport symptom.
See [platform coverage](../../docs/platform-support.md) for the exact tested
combination. A source procedure is not a claim that every target was tested.
Files in this package (2)
- SKILL.md 2 KB
- references/workflow.md 1 KB
Versions
The database has no other skills named usb-debugging.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 3f376df662f5 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90esp32-usb-cdc-throughput-budget
Use when designing, reviewing, debugging or validating usb cdc throughput budget for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release. - 90esp32-usb-host-power-budget
Use when designing, reviewing, debugging or validating usb host power budget for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release. - 100tinyusb-integration
Use when integrating, porting, configuring, or debugging TinyUSB device, host, CDC, MSC, HID, MIDI, vendor class, descriptors, DCD, or USB enumeration issues - 90jetson-customize-usb
Enable/disable Jetson USB2/USB3 SS ports via kernel-DT overlay. Do NOT use for UPHY lane allocation or ODMDATA edits. - 81usb-devices
Use when the USB devices attached to this machine need to be listed and their vendor and product names resolved. - 100meddev-usb-medical
Implement safe USB device connectivity: class selection, enumeration handling, data validation, electrical and safety considerations. Use when working on usb medical in medical device software.