Logical IDs (LIDs)

 

The table below contains a comprehensive list of the Logical IDs (LIDs) available for reading in the DI SDK and through the metering API. It also provides information on whether each LID should be retrieved via the subscription or the get-once methods, and, once retrieved, what type should be used to read the value out of the ApiVariableType correctly. 

Resources for DI Program Participants (Please fill out an application to gain access to the DI Developer Program)

How Agents Work DI Agent APIs

 

Subscription / Get Once 

LID Name 

LID Number 

Type 

Sim File Name 

Description 

INVALID_LID_NUMBER 

 

 

Unique 

ILID_LAST_BLURT_REAL_TIME_IN_MS 

18153640 

Uint64 

 

Last time at which all energy quantities were updated, in UTC 1970 time in milliseconds. 

Sub 

ILID_INS_CURRENT_A 

18153515 

Double 

Amp A 

One second RMS current on phase A, in amps. Resolution of 3.23688 microamps. 

Sub 

ILID_INS_CURRENT_B 

18153516 

Double 

Amp B 

One second RMS current on phase B, in amps. Resolution of 3.23688 microamps. 

Sub 

ILID_INS_CURRENT_C 

18153517 

Double 

Amp C 

One second RMS current on phase C, in amps. Resolution of 3.23688 microamps. 

Sub 

ILID_INS_FREQUENCY 

18153518 

Double 

Frequency 

Number of cycles per second measured on the line side. Resolution is 1cycle. 

Sub 

ILID_INS_VOLTS_A 

18153520 

Double 

Volt A 

One second RMS voltage on phase A, in volts. Resolution of 1decivolt BLURT or 2.5 centivolts CPC. 

Sub 

ILID_INS_VOLTS_B 

18153521 

Double 

Volt B 

One second RMS voltage on phase A, in volts. Resolution of 1decivolt BLURT or 2.5 centivolts CPC. 

Sub 

ILID_INS_VOLTS_C 

18153522 

Double 

Volt C 

One second RMS voltage on phase A, in volts. Resolution of 1decivolt BLURT or 2.5 centivolts CPC. 

Sub 

ILID_INS_VAS_AGGREGATE 

18153530 

Double 

VA 

One second average of apparent power across all phases, in volt-ampere (VA). Resolution of 8.28641 milliVA. 

Sub 

ILID_INS_WATTS_AGGREGATE 

18153531 

Double 

Watt 

One second average of power across all phases, in watts. Resolution of 8.28641 milliwatts. 

Sub 

ILID_INS_VAR_AGGREGATE 

18153532 

Double 

VAR 

One second average of reactive power across all phases, in volt-ampere reactive (VAR). Resolution of 8.28641 milliVAR. 

Sub 

ILID_INS_TEMPERATURE_CELCIUS 

18153533 

Double 

Temperature 

Heat measured by the metrological temperature sensor, measured in degrees celcius. Resolution of 1 degree. 

Sub 

ILID_INS_POWER_FACTOR 

18153559 

Double 

PowerFactor 

The ratio of real power vs apparent power, a unit-less number. Ranges from -1 to 1. 

Sub 

ILID_INS_VAB_ANGLE 

18153644 

Double 

V-Angle A-B 

The phase shift between phase A voltage and phase B voltage, in degrees. Resolution is 1 decidegree. 

Sub 

ILID_INS_VAC_ANGLE 

18153645 

Double 

V-Angle A-C 

The phase shift between phase A voltage and phase C voltage, in degrees. Resolution is 1 decidegree. 

Sub 

ILID_NEUTRAL_CURRENT_MEASURED 

18153652 

Double 

Amp N-Measured 

One second RMS current on the meter neutral, in amps. Resolution of 3.23688 microamps. 

Sub 

ILID_NEUTRAL_CURRENT_CALCULATED 

18153653 

Double 

Amp N-Calculated 

One second RMS current for all phases (A+ -B+C = neutral), in amps. Resolution of 3.23688 microamps. 

Sub 

ILID_NEUTRAL_CURRENT_TAMPER 

18153654 

Double 

Amp N-Tamper 

One second RMS current calculated from ILID_NEUTRAL_CURRENT_CALCULATED -ILID_NEUTRAL_CURRENT_MEASURED, in amps. Is a measure of theft, tamper or other physical anomaly. Resolution of 3.23688 microamps. 

Sub 

ILID_INS_VA_PHA 

18153655 

Double 

VA A 

One second average of apparent power for phase A, in volt-ampere (VA). Resolution of 8. -28641 milliVA. 

Sub 

ILID_INS_VA_PHB 

18153656 

Double 

VA B 

One second average of apparent power for phase B, in volt-ampere (VA). Resolution of 8. -28641 milliVA. 

Sub 

ILID_INS_VA_PHC 

18153657 

Double 

VA C 

