include/alp/mobile_usim.h File Reference


Detailed Description

Public header file for USIM services.

#include <alp/mobile_context.h>
#include <alp/mobile_services.h>
#include <alp/mobile_usat.h>

Go to the source code of this file.

Data Structures

struct  _AlpMblUsimCardFile
struct  _AlpMblUsimTrustedCertificates

Defines

#define ALP_MBL_USIM_NOTIFICATION_CARD_FILE_OPERATION_RESULT   ((AlpMblNotificationId) 2)
#define ALP_MBL_USIM_NOTIFICATION_FILE_CHANGE   ((AlpMblNotificationId) 3)
#define ALP_MBL_USIM_NOTIFICATION_NEW_SIM_CARD   ((AlpMblNotificationId) 5)
 notification broadcasted when the inserted sim card is not the same than the previous one
#define ALP_MBL_USIM_NOTIFICATION_USIM_ID_CHANGE   ((AlpMblNotificationId) 1)
#define ALP_MBL_USIM_NOTIFICATION_USIM_STATUS_CHANGE   ((AlpMblNotificationId) 4)
#define ALP_MBL_USIM_PROVISIONING_FILE_BOOTSTRAP   ((AlpMblUsimProvisioningFileType) 1)
#define ALP_MBL_USIM_PROVISIONING_FILE_CONFIG1   ((AlpMblUsimProvisioningFileType) 2)
#define ALP_MBL_USIM_PROVISIONING_FILE_CONFIG2   ((AlpMblUsimProvisioningFileType) 3)
#define ALP_MBL_USIM_PROVISIONING_FILE_UNKNOWN   ((AlpMblUsimProvisioningFileType) 0)
 > Provisioning file type
#define ALP_MBL_USIM_STATUS_CARD_INSERTED   ((AlpMblUsimStatus) 4)
 the UICC is inserted after the device boot sequence
#define ALP_MBL_USIM_STATUS_CARD_POWERED_OFF   ((AlpMblUsimStatus) 2)
 the UICC is powered OFF
#define ALP_MBL_USIM_STATUS_CARD_POWERED_ON   ((AlpMblUsimStatus) 1)
 the UICC is powered ON
#define ALP_MBL_USIM_STATUS_CARD_REMOVED   ((AlpMblUsimStatus) 3)
 the UICC is removed after the device boot sequence
#define ALP_MBL_USIM_STATUS_CARD_RESETED   ((AlpMblUsimStatus) 6)
 the UICC is reseted
#define ALP_MBL_USIM_STATUS_LOCKED   ((AlpMblUsimStatus) 9)
 The SIM card is locked.
#define ALP_MBL_USIM_STATUS_NAA_REINITIALIZED   ((AlpMblUsimStatus) 7)
 the Network Access Application is reinitialized
#define ALP_MBL_USIM_STATUS_NO_CARD   ((AlpMblUsimStatus) 8)
 There is no smart card inserted in the device during the boot sequence.
#define ALP_MBL_USIM_STATUS_READY   ((AlpMblUsimStatus) 10)
 The SIM card is ready.
#define ALP_MBL_USIM_STATUS_UNKNOWN   ((AlpMblUsimStatus) 11)
 The USIM status is not defined yet.

Typedefs

typedef char AlpMblISOName [2]
typedef _AlpMblUsimCardFile AlpMblUsimCardFile
typedef void(* AlpMblUsimCardFileOperationResultCallbackPtr )(void *iUserDataP, AlpMblUsimCardFile *CardFileP, alp_status_t err)
 to be notified when the result from a get card file request is available (asynchronous response)
typedef char AlpMblUsimCardId [21]
 card identification number (retrieved from EF ICCID at MF-level)
typedef void(* AlpMblUsimFileChangeCallbackPtr )(void *iUserDataP, AlpMblUsatRefreshFileList *ioFileListP)
 to be notified when USIM files are modified during an application, so as to re-read EF's data from UICC
typedef void(* AlpMblUsimIdChangeCallbackPtr )(void *iUserDataP, AlpMblContextId iMobileContextId, AlpMblUsimId iPrevious, AlpMblUsimId iCurrent)
 to be notified when the USIM application is changed
typedef void(* AlpMblUsimNewSimCardCallbackPtr )(void *iUserDataP, AlpMblUsimCardId iCardIdentification)
typedef char AlpMblUsimProvisioningFilePath [256]
typedef unsigned char AlpMblUsimProvisioningFileType
 > path of the provisioning file image retrieved from the WAP provisioning file structure present in the smart card.
typedef unsigned char AlpMblUsimStatus
typedef void(* AlpMblUsimStatusChangeCallbackPtr )(void *iUserDataP, AlpMblUsimId iUsimId, AlpMblUsimStatus iPrevious, AlpMblUsimStatus iCurrent)
typedef _AlpMblUsimTrustedCertificates AlpMblUsimTrustedCertificates
 > path of one trusted certificate retrieved from the WAP provisioning file structure present in the smart card.
typedef char AlpMblUsimTrustedCertificatesPath [256]
 > type of the provisioning file (Bootstrap, Config1 or Config2, see ALP_MBL_USIM_PROVISIONING_FILE_X)

Functions

alp_status_t alp_mbl_usim_get_default_usim_id (AlpMblUsimId *oDefaultUsimIdP)
alp_status_t alp_mbl_usim_get_provisioning_file (AlpMblUsimId iUsimId, AlpMblUsimProvisioningFileType iProvisioningFileType, AlpMblUsimProvisioningFilePath *oProvisioningFilePathP)
alp_status_t alp_mbl_usim_get_usim_ids (AlpMblUsimList *oUsimListP)
alp_status_t alp_mbl_usim_perform_card_file_operation (AlpMblUsimId iUsimId, AlpMblUsimCardFile *ioCardFileP)
alp_status_t alp_mbl_usim_select_usim_id (AlpMblContextId iMobileContextId, AlpMblUsimId iUsimId)


Generated on Wed Jul 30 07:06:40 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation

Copyright © 1999-2008 ACCESS CO., LTD. All rights reserved.