doc/html/user-guide/setup-tx39-sim.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 >TX39 Architectural Simulator Setup</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="Target Setup"
  23 HREF="appendix-target-setup.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="TX39 Hardware Setup"
  26 HREF="setup-tx39-jmr3904.html"><LINK
  27 REL="NEXT"
  28 TITLE="TX49 Hardware Setup"
  29 HREF="setup-tx49-ref4955.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  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="setup-tx39-jmr3904.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Appendix A. Target Setup</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="setup-tx49-ref4955.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="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="SETUP-TX39-SIM">TX39 Architectural Simulator Setup</H1
  86 ><P
  87 >The TX39 simulator is an architectural simulator which implements
  88 all  the features of the Toshiba TX39 needed to run eCos. The current
  89 implementation provides accurate simulation of the instruction set,
  90  interrupt controller, and timers, as well as having generic support
  91 for diagnostic output, serial I/O, and exceptions.</P
  92 ><P
  93 >In this release, you can run the same eCos binaries in the
  94 simulator that can run on target hardware, if it is built for ROM
  95 start-up.</P
  96 ><P
  97 >To simplify connection to the simulator, you are advised to
  98 create a GDB macro by putting the following code in your personal
  99 GDB start-up file (gdb.ini on Windows and .gdbinit on UNIX).</P
 100 ><TABLE
 101 BORDER="5"
 102 BGCOLOR="#E0E0F0"
 103 WIDTH="70%"
 104 ><TR
 105 ><TD
 106 ><PRE
 107 CLASS="PROGRAMLISTING"
 108 >define tsim
 109  target sim --board=jmr3904pal --memory-region 0xffff8000,0x900 \
 110             --memory-region 0xffffe000,0x4 \
 111             --memory-region 0xb2100000,0x4
 112  rbreak cyg_test_exit
 113  rbreak cyg_assert_fail
 114 end</PRE
 115 ></TD
 116 ></TR
 117 ></TABLE
 118 ><P
 119 >You can then connect to the simulator by invoking the command <B
 120 CLASS="COMMAND"
 121 >tsim</B
 122 > on
 123 the command line:</P
 124 ><TABLE
 125 BORDER="5"
 126 BGCOLOR="#E0E0F0"
 127 WIDTH="70%"
 128 ><TR
 129 ><TD
 130 ><PRE
 131 CLASS="PROGRAMLISTING"
 132 >(gdb) tsim</PRE
 133 ></TD
 134 ></TR
 135 ></TABLE
 136 ><P
 137 >You can achieve the same effect by typing out the macro&#8217;s
 138 content on the command line if necessary.</P
 139 ></DIV
 140 ><DIV
 141 CLASS="NAVFOOTER"
 142 ><HR
 143 ALIGN="LEFT"
 144 WIDTH="100%"><TABLE
 145 SUMMARY="Footer navigation table"
 146 WIDTH="100%"
 147 BORDER="0"
 148 CELLPADDING="0"
 149 CELLSPACING="0"
 150 ><TR
 151 ><TD
 152 WIDTH="33%"
 153 ALIGN="left"
 154 VALIGN="top"
 155 ><A
 156 HREF="setup-tx39-jmr3904.html"
 157 ACCESSKEY="P"
 158 >Prev</A
 159 ></TD
 160 ><TD
 161 WIDTH="34%"
 162 ALIGN="center"
 163 VALIGN="top"
 164 ><A
 165 HREF="ecos-user-guide.html"
 166 ACCESSKEY="H"
 167 >Home</A
 168 ></TD
 169 ><TD
 170 WIDTH="33%"
 171 ALIGN="right"
 172 VALIGN="top"
 173 ><A
 174 HREF="setup-tx49-ref4955.html"
 175 ACCESSKEY="N"
 176 >Next</A
 177 ></TD
 178 ></TR
 179 ><TR
 180 ><TD
 181 WIDTH="33%"
 182 ALIGN="left"
 183 VALIGN="top"
 184 >TX39 Hardware Setup</TD
 185 ><TD
 186 WIDTH="34%"
 187 ALIGN="center"
 188 VALIGN="top"
 189 ><A
 190 HREF="appendix-target-setup.html"
 191 ACCESSKEY="U"
 192 >Up</A
 193 ></TD
 194 ><TD
 195 WIDTH="33%"
 196 ALIGN="right"
 197 VALIGN="top"
 198 >TX49 Hardware Setup</TD
 199 ></TR
 200 ></TABLE
 201 ></DIV
 202 ></BODY
 203 ></HTML
 204 >