BERG UBN310 User manual

STANDARD Protocol Manual
English
Rev. 010 - 01/06/2006
1UBMSTD31010
Universal Berg Netzbaustein
UBN310
DIN 96x96 & ANSI 4” Power Meter
UBN315
DIN 96x96 & ANSI 4” LCD Power Meter
UBN3080
DIN 144x144 LCD Power Meter
www.berg-energie.de

A
ENGLISH
TABLE OF CONTENTS
STANDARD Communication Protocol
TABLE OF CONTENTS
1. INTRODUCTION 1
2. GRAPHIC SYMBOLS 2
3. DESCRIPTION 3
3.1 Communication 3
3.2 Identification Code 3
3.3 Data Request Sequence 4
3.3.1 Response Sequence 5
3.4 Parameter Setting Sequence 6
3.4.1 Response Sequence 7
3.5 Check Characters 7
4. COMMANDS 8
4.1 Measured Values 8
4.2 Programmed Parameters & Other Info 12
4.3 Programmable Parameters 19
4.4 Variables List 25
4.5 Error Messages 26
5. ASCII CHARACTERS TABLE 27

1
ENGLISH
INTRODUCTION
STANDARD Communication Protocol
1. INTRODUCTION
This manual provides information on the STANDARD communication protocol. The publication is
not intended for general use, but for qualified technicians.
This term indicates a professional and skilled technician, authorised to act in accordance with the
safety standards relating to the dangers posed by electric current.
This person must also have basic first-aid training and be in possession of suitable Personal
Protective Equipment.
WARNING!
It is strictly forbidden, for anyone who does not have the above-mentioned
features, to install or use the device.
The device is made in compliance with the European Union directives in force, as well as in com-
pliance with the technical standards implementing these requirements, as certified by the CE mark
on the device and in this manual.
It is strictly forbidden to use the instrument for purposes other than those intended, which can be
deduced from the manual content.
The Manufacturer reserves the right to make changes on the device or in the device specifications
identified in this manual without notice.
The Manufacturer declines all liability for any use of the instrument which is different from that
described in this manual and in the instrument manual, or for the lack/incorrect application of the
reported instructions.
The information, contained in this manual, may not be divulged to third parties. Any copy of this
manual, either partial or total, by photocopying, or by other means, also electronically, without
written authorization from the Manufacturer, violates the copyright and is punishable by law.
The information contained in this document is believed to be accurate at the time of publication,
however, the Manufacturer assumes no responsability for any errors which may appear here and
reserves the right to make changes without notice.
Any brands mentioned in the publication are property of their respective owners.

2
ENGLISH
GRAPHIC SYMBOLS
STANDARD Communication Protocol
2. GRAPHIC SYMBOLS
In the manual and on the device, some instructions are highlighted by symbols to draw the reader’s
attention to the operational dangers.
These symbols are the following:
DANGER!
This warning indicates the possible presence of voltage exceeding 1kV
on the marked terminals (even for short periods).
WARNING!
This warning indicates the possible occurrence of an event which may
cause a serious accident or considerable damage to the device if suitable
precautionary countermeasures are not taken.
ATTENTION!
This warning indicates the possible occurrence of an event which may
cause a light accident or damage to the device if suitable precautionary
countermeasures are not taken.
NOTE
This warning indicates important information which must be read care-
fully.

3DESCRIPTION
ENGLISH
STANDARD Communication Protocol
3. DESCRIPTION
3.1 Communication
The protocol specifications define the data sequence, the programming sequence and the check
codes, necessary for a proper data communication.
This protocol allows the communication between the PC (master) and the instrument (slave).
The protocol uses an half duplex connection on a single line. In this way, the communication
messages move on a single line in two opposite directions.
It is not possible a communication between instruments, without PC, as they cannot send comman-
ds; instruments are limited to reply. All the trasmitted characters are part of the ASCII code (see
chapter 5).
3.2 Identification Code
In a multi-point type connection, a code allows to identify each instrument during the communi-
cation. This code, the Serial Number, is assigned to each instrument by the manufacturer.
It is made of 9 characters (numbers and letters), printed on the instrument label.
A second identification code, the Logical Number, can be assigned by the user. As it is made up
of 2 ASCII characters ($01...$FF), it allows a faster communication.
The Logical Number can be changed at any time using the specific command (see section 4.3).
The instrument is supplied with a $01 Logical Number.
NOTE
The $00 Logical Number is used for broadcast commands. A command with
the $00 Logical number is received by all the instruments connected in the
network.

