Lundix It SPC Bridge KNX User manual

SPC Bridge KNX 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 KNX User Manual
Revision
1.0
Page
2 of 25
Reference
2020-111
History Record
Revision
Date
Author
Comment
1.0
Jan-2020
Lundix IT
First edition
©2020 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 KNX User Manual
Revision
1.0
Page
3 of 25
Reference
2020-111
Contents
1INTRODUCTION................................................................................................................................... 5
1.1 SPC Bridge KNX .........................................................................................................................................................................5
1.2 Main Features.............................................................................................................................................................................5
1.3 Hardware Specification..........................................................................................................................................................5
2INSTALLATION..................................................................................................................................... 7
2.1 Prerequisites...............................................................................................................................................................................7
2.2 First Time Installation Workflow ......................................................................................................................................7
3SYSTEM ADMINISTRATION ............................................................................................................. 8
3.1 System Administration Login..............................................................................................................................................8
3.2 Static IP Address .......................................................................................................................................................................9
3.3 Time Setting ................................................................................................................................................................................9
3.4 Change Administration Password.....................................................................................................................................9
4SPC BRIDGE CONFIGURATION......................................................................................................10
4.1 SPC Bridge Sign In ................................................................................................................................................................. 10
4.2 SPC Communication (FlexC) ............................................................................................................................................. 10
4.2.1 SPC Panel - FlexC Settings. ........................................................................................................................................................................................10
4.2.2 SPC Bridge - SPC Communication Settings .........................................................................................................................................................11
4.3 SPC Communication Test ................................................................................................................................................... 12
4.4 KNX Interface Info (Programming Mode) .................................................................................................................. 12
4.5 KNX Scenes ............................................................................................................................................................................... 13
4.6 KNX Datapoints ...................................................................................................................................................................... 14
4.7 System Info............................................................................................................................................................................... 14
4.8 System User.............................................................................................................................................................................. 15
5ETS KNX CONFIGURATION.............................................................................................................16
5.1 First Time Configuration .................................................................................................................................................... 16
5.2 Communication Objects...................................................................................................................................................... 16
5.2.1 KNX Datapoint Map......................................................................................................................................................................................................16
5.2.2 Global System Objects.................................................................................................................................................................................................17
5.2.3 SPC Area Commands ...................................................................................................................................................................................................17
5.2.4 SPC Zone Commands...................................................................................................................................................................................................18
5.2.5 SPC Area Status Objects .............................................................................................................................................................................................19
5.2.6 SPC Zone Status .............................................................................................................................................................................................................20
6ADVANCED USERS.............................................................................................................................21
6.1 Backup of Configuration Settings ................................................................................................................................... 21
6.2 Upgrading software .............................................................................................................................................................. 21
6.3 SSH Access ................................................................................................................................................................................ 21
6.4 Resetting the SPC Bridge .................................................................................................................................................... 21
7APPENDICES .......................................................................................................................................22

© 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 KNX User Manual
Revision
1.0
Page
4 of 25
Reference
2020-111
7.1 SPC Command Error Codes ............................................................................................................................................... 22
7.2 End-User License Agreement for SPC Bridge (EULA) ........................................................................................... 24
7.3 Open Source Software ......................................................................................................................................................... 25
7.4 Open Source Hardware ....................................................................................................................................................... 25

© 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 KNX User Manual
Revision
1.0
Page
5 of 25
Reference
2020-111
1Introduction
1.1 SPC Bridge KNX
SPC Bridge
Weinzierl KNX interface 332
Weinzierl KNX interface 312
SPC Bridge KNX allows interfacing Vanderbilt SPC intrusion system to a KNX system. Using the SPC
Bridge you are able to use events from all your SPC connected motion detectors, door/window
contacts, fire detectors and alarm status for automations in your KNX system. SPC Bridge KNX
includes a certified Weinzierl KNX interface (332 or 312) for a reliable and approved connection to
the KNX bus.
1.2 Main Features
Mirrors SPC zone and area states/status to KNX bus
Support for area and zone commands from KNX bus, e.g arm/disarm, inhibit zone.
SPC Panel Communication using FlexC
Weinzierl KNX interface 332 or 312
Communication objects configurable in KNX ETS.
Web based Admin GUI
Recommended for maximum 128 zones and 16 areas (The actual limit depends on the use case,
e.g. how many motion detectors the SPC system has.)
1.3 Hardware Specification
SPC Bridge
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
Weinzierl KNX interface 332
Mechanical
Housing: plastic transparent, Dimensions: 58 mm x 12 mm x 18 mm

© 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 KNX User Manual
Revision
1.0
Page
6 of 25
Reference
2020-111
Indicators
LED (multicolor) for USB, LED (multicolor) for KNX
KNX
Medium TP, Interface protocol HID/xEMI, APDU length: 55,, Object Server: BAOS V2, Device model:
System B
Power supply
USB < 10 mA, KNX < 3 mA
Connectors
KNX via pluggable screw terminal, USB connector type A
Compatibility
ETS (Engineering Tool Software) ETS4 or later
Weinzierl KNX interface 312
Mechanical
Housing: plastic, DIN rail mounted device, width: 1TE
Indicators
LED (multicolor) for USB, LED (multicolor) for KNX
KNX
Medium TP, Long Frame, Object Server: BAOS V2, Device model: System B
Power supply
USB < 15 mA, KNX < 3 mA
Connectors
KNX connector, USB connector type B
Compatibility
ETS (Engineering Tool Software) ETS4 or later

© 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 KNX User Manual
Revision
1.0
Page
7 of 25
Reference
2020-111
2Installation
2.1 Prerequisites
Vanderbilt SPC panel with firmware >= 3.6 (3.6 was the first version with support for FlexC)
Network router with DHCP server enabled
SPC Bridge and SPC panel connected to same local network
Internet access (to be able to use time synchronization via NTP)
KNX system
KNX configuration tool ETS v 5
2.2 First Time Installation Workflow
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 the included KNX interface, Weinzierl 332 or 312, to the SPC Bridge USB port.
3. Connect the KNX bus cable to the KNX bus connector on the KNX interface. NOTE! The default
individual device address of the KNX interface is 15.15.255. If this address already is in use you should
change the address (see section KNX Interface Info) before you connect the interface to the KNX-bus.
4. Connect the SPC Bridge LAN port, with a regular network cable, to your network switch or router.
5. Power up the device by connecting the included power adapter to a wall socket and then to the SPC
Bridge.
6. Wait (~3 minutes) until the SPC Bridge has fully started.
7. Open a web browser and access your router (DHCP-server) to find the IP address assigned to the SPC
Bridge. Type the IP address in the web browser to go to the SPC Bridge sign in page.
8. Assign a static IP address to the SPC Bridge. Follow instructions in section System Administration,
Static IP Address.
9. Configure SPC communication. Follow the instructions in section SPC Bridge Configuration, SPC
Communication.
10. Test the SPC Communication. See SPC Communication Test.
11. Configure the KNX interface. Follow the instructions in ETS KNX 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 KNX User Manual
Revision
1.0
Page
8 of 25
Reference
2020-111
3System Administration
The SPC Bridge is based on a standard Linux platform, OpenWrt, that is very common on routers. The
System Administration Web GUI contains many settings intended only for advanced users. Only the
settings described in this section should be changed by normal users.
3.1 System Administration Login
Type IP address of the SPC Bridge in the web browser address field, go to SPC Bridge sign in page and
click on System Administration in the top bar.
This will open the OpenWRT sign in page. Enter username (root) and password (default: dragino) and
click on Login.
NOTE! To return to SPC Bridge sign in page you need to type the SPC Bridge IP address in the web
browser address field.

© 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 KNX User Manual
Revision
1.0
Page
9 of 25
Reference
2020-111
3.2 Static IP Address
Default will SPC Bridge use DHCP to get an IP Address. To be sure that the SPC Bridge keeps the IP
address after a network/router restart you should assign the SPC Bridge a static IP Address. In the
System Administration GUI, 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. NOTE! It is very important to
disable the DHCP server in the SPC Bridge to avoid conflict with your normal DHCP server.
6. Click on Save & Apply.
7. Redirect your browser to the new IP Address.
3.3 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.4 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 Administration
Web GUI and for ssh access to the device.
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 KNX User Manual
Revision
1.0
Page
10 of 25
Reference
2020-111
4SPC Bridge Configuration
4.1 SPC Bridge Sign In
Type IP address of the SPC Bridge in the web browser address field, go to SPC Bridge sign in page,
enter username (spcbridge) and password (default Spcbridge!) and click Login.
4.2 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.
4.2.1 SPC Panel - FlexC Settings.
Use Vanderbilt SPC Web interface and define the FlexC communication following this instructions:
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. (To be able to set a web password
you need to login as the user in the SPC web interface).
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 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