FAQ

Here you can find a number of questions and answers regarding our products.

M-Bus driver for Citect

#COM appears sporadically on the screen?

When using slow protocols the (LAN) Timeout often has time to exceed the original setting of 8000ms. When this occur the #COM appears sporadically on the screen, the hardware error “Request Timeout from I/O Server” will appear, and at the same time the total number of Timeouts will be counted in the Probe Kernel window. This is normally corrected by changing the (LAN) Timeout to 20000 or higher. Please be aware that the (LAN) Timeout has been omitted in Citect V7.

I have hundreds of meters configured; however all of them are yet not installed on the premises. What is the best way to start up Citect faster?

Many new parameters have been implemented in version 2 of the M-Bus driver. The InitTimeOut is only used for the starting question and can be set as low as 500ms, and there is also a MainTimeOut to be used for normal questions. This can be used individually by port for 300baud or 2400 baud and can be handled individually or optimally. During the session it is possible to prevent the starting question completely by using the parameter IgnoreDeviceStartup. For more information see the driver manual.

I have installed the Citect M-bus driver on Design Insight, however the licensing registration key does not activate?

The problem is probably that only the Designo Insight license key is installed on the computer, however the Citect key also has to be installed. It is enough to have a so called zero license, which can be delivered from Siemens.

I have many meters on the same picture screen and receive #COM randomly?

The Citect driver supports multitelegram, and if you have a multi telegram meter like the Armatec or F4 from Metrima connected they will read all the telegrams from the meters. The everyday information is normally to be found in telegram 1, and if that is the only information needed set the parameter NrOfTelegrams=1, which means that only telegram number 1 will be read. By doing this the stress on the M-Bus loop will be noticeably reduced.

My IO device will not connect online?

First off you have to set the initial questioning so that it can be logged in syslog.dat, which is easily done by writing DebugStr=*ALL for your driver in Citect.ini. ‘*’ can be replaced by the port name and that way that specific port will be logged. For example M-Bus can look like the following:
[MBUSCIT]
DebugStr=Port1_Board1 ALL
Now you can see if a question is asked or if you get answers from your equipment.

M-Bus OPC Server/Explorer

Configure the ValueSplit scale factor

Here are the scale factors for ValueSplit regarding data types greater than 32-bits.

Data typeScale factor
BCD120,001
INT480,00001
INT640,0000000001

 

Attn!

These scale factors are general and scales the value to fit within an INT32.

Make sure to scale with whatever factor to best suit the site.

 

 

Example:

The energi is 12345Wh in a BCD12 which should be represented as kWh.

The highest value of BCD12 is 999 999 999 999, occupies 6 bytes and cannot be fitted into an INT32 (4 bytes).

With scale factor 0,001 the highest value becomes 999 999 999.

The integer part: 999 999 999 can now fit into an INT32.

The decimal part: 999 can also be fitted into an INT32.

The value will be 12,345kWh: 12kW and 345Wh.

Create a new tag with TagType as ValueSplitHigh with scale 0,001, this will represent the value: 12kW.

Create a new tag with TagType as ValueSplitLow with scale 0,001, this will represent the value 345W.

How to install or upgrade the license?

Start the PiiGAB M-Bus Explorer and go to the Tools menu. Select License… to reveal the License handler window. Copy the license into the Registration Code field and press the Store Registration Code button.

How to move a license to another computer?

Find out what System IDs both the current and new computer has. Then mail to order@piigab.se and ask for a license move and specify both System IDs.

I have installed the OPC server in Citect and everything is running ok, however I can only see #COM on the picture site?

Citect is originally made for DA 1.0 OPC servers. PiiGAB’s  M-Bus OPC Server supports versions: 2.00, 2.05 and 3.0, which means you have to complement  with an adjustment of Citect.ini. Write UseOPC2=1 under the group [OPC].

I make a change and restart the monitor, however the changes don’t seem to update?

The OPC server is a thin server, which means that it does not contain a user interface but the interface is completely external and contains a real OPC client amongst other things. The changes made will be updated when the server is restarted. The OPC standard requires a time delay in between stop is pressed until the server really disconnects. If a restart is made too fast the server does not have enough time to stop, which is why no new reading of the configuration file is made. Starting with the 1.3.0.1 version the server status will be shown in the status field in the bottom right corner, and this will make it easier to see when the server has actually stopped.

I’m using a hardware license key, but the registration information is telling me that I can only operate in demo mode?

