[284] | 1 | %Copyright (c) 2006 Rice University |
---|
| 2 | %All Rights Reserved |
---|
| 3 | %This code is covered by the Rice-WARP license |
---|
| 4 | %See http://warp.rice.edu/license/ for details |
---|
[201] | 5 | \section{Setting up the Project in XPS} |
---|
| 6 | \subsection{Create New Project} |
---|
| 7 | \begin{enumerate} |
---|
| 8 | %Step 1 |
---|
| 9 | \item Start XPS via \textbf{Program Files} $\rightarrow$ \textbf{Xilinx Platform Studio 8.1i} $\rightarrow$ \textbf{Xilinx Platform Studio} |
---|
| 10 | %Step 2 |
---|
| 11 | \item At the \textbf{Create new or open existing project} window, select \textbf{Base System Builder} wizard (recommended) and click \textbf{OK} |
---|
| 12 | |
---|
| 13 | |
---|
| 14 | |
---|
| 15 | \begin{figure}[htp] |
---|
| 16 | \centering |
---|
| 17 | |
---|
| 18 | \includegraphics[width=1.00\textwidth]{SWScreenshots/SW1p2.pdf} |
---|
| 19 | \caption{Step 2 -- Opening Dialog Box} |
---|
| 20 | \label{fig:SW1p2} |
---|
| 21 | \end{figure} |
---|
| 22 | |
---|
| 23 | %Step 3 |
---|
| 24 | \item For \textbf{Project file}, Either: |
---|
| 25 | \begin{enumerate} |
---|
| 26 | \item Enter: \textbf{C:/WARP/BoardTests/IOTest/system.xmp}. \\Click \textbf{OK} and click \textbf{Yes} when asked if you would like to create the directory; OR |
---|
| 27 | \item 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 \textbf{Save}. XPS will save all the various project files and folders in this project folder. Click \textbf{OK} to move to tthe next window. |
---|
| 28 | \item This readme assumes method one when giving locations. You must adjust your addresses accordingly if choosing to save the system elsewhere. |
---|
| 29 | \end{enumerate} |
---|
| 30 | |
---|
| 31 | \begin{figure}[htp] |
---|
| 32 | \centering |
---|
| 33 | \includegraphics[width=.75\textwidth]{SWScreenshots/SW1p3a.pdf} |
---|
| 34 | \caption{Step 3 -- Choose a directory for \textit{system.xmp}} |
---|
| 35 | \label{fig:SW1p3a} |
---|
| 36 | \end{figure} |
---|
| 37 | |
---|
| 38 | \begin{figure}[htp] |
---|
| 39 | \centering |
---|
| 40 | \includegraphics[width=.75\textwidth]{SWScreenshots/SW1p3b.pdf} |
---|
| 41 | \caption{Step 3 -- Click \textbf{Yes} to create the directory.} |
---|
| 42 | \label{fig:SW1p3b} |
---|
| 43 | \end{figure} |
---|
| 44 | |
---|
| 45 | \newpage |
---|
| 46 | %Step4%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 47 | \item The \textbf{Base System Builder - Welcome} window should appear. Select \textbf{I would like to create a new design}, and click \textbf{Next} |
---|
| 48 | \vspace{.5in} |
---|
| 49 | \begin{figure}[htbp] |
---|
| 50 | \centering |
---|
| 51 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p4.pdf} |
---|
| 52 | \caption{Step 4 -- Welcome Screen} |
---|
| 53 | \label{fig:SW1p4} |
---|
| 54 | \end{figure} |
---|
| 55 | |
---|
| 56 | \newpage |
---|
| 57 | %Step 5%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 58 | \item At the \textbf{Select Board} window, make the following selections and click \textbf{Next}: |
---|
| 59 | \begin{itemize} |
---|
| 60 | \item Board vendor: \textit{Rice University CMC - WARP Project} |
---|
| 61 | \item Board name: \textit{WARP FPGA and Radio Boards} |
---|
| 62 | \item Board revision: \textit{1.0b} |
---|
| 63 | \end{itemize} |
---|
| 64 | \vspace{.25in} |
---|
| 65 | \begin{figure}[htbp] |
---|
| 66 | \centering |
---|
| 67 | \includegraphics[width=.8\textwidth]{SWScreenshots/SW1p5.pdf} |
---|
| 68 | \caption{Step 5 -- \textbf{Select Board} window} |
---|
| 69 | \label{fig:SW1p5} |
---|
| 70 | \end{figure} |
---|
| 71 | |
---|
| 72 | \newpage |
---|
| 73 | %Step 6 |
---|
| 74 | \item Make sure \textbf{PowerPC} is your selected processor. Click \textbf{Next} |
---|
| 75 | \vspace{.5in} |
---|
| 76 | \begin{figure}[htbp] |
---|
| 77 | \centering |
---|
| 78 | \includegraphics[width=.8\textwidth]{SWScreenshots/SW1p6.pdf} |
---|
| 79 | \caption{Step 6 -- Processor Selection window} |
---|
| 80 | \label{fig:SW1p6} |
---|
| 81 | \end{figure} |
---|
| 82 | |
---|
| 83 | \newpage |
---|
| 84 | %Step 7 |
---|
| 85 | \item The \textbf{Configure PowerPC} window should appear, make the following designations and click \textbf{Next}: |
---|
| 86 | \begin{itemize} |
---|
| 87 | \item Processor clock frequency: \textit{100.00 MHz} |
---|
| 88 | \item Bus clock frequency: \textit{50.00 MHz} |
---|
| 89 | \item Processor configuration: \textit{FPGA JTAG} |
---|
| 90 | \item On-chip memory (OCM) |
---|
| 91 | \begin{itemize} |
---|
| 92 | \item Data: \textit{64 KB} |
---|
| 93 | \item Instruction: \textit{128 KB} |
---|
| 94 | \end{itemize} |
---|
| 95 | \item Cache setup should be \textit{unchecked} |
---|
| 96 | \end{itemize} |
---|
| 97 | |
---|
| 98 | |
---|
| 99 | \begin{figure}[htbp] |
---|
| 100 | \centering |
---|
| 101 | \includegraphics[width=.70\textwidth]{SWScreenshots/SW1p7.pdf} |
---|
| 102 | \caption{Step 7 -- Configure PowerPC} |
---|
| 103 | \label{fig:SW1p7} |
---|
| 104 | \end{figure} |
---|
| 105 | |
---|
| 106 | \newpage |
---|
| 107 | %Step 8 |
---|
| 108 | \item The next windows are \textbf{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): |
---|
| 109 | \begin{itemize} |
---|
| 110 | \item \textit{LED\_7SEGMENT} |
---|
| 111 | \item \textit{LED\_7SEGMENT\_1} |
---|
| 112 | \item \textit{LEDs\_4Bit} |
---|
| 113 | \item \textit{Push\_Buttons\_4bit} |
---|
| 114 | \begin{itemize} |
---|
| 115 | \item Check \textbf{Use interrupt} for the Push\_buttons\_4bit IO device.\\ IMPORTANT: If you fail to do so now, consult the Help Documentation to learn how to add them once the project is created. |
---|
| 116 | \end{itemize} |
---|
| 117 | \item \textit{RS232} |
---|
| 118 | \begin{itemize} |
---|
| 119 | \item Peripheral: \textit{OPB UARTLITE} |
---|
| 120 | \item Baudrate: \textit{57600} |
---|
| 121 | \end{itemize} |
---|
| 122 | \item \textit{DIPSWs\_4bit} |
---|
| 123 | \item \textbf{UNCHECK}: \textit{SysACECompactFlash}, \textit{Ethernet\_MAC},\textit{onewire\_0}, \\\textit{radio\_controller\_0}, \textit{radio\_bridge\_slot\_2}, \textit{SRAM0\_ZBT\_512Kx32}, \\and \textit{SRAM1\_ZBT\_512Kx32} |
---|
| 124 | \end{itemize} |
---|
| 125 | |
---|
| 126 | \begin{figure}[htbp] |
---|
| 127 | \centering |
---|
| 128 | \includegraphics[width=.9\textwidth]{SWScreenshots/SW1p8a.pdf} |
---|
| 129 | \caption{Step 8 -- Choosing Peripherals} |
---|
| 130 | \label{fig:SW1p8a} |
---|
| 131 | \end{figure} |
---|
| 132 | |
---|
| 133 | \begin{figure}[htbp] |
---|
| 134 | \centering |
---|
| 135 | \includegraphics[width=.9\textwidth]{SWScreenshots/SW1p8b.pdf} |
---|
| 136 | \caption{Step 8 -- Choosing Peripherals cont.} |
---|
| 137 | \label{fig:SW1p8b} |
---|
| 138 | \end{figure} |
---|
| 139 | |
---|
| 140 | \begin{figure}[htbp] |
---|
| 141 | \centering |
---|
| 142 | \includegraphics[width=.9\textwidth]{SWScreenshots/SW1p8c.pdf} |
---|
| 143 | \caption{Step 8 -- Choosing Peripherals cont.} |
---|
| 144 | \label{fig:SW1p8c} |
---|
| 145 | \end{figure} |
---|
| 146 | |
---|
| 147 | \begin{figure}[htbp] |
---|
| 148 | \centering |
---|
| 149 | \includegraphics[width=.9\textwidth]{SWScreenshots/SW1p8d.pdf} |
---|
| 150 | \caption{Step 8 -- Choosing Peripherals cont.} |
---|
| 151 | \label{fig:SW1p8d} |
---|
| 152 | \end{figure} |
---|
| 153 | |
---|
| 154 | \newpage |
---|
| 155 | %Step 9 |
---|
| 156 | \item At \textbf{Add Internal Peripherals}, click \textbf{Remove} to the right of the\\ \textbf{plb\_bram\_if\_cntlr\_1 box}. Click \textbf{Next} |
---|
| 157 | \vspace{.25in} |
---|
| 158 | \begin{figure}[htbp] |
---|
| 159 | \centering |
---|
| 160 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p9a.pdf} |
---|
| 161 | \caption{Step 9 -- Before Removing} |
---|
| 162 | \label{fig:SW1p9a} |
---|
| 163 | \end{figure} |
---|
| 164 | |
---|
| 165 | \begin{figure}[htbp] |
---|
| 166 | \centering |
---|
| 167 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p9b.pdf} |
---|
| 168 | \caption{Step 9 -- After Removing} |
---|
| 169 | \label{fig:SW1p9b} |
---|
| 170 | \end{figure} |
---|
| 171 | |
---|
| 172 | |
---|
| 173 | \newpage |
---|
| 174 | %Step 10%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 175 | \item At \textbf{Software Setup}, UNCHECK \textbf{Memory test} and \textbf{Peripheral selftest}. \textbf{RS232} should be chosen for \textbf{STDIN} and \textbf{STDOUT}. Click \textbf{Next}. |
---|
| 176 | \vspace{.25in} |
---|
| 177 | \begin{figure}[htbp] |
---|
| 178 | \centering |
---|
| 179 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p10.pdf} |
---|
| 180 | \caption{Step 10 -- Software Setup} |
---|
| 181 | \label{fig:SW1p10} |
---|
| 182 | \end{figure} |
---|
| 183 | |
---|
| 184 | \newpage |
---|
| 185 | %Step 11 |
---|
| 186 | \item If you chose to keep the ``Memory test'' or ``Peripheral selftest'' simply click \textbf{NEXT} through configuration menu(s). Click \textbf{Generate} at the \textbf{System Created} window. Click \textbf{Finish} to exit the builder. Click \textbf{OK} to beging using XPS. |
---|
| 187 | \end{enumerate} |
---|
| 188 | |
---|
| 189 | \begin{figure}[htbp] |
---|
| 190 | \centering |
---|
| 191 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p11a.pdf} |
---|
| 192 | \caption{Step 11 -- Generate File} |
---|
| 193 | \label{fig:SW1p11a} |
---|
| 194 | \end{figure} |
---|
| 195 | |
---|
| 196 | \begin{figure}[htbp] |
---|
| 197 | \centering |
---|
| 198 | \includegraphics[width=.80\textwidth]{SWScreenshots/SW1p11b.pdf} |
---|
| 199 | \caption{Step 11 -- Finish} |
---|
| 200 | \label{fig:SW1p11b} |
---|
| 201 | \end{figure} |
---|
| 202 | |
---|
| 203 | \begin{figure}[htbp] |
---|
| 204 | \centering |
---|
| 205 | \includegraphics[width=1.00\textwidth]{SWScreenshots/SW1p11c.pdf} |
---|
| 206 | \caption{Step 11 -- Start Working} |
---|
| 207 | \label{fig:SW1p11c} |
---|
| 208 | \end{figure} |
---|
| 209 | |
---|
| 210 | \begin{figure}[htbp] |
---|
| 211 | \centering |
---|
| 212 | \includegraphics[width=1.00\textwidth]{SWScreenshots/SW1p12.pdf} |
---|
| 213 | \caption{XPS Workspace after Base System Builder} |
---|
| 214 | \label{fig:SW1p12} |
---|
| 215 | \end{figure} |
---|
| 216 | |
---|
| 217 | |
---|
| 218 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 219 | %New Subsection |
---|
| 220 | |
---|
| 221 | \newpage |
---|
| 222 | \subsection{Setting up the UserIO Test in XPS} |
---|
| 223 | \begin{enumerate} |
---|
| 224 | |
---|
| 225 | %Step 1%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 226 | \item Click on the \textbf{Applications} tab in the left hand box. Right-click on \textbf{Add Software Application Project...} and choose \textbf{Add Software Application Project...} Type in \textbf{UserIOTest}, and click \textbf{OK}. You should see you project in the list of ``Software Projects''. |
---|
| 227 | |
---|
| 228 | \begin{figure}[htbp] |
---|
| 229 | \centering |
---|
| 230 | \includegraphics[width=.70\textwidth]{SWScreenshots/SW2p1a.pdf} |
---|
| 231 | \caption{Step 1 -- Adding a Software Project} |
---|
| 232 | \label{fig:SW2p1} |
---|
| 233 | \end{figure} |
---|
| 234 | |
---|
| 235 | \begin{figure}[htbp] |
---|
| 236 | \centering |
---|
| 237 | \includegraphics[width=.40\textwidth]{SWScreenshots/SW2p1.pdf} |
---|
| 238 | \caption{Step 1 -- Name the project: UserIOTest} |
---|
| 239 | \label{fig:SW2p1a} |
---|
| 240 | \end{figure} |
---|
| 241 | |
---|
| 242 | \newpage |
---|
| 243 | %Step 2%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 244 | \item Right-click on \textbf{Sources} and choose \textbf{Add Existing Files...} \\Browse to \textbf{c:/WARP/BoardTests/Files}. You will want to add the following *.c files: |
---|
| 245 | \begin{itemize} |
---|
| 246 | \item \textit{warplib.c} |
---|
| 247 | \item \textit{UserIOTest.c} |
---|
| 248 | \end{itemize} |
---|
| 249 | |
---|
| 250 | \begin{figure}[htbp] |
---|
| 251 | \centering |
---|
| 252 | |
---|
| 253 | \includegraphics[width=.40\textwidth]{SWScreenshots/SW2p2a.pdf} |
---|
| 254 | \caption{Step 2 -- Adding Source Files} |
---|
| 255 | \label{fig:SW2p2a} |
---|
| 256 | \end{figure} |
---|
| 257 | |
---|
| 258 | \begin{figure}[htbp] |
---|
| 259 | \centering |
---|
| 260 | \includegraphics[width=.7\textwidth]{SWScreenshots/SW2p2b.pdf} |
---|
| 261 | \caption{Step 2 -- Select: UserIOTest.c and warplib.c} |
---|
| 262 | \label{fig:SW2p2b} |
---|
| 263 | \end{figure} |
---|
| 264 | |
---|
| 265 | \newpage\newpage |
---|
| 266 | %Step 3%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 267 | \item Next, right-click on \textbf{Headers} and choose \textbf{Add Existing Files...} You should already be in the correct folder. \\If you do not see \textit{warplib.h}, browse to \textbf{c:/WARP/BoardTests/Files}. You will want to add the following *.h file: |
---|
| 268 | \begin{itemize} |
---|
| 269 | \item \textit{warplib.h} |
---|
| 270 | \end{itemize} |
---|
| 271 | |
---|
| 272 | |
---|
| 273 | \begin{figure}[htp] |
---|
| 274 | \centering |
---|
| 275 | \includegraphics[width=.40\textwidth]{SWScreenshots/SW2p3a.pdf} |
---|
| 276 | \caption{Step 3 -- Adding Header Files} |
---|
| 277 | \label{fig:SW2p3a} |
---|
| 278 | \end{figure} |
---|
| 279 | |
---|
| 280 | \begin{figure}[htp] |
---|
| 281 | \centering |
---|
| 282 | \includegraphics[width=.65\textwidth]{SWScreenshots/SW2p3b.pdf} |
---|
| 283 | \caption{Step 3 -- Select: warplib.h} |
---|
| 284 | \label{fig:SW2p3b} |
---|
| 285 | \end{figure} |
---|
| 286 | |
---|
| 287 | \newpage |
---|
| 288 | %Step 4%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 289 | \item Right-click on \textbf{Default: ppc405\_0\_bootloop} in the right hand menu. Uncheck \textbf{Mark to Intialize BRAMs}. Afterward, there should be a red `x' over the green arrow next to the name. |
---|
| 290 | |
---|
| 291 | |
---|
| 292 | \begin{figure}[htp] |
---|
| 293 | \centering |
---|
| 294 | \includegraphics[width=.50\textwidth]{SWScreenshots/SW2p4.pdf} |
---|
| 295 | \caption{Step 4 -- Uninitializing BRAMs for the Default} |
---|
| 296 | \label{fig:SW2p4} |
---|
| 297 | \end{figure} |
---|
| 298 | |
---|
| 299 | %\newpage |
---|
| 300 | %Step 5%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 301 | \item Right-click on \textbf{Project: UserIOTest} and check \textbf{Mark to Initialize BRAMs}. This step tells XPS to update the bitstream with your project. Afterward, there should no longer be a red `x' over the green arrow next to the name. |
---|
| 302 | |
---|
| 303 | |
---|
| 304 | \begin{figure}[htbp] |
---|
| 305 | \centering |
---|
| 306 | \includegraphics[width=.50\textwidth]{SWScreenshots/SW2p5.pdf} |
---|
| 307 | \caption{Step 5 -- Initializing BRAMs for UserIOTest} |
---|
| 308 | \label{fig:SW2p5} |
---|
| 309 | \end{figure} |
---|
| 310 | |
---|
| 311 | \newpage |
---|
| 312 | %Step 6%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 313 | \item Right-click on \textbf{Project: UserIOTest} and select \textbf{Generate Linker Script}. Make sure that each article under the \textbf{Memory} drop down menus is either set to \textbf{iocm\_cntlr} or \textbf{docm\_cntlr}. Click \textbf{Generate} |
---|
| 314 | |
---|
| 315 | |
---|
| 316 | \begin{figure}[htp] |
---|
| 317 | \centering |
---|
| 318 | \includegraphics[width=.40\textwidth]{SWScreenshots/SW2p6a.pdf} |
---|
| 319 | \caption{Step 6 -- Generate Linker Script} |
---|
| 320 | \label{fig:SW2p6a} |
---|
| 321 | \end{figure} |
---|
| 322 | |
---|
| 323 | \begin{figure}[htp] |
---|
| 324 | \centering |
---|
| 325 | \includegraphics[width=.75\textwidth]{SWScreenshots/SW2p6b.pdf} |
---|
| 326 | \caption{Step 6 -- Set memory to iocm\_cntlr or docm\_cntlr} |
---|
| 327 | \label{fig:SW2p6b} |
---|
| 328 | \end{figure} |
---|
| 329 | |
---|
| 330 | \newpage |
---|
| 331 | %Step 7%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 332 | \item Choose \textbf{Update Bitstream} by either accessing it through \textbf{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). |
---|
| 333 | |
---|
| 334 | |
---|
| 335 | \begin{figure}[htbp] |
---|
| 336 | \centering |
---|
| 337 | \includegraphics[width=.70\textwidth]{SWScreenshots/SW2p7.pdf} |
---|
| 338 | \caption{Step 7 -- Update Bitstream} |
---|
| 339 | \label{fig:SW2p7} |
---|
| 340 | \end{figure} |
---|
| 341 | |
---|
| 342 | |
---|
| 343 | %Step 8%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 344 | \item The file is now ready to download to the board. |
---|
| 345 | \end{enumerate} |
---|
| 346 | For help, please refer to the Help/FAQ page. |
---|