PD Capabilities

This section explodes the structure of OSDP capability response (REPLY_PDCAP).

Message Structure

The REPLY_PDCAP response is an list of 3 byte sets, with the following positional meaning.

Byte

Name

Meaning

Value

0

Function Code

Function/feature code

See Below

1

Compliance Level

Level of compliance with above function

See Below

2

Number of Units

Number of objects of this type

See Below

Function Code 1 - Contact Status Monitoring

This function indicates the ability to monitor the status of a switch using a two-wire electrical connection between the PD and the switch. The on/off position of the switch indicates the state of an external device.

The PD may simply resolve all circuit states to an open/closed status, or it may implement supervision of the monitoring circuit. A supervised circuit is able to indicate circuit fault status in addition to open/closed status.

Compliance Levels:

  • 01 - PD monitors and reports the state of the circuit without any supervision. The PD encodes the circuit status per its default interpretation of contact state to active/inactive status.

  • 02 - Like 01, plus: The PD accepts configuration of the encoding of the open/closed circuit status to the reported active/inactive status. (User may configure each circuit as “normally closed” or “normally open”.)

  • 03 - Like 02, plus: PD supports supervised monitoring. The operating mode for each circuit is determined by configuration settings.

  • 04 - Like 03, plus: the PD supports custom End-Of-Line settings within the Manufacturer’s guidelines.

The End-Of-Line circuit parameters are defined by the manufacturer of the PD.

Number of Units:

The number of Inputs.

Function Code 2 - Output Control

This function provides a switched output, typically in the form of a relay. The Output has two states: active or inactive. The Control Panel (CP) can directly set the Output’s state, or, if the PD supports timed operations, the CP can specify a time period for the activation of the Output.

Compliance Levels:

  • 01 - The PD is able to activate and deactivate the Output per direct command from the CP.

  • 02 - Like 01, plus: The PD is able to accept configuration of the Output driver to set the inactive state of the Output. The typical state of an inactive Output is the state of the Output when no power is applied to the PD and the Output device (relay) is not energized. The inverted drive setting causes the PD to energize the Output during the inactive state and de-energize the Output during the active state. This feature allows the support of “fail-safe/fail-secure” operating modes.

  • 03 - Like 01, plus: The PD is able to accept timed commands to the Output. A timed command specifies the state of the Output for the specified duration.

  • 04 - Like 02 and 03 - normal/inverted drive and timed operation.

Number of Units:

The number of Outputs.

Function Code 3 - Card Data Format

This capability indicates the form of the card data is presented to the Control Panel.

Compliance Levels:

  • 01 - the PD sends card data to the CP as array of bits, not exceeding 1024 bits.

  • 02 - the PD sends card data to the CP as array of BCD characters, not exceeding 256 characters.

  • 03 - the PD can send card data to the CP as array of bits, or as an array of BCD characters.

Number of Units:

N/A, set to 0.

Function Code 4 - Reader LED Control

This capability indicates the presence of and type of LEDs.

Compliance Levels:

  • 01 - the PD support on/off control only

  • 02 - the PD supports timed commands

  • 03 - like 02, plus bi-color LEDs

  • 04 - like 02, plus tri-color LEDs

Number of Units:

The number of LEDs per reader.

Function Code 5 - Reader Audible Output

This capability indicates the presence of and type of an Audible Annunciator (buzzer or similar tone generator)

Compliance Levels:

  • 01 - the PD support on/off control only

  • 02 - the PD supports timed commands

Number of Units:

The number of audible annunciators per reader

Function Code 6 - Reader Text Output

This capability indicates that the PD supports a text display emulating character-based display terminals.

Compliance Levels:

  • 00 - The PD has no text display support

  • 01 - The PD supports 1 row of 16 characters

  • 02 - the PD supports 2 rows of 16 characters

  • 03 - the PD supports 4 rows of 16 characters

  • 04 TBD.

Number of Units:

Number of textual displays per reader.

Function Code 7 - Time Keeping

This capability indicates that the type of date and time awareness or time keeping ability of the PD.

Compliance Levels:

  • 00 - The PD does not support time/date functionality

  • 01 - The PD understands time/date settings per Command osdp_TDSET

  • 02 - The PD is able to locally update the time and date

Number of Units:

N/A, set to 0.

Function Code 8 - Check Character Support

All PDs must be able to support the checksum mode. This capability indicates if the PD is capable of supporting CRC mode.

Compliance Levels:

  • 00 - The PD does not support CRC-16, only checksum mode.

  • 01 - The PD supports the 16-bit CRC-16 mode.

Number of Units:

N/A, set to 0.

Function Code 9 - Communication Security

This capability indicates the extent to which the PD supports communication security (Secure Channel Communication)

Compliance Levels:

This field is a bit map of the supported encryption algorithms

  • 0x01 - (Bit-0) AES128 support 0x02 - (Bit-1) to be defined

This field is encoded to represent the key exchange capabilities

  • 0x01 - (Bit-0) default AES128 key, as defined in APPENDIX D 0x02 - (Bit-1) to be defined

Number of Units:

N/A, set to 0.

Function Code 10 - Receive BufferSize

This capability indicates the maximum size single message the PD can receive.

Compliance Levels:

This field is the LSB of the buffer size

Number of Units:

This field is the MSB of the buffer size

Function Code 11 - Largest Combined Message Size

This capability indicates the maximum size multi-part message which the PD can handle.

Compliance Levels:

  • This field is the LSB of the combined buffer size

Number of Units:

This field is the MSB of the combined buffer size

Function Code 12 - Smart Card Support

This capability indicates whether the PD supports the transparent mode used for communicating directly with a smart card.

Compliance Levels:

  • 0 - PD does not support transparent reader mode

  • 1 - PD does support transparent reader mode

Number of Units:

unused, send 0x00

Function Code 13 - Readers

This capability indicates the number of credential reader devices present. Compliance levels are bit fields to be assigned as needed.

Compliance Levels:

  • 0x01 - (Bit-0) 0X02 - (Bit-1)

Number of Units:

Number of readers

Function Code 14 – Biometrics

This capability indicates the ability of the reader to handle biometric input

Compliance Levels:

  • 0 - No Biometric

  • 1 – Fingerprint, Template 1

  • 2 – Fingerprint, Template 2

  • 3 – Iris, Template 1

Number of Units:

Number of readers