Support Center

DEXGate2 full user manual

Last Updated: Apr 05, 2016 04:06PM CEST

Menu

  1. Device Information
  2. Quick Start
  3. Accessing the web administration interface
  4. System Status
  5. Ethernet/Wireless connection
  6. Time and date
  7. Log Kernel
  8. Log System
  9. Modbus Configuration
  10. Last Readings
  11. Custom Modbus Devices
  12. Read Register
  13. Log Modbus
  14. Update Modbus
  15. IEC 870-5-102 Configuration
  16. IEC 870-5-102 Log
  17. Connectivity test
  18. Remote Support
  19. Download files
  20. Reboot
  21. Factory Reset
  22. Change User Password
  23. Change Wifi Password


 

Device Information

Ports

  • Serial port: integrated RS485 and RS232 port
  • Ethernet: Power over Ethernet port. The default address is 192.168.1.150. PoE capable
  • WiFi: An access point is created for configuration. Just join the network and point your smartphone browser to 172.16.0.1
  • USB: USB port for IEC 870-5-102
  • DC in: Power input 7-50V
 

Specifications

  • Processor: Freescale i.MX28 at 545 MHz (ARM)
  • DRAM: 128MB DDR2 DRAM
  • Power requirements: 7V - 50V DC (PoE or DC in)
  • 3G Modem: integrated optional 3G module
  • Storage: 4GB eMMc Flash
  • Size: 7.8 x 6.7 x 3.7 cm
  • DINRail adapter: included in the package
 

Compatible technologies

To get Internet
  • Ethernet
  • 3G integrated as an option
To admin
  • Configurable from smartphone through Wifi
  • Web interface
  • Remote Web configuration via DEXCell Energy Manager
To get measures
  • Modbus-RTU over RS485 port
  • Modbus-TCP
  • IEC 870-5-102
  • Compatible with more than 100 modbus devices
  • Integrated with new API v3, much more efficient
 

Quick Start

 

DEXGate2 Connection

Connect the Wireless antenna on the connector under the miniUSB port
  1. Connect the DEXGate2 through Internet. You have 2 options to feed the DEXGate2 with Internet:
    1. Ethernet, connecting the network cable to DEXGate2 and your local network.
    2. GPRS, connecting the 3G antenna into the connector next to the RS232 port. Then, insert the SIM into the slot on the top of the datalogger.
  2. Power on the DEXGate2 by connecting it through a Power Supply
  3. Wait about 1 minute and connect your laptop, smartphone or tablet to the WiFi called DEXGATE_XXXX, where XXXX is the identifier of the DEXGate2. An access point is created for configuration.
  4. Just enter the password to join the network (default password is the DEXGate2 identifier in capital letters), open your web browser and access http:// 172.16.0.1.
  5. In order to acces to the administration page, enter the username and password. By default both are "admin"
 

Network Configuration

The DEXGate2 is capable of connecting to the Internet using a cable or mobile connection. Go to System > Ethernet or 3G depending on the connection and configure the basic information. If you don't know how to configure it contact your systems administrator or your network provider. 

 

Time and date

Go to System > Time and date and select the timezone according to the location. Then just click on Save
DEXGate2 uses the UDP port 123 to syncronize the time.

If Syncronization through UDP port 123 is not available, you can set Time and date manually by selecting Manual (Not recommended).
 

Register DEXGate2

  1. Acces to DEXCell Energy Manager with a superAdmin or Admin user
  2. Go to Settings > Gateways > and clik on "Register new Gateway"
  3. Select the DEXGate2 and click on "Next"
  4. Fill the form introducing the serial number of the DEXGate2. You can find it under System > Status menu or checking the name of the WiFi you are connected on (DEXGate_XXXXX) where XXXXX in lowercase is the serial number.
  5. Once the serial number is introduced and saved, you'll see at the Gateway configuration the "Gateway Token" code. This code must be introduced at the DEXGate to finish the registering process.  In order to do it, at the DEXGate2 web administration interface go to Modbus Configuration. Then paste the Gateway Token code shown at DEXCell Energy Manager. At the Modbus Configuration you'll find the following lines were the token should be defined: 
