Hub Programming Overview
Hubs require the OPI feature to be licensed to your emx account. Contact Packet Power if you do not already have this feature licensed to your account.
Once the OPI feature has been licensed for your EMX account go to emx.packetpower.com and access the Open Power Interface (OPI) menu under the Manage tab to program the Hub.
Reference the following list to complete common HUB functions. Click on a the corresponding page link under each title for more detailed instructions.
Creating a Template
OPI Menu Item: OPI Templates
Steps:
Click (+) to create a template
Required Fields:
Template name: Friendly template name
Template SYSOID: Use "234234" for most Modbus applications
Template protocol: Select Modbus or SNMP
Adding a Node Template
OPI Menu Item: OPI Templates
Steps:
Click on hyperlink of Template Nodes to expose Node / Reading templates
Complete all required fields
Click (+) to add node template
Required Fields:
Node Template Name: Friendly node template name
Node Type: Select template that closest resembles the device being monitored
Voltage Rating: Nominal voltage for scaling
Current Rating: Nominal current for scaling
Adding a Specific Device
OPI Menu Item: OPI Devices
Steps:
Click (+) Add Device
Complete all required fields including "Enabled"
Required Fields:
Device IP: IP address of the device being monitored
Device Name: Friendly name of the device being monitored
Device Description: Friendly description of the device being monitored
OPI Template: Template to be used
HUB Device: GUID of the HUB being polled
Enabled: Click to enable the HUB to start polling
Assigning Registers to Node Templates
Assign registers to node template
(for Modbus devices)
OPI Menu Item: OPI Templates
Steps:
Click on hyperlink in "Template Nodes" column
Click on hyperlink in "Readings" column
Complete all required fields
Click (+) to add register to node map
Required Fields:
Channel: Select the EMX channel that best resembles the matching register
Scale: Scaling factor to apply to the reading
Offset: Constant to add to scaled reading
Register value = (Reading x Scale) + Offset
Register: Device register number (may require adding the mfg's base address if that is not zero)
Byte Mapping: Register byte type (typically F-ABCD) -- accounts for endianness and byte swapping
Assigning OID Registers to Node Templates
Assign OID registers to node template (for SNMP devices)
OPI Menu Item: OPI Templates
Steps:
Click on hyperlink in "Template Nodes" column
Click on hyperlink in "Readings" column
Complete all required fields
Click (+) to add register to node map
Required Fields:
Channel: Select the EMX channel that best resembles the matching register
Scale: Scaling or multiple
Offset: Typically +1 or -1 or 0
OID: SNMP OID that corresponds to the MIB
Configuring Modbus Settings
OPI Menu Item: OPI Devices
Steps:
Click on "Modbus" hyperlink in Device Credentials column
Complete all required fields
Required Fields:
IP Port: Typically 502 for Modbus
Unit ID: Modbus device ID (0-255)
Protocol: Modbus
Configuring SNMP Settings
OPI Menu Item: OPI Devices
Steps:
Click on "SNMP" hyperlink in Device Credentials column
Complete all required fields
Required Fields:
SNMP Version: Select version 1, 2 or 3
Read Community: Typically "public" unless administrator has changed it
Password: SNMP device access password
Cloning a Device
OPI Menu Item: OPI Devices
Steps:
Highlight device row and click "Clone"
Complete all required fields
Required Fields:
New Device IP: IP address of the new device being monitored
Device Name: Friendly name of the new device being monitored
Viewing Device Readings
OPI Menu Item: OPI Readings
Steps:
Required Fields:
Viewing GUIDs Assigned to Devices
View GUID assigned to device
OPI Menu Item: OPI Nodes
Steps:
Required Fields: