pynq-workflow
/pynq-workflow
Buduje i diagnozuje nakładki PYNQ z jawnym kontraktem sprzętowym, dopasowanymi plikami BIT i HWH oraz transferami AXI DMA.
- Autor
- liuziyi20192010 ↗
- Repozytorium
- far_field_radio_df ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 10
- Skrypty
- 4
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/dma_session.py, scripts/golden_compare.py, scripts/overlay_audit.py, scripts/report_metrics.py
Co robi i kiedy
Buduje i diagnozuje nakładki PYNQ z jawnym kontraktem sprzętowym, dopasowanymi plikami BIT i HWH oraz transferami AXI DMA.
Oryginalny opis (EN)
Build and diagnose PYNQ overlays using an explicit hardware contract, matched BIT/HWH artifacts, bounded simple AXI DMA transfers, buffer ownership, and golden-reference evidence. Use for PYNQ data acquisition or accelerator projects; adapt board pins and packet formats to the actual hardware.
Jak działa
SKILL.md bez nagłówków drugiego poziomu · 17 linii, 409 słów
Podgląd SKILL.md
--- name: pynq-workflow description: Build and diagnose PYNQ overlays using an explicit hardware contract, matched BIT/HWH artifacts, bounded simple AXI DMA transfers, buffer ownership, and golden-reference evidence. Use for PYNQ data acquisition or accelerator projects; adapt board pins and packet formats to the actual hardware. --- # PYNQ workflow Make the interface contract explicit before generating host code: board/part and image version; IP instance names and VLNV; register offsets/bitfields; stream width, byte length and TLAST; cache policy; start/done/rearm; reset/quiescence. Never infer these from another project's constants or from an IP name alone. Read [interface_contract.md](references/interface_contract.md) when creating or changing an overlay interface. BIT, same-stem HWH and host decoder must come from one build. Use `scripts/overlay_audit.py --bit <file> --contract <json> --manifest <json>` before loading. The audit is read-only and proves configured metadata/hashes, not electrical compatibility or bitstream correctness. Check `overlay.ip_dict` and the actual IP `register_map` on the target image before changing registers. For finite simple AXI DMA S2MM, use [dma_and_cdc.md](references/dma_and_cdc.md) and `scripts/dma_session.py`. Compute bytes from count and dtype; compare against the configured BTT width, DRE/alignment and allocation. Receive must be armed before a producer starts. Keep the PYNQ buffer alive until completion and driver cache invalidation; copy results before freeing. Timeout, transfer errors and KeyboardInterrupt require retention until a successful hardware reset ends every old write. A stopped notebook/UI is insufficient. One physical DMA needs one shared owner. The helper assumes the AXI DMA simple S2MM register layout; do not apply it to SG, cyclic DMA or MCDMA. Separate transport correctness from signal/algorithm correctness: use a counter or known vector for the first, then independent same-frame reference results for the second. Compare stages from raw samples to intermediate accumulators, products and final output when diagnosing divergence. Use `scripts/golden_compare.py <npz> --tolerance <limit>` (add `--circular` only for degrees), and `scripts/report_metrics.py <report_dir>`. Reject unknown report formats instead of inventing numbers. Preserve invalid/overrange frames in evidence. Before changing an estimator or adding compensation for a stable measurement bias, check source outputs, cable seating, common reference, input range and calibration conditions. Keep physical observations separate from digital same-frame agreement. For notebook presentation changes, read [presentation_and_evidence.md](references/presentation_and_evidence.md): simplify the normal view while retaining invalid states, raw diagnostics and reproducible evidence outside it. Read [pitfalls.md](references/pitfalls.md) for a matching symptom, and [prompts.md](references/prompts.md) to organize model/tool correction loops. Verify a claimed improvement with the same input and defined baseline; label simulation, offline mock behavior, calculated bounds and board measurements separately. Templates and prompts are aids, not independently proven universal workflows. The scripts contain no ADC format, carrier frequency, phase protocol, package pins or fixed DMA instance name. A new board still needs its own PS/DDR/MIO, constraints and image compatibility checks. Cross-board physical validation has not been performed; see the parent [README](../README.md) for demonstrated scope and failure conditions.
Pliki w paczce (10)
- SKILL.md 4 KB
- references/dma_and_cdc.md 3 KB
- references/interface_contract.md 2 KB
- references/pitfalls.md 5 KB
- references/presentation_and_evidence.md 3 KB
- references/prompts.md 2 KB
- scripts/dma_session.py 4 KB
- scripts/golden_compare.py 2 KB
- scripts/overlay_audit.py 3 KB
- scripts/report_metrics.py 2 KB
Wersje
W bazie nie ma innych skilli o nazwie pynq-workflow.
Migawka bazy z 13.11.2026 · wersja paczki d1ce160571f0 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 91pynq-stream-validation
Waliduje kontrakty strumieni AXI DMA o stałej długości, generuje szkielety hosta PYNQ i zbiera metryki z Vivado. - 100pynq-overlay-bringup
Pomaga uruchomić overlay PYNQ na płytce FPGA, gdy MMIO, DMA lub wideo zawiesza się albo zgłasza brak urządzeń. - 100fpga-project-analyzer
Analizuje i wizualnie opisuje projekty FPGA AMD/Xilinx, od schematów bloków Vivado po RTL i rejestry, oraz szuka błędów w zegarach i resetach. - 100esp32-dma-buffer-placement
Dobiera miejsce i wyrównanie buforów DMA w pamięci ESP32, tak aby transfery działały poprawnie. - 90esp32-audio-dma-buffer-sizing
Dobiera rozmiar buforów DMA dla audio w ESP32, z ograniczeniami układu, analizą awarii i mierzalną weryfikacją przed wydaniem. - 100dma-baremetal
Obsługuje DMA w programowaniu bare-metal do transferów pamięć-peryferia: konfiguracja kanałów, tryb cykliczny, podwójne buforowanie i obsługa przerwania zakończenia transferu.