Skip to main content

Ksenia

The KSENIA lares 16IP/48IP/128IP are multi-area security systems. The integration with HSYCO can be accomplished via direct control through Ethernet connection.
The I/O Server has been tested on units with product revision 1.6.1247, web server firmware version 1.0.0.15 and HTML version 1.1.33 and 1.1.44.

HSYCO Configuration

Add a KSENIA I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

  • IP Address: host name or IP address of the panel
  • IP Port: TCP/IP port assigned to the panel's web server

Authentication

  • User: username to access the web server
  • Password: password to access the web server

High Availability

  • Shutdown when inactive: defaults to false.

Options

IDDefaultValuesDescription
startupeventsfalsetruegenerate IO events also during the driver’s start-up phase
falsestart generating events only after HSYCO is aligned with the current status of the system
pollinterval3n > 0the data acquisition interval, in seconds
logsize20n ≥ 0the number of log lines to display in the UI object
pin<pin_code>Default PIN code to be used for commands

Datapoints

N.B. All the write (W) commands require a PIN code. If the I/O Server option "pin" is set, this code will be used to execute all commands that do not specify a PIN code. To specify a PIN code with a command append it to the value after a dot ('.').

EVENTS Example for I/O Server with ID "ks":

# arm partition 1 using pin 123456:
... : IO ks.p1.armed = 1.123456
# arm partition 1 using pin specified in pin option (the command will fail if pin not specified):
... : IO ks.p1.armed = 1

IDValueR/WDescription
connectiononlineRconnection established
offlineRHSYCO can't connect to the panel
model<model_name>Rproduct name of the panel
revision<x.x.x>Rproduct revision number
webserverfw<x.x.x>Rweb server firmware version
webserverhtml<x.x.x>Rweb server HTML version
p<n>.name<name>Rname of partition <n>
z<n>.name<name>Rname of zone <n>
o<n>.name<name>Rname of output <n>
scen<n>.name<name>Rname of scenario <n>
clockreadWrequest the reading of the panel's date and time
<date_and_time>Rthe panel's clock is set to <date_and_time>. The value's format is "yyyy-MM-dd HH:mm:ss" (e.g. 2018-08-30 16:30:00). This datapoint is only updated after a request with the command "clock = read"
Wset the panel's clock to <date_and_time>. Use the format "yyyy-MM-dd HH:mm:ss"
bus.peripherals.ko0Rbus peripherals OK
1Rerror on bus peripherals
panel.tamper0Rpanel OK
1Rpanel tampered
battery.low0Rbattery OK
1Rbattery low
battery.bad0Rbattery OK
1Rbattery fault
battery.volt<v>Rbattery voltage
power.no0Rpower supplies OK
1Rat least one power supply not available
power.ko0Rpower supplies OK
1Rat least one power supply faulty
power.low0Rpower supplies OK
1Rat least one power supply with low voltage
power.volt<v>Rmain power supply voltage
gsm<n>.descr<descr>Rdescription of GSM peripheral <n>
gsm<n>.state<state>Rstate of GSM peripheral <n>. See below for possible state values
gsm<n>.network.ko0Rnetwork OK on GSM peripheral <n>
1Rno GSM/GPRS network on GSM peripheral <n>
pstn<n>.descr<descr>Rdescription of PSTN peripheral <n>
pstn<n>.state<state>Rstate of PSTN peripheral <n>. See below for possible state values
pstn<n>.network.ko0Rnetwork OK on PSTN peripheral <n>
1Rno PSTN network on PSTN peripheral <n>
ethernet.ko0Rethernet connection OK
1Rethernet not connected
bus.ko0RKs-bus OK
1RKs-bus fault
fuses.ko0Rfuses OK
1Rfuses fault
gemino<n>.descr<descr>Rdescription of gemino peripheral <n>
gemino<n>.state<state>Rstate of gemino peripheral <n>. See below for possible state values
pontis<n>.descr<descr>Rdescription of pontis peripheral <n>
pontis<n>.state<state>Rstate of pontis peripheral <n>. See below for possible state values
ergo<n>.descr<descr>Rdescription of ergo peripheral <n>
ergo<n>.state<state>Rstate of ergo peripheral <n>. See below for possible state values
auxy<n>.descr<descr>Rdescription of auxy peripheral <n>
auxy<n>.state<state>Rstate of auxy peripheral <n>. See below for possible state values
imago<n>.descr<descr>Rdescription of imago peripheral <n>
imago<n>.state<state>Rstate of imago peripheral <n>. See below for possible state values
radius<n>.descr<descr>Rdescription of radius peripheral <n>
radius<n>.state<state>Rstate of radius peripheral <n>. See below for possible state values
divide<n>.descr<descr>Rdescription of divide peripheral <n>
divide<n>.state<state>Rstate of divide peripheral <n>. See below for possible state values
volo<n>.descr<descr>Rdescription of volo peripheral <n>
volo<n>.state<state>Rstate of volo peripheral <n>. See below for possible state values
duo<n>.descr<descr>Rdescription of duo peripheral <n>
duo<n>.state<state>Rstate of duo peripheral <n>. See below for possible state values
opis<n>.descr<descr>Rdescription of opis peripheral <n>
opis<n>.state<state>Rstate of opis peripheral <n>. See below for possible state values
temp.in<val>Rmeasured indoor temperature
temp.out<val>Rmeasured outdoor temperature
gsm.signal<val>RGSM signal strength
gsm.sim<n>.credit<val>Ravailable credit on GSM sim <n>
gsm.sim<n>.exp<date_and_time>Rexpiration date of GSM sim <n> (format "yyyy-MM-dd HH:mm:ss")
armed0Rall partitions are disarmed
1Rat least one partition is armed
alarm0Rno partition is in alarm state
1Rat least one partition is in alarm state
p<n>.armed0Rpartition <n> is disarmed
Wdisarm partition <n>
1Rpartition <n> is armed
Warm partition <n>
immWarm partition <n> immediately
p<n>.alarm0Rpartition <n> no alarm
1Rpartition <n> alarm
p<n>.tamper0Rpartition <n> no tamper alarm
1Rpartition <n> tamper alarm
p<n>.exit0Rpartition <n> no exit time active
1Rpartition <n> in exit time
z<n>.bypass0Rzone <n> is not bypassed
Wunbypass zone <n>
1Rzone <n> is bypassed
Wbypass zone <n>
z<n>.open0Rzone <n> not open
1Rzone <n> open
z<n>.alarm0Rzone <n> no alarm
1Rzone <n> alarm
z<n>.alarm.mem0Rzone <n> no alarm memory
1Rzone <n> alarm memory
z<n>.tamper0Rzone <n> no tamper alarm
1Rzone <n> tamper alarm
z<n>.mask0Rzone <n> not masked
1Rzone <n> masked
o<n>0Routput <n> is off
Wturn off output <n>
1Routput <n> is on
Wturn on output <n>
scen<n>1Wset scenario <n>
Peripherals state values
ValueDescription
nono peripheral
no_comno communication with peripheral
no_progperipheral not programmed
sab_no_comtampered peripheral with no communication
sab_no_progtampered peripheral not programmed
sabtampered peripheral
okperipheral OK

