nfc_start_iso14443_4

Start Host Card Emulation (HCE) for the calling application.

Synopsis:

#include <nfc/nfc.h>

NFC_API nfc_result_t nfc_start_iso14443_4_emulation(const nfc_iso14443_4_card_t *card)

Since:

BlackBerry 10.0.0

Arguments:

card: The structure containing the information that will be emulated

Library:

libnfc (For the qcc command, use the -l nfc option to link against this library)

Description:

HCE emulates an ISO 14443-4 smart card. This function registers card emulation information within the NFC service. It also starts HCE when the application is in the foreground. Only one instance of HCE is allowed at one time, and emulation is only active while this application is in the foreground. If an application is placed in the background, the NFC service automatically stops the appplication's HCE.

If you want to start HCE in the background, you can use nfc_hce_register_aid() with a dedicated AID for the registration.

Once the application is placed in the foreground again, the NFC service resumes HCE. If an application attempts to call this function while it is already emulating an ISO 14443-4 card, the second call will fail with NFC_RESULT_LIMITATION_EXCEEDED.

During HCE, the following events can occur:

NFC_ISO14443_4_COMMAND_EVENT: This event indicates that a command was generated by the target reader. The application must first call nfc_get_target() to retrieve the event target, and then call nfc_get_iso14443_4_emulation_command() using the target retrieved to extract the command data from the triggered event.
NFC_ISO14443_4_EVENT_CODE_EVENT: This event indicates that an ISO 14443-4 related event has occurred. This event is associated with an event code from the target reader. Call nfc_get_notification_value() to extract the event code, which is of type iso14443_4_event_t.

Returns:

NFC_RESULT_SUCCESS, or one of the following: