BAB TECHNOLOGIE GmbH
APP
MODULE
Documentation
Version 1.7.0
Type: IP, KNX, EnOcean
Item no.: 10491, 10495, 13501
Manual version IV
As of 12/2021
Date: 1. December 2021
EN
Page 1: ...BAB TECHNOLOGIE GmbH APPMODULE Documentation Version 1 7 0 Type IP KNX EnOcean Item no 10491 10495 13501 Manual version IV As of 12 2021 Date 1 December 2021 EN ...
Page 2: ...APPMODULE Documentation 2 BAB TECHNOLOGIE GmbH BAB TECHNOLOGIE GmbH Hörder Burgstr 18 D 44139 Dortmund info bab tec de Tel 49 0 231 476 425 30 Fax 49 0 231 476 425 59 www bab tec de ...
Page 3: ...he APPMODULE 20 Setting up the connection in EIBPORT 21 3 2 Using KNX net IP in the APPMODULE IP 23 4 APPMODULE KNX 24 4 1 APPMODULE KNX commissioning 24 4 1 1 KNX configuration 26 4 1 2 Address Settings virtual group addresses 27 4 2 ETS Inside Server 28 5 APPMODULE EnOcean 29 5 1 Initial operation of APPMODULE EnOcean 29 Technical details about the EnOcean Interface 29 EnOcen Kompatibilität 29 5...
Page 4: ...eral 50 8 3 Network 51 8 4 Module 52 8 5 EnOcean Editor 52 8 6 User administration 53 Disable Password Recovery 53 Smart Screens 53 8 7 Rem ote Servicing 54 8 8 Backup the settings 55 Creating a backup 55 Restoring a backup 57 8 9 System firmware update 58 Service 58 Firmware update 58 9 Remote Access HOOC 60 10 Information 61 11 Attachment 62 ...
Page 5: ...tion Devices 31 Figure 27 EnOcean Configuration Monitor 32 Figure 28 EnOcean Settings 33 Figure 29 Calling up properties 34 Figure 30 EnOcean Device Configuration 34 Figure 31 Parameters 35 Figure 32 Receiving KNX parameters 40 Figure 33 Devices delete 41 Figure 34 Devices delete confirm 41 Figure 35 ETS Project Import 42 Figure 36 Open the Group Address Selection window 42 Figure 37 Group address...
Page 6: ...ver that you can customise using the apps from the BAB APPMARKET This documentation will help to familiarise you with the product and facilitate implementation BAB TECHNOLOGIE GmbH Figure 1 APPMODULE KNX Product name APPMODULE Intended use Module to run applications Design Modular device REG Item number 10491 IP 10495 KNX 13501 EnOcean ...
Page 7: ...s available as IP for EIBPORT with KNX or with EnOcean interface 1 2 APPMODULE FUNCTIONAL PRINCIPLE On delivery the APPMODULE contains only the basic software and has no application installed You can purchase and download the applications for the APPMODULE in the BAB APPMARKET For that purpose you will need an APPMARKET account and an APPMODULE registered in the APPMARKET In addition to the downlo...
Page 8: ... objects unlimited Output objects 128 External antenna 2 50 m cable magnetic base and SMA connector Specific features A wide range of different smart home apps can be combined on one device SDK available for manufacturers and developers A steadily growing app portfolio available in the BAB APPMARKET bab appmarket de Software requirements Operating System independent Communication Network interface...
Page 9: ...n the interests of technical progress The information in this documentation may therefore not necessarily be up to date Information on current APPMODULE firmware and on this description APPMODULE documentation can be found at www bab tec de 1 7 FUNCTIONAL SAFETY If there are certain requirements to minimize risks for people or objects functional safety additional measures are obligatory which must...
Page 10: ...e power supply remove the screw plug in terminals see figure below Now connect the power supply cables to the respective screw plug in terminals see figure below Please consider the polarity Now you can replug the screw plug in terminals into the APPMODULE In the next step snap the device onto the mounting rail according to DIN EN 60715 APPMODULE features 1 KNX connection type 10495 via screw plug...
Page 11: ...en started the LED simulates a heartbeat The flashing interval increases depending on the device utilisation FLASHING RED Communication takes place via KNX Explanation The green Power Boot LED lights up as soon as the APPMODULE is supplied with power Two to three seconds after the power supply has been switched on this LED also starts to flash red flashing orange until the booting process has been...
Page 12: ...tion EnOcean Editor The language in the EnOcean Editor Java based application adjusts to the language set in the browser after start up from the browser If the app is used in BAB STARTER the language set in the operation system applies English is used if a language other than German or English is set 2 2 2 SYSTEM REQUIREMENTS Current browser e g Firefox Chrome Safari etc Do not use Internet Explor...
Page 13: ...b interface please proceed as described below Open a browser and enter the IP address of the APPMODULE into the address line Information about the factory settings can be found in chapter Initial Operation Figure 4 APPMODULE start page You will reach the APPMODULE start page The Login unlocks the Configuration Functions whereas Information shows general system information Use the user data to log ...
Page 14: ...Figure 7 Back to the homepage ADJUSTING THE NETWORK SETTINGS OF YOUR COMPUTER In order to adjust the network settings of your computer and establish a connection to the device please proceed as described below Open the IP address settings under Windows 7 Click Start Button Control Panel Network Select Network Connection then LAN Connection Intel PRO1000 GT in the figure below Figure 8 Windows Netw...
Page 15: ...MODULE Documentation BAB TECHNOLOGIE GmbH 15 Then click Properties Figure 9 Ethernet status Select Internet protocol Version 4 TCP IPv4 and click Properties again Figure 10 Properties of the LAN connection ...
Page 16: ...LE Free IP address 192 168 1 228 Subnet mask 255 255 255 0 Now confirm your input with OK Close all windows until the Windows Network and Sharing Center Settings window is shown Thus you have adjusted the network settings of your PC to those of the APPMODULE You can access the web interface of the APPMODULE by means of the browser Restore the original network settings of your PC by following the s...
Page 17: ... browser for factory settings 192 168 1 229 Figure 12 APPMODULE Webinterface The start page of the APPMODULE opens up Click Log In A login dialog appears For factory settings the login data is as follows Username admin Password admin Figure 13 Login dialog Note The password must be changed immediately when logging in for the first time If the password is lost the device cannot be reset Note Loggin...
Page 18: ...nslated with www DeepL com Translator IP address subnet mask gateway Field for the static assignment of IP addresses Please make also sure that the subnet mask often 255 255 255 0 and the gateway entry are correct Often the IP address of the WLAN router Note Without a correct gateway entry the device will not be able to communicate with the Internet DNS server DNS is the abbreviation for Domain Na...
Page 19: ...matically connects to the new IP address if possible Note Please bear in mind that you might have to reset the IP address of your computer to the initial value in order to be able to access the APPMODULE after the change has been made Specialty when activating DHCP If you have activated DHCP for the APPMODULE according to the steps mentioned above please use the BAB STARTER like depicted in the ch...
Page 20: ...acility coupling needs to be set up Note For facility coupling between EIBPORT and the APPMODULE to work communication over UDP with port 1735 or another port if set is required Security installations in more complex networks can prevent this communication SETTING UP THE CONNECTION IN THE APPMODULE In the APPMODULE go to the Configuration Module menu Information on accessing the APPMODULE Web inte...
Page 21: ...ration Advanced EIB yabus settings BMX UDP port Group address format Not relevant here Enter 3 Level xx y zzz This sets up communication from the APPMODULE to EIBPORT Communication from EIBPORT to the APPMODULE must be set up at the EIBPORT end SETTING UP THE CONNECTION IN EIBPORT To set up the connection in EIBPORT you will need the EIBPORT Facility coupling job For detailed information on the jo...
Page 22: ...ress of the APPMODULE to which you wish to connect here e g 192 168 1 224 Target system ID Please do not change this value The system ID must be 0 Rule 1 Enter the wildcard rule in both fields source target This rule transfers all group addresses The job is active as soon as you save and the group addresses are transferred ...
Page 23: ...KNX must be provided by another device with a KNX interface e g a KNX IP Router and KNXnet IP Tunneling as an interface for ETS Proceed as follows to set up the KNXnet IP server Open the Configuration Module and select KNXnet IP under Select interface This enables the KNX interface Figure 18 APPMODULE IP Interface KNXnet IP More information on KNXnet IP setup can be found in KNX configuration ...
Page 24: ...no 10495 All KNX related settings are made over the Web interface of the APPMODULE Note For the ETS project please use a dummy application to record the use of the physical address of the APPMODULE Access the website of the APPMODULE and log on see Calling up the APP MODULE web interface Switch to the Configuration KNX menu Figure 19 KNX configuration ...
Page 25: ...ast 2 physical addresses not used in the relevant line for KNXnet IP Tunneling Figure 21 KNX assigning a KNXnet IP tunneling address Note These addresses are required for establishing a connection for the commissioning software ETS for use of the APPMODULE as an interface to KNX As of ETS 5 at least 2 free addresses are required here Save the configuration Figure 22 Saving the configuration ...
Page 26: ...neling Activates KNXnet IP Tunneling access to the device This connection can be used to program KNX devices or to exchange data The APPMODULE is the server The above address is used as the physical address for the connection For each address only one connection can be established at any one time On the TCP IP layer the connection is made by means of unicast to UDP port 3671 KNXnet IP Tunneling Ad...
Page 27: ...is makes sense on the one hand if more KNX group addresses are required which can be sent on the KNX bus but at the same time not to do without the virtual group address range in order to keep the telegram load on the KNX bus low For example the start of the virtual group addresses can be set to 31 0 0 In this configuration the APPMODULE sends all group addresses up to 30 7 255 on the KNX bus and ...
Page 28: ...g hc en us articles 214496505 Licensing ETS Inside Now the ETS Inside Server is ready for use Further you have access to the KNX network via the ETS Inside Server with the ETS Inside Client installed the APP on your mobile device On one hand the ETS Inside Client and Server as well as the APPMODULE and the required KNX line are connected via the respective network The handling of ETS Inside is not...
Page 29: ... 868 3 Mhz Range 300 m in the free field 30 m in the building depending on the building material Input objects Any number Output objects 128 External antenna 2 50 m cable magnetic base and SMA plug connector ENOCEN KOMPATIBILITÄT Eltako Profil Beschreibung Produkte 80 02 01 Eltako Dimmen Eltako FUD14 FUD61 FDDT65B 80 03 01 Eltako Beschattung Eltako FSB14 FSB61 80 04 01 Eltako Bewegungsmelder Senso...
Page 30: ...re to be interpreted Thus it is important that sensor and actuator utilize the same EnOcean Profile EEP Device categories sensors EnOcean distinguishes between three device categories in its sensor technology The device category gives information about the kind of EnOcean signal involved and simultaneously about what the receiver can expect Switch module A module which sends out a corresponding ra...
Page 31: ...ress which only exists once This address allows the sending device to be identified Teaching Telegram LRN Telegram Is a special telegram used to teach the sensor to recognize the actuator that is to adapt the actuator to the sensor It is important for the actuator to know from which hardware address it gets its sensor data There are several kinds of adapting mechanisms Please consider the respecti...
Page 32: ...EnOcean Configuration Monitor Settings Settings You can configure the EnOcean module here EnOcean Devices Lists all EnOcean devices sorted by device id trans id EnOcean Monitor Lists all received EnOcean telegrams sorted by the time at which they were received ...
Page 33: ...re you can switch the module on or off Repeater The repeater function is used to repeat a receiving signal in order to increase its range The following settings are available Check box activates Repeater function is turned on Level 1 The telegram is repeated by one repeater only Level 2 The telegram is repeated by two repeaters RX sensitivity Determine the receiving sensitivity in which you want t...
Page 34: ...evices Show all devices Configured Devices Show only the devices which have already been configured New Unnamed Devices Show only the new and unnamed devices Advice If you are not sure which device has which Trans ID activate the device of interest and look up in the device list for which device the telegram counter increases column telegrams 2 When you have detected the device of interest mark it...
Page 35: ...soon as a profile is selected the corresponding KNX parameters are shown underneath 5 Select the corresponding profile of your EnOcean device If you are not sure about which profile your device speaks please contact the manufacturer of the device Different parameters appear depending on which profile has been selected If one switch rocker has been selected various additional functions can be carri...
Page 36: ...assignment in chapter KNX Addressing 9 When you have entered the addresses in the parameters as requested close the EnOcean Device Configuration window 10 Save the changes in the window EnOcean Configuration via the button Save Close or Assume the window stays open As soon as this step is taken the entered KNX telegrams are triggered via EnOcean signals In order to be able to use the addresses mor...
Page 37: ...rmine which device is emulated with which KNX telegram by the APPMODULE the device internally works with KNX group addresses also during the EnOcean execution Creating an emulated device Click on the button Add feedback device to create a new emulated EnOcean device A new window will be opened Add feedback device Depending on which actuator is supposed to be controlled the matching device profile ...
Page 38: ...sented ID Is the definite hardware address you have selected before Can not be modified at this point EnOcean Equipment Profil EEP Here the profile the emulated device should use is selected For more information regarding parameter and address configuration please see Configuration example for EnOcean Simulate push the button Here you can simulate a push button for each rocker which sends a telegr...
Page 39: ...there is a 2 digit as well as a 3 digit representation 3 digit MG Main Group CG Central Group SG Subgroup MG CG SG 2 digit MG Main Group SG Subgroup MG SG Note The APPMODULE interface only supports the 3 digit representation Real Virtual Address Space The KNX address space ranges in total from 0 0 0 to 31 7 255 in the 3 digit representation Therein the range from 15 7 255 is designated as real add...
Page 40: ...he length of button presses for switch move step Separate Action You can assign further KNX addresses for the separate action both rockers at the same time Please note that this is only possible for buttons with two rockers Assigning Addresses Switching Dimming The EnOcean button can be used as switch and dimmer A long press will be interpreted as a dimming command When used as a switch the button...
Page 41: ... will be prompted to confirm that you really want to delete it Figure 34 Devices delete confirm Click on Delete to delete it Afterwards save the settings Only then will the device really be deleted If you do not save the settings after deleting devices they will only be removed from the list but reappear with their configuration intact once they are rediscovered ...
Page 42: ...time when the currently imported project was last changed with the ETS The imported ETS project is then available in the App configuration USE ETS PROJECT After the installation of an app for the APPMODULE the ETS project is available to you Click with the left mouse button to the right of the input field for the group address Figure 36 Open the Group Address Selection window ...
Page 43: ...a main group to close it again Click with the left mouse button on a middle group All group addresses of this middle group are displayed Click again with the left mouse button on a middle group to close it again You can transfer a group address to the group address field in two ways Mark the group address with a click of the left mouse button and then press the Select button or double click the gr...
Page 44: ...up address can be entered as a 2 digit or 3 digit group address The 2 digit group address is automatically converted into a 3 digit group address With the button Add the group address is added to the input field for the group address With a click on Save the group address is saved in the APPMODULE Note If group addresses and the corresponding data points are greyed out in an imported ETS project t...
Page 45: ...on the homepage of BAB APPMARKET https www bab appmarket de de or from the ToolTips of the corresponding application 1 Please call up the web interface of your APPMODULE 2 Click on the menu item App Manager here highlighted red Figure 40 APPMODULE Start menu 3 You have entered the menu where a list of all on the device already installed Apps are shown In order to install another App click on Insta...
Page 46: ... the app that you previously loaded from the APPMARKET and click OK See APPMODULE functional principle for information on purchasing apps Figure 42 Select APP 5 As soon as the next window opens the installation was successful Now click on OK and parameterise your APP Figure 43 Installation successful ...
Page 47: ...elete instances Figure 45 Instance functions Colour Function Red Start instance Yellow Edit parameter Blue Display log Green Copy instance Orange Delete instance 7 1 1 NOTATION OF GROUP ADDRESSES The group addresses in the APPMODULE can either be displayed in 2 digit notation XX XXXX or 3 digit notation XX X XXX The APPMODULE always converts the group addresses into 3 digit display no matter in wh...
Page 48: ...ualization for example that an app update is present if a 0 is sent to the group address no update is present if a 1 is sent one or more updates are present Figure 46 Update Configuration If the Automatic App Update is activated the APPMODULE checks for updates once a day The time of the search depends on the last boot process of the APPMODULE and is determined automatically The time cannot be set...
Page 49: ...d Wait until the update is finished Figure 49 Update successful The update of the app does not overwrite existing group addresses Individual group addresses can be given If deleted if the function to which the group address belonged is omitted New functions must be assigned a new group address After the update check the configuration of the Smart Home App ...
Page 50: ...ice name for your APPMODULE This name is then displayed in the Discovery Tool and BAB STARTER Location Edit the installation site so that the correct time zone can be set System time The current system time of the device is shown Clicking the button synchronises the system time of the device with that of the local PC To synchronise the system time automatically please use the NTP service See Netwo...
Page 51: ... out Please note that an IP address may never be assigned twice DNS server DNS is the abbreviation for Domain Name System The DNS server converts Internet addresses for example www bab tec de into the IP address 85 214 89 170 and vice versa Without a valid DNS entry NTP weather and UPnP service do not work NTP server NTP is a free service for synchronising the system time of Internet compatible de...
Page 52: ... relevant for all APPMODULE versions IP 10491 KNX 10495 and EnOcean 13501 With IP 10491 and EnOcean 10495 the configuration regulates KNXnet IP communication For more information please see KNX configuration 8 5 ENOCEAN EDITOR Displayed with the EnOcean APPMODULE device module 13501 More information on configuration is available in APP MODULE EnOcean ...
Page 53: ...ASSWORD RECOVERY If this option is selected the password cannot be reset and the device must be sent in if you lose the password Figure 52 User administration SMART SCREENS The displayed device names here are used to inform which devices have been registered via the Smart Screens function You haven t influence to this login procedure and the stored credentials yourself The registration is required...
Page 54: ...ctivated again if the APPMODULE is restarted this is independent of the set time Remote Servicing Access can be deactivated at any time by clicking on Deactivate Remote Servicing Access Activate the Remote Servicing Access by clicking on Activate Remote Servicing Access Remote Servicing access is started This process takes a few seconds and the Remote Servicing Access ID is displayed Copy the ID a...
Page 55: ...mware update Figure 54 Backup Restore CREATING A BACKUP Select the checkboxes under Modules to set which configuration data is to be backed up Configuration All configuration data except for app configuration data Note The network settings are not backed up these are separate from the backup data Statuses logging The address status table and logging table are backed up This is important as it ensu...
Page 56: ...be selected for backup from the drop down menu Figure 55 Selecting apps and app instances for backup Comments regarding the backup can be added in the Comments field Click on Create backup to launch the backup process The backup file is generated by the system and provided automatically for download using the browser download dialogue ...
Page 57: ...ble in the selected backup file You can also use the checkboxes to select which modules are to be restored Configuration All configuration data except for the app configuration data Note The network settings are not part of the backup file Statuses logging The address status table and logging table are restored This is important as it ensures you can access the status information in the apps after...
Page 58: ...rmware update is free of charge The current firmware files can be found on the BAB homepage Proceed as follows to update the device Download the current firmware image from the download area www bab tec de Unpack the file to any folder Note Generate a new backup including all apps and app instances before you launch the update see Backup the settings The update process restores the factory setting...
Page 59: ...tion The device will be reset to factory defaults during the update Figure 58 Keep network settings Note If the Keep network settings checkbox is not selected the APPMODULE can be accessed at the default IP address after the update For factory settings see Initial Operation Launch the update by clicking on Perform Update Figure 59 Perform update Wait until the update is complete The Web interface ...
Page 60: ...t forms the heart of the HOOC VPN solution and offers a comprehensive user administration as well as many additional features such as a KNX bus monitor or alarm messages with push function Further instructions on setting up configuring and using the Plug Play VPN solution can be found in the separate document Documentation HOOC More information at https bab technologie com hooc lang en The HOOC Ga...
Page 61: ...PMODULE Documentation BAB TECHNOLOGIE GmbH 61 10 INFORMATION Important information on the APPMODULE can be found here Please have this information ready if support is required Figure 61 System Information ...
Page 62: ...rolled IEEE Floating point number long EIS 9 DPT 14 yyy 4 Octet float value IEEE 754 32 Bit 4 byte float value Counter 16 Bit Unsigned EIS 10u DPT 7 yyy 0 65 535 16 Bit 2 byte unsigned value Counter 16 Bit Signed EIS 10 DPT 8 yyy 32 768 32 767 16 Bit 2 byte signed value Counter 32 Bit Unsigned EIS 11u DPT 12 yyy 0 4 294 967 295 32 Bit 4 byte unsigned value Counter 32 Bit Signed EIS 11 DPT 13 yyy 2...
