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

Page 27

Advertising
background image

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

Advertising