1 /*

     2 * Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Defines the class implementing MWlanHwInitInterface interface

    15 *

    16 */

    17 

    18 

    19 #ifndef WLANHWINIT_H

    20 #define WLANHWINIT_H

    21 

    22 #include "wlanhwinitinterface.h"

    23 

    24 class CWlanHwInitMain;

    25 

    26 // CLASS DECLARATION

    27 /**

    28 * This class implements the MWlanHwInitInterface interface.

    29 *

    30 * @since Series 60 3.1

    31 */

    32 NONSHARABLE_CLASS( CWlanHwInit ) : public CBase, public MWlanHwInitInterface

    33     {

    34     public:  // Constructors and destructor

    35         

    36         /**

    37          * Two-phased constructor.

    38          */

    39         IMPORT_C static CWlanHwInit* NewL();

    40         

    41         /**

    42          * Destructor.

    43          */

    44         IMPORT_C virtual ~CWlanHwInit();

    45         

    46         // Functions from base classes

    47 

    48         /**

    49          * From MWlanHwInitInterface Get pointer to hardware specific initialization data.

    50          * @since Series 60 3.1

    51          * @param aInitData Pointer to initialization data, NULL if none.

    52          * @param aInitLength Length of initialization data.

    53          * @param aFwData Pointer to firmware data, NULL if none.

    54          * @param aFwLength Length of firmware data.

    55          */

    56         IMPORT_C void GetHwInitData(

    57             const TUint8** aInitData,

    58             TUint& aInitLength,

    59             const TUint8** aFwData,

    60             TUint& aFwLength );

    61 

    62         /**

    63          * From MWlanHwInitInterface Get device MAC address.

    64          * @since Series 60 3.1

    65          * @param aMacAddress MAC address of the device.

    66          * @return A Symbian error code.

    67          */

    68         IMPORT_C TInt GetMacAddress(

    69             TMacAddr& aMacAddress );

    70 

    71         /**

    72          * Methods for production testing.

    73          */

    74 

    75         /**

    76          * From MWlanHwInitInterface Get pointer to hardware specific initialization data

    77          * for production testing.

    78          * @since Series 60 3.1

    79          * @param aInitData Pointer to initialization data, NULL if none.

    80          * @param aInitLength Length of initialization data.

    81          * @param aFwData Pointer to firmware data, NULL if none.

    82          * @param aFwLength Length of firmware data.

    83          */

    84         IMPORT_C void GetHwTestInitData(

    85             const TUint8** aInitData,

    86             TUint& aInitLength,

    87             const TUint8** aFwData,

    88             TUint& aFwLength );

    89 

    90         /**

    91          * From MWlanHwInitInterface Get hardware specific production testing data.

    92          * @since Series 60 3.1

    93          * @param aId Id of the parameter to read.

    94          * @param aData Buffer for read data.

    95          * @return A Symbian error code.

    96          */

    97         IMPORT_C TInt GetHwTestData(

    98             TUint aId,

    99             TDes8& aData );

   100 

   101         /**

   102          * From MWlanHwInitInterface Set hardware specific production testing data.

   103          * @since Series 60 3.1

   104          * @param aId Id of the parameter to store.

   105          * @param aData Data to be stored.

   106          * @return A Symbian error code.

   107          */

   108         IMPORT_C TInt SetHwTestData(

   109             TUint aId,

   110             TDesC8& aData );

   111 

   112     private:

   113 

   114         /**

   115          * C++ default constructor.

   116          */

   117         CWlanHwInit();

   118 

   119         /**

   120          * By default Symbian 2nd phase constructor is private.

   121          */

   122         void ConstructL();

   123 

   124     private:    // Data

   125 

   126         /** The main implemenation of HW specific functionality. */

   127         CWlanHwInitMain* iMain;

   128     };

   129 

   130 #endif // WLANHWINIT_H