4DESCRIPTION
ENGLISH
STANDARD Communication Protocol
WARNING!
In an instruments network, the $00 code can be used only for sending write
commands. An interrogation would generate a simultaneous response from
all of the instruments, with the possibility of malfunctions.
3.3 Data Request Sequence
By the master, a data request sequence is sent to the instrument (slave) to read information on
the device (measured values, programmed parameters,...). This interrogation cannot change
instrument configuration. The following description shows the correct sequence of characters for
a proper interrogation:
<STX>02R63<ETX>($51)
[begin block character]
[instrument identification]
[command]
[end block character]
[check character]
[begin block character]
It is always <STX> ($02) character.
[instrument identification]
It is usually represented by the Logical Number ($01...$FF). The character S ($53) can also be
used followed by the instrument Serial Number (9 alphanumeric characters).
[command]
It is always R ($52) character followed by the variable number to be read (see section 4.1), ex-
pressed in hexadecimal.
[end block character]
It is always <ETX> ($03) character.
[check character]
It is a single character which results from EXCLUSIVE OR (XOR) of all the characters from <STX>
up to and including <ETX>. It is used to check the transmitted data.

5DESCRIPTION
ENGLISH
STANDARD Communication Protocol
3.3.1 Response Sequence
When the instrument, with the corresponding Serial Number or Logical Number, received a read
command, it replies with the following message.
<STX>+380.0<SP>.....<ETX><BCC>
[begin block character]
[data block]
[end block character]
[check character]
[begin block character]
It is always <STX> ($02) character.
[data block]
The data block format changes according to the sent command.
1. Data block of a variables group.
+380.0<SP>+13.38k...........+123.380k
Algebraic sign
Variable value with decimal point
Multiplier (see the following table)
Character Meaning Multiplier
<SP> space 1
k kilo 1000
M Mega 1000000
G Giga 1000000000
4. Error reply.
Ennn
Error code ($45)
Code relative to the error type
[end block character]
It is always <ETX> ($03) character.
[check character]
It is a single character which results from EXCLUSIVE OR (XOR) of all the characters from <STX>
up to and including <ETX>. It is used to check the transmitted data.

6DESCRIPTION
ENGLISH
STANDARD Communication Protocol
3.4 Parameter Setting Sequence
By the master, a programming sequence is sent to the instrument (slave) to change specific
parameters (instrument configuration). The following description shows the correct sequence of
characters for a proper command.
<STX>SA1T120050W84=0A<ETX>($67)
[begin block character]
[instrument identification]
[command]
[new value]
[end block character]
[check character]
[begin block character]
It is always <STX> ($02) character.
[instrument identification]
It is usually represented by the Logical Number ($01...$FF). The S ($53) character can also be
used followed by the instrument Serial Number (9 alphanumeric characters).
[command]
It is always W ($57) character followed by the variable number to be changed (see section 4.3)
expressed in hexadecimal by two alphanumeric characters and always followed by the character
=($3D).
[new value]
It is a series of alphanumeric characters which express the new value, according to the assigned
parameter (see section 2.3).
[end block character]
It is always <ETX> ($03) character.
[check character]
It is a single character resulting from EXCLUSIVE OR (XOR) of all the characters from <STX> up
to and including <ETX>. It is used to check the transmitted data.

