Eelectron IPSBA01KNX User manual

USER MANUAL
Translation of the original instructions
Version: 1.0
Date: 06/06/2023
IPSBA01KNX Knx bridge with ip interface and power supply knx + aux 640ma + MQTT

IPSBA01KNX
2IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
Index
1. Introduction to the user manual ................................................................................................................................................4
Meaning of the symbols used ................................................................................................................................................. 4
2. Product overview ......................................................................................................................................................................4
3. Installation instructions ..............................................................................................................................................................4
4. Congurationandcommissioning.............................................................................................................................................5
5. General parameters ..................................................................................................................................................................5
General settings...................................................................................................................................................................... 5
Surveillanceconguration....................................................................................................................................................... 6
Logicsconguration................................................................................................................................................................ 6
Networkconguration ............................................................................................................................................................. 6
6. Diagnostic .................................................................................................................................................................................7
7. Surveillance ..............................................................................................................................................................................7
8. Timer ......................................................................................................................................................................................... 7
9. Logics ........................................................................................................................................................................................7
10. MQTT ........................................................................................................................................................................................7
11. Behaviour on bus failure, recovery and download ................................................................................................................... 7
Behaviour on bus voltage failure ............................................................................................................................................ 7
Behaviour on bus voltage recovery ........................................................................................................................................ 7
Wrong application download................................................................................................................................................... 7
VERSION DATE CHANGES
1.0 06/06/2023 -

IPSBA01KNX
3IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
Any information inside this manual can be changed without ad-
vice.
This handbook can be download freely from the website:
www.eelectron.com
Exclusion of liability:
Despite checking that the contents of this document match the
hardware and software, deviations cannot be completely exclu-
ded. We therefore cannot accept any liability for this.
Any necessary corrections will be incorporated into newer ver-
sions of this manual.
Eelectron S.p.A.
Via Claudio Monteverdi 6, I-20025 Legnano (MI), Italia
Tel [phone] [email protected]

IPSBA01KNX
4IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
1. Introduction to the user manual
This manual is intended for use by KNX installers and describes
functions and parameters of the IPSBA01KNX device and how
thesettingsandcongurationscanbechangedusingtheETS
software tool.
For the technical data of the device and the compatible accesso-
ries, please refer to the datasheet of the device itself.
Meaning of the symbols used
WARNING - The operation or phase described must be
carried out in compliance with the instructions provided
and with the safety standards.
IMPORTANT NOTE - Detailsandspecicationstobere-
spected for the correct functioning of the device.
2. Product overview
The IPSBA01KNX device integrates a KNX power supply with
auxiliary output with a a total current of 640mA, and an IP inter-
face, allowing KNX installations to be implemented quickly and
e󰀩ciently.
The voltage of the bus output as well as that of the auxiliary
output is 29V DC.
The IP address can be obtained via DHCP server or manually
conguredviaETS®.
ThedeviceworksinaccordancewiththeKNXnet/IPspecica-
tions;upto5di󰀨erentIPaddressescanbeassigned.Thedevice
is also a KNX bus node, with its own application program and
canbeconguredwithETS®tocommunicateusingKNX Data
Secure protocol.
The device integrates the MQTT protocol which can manage
publications and subscriptions of a server up to 160 objects. By
enablingthespecicparameteronETS,theMQTTversionwith
TLS is available, which features mutual authentication based on
certicate (server and device) and encryption. The purpose of
thecerticateistoguaranteetheidentityoftheserver(broker),
oftheclient(bridge)andtotransmitdatainasecureway.
The uploading of the certicates is managed by the software
“EelectronCerticateLoader”propertyofeelectron.Pleaserefer
tothespecicusermanual“EelectronCerticateLoader”.
ByenablingtheETS“Other power supplies on the BUS line”
parameter, it is possible to install two devices on the same bus
line, at a minimum distance of 200 metres.
Moreover, 48 logic blocks are available to implement simple ex-
pressions with logical or threshold operator or complex expres-
sions with algebraic and conditional operators; It is possible to
usepredened algorithmsas proportionalcontrolsof tempera-
ture and humidity or dew point calculation.
The device also integrates the “Virtual Holder Logic”;theeld
of application is the hotel room: through a magnetic sensor in-
stalled on the door and connected to a digital input, accurate
presence information is managed. The presence detection solu-
tion can deduce the presence of people in the room using one or
more dedicated sensors. It also detects an unexpected presence
andisabletodi󰀨erentiatemorebehaviors.
It is also implemented the control logic called “OnLine-O󰀨Line”
that checks if all KNX TP devices of the subnet connected to the
powersupplyare operating“On Line”,alerting thebackboneif
oneofthemgoesinto“O󰀨Line”status.
OnthedevicetherearepushbuttonsandsignalingLEDsforbus
reset operations as well as for Factory Reset or for displaying
activity on the KNX bus and on the IP backbone.
The device is compact, with a size of only 4 DIN modules and
is intended for installation on DIN bar in LV distribution switch-
boards.
3. Installation instructions
The device can be used for permanent internal installations in
dry places.
WARNING
• When a clear separation between the low voltage (SELV)
andthedangerousvoltage(230V)isNOTpossible,thede-
vice must be installed maintaining a minimum guaranteed
distance of 4 mm between the dangerous voltage lines or
cables (230V not SELV) and the cables connected to the
EIB/KNXBUS(SELV).
• The device must be mounted and commissioned by an au-
thorized installer.
• The applicable safety and accident prevention regulations
must be observed.
• The device must not be opened. Any faulty devices should
be returned to manufacturer.
• For planning and construction of electric installations, the re-
levant guidelines, regulations and standards of the respecti-
ve country are to be considered.
• KNX bus allows you to remotely send commands to the
system actuators. Always make sure that the execution of
remote commands do not lead to hazardous situations, and
that the user always has a warning about which commands
can be activated remotely.
For more information: www.eelectron.com.

