Lundix It SPC Bridge User manual

SPC Bridge User Manual
Revision 1.0

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
2 of 14
Reference
2017-111
History Record
Revision
Date
Author
Comment
1.0
Nov-2017
Lundix IT
First edition
©2017 Lundix IT
Lundix IT
Renvägen 22
S-433 70 Sävedalen
Sweden
[email protected]

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
3 of 14
Reference
2017-111
Contents
1INTRODUCTION................................................................................................................................... 4
1.1 SPC Bridge....................................................................................................................................................................................4
1.2 Features ........................................................................................................................................................................................4
1.3 Hardware Specification..........................................................................................................................................................4
1.4 Terminology and Abbreviations ........................................................................................................................................4
2INSTALLATION..................................................................................................................................... 6
2.1 Installation Prerequisites......................................................................................................................................................6
2.2 Installation Steps ......................................................................................................................................................................6
3CONFIGURATION................................................................................................................................. 7
3.1 IP Address ....................................................................................................................................................................................7
3.2 Time Setting ................................................................................................................................................................................7
3.3 Change Administration Password.....................................................................................................................................7
3.4 SPC Communication (FlexC) ................................................................................................................................................7
3.4.1 SPC Panel FlexC Settings.............................................................................................................................................................................................. 7
3.4.2 SPC Bridge SPC Communication Settings............................................................................................................................................................. 8
3.5 Bridge API ...................................................................................................................................................................................9
3.6 SPC Test Tool........................................................................................................................................................................... 10
4ADVANCED USERS.............................................................................................................................11
4.1 Backup of Configuration Settings ................................................................................................................................... 11
4.2 Upgrading software .............................................................................................................................................................. 11
4.3 SSH Access ................................................................................................................................................................................ 11
5LICENSE AGREEMENTS ...................................................................................................................12
5.1 End-User License Agreement for SPC Bridge (EULA) ........................................................................................... 12
5.2 Open Source Software ......................................................................................................................................................... 13
5.3 Open Source Hardware....................................................................................................................................................... 13

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
4 of 14
Reference
2017-111
1Introduction
1.1 SPC Bridge
SPC Bridge is a network hub for bridging Vanderbilt SPC intrusion detection system to third-party
systems. The bridge converts Vanderbilt IP protocol FlexC to a REST/Websockets API that is easy to
use for integration with other platforms and products. SPC Bridge can be used with any SPC panel
that supports the FlexC protocol.
1.2 Features
SPC Panel Communication using FlexC
REST and Websockets API for easy integration with third-party products.
Web based Admin GUI
1.3 Hardware Specification
Processor
400MHz, 24K MIPS
Flash
16MB
RAM
64MB
Power input
9 –12V DC
Network
2 x 10M/100M RJ45 Connectors
WiFi
802.11 b/g/n
USB
1 x USB 2.0 host connector
Type Approval
FCC Part15 Subpart B, Subpart C, CE NB, C-Tick
1.4 Terminology and Abbreviations
Term
Description
FlexC
Vanderbilt SPC Flexible Secure Communications Protocol

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
5 of 14
Reference
2017-111
REST API
Representational State Transfer
API
Application Programming Interface
URL
Uniform Resource Locator
WebSocket
Two-way TCP protocol RFC 6455

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
6 of 14
Reference
2017-111
2Installation
2.1 Installation Prerequisites
Vanderbilt SPC panel with firmware >= 3.6 (3.6 was the first version with support for FlexC)
Network router with DHCP server enabled
Network connection between the SPC SmartBox and the SPC panel
Internet access (to be able to use time synchronization via NTP)
2.2 Installation Steps
1. Read carefully End-User License Agreement for SPC Bridge (EULA) in last section in this document. If
you do not agree to the terms of the EULA, do not install or use the SPC Bridge.
2. Connect SPC Bridge LAN port, with a regular network cable, to your network switch or router.
3. Power up the device by connecting the included power adapter to a wall socket and then to the SPC
Bridge device.
4. Wait (~2 minutes) until the SPC Bridge has fully started.
5. Login to your router and look for the IP address assigned to the SPC Bridge.
6. Open a web browser and enter the IP address of the SPC Bridge.
7. In the login window, enter Username (root) and Password (default is dragino) and you will see the
main menu.
8. You can now proceed with the configuration.

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
7 of 14
Reference
2017-111
3Configuration
SPC Bridge device is based on a standard Linux platform, OpenWrt, that is normally used for routers,
therefore you will find many standard configuration options in the Web GUI. In this manual only
configuration specific for the SPC Bridge functions is described. Most of these functions are available
in the main menu –SPC Bridge. For configuration of generic OpenWrt functions please see
wiki.openwrt.org .
3.1 IP Address
Default will SPC Bridge use DHCP to get an IP Address. To set a static IP Address, go to Network ->
Interfaces and:
1. Select LAN –Edit.
2. In Interfaces –LAN, select Static address in the Protocol option menu
3. Click on Switch Protocol
4. In Common Configuration –General Setup fill in; IPv4 address, netmask, gateway and custom DNS
servers.
5. In DHCP Server –General Setup; check the checkbox Ignore interface.
6. Click on Save & Apply.
7. Redirect your browser to the new IP Address.
3.2 Time Setting
To set correct Timezone, go to System -> System and select Timezone in section System Properties
–General Settings.
The device is as default using NTP to synchronize time. This setting is in System -> System section
Time Synchronization.
3.3 Change Administration Password
The default administration password for accessing the device is dragino. Of security reasons it is
highly recommended to change the password as soon as possible. Go to System -> Administration
section Device Password to change the password. The same password is used in both Web GUI and
for ssh access to the device.
3.4 SPC Communication (FlexC)
To setup the communication link between SPC Panel and SPC Bridge you have to configure the link in
both SPC Panel and SPC Bridge ends.
3.4.1 SPC Panel FlexC Settings.
Use Vanderbilt SPC Web interface and define the FlexC communication following this instructions:
NOTE! The device has no RTC clock. During boot the device can have incorrect time. Some events
in the system log can therefore have incorrect timestamps.

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
8 of 14
Reference
2017-111
1. Select Full Engineer mode
2. Create a specific user for the SPC Bridge communication, e.g spcbridge. User profile should be
Manager and you need also to define a web password for the user.
3. Select Communications -> FlexC -> Event Profiles. Click on Add to add a new event profile. Give the
event profile the name SPC Bridge Events and select (check) the report checkboxes for all event
types. (You may consider reducing these settings later to just necessary events for the third-party
application)
4. Select Communications -> FlexC -> FlexC ATS. Select Add Custom ATS and change following from
the default settings:
- ATS Name = SPC Bridge
- Event Profile = SPC Bridge Events (created in step 3)
- ATS Polling Timeout = 60 seconds
- Uncheck Generate FTC and Re-queue Events
5. Select Add ATP to FlexC RCT and change following from the default settings:
- SPT Account Code = 999
- RCT URL or IP Address = IP Address of the SPC Bridge
- ATP Category = Cat 6 [Ethernet]
6. Open Advanced ATP Settings and change following from the default settings:
- Encryption Key Mode = Fixed Encryption
- Encryption key (64 hex digits) = Your own key (must match the key in the SPC Bridge)
3.4.2 SPC Bridge SPC Communication Settings
In the SPC Bridge Web interface select SPC Bridge->SPC Communication and fill in the form
according to:
Element
Description
ATP Encryption Key
ATP Encryption Key. 64 hex numbers (0-9, a-f, A-F). Must match corresponding key in SPC
Panel FlexC settings.

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
9 of 14
Reference
2017-111
SPC Account Code
ATP Account Code. Must match corresponding key in SPC Panel FlexC settings.
RCT ID
RCT Id. Must match corresponding id in SPC Panel FlexC settings.
RCT TCP Port
RCT TCP Port. Must match corresponding value in SPC Panel FlexC settings.
SPC Username and Password
Credentials for FlexC communication. User must be defined in the SPC Panel and have a
corresponding web password.
3.5 Bridge API
The SPC Bridge provides a generic web service interface to the SPC panel. The main feature of this
interface is to simplify SPC integration with third party applications and products such as Home and
Building Automation Systems, Smartphone App’s and Web applications. The API is using HTTPS and
REST principles (RESTful) for queries and commands to the SPC panel and WebSockets for reporting
events from the SPC panel. HTTPS GET methods are used for queries and HTTPS PUT methods for
commands. The communication is always encrypted (HTTPS)
To configure the interface, go to SPC Bridge -> Bridge API and fill in the form.
Element
Description
API Server Settings
Port
API Server IP port.
Access Control List
Access Control List (ACL) allows restrictions to be put on the list of IP addresses which
have access to the API server. The ACL is a comma separated list of IP subnets, where each
subnet is pre-pended by either a - or a + sign. A plus sign means allow, where a minus sign

