Genetec Security Center

The Genetec Security Center integrated system provides camera system integration into Runtime.

Definitions

GSC — Genetec Security Center.

PTZ — Pan-Tilt-Zoom. Describes the movement capabilities of cameras.

VMS — Video Management System. A system that manages the playback, storage, and gathering of video.

Setup

Note: Multi-select is not available for camera assets.

Compatibility

The Genetec Security Center integrated system supports integration with Security Center v5.7-5.11.
Important: The version of the IPFusion — Genetec Security Center service installed must correspond to your Genetec Security Center server version. Features described in this page are for the latest version of Genetec. You can see how to find the Genetec Security Center server version here. If you have a version of Genetec Security Center older than 5.11, you will need to contact support for the correct driver and information about the features available in your version.

Prerequisites

Software Minimum Version
.NET Framework 4.8
IPFusion — Genetec Security Center 2.5

When completing your setup, be sure to have the Genetec Security Center documentation available for reference.

Important: To use this system, you will require a license for the Genetec SDK. For the license, you will need to use this part number: GSC-1SDKDELCOGenetecService

Enable RTSP

To ensure the video viewer in Runtime receives the video feed properly from Genetec, RTSP must be enabled on the Genetec server. To enable RTSP:

  1. Open the Config Tool on the Genetec Server.
  2. Navigate to System > Roles > Media Gateway > Properties > RTSP.
  3. Set the Enable option to ON.
  4. Set the User Authentication option to OFF.
  5. Click Apply.

Ports

These ports must be open in your network firewall for the integration to work.

Purpose Default Value Configurable
Genetec Security Center Video Connection 654 No
Genetec Security Center Server Connection 5500 No
Dataserver 9010 Yes
Debug Tools 9563 No

Communication Configuration

In the integrated system configuration panel, you will find the Communication Settings. The below information is required.

Genetec IP Address The IP Address of the primary Genetec directory server.
Note: Failover is handled internally for secondary directory servers. The IP Address of the secondary server is not required.
Username The Username associated with the Runtime to GSC connection. It is configured within Genetec with sufficient access for SDK connections. Typically, this user account is created specifically for Runtime connectivity so it is not accidentally changed or deleted.
Password The Password associated with the Runtime to GSC connection.
Note: Red X indicates an invalid or out of range value given for field.

Assets

Camera Asset

This asset represents a camera in the Genetec VMS.

Important: Genetec camera video feeds cannot be displayed in Video Viewers or VideoFusion.

Supported States

Normal The asset is online and in its default state.
Fault An issue has been detected in a connected asset.
Masked The asset has been masked over its true state.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.
Pan/Tilt Pans and tilts a camera in a configured direction.
Zoom Zooms the camera in or out at a specified speed.
Stop PTZ Stops the current PTZ action.
PTZ Preset Executes a preset PTZ command using the preset ID.
Aux Set Sets the Aux of a Camera.
Aux Clear Clears the Aux of a Camera.
Playback Bookmark Bookmarks a period of time after command trigger.
  • PostPlayback Time (s) — The amount of time in seconds forward from the command issue to bookmark.
Trigger Output Allows a camera's feed to be toggled on or off from an output device.
  • Output Logical ID — The Logical ID of the output device.
  • Output Behavior Logical ID — The ID for the action to be completed on the output device, configured in the Genetec system.

See the Command Tables page for more information on configuring command tables.

System Asset

The system asset represents the connection state of the GSC system.

View all properties

Supported States

Normal The asset is online and in its default state.
Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Security Center Role

The role asset is a representation of the Genetec server in the GSC system.

Supported States

Normal The asset is online and in its default state.
Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Warning Role has run into an unexpected issue.
Error Role has run into an issue affecting its functionality.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Security Center Door

This asset represents a door in the GSC system.

Supported States

Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Secure The door is currently closed.
Unsecure The door is currently opened.
Forced Open A locked door has been forcibly opened.
Held Open A door has been unlocked, opened, and is being held open for an extended period of time.
Locked REX is disabled on this door.
Unlocked REX is enabled on this door.
Maintenance Mode Active The door is currently unlocked for maintenance.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Lock Disables REX on the door.
Unlock Enables REX on the door.
Enable Maintenance Sets the door into maintenance mode, unlocking it indefinitely.
Disable Maintenance Removes the maintenance mode and locks the door.
Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Security Center Reader

This asset represents a reader in the GSC system.

Supported States

Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Card and Pin Mode The reader will only unlock the door if both a card is swiped, and a pin is entered.
Card or Pin Mode The reader will unlock the door if either a card is swiped or a pin is entered.
Reader None Mode No mode has been configured for the reader. While in this state, it cannot be accessed with a card or pin.
Disabled The reader is currently disabled and cannot be accessed with a card or pin.
Access Rule Applied A specified access rule is active on the reader. The access rules Logical ID must be specified in the status parameters.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Set Reader Mode Sets the reader to a specified reader mode:
  • Reader Pin and Card Mode — The reader will only unlock the door if both a card is swiped, and a pin is entered.
  • Reader Pin or Card Mode — The reader will unlock the door if either a card is swiped or a pin is entered.
Enable Enable the reader so it can allow the use of pins/cards for access.
Disable Disable the reader so it will no longer allow access.
Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Security Center Output

This asset represents a output device in the GSC system.

Supported States

Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Secure The output is not currently activated.
Active This output is activated.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.
Activate Set the output to an active status.
Deactivate Set the output to a secure status.

See the Command Tables page for more information on configuring command tables.

Security Center Input

This asset represents a input device in the GSC system.

Supported States

Masked The asset has been masked over its true state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Secure The input is not currently activated.
Active This input is activated.
Trouble Open The input circuit has been opened.
Trouble Short An issue has been detected in the input hardware.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Mask Mask the asset's true state.
Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Workflow Integration

