Magtek eDynamo, Programmer'S Manual

Page: 107 / 245

8 - Commands
eDynamo| Secure Card Reader Authenticator | Programmer’s Manual (COMMANDS)
Page 107 of 245 ( D998200115-17 )
8.5 Command Group 0x03 (Cont.) - EMV L2 Configuration (EMV Only,
Extended Commands Only)
These commands are used to set and get configuration information for the device’s EMV operations.
Many commands require a MAC field. The host must compute the MAC over all of the command data
using the UIK installed in the device and following
ISO 9797 , MAC Algorithm 3, Padding Method 1. In
cases where only MagTek knows the UIK, MagTek must be involved to populate the MAC field.
If the device is set to
Security Level 2 , the device ignores the MAC field and the Device Serial Number
field and the host can set them to all zeroes.
This value is always 16 bytes long. The 16th byte always contains 0x00. If the serial number is less than
15 bytes, it is left-justified and padded with binary zeroes.
8.5.1 Extended Command 0x0305 - Modify Terminal Configuration (MAC)
Like all extended commands, the host initiates this command by calling Command 0x49 - Send
Extended Command Packet (Extended Commands Only) , and receives a response as documented
there.
The host uses this command is used to directly modify tags in the device’s EMV Terminal configuration.
See
Extended Command 0x0306 - Read Terminal Configuration and the Terminal Configuration
subsections in Appendix E EMV Factory Defaults (EMV Only) .
Some of the device’s EMV Terminal configuration tags can only be set to EMV certified combinations.
To change those settings, the host should use
Extended Command 0x0310 - Modify EMV
Configuration (MAC) .
Configuration changes will be lost after a power cycle or reset unless the host sends
Extended
Command 0x030E - Commit Configuration after making all configuration changes.
Table 8-41 - Request Data for Extended Command 0x0305 - Modify Terminal Configuration (MAC)
Offset Field Name Value
0 Type of MAC
MAC algorithm designator
0x00 = ISO 9797 MAC Algorithm 3, Padding Method 1.
1 Slot Number EMV Terminal Slot Number. Must be 0x01.
2 Operation
0x01 = Write Operation
0xFF = Set to Factory Defaults (sets all items, Terminal, Applications, and
Application Public Keys to factory default values)
3
Database
Selector (Contact Only)
0x00 = EMV Contact L2
4..19
Device Serial
Number
(DSN)
16 Bytes DSN
20..n
Objects To
Write
Note: Not needed if Operation is 0xFF Set to Factory Defaults.
FA<len> /* container for generic data */
<tag><len><value>
…
<tag><len><value>