b.a.b-technologie gmbh Manager Dokumentation

Transcription

1 b.a.b-technologie gmbh Manager Dokumentation I Stand 10/2007 Datum: 11. Juni 2012 DE

2 Inhaltsverzeichnis Dokumentation Manager b.a.b technologie gmbh im INHOUSE Dortmund Rosemeyerstr Dortmund Tel.: +49 (0) Fax.: +49 (0) b.a.b-technologie gmbh

3 Dokumentation Manager Inhaltsverzeichnis INHALTSVERZEICHNIS 1 General Functions Configuration tool for the KNXeasy Gateway Update function Datei Management Import of esf files Editing EIB Group adresses Eis Types Saving Data as a SAM file Export of esf+ Files Perspectives and Views Views Hex Converter Device Overview Device Details KnXeasy Monitor b.a.b-technologie gmbh 3

4 Inhaltsverzeichnis Dokumentation Manager Abbildungsverzeichnis Figure 1:Function diagram...5 Figure 2: Manager Home...6 Figure 3: Manager Connection Dialog...6 Figure 4: Manager Network configuration page parameter...7 Figure 5: Manager configuration page parameter...8 Figure 6: Manager Divice properties...8 Figure 7: Manager Configuration page System...9 Figure 8: Manager Update Figure 9: Manager licence install Figure 10: Manager management Diagram Figure 11: Manager ESF Import Figure 12: Manager ESF Import Figure 13: Manager group adress management Figure 14: Manager save SAM File Figure 15: Manager ESF+ Export Figure 16: Manager Perspectives and View Figure 17: Manager Hex Converter Figure 18: Manager Device Overview Figure 19: Manager Device Details Figure 20: send Manager command b.a.b-technologie gmbh

5 Dokumentation Manager General Functions 1 GENERAL FUNCTIONS Figure 1:Function diagram The bab-tec manager is a configuration tool for the KNXeasy-gateway. Furthermore, the manager edits all data, the gateway needs and loads that data into the gateway. b.a.b-technologie gmbh 5

6 Configuration tool for the KNXeasy Gateway Dokumentation Manager 2 CONFIGURATION TOOL FOR THE KNXEASY GATEWAY Open the bab-tec manager with "manager.exe". Figure 2: Manager Home Click on "Configuration" and then on "KNXeasy". The "Connection Dialog" opens Figure 3: Manager Connection Dialog Type in the access data for your KNXeasy gateway and click "Proceed". 6 b.a.b-technologie gmbh

7 Dokumentation Manager Configuration tool for the KNXeasy Gateway The manager connects to the gateway and the "Network Parameters" page opens. Figure 4: Manager Network configuration page parameter Here you can change the Network configuration of your gateway. After changing the configuration for your requirements, click on "KNXeasy Configuration" below. b.a.b-technologie gmbh 7

8 Configuration tool for the KNXeasy Gateway Dokumentation Manager Figure 5: Manager configuration page parameter The configuration of the gateway takes place on the left side in the array "KNXeasy Gateway". To add a new gateway, click "Add..." The configuration window opens: Figure 6: Manager Divice properties Enter name, multicast ID, multicast adress and multicast port of the new gateway. Click "Edit..." to change the configuration of existing gateways. To delete a gateway from the list, click "Delete...". In the array "ESF+" you can load esfp files into the gateway and download or delete existing files 8 b.a.b-technologie gmbh

9 Dokumentation Manager Configuration tool for the KNXeasy Gateway Figure 7: Manager Configuration page System System information is displayed on this page. You can restart the KNXeasy software or reboot the gateway (hardware). Furthermore you have the possibility to do a firmware update. b.a.b-technologie gmbh 9

10 Update function Dokumentation Manager 3 UPDATE FUNCTION To install updates or plugins for the manager, click "Extensions" in the menu bar and then on "Install and Update". Figure 8: Manager Update Now the manager looks for updates. Choose the updates or plugins you want to install in the following window and proceed with "Next". 10 b.a.b-technologie gmbh

11 Dokumentation Manager Update function Now the chosen updates are shown detailed. Figure 9: Manager licence install Accept the license agreements and click "Next" to download the updates. Following the download of the updates starts. After finishing the download, you get asked if you want to install the updates. Click "Install all". After the installation of the updates, the manager has to be restarted. b.a.b-technologie gmbh 11

12 Datei Management Dokumentation Manager 4 DATEI MANAGEMENT Figure 10: Manager management Diagram The preparation of the EIB data takes place in the "simple adress manager". With that data the KNXeasy telegrams are generated. For this purpose, you first have to create an esf file from the ETS. This file can be imported with the manager. (Datei=>Export=>OPC-Export) 12 b.a.b-technologie gmbh

13 Dokumentation Manager Datei Management 4.1 IMPORT OF ESF FILES Click on "File" in the menu bar and then on "Import". Mark "ESF Import" and proceed with "Next". Figure 11: Manager ESF Import b.a.b-technologie gmbh 13

