BAB TECHNOLOGIE APPMODULE IP Operator's manual

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

APPMODULE Documentation
2
BAB TECHNOLOGIE GmbH
BAB TECHNOLOGIE GmbH
Hörder Burgstr. 18
D-44139 Dortmund
[email protected]
Tel.: [phone] - 30
Fax: [phone] - 59
www.bab-tec.de

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
3
TABLE OF CONTENTS
1APPMODULE..........................................................................................................................................6
1.1 Functional overview......................................................................................................................7
1.2 APPMODULE functional principle .................................................................................................7
1.3 Technical data ..............................................................................................................................8
1.4 Scope of delivery and interfaces ..................................................................................................8
Factory setting on delivery: ..........................................................................................................9
Serial number / Registration key..................................................................................................9
1.5 Updates.........................................................................................................................................9
1.6 Important information on the operating instructions .................................................................9
1.7 Functional safety...........................................................................................................................9
2Assembly ............................................................................................................................................ 10
2.1 LED status................................................................................................................................... 11
2.2 Initial Operation......................................................................................................................... 12
2.2.1 Language............................................................................................................................... 12
2.2.2 System requirements ............................................................................................................ 12
2.2.3 Establishing connections....................................................................................................... 12
Calling up the APPMODULE web interface ............................................................................... 13
Adjusting the network settings of your computer.................................................................... 14
Adjusting the network settings of the APPMODULE ................................................................. 17
3APPMODULE IP................................................................................................................................... 20
3.1 Connecting the APPMODULE IP to EIBPORT.............................................................................. 20
Setting up the connection in the APPMODULE......................................................................... 20
Setting up the connection in EIBPORT ...................................................................................... 21
3.2 Using KNX net/IP in the APPMODULE IP .................................................................................... 23
4APPMODULE 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
5APPMODULE EnOcean ...................................................................................................................... 29
5.1 Initial operation of APPMODULE EnOcean ................................................................................ 29
Technical details about the EnOcean Interface........................................................................ 29
EnOcen Kompatibilität............................................................................................................... 29
5.2 Calling up the EnOcean Editor .................................................................................................. 30
5.3 Usage of the EnOcean Editor .................................................................................................... 30
5.3.1 Operating principle EnOcean ............................................................................................... 30
5.3.2 EnOcean Configuration......................................................................................................... 31
5.3.3 EnOcean Settings .................................................................................................................. 33
5.3.4 EnOcean device teach-in procedure .................................................................................... 34
5.3.5 Emulating EnOcean devices ................................................................................................. 37
5.3.6 KNX Addressing ..................................................................................................................... 39
5.3.7 Configuration example for EnOcean Push-Button (Rocker)................................................. 40
APPMODULE as the receiver (actuator) ..................................................................................... 40
5.4 Delete EnOcean devices............................................................................................................ 41
6ETS Project import ............................................................................................................................ 42
Use ETS project .......................................................................................................................... 42
Configure Custom Addresses .................................................................................................... 44
7App Manager ..................................................................................................................................... 45
7.1 Instance...................................................................................................................................... 47
7.1.1 Notation of group addresses ................................................................................................ 47

