Satechi pm130p User manual

Series PM130 PLUS Powermeters
PM130P/PM130E/PM130EH
Modbus Communications Protocol
Reference Guide
BG0427 Rev. A4
Provided by Northeast Power Systems, Inc.
www.nepsi.com

2
Every effort has been made to ensure that the material herein is complete and accurate.
However, the manufacturer is not responsible for any mistakes in printing or faulty
instructions contained in this book. Notification of any errors or misprints will be received
with appreciation.
For further information regarding a particular installation, operation or maintenance of
equipment, contact the manufacturer or your local representative or distributor.
REVISION HISTORY
A1 Nov 2007 Release
A2 Dec 2009 F/W versions 11.1.6 or higher.
Added DNP 16-bit and 32-bit frozen binary counter and analog input objects.
Added DNP Object 50 Time and Date to the Class 0 point list.
F/W versions 11.1.11 or higher.
Added TCP event notification client.
Added GPRS setup and communication counters.
Added time triggers.
Added DI change event log.
F/W versions 11.2.1 or higher.
Added 8 tariffs.
F/W versions 11.3.1 or higher.
Added event and data log setup and file transfer registers.
A3 Oct 2010 F/W versions 11.3.3 or higher.
Added kVAh import/export and 4-quadrant kvarh registers.
A4 Jan 2013 Added support for the 12DI/4RO module and IEC 60870 setup.
Modbus is a trademark of Schneider Electric.
Provided by Northeast Power Systems, Inc.
www.nepsi.com

3
Table of Contents
1GENERAL ..........................................................................................................8
2MODBUS PROTOCOL IMPLEMENTATION......................................................9
2.1 Transmission Modes......................................................................................... 9
2.2 Address Field ................................................................................................... 9
2.3 Function Field .................................................................................................. 9
2.4 Exception Responses........................................................................................ 9
2.5 Transaction Timing .......................................................................................... 9
2.6 Modbus Register Addresses ........................................................................... 10
2.7 Data Formats ................................................................................................. 10
2.7.1 16-bit Scaled Integer Format................................................................................10
2.7.2 32-bit Long Integer Format...................................................................................11
2.7.3 32-bit Floating Point Format..................................................................................12
2.7.4 32-bit Modulo-10000 Format................................................................................12
2.8 User Assignable Registers.............................................................................. 12
2.9 Password Protection ...................................................................................... 13
2.10 Data Recording and File Transfers ................................................................. 13
2.10.1 Log File Organization.....................................................................................13
Multi-section Files...............................................................................................13
Data Log File......................................................................................................14
Profile Data Log File ............................................................................................ 14
Real-time Waveforms..........................................................................................14
2.10.2 File Transfers................................................................................................14
Common File Transfer .........................................................................................14
Reading Multi-section Data Log Files......................................................................15
Reading Real-time Waveforms..............................................................................16
2.11 TCP Notification Client ................................................................................... 16
3MODBUS REGISTER MAP..............................................................................18
3.1 Modbus Setup Registers................................................................................. 18
Assignable Modbus Registers................................................................................18
Assignable Registers Map.....................................................................................18
Modbus Conversion Scales ...................................................................................18
Device Data Scales .............................................................................................18
32-bit Register Type............................................................................................18
3.2 16-bit Scaled Analog Registers and Energy Counters - Basic Register Set ..... 19
3.3 16-bit Scaled Analog Registers, Binary Registers and Counters ..................... 21
None.................................................................................................................21
Special Inputs ....................................................................................................21
Digital Inputs.....................................................................................................21
Relay Outputs ....................................................................................................21
Counters ...........................................................................................................21
1-Cycle Phase Values ..........................................................................................21
1-Cycle Total Values............................................................................................22
1-Cycle Auxiliary Values ......................................................................................22
Phasor ..............................................................................................................22
1-Second Phase Values........................................................................................23
1-Second Total Values.........................................................................................23
1-Second Auxiliary Values.................................................................................... 24
Present Volt, Ampere and Power Demands .............................................................24
Total Energies E..................................................................................................25
Phase Energies E.................................................................................................25
V1/V12 Harmonic Distortion EH.............................................................................. 25
V2/V23 Harmonic Distortion EH.............................................................................. 25
Provided by Northeast Power Systems, Inc.
www.nepsi.com

