KNX LogicMachine3 Re:actor User manual
1
LogicMachine3 Re:actor
Product Manual
Document Issue 1.0
June, 2013
Technical Support:
2
Copyright
Copyright © 2011 Embedded Systems SIA. All Rights Reserved.
Notice
Embedded Systems SIA., reserves the right to modify the information contained herein as
necessary. Embedded Systems SIA assumes no responsibility for any errors which may appear in
this document. Information in this document is provided solely to enable system and software
implementers to use KNX/EIB Logic Machine product.
Trademarks
LogicMachine is a trademark of Embedded Systems SIA.All other names and trademarks are the
property of their respective owners and are hereby acknowledged.
Introduction
Logic Machine is your easiest way to program complex logic in KNX/EIB, Modbus, BACnet,
EnOcean networks. The Logic Machine will enable you to efficiently customize building
automation processes, easily delivering unlimited flexibility benefit to end users in a cost-
effective way.
Logic Machine is an embedded platform with integrated TPUART, Ethernet, USB interfaces.
Logic Machine allows to use it as IP Router, cross-standard gateway, logic engine, visualization
WEB SCADAserver. Scripting templates provides user-friendly, flexible configuration interface.
Via applying custom scripts the Logic Machine can simultaneously act as thermostat, security
panel, lighting controller, etc
Technical support
Any faulty devices should be returned to Embedded Systems.
If there are any further technical questions concerning the product please contact our support,
Firmware updates are available at www.openrb.com
3
Caution
Security advice
The installation and assembly of electrical equipment may only be performed by skilled
electrician. The devices must not be used in any relation with equipment that supports, directly
or indirectly, human health or life or with application that can result danger of people, animals or
real value
Mounting advice
The devices are supplied in operational status. The cables connections included can be clamped
to the housing if required.
Electrical connection
The devices are constructed for the operation of protective low voltage (SELV). Grounding of
device is not needed. When switching the power supply on or off, power surges must be avoided.
4
Contents
DEVICE SPECIFICATION.......................................................................................................................................7
TERMINAL CONNECTION SCHEMES ..............................................................................................................10
FACTORY DEFAULT, DISCOVER IP .................................................................................................................18
STANDARDS SUPPORTED ...................................................................................................................................18
QUICK STARTUP GUIDE......................................................................................................................................20
DEFAULT IP CONFIGURATION..................................................................................................................................20
DISCOVER LOGIC MACHINE IP ADDRESS.................................................................................................................22
FIRMWARE UPGRADE...............................................................................................................................................23
LOGIC MACHINE FOR KNX/EIB NETWORK CONFIGURATION MANAGEMENT WITH ETS .........................................24
KNX AND IP ROUTER SETTINGS..............................................................................................................................27
QUICK GUIDE -CREATE VISUALIZATION FOR IPAD/PC.............................................................................................31
GRAPHICAL USER INTERFACE LOGIN ..........................................................................................................36
1. LOGIC MACHINE CONFIGURATION ...........................................................................................................37
1.1. REACTOR ..................................................................................................................................................38
1.1.1. Digital output.......................................................................................................................................39
1.1.2. Analog output ......................................................................................................................................41
1.1.3. Resistive input......................................................................................................................................42
1.1.4. Analog input ........................................................................................................................................43
1.2. SCRIPTING ........................................................................................................................................................47
1.1.1. Adding a new script .............................................................................................................................47
1.1.2. Event-based scripting ..........................................................................................................................50
1.2.3. Resident scripting ................................................................................................................................51
1.2.4. Scheduled scripting..............................................................................................................................51
1.2.5. Script editor .........................................................................................................................................51
1.2.6. Object functions...................................................................................................................................52
1.2.7. Returned object functions, group communication functions................................................................53
1.2.8. Group communication functions..........................................................................................................54
1.2.9. Object function examples.....................................................................................................................54
1.2.10. Data type functions, data types.......................................................................................................55
1.2.11. Data types .......................................................................................................................................55
1.2.12. Data storage function .....................................................................................................................56
1.2.13. Alert function ..................................................................................................................................57
1.2.14. Log function....................................................................................................................................57
1.2.15. Scheduled scripting date/time format .............................................................................................58
1.2.16. Time function ..................................................................................................................................58
1.2.17. Data Serialization ...........................................................................................................................58
1.2.18. String functions...............................................................................................................................59
1.2.19. Input and output functions ..............................................................................................................64
1.2.20. Script control functions...................................................................................................................64
1.2.21. JSON library...................................................................................................................................65
1.2.22. Conversion......................................................................................................................................65
1.2.23. Bit operators ...................................................................................................................................66
1.2.24. Input and Output Facilities.............................................................................................................67
1.2.25. Mathematical functions...................................................................................................................68
1.2.26. Table manipulations .......................................................................................................................70
1.2.27. Operating system facilities..............................................................................................................70
1.2.28. Extended function library ...............................................................................................................72
1.2.29. User libraries..................................................................................................................................73
1.2.30. Common functions ..........................................................................................................................74
1.2.31. Start-up (init) script ........................................................................................................................74
1.2.32. Tools ...............................................................................................................................................74
1.3. OBJECTS....................................................................................................................................................76
1.3.1. Object parameters ...............................................................................................................................76
1.3.2. Object visualization parameters ..........................................................................................................77
1.3.3. Change the object state........................................................................................................................78
1.3.5. Object control bar ...............................................................................................................................79
5
1.3.6. Filter objects........................................................................................................................................79
1.4. OBJECT LOGS ............................................................................................................................................80
1.4.1. Export logs...........................................................................................................................................81
1.5. SCHEDULERS.............................................................................................................................................84
1.5.1. Add new scheduler...............................................................................................................................84
1.5.2. Scheduler events ..................................................................................................................................85
1.5.3. Scheduler holidays...............................................................................................................................85
1.6. TREND LOGS..............................................................................................................................................86
1.6.1. Add new trend log................................................................................................................................86
1.7. VISUALIZATION STRUCTURE .....................................................................................................................87
1.7.1. Layouts / Widgets.................................................................................................................................89
1.8. VISUALIZATION.........................................................................................................................................91
1.8.1. Plan editor ...........................................................................................................................................91
1.8.2. Object ..................................................................................................................................................93
1.8.3. Plan link...............................................................................................................................................94
1.8.4. Camera ................................................................................................................................................94
1.8.5. Graph...................................................................................................................................................96
1.8.6. Text Label ............................................................................................................................................97
1.8.7. Image ...................................................................................................................................................98
1.8.8. Gauge ..................................................................................................................................................98
1.8.9. Frame ..................................................................................................................................................99
1.9. VIS.GRAPHICS.........................................................................................................................................100
1.10. UTILITIES ................................................................................................................................................102
1.11. ALERTS ...................................................................................................................................................105
1.12. ERROR LOG .............................................................................................................................................106
1.13. LOGS .......................................................................................................................................................106
1.14. HELP .......................................................................................................................................................108
2. USER MODE VISUALIZATION ................................................................................................................109
2.1. CUSTOM DESIGN USERMODE VISUALIZATION .........................................................................................110
3. TOUCH VISUALIZATION .........................................................................................................................110
4. SYSTEM CONFIGURATION .....................................................................................................................112
4.1. CHANGING PASSWORD ............................................................................................................................112
4.2. PACKAGES...............................................................................................................................................113
4.3. UPGRADE FIRMWARE ..............................................................................................................................114
4.4. REBOOT LOGIC MACHINE .......................................................................................................................114
4.5. SHUTDOWN LOGIC MACHINE..................................................................................................................114
4.6. INTERFACE CONFIGURATION ...................................................................................................................115
4.6.1. Ethernet interface data throughput graph .........................................................................................116
4.7. ROUTING TABLE .....................................................................................................................................117
4.7.1. Dynamic routes..................................................................................................................................117
4.7.2. Static routes .......................................................................................................................................117
4.8. ARP TABLE .............................................................................................................................................118
4.9. FTP SERVER ............................................................................................................................................118
4.10. SYSTEM MONITORING .............................................................................................................................119
4.11. NTP CLIENT ............................................................................................................................................119
4.12. SYSTEM STATUS ......................................................................................................................................120
4.13. NETWORK STATUS ..................................................................................................................................120
4.14. NETWORK UTILITIES ...............................................................................................................................121
4.15. SYSTEM LOG ...........................................................................................................................................121
4.16. RUNNING PROCESSES ..............................................................................................................................122
5. USER MODE SCHEDULERS .....................................................................................................................123
5.1. EVENTS ...................................................................................................................................................123
5.2. HOLIDAYS ...............................................................................................................................................124
6. TREND LOGS ...............................................................................................................................................125
7. MODBUS RTU/TCP INTERCONNECTION WITH LM2 .......................................................................127
7.1. MASTER FUNCTIONS................................................................................................................................127
7.2. VISUALIZING MODBUS OBJECTS..............................................................................................................128
6
7.3. USAGE EXAMPLE (MODBUS TCP)...........................................................................................................128
7.4. USAGE EXAMPLE (MODBUS RTU) ..........................................................................................................129
7.5. MODBUS SLAVE EXAMPLES ....................................................................................................................130
7.6. MODBUS WORKING WITH SEVERAL SLAVES ON THE SAME RS485 CONNECTION .....................................133
6. BACNETIP INTERCONNECTION WITH LM2 ......................................................................................136
7. ENOCEAN INTERCONNECTION WITH REACTOR ...........................................................................138
7.1. ENOCEAN INTERFACES ...........................................................................................................................138
7.2. ENOCEANTO KNX MAPPING...................................................................................................................138
7.3. KNX TO ENOCEAN MAPPING ..................................................................................................................140
8. DMX INTERCONNECTION WITH LM2 .................................................................................................142
8.1. EXAMPLES ..............................................................................................................................................144
9. 3GMODEM CONNECTION WITH LM2 ..................................................................................................146
9.1. EXAMPLES ..............................................................................................................................................146
9.2. SMS HANDLER PROGRAM .......................................................................................................................146
9.3. SEND SMS MESSAGES TO SPECIFIC SIM NUMBERS AFTER GROUP-READ OR GROUP-WRITE IS TRIGGERED
148
10. HDL PROTOCOL INTEGRATION IN LOGIC MACHINE 3 ................................................................150
10.1. HDL FUNCTION.......................................................................................................................................150
10.2. USAGE EXAMPLE –HDL DIMMER CONTROL ...........................................................................................152
10.3. USAGE EXAMPLE –HDL RELAY CONTROL..............................................................................................152
11. COMMUNICATION WITH RS232/RS485 SERIAL PORTS ..................................................................154
12. OBJECT VALUE EXPORT VIA XML ......................................................................................................156
12.1. ALERTS,ERRORS VALUES .......................................................................................................................158
13. READ ALERTS RSS FEEDS FROM LOGIC MACHINE .......................................................................159
7
Device specification
Application
Logical functions; WEB SCADA visualization for PC and touch-devices; cross-standard
gateway between KNXnet/IP, Modbus TCP/IP, Modbus RTU, BACnet MS/TP, BACnet IP,
EnOcean, HDL, GSM and other protocols; integration with third party devices over RS232 or
RS485 serial ports – DALI, AV, IR; Data logger with trends; HVAC
Types of product
Re:actor LM3-REACTOR
Standards and norms compliance
CE conformity: EMBS-CE-111231/01
EMC: EN61000-6-1
EN61000-6-3
PCT Certificate
Technical data:
Power supply: 7-36V DC
Power consummation: 1.5W
Interface: EnOcean 868MHz 1
10BaseT/100BaseTX 1
RS485 2
USB2.0 1
TPUART2 KNX/EIB compatible
Digital output 16 (380 mA continues current
on output). Optoislated from
KNX/EIB bus. Additional
24V power source is
supported.
Resistive sensor inputs 6 (PT100, PT1000,
0 Ω...20M Ω)
Analog/binary inputs 7 (0-30V with configurable
threshold voltage, 12bit
resolution)
Analog outputs 2 (0-10V, 12bit resolution,
20mA max current)
Connections: KNX bus: Bus Connection Terminal
0.8mm2
Power supply: Clamp, 1.5mm2
8
Serial: Clam, 1.5mm2
IO: Clam, 1.5mm2
Operating elements LED 1 – CPU load
1 - Activity
Enclosure: Material: Polyamide
Color: Gray
Dimensions: 104(W)x90(H)x51(L) mm
Usage temperature: -5C ... +45C
Storage temperature: -25C ... +55C
Weight: 150g
Warranty: 2 years
Warranty: 2 years
9
LogicMachine3 Re:actor kit contains:
Embedded board with preinstalled software
Plastic DIN-rail case
868MHz antenna
4 x 8pin extension connectors
10
Terminal connection schemes
KNX TP
11
RS485
The EIA-485 differential line consists of two pins:
A aka '-' aka TxD-/RxD- aka inverting pin
B aka '+' aka TxD+/RxD+ aka non-inverting pin
12
24V power supply
13
Analog inputs (e.g. reed contact)
14
Analog inputs, 0-10V
15
Digital output
16
Resistive sensor input
17
Analog output
18
Factory default, discover IP
There is a reset button on the side of Logic Machine 2. You can either reboot the device by
pressing this button or reset the configuration to factory defaults:
•Press and hold for <10 sec – reboot the device
•Press and hold for >10 sec – reset networking with IP to factory default
•Press and hold for >10 sec and again press and hold for >10 sec – full reset of configuration
to factory defaults
There is also another possibility to discover IP address – LM3 has built-in zeroconf utility by
default, so using the following applications you can find out the IP:
•Windows PC – ServiceBrowser
•Linux PC – Avahi
•Android – ZeroConf Browser
•iOS – Discovery
For more info please see here: http://openrb.com/discover-ip-of-logic-machine-or-streaming-
player/
Standards supported
Logic Machine is compatible with the following standards:
•KNX/EIB TP, KNXnet/IP
•Modbus TCP, Modbus RTU
•BACnet IP, BACnet MS/TP (in development)
•GSM (Huawei E173 and similar modem support through USB) for sending SMS
notifications and controlling the installation by receiving SMS commands.
•EnOcean (built-in bi-directional transceiver)
•DMX (in the box, through RS485)
•DALI (support is done over RS485 by using external RS485-DALI interface)
•Ekey biometrical access systems (RS485)
•HVAC systems can be controller through RS232 interface by using scripting
•SMTP/Email, SSL
•SIP (works as PBX for controlling calls, in development)
•XML (export object values, alerts or errors)
•RSS (read Error or Alert tab content)
•JSON, XMPP
•..
19
The system is made so that each of the standards can be used with each other, so Logic Machine
can act as BACnet to Enocean gateway or Modbus to GSM etc.
20
Quick startup guide
1) Mount the device on DIN rail
2) Connect the KNX bus cable
3) Connect 24V power supply to the device (red pole to 24V+, grey pole to GND)
4) Connect Ethernet cable coming from the PC
Default IP configuration
Logic Machine/Network ConfigurationLogin
name
admin
Logic Machine/Network
ConfigurationPassword
admin
User mode visualization/Touch visualization
Login name
Read-only:
visview
Write: viscontrol
Write + admin level: visadmin
User mode visualization/Touch visualization
Password
Read-only:
visview
Write: viscontrol
Write + admin level: visadmin
IP address on LAN 192.168.0.10
Networks mask on LAN 255.255.255.0
Change IP settings
In Network
Interfaces window click on the specific interface to change the IP settings.
Table of contents
