How angelojacobo/uberddr3 works
Main Components
• DDR3 Controller Core:
– The central module (rtl/ddr3_top.v) instantiates the DDR3 controller.
– Within it, include sub-modules showing the high-level control path (command issuing, timing/delay tracking, reset and refresh logic).
– Highlight calibration components: PHY calibration (bitslip training, read/write alignment), command sequencing, and built-in self-test.
– Include the ECC/SECDEC unit as an optional processing block for error correction.
• Interface Blocks:
– Primary Wishbone Interface that links to the controller.
– Optional second-wishbone/debug interface.
– AXI4 interface (discussed in the README/blog posts) which may later be integrated.
• External Memory & I/O:
– Show the connection to the physical DDR3 memory via the DDR3 I/O ports (data lines, clocks, command signals, and associated constraint files).
– Include clock generation blocks (PLL/oscillator) that provide i_controller_clk, i_ddr3_clk, i_ref_clk, and optionally i_ddr3_clk_90.
• Simulation & Verification Environment:
– A simulation testbench block that instantiates the DDR3 memory controller with the Micron DDR3 model (as seen in testbench/).
– A formal verification block that refers to the SBY scripts in the formal folder.
• Demo Projects:
– A collection of board-specific demo projects (example_demo folders for various boards such as Arty-S7, Nexys Video, QMTech, etc.) that illustrate how the DDR3 controller is integrated and used.
Component Relationships and Data Flow
• Feedback loops such as calibration feedback from the PHY calibration block and error correction signals.
• Connection of clock generation blocks to both the controller and DDR3 interface.
Important Architectural Patterns and Principles
• Modularity: separate modules for interfaces (Wishbone, optional second-wishbone) and processing (controller logic, PHY calibration, ECC).
• Configurable nature of the design – note that many parameters (clock periods, address widths, lane configurations, etc.) are defined at the top level.
Relevant Technologies and Tools
• Under “RTL”, list key Verilog modules and IP cores (e.g., ddr3_controller.v, ECC modules, AXI bus wrappers).
• Under “Testbench/Simulation”, include the Micron DDR3 simulation model, Icarus Verilog/Yosys lint flows, and the run_compile.sh script.
• Under “Formal Verification”, indicate that SBY (Symbiyosys) scripts are used.
• If needed, mention that Vivado and OpenXC7 are used for synthesis on real FPGA boards.
Summary
– At the center: the generic memory controller IP.
– At the input side: interfaces (Wishbone/AXI) along with clock/reset logic.
– At the output side: an abstraction of the DDR3 physical interface.
– Additionally, show parallel branches for simulation/testbench and formal verification flows.
– Finally, reference how demo projects tie the abstract design into concrete board implementations with specific constraints files and vendor tools.