4
V3/V31 Harmonic Distortion EH.............................................................................. 26
I1 Harmonic Distortion EH .....................................................................................26
I2 Harmonic Distortion EH .....................................................................................26
I3 Harmonic Distortion EH .....................................................................................26
Fundamental Phase Values EH ............................................................................... 26
Fundamental Total Values EH.................................................................................26
Minimum 1-Cycle Phase Values.............................................................................27
Minimum 1-Cycle Total Values..............................................................................27
Minimum 1-Cycle Auxiliary Values.........................................................................27
Maximum 1-Cycle Phase Values............................................................................27
Maximum 1-Cycle Total Values .............................................................................27
Maximum 1-Cycle Auxiliary Values ........................................................................27
Maximum Demands ............................................................................................27
TOU Parameters E...............................................................................................28
Scaled Analog Outputs.........................................................................................28
TOU Energy Register #1 E....................................................................................28
TOU Energy Register #2 E....................................................................................28
TOU Energy Register #3 E....................................................................................28
TOU Energy Register #4 E....................................................................................28
Summary Energy Accumulated Demands E.............................................................29
Summary Energy Block Demands E........................................................................29
Summary Energy Sliding Window Demands E..........................................................29
Summary Energy Maximum Demands E..................................................................29
TOU Maximum Demand Register #1 E....................................................................29
TOU Maximum Demand Register #2 E....................................................................29
TOU Maximum Demand Register #3 E....................................................................29
TOU Maximum Demand Register #4 E....................................................................29
V1/V12 Harmonic Angles EH ..................................................................................30
V2/V23 Harmonic Angles EH ..................................................................................30
V1/V31 Harmonic Angles EH ..................................................................................30
I1 Harmonic Angles EH .........................................................................................30
I2 Harmonic Angles EH .........................................................................................30
I3 Harmonic Angles EH .........................................................................................30
Setpoint Status ..................................................................................................30
3.4 32-bit Analog Registers, Binary Registers and Counters ................................ 32
Special Inputs ....................................................................................................32
Digital Inputs.....................................................................................................32
Relay Outputs ....................................................................................................32
Counters ...........................................................................................................32
1-Cycle Phase Values ..........................................................................................32
1-Cycle Total Values............................................................................................33
1-Cycle Auxiliary Values ......................................................................................33
Phasor ..............................................................................................................33
1-Second Phase Values........................................................................................34
1-Second Total Values.........................................................................................34
1-Second Auxiliary Values.................................................................................... 35
Present Volt, Ampere and Power Demands .............................................................35
Total Energies E..................................................................................................36
Summary Energy Registers E................................................................................36
Phase Energies E.................................................................................................36
V1/V12 Harmonic Distortions EH ............................................................................ 36
V2/V23 Harmonic Distortions EH ............................................................................ 37
V3/V31 Harmonic Distortions EH ............................................................................ 37
I1 Harmonic Distortions EH ...................................................................................37
I2 Harmonic Distortions EH ...................................................................................37
I3 Harmonic Distortions EH ...................................................................................37
Fundamental (H01) Phase Values EH ......................................................................37
Harmonic Total Values EH .....................................................................................38
Minimum 1-Cycle Phase Values.............................................................................38
Minimum 1-Cycle Total Values..............................................................................38
Provided by Northeast Power Systems, Inc.
www.nepsi.com

