Common JCApp PIN functions

Functions
UFR_STATUS DL_API	JCAppGetPinTriesRemaining (dl_sec_code_t secureCodeType, VAR uint16_t *triesRemaining)
	This function is used to get how many of the unsuccessful login attempts remain before specified PIN or PUK code will be blocked.
UFR_STATUS DL_API	JCAppLogin (uint8_t SO, IN uint8_t *pin, uint8_t pinSize)
	This function is used to login to the JCApp with an appropriate PIN code.
UFR_STATUS DL_API	JCAppPinChange (dl_sec_code_t secureCodeType, IN uint8_t *newPin, uint8_t newPinSize)
	This function is used to change the PIN or PUK code which type is specified with secureCodeType parameter of type dl_sec_code_t.
UFR_STATUS DL_API	JCAppPinUnblock (uint8_t SO, IN uint8_t *puk, uint8_t pukSize)
	This function is used to unblock PIN code which is specified by the SO parameter.

Detailed Description

Function Documentation

JCAppGetPinTriesRemaining()

UFR_STATUS DL_API JCAppGetPinTriesRemaining	(	dl_sec_code_t	secureCodeType,
		VAR uint16_t *	triesRemaining )

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

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

JCAppLogin()

UFR_STATUS DL_API JCAppLogin	(	uint8_t	SO,
		IN uint8_t *	pin,
		uint8_t	pinSize )

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

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. JCAppGetPinTriesRemaining Function description 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;

Returns

Operation status

JCAppPinChange()

UFR_STATUS DL_API JCAppPinChange	(	dl_sec_code_t	secureCodeType,
		IN uint8_t *	newPin,
		uint8_t	newPinSize )

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

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

JCAppPinUnblock()

UFR_STATUS DL_API JCAppPinUnblock	(	uint8_t	SO,
		IN uint8_t *	puk,
		uint8_t	pukSize )

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

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