IPSBA01KNX
5IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
4. Conguration and commissioning
Thecongurationandcommissioningofthedeviceismadewith
theETS®(EngineeringToolSoftware).Forthecongurationof
the device parameters the corresponding application program or
thewholeeelectron® product database must be loaded in the
ETS®program.
The commissioning of the device requires the following steps:
• connectthebusKNX(1)
• turn on the bus power supply
• press the programming button (2); the red programming
LEDturnsON
• download into the device the physical address and the con-
gurationwiththeETS®program
5. General parameters
InETS®,inthedropdownmenuofthedevicethegeneralpa-
rameters consist of four conguration blocks, described in the
next paragraphs.
General settings
Communication objects involved:
“<General>Heartbeat” 1 Bit CRT
“<General>PowerOnEvent” 1 Bit CRT
“<General>InputDate” 3 Bytes CWTU
“<General>InputTime” 3 Bytes CWTU
“<General>OutputDate” 3 Bytes CRT
“<General>OutputTime” 3 Bytes CRT
“<General>IPInterface” 1 Bit CW
“<General>ResetBUS” 1 Bit CW
“<General>PrimaryHeartbeat” 1 Bit CW
“<General>PrimaryAlarm” 1 Bit CRT
PARAMETRO KNX IMPOSTAZIONI
Delay to send telegrams on
power-up 5 ÷ 15 secondi
Through this parameter it is possible to set the telegram transmission
delay after switch-on by selecting the time beyond which the device is
authorized to send telegrams.
In large systems after a power outage or shutdown, this delay avoids
generatingexcessivetra󰀩conthebus,causingslowperformanceor
a transmission crash.
If there are several devices that require telegrams to be sent on the
busafterareset,thesedelaysmustbeprogrammedtopreventtra󰀩c
congestion during the initialization phase.
Input detection and object values are updated at the end of the trans-
mission delay time
AttheendofETSprogramming,thedevicebehavesasitdidafterit
was switched on.
Other power supplies on the
BUS line no / yes
By enabling this parameter it’s possible to install two devices on the
same bus line, at a minimum distance of 200 metres.
Heartbeat
(periodic alive notication)
nothing
periodic
on request
The parameter allows you to notify a hierarchically superior control
or supervision system of your existence / correct online activity. The
noticationcantakeplacespontaneously(periodically-settableperi-
odvalue)orfollowingaquery(uponrequest).Thevalueofthe1-bit
noticationtelegramcanbeset.
Telegram value o󰀨/on/toggle
Denesthevalueofthe1bitnoticationtelegram.Thetogglevalueis
notavailablefor“ondemand”conguration.
Period - time unit seconds / minutes / hours
Denestheunitofmeasureofthenoticationtimeinterval.Thispa-
rameterisnotavailableforthe“ondemand”conguration.
Period - time value 1 ... 255
Denesthe noticationintervaltime.This parameterisnotavailable
forthe“ondemand”conguration.
Date and time source for timers fromBUS/fromNTPserver
DeneswetherthetimedataaretakenfromtheBUSlineortheNTP
server.
Request time at power ON no / yes
IncaseofdateandtimedatasourcingfroBUS,thisparameterpermits
to enable a time request at power ON.
Output date objects Date and Time / DateTime
Denes whether the relay outputs are managed individually or cou-
pled.
Cyclic send time
never / every minute / every 30
minutes / every hour / every 6
hours / every 12 hours / every
day
Set the period of cyclical sending.
Timezone mode custom / standard
In custom mode it is possible to set manually the coordinates
In standard mode the location is chosen from the drop down menu.
IP interface always enabled / bus controlled
With this parameter it is possible to set how to manage the IP interface
function.
+-
KNX BUS
NL
+-
AUX 29V DC
LAN
IPSBA01KNX
PSU WITH IP INTERFACE
RESET POWER
OVERLOAD
ADDRESS
PROG.
TP LAN FACTORY RESET
STATUS
iBUS + iAUX ≤ 640mA
BUS 29V DC
180 - 265V AC
AUX 29V DC
50/60Hz
2
1