One second average of apparent power for phase C, in volt-ampere (VA). Resolution of 8. -28641 milliVA. 

Sub 

ILID_INS_W_PHA 

18153658 

 Double 

Watt A 

One second average of power for phase A, in watts. Resolution of 8.28641 milliwatts. 

Sub 

ILID_INS_W_PHB 

18153659 

Double 

Watt B 

One second average of power for phase B, in watts. Resolution of 8.28641 milliwatts. 

Sub 

ILID_INS_W_PHC 

18153660 

Double 

Watt C 

One second average of power for phase C, in watts. Resolution of 8.28641 milliwatts. 

Sub 

ILID_INS_VAR_PHA 

18153661 

Double 

VAR A 

One second average of reactive power on phase A, in volt-ampere reactive (VAR). Resolution of 8.28641 milliVAR. 

Sub 

ILID_INS_VAR_PHB 

18153662 

Double 

VAR B 

One second average of reactive power on phase B, in volt-ampere reactive (VAR). Resolution of 8.28641 milliVAR. 

Sub 

ILID_INS_VAR_PHC 

18153663 

Double 

VAR C 

One second average of reactive power on phase C, in volt-ampere reactive (VAR). Resolution of 8.28641 milliVAR. 

Sub 

ILID_CPC_DATA_INSTLOADVOLTAGEPHA 

18153795 

Double 

Volt LS A 

One second RMS voltage on load side of phase A, in volts. CPC only. Resolution of 2.5 centi-volts. 

Sub 

ILID_CPC_DATA_INSTLOADVOLTAGEPHB 

18153796 

Double 

Volt LS B 

One second RMS voltage on load side of phase B, in volts. CPC only. Resolution of 2.5 centi-volts. 

Sub 

ILID_CPC_DATA_INSTLOADVOLTAGEPHC 

18153797 

Double 

Volt LS C 

One second RMS voltage on load side of phase C, in volts. CPC only. Resolution of 2.5 centi-volts. 

Sub 

ILID_INS_CURRENT_ANGLE_PHA 

18153839 

Double 

I-Angle A 

The phase shift between phase A current and phase A voltage, in degrees. Resolution is 1decidegree. 

Sub 

ILID_INS_CURRENT_ANGLE_PHB 

18153840 

Double 

I-Angle B 

The phase shift between phase B current and phase A voltage, in degrees. Resolution is 1decidegree. 

Sub 

ILID_INS_CURRENT_ANGLE_PHC 

18153841 

Double 

I-Angle C 

The phase shift between phase C current and phase A voltage, in degrees. Resolution is 1decidegree. 

Get 1 

ILID_INSTRUMENTDATA_RATED_VOLTAGE 

18153619 

Uint16 

 

The maximum supported voltage value of this meter, in volts. 

Get 1 

ILID_INSTRUMENTDATA_RATED_CURRENT 

18153620 

Uint16 

 

The maximum supported current value of this meter, in amps. 

Get 1 

ILID_BASE_METER_FORM 

18153550 

Uint8 

 

Enumeration that represents the expected electrical configuration of the meter. See Meter Form Enumeration. 

Get 1 

ILID_BASE_METER_NUMBER_PHASES 

18153557 

Uint8 

 

The number of phases supported by this meter's metrology base. 

Get 1 

ILID_INSTRUMENTSETTINGS_VOLTAGE_TFMR_NUMERATOR 

18153610 

Uint32 

 

For a transformer rated meter, the numerator of the transformer voltage ratio. 

Get 1 

ILID_INSTRUMENTSETTINGS_VOLTAGE_TFMR_DENOMINATOR 

18153613 

Uint32 

 

For a transformer rated meter, the denominator of the transformer voltage ratio. 

Get 1 

ILID_PHASE_A_NOMINAL_VOLTAGE 

18153832 

Double 

 

The expected voltage level on phase A for this particular meter, in volts. 

Get 1 

ILID_PHASE_B_NOMINAL_VOLTAGE 

18153833 

Double 

 

The expected voltage level on phase B for this particular meter. 

Get 1 

ILID_PHASE_C_NOMINAL_VOLTAGE 

18153834 

Double 

 

The expected voltage level on phase C for this particular meter. 

Get 1 

ILID_BASE_METER_TYPE 

18153836 

Uint8 

 

Enumeration that represents the physical configuration of the meter. See Meter Type Enumeration 

 

Meter Form Enumeration 

 

Value 

Standard Electric Meter Form Number 

10 

12 

13 

16 

25 

10 

29 

11 

36 

12 

45 

13 

46 

14 

48 

15 

56 

16 

66 

17 

96 

 

Meter Type Enumeration 

 

Value 

Definition 

Unspecified Base 

S Base 

A Base 

K Base 

IEC Base 

Switch Base 

Rack Base 

B Base 

P Base 

IEC Symmetric Base