The current Sentinel driver is probably not installed on your computer. The driver can be downloaded from http://www.safenet-inc.com/support-downloads/sentinel-drivers/

OPC-server never terminates and the server indication is steady green or flashes green.

In this case there are still OPC-clients connected to the OPC-server. If you would like to stop the OPC-server, to try a new configuration, all OPC-clients must drop their connections to the OPC-server.

Quality indicates ”Read Error” on one OPC-tag and status field indicates ”The item is no longer available in the server adress space”

If you are about to test a new configuration for the OPC-server then the problem is due to the OPC-server was not terminated before you started the monitor function. In the lower right corner there is an indication if the server is on (steady green) or off (steady red). You must wait for the OPC-server to shut off before you test a new configuration.

Show the content of a meter [Browse-template]

The following instruction shows how the Browse-template in the PiiGAB M-Bus Explorer can be used to show the content of an M-Bus meter.

Note:
This instruction assumes that the configuration for the PiiGAB M-Bus Explorer is working to communicate with the M-Bus gateway and the M-Bus meter.

  1. Start the PiiGAB M-Bus Explorer.
  2. Create a new project or open an existing project.
  3. Create a new channel or choose an existing channel.
  4. Press the Template menu.
  5. In the window Template, press PiiGAB to the left and Browse to the right.
  6. Specify a name for the template.
  7. Press the Load Template button. The template will be created into the project in the tree view as a meter.
  8. Double click the meter in the tree view.
  9. Specify the primary or secondary address of the M-Bus meter to read.
  10. Press OK.
  11. Save the project.
  12. Press the meter in the tree view. This will show a lot of tags (objects) in the meter view.
  13. Click on the Datarecord column to sort the tags in numerical order.
  14. Press the Start monitor button.
  15. Wait for the Quality column to change to Good.
    Note: If the Quality is Bad then the configuration or communication is faulty.
  16. Expand the Value column until all data is visible for each tag.
  17. Read the objects number, data type, representation scaling and value for each object in the meter.

 

The image show an M-Bus meter with identification 53880741 and two M-Bus objects.

 

Notice:

  • The Browse-template shows the first 40 objects in the meter. There might be 40 less or 40 more objects in the meter. The Browse-template can be altered to include more objects.
  • The Browse-template can also be used to show if a meter is a multi telegram meter. If a tag contains the value N/A (0x1F) Manufacurer specific. This specifies the last object in the telegram and there are more objects in the next telegram. All following objects belongs to the next telegram.
  • The column Data type shows VT_BSTR for each tag. This is specific for the Browse-template and is not the actual data type for each object. The actual data type is shown in the Value-column.
  • The tag Header shows for instance the secondary address, manufacturer and type.

 

Here follows a picture how to interpret the content in the browse template.

System requirments

.NET Framework V3.5 is the base of PiiGAB M-Bus Explorer. Please see the requirements for .NET Framework V3.5 here.

PiiGAB M-Bus Explorer also works on the following operating systems:

  • Windows server 2012.
  • Windows server 2012 R2.
  • Windows server 2016.
Where is the System ID?

Start the PiiGAB M-Bus Explorer and go to the Tools menu. Select License… to reveal the License handler window.

  • Then look for the System ID field.
  • Software license is stored in the Registration Code field. Then press the Store Registration Code button.
  • Hardware license is shown in the section Sentinel (Parallel/USB).

PiiGAB Explorer - License

PiiGAB M-Bus 810

Is it possible to use the Ethernet and serial connections at the same time at the PiiGAB M-Bus 810?

No, that is not possible. However the PiiGAB M-Bus 900 may be used for that setup.

Basic troubleshooting

To troubleshoot M-Bus meters connected to an PiiGAB M-Bus 810 there are a couple of things to verify.

Here is a list of good tools to use during troubleshooting:

 

IP-address
What IP-address is the gateway using? To have network communication with the gateway you need to setup your computer in the same network as the gateway. If there is an IT section please contact them to receive an IP-address for your computer. With the PiiGAB M-Bus Setup Wizard you can search gateways on the network or ping the gateway’s IP-address to verify if the network communication works.

If it’s not possible to receive the gateway’s IP-address then you need to setup a new IP-address. Please see the FAQ on how to do this.

 

Port
What port is the gateway set to in order for the the M-Bus client to read the M-Bus meters? If you have network connection with the gateway you can find out the port with the PiiGAB M-Bus Setup Wizard.

Start the PiiGAB M-Bus Setup Wizard -> Change gateway parameters -> Connect using network

 

Protocol

What protocol is the gateway set to in order for the the M-Bus client to read the M-Bus meters? If you have network connection with the gateway you can find out the protocol with the PiiGAB M-Bus Setup Wizard.

Start the PiiGAB M-Bus Setup Wizard -> Change gateway parameters -> Connect using network

Note: If the gateway uses TCP you might not be able to connect to the gateway with the PiiGAB M-Bus Setup Wizard to read the M-Bus meters. This is due to that another client is connected to the port that the gateway is using. Change the port, change to UDP or turn off the client.

 

Communication speed
What communication speed is the gateway set to in order for the the M-Bus client to read the M-Bus meters?If you have network connection with the gateway you can find out the communication speed with the PiiGAB M-Bus Setup Wizard.

Start the PiiGAB M-Bus Setup Wizard -> Change gateway parameters -> Connect using network

Note: If the gateway is set to 300 baud the communication speed is very slow. Remember to change the timeout in the PiiGAB M-Bus Setup Wizard to handle the long response time.

 

M-Bus meters
Is there any documentation of what M-Bus meters that are connected to the gateway? What addresses does the M-Bus meters use? (primary or secondary addresses).

If there is documentation of the meters then you can simple check each meter one by one with the PiiGAB M-Bus Setup Wizard. It’s also possible to read the search function in the PiiGAB M-Bus Setup Wizard.

If there is no documentation of the meters then you can use the search function in the PiiGAB M-Bus Setup Wizard. If the the result of the search function is incomplete then you have to find each meter one by one on the site and test them individually by it’s M-Bus address (primary or secondary address).

 

A M-Bus meter not responding
If an M-bus meter is not responding then you have to test the meter individually. If possible disconnect all other meters and test only that specific meter. Try with primary address 254 or the meter’s own primary or secondary address.

If it’s not possible to disconnect all meters then you can test the specific meter with a MicroMaster USB.

 

 

Example of initial contact

 

Here is an example of how to setup the initial contact with a PiiGAB M-Bus 810.

  1. Connect the PiiGAB M-Bus 810 to a network switch.
  2. Connect the computer to the same network switch.
  3. Configure the computer’s network card with this IP-configuration:
    • IP-address: 192.168.10.1
    • Netmask: 255.255.255.0
    • Gateway: 192.168.10.254
  4. Check the IP-configuration with the ipconfig command in the command interpreter.
  5. Read the MAC-address of the PiiGAB M-Bus 810 on the right side.
    (Starts with 00-80-A3 or 00-20-A4).
  6. Start PiiGAB M-Bus Setup Wizard.
  7. In the main menu, select Change gateway IP-settings and press Next.
  8. Select Setup IP using network (UDP broadcast).
  9. Specify the MAC-address and press Next.
  10. Select Use the following IP-address.
  11. Specify the following IP-configuration:
    • IP-address: 192.168.10.2
    • Netmask: 255.255.255.0
    • Gateway: 192.168.10.1
  12. Press Next and then Apply.
  13. Go ahead to Find gateways on your network.

Now should the PiiGAB M-Bus Setup display the PiiGAB M-Bus 810 in the list. Check the MAC-address and the IP-address should be 192.168.10.2.

How is the gateway prepared at delivery?

The gateway is normally programmed to DHCP unless otherwise specified. The port is configured to 10001 and the gateway is in addition to that configured to UDP.

The gateway can communicate with the meter via M-Bus Wizard, but not via my client?

If you are using TCP and the M-Bus Wizard at the same time you cannot make contact with an additional TCP client since the M-Bus Wizard “owns” the TCP handle.  Shut down the M-Bus Wizard before starting the second TCP client. The same goes if you are using COM ports.

The gateway cannot be found on the network with the PiiGAB M-Bus Setup Wizard application

Make sure the computer and the gateway are configured within the same IP-address range. If the gateway is placed in a subnet, the PiiGAB M-Bus Setup Wizard will not be able to find the gateway.

The gateway’s power light is flashing?

Normally there are two different scenarios to be investigated if the power light is blinking:

  • If there is a short circuit on the M-Bus loop the power light will flash five times per second.
  • If the loop is overloaded, meaning more M-Bus loads than the gateways is dimensioned for; the power light will flash every second.
The Rx light is flashing without any questions asked?

