Professional Documents
Culture Documents
Verex/SNAPP: Integration Manual
Verex/SNAPP: Integration Manual
Verex/SNAPP: Integration Manual
Integration Manual
VEREX/SNAPP – INTEGRATION MANUAL
Device Category
ACS IAS FPS CCTV DVR Perimetry Building External Other
Supported Functionality
Import From File Combined Credentials
Lift Encrypted Communication
Device Auto Import Time Synchronization
Time Zone Support Live Video Streaming
Recorded Video Streaming Video Records Downloading
Voice Transmitting Audio Streaming
PTZ Presets
Motion Detection Live Stream Snapshot
Recorded Stream Snapshot Multiple Stream Types
Fire Panel Networking Mode Card Learning
Dynamic Upload Access Time Restriction
Holidays Support Pin Management
Card Management Fingerprint Management
Reserved Memory Zones Antipassback Forgiveness
Handicapped Flag Alarm Suppression
Fire Alarm Counter Device Audit Log Retrieval
Remote Device Control Dynamic Command State
Wiegand Biometric Support
Legend:
– Fully supported functionality.
– Partially supported functionality, see results of integrations tests for more details.
Licensed Unit
ACCESS PANEL
DOOR MODULE
POINT EXPANSION MODULE
2 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Default Credentials
Key Value
MANAGER (001) 7793
Before programming the IP interface module, obtain the following information from the Network Administrator:
The static IP address for the IP interface module (only if static IP address is going to be used)
The subnet mask for the IP interface module (only if static IP address is going to be used)
The gateway IP address
3 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Write down the Main control board address as it will be needed when adding central unit into C4 Devices
tree.
4 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Create special Credential type as 'Positional card' by enabling just Card number segment with length of 20
bits.
Set Manual User Starting Position to value between Minimum Allowed User Number and Maximum
Allowed User Number.
Assign 'Positional card' with Card number between Manual User Starting Position and Maximum
Allowed User Number to person, which you want explicit define position.
This 'Positional card' code determines user ID for arming. PIN credential and/or Access Card credential
must be create separately.
Extended PIN is not supported credential at all.
At this version driver supports one PIN credential, one Access Card and one 'Positional Card' per
person.
Upload changes to device.
For disable explicit positions assignment set Manual User Starting Position to value of Maximum Allowed
User Number.
5 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Configuration
BUS CONTROLLER
PROPERTY RANGE DEFAULT
Network Monitoring Enabled YES/NO YES
Determines, whether the network monitoring is enabled.
Encryption Enabled YES/NO NO
Determines, whether the Saber encrypted communication is enabled.
IP Address
IP address of supported Verex/SNAPP IP Module.
Port 1 - 65535 24822
Defines a UDP (or TCP when encrypted communication is enabled) port for receiving data from Verex/SNAPP.
Receiving Port 1 - 65535
Defines port that receives data from <% txtApplicationName %> server. Property is used, when encrypted
communication is disabled.
Different Receiving Port YES/NO NO
Enables receiving information from another port, apart from the preset port. Property is used, when encrypted
communication is disabled.
CENTRAL UNIT
6 / 37
VEREX/SNAPP – INTEGRATION MANUAL
PARTITION
PROPERTY RANGE DEFAULT
Address 1 - 16
Partition address.
DETECTOR
PROPERTY RANGE DEFAULT
Address 1 - 256
Detector address.
7 / 37
VEREX/SNAPP – INTEGRATION MANUAL
INPUT
PROPERTY RANGE DEFAULT
Address 1 - 256
Input address.
OUTPUT
PROPERTY RANGE DEFAULT
Address 1 - 128
Output address.
DOOR MODULE
PROPERTY RANGE DEFAULT
Address 0 - 65535
Door module serial number.
DOOR
PROPERTY RANGE DEFAULT
Address 1 - 32
Door address.
CARD READER
PROPERTY RANGE DEFAULT
Reader Direction MOVEMENT DIRECTION NONE
Movement direction of the reader
KEYPAD MODULE
PROPERTY RANGE DEFAULT
Address 0 - 65535
Keypad module serial number.
8 / 37
VEREX/SNAPP – INTEGRATION MANUAL
SUITE DETECTOR
PROPERTY RANGE DEFAULT
Address 1-8
Suite detector address.
SUITE INPUT
PROPERTY RANGE DEFAULT
Address 1-8
Suite input address.
SUITE OUTPUT
PROPERTY RANGE DEFAULT
Address 1-2
Suite output address.
Extended Properties
9 / 37
VEREX/SNAPP – INTEGRATION MANUAL
10 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Defined Enumerations
FLAGS SELECTION
Used by Extended Properties > User Level.
Value Description
Limited User Accept Duress PIN, Status, On
Standard User Limited User, Silence Alarm, Work Late, Off, Stay, Door Commands
Advanced User Standard User, History, Test Function Key, Bypass Points, Auto Remove
Bypass, Suspend Schedule, Emergency Off, Isolate, Escort, Reset Door
Alarm, Off Not Stay, Auto All Off
Register Only Limited User, History
Detailed Configuration User can select detailed options
LANGUAGE
Used by Extended Properties > Language.
Value Description
English English language
Dutch Dutch language
French French language
Spanish Spanish language
MOVEMENT DIRECTION
Used by CARD READER > Reader Direction.
Used by CARD READER WITH KEYPAD > Reader Direction.
Value Description
In Movement direction is from inside to outside.
Out Movement direction is from outside to inside.
None Movement direction is undefined.
Test Notes
TEST NOTE
T08ARF: Door Lock and Test is considerable as passed if master card/PIN opens the door during Door
Unlock lockout phase.
11 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Integration Tests
Test Name Result
Supported Functionality > Device Auto Import
T7FKUJ Device Auto import Passed
Comment: Not supported by design.
Supported Functionality > Time Synchronization
T0FAFL Unified Time Management - Time Synchronization When Not supported
Changed on Device
Comment: Keypad does not have set time command.
T0FWIK Unified Time Management - Time Synchronization on Driver Supported, cannot verify
Startup
T0FYDS Unified Time Management - Periodical Synchronization Not supported
Comment: Keypad does not have set time command.
Supported Functionality > Card Learning
T09UVU Personal Management - Card Learning Supported, cannot verify
Supported Functionality > Access Time Restriction
T09LQY Personal Management - Access Time Restriction Supported, cannot verify
Supported Functionality > Holidays Support
T09XRR Personal Management - Holiday Support Supported, cannot verify
Supported Functionality > Pin Management
T09VMN Personal Management - Pin Management Supported, cannot verify
Supported Functionality > Card Management
T09IND Personal Management - Card Management Supported, cannot verify
Supported Functionality > Antipassback Forgiveness
T09UPY Personal Management - Antipassback Forgiveness Supported, cannot verify
Supported Functionality > Device Audit Log Retrieval
T2FESO Device Audit Log Retrieval Supported, cannot verify
Supported Functionality > Remote Device Control
T04XSI Output Inhibit and Uninhibit Remotely From C4 Not supported
Comment: Not supported by protocol.
T08ARF Door Lock and Unlock Supported, cannot verify
T08LON Door Remote Open Supported, cannot verify
Device Category > ACS
T08FDN Door Open Permanently Supported, cannot verify
T08ICK Door Forced Open Supported, cannot verify
T08JRH Door Open Too Long Supported, cannot verify
T08OCH Request to Exit Button Not supported
Comment: Not supported by communication protocol.
T09CRN Personal Management - Handling Access Granted Event Supported, cannot verify
T09EZJ Personal Management - Biometric - Fingerprint Not supported
Comment: Not supported by device.
T0BBCP Duress Alarm Supported, cannot verify
T0BHSL Tamper Supported, cannot verify
T0FCVB Contact Monitoring from Device Not supported
Comment: Device generate Alarm events for inputs only when Area is armed. Device does not
sent events for inputs when Area is in disarmed state.
T0FLFU Activating Test Mode on Detector from Device Not supported
Comment: Not supported by device.
T0FQCA Mains Failure Supported, cannot verify
12 / 37
VEREX/SNAPP – INTEGRATION MANUAL
13 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Appendix A
Integration Tests
14 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Set the detector to the armed mode (e.g. arming the corresponding area)
Issue an alarm on detector
Restore the alarm on detector
Confirm the alarm from C4 UI
Expected Results
The detector state is set to the Alarm.
The corresponding areas states are set to the Alarm.
After the alarm confirmation the Alarm state is finished.
Notes:
Preferred way to confirm an alarm is to handle it through the Alarm Handling Window in the monitor panel. When
the Alarm module is not available, then user shall use Reset command on the detector in alarm. On some devices
this is not possible and it is necessary to issue another sequence of commands to confirm the alarm (for instance
disarming the area on Alarm systems). If the sequence can be issued from the C4 UI and resembles the sequence
of operations done on the device keypad, this test is considered as passed.
In C4 alarm events are stored always for device that is “nearest” to the real alarm source. This is usually
detector. In case the device or its protocol doesn’t provide the information with that precision, for example
provides only information about the alarmed area, the test can be considered as passed with remark in test
notes
15 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Execute command “Inhibit” on detector.
Execute command “Uninhibit” on detector
Expected Results
1.State of the detector is Idle when not inhibited and Inhibit when detector is inhibited
Where
Notes:
For Fire alarm systems it is considered as acceptable when the zone/area is automatically inhibited
when all detectors in the zone/area are inhibited.
16 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Inhibit the detector using keypad or device panel.
Cancel the inhibit using keypad or device panel
Expected Results
1.State of the detector is Idle when not inhibited and Inhibit when detector is inhibited
Where
Notes:
For Fire alarm systems it is considered as acceptable when the zone/area is automatically inhibited
when all detectors in the zone/area are inhibited.
17 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Execute command “Lock” on door
Try to open the door using valid credential
Execute command “Unlock” on door
Expected Results
During door lockout door ignores any attempt to open it with valid credentials
Status of the door is Locked when locked
Where
Notes:
If the device supports dynamic command state and device is Locked you can see only command
"Unlock".
18 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Execute command “Open Permanently” on door
When door contact is present, simulate real door opening
Execute command “Close” on door
When door contact is present, simulate real door closing
Expected Results
After issuing the command "Open Permanently", the door status is set to Unblocked.
During real door opening, the door contact is activated and the door status is set to Open Indefinitely.
After issuing the command "Close", but door contact is still opened, door status remains Open Indefinitely.
After real door closing, the door contact is deactivated or the door relay timer expires, the door status returns to
Close (normal) state.
Notes:
When door contact is not present or real door opening/closing is not simulated, after issuing both commands, the
door status is set to Open Indefinitely and then returns to Close (normal) state.
Test is considerabled as passed when you need to reverse step 4 and 3
19 / 37
VEREX/SNAPP – INTEGRATION MANUAL
This test focuses on handling events and statuses during the unauthorized opening of the door in a protected
system.
Test Steps
Activate door contact
Expected Results
1.Door status is set to Forcibly open
Where
20 / 37
VEREX/SNAPP – INTEGRATION MANUAL
This test focuses on handling events and states during the held open alarm on the door.
Test Steps
Use the credential to access the access point
Activate door contact
Keep the contact activated longer than the predefined time
Expected Results
After successful credential authorization, the door status is set to Unblocked.
Door status is set to Open when the door contact is activated.
After predefined open time expiration, the door status is set to OpenTooLong.
Where
21 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Execute command “Open” on door
When door contact is present, simulate real door opening
When door contact is present, simulate real door closing
Expected Results
After issuing the command "Open", the door status is set to Unblocked.
During real door opening, the door contact is activated and the door status is set to Open.
After real door closing, the door contact is deactivated and the door status is set to Unblocked. If the
door relay timer also expires, the door status returns to Close (normal) state.
Where
22 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person
Assign the person a valid credential
Grant the person access to the access point
Send credentials to the device
Use the credential to access the access point
Expected Results
Person got access to specific access point
Access point status is set to Unblock
Where
23 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person
Grant the person access to the access point
Assign valid Card to this person
Send credentials to the device
Use the credential to access the access point
Expected Results
Person has correctly defined permissions in a device
Where
24 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person
Assign the person a valid credential
Grant the person access to the access point
Restrict the access permission with time restriction
Send credentials to the device
Check whether the restriction is applied correctly
Expected Results
The assigned time restriction is correctly applied
When person has no limitation in access it gets access granted event. When person has limited
access by time restriction it gets access denied event.
Where
Notes:
Some devices might impose limits on the complexity and/or amount of available time
restrictions.These limits must be enumerated in test notes and validated during this test.
25 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Activate antipassback functionality on device, when necessary
Create new person
Assign the person a valid credential
Use the credential to access the access point
Use credential again on same access point
Remove person from the region in C4
Use the credential to access the access point
Expected Results
Person get access granted for first attempt
Person get denied access for second attempt
Person get granted access for third attempt
Where
Notes:
Valid only on devices providing antipassback functionality. Credential holder's record will be "forgiven"
in order for normal credential access to be achieved.
26 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person
Execute Learn Card feature on this person
Choose correct device for card learning
Slide the card on this device
Expected Results
A card of device supported type is created and assigned to the person
Notes:
Some devices might have some limitations in providing information abut the unknown card
Valid only on devices providing enough information about the unknown card, that the card information can be
constructed from these data and new card can be created in a system
27 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person.
Grant the person access to the access point
Assign valid PIN to this person
Send credentials to the device
Check, whether the definitions were transferred correctly – either by reading the device memory
directly or by proving operation on the device
Expected Results
Person has correctly defined permissions in a device.
Where
Notes:
Some devices might have some limitations in PIN length or some rules to define valid PIN.
28 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Create new person
Assign the person a valid credential
Create holiday set, containing the todays date
Send credentials to the device
Check whether the restriction is applied correctly
Modify holiday set that it doesn't contain todays date
Send credentials to the device
Check whether the restriction is applied correctly
Expected Results
1.The assigned time restriction is correctly applied
Where
Notes:
Some devices might impose limits on the complexity and/or amount of available time
restrictions.These limits must be enumerated in test notes and validated during this test.
29 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Issue a duress alarm
Confirm the duress alarm
Expected Results
A device where the duress alarm is reported has Alarm status.
After confirming the duress alarm, duress alarm is finished and the device where the duress alarm
was reported has normal status.
Where
DEVICE represents the name of device where the duress alarm occurred.
PERSON represents the name of person issuing the duress alarm
Notes:
Depending on the device, the Alarm state might be signalized on other devices like areas, panels etc.
It is acceptable when the alarm is confirmed by other sequence of commands issued from UI (typically
Disarm on area)
In C4 alarm events are stored always for device that is “nearest” to the real alarm source. This is
usually keypad. In case the device or its protocol doesn’t provide the information with that precision,
for example provides only information about the alarmed area, the test can be considered as passed
with remark in test notes
30 / 37
VEREX/SNAPP – INTEGRATION MANUAL
T0BHSL - Tamper
This test verifies behavior of the driver when processing the events about the device tampers on Access
systems, Alarm systems or devices with similar functionality.
Test Steps
Issue a tamper on detector, while detector is in disarmed state
Restore the tamper
Confirm the alarm from C4 UI.
Expected Results
Until the alarm confirmation, the detector has tamper status.
Where
Notes:
Variation of this test is to confirm the tamper alarm from device keypad
Test must be reproducible on all devices that are capable of generating the tamper alarm
In case the device ends the tamper state automatically, there is no need to confirm the tamper from
C4 UI and the test is also considered as passed.
31 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Disconnect the mains power
Wait until the disconnection is signalled
Reconnect mains power
Wait until the reconnection is signalled.
Expected Results
When mains power is disconnected device status is set to Fault state
After mains power is reconnected device status is set to real status of device.
Where
DEVICE represents the device where the power failure was detected.
Notes:
Test must be replicable on all types of devices that have independent powering and are backed up by
battery or another power source
32 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Set the device time 60 min back.
Start the endpoint
Wait until driver is fully started
Check the time on device
Expected Results
Device time is synchronized with C4 server current time.
Notes:
Event is stored only when the time difference is greater than 5 minutes
When the device has its own NTP server (or similar facility) and the driver itself does not set the time on the
device, this test is considered not supported. Option of using NTP server to synchronize time should be stated in
the integration manual
Test is considered as passed also in case the event is not logged due to impossibility to retrieve device time
33 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Disconnect the backup power
Wait until the disconnection is signalled
Reconnect the backup power
Wait until the reconnection is signalled
Expected Results
When backup power is disconnected device status is set to Fault state
After backup power is reconnected device status is set to real status of device.
Where
DEVICE represents the device where the power failure was detected.
Notes:
Test must be replicable on all types of devices that have independent power and are backed up by
battery or another power source.
34 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Stop the endpoint
Wait for 1 minute
Execute operation on device that leads to the entry in the device audit log
Wait for 1 minute
Start the endpoint.
Expected Results
All events from the device that happened during disconnection are stored in audit log with original
time of the events on device, not with the time when they were read out from the device.
Where
35 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Test Steps
Execute command “On” on output.
After the output is opened, execute command “Off” on it.
Expected Results
When output is activated, its status is Open.
When output is deactivated, its status is Normal.
Where
36 / 37
VEREX/SNAPP – INTEGRATION MANUAL
Standard behavior is that the driver retrieves all nodes and properties on the device.
Test Steps
Use add wizard and choose corresponding device type
Fill required properties
Wait until the driver loads configuration from device
Confirm the changes
Expected Results
Window where you can fill required properties is shown.
'DEVICE' tree was successfully imported.
Where
Notes:
Variation of this test is to execute the command "Load Configuration from Device" on incomplete
device tree configuration. When this functionality is supported, the test is considered as passed only
when both ways work correctly
Some devices do not provide all properties
37 / 37