User Interface

UISET Actions

IDAttribute
logvalue
log0value
connection.onlinevisibletruewhen datapoint connection = online
falsewhen datapoint connection = offline
connection.offlinevisibletruewhen datapoint connection = offline
falsewhen datapoint connection = online
<datapoint_id>.1visibletruewhen datapoint with ID <datapoint_id> has value '1'
falsewhen datapoint with ID <datapoint_id> has value '0'
<datapoint_id>.0visibletruewhen datapoint with ID <datapoint_id> has value '0'
falsewhen datapoint with ID <datapoint_id> has value '1'

USER Commands

All writable datapoints can be set from USER commands by setting the ID field to the corresponding datapoint's ID and the Param field to the required value.

Ksenia UI Object

The user interface for the Ksenia multi-area intrusion detection system:

Ksenia UI Object 1 Ksenia UI Object 2 Ksenia UI Object 3

The Ksenia object is listed in the Project Editor’s new object list only when at least one Ksenia I/O Server is defined.

Parameters

  • server id: the server ID. Supports
  • position: the object's position. Use the pixels or rows and columns coordinates format

Log Files

If a Ksenia anti-intrusion unit is connected to HSYCO, the security.log file will be written in the same directories as the daily log files.

This file is never overwritten or deleted from HSYCO SERVER.

2018.02.20 16:59:28.516 - ks - 20/02/2018 16:56:36 - Disinserimento - Part 1 - U1
2018.02.20 17:00:24.527 - ks - 20/02/2018 16:57:36 - Inserimento - Part 1 - U1
2018.02.20 17:00:44.318 - ks - 20/02/2018 16:57:57 - Allarme - Zone 1
2018.02.20 17:00:49.241 - ks - 20/02/2018 16:57:58 - Ripristino - Zone 1
2018.02.20 17:00:54.043 - ks - 20/02/2018 16:58:06 - Disinserimento - Part 1 - U1
2018.02.20 17:01:18.905 - ks - 20/02/2018 16:58:29 - Fallita Comunicazione - Leonardo - Vocale GSM
2018.02.20 17:01:29.053 - ks - 20/02/2018 16:58:40 - Fallita Comunicazione - Leonardo - SMS

Other information about the Ksenia driver are stored in the message.log daily file.

Release Notes

3.8.0

  • Bug fix: this I/O Server was considered as a regular I/O Server instead of a security system (SEC) when matching the license limits

3.7.0

  • initial version release

Ksenia is a registered trademark of Ksenia Security s.r.l.