In the event where the M-Bus loop is connected to the pulse port by mistake instead of the M-bus port on a meter a flash can occur every time a pulse goes trough. If the meter generates many pulses the power light will flash very fast as the pulses go through.

What communication port does the gateway use?
  • For M-Bus communication the default port is 10001. The port number can be changed with the application PiiGAB M-Bus Setup Wizard.
  • To configure the gateway and find the gateway on the network port 30718 is used with UDP in PiiGAB M-Bus Setup wizard.

PiiGAB M-Bus 900/900S

Can the gateway’s IP-configured be altered with PiiGAB M-Bu Setup Wizard in the same way as a PiiGAB 810 gateway?

Yes. Make sure the gateway’s version is version 2, i.e. V2.XX.XX.XXX.

Example of initial contact

 

Here is an example of how to setup the initial contact with a PiiGAB M-Bus 900.

  1. Connect the PiiGAB M-Bus 900 to a network switch.
  2. Connect the computer to the same network switch.
  3. Configure the computer’s network card with this IP-configuration:
    • IP-address: 192.168.10.1
    • Netmask: 255.255.255.0
    • Gateway: 192.168.10.254
  4. Check the IP-configuration with the ipconfig command in the command interpreter.
  5. Read the MAC-address of the PiiGAB M-Bus 900 on the right side. (Starts with E8-99-5A).
  6. Start PiiGAB M-Bus Setup Wizard.
  7. In the main menu, select Change gateway IP-settings and press Next.
  8. Select Setup IP using network (UDP broadcast).
  9. Specify the MAC-address and press Next.
  10. Select Use the following IP-address.
  11. Specify the following IP-configuration:
    • IP-address: 192.168.10.2
    • Netmask: 255.255.255.0
    • Gateway: 192.168.10.1
  12. Press Next and then Apply.
    Note: Ignore the error messages displayed in PiiGAB M-Bus Setup Wizard.
  13. Wait one minute for the PiiGAB M-Bus 900 to restart.
  14. Go ahead to Find gateways on your network.

 

Now should the PiiGAB M-Bus Setup display the PiiGAB M-Bus 900 in the list. Check the MAC-address and the IP-address should be 192.168.10.2.

How is the gateway configured when delivered?

If nothing else has been specified in the order, the default configurations are set for DHCP.

 

How is the gateway PiiGAB M-Bus 900 configured?

All configurartions are made in the gateway’s web interface.

Install a license

The following list will explain how to install a license in the PiiGAB M-Bus 900/900S. These steps will also show the current license of a PiiGAB M-Bus 900/900S.

  1. Start the gateway’s web interface in any web browser.
  2. Go to the Administration page.
  3. Find the section License. This will show the gateway’s license.
  4. Paste the license into the field Update license.
  5. Press the button Update.
  6. Wait for the license to be installed.
Install software (System, MBusHub, QuickPost, Modbus2MBus & Wireless M-Bus)

The following list will explain how to install software in the PiiGAB M-Bus 900 V2 and PiiGAB M-Bus 900S. These steps are either used to install a new software or update an existing.

  1. Download the software as a ZIP-file:
  2. Unzip the file to gain access to the tgz-file.
  3. Place the tgz-file somewhere on the computer. Don’t open the tgz-file.
  4. Start the web interface for the gateway in any browser.
  5. Go to the Administration page.
  6. Find the section Update Software.
  7. Press the Browse… button.
  8. Browse to the tgz-file and select it.
  9. Press the button Install.
  10. Wait until the installation has finished.

 

Note: If QuickPost, Modbus2MBus or Wireless M-Bus is not shown in the web browser, please press CTRL + F5.

Is the license possible to change without replacing the gateway?

Yes. The license can be changed without replacing the gateway.

Pwr LED flashes on the gateway

There are two possible cases when the Pwr LED is flashing

  • Short circuit on the M-Bus loop indicates by a hastily red flash (5 flashes/second)
  • Overload indication on the M-Bus loop indicates by a slow orange flash (1 flash/second)
Read M-Bus meters from external M-Bus master

The following list instructs how to configure a PiiGAB M-Bus 900/900S as an M-Bus slave, i.e. one or two external M-Bus masters can read the M-Bus meter connected to the gateway.

