Difference between revisions of "V2/Integrate/XProtect Video"

From Senfi Docs
Jump to: navigation, search
 
(28 intermediate revisions by the same user not shown)
Line 51: Line 51:
 
# After installation, Senfi XProtect Video Adapter can be accessed with the following URL: [http://localhost:22020/ui/login http://localhost:22020/ui/login]
 
# After installation, Senfi XProtect Video Adapter can be accessed with the following URL: [http://localhost:22020/ui/login http://localhost:22020/ui/login]
 
#* Users can also use the Start Menu to access this page: Start -> Senfi XProtect Video Adapter (folder) -> Senfi XProtect Video Adapter
 
#* Users can also use the Start Menu to access this page: Start -> Senfi XProtect Video Adapter (folder) -> Senfi XProtect Video Adapter
 +
 +
==== '''Generate Integration Key-Secret Pair''' ====
 +
A Senfi API Key and associated secret is required to login/register the Senfi XProtect Video Adapter. View [[V2/CMS_Tutorial/Developer_Tools/Integration/Key|here]] to generate an integration key/secret pair in the CMS.
  
 
==== '''Login Page''' ====
 
==== '''Login Page''' ====
−
[[File:Msva_01_login.png|thumb|center|426px|Login Page|link=]]
+
[[File:XProtect_VA_Login.png|thumb|center|400px|Login Page|link=]]
−
# Login via your Senfi '''Username''' and '''Password'''.
+
# Server/Gateway Hostname - This should be app.senfi.io
 +
# Login via your Senfi API Key and associated secret pair.
 +
# If you require proxy, please send us an [mailto:contact@senfi.io email] with your organization name and contact details for further instructions.
 +
 
  
 
==== '''Setup Page''' ====  
 
==== '''Setup Page''' ====  
−
This page is used to register the Senfi Milestone Video Adapter with Senfi. A Senfi API Key and associated secret is required to complete this step. View [[V2/CMS_Tutorial/Developer_Tools/Integration/Key|here]] to generate an integration key/secret pair in the CMS.
+
This page is used to register the Senfi XProtect Video Adapter with Senfi.  
  
 
Fill in:
 
Fill in:
Line 65: Line 71:
 
# Secret - Secret to your Senfi API Key
 
# Secret - Secret to your Senfi API Key
  
