URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [modifying-the-memory-layout.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Modifying the Memory Layout</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos User Guide"
HREF="ecos-user-guide.html"><LINK
REL="UP"
TITLE="Manual Configuration"
HREF="manual-configuration.html"><LINK
REL="PREVIOUS"
TITLE="Editing the Sources"
HREF="editing-the-sources.html"><LINK
REL="NEXT"
TITLE="Managing the Package Repository"
HREF="managing-package-repository.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos User Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="editing-the-sources.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 28. Manual Configuration</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="managing-package-repository.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="MODIFYING-THE-MEMORY-LAYOUT">Modifying the Memory Layout</H1
><P
>Each <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> platform package is supplied with linker script
fragments which describe the location of memory regions on the evaluation
board and the location of memory sections within these regions.
The correct linker script fragment is selected and included in the
<SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> linker script <TT
CLASS="FILENAME"
>target.ld</TT
> when
<SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> is built.</P
><P
>It is not necessary to modify the default memory
layouts in order to start development with <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
>. However, it will
be necessary to edit a linker script fragment when the memory map
of the evaluation board is changed. For example, if additional memory
is added, the linker must be notified that the new memory is available
for use. As a minimum, this would involve modifying the length of
the corresponding memory region. Where the available memory is non-contiguous,
it may be necessary to declare a new memory region and reassign
certain linker output sections to the new region.</P
><P
>Linker script fragments and memory layout header files should
be edited within the <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> install tree. They are
located at <TT
CLASS="FILENAME"
>include/pkgconf/mlt_*.*</TT
>.
Where multiple start-up types are in use, it will be necessary to
edit multiple linker script fragments and header files. The information
provided in the header file and the corresponding linker script
fragment must always match. A typical linker script fragment is
shown below:</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN2992"><P
><B
>Example 28-1. <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> linker script fragment</B
></P
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>MEMORY
{
 rom : ORIGIN = 0x40000000, LENGTH = 0x80000
 ram : ORIGIN = 0x48000000, LENGTH = 0x200000
}
 
SECTIONS
{
 SECTIONS_BEGIN
 SECTION_rom_vectors (rom, 0x40000000, LMA_EQ_VMA)
 SECTION_text (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_fini (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_rodata (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_rodata1 (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_fixup (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_gcc_except_table (rom, ALIGN (0x1), LMA_EQ_VMA)
 SECTION_data (ram, 0x48000000, FOLLOWING (.gcc_except_table))
 SECTION_bss (ram, ALIGN (0x4), LMA_EQ_VMA)
 SECTIONS_END
}</PRE
></TD
></TR
></TABLE
></DIV
><P
>The file consists of two blocks, the <TT
CLASS="LITERAL"
>MEMORY</TT
> block
contains lines describing the address (<TT
CLASS="LITERAL"
>ORIGIN</TT
>)
and the size (<TT
CLASS="LITERAL"
>LENGTH</TT
>) of each memory
region. The <TT
CLASS="LITERAL"
>MEMORY</TT
> block is followed
by the <TT
CLASS="LITERAL"
>SECTIONS</TT
> block which contains
lines describing each of the linker output sections. Each section
is represented by a macro call. The arguments of these macros are
ordered as follows: </P
><P
></P
><OL
TYPE="1"
><LI
><P
>The memory region in which the section will finally
              reside.</P
></LI
><LI
><P
>The final address (
<TT
CLASS="LITERAL"
>VMA</TT
>
) of the section. This is expressed using one of the following forms:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
></DT
><DD
><P
>at the absolute address specified by the
                    unsigned integer <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
></P
></DD
><DT
>ALIGN (<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
>)</DT
><DD
><P
>following the final location of the previous section
                    with alignment to the next <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
>-byte
                    boundary</P
></DD
></DL
></DIV
></LI
><LI
><P
>The initial address (<TT
CLASS="LITERAL"
>LMA</TT
>)
              of the section. This is expressed using one of the
              following forms:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>LMA_EQ_VMA</DT
><DD
><P
>the <TT
CLASS="LITERAL"
>LMA</TT
>
                    equals the <TT
CLASS="LITERAL"
>VMA</TT
> (no relocation)</P
></DD
><DT
>AT (<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
>)</DT
><DD
><P
>at the absolute address specified by the
                    unsigned integer <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>n</I
></SPAN
></P
></DD
><DT
>FOLLOWING (.<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>name</I
></SPAN
>)</DT
><DD
><P
>following the initial location of section
                    <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>name</I
></SPAN
></P
></DD
></DL
></DIV
></LI
></OL
><P
>In order to maintain compatibility with linker script
          fragments and header files exported by the
          <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> <SPAN
CLASS="APPLICATION"
>Configuration Tool</SPAN
>, the use
          of other expressions within these files is not
          recommended.</P
><P
>Note that the names of the linker output sections will vary
between target architectures. A description of these sections can
be found in the specific <SPAN
CLASS="PRODUCTNAME"
>GCC</SPAN
> documentation for
your architecture.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="editing-the-sources.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-user-guide.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="managing-package-repository.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Editing the Sources</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="manual-configuration.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Managing the Package Repository</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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			`>Modifying the Memory Layout</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="Manual Configuration"`
23			`HREF="manual-configuration.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="Editing the Sources"`
26			`HREF="editing-the-sources.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Managing the Package Repository"`
29			`HREF="managing-package-repository.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="editing-the-sources.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`>Chapter 28. Manual Configuration</TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="managing-package-repository.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="MODIFYING-THE-MEMORY-LAYOUT">Modifying the Memory Layout</H1`
86			`><P`
87			`>Each <SPAN`
88			`CLASS="PRODUCTNAME"`
89			`>eCos</SPAN`
90			`> platform package is supplied with linker script`
91			`fragments which describe the location of memory regions on the evaluation`
92			`board and the location of memory sections within these regions.`
93			`The correct linker script fragment is selected and included in the`
94			`<SPAN`
95			`CLASS="PRODUCTNAME"`
96			`>eCos</SPAN`
97			`> linker script <TT`
98			`CLASS="FILENAME"`
99			`>target.ld</TT`
100			`> when`
101			`<SPAN`
102			`CLASS="PRODUCTNAME"`
103			`>eCos</SPAN`
104			`> is built.</P`
105			`><P`
106			`>It is not necessary to modify the default memory`
107			`layouts in order to start development with <SPAN`
108			`CLASS="PRODUCTNAME"`
109			`>eCos</SPAN`
110			`>. However, it will`
111			`be necessary to edit a linker script fragment when the memory map`
112			`of the evaluation board is changed. For example, if additional memory`
113			`is added, the linker must be notified that the new memory is available`
114			`for use. As a minimum, this would involve modifying the length of`
115			`the corresponding memory region. Where the available memory is non-contiguous,`
116			`it may be necessary to declare a new memory region and reassign`
117			`certain linker output sections to the new region.</P`
118			`><P`
119			`>Linker script fragments and memory layout header files should`
120			`be edited within the <SPAN`
121			`CLASS="PRODUCTNAME"`
122			`>eCos</SPAN`
123			`> install tree. They are`
124			`located at <TT`
125			`CLASS="FILENAME"`
126			`>include/pkgconf/mlt_.</TT`
127			`>.`
128			`Where multiple start-up types are in use, it will be necessary to`
129			`edit multiple linker script fragments and header files. The information`
130			`provided in the header file and the corresponding linker script`
131			`fragment must always match. A typical linker script fragment is`
132			`shown below:</P`
133			`><DIV`
134			`CLASS="EXAMPLE"`
135			`><A`
136			`NAME="AEN2992"><P`
137			`><B`
138			`>Example 28-1. <SPAN`
139			`CLASS="PRODUCTNAME"`
140			`>eCos</SPAN`
141			`> linker script fragment</B`
142			`></P`
143			`><TABLE`
144			`BORDER="5"`
145			`BGCOLOR="#E0E0F0"`
146			`WIDTH="70%"`
147			`><TR`
148			`><TD`
149			`><PRE`
150			`CLASS="PROGRAMLISTING"`
151			`>MEMORY`
152			`{`
153			`rom : ORIGIN = 0x40000000, LENGTH = 0x80000`
154			`ram : ORIGIN = 0x48000000, LENGTH = 0x200000`
155			`}`
156
157			`SECTIONS`
158			`{`
159			`SECTIONS_BEGIN`
160			`SECTION_rom_vectors (rom, 0x40000000, LMA_EQ_VMA)`
161			`SECTION_text (rom, ALIGN (0x1), LMA_EQ_VMA)`
162			`SECTION_fini (rom, ALIGN (0x1), LMA_EQ_VMA)`
163			`SECTION_rodata (rom, ALIGN (0x1), LMA_EQ_VMA)`
164			`SECTION_rodata1 (rom, ALIGN (0x1), LMA_EQ_VMA)`
165			`SECTION_fixup (rom, ALIGN (0x1), LMA_EQ_VMA)`
166			`SECTION_gcc_except_table (rom, ALIGN (0x1), LMA_EQ_VMA)`
167			`SECTION_data (ram, 0x48000000, FOLLOWING (.gcc_except_table))`
168			`SECTION_bss (ram, ALIGN (0x4), LMA_EQ_VMA)`
169			`SECTIONS_END`
170			`}</PRE`
171			`></TD`
172			`></TR`
173			`></TABLE`
174			`></DIV`
175			`><P`
176			`>The file consists of two blocks, the <TT`
177			`CLASS="LITERAL"`
178			`>MEMORY</TT`
179			`> block`
180			`contains lines describing the address (<TT`
181			`CLASS="LITERAL"`
182			`>ORIGIN</TT`
183			`>)`
184			`and the size (<TT`
185			`CLASS="LITERAL"`
186			`>LENGTH</TT`
187			`>) of each memory`
188			`region. The <TT`
189			`CLASS="LITERAL"`
190			`>MEMORY</TT`
191			`> block is followed`
192			`by the <TT`
193			`CLASS="LITERAL"`
194			`>SECTIONS</TT`
195			`> block which contains`
196			`lines describing each of the linker output sections. Each section`
197			`is represented by a macro call. The arguments of these macros are`
198			`ordered as follows: </P`
199			`><P`
200			`></P`
201			`><OL`
202			`TYPE="1"`
203			`><LI`
204			`><P`
205			`>The memory region in which the section will finally`
206			`reside.</P`
207			`></LI`
208			`><LI`
209			`><P`
210			`>The final address (`
211			`<TT`
212			`CLASS="LITERAL"`
213			`>VMA</TT`
214			`>`
215			`) of the section. This is expressed using one of the following forms:</P`
216			`><P`
217			`></P`
218			`><DIV`
219			`CLASS="VARIABLELIST"`
220			`><DL`
221			`><DT`
222			`><SPAN`
223			`CLASS="emphasis"`
224			`><I`
225			`CLASS="EMPHASIS"`
226			`>n</I`
227			`></SPAN`
228			`></DT`
229			`><DD`
230			`><P`
231			`>at the absolute address specified by the`
232			`unsigned integer <SPAN`
233			`CLASS="emphasis"`
234			`><I`
235			`CLASS="EMPHASIS"`
236			`>n</I`
237			`></SPAN`
238			`></P`
239			`></DD`
240			`><DT`
241			`>ALIGN (<SPAN`
242			`CLASS="emphasis"`
243			`><I`
244			`CLASS="EMPHASIS"`
245			`>n</I`
246			`></SPAN`
247			`>)</DT`
248			`><DD`
249			`><P`
250			`>following the final location of the previous section`
251			`with alignment to the next <SPAN`
252			`CLASS="emphasis"`
253			`><I`
254			`CLASS="EMPHASIS"`
255			`>n</I`
256			`></SPAN`
257			`>-byte`
258			`boundary</P`
259			`></DD`
260			`></DL`
261			`></DIV`
262			`></LI`
263			`><LI`
264			`><P`
265			`>The initial address (<TT`
266			`CLASS="LITERAL"`
267			`>LMA</TT`
268			`>)`
269			`of the section. This is expressed using one of the`
270			`following forms:</P`
271			`><P`
272			`></P`
273			`><DIV`
274			`CLASS="VARIABLELIST"`
275			`><DL`
276			`><DT`
277			`>LMA_EQ_VMA</DT`
278			`><DD`
279			`><P`
280			`>the <TT`
281			`CLASS="LITERAL"`
282			`>LMA</TT`
283			`>`
284			`equals the <TT`
285			`CLASS="LITERAL"`
286			`>VMA</TT`
287			`> (no relocation)</P`
288			`></DD`
289			`><DT`
290			`>AT (<SPAN`
291			`CLASS="emphasis"`
292			`><I`
293			`CLASS="EMPHASIS"`
294			`>n</I`
295			`></SPAN`
296			`>)</DT`
297			`><DD`
298			`><P`
299			`>at the absolute address specified by the`
300			`unsigned integer <SPAN`
301			`CLASS="emphasis"`
302			`><I`
303			`CLASS="EMPHASIS"`
304			`>n</I`
305			`></SPAN`
306			`></P`
307			`></DD`
308			`><DT`
309			`>FOLLOWING (.<SPAN`
310			`CLASS="emphasis"`
311			`><I`
312			`CLASS="EMPHASIS"`
313			`>name</I`
314			`></SPAN`
315			`>)</DT`
316			`><DD`
317			`><P`
318			`>following the initial location of section`
319			`<SPAN`
320			`CLASS="emphasis"`
321			`><I`
322			`CLASS="EMPHASIS"`
323			`>name</I`
324			`></SPAN`
325			`></P`
326			`></DD`
327			`></DL`
328			`></DIV`
329			`></LI`
330			`></OL`
331			`><P`
332			`>In order to maintain compatibility with linker script`
333			`fragments and header files exported by the`
334			`<SPAN`
335			`CLASS="PRODUCTNAME"`
336			`>eCos</SPAN`
337			`> <SPAN`
338			`CLASS="APPLICATION"`
339			`>Configuration Tool</SPAN`
340			`>, the use`
341			`of other expressions within these files is not`
342			`recommended.</P`
343			`><P`
344			`>Note that the names of the linker output sections will vary`
345			`between target architectures. A description of these sections can`
346			`be found in the specific <SPAN`
347			`CLASS="PRODUCTNAME"`
348			`>GCC</SPAN`
349			`> documentation for`
350			`your architecture.</P`
351			`></DIV`
352			`><DIV`
353			`CLASS="NAVFOOTER"`
354			`><HR`
355			`ALIGN="LEFT"`
356			`WIDTH="100%"><TABLE`
357			`SUMMARY="Footer navigation table"`
358			`WIDTH="100%"`
359			`BORDER="0"`
360			`CELLPADDING="0"`
361			`CELLSPACING="0"`
362			`><TR`
363			`><TD`
364			`WIDTH="33%"`
365			`ALIGN="left"`
366			`VALIGN="top"`
367			`><A`
368			`HREF="editing-the-sources.html"`
369			`ACCESSKEY="P"`
370			`>Prev</A`
371			`></TD`
372			`><TD`
373			`WIDTH="34%"`
374			`ALIGN="center"`
375			`VALIGN="top"`
376			`><A`
377			`HREF="ecos-user-guide.html"`
378			`ACCESSKEY="H"`
379			`>Home</A`
380			`></TD`
381			`><TD`
382			`WIDTH="33%"`
383			`ALIGN="right"`
384			`VALIGN="top"`
385			`><A`
386			`HREF="managing-package-repository.html"`
387			`ACCESSKEY="N"`
388			`>Next</A`
389			`></TD`
390			`></TR`
391			`><TR`
392			`><TD`
393			`WIDTH="33%"`
394			`ALIGN="left"`
395			`VALIGN="top"`
396			`>Editing the Sources</TD`
397			`><TD`
398			`WIDTH="34%"`
399			`ALIGN="center"`
400			`VALIGN="top"`
401			`><A`
402			`HREF="manual-configuration.html"`
403			`ACCESSKEY="U"`
404			`>Up</A`
405			`></TD`
406			`><TD`
407			`WIDTH="33%"`
408			`ALIGN="right"`
409			`VALIGN="top"`
410			`>Managing the Package Repository</TD`
411			`></TR`
412			`></TABLE`
413			`></DIV`
414			`></BODY`
415			`></HTML`
416			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [modifying-the-memory-layout.html] - Blame information for rev 588