doc/html/cdl-guide/ref.hardware.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 >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 >&nbsp;--&nbsp;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 &lt;name&gt; {
 114     active_if &lt;condition&gt;
 115     &#8230;
 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     &#8230;
 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 >