Software id property, Serial num property – MagTek P-SERIES USB User Manual
Page 27

Section 4. USB Communications (HID)
19
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 “21042817C01”. 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 37 43 30 31
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 device’s serial number.
This string can be 0 – 15 bytes long. This property is stored in non-
volatile EEPROM memory so it will not change when the unit is power
cycled. The value of this property, if any, will be sent to the host when the
host requests the USB string descriptor. When this property is changed,
the unit must be power cycled to have these changes take effect for the
USB descriptor. If a value other than the default value is desired, it can be
set by the factory upon request. Examples follow.
Example Set Serial Num property Request (Hex):
Cmd Num
Data Len
Prp ID
Prp Value
01
04
01
31 32 33