Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Page cover
ChatGPT

Application Group 0x00 - Device Information Messages

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

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

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:

Table - Response to Command 0x00:0x10 - Get Product ID

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

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

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

Command 0x00::0x12 - Get Capability String

The host uses this command to get the device’s Capability String.

Table - Message Structure for Command 0x00::0x12 - Get Capability String

Tag

Len

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

12

Command ID Data Object (Tag C2) = 0x12 Get 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:

Table - Response to Command 0x00::0x12 - Get Capability String

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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

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

Command 0x00::0x13 - Get Manufacturer

The host uses this command to get the device manufacturer.

Table - Message Structure for Command 0x00::0x13 - Get Manufacturer

Tag

Len

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

13

Command ID Data Object (Tag C2) = 0x13 Get 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:

Table - Response to Command 0x00::0x13 - Get Manufacturer

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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.

Command 0x00::0x14 - Get Product Name

The host uses this command to get the device’s product name.

Table - Message Structure for Command 0x00::0x14 - Get Product Name

Tag

Len

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

14

Command ID Data Object (Tag C2) = 0x14 Get 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:

Table - Response to Command 0x00::0x14 - Get Product Name

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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

Command 0x00::0x15 - Get Secure Tracking Number

The host uses this command to get the device’s secure tracking number.

Table - Message Structure for Command 0x00::0x15 - Get Secure Tracking Number

Tag

Len

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

15

Command ID Data Object (Tag C2) = 0x15 Get 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:

Table - Response to Command 0x00::0x15 - Get Secure Tracking Number

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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”

Command 0x00::0x16 - Get Firmware Version

The host uses this command to get the device’s firmware version.

Table - Message Structure for Command 0x00::0x16 - Get Firmware Version

Tag

Len

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

16

Command ID Data Object (Tag C2) = 0x16 Get 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:

Table - Response to Command 0x00::0x16 - Get Firmware Version

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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

Command 0x00::0x18 - Get Network Information (Ethernet Only)

The host uses this command to get information about the device’s network connection.

Table - Message Structure for Command 0x00::0x18 - Get Network Information (Ethernet Only)

Tag

Len

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

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

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:

Table - Response to Command 0x00::0x18 - Get Network Information (Ethernet Only)

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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

Command 0x00::0x23 - Get Boot Loader Version

The host uses this command to get the device’s boot loader version.

Table - Message Structure for Command 0x00::0x23 - Get Boot Loader Version

Tag

Len

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

23

Command ID Data Object (Tag C2) = 0x23 Get 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:

Table - Response to Command 0x00::0x23 - Get Boot Loader Version

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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

Command 0x00::0x27 - Get CT-L2 Version

The host uses this command to get the device’s EMV L2 version, if any.

Table - Message Structure for Command 0x00::0x27 - Get CT-L2 Version

Tag

Len

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

27

Command ID Data Object (Tag C2) = 0x27 Get CT-L2 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:

Table - Response to Command 0x00::0x27 - Get CT-L2 Version

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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”

Command 0x00::0x28 - Get Serial Number

The host uses this command to get the device’s serial number.

Table - Message Structure for Command 0x00::0x28 - Get Serial Number

Tag

Len

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

28

Command ID Data Object (Tag C2) = 0x28 Get 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:

Table - Response to Command 0x00::0x28 - Get Serial Number

Tag

Len

Value(s) / Description

C0

01

02

Message Type Data Object (Tag C0) = 0x02 Response

C1

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”

Last updated