7DESCRIPTION
ENGLISH
STANDARD Communication Protocol
3.4.1 Response Sequence
When the instrument, with the corresponding Serial Number or Logical Number, received a write
command, it replies with the following message.
<STX>E000<ETX>($74)
[begin block character]
[data block]
[end block character]
[check character]
[begin block character]
It is always <STX> ($02) character.
[data block]
It is made up of E ($45) character followed by 3 numerical characters which indicate the code
relative to the error. The E000 code specifies that the operation has been completed correctly.
[end block character]
It is always <ETX> ($03) character.
[check character]
It is a single character resulting from EXCLUSIVE OR (XOR) of all of the characters from <STX>
up to and including <ETX>, used to check the transmitted data.
3.5 Check Characters
The used check characters are the following:
<STX> Start of text ($02)
Start of text character. Preceeds the data in all frames.
<ETX> End of text ($03)
End block character.
<BCC> Block check character
It is represented by 2 digit number, obtained by the operation of EXCLUSIVE OR (XOR) carried
out on the transmitted data, as shown in the preceeding examples.

8COMMANDS
ENGLISH
STANDARD Communication Protocol
4. COMMANDS
NOTE
The * symbol indicates a parameter available only when the instrument includes
the relevant option.
NOTE
“ENH” is the abbreviation for functions or parameters included only in the
Enhanced Package version of the instrument.
4.1 Measured Values (codes valid for read only)
R3D INSTRUMENT (Firmware Release 1.xx) COMPATIBLE ANSWER FORMAT
In case of wiring mode: 3Ph-4W/3CT
Answer format:
<STX> VΣV1 V2 V3 V12 V23 V31 AΣA1 A2 A3 THDA1 THDA2 THDA3 AN PFΣPF1
PF2 PF3 NUL COSØ1* COSØ2* COSØ3* VAΣVA1 VA2 VA3 WΣW1 W2 W3 varΣvar1
var2 var3 IN1 IN2 IN3 IN4 +Wh +varhI +varhC +VAh -Wh -varhI -varhC -VAh F THDV1
THDV2 THDV3 NUL RST <ETX><BCC>
Value format:
Instantaneous values•
sign (space, +, -) + value on 4 digits with decimal point (5 characters) + multiplier
(space, m, k, M, G, T, …)
Energy counters•
sign (space, +, -) + value on 6 digits with decimal point (7 characters) + multiplier
(space, m, k, M, G, T, …)
Digital inputs•
sign (space, +, -) + value on 8 digits with decimal point (9 characters) + multiplier
(space, m, k, M, G, T, …)
Phase reversal•
sign (space, +, -) + value on 3 digits with decimal point (4 characters) + multiplier
(space, m, k, M, G, T, …)
In case of wiring mode: 3Ph-3W/2CT
Answer format:
<STX> VΣNUL NUL NUL V12 V23 V31 AΣA1 A2 A3 THDA1 NUL THDA3 NUL PFΣ
NUL NUL NUL NUL NUL NUL NUL VAΣNUL NUL NUL WΣNUL NUL NUL varΣNUL
NUL NUL IN1 IN2 IN3 IN4 +Wh +varhI +varhC +VAh -Wh -varhI -varhC -VAh F NUL
NUL NUL NUL RST <ETX><BCC>
In case of wiring mode: 1Phase
Answer format:
<STX> NUL V1 NUL NUL NUL NUL NUL NUL A1 NUL NUL THDA1 NUL NUL NUL
NUL PF1 NUL NUL NUL COSØ1* NUL NUL NUL VA1 NUL NUL NUL W1 NUL NUL
NUL var1 NUL NUL IN1 IN2 IN3 IN4 +Wh +varhI +varhC +VAh -Wh -varhI -varhC
-VAh F THDV1 NUL NUL NUL RST <ETX><BCC>
R3D.01 MEASURED INSTANTANEOUS VARIABLES
In case of wiring mode: 3Ph-4W/3CT
Answer format:
<STX> VΣV1 V2 V3 V12 V23 V31 AΣA1 A2 A3 THDA1 THDA2 THDA3 AN PFΣPF1
PF2 PF3 NUL COSØ1* COSØ2* COSØ3* VAΣVA1 VA2 VA3 WΣW1 W2 W3 varΣvar1
var2 var3 IN1 IN2 IN3 IN4 +Wh +varhI +varhC +VAh -Wh -varhI -varhC -VAh F THDV1
THDV2 THDV3 NUL RST <ETX><BCC>
Command Description
UBN310 UBN315
UBN3080

