Support Center

DEXGate Full User Manual

Last Updated: Aug 21, 2015 05:01PM CEST

Menu

  1. Device Information
  2. Quick Start
  3. Accessing the web administration interface
  4. System information
  5. System configuration
  6. Wired network
  7. Remote Access
  8. Debug
  9. Data Sources
  10. Modbus Configuration
  11. Modbus Custom Devices
  12. 4Noks Configuration
  13. Kromschroeder Configuration
  14. IEC 870-5-102 Configuration
  15. Update
  16. Reboot and Halt
  17. Change password


 

Device Information



Ports

Serial port: 1 RS232 port
Eth0: Power over Ethernet port. The default address is 192.168.1.150. PoE capable.
Eth1: Ethernet administration port. It uses the address 172.16.0.1. Provides a 172.16.0.x IP address.
USB: 2x USB 2.0 
DC in: Power input 7-20V

  

Specifications

Processor: AMD Geode LX800 500MHz
DRAM: 256MB DDR DRAM.
Power requirements: 7V - 20V DC (PoE or DC in).
Expansion ports: Minipci – Minipci Express (usb mode only).
Storage:4GB Compact Flash Card.
Size: 15,5*15,5 cm. aprox.
 

Compatible technologies

To get internet:
  • Ethernet
  • Wireless a/b/g (optional module)
  • 3G/GPRS (optional module)
 
To admin:
  • Web interface
  • Optional remote access by technical support via VPN
     
To get measures:
  • Modbus-RTU over RS485 (USB)
  • Modbus-TCP
  • 4-Noks for ZigBee devices
  • Kromschroeder
  • IEC 870-5-102


 

Quick Start

 

In order to start sending data we need to follow a 4 step process: configure the network, register the gateway, configure the meters and verify the reception.
 

Network configuration

The DEXGate is capable of connecting to the Internet using a cable, wireless or mobile connection:
 