IPSBA01KNX
6IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
Bus controlled
Initial enable state disabled / enabled
Itdenes the initial state of the IPinterface function when bus con-
trolled.
Enable activation telegram telegram“0”/telegram“1”
Itdenes the telegram sent totheobject “<General>IPInterface” to
enable the function.
Automatic deactivation time
(0=never) [min] 0 ... 255
Itdenestheautomatictimeafterwhichthefunctionisdeactivated.
Reset BUS object disabled / enabled
With this parameter it’s possible to enable the object “<General> Re-
setBUS”.
Telegram for reset telegram“0”/telegram“1”
Itdenesthetelegramsenttotheobject“<General>ResetBUS”to
enable the reset.
Additional function x
4 logics
20 MQTT channels
1 virtual holder
With this parameter it is possible to enable this functions:
4 logics-see“Logic”usermanual
20 MQTT channels -
1 virtual holder - is a logical function that automatically recognizes the
presence of a person in a room. This function can be used in hotels
orsimilarinstallationsandrequiresconnectiontootherdevices(see
“Virtual Holder”).
Surveillance conguration
Communication objects involved:
“<General>Alarms0-15” 4 bytes CRT
“<General>Alarms16-31” 4 bytes CRT
“<General>Alarms32-47” 4 bytes CRT
“<General>Alarms48-63” 4 bytes CRT
“<General>Alarms64-79” 4 bytes CRT
“<General>Alarms80-95” 4 bytes CRT
“<General>Alarms96-111” 4 bytes CRT
“<General>Alarms112-127” 4 bytes CRT
These objects are used to sum up the alarm status of the relative sur-
veillance channels.
KNX PARAMETER SETTINGS
Physical address main line 0 .. 255
This parameter denes the physical main address of the surveilled
devices(e.g.10.13.x-->10).
Physical address sub line 0 .. 255
Thisparameterdenesthephysicalsubaddressofthesurveilledde-
vices(e.g.10.13.x-->13).
Alarm time - hours 0 ... 255
Thisparameterdenesthesurveillance time (hours) beforesending
thealarm.Usedbythesurveillancemoduleswhenthealarmfunction
is enabled.
Alarm time - minutes 0 ... 255
Thisparameterdenesthesurveillancetime(minutes)beforesending
thealarm.Usedbythesurveillancemoduleswhenthealarmfunction
is enabled.
Warning time - seconds 20 ... 255
Thisparameterdenesthewarningtime(seconds).Thistimeindicates
how much before the end of the surveillance time a group value read is
sentonthebusthroughthe“WarningReadRequest”object.Usedby
the surveillance modules when the warning function is enabled.
Surveillance priority primary / secondary
Thisparameterdenesifthedeviceistheprimarysurveillancedevice
or if it is the secondary one. If secondary is selected, the heartbeat
period of the primary device must be aligned to the one of the primary
device itself. If no message is received in the period an alarm message
issent onthe object “<General> PrimaryAlarm” and the secondary
device starts to surveil the plant.
Primary period - time unit seconds / minutes / hours
ThisparameterdenestheunitofmeasuresofthePrimaryHeartbeat
period.
Primary period - time value 1 ... 255
Thisparameter denes thetime interval forsending the “<General>
PrimaryHeartbeat”object.
Number of surveillances 16, 32, 48, 64, 80, 96, 112, 128
Thisparameterdenesthenumberofsurveillancemodules.
Logics conguration
Communication objects involved:
“<General>Enable/DisableAllLogics” 1 Bit CW
“<General>Enable/DisableLogicx” 1 Bit CW
KNX PARAMETER SETTINGS
Logic activation telegram telegram“0”/telegram“1”
Denesthetelegramsentontheobject“<General>Enable/DisableAll
Logics”toenablethelogicfunction.
Logic x enabled/disabled state
after download disabled / enabled
Thisparameter denes thevalue set for object ““<General>Enable/
DisableLogicx”afteradownload.
Logic x enable/disable object do not use / use
Withthisparameterit’spossibletousetheobject“<General>Enable/
DisableLogicx”.
Network conguration
This function allows the device to communicate with the DNS
(DomainNameSystem)andNTP(NetworkTimeProtocol)ser-
vices,tobeconsideredmandatoryfortheETSIPconguration.
To guarantee the correct functioning of the validation of the secu-
ritycerticatesandtheidentityofthebrokertowhichtoconnect
with the MQTT service, the device must reach the NTP and DNS
services.
In addition to the MQTT part, the NTP service is required to use
the object dedicated to sending the date and time via KNX.
Communication objects involved:
“<General>AlarmDHCP” 1 Bit CRT
“<General>AlarmPing” 1 Bit CRT
“<General>AlarmDNSResolution” 1 Bit CRT
“<General>AlarmNTP” 1 Bit CRT

IPSBA01KNX
7IPSBA01KNXFI00020100_UM_EN_1.0
MEMBER
“<General>Alarm4Bytes” 4 Bytes CRT
“<General>AlarmText” 14 Bytes CRT
KNX PARAMETER SETTINGS
DNS 1 address max 15 bytes
Withthis parameter (Domain Name System) it’s possible to convert
awebaddressinanIPaddresswhichuniquelyidentiesthedevice.
DNS 2 address max 15 bytes
This parameter it’s used in case of failure of DNS 1.
DHCP alarm disabled / enabled
Thisparameter(DynamicHostCongurationProtocol)isusedtoas-
signIPaddresses andothernetwork congurations automatically to
devices that connect to a network.
This parameter allows a message to be sent to the bus which warns
whether or not the protocol has correctly released the IP address to
the device.
Alarm telegram telegram“0”/telegram“1”
It denes the value sent to the object “<General>Alarm DHCP” to
activate the alarm.
Cycling ping alarm disabled / enabled
Ping is a command that is used to verify the network connection be-
tween two devices. Ping works by sending a packet of data from one
device to another.
Ping is often used to check if a given IP address or hostname is reach-
able across a network connection. For example, you can use ping to
check if a server is able to respond to connection requests or to diag-
nose network connection problems.
This parameter allows a message to be sent to the bus which warns if
the IP address/DNS has responded correctly to the request.
Address to ping max. 32 bytes allowed
ItdenestheIPaddress/DNSthedevicewillconnectto.
Alarm telegram telegram“0”/telegram“1”
Itdenesthevaluesenttotheobject“<General>AlarmPing”toacti-
vate the alarm.
Cyclic time [min] 1 ... 60
Itdenesthetimeintervalforpingrequest.
DNS resolution alarm disabled / enabled
This parameter allows a message to be sent to the bus which warns if
atleastoneoftheconguredDNSfunctionscorrectly(seeDNS1/2).
Domain name max. 32 bytes
ItdenesthenameoftheIPaddress/DNStoresolve.
Alarm telegram telegram“0”/telegram“1”
Itdenesthevaluesenttotheobject“<General>AlarmDNSResolu-
tion”toactivatethealarm.
Server x (1- 4) max. 32 bytes
NetworkTimeProtocol(NTP)isanetworkprotocolthatisusedtosyn-
chronize the system time of a device on the network with a time server.
We have 4 servers available to ensure time synchronization, if server
1 fails the request is passed to 2 and so on up to 4.
NTP alarm disabled / enabled
This parameter allows a message to be sent to the bus which warns
ifat least 1 of the congured NTPservers is working correctly(see
Server1/2/3/4).
Alarm telegram telegram“0”/telegram“1”
Itdenesthevaluesenttotheobject“<General>AlarmNTP”toacti-
vate the alarm.
Alarm 4 bytes disabled / enabled
This parameter enable the object “<General>Alarm 4 Bytes” which
sendstotheBUSabitmaskcontainingthenetworkerrors.
Alarm text disabled / enabled
Thisparameterenabletheobject“<General>AlarmText”whichsends
atextstringcontainingnetworkerrorstotheBUS.
6. Diagnostic
Please refer to the “Diagnostic”usermanual.
7. Surveillance
Please refer to the “Surveillance”usermanual.
8. Timer
Please refer to the “Timer”usermanual.
9. Logics
Please refer to the “Logics”usermanual.
In the devices described, the logical expression can
have a maximum of 24 characters.
10.MQTT
Please refer to the “MQTT”usermanual.
11.Behaviour on bus failure, recovery and
download
Behaviour on bus voltage failure
On failure of bus voltage, it’s possible to set an action to execute
in case of independent relays. Behaviour of controlled actuators
must be set using their own parameters.
Behaviour on bus voltage recovery
On bus voltage recovery all the communication objects are set
to0exceptforobjectsforwhichaparameterisdenedforthe
initial value.
Wrong application download
If the wrong ETS application is downloaded then KNX/EIB led
starts blinking and device is not operative on the bus. A power re-
setmustbedoneorthecorrectETSapplicationmustbedownlo-
aded.