This command lets the host retrieve a property (see section on properties) from the device using the 1-byte Property ID.
Table - Get Property Command
Command
Parameter Data Len
Parameter Data
0x0000
0x0001
Property ID (1-byte)
Table - Get Property Response
Legacy (if needed) for simple & short properties.
This command sets a property in the device. For secure properties, this command should be the payload for the Send Secured Command.
This command is used to reset the device.
The host uses this command to get the date / time from the device’s internal clock. The value returned is set to Coordinated Universal Time (UTC). The host is responsible for converting the response to local time.
This command returns the information about the specified key to the host.
This command is used to activate or deactivate the button. The command is rejected if the device is not in Qwantum mode. The button always defaults to disabled after reset or when switching modes.
1
Hour
Value from 0x00...0x17 (0-23)
1
Minute
Value from 0x00...0x3B (0-59)
1
Second
Value from 0x00...0x3B (0-59)
1
Unused
0x00
1
Year
Value from 0x00 (2008) ...0xFF (2263)
2
TK ID
(2 byte)
The Key ID used to transport this key (a parent key ID)
9
Key Algorithm
(1 byte)
1 = DES 4 = AES128
2 = 2TDES 5 = AES192
3 = 3TDES 6 = AES256
10
KCV
(5 or 3 bytes)
5 bytes for AES-CMAC or 3 bytes for TDES-CBCMAC including the KCV algorithm info as defined in X9.143 ‘KP’/’KC’ format (A.5.8 of X9.143 spec)
15 or 13
Length of KSI
(1 bytes)
Length of Key Set Identifier
16 or 14
Key Set Identifier
(n bytes)
Encoded in Hex-ASCII refer to Table 11 in X9.143 specification.
(16 + n) or
(14 + n)
Key Restriction
(2 bytes)
16-bit Key Restriction Bitmask (for TK and DKPT keys)
(16 + n + 3) or
(14 + n + 3)
Key Configuration
(2 bytes)
16-bit Key Configuration Bitmask
Currently supports Data Type Configuration only.
(16 + n + 4) or
(14 + n + 4)
Timestamp
(24 bytes)
Time and date in UTC time format that indicates when the key block was formed.
Return Code
Response Data Len
Response Data
0x0000
varies
Property Value
Command
Parameter Data Len
Parameter Data
0x00
0x01
Property ID (1-byte)
Return Code
Response Data Len
Response Data
0x00
varies
0 to 58 bytes
Command
Parameter Data Len
Parameter Data
0x0001
varies
Property ID (1 byte)
Property Value (varies)
Return Code
Response Data Len
Response Data
0x0001
0x0001
0=Property in effect
1=Needs reset
Command
Parameter Data Len
Parameter Data
0x0002
0x0000
None
Command
Parameter Data Len
Parameter Data
0x030D
0x0000
None
Return Code
Response Data Len
Response Data
0x0000
0x0007
See Table
Length
Field Name
Value
1
Month
Value from 0x01...0x0C (1-12)
1
Day
Command
Parameter Data Len
Parameter Data
0703
0x0002
Key ID
Offset
Field Name
Description
0
Key Slot Status
(1 byte)
0 = Empty
1 = Loaded (Purpose not assigned)
2 = Loaded & active
3 = Exhausted (End of DUKPT key sequence)
4 = Expired (RFU, cert status?)
0xFF = Not supported in this device
1
Slot Type
(1 byte)
Offset
Field Name
Description
4
Key Environment
(1 byte)
‘T’ for test or ‘P’ for production
5
X9.143 Attributes
(4 bytes)
Command
Parameter Data Len
Parameter Data
0x07E0
0x0001
0x00 – Disable button
The push-button functionality is disabled.
0x01 – Enable button
The push-button functionality is enabled, allowing the operator to output buffer data by pressing the button. The functionality remains active until a command is issued to disable it or the device is power cycled.
0x02 – Enable button for single press
The push-button functionality is enabled, allowing the operator to output buffer data by pressing the button once. The functionality will be disabled automatically afterward or upon power cycling.
0x03 – Enable Button Persistently
The push-button functionality is enabled, allowing the operator to output buffer data by pressing the button. The push-button activation persists even after a power cycle. The functionality remains active until a command is issued to disable it.
Table - Legacy Get Property
Table - Legacy Response Structure
Command 0x0001 - Set Property (MAC Protected for Some Properties)
Table - Set Property Command
Table - Set Property Response
Command 0x0002 - Reset Device
Table - Reset Device Command
Command 0x030D - Read Date and Time
Table - Read RTC Command
Table - Read RTC Response
Table - Read RTC Response Data
Command 0x0703 – Get Key Information
Table - Get Key Info Command
Table - Response Data for Get Key Information Command
The following fields are required if Key Slot is not empty.
Command 0x07E0 – Set Button Mode (MAC Protected)
Table - Set Button Mode
Value from 0x01...0x1F (1-31, depends on the month)
First byte of Slot ID (Slot ID = Key ID)
‘Key Usage || Algorithm || Mode of Use’ from X9.143 Key Block Header.