# token of this dexgate in dexcell
token=xxxxxxxxxxxxxxxxxxxxxxxxxx
 

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 "Log" section of the web administration interface of the DEXGate2.
 

Accessing the web administration interface

  1. Connect your laptop, smartphone or tablet to the WiFi called DEXGATE_XXXX, where XXXX is the identifier of the DEXGate2. An access point is created for configuration.
  2. Just enter the password to join the network (the password is the DEXGate2 identifier), open your web browser and access http:// 172.16.0.1.
  3. Log in using your username and password (the default ones are admin/admin)




     

System status



 
 
This screen provides some basic information about the gateway:
  • MAC Address (identifier)
  • IP address
  • Internet connection
  • Modbus status
  • Data consumption
  • DEXGate2 Firmware version
  • Modbus Version
 

Ethernet/Wireless connection

 

Ethernet Cable

Go to System Ehernet and Enable DHCP or disable it and use an Static Address 
  • DHCPIP address and networking parameters are automatically configured from a DHCP server
  • Static Address: enter configuration of the local network provided by the network administrator. Contact your system administrator if you need help

 

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

Go to System > 3G/GPRS and configure the mobile network information. If you don't know how to configure it, contact your mobile network provider. You can use a pre-configured operator, or set a custom one. 
 

Time and date

 
Here you can syncronize your gateway and select the timezone where the DEXGate2 is located. Here, you can:
  • Check your Current System time
  • Check Current Timezone (for example, UTC)
  • Set a new timezone. 

 
 
Go to System > Time and date and select the timezone according to the location. Then just click on Save
DEXGate2 uses the UDP port 123 to syncronize the time.

If Syncronization through UDP port 123 is not available, you can set Time and date manually by selecting Manual (Not recommended).
 

Log Kernel


  Here you can download the Kernel log and check if everything is correct. 
 

Log System


  Here you can download the System log and check if everything is correct. 
 

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.device Local device where the Modbus RTU bus is connected. Do not change
bridge.parity Options: "even" (default), "odd" or "none". 
bridge.data_bit Options:  5, 6, 7 or 8 (default)
bridge.stop_bit Options:  1 (default) or 2
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
token Token of this dexgate in dexcell
proxy.host Proxy Host
proxy.port Proxy Port
proxy.user Proxy User
proxy.pass Proxy Password
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
hardcoded.gateway-mac This identificator will override the default one
publish.local this is used to publish the data locally at the Last Readings feature. Options: true (default) or false
publish.server this is used to publish the data at DEXCell.com. Options: true (default) or false
publish.server.https this is used to publish the data at DEXCell.com using HTTPS or HTTP  protocol. Options: true (default) or false
 

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

#baud:   9600, 19200, 57600, 115200, etc
bridge.speed=9600

#device: the RS485 interface
bridge.device=/dev/ttyAPP0

#parity: "even", "odd" or "none"
bridge.parity=none

#data_bits: 5, 6, 7, 8
bridge.data_bit=8

#stop_bits: 1, 2
bridge.stop_bit=1

bridge.ip=127.0.0.1
bridge.port=502
bridge.sleep-milliseconds-between-nodes=

#token of this dexgate in dexcell
token=xxxxxxxxxxxxxxxxxxxx

# Logger configuration
logging.token=

# Proxy configuration
proxy.host=
proxy.port=
proxy.user=
proxy.pass=

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

# Ids of Circutor devices
devices.circutor-cvm-mini=1
profile.circutor-cvm-mini=high
devices.circutor-cvm-96=

# 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=




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
 

Last Readings


This feature lets you see "locally" all the data that will be published in DEXCell, without the need of having the DEXGate2 connected to the internet. 

 

Custom Modbus Devices


