gMUC User Manual
gMUC User Manual
gMUC User Manual
50 User Manual
Date: 29.04.2013
gMUC Configuration
Date: 29.04.2013
gMUC Configuration
Contents
1 Introduction .............................................................................................................................................................................. 4
2 Status ...................................................................................................................................................................................... 5
2.1 System ............................................................................................................................................................................. 5
2.2 Meters .............................................................................................................................................................................. 6
2.3 Log ................................................................................................................................................................................... 7
3 Configuration ........................................................................................................................................................................... 8
3.1 System ............................................................................................................................................................................. 8
3.2 WAN ................................................................................................................................................................................. 9
3.3 LAN ................................................................................................................................................................................ 13
3.4 Update ............................................................................................................................................................................ 13
3.4.1 Uploading the firmware ........................................................................................................................................... 13
3.4.2 Activating the firmware ............................................................................................................................................ 14
3.5 Meter .............................................................................................................................................................................. 14
3.5.1 Special Notes for the configuration of a MBUS meter ............................................................................................. 15
3.6 Interfaces ........................................................................................................................................................................ 17
3.7 MODBUS ........................................................................................................................................................................ 18
3.8 Learn-Mode .................................................................................................................................................................... 18
4 Security.................................................................................................................................................................................. 22
5 Formation rules for W-MBUS address ................................................................................................................................... 22
6 OBIS Mapping ....................................................................................................................................................................... 23
7 Push ...................................................................................................................................................................................... 24
8 Automatic meter configuration and activation ........................................................................................................................ 26
9 Appendix................................................................................................................................................................................ 27
9.1 List of abbreviations........................................................................................................................................................ 27
10 Copyright Statement .......................................................................................................................................................... 28
Date: 29.04.2013
gMUC Configuration
Date: 29.04.2013
gMUC Configuration
1 INTRODUCTION
This manual explains the options for configuring a gMUC. The parameters for the gMUC are set using a web configuration. You
require the use of a browser (e.g. Internet Explorer). A secure connection (https) to the configuration interface is set up in the
address bar in the browser. The default IP address is set to 192.168.186.10. The username is admin, the password is admin.
(i.e. https://192.168.168.10).
Once you have registered, the following start screen will appear:
The start screen shows the explicit gMUC ID and the existing hardware options for the gMUC. All external interfaces are labeled
on the illustration.
At the top edge of the screen, you will find the configuration menu, which will be explained in more detail in the following. The
chapters after that are based on the menu structure. The entire web configuration was created in English.
Date: 29.04.2013
gMUC Configuration
2 STATUS
1
The Status section provides information on the current status of the gMUC. It cannot be altered . The information available
includes status variables, the meters available and the log.
2.1 System
This indicates the internal status variables that are currently set in the system. These are system-specific and service-specific
variables the number of which depends on the operating mode used (GPRS, DSL) and the hardware.
1
To alter the parameters, see Chap. 3
Date: 29.04.2013
gMUC Configuration
2.2 Meters
This screen shows a list of the available meters. Further details on the meter are also shown for each entry (address, measured
variables, etc.).
Before the values from one of the meters are recorded by the gMUC, that meter has to be activated to do so, click the button
marked Activate, which appears if the meter is not yet registered in the gMUC.
For W-MBUS meters, the W-MBUS identifiers are mapped on standardized OBIS numbers in the gMUC. If this mapping
process is incomplete or defective for a meter, this will be displayed on the screen. The mapping then has to be adjusted
accordingly in the gMUC. If the meter data received from a W-MBUS meter is encrypted, the meter must first be activated (click
Activate), and then store the corresponding AES key in the configuration of the meter (Chapter 3.5).
Date: 29.04.2013
gMUC Configuration
2.3 Log
The operating events generated in the system are stored in a log, which can be read out on this screen. Among other things, it
provides information on any errors that have occurred and system messages. Click the button marked Delete to permanently
delete the information currently in the log.
Date: 29.04.2013
gMUC Configuration
3 CONFIGURATION
The section on Configuration explains how to configure the parameters for the gMUC.
3.1 System
The System screen can be used to alter the registration information (username / password) for the web configuration. The
gMUC system time (UTC) is set here and you can also trigger a restart of the gMUC.
WebUI access configured the client authentication (HTTP Digest) for the WAN interface. If no user/password assigned, the
client side authentication is disabled.
In the section "System Time", the system time of the gMUC can be called/changed. If the time is synchronized by a NTP time
server, the field is disabled. The value "local offset" indicates the time offset of the current time zone in which the gMUC is in
hours (time difference from UTC). The automatic use (switching) from summer / winter time can also be switched on / off.
Date: 29.04.2013
gMUC Configuration
3.2 WAN
This screen is used to configure the WAN (Wide Area Network) interface for the gMUC. Before you can use the WAN interface,
it has to be activated. The WAN interface is always the rear Ethernet RJ45 jack on the gMUC.
There are four different ways in which the device can be reached via WAN:
IP, PPPoE, DHCP and GPRS.
Date: 29.04.2013
gMUC Configuration
IP
- In this case, the gMUC can be given a fixed static IP address, at which it can be reached in the WAN network
(e.g. Internet/Intranet).
- As a rule, this configuration is used for testing only.
PPPoE
- This option is used to configure a PPPoE dial-up onto the Internet using DSL technologies.
- The username and the password for DSL access must be stored here.
- The gMUC must be connected to a DSL modem with its WAN interface.
DHCP
- In this operating mode, the gMUC is operated on an existing DSL router.
- The router performs the DSL dial-up itself and has to be configured as the DHCP server.
- The gMUC then serves as the NAT client behind the router and gets its IP parameters (IP address, DNS, etc.) via the
DHCP protocol from this router.
- It is not necessary to configure special parameters in the gMUC.
- The gMUC must be connected to the router with its WAN interface.
GPRS
- This option is used for the configuration of a GPRS dial-up on the Internet.
- The gMUC must have a valid SIM card; the SIM-card parameters (PIN, username, password) must be configured
accordingly.
- The network operators APN (Access Point Name) also has to be entered.
DNS
- This is where you can configure a static DNS server for an Internet name resolution.
- As a rule, this only makes sense in the IP operating mode because the DNS server is configured automatically in the
system in all the other cases (PPPoE, DHCP, GPRS).
Date: 29.04.2013
gMUC Configuration
DynDNS
- This is where you can configure a DynDNS Internet service.
- This makes it possible to address the gMUC under a fixed symbolic, non-ambiguous name on the Internet instead of
using the devices IP address, which can change under certain circumstances (e.g. new Internet dial-up).
- The configuration parameters depend individually on the DynDNS service used.
- The following placeholders are available to define a DynDNS update request in general:
- The update request cannot contain any "".
Placeholders Meaning
<username> DynDNS username
<password> DynDNS password
<gmuc-id> gMUC ID
<domain> DynDNS domain
<public-ip> Public Internet IP address (e.g. assigned via PPPoE or STUN)
<private-ip> or <local-ip> Local IP address (e.g. assigned via fixed IP4 or DHCP)
domain:
gmuc.dnsalias.org
update request:
-u <username>:<password> -a <public-ip> -h <domain> -S dyndns
domain:
002569627165.no-ip.org
update request:
-u <username>:<password> -a <public-ip> -h <domain> -s dynupdate.no-ip.com -S dyndns -g
/nic/update?username=<username>&password=<password>&hostname=<domain>&myip=<public-ip>
Ping
- to check the IP connectivity, servers can be configured to be pinged at configurable intervals
- up to three servers are adjustable
- interval defines the period in seconds, a server is pinged
- length defines the length of the payload
- repeat defines the number of retries after an unsuccessful ping attempt
- after timeout seconds a ping request have to be acknowledged
- after Retrying repeat +1 times on every configured server the WAN connection will be restarted
- the WAN restart period is random between 1 s and 60 s
- a repeating disconnect of the WAN connection because of an unsuccessful ping session results in doubling the
WAN restart period
- once the WAN restart period is higher than 3600 s, the increasing is stopped
NTP
- The NTP protocol is used to synchronize the gMUC time.
- It is possible to enter the NTP server and the interval, in which a synchronization process takes place.
- As a rule, the gMUC uses UTC (Universal Time Coordinated) time internally.
Remark
In the Group 'NTP', the NTP servers are specified, and the interval at which a synchronization is performed.
The set NTP period cannot be set exactly to any second, but only on powers of two.
24 = 16, 25 = 32, 26 = 64, 27 = 128, 28 = 256, 29 = 512, 210 = 1024, 211 = 2048
, 212 = 4096 ... 217
The gMUC completes the calculated power, i.e. be set to 2048 sec 3600 sec (34min). The next highest value is 4096 seconds
(68 min). The maximum value is 217 seconds. If it is determined that the system time is stable, the round trip time is
Date: 29.04.2013
gMUC Configuration
automatically increased by the NTP service NTP standard algorithm. The NTP service regulates the system clock and
ensures that no time jumps occur due to the synchronization!
Date: 29.04.2013
gMUC Configuration
3.3 LAN
This screen is used to configure the data for the service interface (front Ethernet interface). The IP address and the network
mask can be configured. The service interface is a prerequisite for web access. The default setting for the IP address is
configured to 192.168.168.10.
3.4 Update
Updates are available for the firmware on the gMUC. This is done in two steps:
Upload and activate the firmware. The firmware versions already loaded onto the device will also appear on the list. A total of up
to three different firmware versions can be stored on the device.
The firmware version that initially comes with the device cannot be overwritten or deleted. The user can choose from between
two versions by activating the desired version.
Once the upload has been successfully completed, the new firmware version will appear on the list of firmware versions. Should
an error occur, an error message will appear on the screen.
The firmware that was uploaded is now available on the device and ready for activation.
Date: 29.04.2013
gMUC Configuration
If you want to activate the new firmware, you have to click the corresponding Activate button in the list to replace the previous
version with the newly activated one. The system will be restarted automatically.
This completes the activation process. The previous version of the firmware will remained stored on the device and can be
reactivated at any time.
Only one version of the firmware can be active at any one time. Once the firmware has been activated, the gMUC will not be
available again until the restart has been completed.
3.5 Meter
This is the screen you use to add meters and to configure meters that have already been activated (cf. Chap. 2.2).
Several loggers can be added to a meter, configured and also removed from the meter. The following values must be entered
for a logger:
- the logger name (the following are already predefined: 15m, 1d, 1h, 1m, 1mon)
- the logger time interval (the following are defined: MINUTE, 15 MINUTE, HOUR, DAY, WEEK, MONTH, YEAR)
- the max. size (number of entries) for the logger
- the OBIS ID for the measurement to be recorded
- the PUSH parameters
Example: RS485,1107,Baudrate=300,NTP,ADDR=00000001
Example: WMBUS,MBUS,ADDR=38000226
Example: RS232,SML,Baud rate=9600,meter,ADDR=01A815671833020102
Example: RS485,DLMS,Baudrate=115200,NTP,Hdlc=100.17.1,Password=12345678
Example: RS485,MODBUS,ADDR=2,Baudrate=9600,Register0=HR:0:uint16,Register1=HR:1:uint16
Date: 29.04.2013
gMUC Configuration
The MBUS specification defines two types of addressing a meter. primary addressing an d secondary addressing. Most meters
support both types. MUS V2 supports only secondary addressing.
To configure MBUS meter the secondary address (4 bytes BCD encoded) have to be specified in parameter ADDR.
The secondary address corresponds to the serial number printed on the meter. Leading zeros have to be filled up to a size of 8
digits. When using secondary addressing the following three parameters have to be correct: secondary address, medium, meter
software version (0-255).
In case of unknown parameter, placeholder can be used.
- secondary address: FFFFFFFF
- medium: X (intern 0xFF)
- meter software version: keep empty or 255 (decimal representation)
Every meter responses, whose own parameters matches with configured ones.
Date: 29.04.2013
gMUC Configuration
Some meters responses with more than one messages. To get additional responses the optional parameter Responses have to
configured. The default setting is Responses=1. The number of responses a meter provided, can be found in the datasheet.
Commands send to a meter, will not be responded in the same way for different meters. The optional parameter OPTIONS
handle those deviations.
The Elster MBUS PR6 meter responds to the command SND_NKE whether this meter has been addressed or not. Meters that
can provide more than one responses, require the command SND_NKE. Consequently the simultaneous operation of a meter,
that provides more than one response, and the PR6 module does not work reliably. Alternatively, meters have to be configured
with Responses=1 to work in combination with a PR6 module.
Date: 29.04.2013
gMUC Configuration
3.6 Interfaces
2
The Interfaces screen lists the meter interfaces available on (RS485 / WMBUS ). Additional options can be indicated for each of
these interfaces.
The options provided for an interface must be separated from each other by commas.
Possible options include:
2
Wireless M-Bus
Date: 29.04.2013
gMUC Configuration
Example configurations
3.7 MODBUS
The query of certains registers of a MODBUS sensor must be configured in the meter options using the parameters
Register0..n=function:address:format:
- Query function (HR - holding register, IR - input register)
- Register start-adress (integer)
- Register data format (uint16, uint32, float, floatinverse)
Syntax: Register[0..n]=function[HR,IR]:adress:format
Example: Register0=HR:0:uint16, Query of the holding register with start adresse 0, data format integer
Example: Register1=IR:2:floatinverse, Query of the input register with start adresse 2, data format floatinverse
The registers must be mapped in the OIDMAP (chapter 6) to the Obis numbering system.
3.8 Learn-Mode
The learn mode is used for automatic detection of not activated meters. Notice the following facts when using the learn mode:
1107
While the learn mode is active only one meter should be connected via RS485, otherwise there will be collisions on the bus and
no data can be read out. This meter will be requested with an empty address. If the answer contains the real address it will be
read out.
Date: 29.04.2013
gMUC Configuration
After detection of the meter, the learn mode has to be switched off.
Some 1107 meters do not support this type of request (empty address). In this case the meter has to be added manually.
DLMS
The DLMS meters of the manufacturer Sagem use a further protocol (CIASE). With this protocol the Sagem DLMS meters
connected to the RS485 are detected. While detection, the meters recieve an MAC address, i.e. the learn mode is necessary for
the first start. To ensure this, add Learn=DLMS to the interface configuration (s. Figure 10). After a successful
detection/activation of the new Sagem meter, the learn mode option has to be removed from the interface configuration.
The learn mode is also activated automatically on faulty DLMS requests and manually meter configuration for a short time.
Date: 29.04.2013
gMUC Configuration
4. Activation of the new meter and adjustment of the logger on the page Configuration Meter
Date: 29.04.2013
gMUC Configuration
5. After the next request of the meter ist values are shown on the page STATUS\meter:
6. deactivation of the learn mode in the interface configuration (s. Figure 10) by removing the option Learn=DLMS
Date: 29.04.2013
gMUC Configuration
4 SECURITY
For safety reasons, there is an active firewall on the gMUC that routes only the following IP ports:
80 (http)
443 (https)
22 (SSH, SFTP)
This means, for example, that a gMUC does not respond to an ICMP (ping) query.
Date: 29.04.2013
gMUC Configuration
6 OBIS MAPPING
Inside the gMUC all meter data will be managed by a number OBIS number. This numbering system is for example in WMBUS
protocol and MODBUS not supported. The DLMS protocol need additional parameters (attributes and class), that must be
configured for a meter data query.
The mapping is done by specifying the protocol (protocol=mbus,dlms,modbus) and by special protocol parameters that lead to
compliance with OBIS mapping to the specified OBIS number/name. When mapping, the unit (unit) and scaling (scale) of the
scaler
measured value can be specified. The scaler is using the formula: value = value * 10 applied to the measured value.
Date: 29.04.2013
gMUC Configuration
7 PUSH
The Push page configured the Push jobs of the gMUC. The Push feature will be periodically sent meter data from the gMUC to
an FTP or HTTP server. The transmitted data is sent in XML structures. Using FTP Push, a XML file will be sent to the FTP
server. Using HTTP Push, the same XML data will be sent as content of the html file. The push XML data structures are
described in the document gMUC_XML_Interface_vEN.doc.
Date: 29.04.2013
gMUC Configuration
For the configuration of the URI (FTP file name, HTTP query string) wildcards are available with which one can realize a
dynamic run-time implementation. The configuration of the URI is optional and must be coordinated with the server. When you
push the FTP directory, the structure of the given file name on the server is automatically created.
In the meter configuration, each logger profile will be assigned to a push job. Is this configured, the meter data of this logger will
be pushed to the corresponding push target. The push interval of a logger can be configured individually. It need not be identical
to the recording interval (period). E.g. In the example below, the 15 minute values are pushed all hours. In the corresponding
XML files you will find 4 data points.
To the push interval a random offset time in minutes can be configured. I.e. Push the actual time is a random time offset
between 0 .... Offset added to it. Thus, a load distribution for the push servers are achieved when using many of the same push
gMUC's interval and push server. The offset can have a maximum size of the push interval of the logger, but not greater than
300 minutes.
The Push of every meter can be enabled / disabled loggers across. It is also possible to enable/disable the push for every
single logger (check box).
If the checkbox RAW enabled, the raw protocol data (undecoded) received from the meter will be append to the XML data
structures.
Comment:
When using the FTP protocol (http://en.wikipedia.org/wiki/Ftp), the passive mode is used. The EPSV command will be used for
that. The gMUC initiated all TCP-connections to the FTP Server.
Date: 29.04.2013
gMUC Configuration
In this case a new meter will be configured and activated in the gMUC. All necessary meter parameters be used from the meter
data packet (meter number) as well as from the template (logger configuration, push configuration).
Furthermore, a push target is created and/or configured when to corresponding entries are available in the template. This Push
target is linked internally to the new meter.
Date: 29.04.2013
gMUC Configuration
9 APPENDIX
Abbreviation Meaning
APN Access Point Name
DHCP Dynamic Host Configuration Protocol
DLMS Device Language Message Specification
DNS Domain Name System
DynDNS/DDNS dynamic Domain-Name-System
GPRS General Packet Radio Service
GSM Global System for Mobile Communications
IP Internet Protocol
LAN Local Area Network
gMUC Multi Utility Gateway
NAT Network Address Translation
NTP Network Time Protocol
PIN Personal Identification Number
PPPoE Point-to-Point Protocol over Ethernet
SIM Subscriber Identity Module
STUN Session Traversal Utilities for NAT
WAN Wide Area Network
MBUS / M-Bus wired Meter Bus
WMBUS / wMBUS wireless Meter Bus
Date: 29.04.2013
gMUC Configuration
10 COPYRIGHT STATEMENT
The information released in this publication is under copyright. Any translation, reprints, duplication and/or storage in data-
processing systems requires the express consent of Dr. Neuhaus Telekommunikation GmbH.