1 /*

     2 * Copyright (c) 2005-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:  Interface implemented by core server. Lower adaptation can use

    15 *                these services.

    16 *

    17 */

    18 

    19 

    20 #ifndef ABS_CORE_DRIVERIF_CALLBACK_H

    21 #define ABS_CORE_DRIVERIF_CALLBACK_H

    22 

    23 #include "core_types.h"

    24 

    25 /**

    26  * Abstract core server interface for low-level adaptation layer callbacks.

    27  *

    28  * This interface is implemented by the core server and it provides a callback

    29  * interface for the low-level adaptation layer.

    30  *

    31  * @since S60 v3.1

    32  * @see abs_core_driverif_c

    33  */

    34 class abs_core_driverif_callback_c

    35     {

    36 

    37 public:

    38 

    39     /**

    40      * Destructor.

    41      */

    42     virtual ~abs_core_driverif_callback_c() {};

    43 

    44     /**

    45      * Inform the core server about a new received frame.

    46      *

    47      * @since S60 v3.1

    48      * @param frame_type The type of the frame received.

    49      * @param frame_length The length of the frame.

    50      * @param frame_data Pointer to the frame data.     

    51      * @param frame_rcpi RCPI value of the frame.

    52      */

    53     virtual void receive_frame(

    54         core_frame_type_e frame_type,

    55         const u16_t frame_length,

    56         const u8_t* const frame_data,

    57         u8_t frame_rcpi ) = 0;

    58 

    59     /**

    60      * Notify the core server about an adaptation layer event.

    61      *

    62      * @since S60 v3.1

    63      * @param indication Adaptation layer event.

    64      */

    65     virtual void notify(

    66         core_am_indication_e indication ) = 0;

    67 

    68     /**

    69      * An asynchronous request from the core server has been completed.

    70      *

    71      * @since S60 v3.1

    72      * @param request_id Identification of the corresponding request.

    73      * @param status Completion status of the request.

    74      */

    75     virtual void request_complete(

    76         u32_t request_id,

    77         core_error_e status ) = 0;

    78 

    79     };

    80 

    81 #endif // ABS_CORE_DRIVERIF_CALLBACK_H