If any Modbus device is not compatible yet with DEXGate v2, you can integrate it yourself using the Custom Device feature! In order to do so a JSON device template must be created with the format explained below.
Click on "Custom devices" menu and follow these steps: 
  1. Click in "New custom device" button or in "Import device" button if you have a JSON file already created. 
  2. Introduce a "Device name" (for example, Circutor CVM-mini) and click in "Add Subdevice"
  3. Click in "Add Service" to start configuring the corresponding device and fill the following fields:
    1. Initial Registeris the initial modbus register (an integer between 0 and 65535)
    2. Type Registeris either: 'input' or 'holding'​
    3. DEXCell service: is the dexcell service identificator. You can find them here.
    4. Operation: nothing, multiply, divide or sum. 
    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 value: uint8_msb, int8_msb, uint8_lsb, int8_lsb, uint16, int16, uint32, int32, uint32inv,  int32inv, uint48, int48, uint64, int64, float, floatinv
  4. If you want to add additional services for the same subdevice, click on "Add Service"
  5. For additional subdevices under the same "Custom device" click on "Add Subdevice"
  6. When you finish to configure all the devices, click on "Save Device" to apply changes. 
  7. 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 Circutor-CVM-mini and it has the modbus addres 13 you'll use this line:
    ​customdevice.Circutor-CVM-mini=13
 

Read Register

 
Here you can obtain the specific value for a Modbus Register. You need to specify:
  • Bridge IP Address: IP of the local Modbus TCP/RTU bus. Do not change
  • Bridge Port: Port of the local Modbus TCP/RTU bus. Do not change
  • Slave ID: the ID of the device you want to read
  • Register type: input or holding registers
  • From register: start value
  • Num registers to read
 

Log Modbus

 

This section provides information of the Modbus processes running in the DEXGate2. These 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
 

Update Modbus


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

 

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)
token Token of this DEXGate2 in DEXCell
insert_server Do not change

To use the DEXGate2 to read IEC meters, you need to connect the USB (MicroUSB) optical probe to the DEXGate2 MicroUSB port. 

 

IEC 870-5-102 Log


This section provides information of the IEC 870-5-102 processes running in the DEXGate2.

 

Connectivity test

 
Here you will be able to test if all the network requirements of the DEXGate2 are configured properly and you have connectivity to each port and address. If everything is configured correctly, you should see all the 
  • Connected: indicates if you are connected by Ethernet or GPRS
  • DNS state: if the DNS is working correctly or not
  • Access to port 80 of dexcell.com: if the DEXGate has access to DEXCell Energy Manager in the port 80
  • Access to port 80 of insert.dexcell.com: if the DEXGate has access to the insertion engine of DEXCell Energy Manager in the port 80
  • Access to port 443 of insert.dexcell.com: if the DEXGate has access to the insertion engine of DEXCell Energy Manager in the port 443
 

Remote Support


If you want to have access to the DEXGate2 directly from DEXCell Energy Manager, you need to activate the Remote Support under Diagnostic > Remote Support
 
 

Then, if you access to DEXCell Energy Manager with a superAdmin or Admin user, and go to Settings > Gateways > edit your gateway > Remote access, you will be able to configure your DEXGate2, directly from DEXCell EM!
 

Download Files

 
Here you can Download all the log files or configuration files to see what happened on the DEXGate2 or to check the Modbus configuration
 

Reboot


To reboot your DEXGate2, click on "Reboot". This action will shutdown the gateway, so you will loose your connectivity until DEXGate2 starts again.  

 

Factory Reset


Restoring your DEXGate2 from factory, will apply the following actions: 
  • Modbus Software: The DEXMA modbus software will be change from the factory software.
  • Modbus Configuration: Will have the factory configuration modbus file.
  • Modbus Custom devices: All the custom devices will be removed
  • Ethernet Connection: The Ethernet configuration will be (DHCP)
  • Adminsitration Login: login name and password will be the factory ones
 

Change User Password


You can change the default password using this section. The password by default is "admin". 
 


 

Change Wifi Password


You can change the default password using this section. The password by default is the DEXGate2 identifier
 

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://assets2.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