Notice: On PiiGAB M-Bus 900 there can only be one external M-Bus master connected.

  1. Start the gateway’s web interface in any web browser.
  2. Go to the Configuration page.
  3. Select any slave port to configure as an M-Bus slave.
  4. Specify the following parameters:
    • Type: Serial.
    • Com port: M-Bus Slave 1 or M-Bus Slave 2.
    • Baud rate: The specified communication speed on the M-Bus loop.
    • Bit Number: Number of data bits on the M-Bus loop. Standard 8 bits.
    • Parity: The parity for the M-Bus loop. Standard Even parity.
    • Stop Bit: Number of stop bits on the M-Bus loop. Standard 1 stop bits.
    • Timeout: Expected time to get answer from the M-Bus meter.
    • Protocol: The data protocol on the M-Bus loop. Standard M-Bus.
  5. Press the Save settings button.
  6. Connect the external M-Bus loop from the external M-Bus master to the following pins:
    • PiiGAB M-Bus 900: Pins 15-18. Notice only one M-Bus slave.
    • PiiGAB M-Bus 900S: Pins 15-16 (M-Bus slave 1) or pins 17-18 (M-Bus slave 2).

 

The picture shows Slave port 2 is configured for M-Bus slave 1 on 2400 baud, 8 data bits, even parity, 1 stop bit, 2000ms as timeout and M-Bus communication.

 

Notice:

  • Make sure the gateway doesn’t use the specific M-Bus slave port anywhere else. For instance any other slave ports or the Modbus2MBus and/or the Wireless applications.

Read M-Bus meters over RS232

The following list instructs how to configure a PiiGAB M-Bus 900/900S so that M-Bus meters can be read with RS232.

  1. Start the gateway’s web interface in any web browser.
  2. Go to the Configuration page.
  3. Select any slave port for the RS232 communication.
  4. Specify the following parameters:
    • Type: Serial.
    • Com port: RS-232.
    • Baud rate: The specified communication speed on the RS232 bus.
    • Bit Number: Number of data bits on the RS232 bus.
    • Parity: The parity for the RS232 bus.
    • Stop Bit: Number of stop bits on the RS232 bus.
    • Timeout: Expected time to get answer from the M-Bus meter.
    • Protocol: The data protocol on the RS232 bus.
  5. Press the Save settings button.
  6. Connect the RS232-cable to the RS232-connection on the gateway.
    • PiiGAB M-Bus 900: Pins 10-12.
    • PiiGAB M-Bus 900S: Pins 11-13.

 

The picture shows Slave port 2 is configured for RS232 on 2400 baud, 8 data bits, even parity, 1 stop bit, 2000ms as timeout and M-Bus communication.

 

Note:

  • Make sure the gateway doesn’t use the RS232-port anywhere else. For instance any other slave ports or the Modbus2MBus and/or the Wireless applications.
  • The RX and TX pins should likely go to the opposite pins on the unit.
    For instance RX->TX and TX->RX.

Read M-Bus meters over RS485

The following list instructs how to configure a PiiGAB M-Bus 900/900S so that M-Bus meters can be read with RS485.

  1. Start the gateway’s web interface in any web browser.
  2. Go to the Configuration page.
  3. Select any slave port for the RS485 communication.
  4. Specify the following parameters:
    • Type: Serial.
    • Com port: RS-485.
    • Baud rate: The specified communication speed on the RS485 bus.
    • Bit Number: Number of data bits on the RS485 bus.
    • Parity: The parity for the RS485 bus.
    • Stop Bit: Number of stop bits on the RS485 bus.
    • Timeout: Expected time to get answer from the M-Bus meter.
    • Protocol: The data protocol on the RS485 bus.
  5. Press the Save settings button.
  6. Connect the RS485-cable to the the gateways pin 8 (A) and 9 (B).

 

The picture shows Slave port 2 is configured for RS485 on 2400 baud, 8 data bits, even parity, 1 stop bit, 2000ms as timeout and M-Bus communication.

 

Note:

  • Make sure the gateway doesn’t use the RS485-port anywhere else. For instance any other slave ports or the Modbus2MBus and/or the Wireless applications.
  • The A and B pins should likely go to the opposite A and B on the RS485 master.
    For instance A->A and B->B.

Setup MBus2Modbus

Here follows a general list on how to configure MBus2Modbus, e.g read M-Bus meters with an Modbus clients.

Initialize contact with PiiGAB M-Bus 900/900S and M-Bus meters

  • 1. Set IP-configuration in the PiiGAB M-Bus 900/900S.
  • 2. Testa kommunication with the M-Bus meters.

