From e7431ce6e2342386f05fae9df6ef6597f6a70727 Mon Sep 17 00:00:00 2001
From: Milan Hanajik <milan.hanajik@xyleminc.com>
Date: Fri, 1 May 2020 10:44:28 +0200
Subject: [PATCH] DataStreamInterface added.

---
 .gitignore                                    |   3 +-
 DataStreamInterface/DataFrame.cs              |  23 ++++
 .../DataStreamInterface.csproj                |  61 ++++++++++
 ...interface for datastream water meters.docx | Bin 0 -> 20551 bytes
 DataStreamInterface/Enums.cs                  |  95 +++++++++++++++
 DataStreamInterface/IDataStreamMeter.cs       | 114 ++++++++++++++++++
 .../Properties/AssemblyInfo.cs                |  38 ++++++
 TBF.sln                                       |  12 ++
 clean.bat                                     |   2 +
 9 files changed, 347 insertions(+), 1 deletion(-)
 create mode 100644 DataStreamInterface/DataFrame.cs
 create mode 100644 DataStreamInterface/DataStreamInterface.csproj
 create mode 100644 DataStreamInterface/Doc/Software interface for datastream water meters.docx
 create mode 100644 DataStreamInterface/Enums.cs
 create mode 100644 DataStreamInterface/IDataStreamMeter.cs
 create mode 100644 DataStreamInterface/Properties/AssemblyInfo.cs

diff --git a/.gitignore b/.gitignore
index 96b6c986f..e4e7016bd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,6 +2,8 @@ Common/bin/
 Common/obj/
 Config/bin/
 Config/obj/
+DataStreamInterface/bin/
+DataStreamInterface/obj/
 Decrypt/bin/
 Decrypt/obj/
 DeviceTest/bin/
@@ -40,7 +42,6 @@ Users/bin/
 Users/obj/
 UserManagement/bin/
 UserManagement/obj/
-Doc/
 .vs/
 *.suo
 *.bak
diff --git a/DataStreamInterface/DataFrame.cs b/DataStreamInterface/DataFrame.cs
new file mode 100644
index 000000000..6338df650
--- /dev/null
+++ b/DataStreamInterface/DataFrame.cs
@@ -0,0 +1,23 @@
+///
+/// Copyright (c) 2020 Sensus Slovensko a.s.
+///
+using System;
+
+namespace DataStreamInterface
+{
+    public class DataFrame
+    {
+        public readonly UInt64 ID;          /// Frame ID
+        public readonly double Time;        /// Time stamp in units of time
+        public readonly double Volume;      /// Volume in units of volume
+        public readonly double[] Quantity;  /// An array of optional quantities in their respective units
+
+        public DataFrame(UInt64 id, double time, double volume, double[] quantity)
+        {
+            ID = id;
+            Time = time;
+            Volume = volume;
+            Quantity = quantity;
+        }
+    }
+}
diff --git a/DataStreamInterface/DataStreamInterface.csproj b/DataStreamInterface/DataStreamInterface.csproj
new file mode 100644
index 000000000..49ae9f254
--- /dev/null
+++ b/DataStreamInterface/DataStreamInterface.csproj
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
+  <PropertyGroup>
+    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+    <ProjectGuid>{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}</ProjectGuid>
+    <OutputType>Library</OutputType>
+    <AppDesignerFolder>Properties</AppDesignerFolder>
+    <RootNamespace>DataStreamInterface</RootNamespace>
+    <AssemblyName>DataStreamInterface</AssemblyName>
+    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
+    <FileAlignment>512</FileAlignment>
+    <TargetFrameworkProfile />
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+    <DebugSymbols>true</DebugSymbols>
+    <DebugType>full</DebugType>
+    <Optimize>false</Optimize>
+    <OutputPath>bin\Debug\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+    <DebugType>pdbonly</DebugType>
+    <Optimize>true</Optimize>
+    <OutputPath>bin\Release\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <ItemGroup>
+    <Reference Include="System" />
+    <Reference Include="System.Core" />
+    <Reference Include="System.Xml.Linq" />
+    <Reference Include="System.Data.DataSetExtensions" />
+    <Reference Include="Microsoft.CSharp" />
+    <Reference Include="System.Data" />
+    <Reference Include="System.Xml" />
+  </ItemGroup>
+  <ItemGroup>
+    <Compile Include="DataFrame.cs" />
+    <Compile Include="Enums.cs" />
+    <Compile Include="IDataStreamMeter.cs" />
+    <Compile Include="Properties\AssemblyInfo.cs" />
+  </ItemGroup>
+  <ItemGroup>
+    <Content Include="Doc\Software interface for datastream water meters.docx">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
+  <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
+       Other similar extension points exist, see Microsoft.Common.targets.
+  <Target Name="BeforeBuild">
+  </Target>
+  <Target Name="AfterBuild">
+  </Target>
+  -->
+</Project>
\ No newline at end of file
diff --git a/DataStreamInterface/Doc/Software interface for datastream water meters.docx b/DataStreamInterface/Doc/Software interface for datastream water meters.docx
new file mode 100644
index 0000000000000000000000000000000000000000..09770fbc19d565aefb51f5dadbd9c01f5cf65905
GIT binary patch
literal 20551
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
KFw@NS0r3DL&K?Q?

