1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>Relocatable Module (RSO) Sample Demos</title>
9</head>
10
11<body>
12
13<H1>Relocatable Module (RSO) Sample Demos</H1>
14
15<H2>Location</H2>
16<p><code>$REVOLUTION_SDK_ROOT/build/demos/rsodemo</code></p>
17<H2>Compilation</H2>
18<P>Go to <code>$REVOLUTION_SDK_ROOT/build/demos/rsodemo</code> and enter <code>make</code>. The executable programs (ELF files) are generated in the <FONT face="Courier New">bin/RVL</FONT> folder of each demo directory.</P>
19<H2>Execution</H2>
20<P>Go to the <FONT face="Courier New">/bin/RVL/</FONT> directory for each demo in the <code>$REVOLUTION_SDK_ROOT/build/demos/rsodemo</code> directory and perform one of the following.</P>
21<ul>
22<li>To simply run the application, execute the <code>ndrun</code> script, using the ELF file as an argument.</li>
23<li>Run <CODE>ide</CODE> with the ELF file as an argument if you want to debug with CodeWarrior.</li>
24</ul>
25
26
27<H2>Description</H2>
28<TABLE border="1">
29  <TBODY>
30    <TR>
31<TD width="120"><STRONG><CODE><a href="./LinkList.html">LinkList/</a></CODE></STRONG></TD>
32<TD width="520">Demo program for learning the basic use of the RSO functions. This program links module A and module B, using a link list.</TD>
33    </TR>
34  </TBODY>
35  <TBODY>
36    <TR>
37<TD width="120"><STRONG><CODE><a href="./LinkListFixed0.html">LinkListFixed0/</a></CODE></STRONG></TD>
38<TD width="520">Demo program that shows an example of relocatable module partial memory deallocation. This demo is similar to LinkList, but it deallocates part of the module information as a bss area.</TD>
39    </TR>
40  </TBODY>
41  <TBODY>
42    <TR>
43<TD width="120"><STRONG><CODE><a href="./LinkMem2.html">LinkMem2/</a></CODE></STRONG></TD>
44<TD width="520">Sample that uses a pragma when a relocatable module is allocated to the external main memory (<CODE>MEM2</CODE> area). This program places module E in external main memory and module F in internal main memory.</TD>
45    </TR>
46  </TBODY>
47  <TBODY>
48    <TR>
49<TD width="120"><STRONG><CODE><a href="./LinkFar.html">LinkFar/</a></CODE></STRONG></TD>
50<TD width="520">Sample that uses <code><a href="../RSOLinkFar.html">RSOLinkFar</a></code> when a relocatable module is allocated to the external main memory (<CODE>MEM2</CODE> area). This program places module G in external main memory and module H in internal main memory.</TD>
51    </TR>
52  </TBODY>
53  <TBODY>
54    <TR>
55<TD width="120"><STRONG><CODE><a href="./LinkJump.html">LinkJump/</a></CODE></STRONG></TD>
56<TD width="520">Sample that uses <code><a href="../RSOLinkJump.html">RSOLinkJump</a></code> when a relocatable module is allocated to the external main memory (<CODE>MEM2</CODE> area).</TD>
57    </TR>
58  </TBODY>
59  <TBODY>
60    <TR>
61<TD width="120"><STRONG><CODE><a href="./xxxmakeinc.html">MakeInc/</a></CODE></STRONG></TD>
62<TD width="520">Demo program that uses <code><a href="../tools/makeinc.html">makeinc.exe<a></code>. Module D functions and variables are accessed from a static module, using <CODE>d.inc</CODE>. The <CODE>d.inc</CODE> is generated by <CODE>makeinc.exe</CODE> from the <CODE>d.h</CODE> header file.</TD>
63    </TR>
64  </TBODY>
65  <TBODY>
66    <TR>
67<TD width="120"><STRONG><CODE><a href="./Manually.html">Manually/</a></CODE></STRONG></TD>
68<TD width="520">This is a demo program showing how to specify links without using a link list. Modules A, B, and C are linked using minimal link operations.</TD>
69    </TR>
70  </TBODY>
71</TABLE>
72
73<H2>See Also</H2>
74<p><a href="../list.html">RSO API Function List</a></p>
75
76<H2>Revision History</H2>
77<p>
782007/08/07 Expanded the descriptions of the demos and tools.<br>2006/12/19 Added LinkJump.<br>2006/06/14 Initial version.
79</p>
80
81<hr><p>CONFIDENTIAL</p></body>
82</HTML>
83