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

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.hardware.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
>hardware</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The eCos Component Writer's Guide"
HREF="cdl-guide.html"><LINK
REL="UP"
TITLE="CDL Language Specification"
HREF="reference.html"><LINK
REL="PREVIOUS"
TITLE="flavor"
HREF="ref.flavor.html"><LINK
REL="NEXT"
TITLE="if_define"
HREF="ref.if-define.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>The <SPAN
CLASS="APPLICATION"
>eCos</SPAN
> Component Writer's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="ref.flavor.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="ref.if-define.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="REF.HARDWARE"><SPAN
CLASS="PROPERTY"
>hardware</SPAN
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4413"
></A
><H2
>Name</H2
>Property <SPAN
CLASS="PROPERTY"
>hardware</SPAN
>&nbsp;--&nbsp;Specify that a package is tied to specific hardware.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4417"><H2
>Synopsis</H2
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>cdl_option &lt;name&gt; {
    active_if &lt;condition&gt;
    &#8230;
}</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4419"
></A
><H2
>Description</H2
><P
>Some packages such as device drivers and HAL packages are
hardware-specific, and generally it makes no sense to add such
packages to a configuration unless the corresponding hardware is
present on your target system. Typically hardware package selection
happens automatically when you select your target. The <SPAN
CLASS="PROPERTY"
>hardware</SPAN
>
property can be used in the body of a <TT
CLASS="LITERAL"
>cdl_package</TT
> command to
indicate that the package is hardware-specific.</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>At the time of writing the <SPAN
CLASS="PROPERTY"
>hardware</SPAN
> property is largely ignored by
the configuration tools, but this may change in future. Amongst other
possible changes, for hardware-specific packages such as device
drivers and HAL packages, the current scheme of generating a
configuration header file name based purely on the package name may be
abandoned. Instead all hardware packages would send their
configuration data to a single header file, <TT
CLASS="FILENAME"
>pkgconf/hardware.h</TT
>. This would make it
easier for code to obtain details of the current hardware, but
obviously there are compatibility issues. For now it is recommended
that all hardware packages specify their configuration header file
explicitly.</P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4428"
></A
><H2
>Example</H2
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>cdl_package CYGPKG_HAL_ARM {
    display       "ARM architecture"
    parent        CYGPKG_HAL
    hardware
    include_dir   cyg/hal
    define_header hal_arm.h
    &#8230;
}</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4431"
></A
><H2
>See Also</H2
><P
>Property <A
HREF="ref.define-header.html"
><SPAN
CLASS="PROPERTY"
>define_header</SPAN
></A
>, and
command <A
HREF="ref.cdl-package.html"
><TT
CLASS="LITERAL"
>cdl_package</TT
></A
>.</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="ref.flavor.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="cdl-guide.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="ref.if-define.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><SPAN
CLASS="PROPERTY"
>flavor</SPAN
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="reference.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><SPAN
CLASS="PROPERTY"
>if_define</SPAN
></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			`>hardware</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="The eCos Component Writer's Guide"`
20			`HREF="cdl-guide.html"><LINK`
21			`REL="UP"`
22			`TITLE="CDL Language Specification"`
23			`HREF="reference.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="flavor"`
26			`HREF="ref.flavor.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="if_define"`
29			`HREF="ref.if-define.html"></HEAD`
30			`><BODY`
31			`CLASS="REFENTRY"`
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			`>The <SPAN`
50			`CLASS="APPLICATION"`
51			`>eCos</SPAN`
52			`> Component Writer's Guide</TH`
53			`></TR`
54			`><TR`
55			`><TD`
56			`WIDTH="10%"`
57			`ALIGN="left"`
58			`VALIGN="bottom"`
59			`><A`
60			`HREF="ref.flavor.html"`
61			`ACCESSKEY="P"`
62			`>Prev</A`
63			`></TD`
64			`><TD`
65			`WIDTH="80%"`
66			`ALIGN="center"`
67			`VALIGN="bottom"`
68			`></TD`
69			`><TD`
70			`WIDTH="10%"`
71			`ALIGN="right"`
72			`VALIGN="bottom"`
73			`><A`
74			`HREF="ref.if-define.html"`
75			`ACCESSKEY="N"`
76			`>Next</A`
77			`></TD`
78			`></TR`
79			`></TABLE`
80			`><HR`
81			`ALIGN="LEFT"`
82			`WIDTH="100%"></DIV`
83			`><H1`
84			`><A`
85			`NAME="REF.HARDWARE"><SPAN`
86			`CLASS="PROPERTY"`
87			`>hardware</SPAN`
88			`></H1`
89			`><DIV`
90			`CLASS="REFNAMEDIV"`
91			`><A`
92			`NAME="AEN4413"`
93			`></A`
94			`><H2`
95			`>Name</H2`
96			`>Property <SPAN`
97			`CLASS="PROPERTY"`
98			`>hardware</SPAN`
99			`> -- Specify that a package is tied to specific hardware.</DIV`
100			`><DIV`
101			`CLASS="REFSYNOPSISDIV"`
102			`><A`
103			`NAME="AEN4417"><H2`
104			`>Synopsis</H2`
105			`><TABLE`
106			`BORDER="5"`
107			`BGCOLOR="#E0E0F0"`
108			`WIDTH="70%"`
109			`><TR`
110			`><TD`
111			`><PRE`
112			`CLASS="SYNOPSIS"`
113			`>cdl_option <name> {`
114			`active_if <condition>`
115			`…`
116			`}</PRE`
117			`></TD`
118			`></TR`
119			`></TABLE`
120			`></DIV`
121			`><DIV`
122			`CLASS="REFSECT1"`
123			`><A`
124			`NAME="AEN4419"`
125			`></A`
126			`><H2`
127			`>Description</H2`
128			`><P`
129			`>Some packages such as device drivers and HAL packages are`
130			`hardware-specific, and generally it makes no sense to add such`
131			`packages to a configuration unless the corresponding hardware is`
132			`present on your target system. Typically hardware package selection`
133			`happens automatically when you select your target. The <SPAN`
134			`CLASS="PROPERTY"`
135			`>hardware</SPAN`
136			`>`
137			`property can be used in the body of a <TT`
138			`CLASS="LITERAL"`
139			`>cdl_package</TT`
140			`> command to`
141			`indicate that the package is hardware-specific.</P`
142			`><DIV`
143			`CLASS="NOTE"`
144			`><BLOCKQUOTE`
145			`CLASS="NOTE"`
146			`><P`
147			`><B`
148			`>Note: </B`
149			`>At the time of writing the <SPAN`
150			`CLASS="PROPERTY"`
151			`>hardware</SPAN`
152			`> property is largely ignored by`
153			`the configuration tools, but this may change in future. Amongst other`
154			`possible changes, for hardware-specific packages such as device`
155			`drivers and HAL packages, the current scheme of generating a`
156			`configuration header file name based purely on the package name may be`
157			`abandoned. Instead all hardware packages would send their`
158			`configuration data to a single header file, <TT`
159			`CLASS="FILENAME"`
160			`>pkgconf/hardware.h</TT`
161			`>. This would make it`
162			`easier for code to obtain details of the current hardware, but`
163			`obviously there are compatibility issues. For now it is recommended`
164			`that all hardware packages specify their configuration header file`
165			`explicitly.</P`
166			`></BLOCKQUOTE`
167			`></DIV`
168			`></DIV`
169			`><DIV`
170			`CLASS="REFSECT1"`
171			`><A`
172			`NAME="AEN4428"`
173			`></A`
174			`><H2`
175			`>Example</H2`
176			`><TABLE`
177			`BORDER="5"`
178			`BGCOLOR="#E0E0F0"`
179			`WIDTH="70%"`
180			`><TR`
181			`><TD`
182			`><PRE`
183			`CLASS="PROGRAMLISTING"`
184			`>cdl_package CYGPKG_HAL_ARM {`
185			`display "ARM architecture"`
186			`parent CYGPKG_HAL`
187			`hardware`
188			`include_dir cyg/hal`
189			`define_header hal_arm.h`
190			`…`
191			`}</PRE`
192			`></TD`
193			`></TR`
194			`></TABLE`
195			`></DIV`
196			`><DIV`
197			`CLASS="REFSECT1"`
198			`><A`
199			`NAME="AEN4431"`
200			`></A`
201			`><H2`
202			`>See Also</H2`
203			`><P`
204			`>Property <A`
205			`HREF="ref.define-header.html"`
206			`><SPAN`
207			`CLASS="PROPERTY"`
208			`>define_header</SPAN`
209			`></A`
210			`>, and`
211			`command <A`
212			`HREF="ref.cdl-package.html"`
213			`><TT`
214			`CLASS="LITERAL"`
215			`>cdl_package</TT`
216			`></A`
217			`>.</P`
218			`></DIV`
219			`><DIV`
220			`CLASS="NAVFOOTER"`
221			`><HR`
222			`ALIGN="LEFT"`
223			`WIDTH="100%"><TABLE`
224			`SUMMARY="Footer navigation table"`
225			`WIDTH="100%"`
226			`BORDER="0"`
227			`CELLPADDING="0"`
228			`CELLSPACING="0"`
229			`><TR`
230			`><TD`
231			`WIDTH="33%"`
232			`ALIGN="left"`
233			`VALIGN="top"`
234			`><A`
235			`HREF="ref.flavor.html"`
236			`ACCESSKEY="P"`
237			`>Prev</A`
238			`></TD`
239			`><TD`
240			`WIDTH="34%"`
241			`ALIGN="center"`
242			`VALIGN="top"`
243			`><A`
244			`HREF="cdl-guide.html"`
245			`ACCESSKEY="H"`
246			`>Home</A`
247			`></TD`
248			`><TD`
249			`WIDTH="33%"`
250			`ALIGN="right"`
251			`VALIGN="top"`
252			`><A`
253			`HREF="ref.if-define.html"`
254			`ACCESSKEY="N"`
255			`>Next</A`
256			`></TD`
257			`></TR`
258			`><TR`
259			`><TD`
260			`WIDTH="33%"`
261			`ALIGN="left"`
262			`VALIGN="top"`
263			`><SPAN`
264			`CLASS="PROPERTY"`
265			`>flavor</SPAN`
266			`></TD`
267			`><TD`
268			`WIDTH="34%"`
269			`ALIGN="center"`
270			`VALIGN="top"`
271			`><A`
272			`HREF="reference.html"`
273			`ACCESSKEY="U"`
274			`>Up</A`
275			`></TD`
276			`><TD`
277			`WIDTH="33%"`
278			`ALIGN="right"`
279			`VALIGN="top"`
280			`><SPAN`
281			`CLASS="PROPERTY"`
282			`>if_define</SPAN`
283			`></TD`
284			`></TR`
285			`></TABLE`
286			`></DIV`
287			`></BODY`
288			`></HTML`
289			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.hardware.html] - Blame information for rev 588