Page tree
Skip to end of metadata
Go to start of metadata

The information in this article only applies to KIOSK IV and requires firmware v1.20.089 or newer.

Card_Type is defined as: MifareUltraLight 0x04 and Classic Mifare 0x03

 Add TLV FFEE0E in ACT if Mifare Reading is needed. (FFEE0E  length  Error_Code Card_Type Card_Data)

where length is the length of [Error_Code Card_Type Card_Data].
Error_Code is defined as:
#define ERROR_NO_ERROR 0xE0
#define ERROR_TIMEOUT_ERROR 0xE1
#define ERROR_AUTHENTICATE_ERROR 0xE2
#define ERROR_READ_ERROR 0xE3
#define ERROR_WRIETE_ERROR 0xE4
Tags used:
FFEE0E iis a nested TLV, which includes DFED3A, DFED3B and DFED3C.
DFED3A defines Blocks to read. One block a byte. Eg, DFED3A 04 02 12 18 22 is to read block 02, 12, 18 and 22.
DFED3C defines Block and coresponding data to write: block data. Eg, DFED3C 11 06 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 means write data "01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10" into block 06.
DFED3B defines Key for Blocks: Start_block Mode key. Eg, DFED3B 08 0801FFFFFFFFFFFF means from block 08, key-A "FFFFFFFFFFFF" is used. Mode 01 is KEY-A, 02 is KEY-B.
Return Data: FFEE0E xx [Block_Number xx xx xx xx ... 0D 0A] [Block_Number xx xx xx xx ... 0D 0A]..............


Card_Data is the data read from the card designated by DFED3A.

For the ACT command, if key is not necessary or the key is KEY-A "FF FF FF FF FF FF". Tag DFED3B could be omitted.


Here is the examples (For S50 and UltraLight):
1. Complicate command with key, write operation and read operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 41 DFED3B 08 0101FFFFFFFFFFFF DFED3B 08 0401FFFFFFFFFFFF DFED3B 08 0801FFFFFFFFFFFF DFED3C 11 06 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 DFED3A 04 01 03 07 09
Response:
S50: 56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 03 01 31 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 0D 0A 03 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 07 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 09 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 A2 A4
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 04 01 32 E3 3E 80 6F 48 11 11 F1 11 3F 11 03 00 FE 00 0D 0A 03 F1 11 3F 11 03 00 FE 00 00 00 00 00 01 02 03 04 0D 0A 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 09 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 58 76

2. Command with key, write operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 39 DFED3B 08 0101FFFFFFFFFFFF DFED3B 08 0401FFFFFFFFFFFF DFED3B 08 0801FFFFFFFFFFFF DFED3C 11 06 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 03 9F 41 04 00 00 00 13 DF EE 26 01 41 BD 2A
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 04 9F 41 04 00 00 00 13 DF EE 26 01 41 77 22

3. Command with key, read operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 2C DFED3B 08 0101FFFFFFFFFFFF 
DFED3B 08 0401FFFFFFFFFFFF DFED3B 08 0801FFFFFFFFFFFF DFED3A 04 01 03 07 09
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 03 01 31 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 0D 0A 03 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 
07 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 09 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 A2 A4
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 04 01 32 E3 3E 80 6F 48 11 11 F1 11 3F 11 03 00 FE 00 0D 0A 03 F1 11 3F 11 03 00 FE 00 00 00 00 00 01 02 03 04 
0D 0A 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 09 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 58 76

4. Command without key, write operation and read operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 1D DFED3C 11 06 01 02 03 04 05 06 
07 08 09 0A 0B 0C 0D 0E 0F 10 DFED3A 04 01 03 07 09
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 03 01 31 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 0D 0A 03 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 
07 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 09 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 A2 A4
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 04 01 32 E3 3E 80 6F 48 11 11 F1 11 3F 11 03 00 FE 00 0D 0A 03 F1 11 3F 11 03 00 FE 00 00 00 00 00 01 02 03 04 
0D 0A 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 09 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 58 76

5. Command without key, write operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 15 DFED3C 11 06 01 02 03 04 05 06 
07 08 09 0A 0B 0C 0D 0E 0F 10
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 03 9F 41 04 00 00 00 13 DF EE 26 01 41 BD 2A
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 04 9F 41 04 00 00 00 13 DF EE 26 01 41 77 22

6. Command without key, read operation
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 08 DFED3A 04 01 03 07 09
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 03 01 31 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 0D 0A 03 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 
07 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF 0D 0A 09 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 99 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 A2 A4
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 61 00 00 00 FF EE 0E 4E E0 04 01 32 E3 3E 80 6F 48 11 11 F1 11 3F 11 03 00 FE 00 0D 0A 03 F1 11 3F 11 03 00 FE 00 00 00 00 00 01 02 03 04 
0D 0A 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 09 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D 0A 9F 41 04 00 00 00 13 DF EE 26 01 41 58 76

7. Command with zero length of FFEE0E
Command body: 0A 9C0100 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9F 2B 05 01 00 00 00 00 DF 01 01 01 FF EE 08 02 81 00 FFEE0E 00
Response:
S50:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 03 9F 41 04 00 00 00 13 DF EE 26 01 41 BD 2A
Ultralight:56 69 56 4F 74 65 63 68 32 00 02 00 00 15 00 00 00 FF EE 0E 02 E0 04 9F 41 04 00 00 00 13 DF EE 26 01 41 77 22