E50HX Class
- ID: e50hx
- Name: Veris E50HX (E50H2/E50H5) Energy Meter Module
- Category: electric
- Manufacturer: veris
- Connection: uart
- Link: http://www.veris.com/Item/E50H5.aspx
This module implements support for the Veris E50H2 and E50H5 BACnet Energy Meters.
From the datasheet: The E50H5 BACnet MS/TP DIN Rail Meter with Data Logging combines exceptional performance and easy installation to deliver a cost-effective solution for power monitoring applications. Native serial communication via BACnet MS/TP provides complete accessibility of all measurements to your Building Automation System The data logging capability protects data in the event of a power failure. The E50H5 can be easily installed on standard DIN rail, surface mounted or contained in an optional NEMA 4 enclosure, as needed. The front-panel LCD display makes device installation and setup easy and provides local access to the full set of detailed measurements.
This module was developed using the upm::BACNETMSTP module, based on libbacnet-stack 0.8.3. Both libbacnet 0.8.3 and the upm::BACNETMSTP libraries must be present in order to build this module. This driver was developed on the E50H5. The Trend Log functionality is not currently supported.
The Binary Input Objects are also not supported as these are only used for the Alarm bits which are already available from Analog Input Object 52 as an alarm bitfield incorporating all of the supported alarm indicators.
It was connected using an RS232->RS485 interface. You cannot use the built in MCU TTL UART pins for accessing this device b you must use a full Serial RS232->RS485 or USB-RS485 interface connected via USB.
Item Index
Methods
Properties
- AV_Config
- AV_System_Type
- AV_CT_Ratio_Primary
- AV_CT_Ratio_Secondary
- AV_PT_Ratio
- AV_System_Voltage
- AV_Display_Units
- AV_Phase_Loss_Voltage_Threshold
- AV_Phase_Loss_Imbalance_Threshold
- AV_Subintervals
- AV_Subinterval_Length
- AI_Energy
- AI_kW_Total
- AI_kVAR_Total
- AI_kVA_Total
- AI_PF_Total
- AI_Volts_LL_Avg
- AI_Volts_LN_Avg
- AI_Current_Avg
- AI_kW_A
- AI_kW_B
- AI_kW_C
- AI_PF_A
- AI_PF_B
- AI_PF_C
- AI_Volts_AB
- AI_Volts_BC
- AI_Volts_AC
- AI_Volts_AN
- AI_Volts_BN
- AI_Volts_CN
- AI_Current_A
- AI_Current_B
- AI_Current_C
- AI_Frequency
- AI_kVAh
- AI_kVARh
- AI_kVA_A
- AI_kVA_B
- AI_kVA_C
- AI_kVAR_A
- AI_kVAR_B
- AI_kVAR_C
- AI_KW_Present_Demand
- AI_KVAR_Present_Demand
- AI_KWA_Present_Demand
- AI_KW_Max_Demand
- AI_KVAR_Max_Demand
- AI_KVA_Max_Demand
- AI_Pulse_Count_1
- AI_Pulse_Count_2
- AI_KWH_A
- AI_KWH_B
- AI_KWH_C
- AI_Max_Power
- AI_Energy_Resets
- AI_Power_Up_Count
- AI_Output_Config
- AI_Alarm_Bitmap
- ALARM_Volts_Error_A
- ALARM_Volts_Error_B
- ALARM_Volts_Error_C
- ALARM_Current_Error_A
- ALARM_Current_Error_B
- ALARM_Current_Error_C
- ALARM_Frequency_Error
- ALARM_Reserved_0
- ALARM_Phase_Loss_A
- ALARM_Phase_Loss_B
- ALARM_Phase_Loss_C
- ALARM_Power_Factor_A
- ALARM_Power_Factor_B
- ALARM_Power_Factor_C
- ALARM_RTC_RESET
- CFG_CLR_ENERGY_ACCUM
- CFG_NEW_DSI
- CFG_RESET_MAX_TO_PRESENT
- CFG_CLEAR_PULSE_COUNTERS
- SYSTYPE_SINGLE_PHASE_AN
- SYSTYPE_SINGLE_PHASE_AB
- SYSTYPE_SPLIT_PHASE_ABN
- SYSTYPE_3PHASE_ABC
- SYSTYPE_3PHASE_ABCN
- CT_RATIO_SECONDARY_1
- CT_RATIO_SECONDARY_3
- DISP_UNITS_IEC
- DISP_UNITS_IEEE
Methods
E50HX
-
targetDeviceObjectID
E50HX constructor
Parameters:
-
targetDeviceObjectIDNumberthe unique Instance ID of the Device Object. This number is used to uniquely identify devices on the BACnet network, and ranges from 1 to 4194302. This is not the device's MAC address, though on some devices, the MAC address may be used as part of this number. On the E50HX , this number is randomly generated per device, and you can see this number (or change it) on the BACnet config screens on the LCD .
Returns:
writeConfig
-
config
Write one of several 'magic' numbers to the configuration object (AV1). This is used to clear certain counters, reset the accumulated Energy consumption values, etc. This method will throw on error.
Parameters:
-
configCFG_VALUES_TOne of the CFG_VALUES_T values
writeSystemType
-
systype
Set the System Type of the device. This defines the voltage lines you have connected. This method will throw on error.
Parameters:
-
systypeSYSTEM_TYPES_TOne of the SYSTEM_TYPES_T values.
writeCTRatioPrimary
-
ctRatio
Set the Primary CT ratio. See the datasheet for details. This method will throw on error.
Parameters:
-
ctRatioNumberA floating point value between 5-32000
writeCTRatioSecondary
-
ctRatio
Set the Secondary CT ratio. See the datasheet for details. This method will throw on error.
Parameters:
-
ctRatioCT_SECONDARY_TOne of the CT_SECONDARY_T values.
writePTRatio
-
ptRatio
Set the PT ratio. See the datasheet for details. This method will throw on error.
Parameters:
-
ptRatioNumberA floating point value between 0.01-320.0
writeSystemVoltage
-
sysVolts
Set the System Voltage parmeter. See the datasheet for details. This method will throw on error.
Parameters:
-
sysVoltsNumberA floating point value between 82.0-32000.0
writeDisplayUnits
-
dispUnits
Set the LCD Display Units in IEC or IEEE format. This method will throw on error.
Parameters:
-
dispUnitsDISP_UNITS_TOne of the DISP_UNITS_T values.
writePhaseLossVT
-
phaseLoss
Set the Phase Loss Voltage Threshold. See the datasheet for details. This method will throw on error.
Parameters:
-
phaseLossNumberA floating point value between 1.0-99.0
writePhaseLossIT
-
phaseLoss
Set the Phase Loss Imbalance Threshold. See the datasheet for details. This method will throw on error.
Parameters:
-
phaseLossNumberA floating point value between 1.0-99.0
getAlarmBits
()
Number
Query the AI52 Object and return a bitmask of current Alarms. Compare against ALARM_BITS_T to determine what conditions are signaling an alarm. Alarm conditions will clear on their own as soon as the cause is rectified. This method will throw on error.
Returns:
A bitmask of values from ALARM_BITS_T indicating current alarm conditions.