Table of Contents

Advertisement

Quick Links

b.a.b-technologie gmbh
KNXEASY
documentation
Version 1.2
Documentation version I
Actual state 06/2013
Date: 18. September 2014
EN

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the KNXEASY and is the answer not in the manual?

Questions and answers

Summary of Contents for BAB TECHNOLOGIE KNXEASY

  • Page 1 KNXEASY documentation Version 1.2 Documentation version I Actual state 06/2013 Date: 18. September 2014...
  • Page 2 KNXEASY b.a.b – technologie gmbh im INHOUSE Dortmund Rosemeyerstr. 14 44139 Dortmund info@bab-tec.de Tel.: +49 (0) 231 – 476 425 - 30 Fax.: +49 (0) 231 – 476 425 - 59 www.bab-tec.de b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 3: Table Of Contents

    Date and time ..........................15 Network ............................15 General ............................16 KNX ..............................17 Services ............................18 Alarms ............................. 19 Info ..............................25 KNXEASY ............................. 25 Introduction ..........................25 Connection ..........................26 3.2.1.1 Default connections ..................... 26 3.2.1.2 Configure connections ....................27 Serial connection ........................
  • Page 4 Figure 3: BUS 2 connector ........................... 8 Figure 4: Navigation buttons ........................8 Figure 5: Signal LEDs ............................. 9 Figure 6: BAB TECHNOLOGIE Logo ......................13 Figure 7: User Administration ........................13 Figure 8: Reset Configuration........................14 Figure 9: Backup / Restore ........................14 Figure 10: Date and Time .........................
  • Page 5: Introduction

    All required software and hardware settings are already stored in the KNXEASY. No additional software is needed for operation. KNXEASY has its own user interface as a LCD display allowing to configure the device without a PC. It has also a configuration web interface reachable from any updated browser. As KNXEASY device is connected to LAN it may be operated from anywhere.
  • Page 6: Initial Operation And Installation

    These measures must have the necessary independence from the operation of the KNXEASY and always have to be available. Measures to reduce risk you can take from the Tables "Functional safety" of the "Building Control Handbook, Fundamentals"...
  • Page 7: Device Overview

    Documentation KNXEASY DEVICE OVERVIEW The image below shows KNXEASY. Figure 1: Device Overview (1) Power supply 12 - 30 Volt DC (2) Signal LEDs (3) RJ45-socket for Ethernet LAN (4) Navigation buttons (5) LCD display (6) Front USB socket (7) Bottom USB socket...
  • Page 8: Bus 2 (Twisted Pair) Connector

    (6) ESC button (navigate to precedent menu, erase a character of the string you are configuring such as “Name” string or “Host” string, stop error/warning/info messages when they occur) A long press on Up or Down button allows you to scroll faster. b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 9: Signal Leds

    During update process the Status LED may blink red or yellow. USB SOCKETS Two USB sockets on the front and the bottom side are available on the KNXEASY. Both of them allow you to plug a USB flash drive in order to update the KNXEASY.
  • Page 10: Installation

    For power supply, the non-choked output of an EIB-power supply can be used, if available. (Please consider of adequate power reserves). To supply the KNXEASY Power Over Ethernet (POE) can be used. Plug in the network cable (LAN) into the RJ 45- connector.
  • Page 11: Additional For Knx

    Documentation KNXEASY ADDITIONAL FOR KNX To establish optimum operating conditions and performance the KNXEASY should be connected to the KNX bus system (BUS 2). It is of prior importance that the device is supplied with bus voltage; real devices on the bus system are not needed.
  • Page 12: General

    “[Name].local” or the IP address you have configured. For example the default name is “knxeasy”. You should be able to access to the web interface when you type “knxeasy.local” in your browser. In addition “knxeasy” should be one of the visible KNXnet/IP servers in ETS.
  • Page 13: Web Interface

    Documentation KNXEASY WEB INTERFACE ACCESS TO THE WEB INTERFACE The KNXEASY is delivered with factory-made settings. In order to access to the web interface, type the default IP address or the default hostname in your browser: Default IP address =>...
  • Page 14: Reset Configuration Settings

    In the web interface go to “Configuration” -> “Backup / Restore”. Click on “Create a Backup” and save the file in a safe place. To restore it, click on “Browse”, search for your backup file and click on “Restore”. Figure 9: Backup / Restore b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 15: Date And Time

    Documentation KNXEASY DATE AND TIME At first boot time if KNXEASY is not able to connect to a NTP server in order to get the right date and time, it will display the error message “Please configure date and time”.
  • Page 16: General

    GENERAL In the Web interface, go to “Configuration” -> “General”. You can set the “Device Name”, the “Location” and the “Display-Language” of your KNXEASY. b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 17: Knx

    In the Web interface, go to “Configuration” -> “KNX”. KNX DATE / TIME In order to synchronize KNXEASY’s time to a KNX Date / Time device, enter both KNX group addresses in the “KNX Date / Time” settings. Figure 14: KNX Date / Time...
  • Page 18: Services

    You can from the web interface, import the archive so that all those useful information are available directly in the KNXEASY’s clients simulation. Click on “Browse” and search for the archive you have exported from ETS 4. Finally click on “Upload selected project”.
  • Page 19: Alarms

    You can clear these logs with the button “Clear”. Figure 18: Services ALARMS In the Web interface, go to “Configuration” -> “Alarms”. ALARMS GROUP ADDRESSES Alarms Configuration This field contains the list of alarms you have configured, up to 50 alarms. KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 20: Figure 19: Alarms List

    KNX telegram as a real value. Thus, no way to compare it with the limit value. In this example the group address “14/2/5" has the datatype b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 21: Figure 22: Alarm States Green

    Then, a warning message is displayed on the LCD screen. This message specifies every information about the alarm and the current value. Finally if Connections are configured, the same warning message will be sent via those Connections. KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 22: Figure 24: Alarms List

    Every x minutes, where x is the period in minute (from 15 to 59 minutes) Every x hours, where x is the period in hour (from 1 to 23 hours) Every day at x, where x is the time at which the physical address will be checked every day. b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 23: Figure 26: Alarm States Green

    Therefore, be aware that you will trigger alarmes if these physical addresses are not available when you configure these alarms. ALARMS IP ADDRESS Alarms Configuration This field contains the list of alarms you have configured, up to 50 alarms. KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 24: Figure 28: Alarms List

    Every day at x, where x is the time at which the physical address will be checked every day. After configuring this new alarm, click on “Ok”. For this example we check the address 172.31.49.253 every day at 13:02. Another alarm is added. Hostname "google.com" every hour. Alarm States b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 25: Info

    Therefore, be aware that you will trigger alarmes if these IP addresses are not available when you configure these alarms. INFO In the web interface go to the main menu “Info”. You can there check many information such as “Version”, “Serial Number”, “Temperature (System)” … KNXEASY INTRODUCTION KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 26: Connection

    Documentation KNXEASY KNXEASY behaves as a gateway between an easy ASCII protocol and KNX protocols (KNX Twisted Pair and KNXnet/IP). KNXEASY works in both ways, it turns received ASCII strings into KNX telegrams and received KNX telegrams into ASCII strings. KNXEASY uses Client/Server communications in order to send and receive ASCII strings.
  • Page 27: Configure Connections

    Documentation KNXEASY It also means that anybody having access to your network is easily able to control your KNX installation (door opening, alarms …). Ensure your network is secured and/or configure KNXEASY connections for more security. 3.2.1.2 CONFIGURE CONNECTIONS In the “Connections” field it is possible to add, edit or delete connections. According to this configuration, internal TCP, UDP and HTTP servers will be dynamically added, edited or deleted.
  • Page 28: Serial Connection

    In the “Serial connection” field it is possible to configure a serial connection in order to send commands and receive messages from KNXEASY (This field contains other parameters, they will be explained later, see: "Connection configuration"). To use the serial, plug a serial adaptor in the RJ45 port on the bottom side of the device, named "RS232":...
  • Page 29: Figure 36: Serial Connection

    A serial port may use signals in the interface to pause and resume the transmission of data. It can be: none (no flow control) software hardware Attention! To communicate together, KNXEASY's serial server configuration and your serial client configuration need to match. KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 30: Protocol

    ID is “0”). KNXEASY with address 192.168.1.228 knows that this ASCII string does not belong to him and will search in the route table to which KNXEASY this ASCII string belongs to. It will then try to re- send the ASCII string to the right KNXEASY.
  • Page 31: Figure 37: Route Table

    Enter the System ID of the KNXEASY. SERVICE Enter the default service of the KNXEASY. If there is no service in the ASCII string, the KNX telegram will be send via the default service. Once this configuration saved on one KNXEASY, the route table will be send to every KNXEASY via a multicast message.
  • Page 32: Command

     [type]-[subtype] for example “1-10” If an ETS 4 project has been imported, KNXEASY will automatically get the datatype that you have configured in ETS 4. Therefore, you do not have to define it in the ASCII string. Define the datatype directly in the ASCII string might be dangerous if the datatype is totally wrong. This behaviour is enabled by default but for each connection you are able to disable it (see: "Force send...
  • Page 33: State Table

    STATE TABLE Each time KNXEASY receives a “write” KNX telegram or ASCII string, it writes the value sent in a state table. When it receives a “read” ASCII string, it checks first if the group/physical address is present in the state table.
  • Page 34 {"type": "error","command": "[ASCII string sent]","message": "[error message]"} For example: {"type": "error","message": "KNX bus: EIB bus could be disconnected."} {"type": "error","command": "twisted_pair 0 write scene dpt-1-10 start","message": "Bad KnxEasy command. Cannot find a correct destination address."} RECEIVE TELEGRAM If a KNX telegram is received, you will receive a “receive” JSON string.
  • Page 35: Client Simulation

    This unit is found in the datatype details. For example datatype dpt-5-3 has the unit “angle (degrees)”. CLIENT SIMULATION In the web interface, go to “KNXEASY”. Client simulation is made to help you building ASCII strings you will use in your own UDP, TCP or HTTP client.
  • Page 36: Figure 41: Send Ascii String

    DATAPOINT TYPES If an ETS 4 project has been imported and datatypes has been configured, you can choose a datatype in the list of datatypes. Otherwise you can choose a datatype according to data size. b.a.b-technologie gmbh KNXEASY version. 1...
  • Page 37: Figure 42: Datatypes

    This field displays the generated ASCII string. It is also editable, therefore do not hesitate to test all different possibilities. SEND ASCII STRING Send the ASCII string displayed in the ASCII string field. LOGS All logs are displayed in the bottom field. You can clear logs with the clear button. EXAMPLE KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 38: Http

    You are also able to send ASCII strings via HTTP POST and GET. POST POST is used to send a “write” command to KNXEASY. The address for this POST is: http://[IP address]/knxeasy/rest/knxeasy/write The command is sent as request data in a JSON format: {"command": "[command]"}...
  • Page 39: Figure 44: Postman Post

    You can also send requests directly from the Client simulation just like you do with the other protocols, with the send button. GET is used to send a “read” command to KNXEASY. The address for this GET is: http://[IP address]/knxeasy/rest/knxeasy/read...
  • Page 40: Figure 45: Postman Get

    Documentation KNXEASY {"responses":[{"type": "ack","command": "twisted_pair 0 read scene1 dpt-1-10"},{"type": "read","command": "knxeasy 0 read scene1 dpt-1-10 start start/stop"}]} The application POSTMAN from Google Chrome gives you the possibility to send HTTP requests: Figure 45: POSTMAN GET You can also send requests directly from the Client simulation just like you do with the other protocols, with the send button.
  • Page 41: Saved Command

    Figure 46: GET file example SAVED COMMAND In order to simplify even more the commands send to or receive from KNXEASY, you are able to save string commands corresponding to a normal KNXEASY ASCI command. For example for normal KNXEASY ASCI command “twisted_pair 0 write shutter1 dpt-1-9 open”...
  • Page 42: Figure 48: Saved Commands List

    In the Client simulation, click on the checkbox “Add new saved command”. An “Associated command” text input and a “Save” button appears. Simply build a KNXEASY ASCII string as you normally do. When you finished to configure your string, write your own associated command in the “Associated command” text input and finally click on the save button.
  • Page 43: Figure 49: Send/Receive Saved Command

    “>>”: Display the last command in the list. When you have chose the received command in the list, enter your associated command in the “Associated command” text input and click on the save button. A new saved saved command is added. KNXEASY Version 1 b.a.b-technologie gmbh...
  • Page 44: Update

    KNXEASY (see “Backup / restore configuration”). When a new version of KNXEASY is available on our website, you can update it. Copy the update archive on a USB stick (be sure the usb stick has been properly unmount before plugging it out), and plug it on the KNXEASY In the LCD menu go to “Update”...

Table of Contents