5
Minimum 1-Cycle Auxiliary Values.........................................................................38
Maximum 1-Cycle Phase Values............................................................................38
Maximum 1-Cycle Total Values .............................................................................38
Maximum 1-Cycle Auxiliary Values ........................................................................38
Maximum Demands ............................................................................................38
TOU Parameters E...............................................................................................39
Scaled Analog Outputs.........................................................................................39
TOU Energy Register #1 E....................................................................................39
TOU Energy Register #2 E....................................................................................39
TOU Energy Register #3 E....................................................................................39
TOU Energy Register #4 E....................................................................................40
Summary Energy Accumulated Demands E.............................................................40
Summary Energy Block Demands E........................................................................40
Summary Energy Sliding Window Demands E..........................................................40
Summary Energy Maximum Demands E..................................................................40
TOU Maximum Demand Register #1 E....................................................................40
TOU Maximum Demand Register #2 E....................................................................40
TOU Maximum Demand Register #3 E....................................................................40
TOU Maximum Demand Register #4 E....................................................................41
V1/V12 Harmonic Angles EH ..................................................................................41
V2/V23 Harmonic Angles EH ..................................................................................41
V1/V31 Harmonic Angles EH ..................................................................................41
I1 Harmonic Angles EH .........................................................................................41
I2 Harmonic Angles EH .........................................................................................41
I3 Harmonic Angles EH .........................................................................................41
Setpoint Status ..................................................................................................41
Generic TOU Season Energy Registers ...................................................................41
Generic TOU Season Maximum Demand Registers ...................................................42
Generic Data......................................................................................................42
3.5 Minimum/Maximum Log Registers................................................................. 43
Minimum Phase Values........................................................................................43
Minimum Total Values .........................................................................................43
Minimum Auxiliary Values ....................................................................................43
Maximum Phase Values .......................................................................................43
Maximum Total Values.........................................................................................44
Maximum Auxiliary Values ...................................................................................44
Summary Energy Maximum Demands E..................................................................44
Maximum Demands ............................................................................................44
TOU Maximum Demand Register #1 E....................................................................45
TOU Maximum Demand Register #2 E....................................................................45
TOU Maximum Demand Register #3 E....................................................................46
TOU Maximum Demand Register #4 E....................................................................46
3.6 Device Control and Status Registers .............................................................. 47
Device Restart Register .......................................................................................47
Device Authorization Registers..............................................................................47
Remote Relay Control..........................................................................................47
Device Reset/Clear Registers................................................................................47
Device Identification............................................................................................47
Device Status Registers .......................................................................................48
Alarm Notification Registers .................................................................................48
DI Change Events...............................................................................................48
Memory Status Registers .....................................................................................48
Log Notification Registers (bit map).......................................................................48
Communication Status.........................................................................................48
Communication Counters.....................................................................................48
3.7 Device Setup Registers .................................................................................. 50
Device Identification............................................................................................50
Factory Device Settings .......................................................................................50
Basic Setup........................................................................................................50
Communication Ports Setup .................................................................................51
Provided by Northeast Power Systems, Inc.
www.nepsi.com

6
Device Options Setup ..........................................................................................52
Local Settings ....................................................................................................52
Clock Indication and Setup...................................................................................52
Alarm/Event Setpoints Setup................................................................................53
Pulse Counters Setup ..........................................................................................53
Analog Outputs Setup..........................................................................................53
Network Setup ...................................................................................................53
Password Setup..................................................................................................54
Expert Power Service Setup .................................................................................54
Internet Service Provider (ISP) accounts................................................................54
GPRS Setup .......................................................................................................54
TCP Notification Client Setup ................................................................................54
Transformer Correction Setup...............................................................................54
IEC 60870-5 Options Setup..................................................................................55
IEC 60870-5 Class 2 Data and Counters Setup........................................................55
IEC 60870-5 Assignable Point Map and Events Setup ...............................................56
DNP Options Setup .............................................................................................56
DNP Class 0 Point Assignments.............................................................................57
File Setup E........................................................................................................57
Data Log Setup E................................................................................................57
TOU Daily Profile Setup E.....................................................................................58
TOU Calendar Setup E..........................................................................................58
Summary Energy/TOU Registers Setup E................................................................59
Summary Energy/TOU Registers Source Setup E......................................................59
Digital Inputs Setup ............................................................................................59
Relay Outputs Setup ...........................................................................................59
Analog Outputs Setup..........................................................................................60
3.8 Analog and Digital I/O Configuration............................................................. 61
I/O Slots Configuration Info .................................................................................61
I/O Type Info.....................................................................................................61
3.9 File Transfer Registers E................................................................................. 62
File Transfer Control Blocks.................................................................................. 62
File Info Response Block (Variation 0 – File info) .....................................................63
File Info Response Block (Variation 1 – Current record info)......................................64
File Info Response Block (Variation 2 – Data log record structure)..............................64
Event Log Response Block....................................................................................64
Data Log Response Block.....................................................................................65
RT Waveform Response Block...............................................................................65
3.10 Billing/TOU Daily Profile Data Log E............................................................... 67
4DATA SCALES AND UNITS............................................................................69
Data Scales .......................................................................................................69
Data Units – Low Resolution Option.......................................................................69
Data Units – High Resolution Option......................................................................69
5DATA FORMATS .............................................................................................70
Timestamp ........................................................................................................70
File ID...............................................................................................................70
File Attributes ....................................................................................................70
File Status Word (bitmap)....................................................................................70
File Record Status Word (bitmap)..........................................................................70
TOU Profile Log Channel ID .................................................................................. 70
Waveform Log Channel ID....................................................................................70
Profile Log Sections Mask.....................................................................................70
Waveform Channel Mask......................................................................................70
TOU Tariff Change Time.......................................................................................70
Summary/TOU Energy Register Source ID..............................................................70
Setpoint Trigger Parameters ID.............................................................................71
Relays...............................................................................................................71
Provided by Northeast Power Systems, Inc.
www.nepsi.com

