background image

6

M-CVM-B-DATALOGGER XML Manual

Instruction Manual

 1�- INTRODUCTION

The 

M-CVM-B-Datalogger

 can be used to store data in the embedded PowerStudio platform

integrated in the module.

The information stored in the module can be accessed with a WEB browser compatible with 

HTML5 and/or with HTTP Requests sent to the integrated XML server.

Once the module has been connected to an Ethernet network and an IP address has been 

assigned to the module, use the web browser of a computer in the same local network and 

enter the IP address in the browser’s navigation bar. The embedded PowerStudio environment

of the module can be used to display the data in real time, as well as the data stored over time.

Refer to the PowerStudio manual and tutorials found on 

CIRCUTOR

’s website for more 

information about additional configurations, sending emails, generation of additional 

calculations, etc.

 2�- XML SERVICES

PowerStudio provides a range of XML services to enable, in some respects, communication 

with other applications. 

In requests where it is necessary to express a date and time, both in service request and the 

data from the response, these will be represented in UTC (Universal Coordinated Time) with 

the format DDMMYYYYHHMMSS (two digits for the day, two for the month, four for the year 

and two for the hour, minutes and seconds. It is also possible to represent only a date as 

DDMMYYYY assuming that the time is 00:00:00, or represent an hour as HHMMSS. Finally 

in cases where milliseconds are required these are represented with three digits after the 

seconds, DDMMYYYYHHMMSSUUU or HHMMSSUUU.

The requests must follow the URI standard (RFC 2396), so the user of these requests must 

take into account this detail when making such calls (especially in cases where the name of 

any device contains non-ASCII characters).It should also be taken into account that the length 

of the request may not exceed 4000 characters.

Summary of Contents for CVM-B100

Page 1: ...INSTRUCTION MANUAL M CVM B DATALOGGER XML Manual CVM B100 CVM B150 M034B01 03 17A ...

Page 2: ...2 M CVM B DATALOGGER XML Manual Instruction Manual ...

Page 3: ...ce may also lead to the risk of fire Read the manual carefully prior to connecting the unit Follow all installation and maintenance instructions throughout the unit s working life Pay special attention to the installation stan dards of the National Electrical Code Refer to the instruction manual before using the unit In this manual if the instructions marked with this symbol are not respected or c...

Page 4: ...nfo xml id dispositivo 7 2 3 services user varInfo xml var dispositivo variable id dispositivo 8 2 4 services user values xml var dispositivo variable id dispositivo 9 2 5 services user forceVariables xml id dispositivo 10 2 6 services user records xml begin end var period 900 11 2 7 services user events xml begin end id 14 2 8 services user recordsEve xml begin end id 15 3 TECHNICAL SERVICE 17 4 ...

Page 5: ...Table 1 Revision log Date Revision Description 11 15 M034B01 03 15A Initial version 08 17 M034B01 03 17A Modification of the device name Changes in the following sections 1 Note Devices images are for illustrative purposes only and may differ from the actual device ...

Page 6: ...n of additional calculations etc 2 XML SERVICES PowerStudio provides a range of XML services to enable in some respects communication with other applications In requests where it is necessary to express a date and time both in service request and the data from the response these will be represented in UTC Universal Coordinated Time with the format DDMMYYYYHHMMSS two digits for the day two for the ...

Page 7: ...nfo xml id dispositivo services user deviceInfo xml id dispositivo Returns information on devices Each of the devices on which information is required must be included in the request as id device2 id device2 devices device id id description description type type typeDescription typeDescription var var device devices Where Table 3 Parameter description 2 2 Parameter Description devices Main Field w...

Page 8: ... device variable And if you want to get information from all the variables of a device this must be indicated as id device With it being possible to request information from one or more variables and one or more devices in the same request varInfo var id id title title hasValue T hasValue hasLogger T hasLogger sampleMode sampleMode measureUnits measureUnits unitsFactor unitsFactor decimals decimal...

Page 9: ...Apparent power W Active power VARL Inductive power VARC Capacitive power PF Power factor HZ Frequency PERCENT Percentage WH Active energy VARLH Inductive energy VARCH Capacitive energy DATETIME Date and time If not preceded by it is a user defined unit unitsFactor Power of 10 that indicates the value the variable is multiplied by in the log file decimals Decimals with this variable 2 4 services us...

Page 10: ...nd the order to force variables to PowerStudio The request must include the name of the device we want to force so that if necessary authentication can be checked Only variables belonging to the device indicated in the request will be forced forceVariables forceVar forceName forceName forceValue forceValue forceVar forceVariables Where Table 6 Parameter description 2 5 Parameter Description forceV...

Page 11: ...data not grouped returning the register as they have saved in the log AUTO Grouping will take place automatically depending on the specified dates begin and end ALL Data is grouped into a single value 0 Value in seconds in which the data is grouped If the period parameter does not appear on the request it shall be considered as value 0 and the data will not be grouped recordGroup period period rec...

Page 12: ... 9 Parameter description 2 6 Table 3 Parameter Description id Variable identifier device variable value Value flags Additional information from the variable formed by the union of one or more of the following values 0x0000 The PLT is correct 0x0001 The PLT calculation has been done with fewer samples than expected 0x0002 The PLT calculation has been done with more samples than expected 0x0004 The ...

Page 13: ...monic value Waveform value record fieldFO id id element msec msec value value element fieldFO Table 11 Parameter description 2 6 Table 5 Parameter Description id Variable identifier device variable element Information from each of the points that make up the waveform msec millisecond value value EVQ event Record fieldEVQ id id value value phase phase duration duration averageValue averageValue pre...

Page 14: ...age associated with the event This field is optional and may not exist date Date and time DDMMYYYYHHMMSSUUU value Value 2 7 services user events xml begin end id services user events xml begin end id Returns the events log of one or more events between dates begin and end Each of the events on which information is required must be included in the request as id name_event The format of begin and en...

Page 15: ...edged 2 8 services user recordsEve xml begin end id services user recordsEve xml begin end id Returns information on events recorded by one or more devices between the dates begin and end Each of the devices on which information is required must be included in the request as id device The format of begin and end will be DDMMYYYY when you wish only to indicate the date in this case the hour will 00...

Page 16: ...in Main field that will identify the XML as a response to the request recordGroup Field that groups all the records of an event device Device the records refer to record Will Identify each of the records dateTime Date and time of the sample field Will identify each of the fields id Iden value Value of the event ...

Page 17: ...ons derived from a pos sible failure improper installation or improper usage of the unit Consequently this guarantee does not apply to failures occurring in the following cases Overvoltages and or electrical disturbances in the supply Water if the product does not have the appropriate IP classification Poor ventilation and or excessive temperatures Improper installation and or lack of maintenance ...

Page 18: ...CIRCUTOR SA Vial Sant Jordi s n 08232 Viladecavalls Barcelona Tel 34 93 745 29 00 Fax 34 93 745 29 14 www circutor com central circutor com ...

Reviews: