Hub Programming Overview
To program a Hub, go to emx.packetpower.com and access the Open Power Interface (OPI) menu under the Manage tab.
Reference the following to complete common HUB functions. Click on a specific function 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: