pa_mdc.h

Go to the documentation of this file.

//--------------------------------------------------------------------------------------------------
#ifndef LEGATO_PA_MDC_INCLUDE_GUARD
#define LEGATO_PA_MDC_INCLUDE_GUARD

#include "legato.h"
#include "interfaces.h"


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_MAX_PROFILE 5


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_APN_MAX_LEN LE_MDC_APN_NAME_MAX_LEN

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_APN_MAX_BYTES (PA_MDC_APN_MAX_LEN+1)

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_USERNAME_MAX_LEN LE_MDC_USER_NAME_MAX_LEN

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_USERNAME_MAX_BYTES (PA_MDC_USERNAME_MAX_LEN+1)

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_PWD_MAX_LEN LE_MDC_PASSWORD_NAME_MAX_LEN

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
#define PA_MDC_PWD_MAX_BYTES (PA_MDC_PWD_MAX_LEN+1)

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef struct {
    le_mdc_Auth_t type;                       
    char userName[PA_MDC_USERNAME_MAX_BYTES]; 
    char password[PA_MDC_APN_MAX_BYTES];      
}
pa_mdc_Authentication_t;

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef enum {
    PA_MDC_SESSION_IPV4=0,  
    PA_MDC_SESSION_IPV6,    
    PA_MDC_SESSION_IPV4V6,  
}
pa_mdc_SessionType_t;

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef struct {
    char apn[PA_MDC_APN_MAX_BYTES]; 
    pa_mdc_Authentication_t authentication; 
    le_mdc_Pdp_t pdp;           
}
pa_mdc_ProfileData_t;


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef enum
{
    PA_MDC_CONNECTED,       
    PA_MDC_DISCONNECTED,    
}
pa_mdc_SessionState_t;


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef struct {
    uint32_t profileIndex;              
    pa_mdc_SessionState_t newState;     
}
pa_mdc_SessionStateData_t;

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef struct {
    uint64_t    transmittedBytesCount;  
    uint64_t    receivedBytesCount;     
}
pa_mdc_PktStatistics_t;

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
typedef void (*pa_mdc_SessionStateHandler_t)
(
    pa_mdc_SessionStateData_t* sessionStatePtr
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_ReadProfile
(
    uint32_t profileIndex,                  
    pa_mdc_ProfileData_t* profileDataPtr    
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_WriteProfile
(
    uint32_t profileIndex,                  
    pa_mdc_ProfileData_t* profileDataPtr    
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_StartSessionIPV4
(
    uint32_t profileIndex,        
    uint32_t* callRefPtr          
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_StartSessionIPV6
(
    uint32_t profileIndex,        
    uint32_t* callRefPtr          
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_StartSessionIPV4V6
(
    uint32_t profileIndex,        
    uint32_t* callRefPtr          
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetSessionType
(
    uint32_t profileIndex,              
    pa_mdc_SessionType_t* sessionIpPtr  
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_StopSession
(
    uint32_t callRef         
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetSessionState
(
    uint32_t profileIndex,                  
    pa_mdc_SessionState_t* sessionStatePtr  
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
void pa_mdc_SetSessionStateHandler
(
    pa_mdc_SessionStateHandler_t handlerRef 
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetInterfaceName
(
    uint32_t profileIndex,                  
    char*  interfaceNameStr,                
    size_t interfaceNameStrSize             
);


//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetIPAddress
(
    uint32_t profileIndex,             
    le_mdmDefs_IpVersion_t ipVersion,          
    char*  ipAddrStr,                  
    size_t ipAddrStrSize               
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetGatewayAddress
(
    uint32_t profileIndex,                  
    le_mdmDefs_IpVersion_t ipVersion,               
    char*  gatewayAddrStr,                  
    size_t gatewayAddrStrSize               
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetDNSAddresses
(
    uint32_t profileIndex,                  
    le_mdmDefs_IpVersion_t ipVersion,               
    char*  dns1AddrStr,                     
    size_t dns1AddrStrSize,                 
    char*  dns2AddrStr,                     
    size_t dns2AddrStrSize                  
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetAccessPointName
(
    uint32_t profileIndex,             
    char*  apnNameStr,                 
    size_t apnNameStrSize              
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetDataBearerTechnology
(
    uint32_t                       profileIndex,              
    le_mdc_DataBearerTechnology_t* downlinkDataBearerTechPtr, 
    le_mdc_DataBearerTechnology_t* uplinkDataBearerTechPtr    
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_GetDataFlowStatistics
(
    pa_mdc_PktStatistics_t *dataStatisticsPtr 
);

//--------------------------------------------------------------------------------------------------
//--------------------------------------------------------------------------------------------------
le_result_t pa_mdc_ResetDataFlowStatistics
(
    void
);

#endif // LEGATO_PA_MDC_INCLUDE_GUARD