How skandakm29/vsd_sqaudron_mini_fpga works
Overall System Context
• Toolchain used for synthesis and implementation (Yosys for synthesis, NextPNR for place-and-route, and IceStorm for bitstream generation) to capture the build flow.
Main Architectural Components
• FPGA Core: Represent the VSD Squadron Mini FPGA board as the central node.
• Project-specific Functional Blocks:
– LED Control Block (for the Blink LED project)
– UART Components: Separate blocks for UART Transmitter, UART Loopback, and UART Sensor-based transmission. For the sensor projects, also add a “Sensor Interface” block (e.g., for ultra_sonic sensor integration).
• External Interfaces: Show any additional connections such as the programming/debug interface (FTDI interface), physical UART ports, and possible sensor connections.
• Design Flow: Include the synthesis and implementation steps, showing directional data flow from Verilog source files (as seen in files like top.v, uart_trx.v, ultra_sonic_sensor.v) to synthesis (Yosys), then to placement (NextPNR) and finally bitstream generation (IceStorm).
• For the UART loopback design, highlight the bidirectional flow (i.e., TX and RX loops) between the UART component and the board’s I/O interfaces.
• The build process should be shown in a sequential manner: source code ➔ Makefile-based build trigger ➔ synthesis (Yosys) ➔ place & route (NextPNR) ➔ programming (IceStorm) ➔ flash to FPGA.
Architectural Patterns and Technologies
• That the project employs a modular design approach: each project directory contains its own Makefile and README, emphasizing a componentized strategy.
• Mention the usage of Verilog as the hardware description language and the open-source tools that form the FPGA development toolchain.
• Simulation or testbenches available (e.g., ultra_sonic_sensor_tb.v) and how they help validate functionality.
Instructing the Principal Software Engineer
• A “Sensor Acquisition Module” that includes the ultra_sonic_sensor (and its testbench where applicable).
• A “UART Communication Module” that further splits into submodules for loopback, transmitter, and sensor-based UART communications.
• A “LED Control Module” for the blink project.
• Build and toolchain flow with labeled steps: “Synthesis (Yosys)” ➔ “Place & Route (NextPNR)” ➔ “Bitstream Generation (IceStorm)” ➔ “Programming (Flash via FTDI).”
• Annotations detailing key technologies (Verilog, Yosys, NextPNR, IceStorm) and specify that each project’s source files (Makefile, *.v, *.pcf, etc.) contribute to its specific functionality.