Magtek eDynamo, Programmer'S Manual

Page: 69 / 245

8 - Commands
eDynamo| Secure Card Reader Authenticator | Programmer’s Manual (COMMANDS)
Page 69 of 245 ( D998200115-17 )
8.3.2 Command 0x01 - Set Property (MAC)
This command sets a property in the device. For security purposes, this command is privileged. When
the Security Level is set to higher than 2 (see section
4 Security Levels ), this command must be MACed
to be accepted [see section 4.1 About Message Authentication Codes (MAC) ]. The command is
logically paired with Command 0x00 - Get Property . For details about properties, see section 9
Properties .
Some properties require the device to be reset using
Command 0x02 - Reset Device (MAC) or power
cycled to take effect. In those cases, the documentation for the property indicates what is required.
Table 8-7 - Request Data for Command 0x01 - Set Property (MAC)
Data Offset Value
0 Property ID
1..n Property Value
Response Data: None
The result codes for the
Set Property command can be any of the generic result codes listed in Table 8-3
on page 67 . If the Set Property command gets a result code of
0x07
, it means the required MAC was
absent or incorrect.
Property ID is a one-byte value that identifies the property. A full list of properties can be found in
section 9 Properties .
Property Value consists of multiple bytes containing the value of the property. The number of bytes in
this value depends on the property. Table 8-4 describes the available property types.
Table 8-8 - Response Data for Command 0x01 - Set Property (MAC)
Property Type Description
Byte This is a one-byte value. The range of valid values depends on the property.
String
This is a multiple-byte ASCII string. Its length can be zero to a maximum length
that depends on the property. The data length listed in the tables for each
property does not include the terminating NULL character.