VhlCfg / File / LegicSegmentListLegacy Value

This value is deprecated. Do not use it in new code as we may remove it in the future!

Please use LegicApplicationSegmentList instead of this value for new applications.

General information about Legic VHL definition:
A Legic VHL description consists of one or more so-called fragments. Each fragment represents a certain data area on a Legic card. It can be a whole segment or only a part of it.
A fragment is described by a segment information (this value), by its length LegicLengthList and by the starting address within the desired segment LegicAddressList. Optionally a CRC checksum may be verified for every fragment ( LegicCRCAddressList ) and a certain segment type may be specified ( LegicSegmentType ).

The configuration value LegicSegmentListLegacy is a list of one or more segment descriptions. Every entry corresponds to a certain fragment and specifies which Legic segment has to be accessed by VHL.

This value is mandatory for a Legic VHL fragment definition.

Every entry in the list consists of at least two bytes: The first byte specifies the method the segment is identified (SegmentIdentification). Depending on this value one or more bytes follow with required identification attributes.

Basically there are two ways to identify a segment:

Sample
"ProtocolHeaderAddressMode 1": address segment 1 in Protocol Header mode
"AdvantAddressMode 3": address segment 3 in Advant Address Mode
"ProtocolHeaderAddressMode|3 0x12 0x23 0x45": address segment with stamp "12 34 56" in Protocol Header mode
"AdvantAddressMode|3 0x12 0x23 0x45": address segment with stamp "12 34 56" in Advant Address mode

Properties

Format

Name Type/Size Description
- Array (until end of frame) -
SegmentIdAndAdr Bit mask (8 bits)

This byte defines how a Legic segment shall be accessed.

There are two possibilities to select a certain segment on a Legic card:

  • ID: The reader selects the segment with the desired number.
  • Stamp: The reader selects the first segment that matches the desired stamp.

If possible always stamp search should be used for segment identification to guarantee that only genuine cards are processed!

Legic advant compatible readers support two addressing modes:

  • Protocol Header: Stamp data (read-only) can be accessed starting with address 18 (data below address 18 is undefined). Application data follows directly after the stamp.
  • Advant: Application data stored in S_DATA can be accessed starting with address 0. Stamp data is not accessible in this case.

AdvantAddressMode Boolean (bit 0x80) Use Advant address mode. If this bit is not set Protocol Header address mode will be applied.
RFU Integer (bit mask area 0x7E) Zero padding
StampSearch Boolean (bit 0x01) Use Stamp search to identify the desired segment. If this bit is not set the segment will be identified by ID.
SegmentInformation ASCII string (length 1 Byte) Segment ID (length: 1) or Stamp (length: 1...12) depending on the value of SegmentIdentification