1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-2D977A02-5928-5441-8AE7-42A722F2A4B8" xml:lang="en"><title>User-Side Hardware Abstraction</title><shortdesc>The User-Side Hardware Abstraction (HAL) component provides a simple

    13 interface for programs to read and set hardware-specific settings, for example,

    14 the display contrast. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>A base port must define the attributes that clients can use on a phone,

    16 and implement any functions that are required to get and set the attributes.</p>

    17 <p id="GUID-4DA41221-40B9-5BC7-B2C6-7C6EB4522508"> To define attributes, you

    18 must change the source of the <filepath>hal.dll</filepath> library and rebuild

    19 it. Functions that get and set attributes are implemented as HAL handler functions

    20 in kernel-side programs, for example, device drivers. </p>

    21 </conbody><related-links>

    22 <link href="GUID-8C22AF20-EE0E-5AD2-BEFD-FED5A7DBB09B.dita"><linktext>LCD   Extension</linktext>

    23 </link>

    24 <link href="GUID-54042C84-6216-5930-9CBF-BAF635CECD4D.dita"><linktext>Power HAL

    25   Handler</linktext></link>

    26 </related-links></concept>