Magtek MagneSafe V5, Reference Manual

Page: 30 / 138

MagneSafe V5
22
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 Description
0x00 Get Property Gets a property from the reader
0x01 Set Property Sets a property in the reader
0x02 Reset Device Resets the reader
0x03 Get Keymap Item Gets a key map item (KB only)
0x04 Set Keymap Item Sets a key map item (KB only)
0x05 Save Custom Keymap Saves the custom key map (KB only)
0x09 Get DUKPT KSN and Counter Reports DUKPT KSN and Counter
0x0A Set Session ID Sets the current Session ID
0x10 Activate Authenticated Mode
Starts Activation of Authenticated Mode of
secure operation
0x11 Activation Challenge Reply
Completes the Activation of Authenticated Mode
of secure operation
0x12 Deactivate Authenticated Mode
Deactivates the Authenticated Mode of secure
operation.
0x14 Get Reader State Gets the current state of the reader.
0x15 Set Security Level Sets or gets the current Security Level
0x16
Get Transaction count Command
(Flash Reader Only)
Gets number of stored transactions
0x17
Read Oldest Transaction
Command (Flash Reader Only)
Retrieves oldest transaction in the buffer
0x18
Erase Oldest Transaction
Command (Flash Reader Only)
Erases oldest transaction if already retrieved
0x1C Get Encryption Counter
Gets the number of transactions that can be
performed