The below information is specific to the Genetec Security Center system. For more information about Workflows, see the Workflows section.

System Events

System events are events used to trigger Workflow actions at the system level. For more information about Workflows, see the Workflows section.

Analytic Event

This event is triggered when an analytic event occurs in the Genetec system.

The below analytic events will trigger this:
  • Adaptive Motion
  • Audio Alarm
  • Crowd Detected
  • Direction Alarm
  • Face Detected
  • Face Recognized
  • Heat Map Changed
  • License Plate In Sight
  • License Plate Out of Sight
  • License Plate Reading
  • Object Condition Change
  • Object Count Changed
  • Object Count Reached
  • Object Crossed Line
  • Object Detected
  • Object Direction Changed
  • Object Entered
  • Object Exited
  • Object Fall
  • Object Following Route
  • Object In Field
  • Object Left
  • Object Loitering
  • Object Merged
  • Object Removed
  • Object Run
  • Object Slide
  • Object Split
  • Object Stopped
  • Object Velocity Changed
  • People Counting
  • People Counting Alarm
  • Tailgating
  • Tampering
  • Tampering Off
  • Temperature Detection On
  • Temperature Detection Off
  • Undefined
Table 1. Properties
Event Name The name of the analytic event which occurred.
Entity Type The type of Genetec entity which the event occurred on. E.g., a camera.
Genetec ID The Genetec ID of the entity which the event occurred on.
Date/Time The date and time which the event occurred at.

Asset Events

Asset events are events used to trigger Workflow actions on an asset level. For more information about Workflows, see the Workflows section.

Door and Reader

The below triggers can be fired on either a door or reader asset.

Access Granted

A card or pin has been used on the door/reader, and access to it has been granted. Information about the access event is available in the Last Access Event object.

Access Denied

A card or pin has been used on this door/reader, and access to it has been denied. Information about the access event is available in the Last Access Event object.

Last Access Event

Door and reader assets contain a child object (Last Access Event) which contains the information for that assets most recent access granted or denied event.

Table 2. Properties
Access Granted Whether or not access was granted (True) or not (False).
Cardholder Name The name of the cardholder associated with the card/pin used.
Date/Time The timestamp for when this event occurred.

System Commands

System commands are commands executed through Workflows at the system level.

Add Access Rule

Adds an access rule to a door asset.

Table 3. Parameters
Door Asset ID The asset ID for the door the access rule will be applied to.
Access Rule Logical ID The logical ID for the access rule as defined in the Genetec Security Center server.
Door Side Which reader this rule applies to for the door (i.e. in, out, both).

Remove Access Rule

Removes an access rule from a door asset.

Table 4. Parameters
Door Asset ID The asset ID for the door the access rule will be removed from.
Access Rule Logical ID The logical ID for the access rule as defined in the Genetec Security Center server.
Door Side Which side of the door this rule is to be removed from (i.e. in, out, both).

Callup Live Camera to Genetec Monitor

Brings up live camera feed from a specified camera to a specified tile of a specified monitor.

Table 5. Parameters
Asset ID The Asset ID of which camera's feed to be used.
Monitor ID The ID of the Monitor that the feed will be called up on.
Tile Number The Number that corresponds with the Tile of the monitor that the feed will be called up on.

Callup Playback Camera to Genetec Monitor

Calls up recorded camera feed from a specified camera to a specified tile of a specified monitor.

Table 6. Parameters
Asset ID The Asset ID of the camera's feed to be used.
Monitor ID The ID of the monitor that the feed will be called up on.
Tile Number The number that corresponds with the tile of the monitor that the feed will be called up on.
Date and Time Starting Date/Time for playback.
Pre-Playback Seconds The number of seconds back from date time to begin playback.
Post-Playback Seconds The number of seconds forward from date time to end playback.

Create Playback Bookmark

Adds a bookmark to the GSC system starting and ending at a specific time.

Table 7. Parameters
Asset ID The Asset ID of the camera feed that will be used.
Date and Time The date/time to base the bookmark off of.
Post Time in Seconds This is used to start a manual recording session on the camera for a specified duration. If the camera is already recording, this has no effect.

Stop Playback

Halts playback feed for a specific camera.

Table 8. Parameters
Asset ID The Asset ID of the camera feed that will be stopped.

Clear Monitor

Sets all of the tiles on a specified monitor to be blank.

Table 9. Parameters
Monitor ID The ID of the Monitor that will have its tiles cleared.

Change Tile Layout on Genetec Monitor

Changes the layout of the tiles on a Genetec monitor.

Warning: When updating a layout to use a large number of tiles, this may cause the monitor to update its layout slowly.
Table 10. Parameters
Monitor ID The ID of the Genetec monitor to update the tile layout on.
Tile Columns The number of columns to set for the tiles. This value must be one or greater.
Tile Rows The number of rows to set for the tiles. This value must be one or greater.

Trigger Output on Camera

Allows a camera's feed to be toggled on or off from an output device.

Table 11. Parameters
Asset ID The Asset ID of the Genetec camera.
Output ID The logical ID of the output device.
Output Behavior ID The ID for the action to be completed on the output device, configured in the Genetec system.

Trigger Camera Preset

Table 12. Parameters
Preset ID The ID of the preset command.
Note: This command only accepts integer values. If a string value is required, please use the camera asset PTZ preset command instead.
Asset ID The ID of the camera asset to execute the PTZ command on.

Troubleshooting

Logs from the driver and Runtime can be viewed in the Debug Tools client. These messages contain information which can provide further context for issues during initialization, or while actively running. This can help diagnose problems.