Note: Verify the gateway’s IP-address, port and protocol and test all M-Bus meters. Use Getting started PiiGAB M-Bus 900S or Gettings started PiiGAB M-Bus 900 for help.
Check the license for MBus2Modbus
The license must allow Modbus communication for the gateway. The gateway’s license can be found on the Administrations page.
Pi900License
Note: If Modbus is missing it must be ordered. Order it on order@piigab.se and specify the following: PI-900_0-Modbus and the gateways serial number.
Use PiiGAB M-Bus Explorer

  • 1. Create an M-Bus OPC project.
  • 2. Find out what objects can be read from the M-Bus meters.
  • 3. Take note what objects should be read in the meters:
    Data record, data type, physical quantity and scaling.
  • 4. Find out if any of the meters are multi telegram meters and what telegrams are necessary to read.

Use the Getting started PiiGAB M-Bus Explorer for help.
Configure MBus2Modbus the configuration in PiiGAB M-Bus Explorer

  • 1. Create a Modbus project.
  • 2. Configure the M-Bus meters with the primary or secondary addresses.
  • 3. Conifgure the objects for each meter.
  • 4. Assign the number of telegrams for each multi telegram meter.
  • 5. Assign Modbus registers for each objekt.

Use the Getting started PiiGAB MBus2Modbus for help.
Upload the MBus2Modbus configuration to the gateway

  • 1. Upload both CSV-files created by PiiGAB M-Bus Explorer.
  • 2. Bind the CSV-files to the Master port and a slave port.

Use the Getting started PiiGAB MBus2Modbus for help.
Test the MBus2Modbus configuration with PiiGAB M-Bus Setup Wizard

Use the built-in the Modbus client in PiiGAB M-Bus Setup Wizard to test the MBus2Modbus configuration. Use the Getting started PiiGAB MBus2Modbus for help.

Configuration a slave port to communicate with the Modbus client
Configuration a slave port for network or serial connection and Modbus RTU or Modbus TCP.

The gateway cannot be found on the network with the PiiGAB M-Bus Setup Wizard application

Make sure the computer and the gateway are configured within the same IP-address range. If the gateway is placed in a subnet, the PiiGAB M-Bus Setup Wizard will not be able to find the gateway.

Unsuccessful secondary address search with PiiGAB M-Bus 900S

If the search of secondary addresses failes in the PiiGAB M-Bus Setup Wizard through a PiiGAB M-Bus 900S then the timeouts are probably set too high.

 

There are four timeouts that are required to configure:

  • MBusHub Master port in PiiGAB M-Bus 900S.
  • MBusHub slave port in PiiGAB M-Bus 900S.
  • SND_NKE/SND_UD timeout in PiiGAB M-Bus Setup Wizard.
  • RSP_UD2 timeout in PiiGAB M-Bus Setup Wizard

 

This table shows how to configure the tiemouts depending on the communication speed:

300 Baudrate2400 Baudrate
9600 Baudrate
Master port9600ms1300ms400ms
Slave port9600ms1300ms400ms
SND_NKE11000ms1500ms600ms
REQ_UD211000ms1500ms600ms

 

What communication port does the gateway use?
  • For M-Bus communication the default port are 10001, 10002, 10003 and 10004. The port numbers can be changed with the gateway’s web interface.
  • To find the gateway on the network port 30718 is used with UDP in PiiGAB M-Bus Setup wizard.
What different types of licenses are available for the gateway?

Available choices and add-ons:

  • Quantity of M-Bus loads: 5, 20, 60 or 120.
  • Quantity of clients: 1, 2 or 4.
  • Protocols: MBus2MBus, MBus2Modbus, MBus2MBusASCII, QuickPost and Modbus2MBus.
What is a client for the gateway?

A client is something which requests the data from the M-Bus meter through the gateway.

What is the default name and password for the gateway’s web interface?
  • Name: Admin
  • Password: Admin
What port is used for the gateway’s web interface?
  • For https: 443 (standard)
  • For http: 80
What should be assigned as name server in the Name Server field?

The actual IP-address of the name server. Not the name of the server.

PiiGAB M-Bus Setup Wizard

How to set the timeout

There are three timeouts in PiiGAB M-Bus Setup Wizard for the protocols M-Bus, Modbus and MBus ASCII. Please set the respective protocols accordingly.

Note: In earlier versions of PiiGAB M-Bus Setup Wizard (3.1.0 or older) there was only one timeout for the three protocols.