7
Setpoint Action ID .............................................................................................. 72
Counter Source ID ..............................................................................................73
Relay Output Pulse Source ID...............................................................................73
AO Parameters ID...............................................................................................73
Event Cause/Point ID ..........................................................................................73
Event Effect ID...................................................................................................74
Data Point ID .....................................................................................................74
Event Type ID .................................................................................................... 74
Device Diagnostics..............................................................................................74
DNP Object Variations .........................................................................................75
DNP Class 0 Objects............................................................................................ 75
Wiring Mode.......................................................................................................75
Instrument Options.............................................................................................76
I/O Slot Types....................................................................................................76
Provided by Northeast Power Systems, Inc.
www.nepsi.com

8
1 General
This document specifies a subset of the Modbus serial communications protocol used to
transfer data between a master computer station and the PM130. The document provides
the complete information necessary to develop third-party communications software
capable of communication with Series PM130 devices. For additional information concerning
operating the device, configuring the communication parameters, and communication
connections see the PM130 PLUS Installation and Operation Manual.
The document is applicable to PM130A, PM130P, PM130E and PM130EH meters.
IMPORTANT
In 3-wire connection schemes, the unbalanced current and phase readings for power factor,
active power, and reactive power will be zeros, because they have no meaning. Only the
total three-phase power values are provided.
Most of the advanced features are configured using multiple setup parameters that can be
accessed in a number of contiguous registers. When writing the setup registers, it is
recommended to write all the registers at once using a single request, or to clear (zero) the
setup before writing into separate registers.
Designations used in the guide:
E - available in the PM130E and PM130EH
EH- available in the PM130EH
Provided by Northeast Power Systems, Inc.
www.nepsi.com

