localconnectivityservice/dun/atext/inc/DunAtNvramListen.h
author hgs
Fri, 15 Oct 2010 15:05:57 +0800
changeset 54 4dc88a4ac6f4
parent 29 3ae5cb0b4c02
permissions -rw-r--r--
201041_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
29
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     1
/*
54
4dc88a4ac6f4 201041_02
hgs
parents: 29
diff changeset
     2
* Copyright (c) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).
29
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     3
* All rights reserved.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     8
*
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
     9
* Initial Contributors:
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    11
*
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    12
* Contributors:
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    13
*
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    14
* Description:  AT NVRAM status change listener and notifier
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    15
*
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    16
*/
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    17
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    18
#ifndef C_CDUNATNVRAMLISTEN_H
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    19
#define C_CDUNATNVRAMLISTEN_H
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    20
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    21
#include <atext.h>
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    22
#include <atextcommon.h>
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    23
#include "DunTransporter.h"
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    24
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    25
/**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    26
 *  Class for AT NVRAM status change listener
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    27
 *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    28
 *  @lib dunatext.lib
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    29
 *  @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    30
 */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    31
NONSHARABLE_CLASS( CDunAtNvramListen ) : public CActive
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    32
    {
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    33
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    34
public:
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    35
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    36
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    37
     * Two-phased constructor.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    38
     * @param aAtCmdExt Pointer to AT command extension
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    39
     * @param aAtCmdExtCommon Pointer to AT command extension to common
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    40
     *                        functionality
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    41
     * @return Instance of self
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    42
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    43
	static CDunAtNvramListen* NewL( RATExt* aAtCmdExt,
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    44
	                                RATExtCommon* aAtCmdExtCommon );
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    45
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    46
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    47
     * Two-phased constructor.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    48
     * @param aAtCmdExt Pointer to AT command extension
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    49
     * @param aAtCmdExtCommon Pointer to AT command extension to common
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    50
     *                        functionality
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    51
     * @return Instance of self
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    52
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    53
    static CDunAtNvramListen* NewLC( RATExt* aAtCmdExt,
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    54
                                     RATExtCommon* aAtCmdExtCommon );
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    55
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    56
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    57
    * Destructor.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    58
    */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    59
    virtual ~CDunAtNvramListen();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    60
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    61
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    62
     * Resets data to initial values
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    63
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    64
     * @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    65
     * @return None
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    66
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    67
    void ResetData();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    68
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    69
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    70
     * Starts waiting for NVRAM status changes
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    71
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    72
     * @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    73
     * @return Symbian error code on error, KErrNone otherwise
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    74
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    75
    TInt IssueRequest();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    76
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    77
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    78
     * Stops waiting for NVRAM status changes
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    79
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    80
     * @since TB9.2
54
4dc88a4ac6f4 201041_02
hgs
parents: 29
diff changeset
    81
     * @return None
29
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    82
     */
54
4dc88a4ac6f4 201041_02
hgs
parents: 29
diff changeset
    83
    void Stop();
29
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    84
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    85
private:
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    86
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    87
    CDunAtNvramListen( RATExt* aAtCmdExt,
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    88
                       RATExtCommon* aAtCmdExtCommon );
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    89
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    90
    void ConstructL();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    91
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    92
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    93
     * Initializes this class
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    94
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    95
     * @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    96
     * @return None
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    97
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    98
    void Initialize();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
    99
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   100
// from base class CActive
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   101
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   102
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   103
     * From CActive.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   104
     * Gets called when NVRAM has changed
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   105
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   106
     * @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   107
     * @return None
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   108
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   109
    void RunL();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   110
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   111
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   112
     * From CActive.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   113
     * Gets called on cancel
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   114
     *
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   115
     * @since TB9.2
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   116
     * @return None
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   117
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   118
    void DoCancel();
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   119
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   120
private:  // data
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   121
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   122
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   123
     * AT command extension
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   124
     * Not own.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   125
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   126
    RATExt* iAtCmdExt;
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   127
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   128
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   129
     * AT command extension to common functionality
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   130
     * Not own.
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   131
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   132
    RATExtCommon* iAtCmdExtCommon;
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   133
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   134
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   135
     * Buffer for NVRAM
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   136
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   137
    TBuf8<KDefaultNvramBufLength> iNvramBuffer;
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   138
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   139
    /**
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   140
     * Flag to indicate start of receiving
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   141
     */
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   142
    TBool iStarted;
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   143
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   144
    };
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   145
3ae5cb0b4c02 201025_07
hgs
parents:
diff changeset
   146
#endif  // C_CDUNATNVRAMLISTEN_H