Configuring the LocationAwarenessAgent settings
The following sections describe how to configure the Location Awareness agent.
LocationAwarenessAgent parameters
The following parameters' default settings are appropriate for most implementations. The following parameters may be changed depending on your system's requirements.
|
Name |
Description |
Type |
Unit |
Min |
Max |
Default |
|---|---|---|---|---|---|---|
|
Voltage_LowerThreshold |
The lower threshold delta for VoltageA. |
float |
volts |
0.1 |
10 |
1.4 |
|
Voltage_UpperThreshold |
The upper threshold delta for VoltageA. |
float |
volts |
0.1 |
10 |
1.6 |
|
Voltage_EventMaxLengthSeconds |
The maximum length of the voltage event in seconds. Larger voltage changes take longer to establish. |
uint |
seconds |
1 |
15 |
10 |
|
EventReportInterval |
The frequency messages are to be sent out to one‑hop neighbors in seconds. |
uint |
seconds |
15 |
21600 |
3600 |
|
TimeStampThreshold |
The voltage events time drift tolerance in seconds. |
uint |
seconds |
1 |
30 |
15 |
|
EventThresholdCount |
The minimum friends+stranger count per MAC address to be present to considered to be packed as a part of daily message. |
uint |
seconds |
1 |
100 |
5 |
|
TimeCyclePeriod |
Determines the number of minutes within a day during which the neighbor table is sent once to the server. |
uint |
minutes |
1 |
1440 |
1440 |
|
CoincidentEvent_DeltaVTolerance |
The maximum allowed difference between event delta V in voltage units to consider them as coincident. The default is 2 indicating 0.2 volts on a 240V meter. |
uint |
volts |
40 |
100 |
80 |
|
GroupEvent_PctCoincidentMeters |
The minimum percentage of meters detecting the same group event required to include it in message 30#. |
uint |
percent |
10 |
100 |
50 |
|
NumberMainMeters |
The number of main meters per transformer group |
uint |
|
1 |
5 |
2 |
|
Name |
Description |
Type |
Unit |
Min |
Max |
Default |
|---|---|---|---|---|---|---|
|
SIDReportIntervalDays |
The interval, in days, to report the SID value. 0 sets a test mode with 5‑minute intervals. |
uint |
days |
0 |
30 |
10 |
|
SIDNeighborBroadcastIntervalHours |
The interval, in hours, to report the SID to neighbor meters. 0 sets a test mode with 15-minute intervals. |
uint |
hours |
0 |
24 |
6 |
|
Name |
Description |
Type |
Unit |
Min |
Max |
Default |
|---|---|---|---|---|---|---|
| SID | The short ID for the meter. | int | -1 | 16777215 | -1 | |
| TransformerGroupID | The identifier for the transformer group. | int | -1 | 16777215 | -1 | |
| CT_Multiplier | The current transformer multiplier | float | 1.00 | 10000.00 | 1.0 | |
| PT_Multiplier | The voltage transformer multiplier. | float | 1.00 | 10000.00 | 1.0 | |
|
RefMeterPhase1 RefMeterPhase2 RefMeterPhase3 |
The reference phase leg (1, 2, 3) 0 through 330 in 30 degree increments (-1 not available). | int | -1 | 330 | -1 | |
| TransformerUtilityID | The identifier for the transformer utility. | string | 0 | 40 | ||
| TransformerNumPhases | The number of transformer phases. | uint | 1 | 3 | ||
| TransformerRating | The transformer rating in kVA. | float | 0 | 0 |
Sample configuration XML files
This XML file contains sample values for one possible basic configuration.
<?xml version="1.0" encoding="UTF-8"?>
<diConfigParameters feature-id="50593790"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="BasicConfig.xsd">
<folders>
<folder name="General">
<parameter name="FeatureState" value="1" />
<parameter name="LogLevel" value="3" />
<parameter name="KeepLogLevelForSecs" value="180" />
</folder>
<folder name ="LAv2Config">
<parameter name="DetectionMode" value="0" />
<parameter name="MaxServerMsgCountPerSend" value="2"/>
<parameter name="Voltage_LowerThreshold" value="0.5" />
<parameter name="Voltage_UpperThreshold" value="5.0" />
<parameter name="Voltage_EventMaxLengthSeconds" value="10" />
<parameter name="EventReportInterval" value="3600" />
<parameter name="PreferredNwkMedium" value="PLC" />
<parameter name="TimeStampThreshold" value="15" />
<parameter name="EventThresholdCount" value="5" />
<parameter name="ServerMessageSendInterval" value="1440"/>
<parameter name="SNRThreshold" value="40" />
<parameter name="FilterOnPhaseShift" value="0" />
<parameter name="DayCyclePeriod" value="1" />
<parameter name="DayCycleStart" value="1" />
<parameter name="TimeCyclePeriod" value="1440" />
<parameter name="TimeCycleStart" value="1" />
<parameter name="TestMode" value="0" />
<parameter name="SelfInduced_PctLoadChangeThreshold" value="5" />
<parameter name="SelfInduced_AssumedZp" value="50" />
<parameter name="SelfInduced_PctDeltaVoltageTolerance" value="80" />
<parameter name="CoincidentEvent_DeltaVTolerance" value="2" />
<parameter name="GroupEvent_PctCoincidentMeters" value="50" />
<parameter name="NumberMainMeters" value="2" />
</folder>
<folder name ="Discrepancy">
<parameter name="DiscrepancySNRThreshold" value="60" />
<parameter name="DiscrepancyThreshold" value="75" />
</folder>
<folder name ="Meter">
<parameter name="SID" value="0" />
<parameter name="TransformerGroupID" value="0" />
<parameter name="PhaseCount" value="0" />
<parameter name="RelPhase1" value="-1" />
<parameter name="RelPhase2" value="-1" />
<parameter name="RelPhase3" value="-1" />
<parameter name="AbsPhase1" value="" />
<parameter name="AbsPhase2" value="" />
<parameter name="AbsPhase3" value="" />
<parameter name="AbsolutePhase1" value="" />
<parameter name="AbsolutePhase2" value="" />
<parameter name="AbsolutePhase3" value="" />
<parameter name="CircuitPhase" value="" />
<parameter name="ServicePointStatus" value="Active" />
</folder>
<folder name ="Transformer">
<parameter name="ID" value="" />
<parameter name="Rating" value="0" />
<parameter name="Meters" value="" />
<parameter name="LowSideVoltage" value="0" />
<parameter name="PhaseCount" value="0" />
</folder>
<folder name ="SIDConfig">
<parameter name="SIDReportIntervalDays" value="10" />
<parameter name="SIDNeighborBroadcastIntervalHours" value="6" />
</folder>
<folder name="Service">
<parameter name="SID" display="Meter DI Short ID" value="-1" type="int" min="-1" max="16777215" />
<parameter name="TransformerGroupID" display="Transformer Group ID" value="-1" type="int" min="-1" max="16777215"/>
<parameter name="CT_Multiplier" display="Current Transformer Multiplier" value="1.0" type="float" min="1.00" max="10000.00"/>
<parameter name="PT_Multiplier" display="Voltage Transformer Multiplier" value="1.0" type="float" min="1.00" max="10000.00"/>
<parameter name="RefMeterPhase1" display="Reference Phase Leg1 0-330 in 30 degrees increments (-1 not available)" value="-1" type="int" min="-1" max="330"/>
<parameter name="RefMeterPhase2" display="Reference Phase Leg2 0-330 in 30 degrees increments (-1 not available)" value="-1" type="int" min="-1" max="330"/>
<parameter name="RefMeterPhase3" display="Reference Phase Leg3 0-330 in 30 degrees increments (-1 not available)" value="-1" type="int" min="-1" max="330"/>
<parameter name="TransformerRating" display="The transformer rating in kVA." value="0" type="float" min="0"/>
<parameter name="TransformerNumPhases" display="Number of Transformer Phases" type="uint" min="1" max="3"/>
<parameter name="TransformerUtilityID" display="Transformer Utility ID" value="" type="string" min="0" max="40"/>
</folder>
</folders>
</diConfigParameters>DI configurations and configuration change requests (CCRs)
-
For information about DI Configurations, see Configurations in the Itron Analytics Admin Portal Help.
-
For information about DI configuration change requests (CCRs), see Requests in the Itron Analytics Admin Portal Help.
Subscriptions
For information about DI subscriptions, see Subscriptions in the Itron Analytics Admin Portal Help.