1 About Feedback from Panel

1.1 Introduction

Feature enables SAFR SCAN to receive access granted / access denied feedback from the control panel via “Wiegand” Red / Green LED lines or via the OSDP two-way protocol.

This is intended to simplify identity synchronization from external systems. User feedback is displayed based on panel disposition. The panel to determine if access is granted or denied based on the extensive rules defined in the access control software including access groups/levels, door groups, schedules, etc. This avoids the need to perform complicated mapping when configuring the PACS integrations.

1.2 How it works

After completing configured access sequence (Face Matching, validate one or more factors (face, keypad, card), anti-spoofing checks) the access card id and facility id will be transmitted via configured control panel connection (e.g. Wiegand and OSDP). After completion of transmission, SAFR SCAN monitors for input from the panel up to the specified timeout and then final access denied or granted concluded based on feedback received or timeout. Displayed text, LED color and audio feedback manifestation and dispatching of events will be deferred until then.

The following figures demonstrate how this feature works.

First, SAFR SCAN performs multiple factor authentication if authenticated.

Secondly, SCAN changes status to “Waiting” and transmits credentials to Panel.

Finally, the Panel evaluates access and returns status to SCAN which results in appropriate response to user.

2 Configuring SAFR for Panel Feedback

2.1 Wiegand Configuration

2.1.1 Hardware Setup

SAFR SCAN offers 2 options to wire feedback with Wiegand wiring from panel.

• Use one or two wires on SAFR SCAN’s Wiegand In PINs (PIN 1 and 2 on Terminal block 1)
• Use one wire on SAFR SCAN’s TTL In PIN (PIN 5 on Terminal block 2)

Use the first method unless you also need to use the Wiegand In PINs to connect and external card reader to SAFR SCAN.

2.1.1.1 Wiring using SAFR Wiegand In PINs

SAFR SCAN uses 2 separate PINs to receive feedback over Wiegand wires. One is labeled "Green LED" feedback and the other "Red LED" feedback as indicated in the diagram below. To facilitate the extra inputs, SAFR re-used the existing Wiegand input wires on PINs 1 and 2 on Terminal Block 1. More on this below and how to use an input reader with feedback from panel over Wiegand.

When using this method, select “Wiegand In”as the Feedback Port” as described in Software Setup below.

Panel Feedback for Wiegand requires at least 1 wire run from the panel and the panel must be configured to provide feedback to the reader via the single wire. Optionally, 2 wires may be used to provide feedback from the panel. Panels offer various ways to communicate back to Wiegand access control readers:

1. A buzzer (BZR) and a LED wire
2. A "red" LED and a "green" LED wire
3. A single LED wire

The notion of color here is just symbolic. Wiegand wires carry only voltage states (on and off). The panel cycles between on and off states in a repeating pattern to indicate different conditions.

The behavior of the feedback wires varies from panel to panel. There is often a signal pattern when the door is in a waiting state and then separate patterns sent on various actions such as access granted or denied. A pattern can consist of switching between on (+5v) and off (0v) voltage states. SAFR uses the switch in voltage state to detect a specific state such as access granted.

If you just have a single LED wire, run it to the green LED on SAFR SCAN. If you have a green and red wire, run it to the green and red LEDs. The green and red LED wires must be run from the appropriate PINs on the panel to SAFR’s Wiegand In PINs per the diagram below.

2.1.1.1.1 Full Size Readers (SC100/200)

2.1.1.1.2 Mullion Reader (SC50)

Consult your panel’s documentation for location of the feedback outputs. This may require you to configure your panel for which type of output the panel uses (one or two wire) and possibly configure the pattern applied on both wires for the access granted and access denied states. Some panels refer to these as "LED" (typically Green LED) and "BZR" (typically Red LED).

SAFR SCAN does not support external Wiegand readers if using Wiegand output to panel with panel feedback using the Wiegand In PINs. If an external reader is required, use the TTL In PIN as described below or an OSDP capable reader with SCAN’s OSDP input support.

