This section documents the full set of messages that can be exchanged between the device and the host.
Command 0x00:0x10 - Get Product ID
The host uses this command to get the device’s product ID.
Table 4-1 - Message Structure for Command 0x00:0x10 - Get Product ID
Tag
Len
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x12 - Get Capability String
The host uses this command to get the device’s Capability String.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x13 - Get Manufacturer
The host uses this command to get the device manufacturer.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x14 - Get Product Name
The host uses this command to get the device’s product name.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x15 - Get Secure Tracking Number
The host uses this command to get the device’s secure tracking number.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x16 - Get Firmware Version
The host uses this command to get the device’s firmware version.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x18 - Get Network Information (Ethernet Only)
The host uses this command to get information about the device’s network connection.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x23 - Get Boot Loader Version
The host uses this command to get the device’s boot loader version.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x27 - Get CT-L2 Version
The host uses this command to get the device’s EMV L2 version, if any.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
Command 0x00::0x28 - Get Serial Number
The host uses this command to get the device’s serial number.
If an error occurs, the device will terminate the command and report the error using an ACK Response containing the result code. For a full list of error codes, see 2.4.4 Result Code Data Object (Tag C3). If no error occurs, the device responds as follows:
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
10
Command ID Data Object (Tag C2) = 0x10 Get Product ID
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Product ID, e.g., 5999
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
12
Command ID Data Object (Tag C2) = 0x12 Get Capability String
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
12
Command ID Data Object (Tag C2) = 0x12 Get Capability String
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) =
Null-terminated string similar to
“V=1,SC=1,SR=1,TR=1,MS2=1,PFK=1,UDE=2,CE=2,CLE=1,DR=1” where each of
the comma-separated name-value pairs represents a device capability:
V = Device Version
SC = Signature Capture Support, 1=Supported, 0=Not Supported SR = SRED, 1=SRED, 0=NON-SRED
TR = Token Reversal Support, 1=Supported, 0=Not Supported MS2 = MagneSafe 2.0 Support, 1=Supported, 0=Not Supported PFK = PIN Fixed Key Support, 1=Supported, 0=Not Supported
UDE = User Data Entry Mode, 1=Encrypted Only, 2=Clear Text and Encrypted CE = Contact EMV Level Support, 1=L1, 2=L2
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
13
Command ID Data Object (Tag C2) = 0x13 Get Manufacturer
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
13
Command ID Data Object (Tag C2) = 0x13 Get Manufacturer
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Manufacturer, e.g., MagTek, Inc.
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
14
Command ID Data Object (Tag C2) = 0x14 Get Product Name
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
14
Command ID Data Object (Tag C2) = 0x14 Get Product Name
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Product Name, e.g., oDynamo
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
15
Command ID Data Object (Tag C2) = 0x15 Get Secure Tracking Number
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
15
Command ID Data Object (Tag C2) = 0x15 Get Secure Tracking Number
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
26
Data Field Data Object (Tag C4 or E0) = Bytes 0..25 Secure Tracking Number
ASCII string. Example “B55984678901234567890123456”
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
16
Command ID Data Object (Tag C2) = 0x16 Get Firmware Version
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
16
Command ID Data Object (Tag C2) = 0x16 Get Firmware Version
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Firmware Version, e.g., 1000004854-B1-PCI
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
18
Command ID Data Object (Tag C2) = 0x18 Get Network Information
C4
01
Data Field Data Object (Tag C4 or E0) = Type of Information
0x00 = Request Ethernet MAC Address 0x01 = Request Ethernet IP Address
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
18
Command ID Data Object (Tag C2) = 0x18 Get Network Informations
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Byte 0 Type of Information
0x00 = Ethernet MAC Address 0x01 = Ethernet IP Address
Bytes 1..n.Network Information String
MAC Address in ASCII format, e.g., 112233445566 or IP Address e.g., 111.222.333.444
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
23
Command ID Data Object (Tag C2) = 0x23 Get Boot Loader Version
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
23
Command ID Data Object (Tag C2) = 0x23 Get Boot Loader Version
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) = Boot loader version, e.g., 1000004194-A0-PCI
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
27
Command ID Data Object (Tag C2) = 0x27 Get CT-L2 Version
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
27
Command ID Data Object (Tag C2) = 0x27 Get CT-L2 Version
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
Calculated
Data Field Data Object (Tag C4 or E0) =
ASCII string containing version info. For example “JIBE EMV L2 4.3j Version C”
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
28
Command ID Data Object (Tag C2) = 0x28 Get Serial Number
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
28
Command ID Data Object (Tag C2) = 0x28 Get Serial Number
C3
01
00
Result Code Data Object (Tag C3) = 0x00 OK / Done
C4
10
Data Field Data Object (Tag C4 or E0) =
Serial Number is 16 bytes long in ASCII., e.g., “1111000050123456”
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
C1
01
00
Application ID Data Object (Tag C1) = 0x00 Device Information
C2
01
10
Command ID Data Object (Tag C2) = 0x10 Get Product ID
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
Tag
Len
Value(s) / Description
C0
01
01
Message Type Data Object (Tag C0) = 0x01 Command
Tag
Len
Value(s) / Description
C0
01
02
Message Type Data Object (Tag C0) = 0x02 Response
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
C1
CLE = Contactless EMV Level Support, 0=Not Supported,1=L1, 2=L2 DR = Delayed Response Support, 1=Supported, 0=Not Supported SIGN = Device Signing Certificate support, 1=Supported