Prerequisites

Hardware Prerequisites

• Required: XUP Virtex-II PRO evaluation board, sold by Digilent Inc.

• Required: KVR266X64C25/256 256MB DDR RAM module, sold by Digilent Inc. (and other vendors). NOTE: You have to press down very firmly to insert the memory card; Make sure its key hole is lined up and then press down hard until the side clips snap into the DIMM.

  WARNING: Digilent also sells a 512MB module. This will not work. You must have the specific 256MB module for this tutorial.

• Optional: Compact Flash card

Good, properly inserted DIMM (the DIMM is pressed down and the clips are snapped into the sides):

Bad, improperly inserted DIMM (the DIMM needs to be pressed down further until the clips can snap into the sides):

This figure shows the XUP board with the 256MB DIMM and Compact Flash card installed:

Create a New Project

1. Launch a new XPS session and choose "Base System Builder wizard":

2. Choose a location for the project file, "system.xmp":

3. Set "Project Peripheral Repositories" to the contents of "lib_xupv2p_edk_10_1_sp3.zip":

4. Select "I would like to create a new design":

5. Select "XUP Virtex-II Pro Development System":

6. Click "Next" (accepting defaults):

7. Increase the CPU frequency to 200 MHz. Enable the cache:

8. Increase the RS232 baud rate and select "Use interrupt" for each peripheral:

9. Click "Next" (accepting defaults):

10. Choose 16 kB of RAM (or more). Do not choose 8 kB, as this is not supported by the Virtex-II PRO. You must have BRAM so that the bootloop can be stored at address 0xfffffffc:

11. Choose to enable ICache and DCache for DDR_SDRAM. (This causes the wizard to insert "XCache_EnableICache" and "XCache_EnableDCache" calls into the TestApp C code, later):

12. Click "Next" (accepting defaults):

13. Click "Next" (accepting defaults):

14. Click "Next" (accepting defaults):

15. Click "Generate":

16. Now, you have an almost ready-to-build system-on-chip project as shown here:

17. The next step is to turn on double buffering (aka "ping-pong" buffers) for the xps_ethernetlite core (double click on "Ethernet_MAC" from the "System Assembly View"):

18. Build your project (Choose the menu option: "Device Configuration: Update Bistream").
19. Build and run the TestApp programs to do a basic checkout of your board.
20. Generate the Linux device tree. When you are done running basic software tests, it is time to reconfigure EDK to generate a Linux device tree. Click the menu "Software: Software Platform Settings..." and then choose "device-tree" as the OS (Note: if you do not see this option, it is because you did not copy the device tree generator as described in the section Software Prerequisites):

21. Set "console device" to your UART. Update "bootargs" to include "console=ttyUL0":

22. Click "OK" to finish with Software Platform Settings

23. Generate the device tree by clicking the menu: "Software: Generate Libraries and BSPs". The following file will be created inside your EDK project directory:

    ./ppc405_0/libsrc/device-tree/xilinx.dts
    

    This file (xilinx.dts) will be used to help build Linux (which is described in the next tutorial).

    This file is a plain text file and you are encouraged to open in it and have a look. It's contents look something like this excerpt:

    /dts-v1/;
    / {
      #address-cells = <1>;
      #size-cells = <1>;
      compatible = "xlnx,virtex405", "xlnx,virtex";
      model = "testing";
      DDR_SDRAM: memory@0 {
        device_type = "memory";
        reg = < 0x0 0x10000000 >;
      } ;
      chosen {
        bootargs = "console=ttyUL0 root=/dev/ram";
        linux,stdout-path = "/plb@0/serial@84000000";
      } ;
      cpus {
        #address-cells = <1>;
        #cpus = <0x1>;
        #size-cells = <0>;
        ppc405_0: cpu@0 {
          clock-frequency = <200000000>;
          <*snip*>
        } ;
      } ;
      plb0: plb@0 {
        #address-cells = <1>;
        #size-cells = <1>;
        compatible = "xlnx,plb-v46-1.03.a", "simple-bus";
        ranges ;
        <*snip*>
        Ethernet_MAC: ethernet@81000000 {
          compatible = "xlnx,xps-ethernetlite-2.00.b";
          device_type = "network";
          interrupt-parent = <&xps_intc_0>;
          interrupts = < 1 0 >;
          local-mac-address = [ 02 00 00 00 00 00 ];
          reg = < 0x81000000 0x10000 >;
          xlnx,duplex = <0x1>;
          xlnx,family = "virtex2p";
          xlnx,rx-ping-pong = <0x1>;
          xlnx,tx-ping-pong = <0x1>;
        } ;
        RS232_Uart_1: serial@84000000 {
          clock-frequency = <100000000>;
          compatible = "xlnx,xps-uartlite-1.00.a";
          current-speed = <115200>;
          device_type = "serial";
          interrupt-parent = <&xps_intc_0>;
          interrupts = < 2 0 >;
          port-number = <0>;
          reg = < 0x84000000 0x10000 >;
          xlnx,baudrate = <0x1c200>;
          xlnx,data-bits = <0x8>;
          xlnx,family = "virtex2p";
          xlnx,odd-parity = <0x0>;
          xlnx,use-parity = <0x0>;
        } ;
        <*snip*>
      }  ;
    }  ;
    

Downloads

Files for download:

• 20090211-v2pro-linux-edk.tar.gz (md5sum: bbc3ee171670f77cffa8ecbc3f79cd4d)

  This is a reference design which has all the steps from previous sections applied and is ready to use with EDK 10.1 SP3. This tar file also contains "download.bit" and "xilinx.dts" so that you don't have to compile anything.