2.1.1.2 Wiring using SAFR Wiegand In PINs

SAFR SCAN can alternatively use the TTL In PIN on Terminal block 2. This option is useful when an external Wiegand reader must be connected to SAFR SCAN. With this option, only 1 wire is available for feedback and Access Denied can only be determined by the timeout.

When using this method, select “Wiegand In”as the Feedback Port” as described in Software Setup below.

The diagram below demonstrates wiring for TTL In option.

2.1.1.2.1 Full Size Readers (SC100/SC200)

2.1.1.2.2 Mullion Reader (SC50)

SC50 does not have TTL In/Out wires so TTL is not an option on this reader.

2.1.2 Software Setup

2.1.2.1 Panel Configuration

As described above, SAFR uses the red and green LED feedback wires to receive feedback from the access control panel. Most panels will allow configuration to choose between BZR + LED or 2-wire LED feedback. Consult your panel’s documentation to configure the panel to use red and green LED feedback.

2.1.2.2 SAFR Configuration

Below describes configuration using SAFR Desktop for Windows. The process is similar for SAFR SCAN Web Console but location of configuration pages may vary slightly.

1. Open SAFR Desktop Video Feeds window
2. Use the “…” menu to the right of the SAFR SCAN device you wish to configure and select “Edit Operation Settings…”
3. Select the Wiegand configuration page on the left
4. Set “Wiegand connection to Control Panel” to “Enabled”.
   
5. Select “Wiegand feedback from Control Panel”. You will be presented with the settings below.
   

See below for explanation of these settings.

2.1.2.2.1 Wiegand Feedback Settings

Feedback via Wiegand red and green LED wires is based upon changes in the voltage in the wire. Panels send either 0v or 5v over LED wires. SAFR looks for the change in the voltage from the panel to interpret the feedback from the panel.

SAFR is primarily interested in the change in the signal immediately after the credentials are sent. SAFR will monitor the voltage and determine if it sees a decrease in voltage (i.e. a “Negative Edge”) or an increase in voltage (i.e. “Positive Edge”). These can be interpreted as follows:

• Negative Edge – Voltage when from high to low and is interpreted as panel setting voltage to 0v
• Positive Edge – Voltage when from low to high and is interpreted as panel setting voltage to 5v

Note: Its important that SAFR ground be connected to panel ground in order for this signal to be interpreted correctly.

SAFR looks for the first change in voltage matching the configuration after it send credentials to the panel. The panel should be configured to change the voltage in the desired direction as soon as possible after it receives the credential. And the panel should not send an undesired change in voltage level before its able to make an access granted/denied determination.

Below is one example of what you might see in the panel configuration for controlling feedback over Wiegand.

The "color" is means for OSDP but when working with Wiegand, what matters is the notion of on/off state, the duration of each state and the number of times the pattern is repeated.

Sequence of Events

To best know how to configure Wiegand Feedback, its helpful to think about the sequence of events that make up an access session.

1. Waiting state - Before SAFR SCAN evaluates a face and sends credentials to the panel, the panel may be sending Wiegand feedback to the reader in the "waiting state". This might be a pattern that results in the reader flashing red/green or showing some other variability. A solid pattern is desirable in this state as explained below
2. Credentials sent by SAFR - Immediately after SAFR sends credentials, the panel may be still sending its waiting state pattern. If this pattern is variable, then SAFR may incorrectly interpret the pattern as access granted to access denied depending on SAFR configuration, number of wires and timing. It may take a few hundred milliseconds for the panel to complete its evaluation so this

The behavior will vary by panel. Thus the settings required by SAFR will vary by panel. If the default settings do not work, then try to adjust the options for Access Granted and Access Denied triggers as well as Feedback Timeout. Please consult SAFR support team if you cannot find settings that work for your panel. These settings are described below.

