doc/html/user-guide/running-an-ecos-test-case.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Running an eCos Test Case</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos User Guide"
  20 HREF="ecos-user-guide.html"><LINK
  21 REL="UP"
  22 TITLE="Programming With eCos"
  23 HREF="user-guide-programming.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Ecosconfig on Windows and Linux Quick Start"
  26 HREF="using-ecosconfig-on-linux.html"><LINK
  27 REL="NEXT"
  28 TITLE="Using the command line"
  29 HREF="using-commandline-testcase.html"></HEAD
  30 ><BODY
  31 CLASS="CHAPTER"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos User Guide</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="using-ecosconfig-on-linux.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="using-commandline-testcase.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="CHAPTER"
  82 ><H1
  83 ><A
  84 NAME="RUNNING-AN-ECOS-TEST-CASE">Chapter 12. Running an <SPAN
  85 CLASS="PRODUCTNAME"
  86 >eCos</SPAN
  87 > Test Case</H1
  88 ><DIV
  89 CLASS="TOC"
  90 ><DL
  91 ><DT
  92 ><B
  93 >Table of Contents</B
  94 ></DT
  95 ><DT
  96 ><A
  97 HREF="running-an-ecos-test-case.html#USING-CONFIGTOOL-TESTCASE"
  98 >Using the <SPAN
  99 CLASS="APPLICATION"
 100 >Configuration Tool</SPAN
 101 ></A
 102 ></DT
 103 ><DT
 104 ><A
 105 HREF="using-commandline-testcase.html"
 106 >Using the command line</A
 107 ></DT
 108 ><DT
 109 ><A
 110 HREF="testing-filters.html"
 111 >Testing Filters</A
 112 ></DT
 113 ></DL
 114 ></DIV
 115 ><P
 116 >In <A
 117 HREF="using-configtool-windows-linux.html"
 118 >the Section called <I
 119 >Configuration Tool on Windows and Linux Quick Start</I
 120 > in Chapter 11</A
 121 > or <A
 122 HREF="using-ecosconfig-on-linux.html"
 123 >the Section called <I
 124 >Ecosconfig on Windows and Linux Quick Start</I
 125 > in Chapter 11</A
 126 > you created the <SPAN
 127 CLASS="PRODUCTNAME"
 128 >eCos</SPAN
 129 > test cases
 130 as part of the build process. Now it is time to try and run one.</P
 131 ><DIV
 132 CLASS="SECT1"
 133 ><H1
 134 CLASS="SECT1"
 135 ><A
 136 NAME="USING-CONFIGTOOL-TESTCASE">Using the <SPAN
 137 CLASS="APPLICATION"
 138 >Configuration Tool</SPAN
 139 ></H1
 140 ><P
 141 >Test executables that have been linked using the
 142 <SPAN
 143 CLASS="emphasis"
 144 ><I
 145 CLASS="EMPHASIS"
 146 >Build-&gt;Tests</I
 147 ></SPAN
 148 > operation against the current
 149 configuration can be executed by selecting <SPAN
 150 CLASS="emphasis"
 151 ><I
 152 CLASS="EMPHASIS"
 153 >Tools-&#62;Run
 154 Tests</I
 155 ></SPAN
 156 >.</P
 157 ><P
 158 >When a test run is invoked, a property sheet is displayed, see
 159 <A
 160 HREF="running-an-ecos-test-case.html#PROGRAMMING-RUN-TESTS"
 161 >Figure 12-1</A
 162 >. Press the <SPAN
 163 CLASS="emphasis"
 164 ><I
 165 CLASS="EMPHASIS"
 166 >Uncheck
 167 All</I
 168 ></SPAN
 169 > button and then find and check just one test,
 170 <TT
 171 CLASS="FILENAME"
 172 >bin_sem0</TT
 173 > for example.</P
 174 ><DIV
 175 CLASS="FIGURE"
 176 ><A
 177 NAME="PROGRAMMING-RUN-TESTS"><P
 178 ><B
 179 >Figure 12-1. Run tests</B
 180 ></P
 181 ><P
 182 ><IMG
 183 SRC="pix/run-tests.png"></P
 184 ></DIV
 185 ><P
 186 >Now press the <SPAN
 187 CLASS="emphasis"
 188 ><I
 189 CLASS="EMPHASIS"
 190 >Properties</I
 191 ></SPAN
 192 > button to set up
 193 communications with the target. This will bring up a properties dialog
 194 shown in <A
 195 HREF="running-an-ecos-test-case.html#PROGRAMMING-RUN-PROPERTIES"
 196 >Figure 12-2</A
 197 >. If you have
 198 connected the target board via a serial cable, check the
 199 <SPAN
 200 CLASS="emphasis"
 201 ><I
 202 CLASS="EMPHASIS"
 203 >Serial</I
 204 ></SPAN
 205 > radio button, and select the serial port
 206 and baud rate for the board. If the target is connected via the
 207 network select the <SPAN
 208 CLASS="emphasis"
 209 ><I
 210 CLASS="EMPHASIS"
 211 >TCP/IP</I
 212 ></SPAN
 213 > button and enter the IP
 214 address that the board has been given, and the port number (usually
 215 9000).</P
 216 ><DIV
 217 CLASS="FIGURE"
 218 ><A
 219 NAME="PROGRAMMING-RUN-PROPERTIES"><P
 220 ><B
 221 >Figure 12-2. Properties dialog box</B
 222 ></P
 223 ><P
 224 ><IMG
 225 SRC="pix/ch-properties-dialog.png"></P
 226 ></DIV
 227 ><P
 228 >Click OK on this dialog and go back to the <SPAN
 229 CLASS="emphasis"
 230 ><I
 231 CLASS="EMPHASIS"
 232 >Run
 233 Tests</I
 234 ></SPAN
 235 > dialog. Press the <SPAN
 236 CLASS="emphasis"
 237 ><I
 238 CLASS="EMPHASIS"
 239 >Run</I
 240 ></SPAN
 241 > button and
 242 the selected test will be downloaded and run. The
 243 <SPAN
 244 CLASS="emphasis"
 245 ><I
 246 CLASS="EMPHASIS"
 247 >Output</I
 248 ></SPAN
 249 > tab will show you how this is
 250 progressing. If it seems to stop for a long time, check that the
 251 target board is correctly connected, and that <SPAN
 252 CLASS="PRODUCTNAME"
 253 >eCos</SPAN
 254 > has been correctly
 255 configured -- especially the start-up type.</P
 256 ><P
 257 >When the program runs you should see a couple of line similar to this appear:</P
 258 ><TABLE
 259 BORDER="5"
 260 BGCOLOR="#E0E0F0"
 261 WIDTH="70%"
 262 ><TR
 263 ><TD
 264 ><PRE
 265 CLASS="PROGRAMLISTING"
 266 >PASS:&lt;Binary Semaphore 0 OK&gt;
 267 EXIT:&lt;done&gt;</PRE
 268 ></TD
 269 ></TR
 270 ></TABLE
 271 ><P
 272 >This indicates that the test has run successfully.</P
 273 ><P
 274 >See <A
 275 HREF="config-tool-test-execution.html"
 276 >Chapter 22</A
 277 > for
 278 further details.</P
 279 ></DIV
 280 ></DIV
 281 ><DIV
 282 CLASS="NAVFOOTER"
 283 ><HR
 284 ALIGN="LEFT"
 285 WIDTH="100%"><TABLE
 286 SUMMARY="Footer navigation table"
 287 WIDTH="100%"
 288 BORDER="0"
 289 CELLPADDING="0"
 290 CELLSPACING="0"
 291 ><TR
 292 ><TD
 293 WIDTH="33%"
 294 ALIGN="left"
 295 VALIGN="top"
 296 ><A
 297 HREF="using-ecosconfig-on-linux.html"
 298 ACCESSKEY="P"
 299 >Prev</A
 300 ></TD
 301 ><TD
 302 WIDTH="34%"
 303 ALIGN="center"
 304 VALIGN="top"
 305 ><A
 306 HREF="ecos-user-guide.html"
 307 ACCESSKEY="H"
 308 >Home</A
 309 ></TD
 310 ><TD
 311 WIDTH="33%"
 312 ALIGN="right"
 313 VALIGN="top"
 314 ><A
 315 HREF="using-commandline-testcase.html"
 316 ACCESSKEY="N"
 317 >Next</A
 318 ></TD
 319 ></TR
 320 ><TR
 321 ><TD
 322 WIDTH="33%"
 323 ALIGN="left"
 324 VALIGN="top"
 325 >Ecosconfig on Windows and Linux Quick Start</TD
 326 ><TD
 327 WIDTH="34%"
 328 ALIGN="center"
 329 VALIGN="top"
 330 ><A
 331 HREF="user-guide-programming.html"
 332 ACCESSKEY="U"
 333 >Up</A
 334 ></TD
 335 ><TD
 336 WIDTH="33%"
 337 ALIGN="right"
 338 VALIGN="top"
 339 >Using the command line</TD
 340 ></TR
 341 ></TABLE
 342 ></DIV
 343 ></BODY
 344 ></HTML
 345 >