====== Adding DDR Memory to a Microblaze Design ======

===== Add the MIG IP =====
/*add_the_mig_ip*/
When creating a design with DDR, it's best to add the DDR interface first, as it is typically also used to generate the clock or clocks that will be used by the rest of your design.

<columns 100% 50%>
In the Board tab, right click on the DDR interface and select "Auto Connect". This process will add a MIG and the external DDR interface to the design. Two clock pins are also created, which will need to be modified.
<newcolumn>
{{auto-connect-ddr.png?600|}}
</columns>
----
===== MIG Clocking =====
<columns 100% 50%>
Delete the "clk_ref_i" pin. This can be accomplished either by right-clicking on the pin and selecting delete or by selecting and pressing the delete key.
<newcolumn>
{{delete-clk-ref.png?600|}}
</columns>
----


<columns 100% 50%>
Verify that the "ui_addn_clk_0" pin has a frequency near 200 MHz by selecting it and looking at the "Frequency" value in the "Block Pin Properties" pane.
<newcolumn>
{{check-ui-addn-clk-properties.png?600|}}
</columns>
----

<columns 100% 50%>
Manually connect the "ui_addn_clk_0" pin to the "clk_ref_i" pin by clicking and dragging from one to the other.
<newcolumn>
{{create-clk-loopback.png?600|}}
</columns>
----

It's important to note that the "sys_clk_i" pin will not be constrained by the board files, and you will need to add a constraint file to map it to the corresponding pin location on the FPGA.

{{section>vivado-add-xdc&noheader}}

----

<columns 100% 50%>
Find the set_property and create_clock constraints for your board's 100 MHz input clock, uncomment them by removing the ''#'' at the start of each line, and change the name of the //port// that they are constraining to ''sys_clk_i'', to match the name of the port in the block design.

If your board has multiple clocks, the 100 MHz one can be determined by observing that the create_clock constraint specifies a ''10.000'' ns period, as seen in the screenshot to the right.

Make sure to save your changes.
<newcolumn>
{{ :programmable-logic:guides:change-port-name.png?600 |}}
</columns>

----
===== MIG Reset =====
<columns 100% 50%>
Next, the MIG's reset pin will be connected to the board's reset button. Click "Run Connection Automation" in the green bar at the top of the window.
<newcolumn>
{{run-reset-automation.png?600|}}
</columns>
----

<columns 100% 50%>
In the list to the left side of the dialog that pops up, make sure that the "sys_rst" box is checked. Click **OK** to connect the reset to the corresponding board part interface.
<newcolumn>
{{run-reset-automation-wizard.png?600|}}
</columns>
----

===== Other MIG Ports =====

The MIG block may have other ports which will need to be connected to ensure that it works correctly. This section discusses each of those ports.

--> Open this dropdown if your MIG has a "device_temp_i" port #
<columns 100% 50%>
If your MIG block has a "device_temp_i" port, it means that the MIG is not using the chip's XADC analog-to-digital converter feature. We'll ground this port to prevent any warnings that it may throw. Add a "Constant" IP to the design.
<newcolumn>
{{add-const.png?600|}}
</columns>
----
<columns 100% 50%>
Double click on the block to open it's configuration wizard and modify it to have a Value of "0" and a Width of "12".
<newcolumn>
{{configure-const.png?600|}}
</columns>
----
<columns 100% 50%>
Connect its output port to the "device_temp_i" port on the MIG.
<newcolumn>
{{connect-const-to-temp.png?600|}}
</columns>
<--
----

===== Additional Clocks =====
If your design requires more clocks than just the ui_clk provided by the MIG, you will need to add a clocking wizard IP that is driven by the MIG's ui_clk.

<columns 100% 50%>
Use the Add IP button to search for and add a Clocking Wizard to the design.
<newcolumn>
{{add-clocking-wizard-ip.png?600|}}
</columns>
----
<columns 100% 50%>
Manually connect the Clocking Wizard's clk_in1 and reset ports to the MIG's ui_clk and ui_clk_sync_rst ports, respectively.
<newcolumn>
{{connect-wizard.png?600|}}
</columns>
----
<columns 100% 50%>
Finally, double-click on the Clocking Wizard to open and configure it. The third tab, //Output Clocks// contains all of the settings required to specify how many clocks you need, and of what frequencies. The screenshot to the right shows the wizard configured to create a 100 MHz clk_out1 and a 50 MHz clk_out2.

If your design requires additional clocks (such as for an ext_spi_clock pin), they should be added here.
<newcolumn>
{{configure-clocks.png?600|}}
</columns>

**Note:** //If you aren't sure that you have all of the clocks you need, don't worry, you can always come back and add them by reconfiguring this IP. This task can be performed whenever in the design process it becomes necessary.//
----
===== MIG Success =====
<columns 100% 50%>
At the end of this process, the block design will look something like this:
<newcolumn>
{{connect-wizard.png?600|}}
</columns>
----
===== Connect the MIG to the Microblaze Processor =====
<columns 100% 50%>
To connect the MIG's AXI interface to the processor, click the **Run Connection Automation** button in the green banner at the top of the block design.
<newcolumn>
{{ :programmable-logic:guides:run-connection-automation.png?600 |}}
</columns>
----
<columns 100% 50%>
In the dialog that pops up, you will be presented with several options for interfaces that can be connected to other interfaces. Both the Microblaze's IC and DC ports, as well as the MIG's AXI port will appear. You should only run connection automation for one side of the connection - the S_AXI port, as shown in the screenshot to the right. Make sure that its box is checked. Check that the //Master interface// is set to "/microblaze_0 (Cached)", indicating that the microblaze local memory will act as a cache for the DDR memory, then click **OK** to make the connections.
<newcolumn>
{{ :programmable-logic:guides:connection-automation.png?600 |}}
</columns>