Setting	Description
Feedback port	Setting determines which terminal PINs on SAFR SCAN are used for feedback. Useful if using external Wiegand reader and thus cannot use Wiegand PINs 1 and 2 for feedback. Use “Wiegand in” for either 1-wire or 2-wire feedback. In this mode you can have explicit signaling for both access granted and access denied with 2-wires or rely upon a timeout for access denied if using only 1 wire. Use “TTL In” if Wiegand in is required for external reader. This option only allows 1-wire feedback option for (for access granted). Access denied is indicated by timeout.
Access Granted Trigger	The setting for how to detect an Access Granted signal from the panel over the D0 (green) LED line. Options are: Negative Edge on green LED line – If set, Access Granted is assumed If the voltage drops after passing credentials. Positive Edge on green LED line - If set, Access Denied is assumed If the voltage drops after passing credentials.
Access Denied Trigger	Options: Disabled – If set to Disabled, red LED wire is not monitored for changes and will have no impact on feedback evaluation regardless of its state changes. Negative Edge on green LED line – If set, Access Denied is assumed If the voltage drops after passing credentials. Positive Edge on green LED line - If set, Access Denied is assumed If the voltage drops after passing credentials.
Feedback Timeout	The amount of time in milliseconds that SAFR SCAN will wait for the configured changes to occur before. If no change occurs in this time, an “Access Denied” response is generated.

2024-Mar-26 19:55:53.318838: INFO/accessCredential(547439228592): Construct cardDataOut for format CardNoFac, accessCardId=9905, accessFacilityId=31

2024-Mar-26 19:55:53.319173: INFO/accessCredential(547439228592): sendCardDataOut(): Sending out 26 bits of CardNoFac card data to OSDP-PD-out...OK

2024-Mar-26 19:55:53.370718: INFO/accessCredentialOSDP(547844242736): Received MSG_TYPE_OSDP_PD_LED message: reader=0, led_number=0

temporary: control_code=2(SET), on_count=2(200ms), off_count=1(100ms), on_color=1(RED), off_color=0(NONE), timer_count=6(600ms)

permanent: control_code=1(SET), on_count=1(100ms), off_count=0(0ms), on_color=0(NONE), off_color=0(NONE), timer_count=127(N/A)

2024-Mar-26 19:55:53.393092: INFO/accessCredentialOSDP(547844242736): Received MSG_TYPE_OSDP_PD_TEXT message: reader=0, control_code=4(TEMP_TEXT_WRAP), temp_time=3(3s), offset_row=1, offset_col=1, length=16, data="Invalid "

2.1.3 Reconfigure Wiegand Feedback from Panel

Wiegand settings may be changed by choosing “Edit feedback settings” button in the view below. All changes take effect immediately.

2.2 OSDP Configuration

2.2.1 Hardware Setup

Unlike for Wiegand, Panel Feedback for OSDP does not require any additional low voltage wires run from the panel. OSDP is a 2-way communication protocol and is capable of passing the feedback information through the same 2 wires as used for sending credentials.

Only the 2 OSDP wires and the ground is required to support OSDP Feedback from Panel. The diagram below demonstrates the connections required for OSDP and OSDP Feedback from Panel.

2.2.2 Full Size Readers (SC100/SC200)

2.2.3 Mullion Readers (SC50)

2.2.4 Software Setup

2.2.4.1 Panel Configuration

Many panels offer a number of different options for getting feedback over OSDP. These can be any of the following:

• LED Pattern (Colors)
• Strings (Text message intended to be displayed to cardholder)
• Output control codes (numbers intended to be interpreted by reader firmware)

Which option is available for your panel will vary by manufacturer. SAFR offers the flexibility to configure any of the above or combinations of. Consult your panel’s documentation for how to enable either and configure of above options. See below for details on SAFR configuration.

2.2.4.2 SAFR Configuration

Below describes configuration using SAFR Desktop for Windows. The process is similar for SAFR SCAN Web Console but location of configuration pages may vary slightly.

