Privileged Commands; Command Number - Magtek MagneSafe V5 Reference Manual

MagneSafe V5

Privileged Commands

Some commands are, for security purposes, privileged. These commands are:
1. Set Property
2. Reset Device*
3. Set Key Map Item
4. Save Custom Key Map
5. Set Security Level†
* The Reset Device command is usually not Privileged. The exception is during a sequence
to Activate the Authenticated Mode. During this sequence the Reset Device command is
Privileged to avoid a hacker using this sequence to exhaust DUKPT keys rendering the
reader unusable.
† The Set Security Level command is Privileged when it is being used to set the Security
Level. It is not Privileged when it is being used to Get the Security Level.
When the Security Level is set to higher than 2 (see the Security section), the previleged
commands must be MACed in order to be accepted. If a MAC is required but not present or
incorrect, RC = 07 will be returned.

Command Number

This one-byte field contains the value of the requested command number. The following table
lists all the existing commands.
Value Command Number
0x00 Get Property
0x01 Set Property
0x02 Reset Device
0x03 Get Keymap Item
0x04 Set Keymap Item
0x05 Save Custom Keymap
0x09 Get DUKPT KSN and Counter
0x0A Set Session ID
0x10 Activate Authenticated Mode
0x11 Activation Challenge Reply
0x12 Deactivate Authenticated Mode
0x14 Get Reader State
0x15 Set Security Level
Get Transaction count Command
0x16
(Flash Reader Only)
Read Oldest Transaction
0x17
Command (Flash Reader Only)
Erase Oldest Transaction
0x18
Command (Flash Reader Only)
0x1C Get Encryption Counter
22
Description
Gets a property from the reader
Sets a property in the reader
Resets the reader
Gets a key map item (KB only)
Sets a key map item (KB only)
Saves the custom key map (KB only)
Reports DUKPT KSN and Counter
Sets the current Session ID
Starts Activation of Authenticated Mode of
secure operation
Completes the Activation of Authenticated Mode
of secure operation
Deactivates the Authenticated Mode of secure
operation.
Gets the current state of the reader.
Sets or gets the current Security Level
Gets number of stored transactions
Retrieves oldest transaction in the buffer
Erases oldest transaction if already retrieved
Gets the number of transactions that can be
performed