To set the timeout for respective protocol, please follow the below steps:

  1. In the main menu select Test, search and configure meters and press Next.
  2. Press Next again.
  3. Press the Debug button.
  4. In the Tools menu select Timeouts.
  5. Assign the desired timeout for respective protocols:
    • M-Bus timeout: For all M-Bus communication.
    • Modbus timeout: For all Modbus communication.
    • M-Bus ASCII timeout: For all MBusASCII communication.
    • Note: In earlier version the timeout was called BusTimeout.
  6. Press OK.

 

wizardtimeouteng

I cannot set the IP-address on my PiiGAB 900 gateway.

Make sure the version of your PiiGAB 900 is V2 (V2.XX.XX.XXX) or greater.

I have one M-Bus meter and one M-Bus gateway for 300 baud but cannot communicate.

Increase the value of BusTimeout. Possibly there is a timeout which cuts of the response from the meter in PiiGAB M-Bus Setup Wizard. Go to Debug/Tools/Timeout. Change value of BusTimeout to 10000 milliseconds.

It’s not possible to find all M-Bus meter with the search function when using primary address.

Some M-Bus meters don’t support SND_NKE together with REQ_UD2 requests. Uncheck the SND_NKE box and the meters should respond.

Missing OCX-file

An error message shows if an OCX-file is missing when PiiGAB M-Bus Setup Wizard is starting.

For example:

The error is due to that the specified file is missing in the Windows installation.

To solve the problem:
1) Search for the missing file. For example search at OCX-dump.
2) Save the OCX-file in the folder C:\Windows\SysWOW64\.
3) Start the terminal.
4) Run the command: regsvr32 “C:\Windows\SysWOW64\mscomm32.ocx”.
Note: Administration privileges might be needed to run the above command.

PiiGAB M-Bus Setup Wizard should now start.

PiiGAB M-Bus Setup Wizard crashes due to authorization problems. I’m not running as administrator.

On newer Windows operating systems than Windows XP, C:\Program files is no longer suitable as installation folder. Administration authority is required for this folder. If you are not administrator you have to install PiiGAB M-Bus Setup Wizard in a folder which doesn’t require administration authority. For example you my use C:\ or C:\PiiGAB M-Bus Setup Wizard

Unable to send UDP Data

This happens due to one or more of the network cards have changed in the computer’s configuration when PiiGAB M-Bus Setup Wizard was running. For instance changing the IP-address of the network card.

PiiGAB M-Bus Setup Wizard detects only network cards when starting and when the error occurred there are invalid connections to the network cards.

Please restart the PiiGAB M-Bus Setup Wizard.

Unsuccessful secondary address search with PiiGAB M-Bus 900S

If the search of secondary addresses failes in the PiiGAB M-Bus Setup Wizard through a PiiGAB M-Bus 900S then the timeouts are probably set too high.

 

There are four timeouts that are required to configure:

  • MBusHub Master port in PiiGAB M-Bus 900S.
  • MBusHub slave port in PiiGAB M-Bus 900S.
  • SND_NKE/SND_UD timeout in PiiGAB M-Bus Setup Wizard.
  • RSP_UD2 timeout in PiiGAB M-Bus Setup Wizard

 

This table shows how to configure the tiemouts depending on the communication speed:

300 Baudrate2400 Baudrate
9600 Baudrate
Master port9600ms1300ms400ms
Slave port9600ms1300ms400ms
SND_NKE11000ms1500ms600ms
REQ_UD211000ms1500ms600ms

 

Which communication ports are used in the PiiGAB M-Bus Setup Wizard

Port 30718 over UDP/IP is being used in the following functions:

  • Find the gateways on the network.
  • Changing the gateway’s IP- settings.
  • Changing the gateways parameters.

The other functions in the PiiGAB M-Bus Setup Wizard require the user to choose port and protocol manually.

 

Specific for Find gateways on the network

The function Find the gateways on the network uses the broadcast address (255.255.255.255) to find the PiiGAB M-Bus 810 and PiiGAB M-Bus 900 on the network. The broadcast might be inactivated in some routers, which can cause gateways placed on other subnets not to be found.

PiiGAB QuickLoop

How do I sample multiple tags simultaneously?

By choosing the ArrayLimit parameter it is possible to sample 1-10 tags simultaneously.

I have started QuickLoop but cannot read any values?

Make sure that the sampling time actually has been set to the tags in question. If they are set to 00:00:00 the sampling will not start.

