Properties are used to provide information about the device and how to configure it. Secured properties are set at the factory or by an administrator using software tools supplied by MagTek. Property values take effect immediately unless specified otherwise.
Property Type:
String
Length:
Varies
Get Property:
This read-only property returns the main firmware part number, a dash, the major and minor revision number, followed by a dash and the firmware type. {main firmware part number}-{3 character rev}-{type}
This one-byte value (1-255) sets the device’s polling interval in milliseconds for the Interrupt in Endpoint. The device sends the value of this property as part of USB device enumeration to the host.
This value is also found on the product label. The property contains the 7-character MagTek device serial number. This value is used for USB device enumeration, data messages, and message security.
This is a maximum 7-byte read-only property that identifies the MagneSafe Feature Level supported on this device.
This property is defined as follows:
id = 0: Decodes standard ISO/ABA cards only
id = 1: Decodes AAMVA and 7-bit cards also
If the id flag is set to 0, only tracks that conform to the ISO card data format allowed for that track are decoded. If the track cannot be decoded by the ISO method, the device reports a decode error.
For each pair of track bits, valid values are as follows:
T# = 00: Track Disabled
T# = 01: Track Enabled
T# = 10: Track Enabled and Required (Generates error if track is blank)
This property specifies how the device should mask data on ISO/ABA type cards: Each byte in the sequence has the following meaning:
This property specifies the factors for masking data on AAMVA type cards. Each byte in the property has the following meaning:
This property represents the device’s current connection type.
Valid values for this property are:
0x00 = USB HID (HID Only)
0x01 = USB Keyboard Emulation (KB) (USB KB Only)
0x02 = iAP2
0xFF = One-Time Automatic (HID Only | iAP2 Only). When the property is set to this value and the device connects to a host, the device attempts to determine which interface type the host is using. After it successfully detects the interface type, it automatically sets this property to the value that corresponds to that interface type.
Configures Magneprint options.
The device sends the value of this property to the host before all other card data. For example, if the host software requires a set of keystrokes to begin the process of receiving card data, this property could be set to transmit that keystroke sequence.
The device sends the value of this property to the host at the end of the data message. For example, if the host software requires a set of keystrokes to end the process of receiving card data, this property could be set to transmit that keystroke sequence. If the value is 0, the device does not send a termination string.
Set Property:
Yes
Default Value:
0x01
Set Property:
No
Default Value:
N/A
Set Property:
No
Standard Value:
PCIV01
Set Property:
Yes
Default Value:
0x95
id
0
T3
T3
T2
T2
T1
T1
Set Property:
Yes
Default Value:
04040Y
1
This byte specifies whether the device applies Mod 10 Correction to the PAN. “Y” means Yes, “N” means No. This option is only effective if the Masking Character specified by this command is “0”.
1
This byte specifies whether the device applies Mod 10 Correction to the PAN. “Y” means Yes, “N” means No. This option is only effective if the Masking Character specified by this command is “0”.
Set Property:
Yes
Default Value:
04040Y
1
This byte specifies whether the device applies Mod 10 Correction to the DL/ID#. “Y” means Yes, “N” means No. This option is only effective if the masking character specified in this command is “0”.
1
This byte specifies whether the device applies Mod 10 Correction to the DL/ID#. “Y” means Yes, “N” means No. This option is only effective if the masking character specified in this command is “0”.
Set Property:
Yes (No for devices that switch connections automatically)
Default Value:
Dependent on device type:
Set Property:
Yes (Secure MAC)
Default Value:
0x00
0
0
0
0=Use SRED encrypt key
1=Use MP encrypt key
0=Normal Length MP
1=Extended Length MP
0
Set Property:
Yes
Default Value:
Null String
Set Property:
Yes
Default Value:
0x0D (carriage return)
Yes
Set Property:
No
Default Value:
Part number of installed firmware
Example
1000004854-AD9-PCI
Property ID:
0x02
Property Type:
Byte
Length:
1 byte
Get Property:
Yes
Property ID:
0x03
Property Type:
String
Length:
7
Get Property:
Yes
Property ID:
0x04
Property Type:
String
Length:
0 - 7 bytes
Get Property:
Yes
Property ID:
0x05
Property Type:
Byte
Length:
1 byte
Get Property:
Yes
Bit Position
7
6
5
4
3
2
1
0
Property ID:
0x07
Property Type:
String
Length:
6 bytes
Get Property:
Yes
Length
Description
2
These bytes are an ASCII representation of a decimal value that specifies how many of the leading characters of the PAN the device sends unmasked. The range is from “00” to “99”.
2
These bytes are an ASCII representation of a decimal value that specifies how many of the trailing characters of the PAN the device sends unmasked. The range is from “00” to “99”.
1
Masking Character. This byte specifies which character the device uses for masking. If this byte contains the uppercase letter ‘V’, the following rules apply:
The device masks the PAN using character ‘0’
The device leaves all data after the PAN unmasked, leaving Discretionary Data (“DD”) and other non-PAN data available for the host to read.
0x00 (NULL character) is not allowed.
Length
Description
2
These bytes are an ASCII representation of a decimal value that specifies how many of the leading characters of the PAN the device sends unmasked.
The leading character range is from “00” to “08” when the PAN length is greater than 15.
The leading character range is from “00” to “06” when the PAN length is 15 or less.
2
These bytes are an ASCII representation of a decimal value that specifies how many of the trailing characters of the PAN the device sends unmasked. The range is from “00” to “04”.
1
Masking Character. This byte specifies which character the device uses for masking.
The uppercase letter ‘V’ is not supported.
0x00 (NULL character) is not allowed.
Property ID:
0x08
Property Type:
String
Length:
6 bytes
Get Property:
Yes
Length
Description
2
These bytes are an ASCII representation of a decimal value that specifies how many of the leading characters of the Driver’s License/ID Number (DL/ID#) the device sends unmasked. The range is from “00” to “99”.
2
These bytes are an ASCII representation of a decimal value that specifies how many of the trailing characters of the DL/ID# sends unmasked. The range is from “00” to “99”.
1
Masking Character. This byte specifies which character the device uses for masking. If this byte contains the uppercase letter ‘V’, the following rules apply:
The device masks the PAN according to the rules of this property (Property 0x34 - Send AAMVA Card Data is ignored).
The device uses ‘0’ for masking the PAN.
The device sends all data after the PAN without masking.
0x00 (NULL character) is not allowed.
Length
Description
2
These bytes are an ASCII representation of a decimal value that specifies how many of the leading characters of the Driver’s License/ID Number (DL/ID#) the device sends unmasked. The range is from “00” to “99”.
2
These bytes are an ASCII representation of a decimal value that specifies how many of the trailing characters of the DL/ID# sends unmasked. The range is from “00” to “99”.
1
Masking Character. This byte specifies which character the device uses for masking.
The uppercase letter ‘V’ is not supported.
0x00 (NULL character) is not allowed.
Property ID:
0x10
Property Type:
Byte
Length:
1 byte
Get Property:
Yes
Property ID:
0x15
Property Type:
Byte
Length:
1 byte
Get Property:
Yes
7
6
5
4
3
Bit 2
Bit 1
Bit 0
0
Property ID:
0x1E
Property Type:
String
Length:
0-7 bytes
Get Property:
Yes
Property ID:
0x22
Property Type:
String
Length:
0-7 bytes
Get Property:
Yes
0