APPMODULE Documentation
4
BAB TECHNOLOGIE GmbH
7.2 Automatic Smart Home App update......................................................................................... 48
8Configuration .................................................................................................................................... 50
8.1 Saving the configuration ........................................................................................................... 50
8.2 General....................................................................................................................................... 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
9Remote Access - HOOC..................................................................................................................... 60
10 Information........................................................................................................................................ 61
11 Attachment........................................................................................................................................ 62

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
5
List of Figures
Figure 1: APPMODULE KNX...............................................................................................................................................6
Figure 2: APPMODULE –How it works..............................................................................................................................7
Figure 3: APPMODULE connection diagram.................................................................................................................. 10
Figure 4: APPMODULE start page .................................................................................................................................. 13
Figure 5: Logging in to the web interface .................................................................................................................... 13
Figure 6: "Configuration" menu item........................................................................................................................... 14
Figure 7: Back to the homepage................................................................................................................................... 14
Figure 8: Windows Network and Sharing Center.......................................................................................................... 14
Figure 9: "Ethernet" status ........................................................................................................................................... 15
Figure 10: Properties of the LAN connection................................................................................................................ 15
Figure 11: TCP/IPv4 properties..................................................................................................................................... 16
Figure 12: APPMODULE Webinterface .......................................................................................................................... 17
Figure 13: Login dialog ................................................................................................................................................. 17
Figure 14: APPMODULE –Main Menu ........................................................................................................................... 18
Figure 15: APPMODULE Network configuration ........................................................................................................... 19
Figure 16: APPMODULE IP Interface Extension ............................................................................................................. 20
Figure 17: EIBPORT facility coupling job....................................................................................................................... 21
Figure 18: APPMODULE IP Interface KNXnet/IP ............................................................................................................ 23
Figure 19: KNX configuration........................................................................................................................................ 24
Figure 20: KNX –Physical Address................................................................................................................................. 25
Figure 21: KNX –assigning a KNXnet/IP tunneling address.......................................................................................... 25
Figure 22: Saving the configuration ............................................................................................................................. 25
Figure 23 Address setting (virtual group addresses)..................................................................................................... 27
Figure 24: ETS Inside Server .......................................................................................................................................... 28
Figure 25: Configuration –EnOcean Editor.................................................................................................................. 30
Figure 26: EnOcean Configuration - 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 selection .............................................................................................................................. 43
Figure 38: Assign group address ................................................................................................................................... 43
Figure 39: Configure Custom Addresses....................................................................................................................... 44
Figure 40: APPMODULE Start menu .............................................................................................................................. 45
Figure 41: Install APP..................................................................................................................................................... 45
Figure 42: Select APP..................................................................................................................................................... 46
Figure 43: Installation successful .................................................................................................................................. 46
Figure 44: Create Instance............................................................................................................................................ 47
Figure 45: Instance functions........................................................................................................................................ 47
Figure 46: Update Configuration.................................................................................................................................. 48
Figure 47: Smart Home App Update available ............................................................................................................. 48
Figure 48: Release notes for the update file................................................................................................................. 49
Figure 49: Update successful ........................................................................................................................................ 49
Figure 50: General configurations ................................................................................................................................ 50
Figure 51: APPMODULE –Network settings.................................................................................................................. 51
Figure 52: User administration...................................................................................................................................... 53
Figure 53: Remote servicing ......................................................................................................................................... 54
Figure 54: Backup / Restore ......................................................................................................................................... 55
Figure 55: Selecting apps and app instances for backup............................................................................................. 56
Figure 56: Downloading backup................................................................................................................................... 57
Figure 57: Configuration –System................................................................................................................................ 58
Figure 58: Keep network settings ................................................................................................................................. 59
Figure 59: Perform update............................................................................................................................................ 59
Figure 60: APPMODULE - Remote Access HOOC ......................................................................................................... 60
Figure 61: System Information...................................................................................................................................... 61

APPMODULE Documentation
6
BAB TECHNOLOGIE GmbH
1APPMODULE
Thank you for buying the APPMODULE. The APPMODULE is a unique integration server 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)

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
7
1.1 FUNCTIONAL OVERVIEW
The APPMODULE links building automation to third-party applications that otherwise cannot be
controlled by building control. The connection is established with applications that can be installed on
the APPMODULE. You can select your very own combination of apps, and purchase individual apps from
the BAB APPMARKET (https://www.bab-appmarket.de/de/). The APPMODULE is 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 download of the purchased applications, there is the option of integration into the
terminal configurator including the purchase of a Smart Home App.
Figure 2: APPMODULE –How it works
You can find the APPMARKET on https://www.bab-appmarket.de/

APPMODULE Documentation
8
BAB TECHNOLOGIE GmbH
1.3 TECHNICAL DATA
Article No.: 10491 (IP) | 10495 (KNX) | 13501 (EnOcean)
Operating voltage: 12-32V DC
Typical power consumption 300 mA at 12V DC
Power consumption: <= 5 W
Connection: Power supply via screw-type terminal
Resistant to climate: EN 50090-2-2
Ambient temperature: -5 to +35 °C
Rel. humidity (non-condensing): 5% to 80%
Mechanical data
Assembly: Modular device (REG) housing 4 TP
Dimensions (W x H x D) in mm: 70 x 90 x 63
Housing: Plastic
Degree of protection: IP20 (according to EN 60529)
Interfaces:
Ethernet over RJ-45 female connector
KNXconnection
EnOcean®: external SMA antenna
EnOcean specifications:
Operating frequency: 868.3 MHz
Range: 300 m in free space / 30 m in buildings (varies depending on building material)
Input 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
Browser: current standard browser
1.4 SCOPE OF DELIVERY AND INTERFACES
The scope of delivery of APPMODULE includes the following content:
1x APPMODULE IP, KNX or EnOcean (currently being planned)
1x enclosed CD
1x 2.50 m antenna with magnetic base (for EnOcean only)
A power supply unit for the device is NOT included in the scope of delivery!
In addition to the connection for the power supply (12-32 V DC), the APPMODULE has the following
interfaces:
1 x RJ 45 Ethernet 100Mbit/s Full Duplex
KNX® / TP connection or SMA female connector for EnOcean (planned)

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
9
FACTORY SETTING ON DELIVERY:
IP address: 192.168.1.224
Username: "admin"
Password: "admin"
SERIAL NUMBER / REGISTRATION KEY
The Serial Number (SN) and Registration Key are required to register the APPMODULE. You will find both
as stickers on the packaging, in the quick start guide and as well on the backside of your device.
1.5 UPDATES
We reserve the right to offer firmware updates free of charge for the APPMODULE. We inform you about
new firmware in our newsletter or on our homepage. The update files are available in the download
section on our homepage.
www.bab-tec.de
1.6 IMPORTANT INFORMATION ON THE OPERATING
INSTRUCTIONS
We reserve the right to make technical and formal changes to the product in 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 be considered during planning and implementation. When using
the APPs in the APPMODULE, there are interactions with many devices/connections (e.g. Internet) in the
system, which may lead to risks. Especially failure of individual devices or functions or connections can
lead to malfunction of the system. There are different ways to minimise the risks. That depends on the
system and customer requirements.
These measures must always have the required independence from the operation of the system (APP
MODULE with APP) and must always be available.

APPMODULE Documentation
10
BAB TECHNOLOGIE GmbH
Figure 3: APPMODULE connection diagram
2ASSEMBLY
The operating voltage of the APP MODULE is 12-32 V DC
The device shown here is the APPMODULE KNX (form factor identical for all models), REG housing 4 TE.
Dimensions (width x height x depth): 70 x 90 x 63 mm
In order to ensure easy connection of the 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-in terminal
(2)
Power supply via screw plug-in terminal 12-32V DC
(3)
USB connection (is not activated)
(4)
RJ-45 female connector for Ethernet LAN

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
11
2.1 LED STATUS
The APPMODULE has two DUO LEDs ("Power/Boot" and "Status"). Each DUO LED has a green and a red
LED.
POWER / BOOT LED
LED display
Status
OFF
The device is not ready for operation. No operating
voltage is supplied.
GREEN
The device is ready for operation.
FLASHING ORANGE
The device is booting.
STATUS LED
LED display
Status
OFF
The device is booting.
FLASHING GREEN
The device has been 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 completed. Then the LED is permanently illuminated green, while
the "Status" LED flashes green (simulates a "heartbeat"). The flashing frequency increases depending on
the device utilisation.
It takes approx. 2 minutes to start the APPMODULE.

APPMODULE Documentation
12
BAB TECHNOLOGIE GmbH
2.2 INITIAL OPERATION
If the APPMODULE has been mounted and started as described in chapter "Assembly", commissioning
can now be continued as specified below.
Factory setting on delivery:
IP address
192.168.1.224
Subnet mask
255.255.255.0
Username
Admin
Password
Admin
Device Name
AppModule
Note: The password must be changed immediately when logging in for the first time. If the password is
lost, the device cannot be reset!
2.2.1 LANGUAGE
Web interface
The language used for the APPMODULE Web interface is based on the language set in the browser.
German and English are currently available in the APPMODULE. If the browser is set to a language other
than German or English, English is displayed in the APPMODULE interface.
Java application (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 Explorer
If applicable, an app from the APPMARKET (https://www.bab-appmarket.de/de/)
For EnOcean configuration: BAB STARTER or current JVM & JVM browser plugin
2.2.3 ESTABLISHING CONNECTIONS
In order to configure the APPMODULE, a current browser and a network connection to the device are
required. If the device is in the condition of delivery, it can be accessed at the above-mentioned IP
address and the network settings must be adjusted to the address range, where necessary. Please follow
the information given in the chapter " Adjusting the network settings of your computer " for this
purpose.

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
13
CALLING UP THE APPMODULE WEB INTERFACE
The APPMODULE is configured via its web interface so that it can be configured via each web browser.
The "EnOcean Editor" layers are Java applications and also require a Java Virtual Machine (JVM) or the
BAB STARTER (see " Establishing connections ").
In order to call up the web 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 in to the web interface: "Log In". (Information on the authorisation
settings can be found in chapter " Initial Operation ")
Figure 5: Logging in to the web interface

APPMODULE Documentation
14
BAB TECHNOLOGIE GmbH
You can then also access the "Configuration" menu item. See chapter " Configuration "
Figure 6: "Configuration" menu item
To return to the main menu, just click on the header graphic.
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 Network and Sharing Center

APPMODULE 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

APPMODULE Documentation
16
BAB TECHNOLOGIE GmbH
Now note down the current IP address settings or take a screenshot in order to ensure that you
can reset the IP address setting following the configuration of the APPMODULE.
Now change the IP address settings (IP address and subnet mask) as required:
Figure 11: TCP/IPv4 properties
Example of a valid configuration for the factory settings of the APPMODULE:
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 steps described above as soon as you have configured the APPMODULE
correspondingly.
If the IP address of your PC and your APPMODULE are in the same network mask, you can continue with
the configuration.

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
17
ADJUSTING THE NETWORK SETTINGS OF THE APPMODULE
If the network prerequisites have been created, you can now access the configuration of the
APPMODULE in order to adjust the network settings to the local requirements there. To do this, please
proceed as described below:
Enter the IP address of the APPMODULE in the address line of your 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: Logging in only works if the browser is authorised to save cookies!
The view on the start page changes. You can now access the following levels:
App Manager
Configuration
Information
Log Out

APPMODULE Documentation
18
BAB TECHNOLOGIE GmbH
In order to change the IP address of the APPMODULE, please click "Configuration"
Figure 14: APPMODULE –Main Menu
The configuration menu opens up. You can make the following settings in the "Network" menu item:
DHCP:
If the DHCP service is enabled, the device will automatically obtain the network
settings. The DCHP service assigns the IP address, the network mask and the
default gateway to the APPMODULE. Therefore, a DHCP server, in private
networks mostly the router, must be available in the local network.
Note: If the DHCP service fails, the APPMODULE gets that with and is then
reachable under the default IP address, network mask and standard gateway.
Translated 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 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- or
UPnP services do not work.
NTP server:
NTP is a free service for synchronising the system time of Internet-compatible
devices. If it is not possible to establish the connection to an NTP-Server, the
system time must always be checked and adjusted manually (see menu
" General ")
NTP-Server list: e.g. http://www.pool.ntp.org/zone/europe

APPMODULE Documentation
BAB TECHNOLOGIE GmbH
19
Figure 15: APPMODULE Network configuration
Change the IP address settings as required. In order to save the settings made, click "Save
Configuration". The server in the device is restarted, the browser automatically 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 chapter “Network” to find out the current IP-address.

APPMODULE Documentation
20
BAB TECHNOLOGIE GmbH
3APPMODULE IP
The IP APPMODULE (10491) is an IP for EIBPORT available thanks to the facility coupling protocol
implemented. A KNXnet/IP server is also implemented.
3.1 CONNECTING THE APPMODULE IP TO EIBPORT
Before the APPMODULE can communicate with EIBPORT, facility 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 interface can be found in “ Calling up the APP MODULE web interface”.
Figure 16: APPMODULE IP Interface Extension