Common JCApp PIN functions

Functions
UFR_STATUS DL_API	JCAppLoginM (UFR_HANDLE hndUFR, uint8_t SO, IN uint8_t *pin, uint8_t pinSize)
UFR_STATUS DL_API	JCAppGetPinTriesRemainingM (UFR_HANDLE hndUFR, dl_sec_code_t secureCodeType, VAR uint16_t *triesRemaining)
UFR_STATUS DL_API	JCAppPinChangeM (UFR_HANDLE hndUFR, dl_sec_code_t secureCodeType, IN uint8_t *newPin, uint8_t newPinSize)
UFR_STATUS DL_API	JCAppPinUnblockM (UFR_HANDLE hndUFR, uint8_t SO, IN uint8_t *puk, uint8_t pukSize)

Detailed Description

Function Documentation

JCAppLoginM()

UFR_STATUS DL_API JCAppLoginM	(	UFR_HANDLE	hndUFR,
		uint8_t	SO,
		IN uint8_t *	pin,
		uint8_t	pinSize )

Multi reader support. This function is used to login to the JCApp with an appropriate PIN code. Every time you deselect the JCApp tag either by calling s_block_deselect(), ReaderReset(), ReaderClose() or because of the loss of the NFC field, in order to communicate with the same tag you have to select JCApp and login again, using this function. Every successful login resets the incorrectly entered PIN code counter for the PIN code specified by the SO parameter.

Parameters

hndUFR	handle of the uFR device
SO	If this parameter has value 0 function will try to login as a User. If this parameter has a value different then 0, the function will try to login as a Security Officer (SO).
pin	Pointer to the array of bytes which contains PIN code.
pinSize	Effective size of the array of bytes which contains PIN code.

Returns

Operation status

JCAppGetPinTriesRemainingM()

UFR_STATUS DL_API JCAppGetPinTriesRemainingM	(	UFR_HANDLE	hndUFR,
		dl_sec_code_t	secureCodeType,
		VAR uint16_t *	triesRemaining )

Multi reader support. This function is used to get how many of the unsuccessful login attempts remain before specified PIN or PUK code will be blocked. This function have parameter of the type dl_sec_code_t which is defined as: typedef enum { USER_PIN = 0, SO_PIN, USER_PUK, SO_PUK } dl_sec_code_t; This function does not require to be logged in with any of the PIN codes.

Parameters

hndUFR	handle of the uFR device
secureCodeType	Specifies the PIN code type (see the dl_sec_code_t type definition above, in the text)
triesRemaining	Pointer to the 16-bit unsigned integer which will contain the number of the unsuccessful login attempts remains before specified PIN code will be blocked, in case of successful function execution. If this value is 0 then the specified PIN code is blocked.

Returns

Operation status

JCAppPinChangeM()

UFR_STATUS DL_API JCAppPinChangeM	(	UFR_HANDLE	hndUFR,
		dl_sec_code_t	secureCodeType,
		IN uint8_t *	newPin,
		uint8_t	newPinSize )

Multi reader support. This function is used to change the PIN or PUK code which type is specified with secureCodeType parameter of type dl_sec_code_t which is defined as: typedef enum { USER_PIN = 0, SO_PIN, USER_PUK, SO_PUK } dl_sec_code_t; Prior to calling this function you have to be logged in with an SO PIN code.

Parameters

hndUFR	handle of the uFR device
secureCodeType	Specifies the PIN or PUK code type you wish to change (see the dl_sec_code_t type definition above, in the text)
newPin	Pointer to the array of bytes which contains a new code
newPinSize	Effective size of the array of bytes which contains a new code.

Returns

Operation status

JCAppPinUnblockM()

UFR_STATUS DL_API JCAppPinUnblockM	(	UFR_HANDLE	hndUFR,
		uint8_t	SO,
		IN uint8_t *	puk,
		uint8_t	pukSize )

Multi reader support. This function is used to unblock PIN code which is specified by the SO parameter. This function does not require to be logged in with any of the PIN codes.

Parameters

hndUFR	handle of the uFR device
SO	If this parameter has value 0 function will try to unblock User PIN code. If this parameter has a value different then 0, the function will try to unblock SO PIN code.
puk	Pointer to the array of bytes which contains PUK code.
pukSize	Effective size of the array of bytes which contains PUK code.

Returns

Operation status