summaryrefslogtreecommitdiff
path: root/AGENTS.md
AgeCommit message (Collapse)Author
2026-06-11Merge pull request #3695 from hathach/claude/adoring-pasteur-kbaFaHa Thach
Add pvs skill to run PVS-Studio analysis for a board
2026-06-11pvs skill: harden credentials parsing; note compile DB is exported by defaultClaude
- Parse PVS_STUDIO_CREDENTIALS into two quoted fields (no glob/word-split). - AGENTS.md: examples build sets CMAKE_EXPORT_COMPILE_COMMANDS ON already. Addresses Copilot review on #3695.
2026-06-11pvs skill: mirror CI --security-related-issues flag and ignore SARIF outputClaude
- Add --security-related-issues to run_pvs.sh and AGENTS.md analyze commands so local runs reproduce the CI SAST classification (static_analysis.yml). - Ignore *.sarif so a successful run leaves the worktree clean. Addresses Codex review on #3695.
2026-06-11Fix stm32f723disco host/cdc_msc_hid HIL: UART RX starvation + DWC2 DMA ↵Ha Thach
split-IN NAK storm (#3677) Fix stm32f723disco host HIL: UART RX starvation + DWC2 split bulk NAK/XactErr handling (#3677) stm32f7 BSP — UART RX starvation - The host console USART shared interrupt priority with the USB OTG ISR, so a long OTG interrupt could starve RXNE and drop received bytes. Raise the USART RX IRQ above OTG_FS/OTG_HS in both the bare-metal and FreeRTOS init paths, guarded by #ifdef UART_ID so boards without a UART console keep the default OTG priority. dwc2 host — split NAK/XactErr handling - Slave mode: a persistently-NAKing split bulk/control IN poll re-armed the start-split immediately, storming the ISR and starving task context. Throttle by disabling the channel and re-arming on the resulting halt (no frame deferral). - Buffer-DMA mode: a pure split bulk-OUT NAK was unhandled, leaving the channel halted and stalling the transfer — the dominant cause of CDC echo truncation. Handle it by rewinding the buffer pointers and retrying the start-split (Programming Guide v4.20a 5.1.4.2). - Buffer-DMA mode: a split bulk-OUT XactErr was retried immediately, exhausting HCD_XFER_ERROR_MAX before the transient cleared. Throttle via channel_disable + re-arm to give the hub TT a recovery gap, mirroring slave mode. - All three are scoped to split transfers (hcsplt.split_en); non-split NAK/XactErr keep the core-handled / immediate-retry behavior. The OUT XactErr throttle also excludes periodic split, where channel_disable() is a no-op and would wedge the channel. The nak_disabled flag is generalized to retry_disabled and honors xfer->closing so an endpoint close during a throttled retry tears down cleanly. Verified on stm32f723disco HIL (slave + CFG_TUH_DWC2_DMA_ENABLE): host/cdc_msc_hid, msc_file_explorer, and device_info all pass on both variants; DMA CDC echo went from ~15-25% raw failure to 10/10 clean.
2026-06-05Compact pvs skill; fix PVS-Studio -S/--dump-files docs in AGENTS.mdClaude
The AGENTS.md '-S src/foo.c' example was inaccurate: -S takes a plaintext file listing source paths, not paths directly. Drop --dump-files from the documented commands (it scatters .PVS-Studio.i/.cfg dumps across the tree; FP-debugging only) and reference the new pvs skill. https://claude.ai/code/session_015inWmFhRYSq17CxMukdoqX
2026-04-29Improve remote execution in `hil_ci.sh`hathach
2026-04-29Add `code-size` skill and integrate `metrics_compare_base.py` toolhathach
- Introduced a `code-size` skill under `.claude/skills` for evaluating TinyUSB code size changes between the base branch and current branch. - Added `metrics_compare_base.py`, automating code size comparison with granular options for examples, boards, and CI-wide runs. - Updated `AGENTS.md` to include quick references and usage guidance for the new feature.
2026-04-29address review feedback for AGENTS.md and hil skillhathach
AGENTS.md: - fix build dir to cmake-build-<board> (matches hil_test.py expectation) - reformat flash section to avoid shell-pipe ambiguity, use <board> - mention board.mk for Make-based builds - complete OpenOCD jlink interface example - update stale "Build Option 2" references to "All examples for a board" - split PVS-Studio command so it is copy-pasteable .claude/skills/hil/SKILL.md: - clarify local.json is user-supplied, not tracked in repo - use python3 consistently - add all-boards variant for remote execution - delegate remote execution to test/hil/hil_ci.sh test/hil/hil_ci.sh: - portable shebang (/usr/bin/env bash) - set -euo pipefail - env overrides for REMOTE, REMOTE_DIR, CONFIG, ROOT_DIR - --prune-empty-dirs on rsync to skip empty subdirs - fail-fast sanity check on repo layout Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
2026-04-28update AGENTS.md and claude hil skillhathach
2026-03-17add hil test for host msc and cdchathach
2026-03-17add hil host cdc testhathach
2026-03-12chore(workflows): update GitHub Actions dependencies and improve membrowse ↵hathach
error handling update AGENTS.md with metrics compare
2026-03-06update printer class: enhance descriptors, buffer sizes, and callbackshathach
2026-03-05improve threadx support, add multi ROTS support for board_test and msc_dual_lunhathach
2026-03-04Merge pull request #3490 from Precidata/non-blocking-host-v2Ha Thach
Fully asynchrounous host code (v2)
2026-03-02fix esp32p4 utmi phy init in the new esp-idf, also update esp-idf to v5.5.3hathach
2026-02-25fix CDC host FTDI multiple channel loophathach
fix typos for ftdi_process_set_config() add J-Link GDB + RTT logging instructions
2026-02-23refactor: streamline high-speed PHY detection and configuration in DWC2 driverhathach
2025-11-26focus on cdc test, write lots more data, each trunk is 64 or less since ↵hathach
examples having minimum 64 bytes fifo (fs)
2025-11-19Bump version to 0.20.0hathach
2025-11-19remove copilot-instructions.md, update and use AGENTS.md insteadhathach
2025-11-19Apply suggestions from code reviewHa Thach
Co-authored-by: Copilot <[email protected]>
2025-11-19fix more alertshathach
2025-10-09Update AGENTS.mdHa Thach
Co-authored-by: Copilot <[email protected]>
2025-10-09added AGENTS.mdhathach