wlan_plat/wlan_hw_initialization_data_api/inc/wlanhwinit.h
changeset 0 c40eb8fe8501
equal deleted inserted replaced
-1:000000000000 0:c40eb8fe8501
       
     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 "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 * %version: 4 %
       
    20 */
       
    21 
       
    22 #ifndef WLANHWINIT_H
       
    23 #define WLANHWINIT_H
       
    24 
       
    25 #include "wlanhwinitinterface.h"
       
    26 
       
    27 class CWlanHwInitMain;
       
    28 
       
    29 // CLASS DECLARATION
       
    30 /**
       
    31 * This class implements the MWlanHwInitInterface interface.
       
    32 *
       
    33 * @since Series 60 3.1
       
    34 */
       
    35 NONSHARABLE_CLASS( CWlanHwInit ) : public CBase, public MWlanHwInitInterface
       
    36     {
       
    37     public:  // Constructors and destructor
       
    38         
       
    39         /**
       
    40          * Two-phased constructor.
       
    41          */
       
    42         IMPORT_C static CWlanHwInit* NewL();
       
    43         
       
    44         /**
       
    45          * Destructor.
       
    46          */
       
    47         IMPORT_C virtual ~CWlanHwInit();
       
    48         
       
    49         // Functions from base classes
       
    50 
       
    51         /**
       
    52          * From MWlanHwInitInterface Get pointer to hardware specific initialization data.
       
    53          * @since Series 60 3.1
       
    54          * @param aInitData Pointer to initialization data, NULL if none.
       
    55          * @param aInitLength Length of initialization data.
       
    56          * @param aFwData Pointer to firmware data, NULL if none.
       
    57          * @param aFwLength Length of firmware data.
       
    58          */
       
    59         IMPORT_C void GetHwInitData(
       
    60             const TUint8** aInitData,
       
    61             TUint& aInitLength,
       
    62             const TUint8** aFwData,
       
    63             TUint& aFwLength );
       
    64 
       
    65         /**
       
    66          * From MWlanHwInitInterface Get device MAC address.
       
    67          * @since Series 60 3.1
       
    68          * @param aMacAddress MAC address of the device.
       
    69          * @return A Symbian error code.
       
    70          */
       
    71         IMPORT_C TInt GetMacAddress(
       
    72             TMacAddr& aMacAddress );
       
    73 
       
    74         /**
       
    75          * Methods for production testing.
       
    76          */
       
    77 
       
    78         /**
       
    79          * From MWlanHwInitInterface Get pointer to hardware specific initialization data
       
    80          * for production testing.
       
    81          * @since Series 60 3.1
       
    82          * @param aInitData Pointer to initialization data, NULL if none.
       
    83          * @param aInitLength Length of initialization data.
       
    84          * @param aFwData Pointer to firmware data, NULL if none.
       
    85          * @param aFwLength Length of firmware data.
       
    86          */
       
    87         IMPORT_C void GetHwTestInitData(
       
    88             const TUint8** aInitData,
       
    89             TUint& aInitLength,
       
    90             const TUint8** aFwData,
       
    91             TUint& aFwLength );
       
    92 
       
    93         /**
       
    94          * From MWlanHwInitInterface Get hardware specific production testing data.
       
    95          * @since Series 60 3.1
       
    96          * @param aId Id of the parameter to read.
       
    97          * @param aData Buffer for read data.
       
    98          * @return A Symbian error code.
       
    99          */
       
   100         IMPORT_C TInt GetHwTestData(
       
   101             TUint aId,
       
   102             TDes8& aData );
       
   103 
       
   104         /**
       
   105          * From MWlanHwInitInterface Set hardware specific production testing data.
       
   106          * @since Series 60 3.1
       
   107          * @param aId Id of the parameter to store.
       
   108          * @param aData Data to be stored.
       
   109          * @return A Symbian error code.
       
   110          */
       
   111         IMPORT_C TInt SetHwTestData(
       
   112             TUint aId,
       
   113             TDesC8& aData );
       
   114 
       
   115     private:
       
   116 
       
   117         /**
       
   118          * C++ default constructor.
       
   119          */
       
   120         CWlanHwInit();
       
   121 
       
   122         /**
       
   123          * By default Symbian 2nd phase constructor is private.
       
   124          */
       
   125         void ConstructL();
       
   126 
       
   127     private:    // Data
       
   128 
       
   129         /** The main implemenation of HW specific functionality. */
       
   130         CWlanHwInitMain* iMain;
       
   131     };
       
   132 
       
   133 #endif // WLANHWINIT_H