−
After registration, you will see a Video Adapter ID. The ID and Video Adapter Name will be shown in the [https://app.senfi.io/cms/video_adapter|Senfi CMS Video page]  when you use the CMS to configure site/asset to video stream.
+
After registration, you will see a Video Adapter ID. The ID and Video Adapter Name will be shown in the [https://app.senfi.io/cms/video_adapter Senfi CMS Video page]  when you use the CMS to configure site/asset to video stream.
  
 
[[File:Msva_02_setup.png|thumb|center|800px|Setup Page|link=]]
 
[[File:Msva_02_setup.png|thumb|center|800px|Setup Page|link=]]
  
−
Click '''Setup Milestone''' to continue.
+
Click '''Setup XProtect''' to continue.
  
−
==== '''Milestone Config''' ====
+
==== '''XProtect Config''' ====
 
This page is used to configure the connection to the Milestone XProtect server
 
This page is used to configure the connection to the Milestone XProtect server
−
[[File:Msva_milestone_config.png|thumb|center|690px|Configure Milestone|link=]]
+
[[File:XProtect_Config.png|thumb|center|716px|Configure XProtect|link=]]
  
 
Fill in:
 
Fill in:
−
# Milestone Server hostname or IP address
+
# XProtect Management Server hostname or IP address
−
# Milestone Server port - 80 (Default)
+
# XProtect Server port - 80 (Default)
−
# Milestone Account Username - Username to an Administrator account on the Milestone server
+
# XProtect Account Username - Username to an Administrator account on the XProtect server
−
# Milestone Account Password - Password to above
+
# XProtect Account Password - Password to above
−
# Milestone Account Domain (Optional) - Fill this in if your Milestone account is a domain LDAP account
+
# XProtect Account Domain (Optional) - Fill this in if your XProtect account is a domain LDAP account
 
# Credential Type - Windows or Basic Account
 
# Credential Type - Windows or Basic Account
−
# Milestone Adapter hostname or IP address - localhost (Default/Cannot be modified)
+
# Management Server Encrypted – If XProtect server has SSL enabled (e.g. using https), select “Yes”
−
# Milestone Adapter port - 8732 (Default/Cannot be modified)
+
# Event Server Encrypted – If XProtect server has SSL enabled (e.g. using https), select “Yes”
−
# Milestone Adapter Streaming Base Port - 49152 (Default)
+
# XProtect Adapter hostname or IP address - localhost (Default/Cannot be modified)
 +
# XProtect Adapter port - 8732 (Default/Cannot be modified)
 +
# XProtect Adapter Streaming Base Port - 49152 (Default)
  
−
Click "Update Configuration" to set or change the configuration. If successful, the page will show "Connected to Milestone Server: <IP/Hostname>".
+
Click "Update Configuration" to set or change the configuration. If successful, the page will show "Connected to XProtect Server: <IP/Hostname>".
  
 
==== '''Video''' ====
 
==== '''Video''' ====
−
The Video page is used to configure live video from Milestone that will be available for streaming to Senfi.
+
The Video page is used to configure live video from XProtect that will be available for streaming to Senfi.
−
 
 
−
[[File:Msva_04_Video.png|thumb|center|787px|Add new stream|link=]]
 
  
 
To add a new Stream
 
To add a new Stream
−
# Click "Stream +". The Stream > Add New page will appear
+
[[File:Add_Video_Stream_01_labelled.png|thumb|center|781px|Add new stream|link=]]
−
# Specify [[File:Msva_05_AddNewVideo.png|thumb|center|787px|Add new stream page|link=]]
+
# Go to the "Video" tab.
 +
# Click "Stream +". The Stream > Add New page will appear.
 +
# Specify [[File:Add_Video_Stream_02.png|thumb|center|800px|Add new stream page|link=]]
 
#* Stream Name
 
#* Stream Name
−
#* Select from the list of cameras in the Milestone server
+
#* Stream Type (XProtect)
 +
#* Select from the list of cameras in the XProtect server
 
#* If the selected camera has PTZ capability, you can check the "PTZ" checkbox to enable PTZ capability in Senfi
 
#* If the selected camera has PTZ capability, you can check the "PTZ" checkbox to enable PTZ capability in Senfi
 
# Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
 
# Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
Line 107: Line 116:
  
 
==== '''Alarm''' ====
 
==== '''Alarm''' ====
−
The Alarm page is used to configure Milestone alarms which will be raised as Senfi External Events. Following is the pipeline of how Milestone alarms will be raised as Senfi External Events:
+
The Alarm page is used to configure XProtect alarms which will be raised as Senfi External Events. Following is the pipeline of how XProtect alarms will be raised as Senfi External Events:
  
−
# Something happens to/in a Milestone device
+
# Something happens to/in a XProtect device
−
# An alarm is raised by Milestone
+
# An alarm is raised by XProtect
−
# Senfi Milestone Video Adapter is notified
+
# Senfi XProtect Video Adapter is notified
−
# If an External Event has been configured for the Milestone Alarm and alarm state combination, and that External Event has been selected as raisable for the Milestone device, a Senfi External Event is generated by Senfi Milestone Video Adapter.
+
# If an External Event has been configured for the XProtect Alarm and alarm state combination, and that External Event has been selected as raisable for the XProtect device, a Senfi External Event is generated by Senfi XProtect Video Adapter.
 
# If the External Event (assuming that the External Event is linked to a Senfi Asset in the CMS) has been configured to raise a Senfi Alarm, a Senfi Alarm is raised.  
 
# If the External Event (assuming that the External Event is linked to a Senfi Asset in the CMS) has been configured to raise a Senfi Alarm, a Senfi Alarm is raised.  
  
Line 118: Line 127:
  
 
The Alarm page is split into 2 tabs:
 
The Alarm page is split into 2 tabs:
−
# Alarm - To configure Milestone Alarm/Alarm state combination mapping to Senfi external event (i.e. which external event to be sent)
+
# Alarm - To configure XProtect Alarm/Alarm state combination mapping to Senfi external event (i.e. which external event to be sent)
−
# Device - To configure Milestone device mapping to Senfi external event (i.e. which milestone devices can send which external events)
+
# Device - To configure XProtect device mapping to Senfi external event (i.e. which XProtect devices can send which external events)
−
 
 
−
==== Milestone Alarm Tab ====
 
  
−
[[File:Msva_06_Alarm.png|thumb|center|787px|Milestone Alarm Page|link=]]
+
==== XProtect Alarm Tab ====
  
−
In this tab, a list of Milestone alarm definitions configured on the Milestone Server are shown.
+
In this tab, a list of XProtect alarm definitions configured on the XProtect Server are shown.
 
To forward an alarm/state combination to Senfi as an external event:
 
To forward an alarm/state combination to Senfi as an external event:
−
# Click the Pencil icon on the desired Milestone alarm [[File:Msva_07_AlarmEventMapping.png|thumb|center|787px|Milestone Alarm to Senfi Event Mapping|link=]]
+
# Click the Pencil icon on the desired XProtect alarm [[File:Alarm_configuration_01.png|thumb|center|800px|XProtect Alarm Page|link=]]
−
# In Senfi Event Raised, select either
+
# In Senfi Event Raised, select '''+ EVENT FOR INCOMING ALARM''' - 1 Senfi event will be added to be generated when a New alarm is received by the adapter. [[File:Alarm_configuration_02.png|thumb|center|800px|XProtect Alarm to Senfi Event Mapping|link=]]
−
#* + EVENT FOR ALL ALARM STATES - Add 4 mapping templates to forward New, Acknowledged, On Hold, Closed states to Senfi
+
# Fill in '''Name''' - Name of external event in Senfi [[File:Alarm_configuration_04.png|thumb|center|800px|Name of external event to be displayed in Senfi|link=]]
−
#* + EVENT FOR SINGLE ALARM STATE - Add a mapping template
+
# A standard input and description has been auto-filled to be displayed in the eventual alarm in Senfi. To modify, change in Advanced section:
−
# For each mapping template, fill in/change
+
#* Inputs - Select from list of XProtect alarm data you want to use for inputs in the eventual Senfi alarm's description
−
#* Milestone Alarm State - Select from New, Acknowledged, On Hold, Closed
+
#* Description - Description of the eventual Senfi alarm, with embedded per-alarm-instance inputs [[File:Alarm_configuration_05.png|thumb|center|800px|Advanced settings|link=]]
−
#* Name - Name of external event in Senfi
 
−
#* A standard input and description has been auto-filled to be displayed in the eventual alarm in Senfi. To modify, change in Advanced section:
 
−
#** Inputs - Select from list of Milestone alarm data you want to use for inputs in the eventual Senfi alarm's description
 
−
#** Description - Description of the eventual Senfi alarm, with embedded per-alarm-instance inputs
 
 
# Click SAVE & EXIT
 
# Click SAVE & EXIT
  
−
[[File:Msva_08_AlarmEventMapping.png|thumb|center|787px|Sample for mapping of New alarm state for motion detection from Milestone|link=]]
+
This tab only configures XProtect Alarm/State combo to Senfi External Event mapping. Once configured, the equivalent External Event will automatically be created in Senfi CMS. To associate Senfi External Event from a particular XProtect device to be sent to Senfi, go to the XProtect Device tab.
  
−
This tab only configures Milestone Alarm/State combo to Senfi External Event mapping. To associate Senfi External Event from a particular Milestone device to be sent to Senfi, go to the Milestone Device tab.
+
Note:
 +
Only '''New''' XProtect Alarm State will generate a Senfi event. Other XProtect Alarm States will update an existing Senfi event.
  
−
==== Milestone Device Tab ====
+
==== XProtect Device Tab ====
−
In this tab, a list of Milestone camera and input devices configured on the Milestone Server are shown.
+
In this tab, a list of XProtect camera and input devices configured on the XProtect Server are shown.
  
−
[[File:Msva_09_AlarmDevice.png|thumb|center|787px|Milestone Device Page|link=]]
+
[[File:Device_Configuration_01.png|thumb|center|779px|XProtect Device Page|link=]]
  
−
To map mapped alarms (configured in the Milestone Alarm Tab) from Milestone devices to Senfi assets:
+
To map mapped alarms (configured in the XProtect Alarm Tab) from XProtect devices to Senfi assets:
−
# Click the Pencil icon on the desired Milestone device
+
# Click the Pencil icon on the desired XProtect device
−
# Write down the source_id for the corresponding Milestone Device. You will need this information later when configuring Senfi assets in the CMS.
+
# Write down the source_id for the corresponding XProtect Device. You will need this information later when configuring Senfi assets in the CMS.
−
# In Senfi Event Triggered, select one or more mapped Senfi External Event that this Milestone device will trigger in Senfi.
+
# In Senfi Event Triggered, select one or more mapped Senfi External Event that this XProtect device will trigger in Senfi.
 
# Click SAVE & EXIT
 
# Click SAVE & EXIT
  
−
[[File:Msva_10_DeviceEventMapping.png|thumb|center|787px|Sample of Milestone Device to Senfi Event Mapping|link=]]
+
[[File:Device_Configuration_02.png|thumb|center|726px|Sample of XProtect Device to Senfi Event Mapping|link=]]
  
−
Note: In Step 3, all Senfi External Event mapped by this adapter will be shown. This may include events that cannot be raised by the selected Milestone Device (e.g. a Camera raising an input triggered external event mapped to a Milestone input alarm)
+
Note: In Step 3, all Senfi External Event mapped by this adapter will be shown. This may include events that cannot be raised by the selected XProtect Device (e.g. a Camera raising an input triggered external event mapped to a XProtect input alarm)
  
 
==== '''Backup & Restore''' ====
 
==== '''Backup & Restore''' ====
−
[[File:Msva_11_Backup.png|thumb|center|787px|Backup|link=]]
+
[[File:Msva_11_Backup.png|thumb|center|800px|Backup|link=]]
 
To backup configuration, click BACKUP
 
To backup configuration, click BACKUP
  
−
[[File:Msva_12_Restore.png|thumb|center|787px|Restore|link=]]
+
[[File:Msva_12_Restore.png|thumb|center|800px|Restore|link=]]
 
To restore from previously downloaded backup config file, click RESTORE
 
To restore from previously downloaded backup config file, click RESTORE
  
−
[[File:Msva_13_ResetToFactoryDefault.png|thumb|center|787px|Reset to factory default|link=]]
+
[[File:Msva_13_ResetToFactoryDefault.png|thumb|center|800px|Reset to factory default|link=]]
 
To remove all streams and reset settings to factory default, click RESET TO FACTORY DEFAULT
 
To remove all streams and reset settings to factory default, click RESET TO FACTORY DEFAULT
  
−
===Steps to Use Configured Milestone Video and External Events in Senfi CMS===
+
===Steps to Use Configured XProtect Video and External Events in Senfi CMS===
 
To use the configured video and external events in Senfi, additional configuration needs to be performed in the Senfi CMS.
 
To use the configured video and external events in Senfi, additional configuration needs to be performed in the Senfi CMS.
  
 
==== '''Associate Video Adapter to Site in CMS''' ====
 
==== '''Associate Video Adapter to Site in CMS''' ====
 
# Go to the [https://app.senfi.io/cms/video_adapter Video Page]
 
# Go to the [https://app.senfi.io/cms/video_adapter Video Page]
−
# In the VIDEO ADAPTER tab, find the Name (or Video Adapter ID) of the Senfi Milestone Video Adapter, and click the Pencil icon
+
# In the VIDEO ADAPTER tab, find the Name (or Video Adapter ID) of the Senfi XProtect Video Adapter, and click the Pencil icon [[File:Video_adapter.png|thumb|center|800px|Video adapters page|link=]]
 
# Select the Site to associate this video adapter with
 
# Select the Site to associate this video adapter with
 
# Optionally, provide a description
 
# Optionally, provide a description
−
# Click the Tick arrow to save.
+
# Click the Tick arrow to save. [[File:Video_adapter_02.png|thumb|center|800px|Video adapters page|link=]]
  
 
==== '''Link Video Streams to Asset in CMS''' ====
 
==== '''Link Video Streams to Asset in CMS''' ====
 
# Edit the Asset
 
# Edit the Asset
 
# Click + STREAM
 
# Click + STREAM
−
# Select the Milestone video camera in the drop down list
+
# Select the XProtect video camera in the drop down list
 
# Select whether to Allow PTZ if PTZ has been enabled.
 
# Select whether to Allow PTZ if PTZ has been enabled.
 
# Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
 
# Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
−
# Click SAVE & EXIT
+
# Click SAVE & EXIT [[File:Configure_video.png|thumb|center|800px|Link video stream to asset in CMS|link=]]
  
 
==== '''Link External Event to Asset in CMS''' ====
 
==== '''Link External Event to Asset in CMS''' ====
−
For External Events generated by Senfi Milestone Video Adapter to be attributed to a Senfi Asset, the Senfi Asset must be configured with an External Event source, with the source_id you written down in the "Milestone Device Tab" section Step 2.
+
For External Events generated by Senfi XProtect Video Adapter to be attributed to a Senfi Asset, the Senfi Asset must be configured with an External Event source, with the source_id you written down in the "XProtect Device Tab" section Step 2.
  
 
# Edit the Asset
 
# Edit the Asset
 
# Click + EVENT
 
# Click + EVENT
 
# Select the External Event in the drop down list
 
# Select the External Event in the drop down list
−
# User Tags, enter the source_id of the Milestone device. This is the source_id you have written earlier in "Milestone Device Tab" Step 2 [[File:Linking_source_id.png|thumb|center|800px|Fill in the same source_id|link=]]
+
# User Tags, enter the source_id of the XProtect device. This is the source_id you have written earlier in "XProtect Device Tab" Step 2 [[File:Linking_source_id.png|thumb|center|800px|Fill in the same source_id|link=]]
 
# Click SAVE & EXIT
 
# Click SAVE & EXIT
 +
 +
==== '''Raising External Alarms in CMS''' ====
 +
By setting up and linking an external event to an asset does not mean that alarms from external systems will be directly raised in Senfi. All external alarms must be raised by proxy using external events, which then trigger Senfi alarms using Senfi's automation workflow.
 +
 +
# Follow [[V2/CMS_Tutorial/User_Tools/Creating_Content/Automation/Alarm|Add Alarm]] to add Alarm.
 +
# Select external event as event trigger [[File:External_Alarm.png|thumb|center|800px|Adding alarm for external event|link=]]

Latest revision as of 11:38, 16 April 2026

Senfi XProtect Video Adapter

The Senfi XProtect Video Adapter is available to onboarded partners only. If you would like to join as a Senfi partner, please send us an email with your organization name and contact details.

General

The Senfi XProtect Video Adapter provides Senfi integration with the Milestone XProtect Video Management Software.

Features include:

  • View live video streams in Senfi
  • Send PTZ commands to PTZ camera from Senfi
  • Forward and synchronize XProtect alarms to/from Senfi

Senfi XProtect Video Adapter supports XProtect 2018 and later only.

Milestone XProtect Video Management Software Basics

Milestone XProtect is a Video Management Software (VMS) product offered by Milestone Systems A/S. For more information, view here

In the rest of this document, "XProtect" will be used to refer to an installed instance of Milestone XProtect.

XProtect Devices

Several device types can be added to XProtect. The supported device types are:

  • Camera devices
    • Streams video
    • Can have Pan-Tilt-Zoom (PTZ) capability
    • Can raise events related to video/video analytics. e.g. Motion Detected Event
  • Input devices
    • Simple 2-state/binary devices e.g. Tamper detection, momentary trigger
    • Can raise events related to changes of its state e.g. Input Rising Event

Note: Devices can also raise other system, device-specific or custom events, but their discussion is beyond the scope of this article.

XProtect Alarms

XProtect devices can raise Alarms from Events. Alarms will be shown in the Milestone XProtect Smart Client's Alarm Manager. Alarms have a name, which is used to identify the type of alarm (i.e. an alarm definition).

Alarms have 4 default states. Users can also add additional alarm states.

  • New
  • Acknowledged
  • On Hold
  • Closed

Alarms can be configured with a "related camera". This is mapped to each device that can raise a particular alarm.

Triggered alarms also contain other data such as:

  • Local ID
  • Priority
  • Category
  • Description
  • Timestamp

Steps to Install and Configure Senfi XProtect Video Adapter

Installation

  1. Request for a copy of the Senfi XProtect Video Adapter installer by sending an email to us.
  2. Run the installer on a Windows machine. It uses the following ports by default: 22020, 10085, 10086, 10087.
  3. After installation, Senfi XProtect Video Adapter can be accessed with the following URL: http://localhost:22020/ui/login
    • Users can also use the Start Menu to access this page: Start -> Senfi XProtect Video Adapter (folder) -> Senfi XProtect Video Adapter

Generate Integration Key-Secret Pair

A Senfi API Key and associated secret is required to login/register the Senfi XProtect Video Adapter. View here to generate an integration key/secret pair in the CMS.

Login Page

Login Page
  1. Server/Gateway Hostname - This should be app.senfi.io
  2. Login via your Senfi API Key and associated secret pair.
  3. If you require proxy, please send us an email with your organization name and contact details for further instructions.


Setup Page

This page is used to register the Senfi XProtect Video Adapter with Senfi.

Fill in:

  1. Server/Gateway Hostname - This should be app.senfi.io
  2. Video Adapter Name
  3. Integration Key - Your Senfi API Key
  4. Secret - Secret to your Senfi API Key

After registration, you will see a Video Adapter ID. The ID and Video Adapter Name will be shown in the Senfi CMS Video page when you use the CMS to configure site/asset to video stream.

Setup Page

Click Setup XProtect to continue.

XProtect Config

This page is used to configure the connection to the Milestone XProtect server

Configure XProtect

Fill in:

  1. XProtect Management Server hostname or IP address
  2. XProtect Server port - 80 (Default)
  3. XProtect Account Username - Username to an Administrator account on the XProtect server
  4. XProtect Account Password - Password to above
  5. XProtect Account Domain (Optional) - Fill this in if your XProtect account is a domain LDAP account
  6. Credential Type - Windows or Basic Account
  7. Management Server Encrypted – If XProtect server has SSL enabled (e.g. using https), select “Yes”
  8. Event Server Encrypted – If XProtect server has SSL enabled (e.g. using https), select “Yes”
  9. XProtect Adapter hostname or IP address - localhost (Default/Cannot be modified)
  10. XProtect Adapter port - 8732 (Default/Cannot be modified)
  11. XProtect Adapter Streaming Base Port - 49152 (Default)

Click "Update Configuration" to set or change the configuration. If successful, the page will show "Connected to XProtect Server: <IP/Hostname>".

Video

The Video page is used to configure live video from XProtect that will be available for streaming to Senfi.

To add a new Stream

Add new stream
  1. Go to the "Video" tab.
  2. Click "Stream +". The Stream > Add New page will appear.
  3. Specify
    Add new stream page
    • Stream Name
    • Stream Type (XProtect)
    • Select from the list of cameras in the XProtect server
    • If the selected camera has PTZ capability, you can check the "PTZ" checkbox to enable PTZ capability in Senfi
  4. Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
  5. Select "ADD" to add stream.

Note:

  • This is similar to Video Adapter
  • Only "On Demand" state is available.

Alarm

The Alarm page is used to configure XProtect alarms which will be raised as Senfi External Events. Following is the pipeline of how XProtect alarms will be raised as Senfi External Events:

  1. Something happens to/in a XProtect device
  2. An alarm is raised by XProtect
  3. Senfi XProtect Video Adapter is notified
  4. If an External Event has been configured for the XProtect Alarm and alarm state combination, and that External Event has been selected as raisable for the XProtect device, a Senfi External Event is generated by Senfi XProtect Video Adapter.
  5. If the External Event (assuming that the External Event is linked to a Senfi Asset in the CMS) has been configured to raise a Senfi Alarm, a Senfi Alarm is raised.

View link for discussion of Senfi's External Events.

The Alarm page is split into 2 tabs:

  1. Alarm - To configure XProtect Alarm/Alarm state combination mapping to Senfi external event (i.e. which external event to be sent)
  2. Device - To configure XProtect device mapping to Senfi external event (i.e. which XProtect devices can send which external events)

XProtect Alarm Tab

In this tab, a list of XProtect alarm definitions configured on the XProtect Server are shown. To forward an alarm/state combination to Senfi as an external event:

  1. Click the Pencil icon on the desired XProtect alarm
    XProtect Alarm Page
  2. In Senfi Event Raised, select + EVENT FOR INCOMING ALARM - 1 Senfi event will be added to be generated when a New alarm is received by the adapter.
    XProtect Alarm to Senfi Event Mapping
  3. Fill in Name - Name of external event in Senfi
    Name of external event to be displayed in Senfi
  4. A standard input and description has been auto-filled to be displayed in the eventual alarm in Senfi. To modify, change in Advanced section:
    • Inputs - Select from list of XProtect alarm data you want to use for inputs in the eventual Senfi alarm's description
    • Description - Description of the eventual Senfi alarm, with embedded per-alarm-instance inputs
      Advanced settings
  5. Click SAVE & EXIT

This tab only configures XProtect Alarm/State combo to Senfi External Event mapping. Once configured, the equivalent External Event will automatically be created in Senfi CMS. To associate Senfi External Event from a particular XProtect device to be sent to Senfi, go to the XProtect Device tab.

Note: Only New XProtect Alarm State will generate a Senfi event. Other XProtect Alarm States will update an existing Senfi event.

XProtect Device Tab

In this tab, a list of XProtect camera and input devices configured on the XProtect Server are shown.

XProtect Device Page

To map mapped alarms (configured in the XProtect Alarm Tab) from XProtect devices to Senfi assets:

  1. Click the Pencil icon on the desired XProtect device
  2. Write down the source_id for the corresponding XProtect Device. You will need this information later when configuring Senfi assets in the CMS.
  3. In Senfi Event Triggered, select one or more mapped Senfi External Event that this XProtect device will trigger in Senfi.
  4. Click SAVE & EXIT
Sample of XProtect Device to Senfi Event Mapping

Note: In Step 3, all Senfi External Event mapped by this adapter will be shown. This may include events that cannot be raised by the selected XProtect Device (e.g. a Camera raising an input triggered external event mapped to a XProtect input alarm)

Backup & Restore

Backup

To backup configuration, click BACKUP

Restore

To restore from previously downloaded backup config file, click RESTORE

Reset to factory default

To remove all streams and reset settings to factory default, click RESET TO FACTORY DEFAULT

Steps to Use Configured XProtect Video and External Events in Senfi CMS

To use the configured video and external events in Senfi, additional configuration needs to be performed in the Senfi CMS.

Associate Video Adapter to Site in CMS

  1. Go to the Video Page
  2. In the VIDEO ADAPTER tab, find the Name (or Video Adapter ID) of the Senfi XProtect Video Adapter, and click the Pencil icon
    Video adapters page
  3. Select the Site to associate this video adapter with
  4. Optionally, provide a description
  5. Click the Tick arrow to save.
    Video adapters page

Link Video Streams to Asset in CMS

  1. Edit the Asset
  2. Click + STREAM
  3. Select the XProtect video camera in the drop down list
  4. Select whether to Allow PTZ if PTZ has been enabled.
  5. Preview stream by selecting "PREVIEW" beside "Source URL" (Optional).
  6. Click SAVE & EXIT
    Link video stream to asset in CMS

Link External Event to Asset in CMS

For External Events generated by Senfi XProtect Video Adapter to be attributed to a Senfi Asset, the Senfi Asset must be configured with an External Event source, with the source_id you written down in the "XProtect Device Tab" section Step 2.

  1. Edit the Asset
  2. Click + EVENT
  3. Select the External Event in the drop down list
  4. User Tags, enter the source_id of the XProtect device. This is the source_id you have written earlier in "XProtect Device Tab" Step 2
    Fill in the same source_id
  5. Click SAVE & EXIT

Raising External Alarms in CMS

By setting up and linking an external event to an asset does not mean that alarms from external systems will be directly raised in Senfi. All external alarms must be raised by proxy using external events, which then trigger Senfi alarms using Senfi's automation workflow.

  1. Follow Add Alarm to add Alarm.
  2. Select external event as event trigger
    Adding alarm for external event
Retrieved from "https://www.senfi.io/docs/index.php?title=V2/Integrate/XProtect_Video&oldid=3942"