literal 0
HcmV?d00001

diff --git a/DataStreamInterface/Enums.cs b/DataStreamInterface/Enums.cs
new file mode 100644
index 000000000..f913fc73c
--- /dev/null
+++ b/DataStreamInterface/Enums.cs
@@ -0,0 +1,95 @@
+///
+/// Copyright (c) 2020 Sensus Slovensko a.s.
+///
+using System;
+
+namespace DataStreamInterface
+{
+    public enum Unit
+    {
+        None,
+
+        pulse,
+        degree,
+
+        /// Volume
+        ml,         ///   0.001 l
+        l,          /// * 1 liter = 1 l
+        dm3,        ///   1 dm3 = 1 l
+        m3,         ///   1000 l
+        gal_UK,     ///   1 gal(UK) = 4.54609 l
+        gal_US,     ///   1 gal(US) = 3.78541178 l
+
+        /// Flow
+        lph,        ///   1 liter/h
+        m3ph,       /// * 1 m3/h = 1000 l/h
+
+        /// Mass
+        g,          ///   0.001 kg
+        kg,         /// * 1 kilogram
+        t,          ///   1000 kg
+        lb,         ///   0.45359237 kg
+
+        /// Time
+        ms,         ///   1 ms = 0.001 s
+        s,          /// * 1 second = 1 s
+        min,        ///   1 min = 60 s
+        hour,       ///   1 hour = 60 min = 3600 s
+
+        /// Temperature
+        C,          /// * degree Celsius (°C)
+        F,          ///   degree Fahrenheit
+        K,          ///   degree Kelvin
+
+        /// Pressure
+        Pa,         ///   1 Pa = 0.01 hPa
+        hPa,        ///   1 hPa = 100 Pa
+        mbar,       ///   1 mbar = 1 hPa = 100 Pa
+        kPa,        ///   1 kPa = 10 HPa
+        inHg,       ///   1 inHg = 33.864 hPa
+        bar,        /// * 1 Bar = 1000 mbar = 0.1 MPa = 100000 Pa
+        MPa,        ///   1 MPa = 10000 hPa
+
+        /// Humidity
+        RPct,       /// * 1 R%
+
+        /// Relative error
+        Promile,    ///   1 promile = 0.1 %
+        Pct,        /// * 1 %
+
+        /// Length
+        mm,         /// * 1 millimeter
+        cm,         ///   1 cm = 10 mm
+        inch,       ///   1 inch = 25.4 mm
+        foot,       ///   1 foot = 304.8 mm
+        m,          ///   1 m = 1000 mm
+
+        /// Density
+        kgpm3,		/// * 1 kg/m3 = 0.001 kg/l
+        kgpl,		///   1 kg/l = 1000 kg/m3
+
+        /// Energy
+        J,			/// * 1 Joul
+        kJ,			///   1 kJ = 1000 J
+        MJ,         ///   1 MJ = 1000000 J
+        Wh,			///   1 Wh = 3600 J
+        kWh,		///   1 kWh = 3600000 J
+        MWh,		///   1 MWh = 3600000000 J
+
+        /// Meter coefficient - volume
+        ppl,		/// * 1 pulse/l
+        ppdm3,		/// * 1 pulse/dm3
+        degpl,		/// * 1 degree/l
+        degpdm3,	/// * 1 degree/dm3
+        lpp,		/// * 1 l/pulse
+        dm3pp,		/// * 1 dm3/pulse
+        lpdeg,		/// * 1 l/degree
+        dm3pdeg,	/// * 1 dm3/degree
+
+        /// Meter coefficient - energy
+        ppkWh,		/// * 1 pulse/kWh
+        kWhpp,		/// * 1 kWh/pulse
+
+        Count
+    }
+}
diff --git a/DataStreamInterface/IDataStreamMeter.cs b/DataStreamInterface/IDataStreamMeter.cs
new file mode 100644
index 000000000..6255b1b0a
--- /dev/null
+++ b/DataStreamInterface/IDataStreamMeter.cs
@@ -0,0 +1,114 @@
+///
+/// Copyright (c) 2020 Sensus Slovensko a.s.
+///
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace DataStreamInterface
+{
+    public interface IDataStreamMeter
+    {
+        /// <summary>
+        /// Get state of the connected data stream meter
+        /// </summary>
+        /// <param name="state">Current state of the meter</param>
+        /// <returns>true when successful</returns>
+        bool GetState(out int state, out string parameter);
+
+        /// <summary>
+        /// Set state of the connected data stream meter
+        /// </summary>
+        /// <param name="state">Required state of the meter</param>
+        /// <returns>true when successful</returns>
+        bool SetState(int state, string parameter);
+
+        /// <summary>
+        /// Establish connection with a data stream meter
+        /// </summary>
+        /// <param name="connectionParameters">Connection parameters</param>
+        /// <param name="meterId">Meter ID (e.g. serial number)</param>
+        /// <returns>true when successful</returns>
+        bool OpenConnection(string connectionParameters, out string meterId);
+
+        /// <summary>
+        /// Closes connection with the data stream meter
+        /// </summary>
+        /// <returns>true when successful</returns>
+        bool CloseConnection();
+
+        /// <summary>
+        /// Stars saving measurement results into internal data structures of the component.
+        /// Each data frame obtains a unique ID.
+        /// The very first data fraim obrains ID = 0.
+        /// </summary>
+        /// <returns>true when successful</returns>
+        bool StartMeasurement();
+
+        /// <summary>
+        /// Stops saving measurement results into internal data structures of the component.
+        /// Updates ID of the last date frame received from the meter.
+        /// </summary>
+        /// <param name="lastFrameID">ID of the last date frame</param>
+        /// <returns>true when successful</returns>
+        bool StopMeasurement(out UInt64 lastFrameID);
+
+        ///------------------------------------------------
+        /// Units of time, volume and optional quantities
+        ///------------------------------------------------
+
+        /// <summary>
+        /// Returns time units (s, ms, ...)
+        /// </summary>
+        Unit GetTimeUnits();
+
+        /// <summary>
+        /// Returns units of volume (ml, l, ...)
+        /// </summary>
+        Unit GetVolumeUnits();
+
+        ///-----------------------------------------------
+        /// Ooptional quantities: count, units, captions
+        ///-----------------------------------------------
+
+        /// <summary>
+        /// Returns count of optional quantities in each data frame
+        /// </summary>
+        /// <returns>Count of optional quantities</returns>
+        int GetQuantitiesCount();
+
+        /// <summary>
+        /// Returns units of the specified quantity
+        /// </summary>
+        /// <param name="quanityNr">Zero based quantity number 0 .. quantites count-1</param>
+        Unit GetQuantityUnits(int quanityNr);
+
+        /// <summary>
+        /// Returns caption of the specified quantity
+        /// </summary>
+        /// <param name="quanityNr">Zero based quantity number 0 .. quantites count-1</param>
+        string GetQuantityCaption(int quanityNr);
+
+        ///---------------------------
+        /// Datastream data exchange
+        ///---------------------------
+
+        /// <summary>
+        /// Retuns 'count' data frames starting with data frame with ID = 'id' 
+        /// </summary>
+        /// <param name="id">First frame ID</param>
+        /// <param name="count">Frames count</param>
+        /// <returns>Selected data frames</returns>
+        DataFrame[] GetFrames(UInt64 id, int count);
+
+        /// <summary>
+        /// Returns ID of the data frame where time equals or exceeds the specified time.
+        /// When time of the first frame (ID=0) is larger then specified time, function returns 0.
+        /// </summary>
+        /// <param name="time">Time</param>
+        /// <returns>ID of the data frame at or after the pecified time</returns>
+        UInt64 GetID(double time);
+    }
+}
diff --git a/DataStreamInterface/Properties/AssemblyInfo.cs b/DataStreamInterface/Properties/AssemblyInfo.cs
new file mode 100644
index 000000000..7e172011f
--- /dev/null
+++ b/DataStreamInterface/Properties/AssemblyInfo.cs
@@ -0,0 +1,38 @@
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+using System.Resources;
+
+// General Information about an assembly is controlled through the following 
+// set of attributes. Change these attribute values to modify the information
+// associated with an assembly.
+[assembly: AssemblyTitle("DataStreamInterface")]
+[assembly: AssemblyDescription("")]
+[assembly: AssemblyConfiguration("")]
+[assembly: AssemblyCompany("")]
+[assembly: AssemblyProduct("DataStreamInterface")]
+[assembly: AssemblyCopyright("Copyright ©  2020")]
+[assembly: AssemblyTrademark("")]
+[assembly: AssemblyCulture("")]
+
+// Setting ComVisible to false makes the types in this assembly not visible 
+// to COM components.  If you need to access a type in this assembly from 
+// COM, set the ComVisible attribute to true on that type.
+[assembly: ComVisible(false)]
+
+// The following GUID is for the ID of the typelib if this project is exposed to COM
+[assembly: Guid("e44458ee-b635-4d7c-a763-20054399e817")]
+
+// Version information for an assembly consists of the following four values:
+//
+//      Major Version
+//      Minor Version 
+//      Build Number
+//      Revision
+//
+// You can specify all the values or you can default the Build and Revision Numbers 
+// by using the '*' as shown below:
+// [assembly: AssemblyVersion("1.0.*")]
+[assembly: AssemblyVersion("1.0.0.0")]
+[assembly: AssemblyFileVersion("1.0.0.0")]
+[assembly: NeutralResourcesLanguageAttribute("en")]
diff --git a/TBF.sln b/TBF.sln
index 777120a0e..8d202f8ac 100644
--- a/TBF.sln
+++ b/TBF.sln
@@ -67,6 +67,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EventViewer", "EventViewer\
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Common", "Common\Common.csproj", "{C8939821-BA5C-4988-A3D0-BF53B74865C7}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DataStreamInterface", "DataStreamInterface\DataStreamInterface.csproj", "{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -291,6 +293,16 @@ Global
 		{C8939821-BA5C-4988-A3D0-BF53B74865C7}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
 		{C8939821-BA5C-4988-A3D0-BF53B74865C7}.Release|Mixed Platforms.Build.0 = Release|Any CPU
 		{C8939821-BA5C-4988-A3D0-BF53B74865C7}.Release|x86.ActiveCfg = Release|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Release|Mixed Platforms.Build.0 = Release|Any CPU
+		{7EBEEA14-91C4-48D7-AF0A-7A4BC3FF9A28}.Release|x86.ActiveCfg = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
diff --git a/clean.bat b/clean.bat
index bc5931579..1e408ae9a 100644
--- a/clean.bat
+++ b/clean.bat
@@ -2,6 +2,8 @@ rmdir /s /q Common\bin
 rmdir /s /q Common\obj
 rmdir /s /q Config\bin
 rmdir /s /q Config\obj
+rmdir /s /q DataStreamInterface\bin
+rmdir /s /q DataStreamInterface\obj
 rmdir /s /q Decrypt\bin
 rmdir /s /q Decrypt\obj
 rmdir /s /q DeviceTest\bin