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 |
---|
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. |
---|