My sampling time is set to an hour; however I want to be able to read the first sample at the time of the QuickLoop start?

Mark the box “Sample at Startup,” and by doing that the first sampling will be done right away even though you have chosen the sampling to be done hourly.

My tags are not exported in the same order as I specified in my project.

Under advance settings for the project change the parameter Threads to value 1.

System requirments

In order to run QuickLoop the .NET framework 4.5.2 package must be installed on the computer.

 

These operating system, amongst others, have support for .NET Framework 4.5.2:

  • Windows 7 (x86 orx64) with service pack 1.
  • Windows 8 (x86 or x64) with Update.
  • Windows 10 (x86 or x64).
  • Windows Server 2008 R2 (x64) with service pack 1.
  • Windows Server 2012 (x64).
  • Windows Server 2012 R2 (x64).

 

PiiGAB QuickPost

Can another PiiGAB M-Bus 900 be used to deliver the M-Bus ASCII data?

Yes, the M-Bus ASCII data can be delivered by any PiiGAB M-Bus 900 with a slave port configured for M-Bus ASCII.

Can I install PiiGAB QuickPost by myself?

Yes, PiiGAB QuickPost can be downloaded from www.piigab.com. In the PiiGAB M-Bus 900’s web interface the Administration page provides the choice Update Software where the application can be installed.

Does QuickPost use active or passive mode for FTP?

QuickPost use passive mode.

Does the gateway require a license for PiiGAB QuickPost?

Yes, without PiiGAB QuickPost present in the license the functionality of PiiGAB QuickPost won’t work.

Does the internal clock in the gateway need be set for PiiGAB QuickPost to work?

No, not necessary. However, it is recommended to set the internal clock to sync the gateway’s clock with the FTP- or HttpPost-server’s clock.

For Upload time, at what time exactly does the files upload?

When GMT has reached Upload time the file will be uploaded. Not when local time has reached Upload time.

How many re-inquiries are necessary?

At least one can be specified. But if any M-Bus meter fails to transmit data after the first retry there is usually no meaning to continue retrying.

Is a name server required?

Only if the gateway have static IP-configuration. Set the name server on the PiiGAB M-Bus 900’s configuration page in the Name Server field for static IP.

Is M-Bus ASCII required for PiiGAB QuickPost?

Yes, the raw M-Bus data from the M-Bus meters must be converted into PiiGAB’s M-Bus ASCII protocol before it can be exported with PiiGAB QuickPost.

Must the configuration file for PiiGAB QuickPost be the same as the PiiGAB M-Bus 900’s master port?

No, the content of Quick Post’s configuration file can either be a subset or the same file as the Master ports.

What file formats are available?

The different formats are all present in the field called File Format in PiiGAB QuickPost’s configuration page. You are able to read more about the file format in the manual.

What happens when Upload period is set to 0?

This will let Upload time decide when PiiGAB QuickPost will export.

What indicates that PiiGAB QuickPost is installed on the PiiGAB M-Bus 900?

In the navigation field to the left of the gateways web interface PiiGAB QuickPost should be available as a choice.

What time value should the read timeout have?

This value depends on the timeout of the slave ports which delivers M-Bus ASCII data. PiiGAB QuickPost’s read timeout should always be greater than the slave port’s to guarantee that the data will arrive to the PiiGAB QuickPost application.

QuickOPC

After a while there are no more values read from the OPC-server. QuickOPC must be restarted to receive new values.

Make sure there us a license installed on the computer with QuickOPC installed. QuickOPC only works in 30 minutes if there is no license.

After long execution there are very much memory allocated for my program which use QuickOPC.

This problem occurs if there are many instances of the EasyDAClient class which is not removed correctly. When an instance should not be used any more call the EasyDAClient.Dispose() method. This will flag for .NET GC (Garbage Collector) that the instance can be removed. You can also use one or few instances of the EasyDAClient class instead of many. But please class the EasyDAClient.Dispose() method when the instances are not needed any more.

Cannot install a license with the License Manager.

If you are running on Windows Vista or Windows 7 you might need to run the License Manager as administrator.

EasyDAClient crashes

Id you are using .NET Framework 4.6 will EasyDAClient crash during initialization. Please use the following solution:

  • Open the Window’s registry (regedit.exe)
  • Browse to: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework
  • Create a new 32-bit value (DWORD)
  • Name: useLegacyJIT
  • Value: 1
  • Close the registry

Note: You might need administration privileges to gain access to the Window’s registry.