cellular_types.h

Go to the documentation of this file.

/*
 * FreeRTOS-Cellular-Interface v1.2.0
 * Copyright (C) 2020 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of
 * this software and associated documentation files (the "Software"), to deal in
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 * the Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 * https://www.FreeRTOS.org
 * https://github.com/FreeRTOS
 */
 
#ifndef __CELLULAR_TYPES_H__
#define __CELLULAR_TYPES_H__
 
/* *INDENT-OFF* */
#ifdef __cplusplus
    extern "C" {
#endif
/* *INDENT-ON* */
 
/* Includes for standard bool and int. */
#include <stdbool.h>
#include <stdint.h>
 
#define CELLULAR_INVALID_SIGNAL_VALUE        ( -32768 )
 
#define CELLULAR_INVALID_SIGNAL_BAR_VALUE    ( 0xFFU )
 
struct CellularContext;
 
typedef struct CellularContext         CellularContext_t;
 
typedef struct CellularContext         * CellularHandle_t;
 
struct CellularSocketContext;
 
typedef struct CellularSocketContext   * CellularSocketHandle_t;
 
typedef enum CellularError
{
    CELLULAR_SUCCESS = 0,            
    CELLULAR_INVALID_HANDLE,         
    CELLULAR_MODEM_NOT_READY,        
    CELLULAR_LIBRARY_NOT_OPEN,       
    CELLULAR_LIBRARY_ALREADY_OPEN,   
    CELLULAR_BAD_PARAMETER,          
    CELLULAR_NO_MEMORY,              
    CELLULAR_TIMEOUT,                
    CELLULAR_SOCKET_CLOSED,          
    CELLULAR_SOCKET_NOT_CONNECTED,   
    CELLULAR_INTERNAL_FAILURE,       
    CELLULAR_RESOURCE_CREATION_FAIL, 
    CELLULAR_UNSUPPORTED,            
    CELLULAR_NOT_ALLOWED,            
    CELLULAR_UNKNOWN                 
} CellularError_t;
 
typedef enum CellularRat
{
    CELLULAR_RAT_GSM = 0,        
    CELLULAR_RAT_WCDMA = 2,      
    CELLULAR_RAT_EDGE = 3,       
    CELLULAR_RAT_HSDPA = 4,      
    CELLULAR_RAT_HSUPA = 5,      
    CELLULAR_RAT_HSDPAHSUPA = 6, 
    CELLULAR_RAT_LTE = 7,        
    CELLULAR_RAT_CATM1 = 8,      
    CELLULAR_RAT_NBIOT = 9,      
    CELLULAR_RAT_MAX,            
    CELLULAR_RAT_INVALID = 0xFF  
} CellularRat_t;
 
typedef enum CellularSimCardState
{
    CELLULAR_SIM_CARD_REMOVED = 0, 
    CELLULAR_SIM_CARD_INSERTED,    
    CELLULAR_SIM_CARD_STATUS_MAX,  
    CELLULAR_SIM_CARD_UNKNOWN      
} CellularSimCardState_t;
 
typedef enum CellularSimCardLockState
{
    CELLULAR_SIM_CARD_READY = 0,     
    CELLULAR_SIM_CARD_PIN,           
    CELLULAR_SIM_CARD_PUK,           
    CELLULAR_SIM_CARD_PIN2,          
    CELLULAR_SIM_CARD_PUK2,          
    CELLULAR_SIM_CARD_PH_NET_PIN,    
    CELLULAR_SIM_CARD_PH_NET_PUK,    
    CELLULAR_SIM_CARD_PH_NETSUB_PIN, 
    CELLULAR_SIM_CARD_PH_NETSUB_PUK, 
    CELLULAR_SIM_CARD_SP_PIN,        
    CELLULAR_SIM_CARD_SP_PUK,        
    CELLULAR_SIM_CARD_CORP_PIN,      
    CELLULAR_SIM_CARD_CORP_PUK,      
    CELLULAR_SIM_CARD_IMSI_PIN,      
    CELLULAR_SIM_CARD_IMSI_PUK,      
    CELLULAR_SIM_CARD_INVALID,       
    CELLULAR_SIM_CARD_LOCK_UNKNOWN   
} CellularSimCardLockState_t;
 
typedef enum CellularNetworkRegistrationMode
{
    REGISTRATION_MODE_AUTO = 0,             
    REGISTRATION_MODE_MANUAL = 1,           
    REGISTRATION_MODE_DEREGISTER = 2,       
    REGISTRATION_MODE_MANUAL_THEN_AUTO = 4, 
    REGISTRATION_MODE_MAX,                  
    REGISTRATION_MODE_UNKNOWN               
} CellularNetworkRegistrationMode_t;
 
typedef enum CellularNetworkRegistrationStatus
{
    REGISTRATION_STATUS_NO_REGISTERED_SEARCHING = 0,      
    REGISTRATION_STATUS_REGISTERED_HOME = 1,              
    REGISTRATION_STATUS_NOT_REGISTERED_SEARCHING = 2,     
    REGISTRATION_STATUS_REGISTRATION_DENIED = 3,          
    REGISTRATION_STATUS_UNKNOWN = 4,                      
    REGISTRATION_STATUS_ROAMING_REGISTERED = 5,           
    REGISTRATION_STATUS_HOME_SMS_ONLY_REGISTERED = 6,     
    REGISTRATION_STATUS_SMS_ONLY_ROAMING_REGISTERED = 7,  
    REGISTRATION_STATUS_ATTACHED_EMERG_SERVICES_ONLY = 8, 
    REGISTRATION_STATUS_MAX                               
} CellularNetworkRegistrationStatus_t;
 
typedef enum CellularOperatorNameFormat
{
    OPERATOR_NAME_FORMAT_LONG = 0,        
    OPERATOR_NAME_FORMAT_SHORT = 1,       
    OPERATOR_NAME_FORMAT_NUMERIC = 2,     
    OPERATOR_NAME_FORMAT_NOT_PRESENT = 9, 
    OPERATOR_NAME_FORMAT_MAX              
} CellularOperatorNameFormat_t;
 
typedef enum CellularUrcEvent
{
    CELLULAR_URC_EVENT_NETWORK_CS_REGISTRATION, 
    CELLULAR_URC_EVENT_NETWORK_PS_REGISTRATION, 
    CELLULAR_URC_EVENT_PDN_ACTIVATED,           
    CELLULAR_URC_EVENT_PDN_DEACTIVATED,         
    CELLULAR_URC_EVENT_SIGNAL_CHANGED,          
    CELLULAR_URC_SOCKET_OPENED,                 
    CELLULAR_URC_SOCKET_OPEN_FAILED,            
    CELLULAR_URC_EVENT_OTHER                    
} CellularUrcEvent_t;
 
typedef enum CellularModemEvent
{
    CELLULAR_MODEM_EVENT_BOOTUP_OR_REBOOT, 
    CELLULAR_MODEM_EVENT_POWERED_DOWN,     
    CELLULAR_MODEM_EVENT_PSM_ENTER         
} CellularModemEvent_t;
 
typedef enum CellularPdnContextType
{
    CELLULAR_PDN_CONTEXT_IPV4 = 1,   
    CELLULAR_PDN_CONTEXT_IPV6 = 2,   
    CELLULAR_PDN_CONTEXT_IPV4V6 = 3, 
    CELLULAR_PDN_CONTEXT_TYPE_MAX    
} CellularPdnContextType_t;
 
typedef enum CellularPdnAuthType
{
    CELLULAR_PDN_AUTH_NONE = 0,   
    CELLULAR_PDN_AUTH_PAP,        
    CELLULAR_PDN_AUTH_CHAP,       
    CELLULAR_PDN_AUTH_PAP_OR_CHAP 
} CellularPdnAuthType_t;
 
typedef enum CellularSocketDomain
{
    CELLULAR_SOCKET_DOMAIN_AF_INET, 
    CELLULAR_SOCKET_DOMAIN_AF_INET6 
} CellularSocketDomain_t;
 
typedef enum CellularSocketType
{
    CELLULAR_SOCKET_TYPE_DGRAM, 
    CELLULAR_SOCKET_TYPE_STREAM 
} CellularSocketType_t;
 
typedef enum CellularSocketProtocol
{
    CELLULAR_SOCKET_PROTOCOL_UDP,
    CELLULAR_SOCKET_PROTOCOL_TCP
} CellularSocketProtocol_t;
 
typedef enum CellularSocketAccessMode
{
    CELLULAR_ACCESSMODE_BUFFER = 0,  /* Data access buffer mode. */
    CELLULAR_ACCESSMODE_DIRECT_PUSH, /* Data access direct push mode. */
    CELLULAR_ACCESSMODE_TRANSPARENT, /* Data access transparent mode. */
    CELLULAR_ACCESSMODE_NOT_SET      /* Data access not set. */
} CellularSocketAccessMode_t;
 
typedef enum CellularIPAddressType
{
    CELLULAR_IP_ADDRESS_V4, 
    CELLULAR_IP_ADDRESS_V6  
} CellularIPAddressType_t;
 
typedef enum CellularSocketOptionLevel
{
    CELLULAR_SOCKET_OPTION_LEVEL_IP,       
    CELLULAR_SOCKET_OPTION_LEVEL_TRANSPORT 
} CellularSocketOptionLevel_t;
 
typedef enum CellularSocketOption
{
    CELLULAR_SOCKET_OPTION_MAX_IP_PACKET_SIZE, 
    CELLULAR_SOCKET_OPTION_SEND_TIMEOUT,       
    CELLULAR_SOCKET_OPTION_RECV_TIMEOUT,       
    CELLULAR_SOCKET_OPTION_PDN_CONTEXT_ID      
} CellularSocketOption_t;
 
typedef enum CellularPktStatus
{
    CELLULAR_PKT_STATUS_OK = 0,          /* The operation was successful. */
    CELLULAR_PKT_STATUS_TIMED_OUT,       /* The operation timed out. */
    CELLULAR_PKT_STATUS_FAILURE,         /* There was some internal failure. */
    CELLULAR_PKT_STATUS_BAD_REQUEST,     /* Request was not valid. */
    CELLULAR_PKT_STATUS_BAD_RESPONSE,    /* The response received was not valid. */
    CELLULAR_PKT_STATUS_SIZE_MISMATCH,   /* There is a size mismatch between the params. */
    CELLULAR_PKT_STATUS_BAD_PARAM,       /* One or more params is not valid. */
    CELLULAR_PKT_STATUS_SEND_ERROR,      /* Modem returned a send error. */
    CELLULAR_PKT_STATUS_INVALID_HANDLE,  /* Invalid context. */
    CELLULAR_PKT_STATUS_CREATION_FAIL,   /* Resource creation fail. */
    CELLULAR_PKT_STATUS_PREFIX_MISMATCH, /* Invalid prefix from Modem resp. */
    CELLULAR_PKT_STATUS_INVALID_DATA,    /* Invalid data from Modem resp. */
    CELLULAR_PKT_STATUS_PENDING_DATA,    /* Pending data from Modem resp. */
    CELLULAR_PKT_STATUS_PENDING_BUFFER   /* Pending data from Modem resp. */
} CellularPktStatus_t;
 
typedef enum CellularATCommandType
{
    CELLULAR_AT_NO_RESULT,            
    CELLULAR_AT_WO_PREFIX,            
    CELLULAR_AT_WITH_PREFIX,          
    CELLULAR_AT_MULTI_WITH_PREFIX,    
    CELLULAR_AT_MULTI_WO_PREFIX,      
    CELLULAR_AT_MULTI_DATA_WO_PREFIX, 
    CELLULAR_AT_NO_COMMAND            
} CellularATCommandType_t;
 
typedef struct CellularSimCardStatus
{
    CellularSimCardState_t simCardState;         
    CellularSimCardLockState_t simCardLockState; 
} CellularSimCardStatus_t;
 
typedef struct CellularPlmnInfo
{
    char mcc[ CELLULAR_MCC_MAX_SIZE + 1 ]; 
    char mnc[ CELLULAR_MNC_MAX_SIZE + 1 ]; 
} CellularPlmnInfo_t;
 
typedef struct CellularSimCardInfo
{
    char iccid[ CELLULAR_ICCID_MAX_SIZE + 1 ]; 
    char imsi[ CELLULAR_IMSI_MAX_SIZE + 1 ];   
    CellularPlmnInfo_t plmn;                   
} CellularSimCardInfo_t;
 
typedef struct CellularModemInfo
{
    char hardwareVersion[ CELLULAR_HW_VERSION_MAX_SIZE + 1 ];   
    char firmwareVersion[ CELLULAR_FW_VERSION_MAX_SIZE + 1 ];   
    char serialNumber[ CELLULAR_SERIAL_NUM_MAX_SIZE + 1 ];      
    char imei[ CELLULAR_IMEI_MAX_SIZE + 1 ];                    
    char manufactureId[ CELLULAR_MANUFACTURE_ID_MAX_SIZE + 1 ]; 
    char modelId[ CELLULAR_MODEL_ID_MAX_SIZE + 1 ];             
} CellularModemInfo_t;
 
typedef struct CellularTime
{
    uint8_t month;    
    uint8_t day;      
    uint8_t hour;     
    uint8_t minute;   
    uint8_t second;   
    uint16_t year;    
    int32_t timeZone; 
    uint8_t dst;      
} CellularTime_t;
 
typedef struct CellularSignalInfo
{
    int16_t rssi; 
    int16_t rsrp; 
    int16_t rsrq; 
    int16_t sinr; 
    int16_t ber;  
    uint8_t bars; 
} CellularSignalInfo_t;
 
typedef struct CellularServiceStatus
{
    CellularRat_t rat;                                         
    CellularNetworkRegistrationMode_t networkRegistrationMode; 
    CellularNetworkRegistrationStatus_t csRegistrationStatus;  
    CellularNetworkRegistrationStatus_t psRegistrationStatus;  
    CellularPlmnInfo_t plmnInfo;                               
    CellularOperatorNameFormat_t operatorNameFormat;           
    char operatorName[ CELLULAR_NETWORK_NAME_MAX_SIZE + 1 ];   
    uint8_t csRejectionType;                                   
    uint8_t csRejectionCause;                                  
    uint8_t psRejectionType;                                   
    uint8_t psRejectionCause;                                  
} CellularServiceStatus_t;
 
typedef struct CellularATCommandLine
{
    struct CellularATCommandLine * pNext; 
    char * pLine;                         
} CellularATCommandLine_t;
 
typedef struct CellularATCommandResponse
{
    bool status;                    
    CellularATCommandLine_t * pItm; 
} CellularATCommandResponse_t;
 
typedef struct CellularPsmSettings
{
    /*
     * 0 = PSM Disable
     * 1 = PSM Enable.
     */
    uint8_t mode; 
    /*
     * Bits 5 to 1 represent the binary coded timer value
     * Bits 6 to 8 define the timer value unit as follows:
     * Bits
     * 8 7 6
     * 0 0 0 value is incremented in multiples of 10 minutes
     * 0 0 1 value is incremented in multiples of 1 hour
     * 0 1 0 value is incremented in multiples of 10 hours
     * 0 1 1 value is incremented in multiples of 2 seconds
     * 1 0 0 value is incremented in multiples of 30 seconds
     * 1 0 1 value is incremented in multiples of 1 minute
     *
     * e.g. "00001010" equals to 100 minutes.
     * first uint8_t is used for PSM set, whole uint32_t is used for PSM get.
     */
    uint32_t periodicTauValue; 
    /*
     * Bits 5 to 1 represent the binary coded timer value
     * Bits 6 to 8 define the timer value unit as follows:
     * Bits
     * 8 7 6
     * 0 0 0 value is incremented in multiples of 10 minutes
     * 0 0 1 value is incremented in multiples of 1 hour
     * 0 1 0 value is incremented in multiples of 10 hours
     * 0 1 1 value is incremented in multiples of 2 seconds
     * 1 0 0 value is incremented in multiples of 30 seconds
     * 1 0 1 value is incremented in multiples of 1 minute
     *
     * e.g. "00001010" equals to 100 minutes.
     * first uint8_t is used for PSM set, whole uint32_t is used for PSM get.
     */
    uint32_t periodicRauValue; 
    /*
     * Bits 5 to 1 represent the binary coded timer value
     * Bits 6 to 8 define the timer value unit as follows:
     * Bits
     * 8 7 6
     * 0 0 0 value is incremented in multiples of 10 minutes
     * 0 0 1 value is incremented in multiples of 1 hour
     * 0 1 0 value is incremented in multiples of 10 hours
     * 0 1 1 value is incremented in multiples of 2 seconds
     * 1 0 0 value is incremented in multiples of 30 seconds
     * 1 0 1 value is incremented in multiples of 1 minute
     *
     * e.g. "00001010" equals to 100 minutes.
     * first uint8_t is used for PSM set, whole uint32_t is used for PSM get.
     */
    uint32_t gprsReadyTimer; 
    /*
     * Bits 5 to 1 represent the binary coded timer value.
     * Bits 6 to 8 define the timer value unit as follows:
     * Bits
     * 8 7 6
     * 0 0 0 value is incremented in multiples of 2 seconds
     * 0 0 1 value is incremented in multiples of 1 minute
     * 0 1 0 value is incremented in multiples of decihours
     * 1 1 1 value indicates that the timer is deactivated.
     *
     * "00001111" equals to 30 seconds.
     * first uint8_t is used for PSM set, whole uint32_t is used for PSM get.
     */
    uint32_t activeTimeValue; 
} CellularPsmSettings_t;
 
typedef struct CellularEidrxSettings
{
    /*
     * 0 Disable the use of e-I-DRX
     * 1 Enable the use of e-I-DRX
     * 2 Enable the use of e-I-DRX and enable the unsolicited result code
     * 3 Disable the use of e-I-DRX and discard all parameters for e-I-DRX or,
     *   if available, reset to the manufacturer specific default values.
     */
    uint8_t mode; 
    /*
     * 2 GSM
     * 3 UTRAN
     * 4 LTE Cat M1
     * 5 LTE Cat NB1
     */
    uint8_t rat; 
    /*
     * String type. Half a byte in a 4 bit format.
     * bit
     * 4 3 2 1 E-UTRAN e-I-DRX cycle length duration
     * 0 0 0 0   5.12 seconds
     * 0 0 0 1   10.24 seconds
     * 0 0 1 0   20.48 seconds
     * 0 0 1 1   40.96 seconds
     * 0 1 0 0   61.44 seconds
     * 0 1 0 1   81.92 seconds
     * 0 1 1 0   102.4 seconds
     * 0 1 1 1   122.88 seconds
     * 1 0 0 0   143.36 seconds
     * 1 0 0 1   163.84 seconds
     * 1 0 1 0   327.68 seconds
     * 1 0 1 1   655,36 seconds
     * 1 1 0 0   1310.72 seconds
     * 1 1 0 1   2621.44 seconds
     * 1 1 1 0   5242.88 seconds
     * 1 1 1 1   10485.76 seconds
     */
    uint8_t requestedEdrxVaue;  
    uint8_t nwProvidedEdrxVaue; 
    /*
     * LTE Cat M1 mode
     * bit
     * 4 3 2 1 Paging Time Window length
     * 0 0 0 0 1.28 seconds
     * 0 0 0 1 2.56 seconds
     * 0 0 1 0 3.84 seconds
     * 0 0 1 1 5.12 seconds
     * 0 1 0 0 6.4 seconds
     * 0 1 0 1 7.68 seconds
     * 0 1 1 0 8.96 seconds
     * 0 1 1 1 10.24 seconds
     * 1 0 0 0 11.52 seconds
     * 1 0 0 1 12.8 seconds
     * 1 0 1 0 14.08 seconds
     * 1 0 1 1 15.36 seconds
     * 1 1 0 0 16.64 seconds
     * 1 1 0 1 17.92 seconds
     * 1 1 1 0 19.20 seconds
     * 1 1 1 1 20.48 seconds
     *
     * LTE Cat NB1 mode
     * bit
     * 4 3 2 1 Paging Time Window length
     * 0 0 0 0 2.56 seconds
     * 0 0 0 1 5.12 seconds
     * 0 0 1 0 7.68 seconds
     * 0 0 1 1 10.24 seconds
     * 0 1 0 0 12.8 seconds
     * 0 1 0 1 15.36 seconds
     * 0 1 1 0 17.92 seconds
     * 0 1 1 1 20.48 seconds
     * 1 0 0 0 23.04 seconds
     * 1 0 0 1 25.6 seconds
     * 1 0 1 0 28.16 seconds
     * 1 0 1 1 30.72 seconds
     * 1 1 0 0 33.28 seconds
     * 1 1 0 1 35.84 seconds
     * 1 1 1 0 38.4 seconds
     * 1 1 1 1 40.96 seconds
     */
    uint8_t pagingTimeWindow; 
} CellularEidrxSettings_t;
 
typedef struct CellularEidrxSettingsList
{
    CellularEidrxSettings_t eidrxList[ CELLULAR_EDRX_LIST_MAX_SIZE ]; 
    uint8_t count;                                                    
} CellularEidrxSettingsList_t;
 
typedef struct CellularIPAddress
{
    CellularIPAddressType_t ipAddressType;              
    char ipAddress[ CELLULAR_IP_ADDRESS_MAX_SIZE + 1 ]; 
} CellularIPAddress_t;
 
typedef struct CellularPdnConfig
{
    CellularPdnContextType_t pdnContextType;                   
    CellularPdnAuthType_t pdnAuthType;                         
    const char apnName[ CELLULAR_APN_MAX_SIZE + 1 ];           
    const char username[ CELLULAR_PDN_USERNAME_MAX_SIZE + 1 ]; 
    const char password[ CELLULAR_PDN_PASSWORD_MAX_SIZE + 1 ]; 
} CellularPdnConfig_t;
 
typedef struct CellularPdnStatus
{
    uint8_t contextId;                       
    uint8_t state;                           
    CellularPdnContextType_t pdnContextType; 
    CellularIPAddress_t ipAddress;           
} CellularPdnStatus_t;
 
typedef struct CellularSocketAddress
{
    CellularIPAddress_t ipAddress; 
    uint16_t port;                 
} CellularSocketAddress_t;
 
typedef CellularPktStatus_t ( * CellularATCommandResponseReceivedCallback_t ) ( CellularHandle_t cellularHandle,
                                                                                const CellularATCommandResponse_t * pAtResp,
                                                                                void * pData,
                                                                                uint16_t dataLen );
 
typedef void ( * CellularUrcNetworkRegistrationCallback_t )( CellularUrcEvent_t urcEvent,
                                                             const CellularServiceStatus_t * pServiceStatus,
                                                             void * pCallbackContext );
 
typedef void ( * CellularUrcPdnEventCallback_t )( CellularUrcEvent_t urcEvent,
                                                  uint8_t contextId,
                                                  void * pCallbackContext );
 
typedef void ( * CellularUrcSignalStrengthChangedCallback_t )( CellularUrcEvent_t urcEvent,
                                                               const CellularSignalInfo_t * pSignalInfo,
                                                               void * pCallbackContext );
 
typedef void ( * CellularUrcGenericCallback_t )( const char * pRawData,
                                                 void * pCallbackContext );
 
typedef void ( * CellularModemEventCallback_t )( CellularModemEvent_t modemEvent,
                                                 void * pCallbackContext );
 
typedef void ( * CellularSocketOpenCallback_t )( CellularUrcEvent_t urcEvent,
                                                 CellularSocketHandle_t socketHandle,
                                                 void * pCallbackContext );
 
typedef void ( * CellularSocketDataReadyCallback_t )( CellularSocketHandle_t socketHandle,
                                                      void * pCallbackContext );
 
typedef void ( * CellularSocketClosedCallback_t )( CellularSocketHandle_t socketHandle,
                                                   void * pCallbackContext );
 
/* *INDENT-OFF* */
#ifdef __cplusplus
    }
#endif
/* *INDENT-ON* */
 
#endif /* __CELLULAR_TYPES_H__ */