© PROPERTY OF LUNDIX IT SWEDEN, ALL RIGHTS RESERVED –THIS DOCUMENT AND THE INFORMATION CONTAINED THEREIN ARE CONFIDENTIAL –THE DISCLOSURE OR OTHER COMMUNICATION, COPYING, REPRODUCTION
AND ANY USE WHATSOEVER IS FORBIDDEN WITHOUT THE WRITTEN AUTHORIZATION OF LUNDIX IT.
SPC Bridge User Manual
Revision
1.0
Page
10 of 14
Reference
2017-111
means deny. If a subnet mask is omitted, such as -1.2.3.4, this means to deny only that
single IP address. Subnet masks may vary from 0 to 32, inclusive
REST/Websockets Credentials
Username and Password Queries
Username and password for queries to SPC Bridge. Default username is get_user and
password get_pwd.
Username and Password Commands
Username and password for commands (e.g. arm/disarm) to SPC Bridge. Default
username is put_user and password put_pwd.
Username and Password Events
Username and password for websockets events from SPC Bridge. Default username is
ws_user and password ws_pwd.
3.6 SPC Test Tool
To be sure that the communication between SPC Bridge and SPC panel is working properly you can
use the tests provided in SPC Bridge->SPC Test Tool. In the option menu you can choose between
query SPC areas, zones or the system log.
NOTE! For security reasons it is highly recommended that you set own passwords for Queries,
Commands and Events access.