The configuration file ExtremeValueIndex.xml is saved in the "ExtremeValues" subdirectory of the eBus master service directory (default: "D:\KBR\Data\Kbr.EbusMaster.CommunicationService\2.0.0.0"). With this file, you can define the extreme values to be read.
<?xml version="1.0" encoding="utf-8" ?>
<extremevalues version="4.5.3000">
<deviceclass classguid="c84e4b3d-ef55-4cda-ae2c-83fbb3fce59f" name="multimess 3F144-1-LED">
<version value="4.5.3" firstversion="0.0.0" lastversion="0.0.0" >mmess_3_4_base.xml</version>
</deviceclass>
</extremevalues>
You need one <deviceclass> node per device type. As a minimum, it must be assigned the "classguid" attribute by defining a unique device class GUID in the eBus master. This combination may only be included once within the <extremevalues> root node.
The device class GUID is always displayed in the device properties:
As the extreme value data points might vary depending on the version, a <version> node is included. It contains 3 attributes:
- value = the version designation
- firstversion = the first device firmware version for which the setting applies
-
lastversion = the last device firmware version for which the setting applies
The version information "0.0.0" indicates "undefined", meaning that there are no limitations in terms of the first or last version.
In the <version> node value, the XML file name defining the extreme values of this device version is specified.
The corresponding file has to be in the same directory and is structured as follows:
<?xml version="1.0" encoding="utf-8" ?>
<deviceclass>
<extremevalue id="UPhN.Max.L1" default="true" obiscode="1-0:32.6.0*0" name="U PH-N L1 MAX" value="ExtremeValues.UPhN.Max.L1.Value" timestamp="ExtremeValues.UPhN.Max.L1.TimeStamp" reset="ExtremeValues.UPhN.Max.L1.Reset">
</extremevalue>
...
<extremevaluegroup default="false" reset="ExtremeValues.Thd.U.ResetAllMax" name="U Thd" id="U.Thd">
...
<extremevalue id="Thd.U.Thd.Max.L1" obiscode="1-0:32.6.124*0" name="Thd U L1 MAX" value="ExtremeValues.Thd.U.Thd.Max.L1.Value" timestamp="ExtremeValues.Thd.U.Thd.Max.L1.TimeStamp">
</extremevalue>
<extremevalue id="Thd.U.Thd.Max.L2" obiscode="1-0:52.6.124*0" name="Thd U L2 MAX" value="ExtremeValues.Thd.U.Thd.Max.L2.Value" timestamp="ExtremeValues.Thd.U.Thd.Max.L2.TimeStamp">
</extremevalue>
</extremevaluegroup>
</deviceclass>
The XML file begins with the <deviceclass> root node, which can have two types of subnodes: <extremevalue> and <extremevaluegroup>
- <extremevalue> defines an individual extreme value with the following attributes: • id : Item ID designation of the extreme value data point • obiscode: OBIS code of the extreme value • name: legible designation of the extreme value • value: Item ID of the data point that includes the extreme value • timestamp: Item ID of the data point that includes the timestamp of the extreme value • reset: Item ID of the data point that includes the reset command of the extreme value.<extremevaluegroup> defines a group of extreme values that share a common reset command. In this group, you can find the corresponding <extremevalue> nodes. The reset attribute, however, is located in the group node.
- <extremevaluegroup> definiert eine Gruppe von Extremwerten, die einen gemeinsamen Reset-Befehl besitzen. Darunter sind wieder die entsprechenden <extremevalue>-Knoten. Das reset-Attribut sitzt allerdings im Gruppenknoten.
For certain individual devices, you can make special extreme value settings. For this purpose, the 'ExtremeValueIndex.xml' file has to include one <device> node per device with the "id" attribute, to which a unique device GUID is assigned.The node The Again, the node value has the name of the XML file that contains the settings (as described above).