UICC SE card emulation

The sample code below demonstrates how to retrieve the current values of the user settings:

#include <nfc/nfc.h> 
bool ceAllowedWhenBacklightOffOrLocked = false; 
bool ceAllowedWhenPoweredOff = false;
if (NFC_RESULT_SUCCESS == 
        nfc_get_setting(NFC_SETTING_CE_BACKLIGHT_OFF,
                  &ceAllowedWhenBacklightOffOrLocked) &&
      NFC_RESULT_SUCCESS == 
        nfc_get_setting(NFC_SETTING_CE_POWERED_OFF,
                        &ceAllowedWhenPoweredOff)) { 
    printf("CE allowed when locked or backlight is off: %s\n",
      ceAllowedWhenBacklightOffOrLocked ? "true" : "false");
    printf("CE allowed when device is turned off: %s\n", 
      ceAllowedWhenPoweredOff ? "true" : "false"); 
} else {
    // Handle error
} 

The sample code below uses nfc_set_setting() to turn on the When device is turned off setting. You can also use this function to turn the setting off, or to modify the When locked or backlight is off setting.

#include <nfc/nfc.h>
nfc_result_t res = 
        nfc_set_setting(NFC_SETTING_CE_POWERED_OFF, true); 
if(res == NFC_RESULT_SUCCESS) { 
    // The dialog is currently on the screen; we need
    // to wait for a BlackBerry Platform Services
    // message with the actual result.
} else if(res == NFC_RESULT_RESOURCE_BUSY) { 
    // The user is already being prompted about a setting 
    // change (by this or another application). We should
    // try again later. 
} else {
    // Handle error
}    
            

Receive the response to your request in a BlackBerry Platform Services event loop such as the following. An NFC_RESULT_SUCCESS event means the setting has been successfully changed. In this code sample, it indicates that card transaction is now enabled when the device is powered off.

 
#include <nfc/nfc_bps.h>
#include <nfc/nfc.h> 
#include <bps/bps.h>
                
bps_initialize(); 
nfc_request_events(); 
                
for (;;) { 
    bps_event_t* event;
    nfc_event_t* nfc_event; 
    nfc_event_type_t event_type; 
    int event_value;
    bps_get_event(&event, -1); 
    if (bps_event_get_domain(event) == nfc_get_domain() 
        && BPS_SUCCESS == 
              nfc_get_nfc_event(event, &nfc_event) 
        && NFC_RESULT_SUCCESS == 
              nfc_get_event_type(nfc_event, &event_type) 
        && NFC_CE_ENABLE_POWERED_OFF_EVENT == event_type 
        && NFC_RESULT_SUCCESS == 
              nfc_get_notification_value(nfc_event, 
                                         &event_value)) {
        switch (event_value) { 
            case NFC_RESULT_SUCCESS: 
                // Handle the case where the setting 
                // was successfully changed 
            case NFC_RESULT_OPERATION_REJECTED: 
                // Handle the case where the user 
                // declined the setting change 
            default:
                // Default error handling
       } 
    } else { 
       // Handle uninteresting or invalid events 
    } 
} 

The following pseudo code demonstrates how to configure technology types in a wallet application. For simplicity, error handling is not included.

uint32_t currentTechType = 0;
nfc_se_reader_get_technology_types(session, 
				batteryMode, 
				&currentTechType);
				
if(currentTechType != desiredTechType) {
				
    // Make sure the UICC is the Active SE
	secure_element_id_type_t activeSEType = SE_ID_NONE;
	nfc_se_get_active_se_type(&activeSEType);
	if(activeSEType != UICC_SE_ID) {
		nfc_se_set_uicc_active();
		// Wait for NFC_CE_SET_UICC_ACTIVE_SE_TYPE_EVENT.
		...
				
		// Handle error case in which the user cancels 
		// the request to make the UICC the active SE
		...
				
	}
				
	// Turn on battery-off mode if needed
	if(batteryMode == BATTERY_MODE_OFF) {
		nfc_set_setting(NFC_SETTING_CE_POWERED_OFF, true);
		// Wait for NFC_CE_DISABLE_POWERED_OFF_EVENT.
		...
				
		// Handle error case in which the user cancels 
		// the request to enable battery off mode
		...
				
	}
				
	// Set the technology type
	nfc_se_reader_set_technology_types(session, desiredTechType);
}