6. Open SAFR Desktop Video Feeds window
7. Use the “…” menu to the right of the SAFR SCAN device you wish to configure and select “Edit Operation Settings…”
8. Select the OSDP configuration page on the left
9. Set “OSDP connection to Control Panel” to “Enabled”
   
10. You will then see the option “OSDP feedback from Control Panel” appear as below.
11. Change “OSDP feedback from Control Panel” to “Enabled”. You will see settings dialog as follows:
    

See below for explanation of these settings.

2.2.4.2.1 OSDP Feedback Settings

OSDP Feedback settings are highly dependent upon your access control panel OSDP configuration. Please consult your access control panel documentation for information on what options are available and how to configure those options to align to SAFR’s OSDP Feedback settings.

SAFR’s OSDP Feedback Settings are grouped as follows:

Feedback Condition	Feedback Options	Description
Access Granted	LED pattern (color) Text (display message) Output control (code)	Provides the set or choices for which OSDP response mechanism to use in evaluating Access Granted feedback. It is required to set at least one method.
Access Denied	On timeout only LED pattern (color) Text (display message) Output control (code)	Provides the set or choices for which OSDP response mechanism to use in evaluating Access Granted feedback.
Door Forced Open	Disabled LED pattern (color) Text (display message) Output control (code)	Identifies mechanism to detect a door forced open condition meaning the door contact switch detected door open without a valid cause. Valid causes for a door in a locked state would be RTE triggered or access granted.
Door Held Open	Same as Door Forced Open	Identifies mechanism to detect a door was held open for longer than the configured time after a valid open condition was triggered.
Door Unlocked	Same as Door Forced Open	Identifies mechanism that allows panel to inform SAFR SCAN that the door state is unlocked and display appropriate feedback to indicate such.
Door Locked	Same as Door Forced Open	Same as Door Unlocked but for Door Locked state.

• Each of the Feedback Options are described below. Their behavior is common to all Feedback Conditions.

Door state information is not detected by SAFR SCAN. SAFR SCAN relies upon the panel to inform if of door state. At a future date, SAFR SCAN may implement door state detection (Door contact and Release to Exit contacts). Even so, SAFR SCAN takes its input from the panel for what to display.

SAFR SCAN also offers OSDP Feedback Settings for following:

• LED Activation – Defines if LED should be activiated.
• Text Display – Defines if text returned via OSDP will be displayed.
• Buzzer Activation – Defines if sound corresponding to the OSDP response will be played.

Feedback Options are described in following table.

Setting	Choices	Description
LED pattern (color)	Green, Red, Amber, Blue, Sentinel, Any or None	Uses color information returned by the panel via OSDP to determine if the Feedback condition exists. “None” results in LED in off state. “Any” results in any color signaled from the panel to indicate the condition. Whenever a LED pattern is selected, two colors must be specified: On Color – Color that will indicate condition is active. Off Color – Color that will indicate the condition is no longer active.
Text (display message)	Any text string	Enter the text that the panel will send to indicate this condition. Text comparison is case insensitive. UTF-8 character set is supported but results may vary with control panel. Any leading and trailing whitespace is removed (but not spaces between words).
Output control (code)		A numeric (integer) value. These will be panel specific and may or may not be configurable.
On timeout only		The amount of time in milliseconds that SAFR SCAN will wait for the corresponding condition is assumed. This is only supported for Access Denied. If specified, Access Feedback Timeout should be set in milliseconds from the time that the credentials were sent. If no change occurs in this time, an “Access Denied” response is generated.

2.2.5 Reconfigure OSDP Feedback from Panel

OSDP settings may be changed by choosing “Reset Control Panel connection” button in the view below. All changes take effect immediately.

OSDP feedback settings may be changed by choosing “Edit feedback settings” button in the view below. All changes take effect immediately.

Questions or comments about the documentation? Email us at [email protected] .

1