XmlDemo user's guide

XmlDemo screen shot

 XmlDemo is a Windows application which can communicate with a COSEM/DLMS device, using either the HDLC communication profile (via serial-line, or TCP) or the TCP-based WRAPPER communication profile. XmlDemo uses the trial versions of the ezhdlc and xmlpdu libraries.  Therefore, ezhdlc timeouts after about 15 minutes (as indicated by the word TIMEOUT in the application title bar). This indicates that the HDLC layer cannot be used anymore and XmlDemo must be restarted. Also, xmlpdu trial has several limitations.

After having started the application, do the following:

1 : Select ''View/Settings...''

XmlDemo uses settings-files files to store all the parameters needed for the communication with a particular device. The current settings-file is shown in the settings-editor which is displayed when selecting View/Settings... When started, XmlDemo automatically reloads the last settings-file.

When started for the first time, XmlDemo loads the default settings-file (Settings_Template.txt). You will have to modify this file for the device with which you have to connect to. When done, right-click in the settings-editor and save the content to a file. You can have as many settings-files as needed, for different devices, different configurations, different protocols etc...Furthermore, the ''Settings'' subdirectory contains several examples for L+G and Actaris devices.

2 : Select ''Do/Connect''

''Connect'' performs the HDLC or the TCP connection. The HDLC connection is automatically and periodically polled so that it is kept alive. The PDU exchanges can be seen by clicking View/Traffic... The green lines show the outgoing data. The red lines show the incoming data.

3 : Select Do/Send  (Send "requests'' and receive ''responses'')

Right-click on the request (upper) pane, select Load... and navigate to a xml file containing the request you want to send to the device. Usually, the first request should be an AssociationRequest. Then click Send....

Note that the settings can also specify the name of an AssociationRequest file which is sent automatically after the ''connect'' (see item DefaultAARQFile in the settings).

XmlDemo encodes the request, sends it to the device, waits for the device's response, decodes the response and displays it into the response (lower) pane.

Once the association is established, you can load other xml files to read COSEM objects attributes.

4 : Select Do/Disconnect

''Disconnect'' closes the HDLC or TCP connection.