<?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>
</conbody></concept>