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

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

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

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

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

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

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

<concept id="GUID-453F06F7-DD8C-546F-A206-FCE863744572" xml:lang="en"><title>Extended

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

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

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

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

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

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

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

section:</p></section>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</ul> </section>

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

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