How pconst/basic_verilog works
Project Type and Purpose
• This repository is not a conventional “frontend‐backend” application but a comprehensive FPGA IP library and toolbox.
• It collects synthesizable Verilog/SystemVerilog modules (“must‐have modules”), soft‐processor cores (KCPSM6, pacoblaze), board definitions (Xilinx Alveo cards, Digilent, etc.), design templates (Avalon-MM, AXI, dual-port RAM), example projects, testbenches, and scripts to automate common FPGA flows.
File Structure Analysis
• Top‐level categories:
• “Advanced Synthesis Cookbook” – categorized IP blocks (arithmetic, communication, storage, crypto, etc.)
• “pacoblaze-2.2” & “KCPSM6_Release…” – PicoBlaze soft CPU implementations
• “XilinxBoardStore_with_Alveo_cards_support” – board metadata (XML, JSON, presets)
• “avalon_mm_master_templates” & “axi_master_slave_templates” – bus interface templates
• “dual_port_single_port_ram_templates” – block RAM / FIFO templates
• “example_projects” & “benchmark_projects” – boilerplates, reference designs, performance tests
• “scripts” & “scripts_for_intel_hls”/“_xilinx_hls” – flow automation (TCL, shell, batch, Python)
• Individual .sv/.v files at root – standalone utility modules and testbenches
a. IP Library Blocks
• Modules by category (e.g., Arithmetic, Communication, Storage, Crypto, Debug).
b. Soft CPU Cores
• KCPSM6 and pacoblaze cores with their assembler/toolchain (KCAsm).
c. Board Definitions
• XilinxBoardStore directory feeding into toolchains; presets/IO mappings.
d. Bus Interface Templates
• Avalon-MM masters/slaves, AXI masters/slaves.
e. Dual-Port/Single-Port RAM Templates
f. Example & Benchmark Projects
• Consume IP blocks, board definitions, templates. Illustrate typical end-to-end use.
g. Automation Scripts
• Invoke synthesis tools (Vivado, Quartus, ModelSim, Gowin, HLS flows).
h. FPGA Toolchains & Devices
• External services: Vivado, Quartus, ModelSim, Icarus Verilog, Vitis HLS, Intel HLS.
• Target boards (e.g., Alveo cards, Digilent boards).
Relationships and Data Flows
• IP Library → Example/Benchmark Projects (integration)
• Board Definitions → Example/Benchmark Projects (pin/preset selection)
• Templates (RAM, bus interfaces) → Example Projects
• Example/Benchmark Projects + Scripts → FPGA Toolchain (synthesis, implementation)
• Toolchain → FPGA Devices (programming)
• Scripts orchestrate flows end-to-end; testbenches drive module verification via simulators.
• Soft CPU cores integrate into projects or run within FPGA designs.
Architectural Patterns
• Modular, plug-and-play IP blocks organized by function.
• Template-based code generation (bus interfaces, RAM blocks).
• Directory-per-category for scalability.
• Scripts as thin orchestration layer (architecture-as-code).
Essential Elements
• Clusters for each top‐level directory group.
• External toolchain and device targets.
• Scripts as automation connectors.