Cable

  • Connect the network cable to the eth0 connector.
  • Prepare your computer to obtain a IP address using DHCP or assign an IP in the 172.16.0.2-254 range.
  • Connect another network cable to our computer and the eth1 connector.
  • Open your web browser and access http://172.16.0.1.
  • Log in (the default username and password are admin/admin)
  • Configure the local network accessing the section "Wired Network" (if you don't know how to configure it contact your systems administrator)


Wireless (only with the wireless optional module)

  • Prepare your computer to obtain a IP address using DHCP or assign an IP in the 172.16.0.2-254 range.
  • Connect another network cable to our computer and the eth1 connector.
  • Open your web browser and access http://172.16.0.1.
  • Log in (the default username and password are admin/admin)
  • Configure the local wireless network accessing the section "Wireless Network" (if you don't know how to configure it contact your systems administrator)


3G/GPRS (only with the 3G/GPRS optional module)

  • Insert the SIM card before powering the DEXGate.
  • Prepare your computer to obtain a IP address using DHCP or assign an IP in the 172.16.0.2-254 range.
  • Connect another network cable to our computer and the eth1 connector.
  • Open your web browser and access http://172.16.0.1.
  • Log in (the default username and password are admin/admin)
  • Configure the mobile network accessing the section "Mobile Configuration" (if you don't know how to configure it contact your mobile network provider)


Configure the meters

We can divide the meters configuration in two steps:

  • Physical meter configuration
  • Bridge configuration
Every meter works in its own way, so we strongly recommend to read the user manual of the meter.
You can configure the bridge through the web administration interface. If you're using modbus devices you need to specify the address and type of each meter. It is important to configure properly the modbus address in order to indicate it on DEXGate system configuration.


Verify the reception

It takes a few minutes for a message to be processed and visible in www.dexcell.com. Although you can check if the messages have been obtained from the meter and send in the "Debug" section of the web administration interface of the DEXGate.


 

Accessing the web administration interface

 
  • Prepare your computer to obtain a IP address using DHCP or assign an IP in the 172.16.0.2-254 range.
  • Connect another network cable to our computer and the eth1 connector.
  • Open your web browser and access http://172.16.0.1.
  • Log in using your username and password (the default ones are admin/admin)


 

System information

 

This screen provides some basic information about the device:
  • Device name
  • Serial Number
  • Uptime
  • IP addresses
  • Disk usage
  • Memory usage
  • Internet connection (if the internet connection is restricted in any way the detection may fail)
  • Remote access
  • Current date


 

System configuration


This section is used to configure some basic parámeters of the DEXGate:
  • Device name: change the device name in order to differentiate various DEXGates inside the same local area network
  • NTP time synchronization: enable it to synchronize the time regularly with internet time.
  • Manual time adjust: some networks don't allow ntp time syncronization. This option allows manual modification of the DEXGate time


 

Wired network

 


There are 2 wired network interfaces: eth0 and eth1. Eth1 is not configurable and it's set to 172.16.0.1. Eth0 can be configured to use DHCP or to use a static IP address. Please contact your systems administrator to obtain the configuration.



 

Remote Access



DEXGate can be remotely administered by an engineer from DEXMA in order to diagnose several problems. In order to accomplish that the DEXGate establishes a VPN connection that allows bidirectional connection. This VPN connection uses the port 1196 UDP. The DEXGate needs to be registered in order to connect to the VPN server.
The DEXGate is prepared to connect to vpn.dexcell.com. If you need to connect to another server you'll need to update the certificate to be able to connect to the new server. You can download it from the server or upload it manually from your computer.


 

Debug

 


This section provides information on various processes running in the DEXGate. This are the most frequent messages:

  • INFO [MBusManager :: main]  - <Publishing 72messages to the  server>: 72 messages have been read from the meter(s) and are being sent to the server
  • INFO [JSONMessagePublisher :: main] - <Insert server response: OK>: Messages correctly received by the server
  • [MBusManager :: main] - <FOUND: 2 nodes>: Number of configured devices
  • INFO [JSONMessagePublisher :: main]  - <Publishing to address: http://dexcell.com/insert-json.htm>: Messages are being sent to the server


 

Data Sources



In this section you'll find the state of various bridges. You need to refresh the webpage in order to update the values.

 

Modbus Configuration

 

This section provides a basic interface to modify the modbus bridge configuration. The most relevant parameters are:

Option Meaning
bridge.speed Speed of the local Modbus RTU bus
bridge.scheduled-polling-interval Polling interval of the bridge. Mínimum 2 minutes
proxy.host Proxy host
proxy.port Proxy port
hardcoded.server-url DEXCell server url address
hardcoded.gateway-mac This identificator will override the default one
Queue path File where the data is stored before sending it to the server. Do not change
remotebridge-mbX IP address and port (optional) of a remote modbus-TCP device or bridge in the format IP:port
devices.manufacturer-model Coma separated list of modbus addresses of devices of this kind
profile.manufacturer-model low (default), medium or high. The profile dictates the amount of parameters sent to the server
gateway.interface Interface used to get the id of the gateway. Do not change
bridge.device Local device where the Modbus RTU bus is connected. Do not change
bridge.ip IP of the local Modbus TCP/RTU bus. Do not change
bridge.port Port of the local Modbus TCP/RTU bus. Do not change
 

Profiles

There are 3 profiles: Low, medium and high. They are used to minimize the unnecessary data sent to the server.
Low:
  • Active Energy
  • Active Power
  • Reactive Energy
  • Reactive Power
Medium:
  • All Low Services
  • Apparent Energy
  • Apparent Power
  • Cos Phi
  • Power Factor
High: Everything
 

Example file

bridge.speed=9600
bridge.device=/dev/ftdi485
bridge.ip=127.0.0.1
bridge.port=9003
bridge.scheduled-polling-interval=15

# Proxy configuration
proxy.host=
proxy.port=

# Remote TCP Modbus bridges
remotebridge.mb1=10.123.12.32:502
remotebridge.mb2=
remotebridge.mb3=

# Ids of Accuenergy devices
devices.accuenergy-accuvimii=

# Ids of Atec devices
devices.atec-mdm3100=

# Ids of Brainchild devices (example 1[p1[403(100)];a2[500]],2[r2[100]] )
devices.brainchild-daio=

# Ids of Carlo Gavazzi devices
devices.carlogavazzi-em21=
devices.carlogavazzi-em24=

# Ids of Circutor devices
devices.circutor-cvm-mini=1
profile.circutor-cvm-mini=high
devices.circutor-cvm-96=
devices.circutor-cvm-144=
devices.circutor-cvmk=
devices.circutor-cvmk2=
devices.circutor-edmk=
devices.circutor-lm-4i-4o=
devices.circutor-lm24=
devices.circutor-lm50=
devices.circutor-mk30-60=
devices.circutor-mkd=
devices.circutor-nrg96=

# Ids of Electrex devices
devices.electrex-femto=

# Ids of Enerdis devices
devices.enerdis-cct=mb1:5[402(0.02);0;0;0;402(1);419(0.001);419(0.001);0]
devices.enerdis-enerium30=
devices.enerdis-enerium50=
devices.enerdis-enerium150=
devices.enerdis-ulys=
profile.enerdis-ulys=

# Ids of General Electric devices devices.generalelectric-MTDN3L=
devices.generalelectric-MTDN3R4M=

# Ids of Janitza devices devices.janitza-umg96rm=
devices.janitza-umg96s=
devices.janitza-umg103=
devices.janitza-umg508=

# Ids of Lovato devices
devices.lovato-dmg210=
devices.lovato-dmg300=
devices.lovato-dmg700=
devices.lovato-dmg800=
devices.lovato-dmg900=
devices.lovato-dmecd=

# Ids of Millenial/LEM devices
devices.millenial-emn=
devices.millenial-wizone=
devices.millenial-wistat=
devices.millenial-wipulse=
devices.millenial-witemp=
devices.millenial-meshnode=
devices.millenial-meshgate=

# Ids of Panasonic devices
devices.panasonic-kw1m=
devices.panasonic-kw2g=

# Ids of Schneider devices
devices.schneider-pm9c=
devices.schneider-pm710=
devices.schneider-pm800=
devices.schneider-sim=

# Ids of Siemens devices
devices.siemens-pac3100=
devices.siemens-pac3200=

# Ids of Socomec devices
devices.socomec-a10=
devices.socomec-a20=
devices.socomec-a40=
devices.socomec-e30=
devices.socomec-e40=
devices.socomec-e50=
devices.socomec-e60=
devices.socomec-eci2=

#Ids of Step devices
devices.step-thdg=

# Ids of 4Noks devices
devices.fournoks-thl=
devices.fournoks-thi=
devices.fournoks-tid-ci=

# Auto detect gateway ID using interface
gateway.interface=eth0

# Hardcoded properties, must be empty or they will be used overriding dynamic configuration
hardcoded.gateway-mac=
hardcoded.server-url=

# Properties about the queuedev
queue.path=/var/tmp/tempQueueMaster.txt

# Properties about publication
publish.local=True
publish.server=True


In this example there are 2 meters: 1 circutor cvm-mini and 1 enerdis cct. The circutor meter is connected to the local bus and the enerdis device is connected to a remote modbus-tcp bridge running on 10.123.12.32:502. The cvm-mini has the profile high active (it will send all the information available)
The cct is a 8 input pulse counter and its configuration is quite complex: mb1:5[402(0.02);0;0;0;402(1);419(0.001);419(0.001);0]
  • mb1: This device is connected to the remote bus 1 (10.123.12.32:502)
  • 5: The modbus address of the cct is 5
  • [
    • 402(0.02);: The first pulse input has a energy counter connected. Each pulse represents 0.02kWh
    • 0;: The second pulse input is disconnected
    • 0;: The third pulse input is disconnected
    • 0;: The fourth pulse input is disconnected
    • 402(1);: The fifth pulse input has a energy counter connected. Each pulse represents 1 kWh
    • 419(0.001);: The sixth pulse input has a gas counter connected. Each pulse represents 1l or 0.001m³
    • 419(0.001);: The seventh pulse input has a gas counter connected. Each pulse represents 1l or 0.001m³
    • 0: The eighth pulse input is disconnected
    ]
The identifiers for every measure type supported by DEXCell Energy Manager are available here

 

Modbus Custom Devices


    Since version 4.6.0 DEXGate can obtain information from custom devices. In order to do so a json device template must be created with the format explained below. After creating a file called "yourdevice" you'll need to add a line "customdevice.yourdevice=" in your modbus configuration file followed by the modbus addresses of your custom devices. For example if your device is called myPLC and it has the modbus addres 13 you'll use this line:
customdevice.myPLC=13

Custom device JSON format:

[ device1, device2, device3]

For Modbus bridge versions lower than v5.2.10, each device is a dictionary containing:
{
    "name-ext": String
    "services": [ service1, service2, service3, ...]
}

Since Modbus bridge version v5.2.10, each device is a dictionary containing:
{

    "name-ext": String
    
"delay": Integer
    "services": [ service1, service2, service3, ...]
}

The delay param is the time in ms between each register reading.


Each service is a dictionary containing:
{
    "initial-register": Integer,
    "type-of-register": String,
    "dexcell-service": Integer,
    "operation": String,
    "operand": Float,
    "type-of-value": String
}
  1. Initial-register is the initial modbus register (a integer between 0 and 65535)
  2. Type-of-register is either: 'input' or 'holding'​
  3. Dexcell-service is the dexcell service identificator. You can find them here.
  4. Operation is either:
  • ​nothing
  • multiply
  • divide
  • sum​
It can be very useful if, for example, we want to get the data in kW instead of W. In this case you will have to set the value to "divide"

      5. Operand is the operand of the operation. For example, in the kW to W case, we would set the operand value to 1000 to set the divisor of the operation to 1000.
      6. Type of value is one of the following:
  • uint8_msb
  • int8_msb
  • uint8_lsb
  • int8_lsb
  • uint16
  • int16
  • uint32
  • int32
  • uint32inv
  • int32inv
  • uint48
  • int48
  • uint64
  • int64
  • float

Example: Circutor CVM-mini
[
    {
        "name-ext" : "",
        "services" :[
            {
                "initial-register" : 30,
                "type-of-register" : "input",
                "dexcell-service" : 401,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 32,
                "type-of-register" : "input",
                "dexcell-service" : 403,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 34,
                "type-of-register" : "input",
                "dexcell-service" : 407,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 66,
                "type-of-register" : "input",
                "dexcell-service" : 409,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 70,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 72,
                "type-of-register" : "input",
                "dexcell-service" : 413,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 36,
                "type-of-register" : "input",
                "dexcell-service" : 411,
                "operation" : "divide",
                "operand" : 100,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 38,
                "type-of-register" : "input",
                "dexcell-service" : 412,
                "operation" : "divide",
                "operand" : 100,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 80,
                "type-of-register" : "input",
                "dexcell-service" : 701,
                "operation" : "divide",
                "operand" : 10,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 60,
                "type-of-register" : "input",
                "dexcell-service" : 402,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 62,
                "type-of-register" : "input",
                "dexcell-service" : 404,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 64,
                "type-of-register" : "input",
                "dexcell-service" : 408,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 86,
                "type-of-register" : "input",
                "dexcell-service" : 410,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            }
        ]
    },
    {
        "name-ext" : "a",
        "services" :[
            {
                "initial-register" : 0,
                "type-of-register" : "input",
                "dexcell-service" : 405,
                "operation" : "divide",
                "operand" : 10,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 2,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 4,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 6,
                "type-of-register" : "input",
                "dexcell-service" : 403,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 74,
                "type-of-register" : "input",
                "dexcell-service" : 409,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 8,
                "type-of-register" : "input",
                "dexcell-service" : 412,
                "operation" : "divide",
                "operand" : 100,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 48,
                "type-of-register" : "input",
                "dexcell-service" : 422,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 54,
                "type-of-register" : "input",
                "dexcell-service" : 423,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            }
        ]
    },
    {
        "name-ext" : "b",
        "services" :[
            {
                "initial-register" : 10,
                "type-of-register" : "input",
                "dexcell-service" : 405,
                "operation" : "divide",
                "operand" : 10,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 12,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 14,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 16,
                "type-of-register" : "input",
                "dexcell-service" : 403,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 76,
                "type-of-register" : "input",
                "dexcell-service" : 409,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 18,
                "type-of-register" : "input",
                "dexcell-service" : 412,
                "operation" : "divide",
                "operand" : 100,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 50,
                "type-of-register" : "input",
                "dexcell-service" : 422,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 56,
                "type-of-register" : "input",
                "dexcell-service" : 423,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            }
        ]
    },
    {
        "name-ext" : "c",
        "services" :[
            {
                "initial-register" : 20,
                "type-of-register" : "input",
                "dexcell-service" : 405,
                "operation" : "divide",
                "operand" : 10,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 22,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 24,
                "type-of-register" : "input",
                "dexcell-service" : 406,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 26,
                "type-of-register" : "input",
                "dexcell-service" : 403,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 78,
                "type-of-register" : "input",
                "dexcell-service" : 409,
                "operation" : "nothing",
                "operand" : 0,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 28,
                "type-of-register" : "input",
                "dexcell-service" : 412,
                "operation" : "divide",
                "operand" : 100,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 52,
                "type-of-register" : "input",
                "dexcell-service" : 422,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            },
            {
                "initial-register" : 58,
                "type-of-register" : "input",
                "dexcell-service" : 423,
                "operation" : "divide",
                "operand" : 1000,
                "type-of-value": "int32"
            }
        ]
    }
]​

 

4Noks Configuration

 

This section provides a basic interface to modify the 4Noks bridge configuration. The most relevant parameters are:

Option Meaning
bridge.speed Speed of the local Modbus RTU bus
bridge.scheduled-polling-interval Polling interval of the bridge. Mínimum 2 minutes
proxy.host Proxy host
proxy.port Proxy port
hardcoded.server-url DEXCell server url address
hardcoded.gateway-mac This identificator will override the default one
Queue path File where the data is stored before sending it to the server. Do not change
bridge.first.node First modbus address scanned by the bridge to find active meters. Default 15
bridge.last.node Last modbus address scanned by the bridge to find active meters. Default 20
gateway.interface Interface used to get the id of the gateway. Do not change
bridge.device Local device where the Modbus RTU bus is connected. Do not change
bridge.ip IP of the local Modbus TCP/RTU bus. Do not change
bridge.port Port of the local Modbus TCP/RTU bus. Do not change


 

Kromschroeder Configuration

 

This section provides a basic interface to modify the Kromschroeder bridge configuration. The most relevant parameters are:

Option Meaning
pulsecounter Coma-separated list of ids of the pulse counters
temphum Coma-separated list of ids of the temperature and humidity devices
temp Coma-separated list of ids of the temperature devices
retries Number of attempts to comunicate with the devices
default-pulse Default service number of the pulse generator. Default: 502
server-url URL of the server. Default: is2.dexcell.com
queue-path File where the pending messages will be buffered. Do not change
hardcoded.gateway-mac This identificator will override the default one
Queue path File where the data is stored before sending it to the server. Do not change
persistence-path File where the timestamps data is stored. Do not change
serial-device Name of the serial device. Do not change
serial-speed Speed of the serial device
serial-timeout Timeout time of the serial port. Do not change


 

IEC 870-5-102 Configuration

 
Option Meaning
link Link address. It can be generally obtained from the meter menu. Default 1
measure Measure point. It can be generally obtained from the meter menu. Default 1
password Password. It cannnot be obtained from the meter. The usual values are 1, 2 or 7. Default 1
log Log level
device Name of the serial device. Do not change
speed Speed of the serial device
parity Parity of the serial device. It can be E, O or N (even, odd, none)


 

Update


The technical support team may give you updates to install. You can use this section to do so.


 

Reboot and Halt


This sections are designed to reboot and halt the device. It is recommended to use this option instead of directly removing current from the device.


 

Change password


Change the password required to log in the administration interface.

Contact Us

  • Post a Public Question
  • Email Us
  • Tel : +34 931 810 195
    Hours: 9am - 6pm CEST, Mon to Fri
    support@dexmatech.com

    Check Public holidays here

                                         
    Support
soporte@dexmatech.com
http://assets1.desk.com/
false
dexma
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete