Digital Concepts EnOcean DC-GW/EO-IP User manual

<< Click to Display Table of Contents >>
Manual
Smart EnOcean Gateway
DC-GW/EO-IP
Manual
Contents
1. General information
2. The Webinterface
2.1 Menu point "Admin"
2.2 Menu point "EnOcean"
2.3 Menu point "Internet of Things"

1.GENERAL INFORMATION
English edition 05/2016 Documentation © 2016 Digital-Concepts GmbH, Germany
All rights reserved. This manual may not be reproduced in part in any form or duplicated using electronic, mechanical
or chemical processes or processed without the written permission of the publisher.
It is possible that this manual has printing technology defects or typographical errors. However, the specifications of
this manual are regularly reviewed and corrections are made in the next issue. For technical or printing errors and
their consequences Digital Concepts GmbH assumes no liability.
Before using the Gateway, please read these instructions carefully. If you pass the product on to third parties, give
them this manual, too.
More information, associated software, as well as the latest version of the manual can be found on our website
www.enocean-gateway.eu
This handbook should be seen as an extension of the Quick Start guide "Quick Start" which Digital Concepts already
attaches to your product. It describes in detail, both the properties of the gateway, the menu structure, as well as the
processes that are necessary for start-up and subsequent operation.
For installation instructions and basic information about the physical start-up, please look at our " Quick Start " !
Technical notes [FAQs] and downloads are available
on our homepage: www.enocean-gateway.eu
If you have technical problems or comments, please
directly contact
support from Digital Concepts
GmbH.
Phone: [phone] – 70
E-mail: [e-mail]
Hazard statements:
•Do not use for purposes other than the intended use.
•
Use only indoors and avoid external influences such as
moisture, dirt/dust and sunlight or other heat load.
•Avoid repositories enclosed by metal, as these affect the
transmission power. If a mount in DIN rail is to be made,
precautions should be taken to mount the antenna outside
the control cabinet.
•Do not open the device. In case of failure, please contact the
DC support team.

2.THE WEBINTERFACE
The web interface is primarily used to:
•commission and configure the gateway
•Register and configure the EnOcean components
•Monitor the transmitted states (telegrams)
•Analyze errors in the system
The menu structure
For easy navigation, the complete menu structure of the gateway is shown here. The manual is based on this order and
explains the individual areas .
Menu item "Login" - registration at the gateway.
Discovering the gateway is described here

If a physical connection is established, you should see the logion page of the gateway.
You have to enter a password. The default password is “admin”. Please change it afterwards.
Menu item “Admin“
All administrative settings and values which are fundamentally important for the gateway can be configured here.
System Info - General Info System
After a successful login the system information page is shown.

As the name implies, you can view basic information here regarding the current state of your gateway.
Version: actual software release of the gateway
•Do you have the latest firmware? – see section: Firmware
State & Date: actual time & clock settings
•Possibilities for adjusting can be found under the menu item "Date & Time”
Uptime: Uptime since last reboot
Load: Load of the Gateway. As the hardware consists of a multiprocessor, there can be a load of above 100%.
LAN Interface: The actual network configuration of the gateway
•Possibilities for adjusting can be found under the menu item "Ethernet”

Port Settings: Current port setting for the two API versions with password
•Possibilities for adjusting can be found under the menu item „API Port Settings“
•Notes on the API can be found in the "API Port Settings" menu or in the corresponding API descriptions in the
download section of the Gateway website.
EnOcean Chip: Information on the current status of the EnOcean chipset.
Base ID: Base ID of the gateway
Chip ID: Serial number of the EnOcean chipset
Filter Mode: When enabling the filter mode, only telegrams of learned-in devices are transmitted though the
gateway on the API and on the Telegram menu. Default is off. This is used to limit the output of the gateway only
to the desired devices.
oPossibilities for adjusting can be found under the menu item „EnOcean Chip“
Number of devices: Number of currently learned-in devices.
Password – Changing the password
In order to protect the gateway from unauthorized access it is strongly recommended to change the factory-set password
[factory setting: admin]. Make sure that your password is not too complex. It is not possible at this stage of development
of the gateway to reset the password.
Date & Time – Configuration of date & time
In this menu the appropriate time settings of the gateway can be made. The gateway provides the ability to sync via the
Internet service NTP. To do this, enter your favorite NTP server. Alternatively, the time can also be entered manually.
However, this can lead to variations in the time after a certain period of operation.
Ethernet – Network setting of the gateway
In this menu you can adjust the Gateway IP settings according to your environment. By default the gateway is in DHCP
mode (Dynamic Host Configuration Protocol), in which the gateway gets its IP-settings automatically transmitted from the
server/router. If you prefer manual adjustment you can change the mode from DHCP to Static and enter your desired
values.
ServiceIP: Besides the above-mentioned possibilities, the gateway also provides a ServiceIP. This IP address cannot be
changed and is for the purpose of support. This IP address is: 192.168.66.69.

EnOcean Chip
Each gateway includes an EnOcean communication chip with an individual chip ID. This chip ID is similar to a serial number
and unchangeable.
API Settings – Port configuration of Simple API & JSON API
This menu allows the ports and passwords for both APIs to be set individually. There are several ways you can check the
output of the gateway of each API:

Simple String API
Using the freewaretool “PuTTY” and the configuration of the Gateway API, it is easy to connect to the Simple API and look
at the output.
Start the software, define the IP as required and choose „telnet“ as connection type. After setting the port to the
corresponding Simple API port (default 9090), you can start the connection.
In the window shown you can see the connection startig with the actual version of the gateway. Press return and
login with the desired user. (Default password: user)
login; password=user
Now you can see all the incoming and outgoing telegrams – one command per line.
Restful JSON API
The default port for the JSON API is <IP of gateway: 8080>. Here the gateway shows all the features that it offers
with an easy to understand interface. The full range of functions is displayed and the syntax of the calls may be
tested at any time extensively.
To use the JSON API, point your browser to the address <IP of gateway: 8080> and log in with as a user with the
appropriate password. You now have reached the Help page of the JSON API. The coding of the JSON API is "UTF-
8".
A detailed description of the Simple String & Restful JSON API can be found at the download section of: www.enocean-
gateway.de

Menu Item "Import/Export" – Backup and restore of configurations
•Export of the Gateway configuration
The complete configuration and settings of the gateway can be saved in a configuration file "dcgw.conf". Press the
"Export" button and select the destination folder according to your browser.
The following information is saved:
-Network settings
-EnOcean Settings (API settings)
-Device Database (Sensors and actuators)
•Import of the Gateway configuration
To load a configuration file into the gateway, please drag the configuration file (e.g. dcgw.conf) to the field
"Upload" (drag'n'drop). Three possible sections show up for you to choose what part to import.

Menu Item System – How to update the firmware
The Digital Concepts EnOcean Gateway will be improved over time with new profiles and new functionalities.
These improvements (new firmware) will be available on the homepage www.enocean-gateway.de in the support section
and will have to be uploaded in the firmware menu of the gateway.
As described in the menu “Import/Export” please drag and drop the new firmware to the field “Upload”
The gateway will check the file before starting an update process. Nothing will happen if the file is not suitable.
Menu item “EnOcean”
This menu contains management options for connected EnOcean devices. The options include learning-in (pairing) of new
devices, editing features and communication settings for existing devices, and deleting sensors and actuators from device
database.