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-453F06F7-DD8C-546F-A206-FCE863744572" xml:lang="en"><title>Extended

    13 Light API Tutorial</title><shortdesc>This tutorial describes how to use the Extended Light API of HWRM. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section id="GUID-09885F9B-8303-55B8-B8D4-ADFDB2912D2A"><title>Introduction</title> <p>Extended

    15 Light API is similar to the Light API but it supports more target devices.

    16 It can be used with or without a notification. When the notification is required,

    17 a callback pointer is implemented in the instance of the <xref href="GUID-BC043845-8907-340F-AD25-612DD5C08225.dita"><apiname>CHWRMExtendedLight</apiname></xref>.

    18 The callback pointer is provided by the <xref href="GUID-BC043845-8907-340F-AD25-612DD5C08225.dita"><apiname>MHWRMExtendedLightObserver</apiname></xref> class. </p><p>Using

    19 Extended Light API, you can perform any of the tasks listed in the procedure

    20 section:</p></section>

    21 <section><title>Procedure</title> <ul id="GUID-5DEA0392-4A81-5941-AB29-ECEC3B4C5703">

    22 <li id="GUID-9D8792E6-D03B-5F54-B32D-D0D78F9B24F8"><p><xref href="GUID-74ACD63A-F45B-4F64-963B-0DCF0842A13B.dita">Creating

    23 an instance</xref>  </p> </li>

    24 <li id="GUID-41011B42-F71D-513C-B1BD-BF42A61ED7EE"><p><xref href="GUID-380800EC-B16E-4909-BD75-0D1E21625A42.dita">Retrieving

    25 the supported targets</xref>  </p> </li>

    26 <li id="GUID-DD269136-73F9-5FF4-BCAF-CD7A1B4283D6"><p><xref href="GUID-BA1FA926-8511-4D31-AD01-4A8BCABB825D.dita">Retrieving

    27 the status of the lights</xref>  </p> </li>

    28 <li id="GUID-F5AA6116-BE76-5C7E-A136-29D9EC4219D2"><p><xref href="GUID-2EBA62F2-26B0-46FE-BDB8-E2A2B7CE6FF3.dita">Reserving

    29 the lights</xref>  </p> </li>

    30 <li id="GUID-1CF68661-ADEE-54F2-814F-57C7B799BEFA"><p><xref href="GUID-6F71BDAA-1639-4460-ACE8-BA677AE7D967.dita">Switching

    31 ON the lights</xref>  </p> </li>

    32 <li id="GUID-F8CBEDA0-AF0B-5D66-8A47-3052CEB55A9B"><p><xref href="GUID-3A498F20-5953-483D-951F-496D063A337E.dita">Switching

    33 OFF the lights</xref>  </p> </li>

    34 <li id="GUID-ADC018EE-4FC1-5BAC-82B8-6CC9AE74E3DB"><p><xref href="GUID-E41CF544-DCD3-4931-B7C3-CE9BE6E195E1.dita">Blinking

    35 the lights</xref>  </p> </li>

    36 <li id="GUID-236B393C-7084-5D2B-A8E0-F748E7BFA2CE"><p><xref href="GUID-A83B9529-E7BF-4D03-B977-C00ACCF9438C.dita">Releasing

    37 the reserved lights</xref>  </p> </li>

    38 <li id="GUID-1D3732D5-F7DE-5042-AA87-8DFC74AED2DD"><p><xref href="GUID-FE403A48-AF5A-4032-A724-680431A52B7C.dita">Releasing

    39 the instance of Extended Light API</xref>  </p> </li>

    40 </ul> </section>

    41 <section><title>See also</title> <p><xref href="GUID-40A9EAE3-F0AA-52FF-B3E8-455E820AA410.dita">Extended

    42 Light API</xref>  </p> </section>

    43 </conbody></concept>