Software_id property, Usb_serial_num property – MagTek USB MagnePrint Swipe Reader with Encryption User Manual
Page 35

Section 4. USB Communications
27
The Property Value is a multiple-byte field that contains the value of the property. The number
of bytes in this field depends on the type of property and the length of the property. The
following table lists all of the property types and describes them.
Property Type Description
Byte
This is a one-byte value. The valid values depend 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 value and
length of the string does not include a terminating NUL character.
SOFTWARE_ID PROPERTY
Property ID:
0
Property Type:
String
Length:
Fixed at 11 bytes
Get Property:
Yes
Set Property:
No
Description:
This is an 11 byte read only property that identifies the software part number
and version for the device. The first 8 bytes represent the part number and the
last 3 bytes represent the version. For example this string might be
“21042812D01”. Examples follow:
Example Get SOFTWARE_ID property Request (Hex):
Cmd Num
Data Len
Prp ID
00 01
00
Example Get SOFTWARE_ID property Response (Hex):
Result Code Data Len
Prp Value
00
01
32 31 30 34 32 38 31 32 44 30 31
USB_SERIAL_NUM PROPERTY
Property ID:
1
Property Type:
String
Length:
0 – 15 bytes
Get Property:
Yes
Set Property:
Yes
Default Value:
The default value is no string with a length of zero.
Description:
The value is an ASCII string that represents the USB serial number. This
string can be 0 – 15 bytes long. The value of this property, if any, will be sent
to the host when the host requests the USB string descriptor.
This property is stored in non-volatile memory, so it will persist when the unit
is power cycled. When this property is changed, the unit must be reset (see
Command Number 2) or power cycled to have these changes take effect. This
device must be unplugged for at least 30 seconds to properly power cycle it.
Example Set USB_SERIAL_NUM property Request (Hex):
Cmd Num
Data Len
Prp ID
Prp Value
01
04
01
31 32 33