9
2 Modbus Protocol Implementation
For detailed information about Modbus protocol, Modbus message framing and error
checking, refer to the "Modicon Modbus Protocol Reference Guide". It can be downloaded
from the www.modbus.org Website. The following paragraphs outline some issues
concerning the implementation of the Modbus protocol in the PM130.
2.1 Transmission Modes
The PM130 can be set up to communicate on a Modbus network using RTU transmission
mode. Refer to the "Series PM130 PLUS Powermeters, Installation and Operation Manual"
on how to select the transmission mode in your meter.
2.2 Address Field
The address field contains a user assigned address of the instrument (1-247) on a Modbus
network. Broadcast mode using address 0 is not supported.
2.3 Function Field
The Modbus functions implemented in the PM130 are shown in Table 2-1. Function 04 can
be used in the same context as function 03.
Table 2-2 Modbus Function Codes
Code (decimal) Meaning in Modbus Action
03 Read holding registers Read multiple registers
04 Read input registers Read multiple registers
06 Preset single register Write single register
16 Preset multiple registers Write multiple registers
081Loop-back test Communications test
1 The PM130 supports only diagnostic code 0 - return query data.
2.4 Exception Responses
The instrument sends an exception response when an error is detected in the received
message. To indicate that the response is notification of an error, the high order bit of the
function code is set to 1.
Implemented exception response codes:
01 - Illegal function
02 - Illegal data address
03 - Illegal data value
04 - Device failure
When the character framing, parity, or redundancy check detects a communication error,
processing of the master's request stops. The instrument will not act on or respond to the
message.
2.5 Transaction Timing
The PM130 response time to master requests is indicated in Table 2-2.
Table 2-2 Response Time
Response Time, msBaud Rate, bps Min Max Typical
9600 13 15 13
19200 11 12 11
57600 9 10 9
115200 9 10 9
Provided by Northeast Power Systems, Inc.
www.nepsi.com

10
2.6 Modbus Register Addresses
The PM130 Modbus registers are numbered in the range of 0 to 65535. From the Modbus
applications, the PM130 Modbus registers can be accessed by simulating holding registers of
the Modicon 584, 884 or 984 Programmable Controller, using a 5-digit “4XXXX” or 6-digit
“4XXXXX” addressing scheme.
To map the PM130 register address to the range of the Modbus holding registers, add a
value of 40001 to the PM130 register address. When a register address exceeds 9999, use
a 6-digit addressing scheme by adding 400001 to the PM130 register address.
2.7 Data Formats
The PM130 uses four data formats to pass data between a master application and the
instrument: 16-bit short integer, 32-bit long integer, 32-bit floating point and 32-bit
modulo-10000 formats. Binary values and counters are always transmitted in 32-bit
registers, while analog values can be read both in 32-bit and in 16-bit scaled registers.
32-bit analog and energy registers and counters can be read either in long integer or in
single precision floating point format. The register type can be selected in the meter
separately for analog registers, binary counters and energy registers via Modbus register
246 (see Section 3.1, Modbus Setup Registers). Refer to the "PM130 PLUS Powermeters,
Installation and Operation Manual, Device Options Setup" for information on how to setup
the type of 32-bit registers in your meter.
Analog registers 256 through 308 and 6656 through 10935 contain scaled 16-bit data.
2.7.1 16-bit Scaled Integer Format
16-bit scaled analog data is transmitted in a single 16-bit Modbus register being scaled to
the range of 0 to 9999. To get a true reading, a reverse conversion should be done using
the following formula:
LO
9999 )LOHI(X
Y+
−×
=
where:
Y - True reading in engineering units
X - Raw input data in the range of 0 to 9999
LO and HI - Data low and high scales in engineering units
The engineering scales are indicated for every scaled 16-bit register. Refer to Section 4
“Data Scales and Units” for applicable data scales and measurement units.
The default voltage scale in the device is 144V (120V+20%). It can be changed through
register 242 (see Section 3.1, Device Data Scales), or via the supplemental PAS software.
The recommended voltage scale is 120V+20% = 144V for using with external PT’s, and
690V+20% = 828V for a direct connection to power line.
CONVERSION EXAMPLES
1. Voltage readings
a) Assume device settings (direct wiring): PT ratio = 1; Voltage scale = 828V (690V + 20%).
Voltage engineering scales (see Section 4):
HI_ENG = Vmax = 828.0 ×PT ratio = 828.0 ×1 = 828.0V
LO_ENG = 0V
If the raw data reading is 1449 then the voltage reading in engineering units will be as follows:
Volts reading = 1449 ×(828.0 - 0)/(9999 - 0) + 0 = 120.0V
b) Assume device settings (wiring via PT): PT ratio = 14,400V : 120V = 120; Voltage scale = 144V.
Voltage engineering scales (see Section 4):
HI_ENG = Vmax = 144.0 ×PT ratio = 144 ×120 = 17,280V
Provided by Northeast Power Systems, Inc.
www.nepsi.com