The remote SIM profile is a profile of a SIM card placed remotely. Users can manage the remote SIM profile using this service and interface between the application and the SIM card service based on the SIM Access Profile (SAP) specification. A remote SIM profile is needed for applications that want to add, delete, enable, or disable a SIM profile locally or remotely.

IPC interfaces binding

The functions this API are provided by the tafSimCardSvc application service.

The follwoing example illustrates how to bind to the Remote SIM Profile service.

bindings:
{
    clientExe.clientComponent.taf_simRsp -> tafSimCardSvc.taf_simRsp
}

Adding a SIM profile

A SIM profile can be added remotely using taf_simRsp_AddProfile() with slotId, activationCode, confirmationCode and userConsentSupported passed as parameters.

#define SLOT_ID  TAF_SIM_EXTERNAL_SLOT_1
#define ACTIVATION_CODE "LPA:1$mc4-poc5.otlabs.fr$333353014959437" //This is for test, dummy activation code
le_result_t res = taf_simRsp_AddProfile((taf_sim_Id_t) TAF_SIM_EXTERNAL_SLOT_1, ACTIVATION_CODE,"",false);
LE_ASSERT(res == LE_OK);

Before the SIM profile download is started, an application registers a state change handler using taf_simRsp_AddProfileDownloadHandler(). Once the profile download is completed, the handler will be called indicating it's completed. If profile downloading failed or the downloading state changed, the handler will be called with the error code or new state.

taf_simRsp_ProfileDownloadHandlerRef_t pdHandlerRef = taf_simRsp_AddProfileDownloadHandler(ProfileDownloadHandler, NULL);

To enable a SIM profile, an application can use taf_simRsp_SetProfile() with the slotId, profileId and enable flag passed as parameters. To delete a SIM profile, an application can use taf_simRsp_DeleteProfile() with the slotId and profileId passed as parameters.

Applications must use taf_simRsp_RemoveProfileDownloadHandler() to release the taf_simRsp_ProfileDownloadHandlerRef_t download handler reference object when it is no longer used.