14 Datei Management Dokumentation Manager Choose the esf file, you created with the ETS before and enter the SystemID of the eibport. If you have imported an esf file before, you can merge the new with the old esf file. At this, you have the options only to add new group addresses, or to replace existing group addresses. Click "Finish" to complete this procedure. Figure 12: Manager ESF Import 14 b.a.b-technologie gmbh

15 Dokumentation Manager Datei Management 4.2 EDITING EIB GROUP ADRESSES If you have imported an esf file, this file can be viewed and edited with the manager. The editor area opens in every perspective, if an esf file was imported. For proper performance of the gateway, the right EIS types have to be assigned to all group addresses. Figure 13: Manager group adress management To define EIS types, click on the entry in the column "EIS" and change the value. b.a.b-technologie gmbh 15

16 Datei Management Dokumentation Manager 4.3 EIS TYPES EIS 1 EIS 2 EIS 3 EIS 4 EIS 5 EIS 6 EIS 7 EIS 8 EIS 9 EIS 10 unsigned EIS 10 signed EIS 11 unsigned EIS 11 signed EIS 12 EIS 13 EIS 14 unsigned EIS 14 signed EIS 15 On/Off (1 Bit) Dim (4 Bit) Time (3 Byte) Date (3 Byte) Floating-point (2 Byte) Per cent value (1 Byte) Motor (1 Bit) Priority (2 Bit) Floating-point (4 Byte) Counter unsigned (2 Byte) Counter signed (2 Byte) Counter unsigned (4 Byte) Counter signed (4 Byte) Access code (4 Byte) ASCII value (1 Byte) Counter unsigned (1 Byte) Counter signed (1 Byte) Character string (14 Byte) 16 b.a.b-technologie gmbh

17 Dokumentation Manager Datei Management 4.4 SAVING DATA AS A SAM FILE Imported (and maybe edited) esf files get saved in the bab-tec manager as simple adress manager (sam) files. Click on "File" in the menubar and then on "Save as". Figure 14: Manager save SAM File Choose the path for the file and proceed with "Save". b.a.b-technologie gmbh 17

18 Datei Management Dokumentation Manager 4.5 EXPORT OF ESF+ FILES To use the sam files in the KNXeasy gateway, the files have to be exported to esf+ files. Click on "File" in the menubar and then on "Export". Mark "ESF+ Export" and proceed with "Next". Figure 15: Manager ESF+ Export Choose the path for the esf+ file and click "Finish" to export the file. 18 b.a.b-technologie gmbh

19 Dokumentation Manager Perspectives and Views 5 PERSPECTIVES AND VIEWS The desktop of the bab-tec manager is based on perspectives. They are shown as tabs. Click on "Window" in the menubar and then on "Open Perspective" to open a new perspective. View Perspective You can open different "views" in every perspective. Those are the tools you can work with. To open a new view, click "Views" in the menubar and then on "Show View". The default views of the perspectives: KNXeasy Monitor Perspective: KNXeasy Monitor Editor area for group addresses Device Perspective: Device Overview Device Details Editor area for group addresses Project Exploration: Editor area for group addresses You can open other views in every perspective. Figure 16: Manager Perspectives and View To set the defaults, click the tab of the perspective with the right mouse button and choose "Reset". b.a.b-technologie gmbh 19

20 Views Dokumentation Manager 6 VIEWS 6.1 HEX CONVERTER This tool is able to convert ASCII values into hex values and reverse. Figure 17: Manager Hex Converter Just type in the value, you want to convert into the matching array and the converted values appear in the other arrays. 20 b.a.b-technologie gmbh

21 Dokumentation Manager Views 6.2 DEVICE OVERVIEW In the "Device Overview" all discovered eibports get displayed. Figure 18: Manager Device Overview If you click on an eibport with the right mouse button, you can add it to, or remove it from the favourites. b.a.b-technologie gmbh 21

22 Views Dokumentation Manager 6.3 DEVICE DETAILS In the "Device Details" you can watch the configuration of an eibport. First you have to open the "Device Overview" and mark an eibport. Then open "Device Details". Figure 19: Manager Device Details 22 b.a.b-technologie gmbh

23 Dokumentation Manager Views 6.4 KNXEASY MONITOR The KNXeasy Monitor is a tool to write values on EIB group addresses or read the current value of an EIB group adress. The commands get converted to the KNXeasy protocol and then they get sent to the KNXeasy gateway. The gateway sends the commands to the eibport. The KNXeasy Monitor sends the data in the format below: Protokoll SystemID Command Adress Value So if you want to send the EIS_1 value "1" on the group adress 1/0/1 at the eibport with SystemID 0, the command reads as follows: KNXnet/IP 0 write 1/0/1 EIS_1 on You don't have to write these commands yourself. The manager generates the commands by using the array "Generate Command". Example: Sending a command Figure 20: send Manager command First you have to connect to a KNXeasy gateway. Enter the IP of the gateway in the array "Target Host" and click "Set Target". Complete the checkboxes to generate the command. Here we send "1" on the group adress 1/0/1 at the eibport with SystemID "0". Click "send" after completing the checkboxes. The command gets sent to the gateway and you can see it on the monitor. b.a.b-technologie gmbh 23