= Setting up the Project in XPS =

== Create New Project ==
 1. Start XPS via '''Program Files''' => '''Xilinx Platform Studio 8.2i''' => '''Xilinx Platform Studio'''
 2. At the '''Create new or open existing project''' window, select '''Base System Builder wizard (recommended)''' and click '''OK'''
 3. For '''Project file''', browse to the directory in which you would like to store your project.  Create a new folder within this directory and open it.  The file name should be ''system.xmp''.  Click '''Save'''. XPS will save all the various project files and folders in this project folder.  Click '''OK''' to move to tthe next window.
 4. The '''Base System Builder - Welcome''' window should appear.  Select '''I would like to create a new design''', and click '''Next'''
 5. At the '''Select Board''' window, make the following selections and click '''Next''':
   * Board vendor: ''Rice University CMC - WARP Project''
   * Board name: ''WARP FPGA and Radio Boards''
   * Board revision: ''1.0a''
 6. Make sure '''PowerPC''' is your selected processor.  Click '''Next'''
 7. The '''Configure PowerPC''' window should appear, make the following designations and click '''Next''':
   * Processor clock frequency: ''100.00 MHz''
   * Bus clock frequency:      ''50.00 MHz'' (Bus speed should always be half of processor speed)
   * Processor configuration: ''FPGA JTAG''
   * On-chip memory (OCM)
     * Data:        ''64 KB''
     * Instruction: ''128 KB''
   * Cache setup should be ''unchecked''
 8. The next windows are '''Configure IO Interfaces'''.  Depending on the size of your window, a varying number of IO devices will be available on each screen.  Make sure the following are checked (if an attribute is not enumerated, assume default configuration):
   * ''LED_7SEGMENT''
   * ''LED_7SEGMENT_1''
   * ''LEDs_4Bit''
   * ''Push_Buttons_4bit''
     * Check '''Use interrupt''' for the Push_buttons_4bit IO device.  IMPORTANT: If you fail to do so now, consult the [wiki:peripheral_test/helpfaq Help Documentation] to learn how to add them once the project is created. 
   * ''RS232''
     * Peripheral: ''OPB UARTLITE''
     * Baudrate: ''57600''
   * ''EEPROM_0''
   * ''DIPSWs_4bit''
   * '''UNCHECK''': ''SysACECompactFlash'', ''Ethernet_MAC'', ''radio_controller_0'', ''radio_bridge_slot_*'', ''SRAM0_ZBT_512Kx32'', and ''SRAM1_ZBT_512Kx32''
 9. At '''Add Internal Peripherals''', click '''Remove''' in the right of the '''plb_bram_if_cntlr_1''' box. Click '''Next'''
 10. At '''Software Setup''', UNCHECK '''Memory test''' and '''Peripheral selftest'''.  '''RS232''' should be chosen for '''STDIN''' and '''STDOUT'''.  Click '''Next'''. 
 11. If you chose to keep the "Memory test" or "Peripheral selftest" simply click '''NEXT''' through configuration menu(s). Click '''Generate''' at the '''System Created''' window.  Click '''Finish''' to exit the builder.  Click '''OK''' to begin using XPS.

== Setting up the Peripheral Test in XPS ==
 1. Click on the '''Applications''' tab in the left hand box.  Right-click on '''Add Software Application Project...''' and choose '''Add Software Application Project...'''.  Type in '''Peripheral Test''', and click '''OK'''.  You should see your project in the list of "Software Projects".
 2. Right-click on '''Sources''' and choose '''Add Existing Files...'''.  You will want to add the following *.c files:
   * ''warplib.c''
   * ''peripheral_test.c''
 3. Next, right-click on '''Headers''' and choose '''Add Existing Files...'''  You will want to add the following *.h file:
   * ''warplib.h''
 4. Right-click on '''Default: ppc405_0_bootloop''' in the right hand menu.  Uncheck '''Mark to Intialize BRAMs'''. 
 5. Right-click on '''Project: Peripheral Test''' and check '''Mark to Initialize BRAMs'''.  This step tells XPS to update the bitstream with your project.
 6. Right-click on '''Project: Peripheral Test''' and select '''Generate Linker Script'''.  Make sure that each article under the '''Memory''' drop down menus is either set to '''iocm_cntlr''' or '''docm_cntlr'''.  Click '''Generate'''
 7. Choose '''Update Bitstream''' by either accessing it through '''Device Configuration''' on the top menu, or by clicking on the toolbar button (it says "Bram Init" on it).  This process will take 10-15 minutes depending on your computing speed. Longer may indicate an improper setup (esp. steps 4,5,6 of this section).
 8. The file is now ready to download to the board.

For help, please refer to the '''[wiki:peripheral_test/helpfaq Help/FAQ]''' page.