Danfoss ECL 2000 Operating instructions

Technical Manual

ECL 2000

Serial Interface

07-00 VI.74.M3.02

Technical Manual

ECL 2000 Serial Interface

Danfoss A/S

VI.74.M3.02

ECL 2000 Serial Interface

VI.74.M3.02

ii

Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed materials.

Danfoss reserves the right to alter its products without notice. This also applies to products already on order pro-

vided that such alterations can be made without subsequent changes being necessary in specifications already

agreed. All trademarks in this material are property of the respective companies. Danfoss and the Danfoss logo-

type are trademarks of Danfoss A/S.

This manual replaces the Technical Manual ECL 2000 Serial Interface of March 2000.

Danfoss A/S ID: VI.74.M3.02

DK-6430 Nordborg Date: July 2000

Denmark

Phone: +45 74 88 22 22

Contents

VI.74.M3.02

iii

TABLE OF CONTENTS

1. INTRODUCTION..............................................................1

1.1 Scope.....................................................................................1

1.2 About This Manual................................................................1

1.3 Typographical Conventions ..................................................2

2. SERIAL INTERFACE PROTOCOL...............................3

2.1 Serial Interface Configuration...............................................3

2.2 Interactive Protocol ...............................................................3

2.2.1 Character Level ........................................................4

2.2.2 Command Level .......................................................4

3. COMMAND REFERENCE..............................................7

3.1 Command Format..................................................................7

3.2 Read/Write Property Commands...........................................8

3.2.1 BACnet Objects and Properties................................8

3.2.2 Commands................................................................9

3.3 Read File (Log) ...................................................................11

3.4 Sensor Setup........................................................................14

3.5 Keyboard Emulation ...........................................................15

3.6 System Commands..............................................................16

3.6.1 Select Application ..................................................16

3.6.2 Display and LED....................................................16

3.6.3 Reset.......................................................................17

3.7 Miscellaneous Commands...................................................18

3.7.1 Read Softwiring......................................................18

3.7.2 Read Compile Time................................................19

3.7.3 Other.......................................................................19

3.8 Production Test Commands................................................20

3.8.1 Start/End Test.........................................................20

3.8.2 Keyboard Test ........................................................21

3.8.3 LED Test ................................................................22

3.8.4 Display Test............................................................22

4. REMOTE MONITORING AND CONTROL...............25

4.1 Reading Sensor Inputs.........................................................25

4.1.1 Sensor S1 – S7........................................................25

4.1.2 Sensor S8 – S11......................................................26

Reading Sensor Input Values .................................26

Checking Sensor Reliability...................................29

4.1.3 LON Sensors ..........................................................30

Sensor L1 – L4.......................................................30

Sensor AI1 – AI10..................................................32

Sensor DI1 – DI10..................................................33

4.2 Operating Mode...................................................................34

4.3 Temperature Setpoints.........................................................37

4.4 Reading Status Information.................................................38

Contents

VI.74.M3.02

iv

4.4.1 Outdoor Temperature .............................................38

4.4.2 Degree Days...........................................................39

4.4.3 Flow Temperature ..................................................39

Heat Circuit ............................................................39

Hot-Water Circuit...................................................39

4.5 Log ......................................................................................40

4.6 7-Day Plan...........................................................................41

4.6.1 Reading and Setting the 7-Day Plan.......................41

4.6.2 Overriding the 7-Day Plan......................................42

4.7 Holiday Plan........................................................................44

4.7.1 Calendar..................................................................44

4.7.2 Heating During Holiday.........................................45

4.8 Heating Curves....................................................................47

4.8.1 Flow Temperature Curve........................................47

4.8.2 Return Temperature Curve.....................................49

Reading...................................................................50

Setting.....................................................................50

4.9 Application Setup................................................................51

4.10 Sensor Setup........................................................................52

4.10.1 Reading Sensor Setup.............................................52

4.10.2 Modifying Sensor Setup.........................................54

Setting Up a Pt 1000 or ESMF Sensor...................57

Setting Up a 0 – 10 V Sensor .................................57

Setting Up a Pulse Sensor.......................................57

Setting Up a Digital Sensor....................................58

Setting Up a LON Sensor.......................................58

4.11 Relay Output Setup .............................................................59

4.12 Manual Operation................................................................60

4.12.1 Pump Control .........................................................60

4.12.2 Valve Motor Control – Type 1...............................61

4.12.3 Valve Motor Control – Type 2...............................62

4.13 Service Menu – Heat Circuit...............................................63

4.13.1 About this Section..................................................63

4.13.2 Building..................................................................63

Summer Cut-Off.....................................................63

Pre-heat Period .......................................................64

Cooling Period........................................................64

Pre-heat Method.....................................................64

Night Setback Disable............................................64

4.13.3 Pump/valve.............................................................65

Pump.......................................................................65

Motor Valve............................................................65

Flow Cut-off...........................................................65

4.13.4 PI Constants............................................................66

Flow Temperature Control.....................................66

Return Temperature Limiter...................................66

Room Influence......................................................66

4.13.5 Limiter....................................................................67

Return Temperature................................................67

Flow........................................................................67

Contents

VI.74.M3.02

v

Energy.....................................................................67

Wind Speed ............................................................67

Sun Intensity...........................................................68

Universal ................................................................68

4.14 Service Menu – Hot-Water Circuit .....................................68

4.14.1 Hot Water ...............................................................68

Anti-bacteria Function............................................68

Charging Temperature............................................69

4.14.2 Pump/valve.............................................................69

Pump.......................................................................69

During Charging.....................................................70

Motor Valve............................................................70

Flow Cut-off...........................................................71

4.14.3 PI Constants............................................................71

Flow Temperature Control.....................................71

Return Temperature Limiter...................................71

4.14.4 Limiter....................................................................72

Return Temperature................................................72

Flow........................................................................72

Energy.....................................................................72

Universal ................................................................73

4.15 Service Menu – Common Functions...................................74

4.15.1 Set Clock ................................................................74

Time and Date........................................................74

Daylight Saving Time.............................................74

4.15.2 Log Today, Log Yesterday.....................................74

4.15.3 Override..................................................................74

Hot-water Priority...................................................74

Total Stop...............................................................75

Safety Thermostat...................................................75

Mixing....................................................................75

4.15.4 Communication ......................................................75

4.15.5 Sensors....................................................................76

4.15.6 Degree Days ...........................................................77

4.15.7 Access Code ...........................................................77

4.15.8 Energy Consumption..............................................78

4.15.9 Language ................................................................79

4.15.10 Version ...................................................................79

4.15.11 LON Module Check...............................................79

5. ALARMS...........................................................................81

5.1 Alarms in General ...............................................................81

5.2 Enabling and Disabling Alarms ..........................................81

5.3 Alarm Status and Setup.......................................................83

5.3.1 Analog Sensors.......................................................83

Alarm Status – Analog Sensors..............................83

Alarm Setup – Analog Sensors...............................85

5.3.2 ESMF Sensors........................................................91

5.3.3 Digital Sensors .......................................................91

Alarm Status – Digital Sensors...............................91

Contents

VI.74.M3.02

vi

Alarm Setup – Digital Sensors...............................92

5.3.4 Pulse Sensors..........................................................94

Alarm Status – Pulse Sensors.................................94

Alarm Setup – Pulse Sensors..................................95

5.4 Alarm Routing.....................................................................98

5.4.1 Alarm Recipient Addresses....................................98

Explicit Configuration............................................98

Automatic Configuration........................................99

Routing Alarm Messages .......................................99

5.5 Alarm Notification ............................................................100

6. MODEM SUPPORT AND SERIAL PROTOCOL.....101

6.1 Modem Communication....................................................101

6.1.1 Physical Connection.............................................101

6.1.2 Detecting the Modem...........................................102

6.1.3 Initiating a Session ...............................................102

6.1.4 Ending a Session ..................................................103

6.1.5 Modem Support....................................................103

6.2 Serial Communication Protocol ........................................104

6.2.1 Interactive Protocol ..............................................104

6.2.2 CRC Encoded Protocol.........................................104

6.2.3 Error Messages.....................................................105

6.2.4 CRC Calculation...................................................106

APPENDIX A. OVERVIEW OF BACNET OBJECTS ....107

APPENDIX B. CABLES.......................................................109

B.1 ECL 2000 to PC 9-pin.......................................................109

B.2 ECL 2000 to PC 25-pin.....................................................109

B.3 ECL 2000 to Modem 25-pin .............................................110

APPENDIX C. DISPLAY DUMP FORMATS...................111

C.1 General Information..........................................................111

C2. ZP Format..........................................................................111

C.3 ZP1 Format........................................................................113

C.3 ZP2 Format........................................................................115

LITERATURE.......................................................................117

INDEX....................................................................................119

.

Introduction

VI.74.M3.02

1

1. INTRODUCTION

1.1 Scope

This Technical Manual describes the EIA 232 interface of the ECL 2000 district

heating controller. The manual documents the protocol used to communicate with

the ECL 2000 via the serial interface. The manual is valid from CPU software ver-

sion 2.02.XX.

The manual is intended for research and development staff and for staff developing

software to test the ECL 2000.

Additional information about the ECL 2000 is available in the ECL 2000 manuals

listed on page 117. You may also find that the ECL 2000 Service Software (Dan-

foss order no. 087B8063) is very useful for getting acquainted with the serial inter-

face protocol.

1.2 About This Manual

Chapter 2 describes the setup of the EIA 232 interface, and provides some overall

comments to the serial interface protocol.

Chapter 3 is the reference to the individual commands in the protocol and their us-

age.

Chapter 4 provides detailed guidelines for communicating with the ECL 2000, for

example from a main station.

Chapter 5 describes the ECL 2000’s facilities for generating alarms based on sen-

sor input.

Chapter 6 describes the ECL 2000’s facilities for modem support and gives some

details about the serial protocol used for modem communication.

Appendix A provides an overview of the BACnet object types implemented in the

ECL 2000 (see page 8 for a short introduction to BACnet objects).

Appendix B describes cable configurations that can be used for serial communica-

tion with the ECL 2000.

Appendix C documents the formats that the ECL 2000 can use to dump the current

display picture.

At the end of the manual, you find a list of relevant literature and an index.

Introduction

VI.74.M3.02

2

1.3 Typographical Conventions

The following conventions are used:

Bold Terms that are found in display pictures appear in bold when mentioned in the text.

Italic Introduces new terms.

Courier Indicates data travelling to/from the ECL 2000 via the serial interface.

Note:

Indicates a note to which you should pay attention.

The following notation is used in the description of interface command syntax:

[ ] Optional element of interface command.

< > Element of interface command that will be explained in more detail in the follow-

ing.

Serial Interface Protocol

VI.74.M3.02

3

2. SERIAL INTERFACE PROTOCOL

2.1 Serial Interface Configuration

To connect an external device configured as DTE (typically a PC) to the ECL

2000, you can use the Danfoss service cable (order no. 087B8062). To connect a

modem (DCE) to the ECL 2000, you can use the Danfoss cable with order no.

087B8191. See also Appendix B.

The pin assignment of the serial interface is described on page 101.

A variety of software tools can be used for communicating with the ECL 2000, for

example:

• The Danfoss ECL 2000 Service Program

• A terminal emulator program

• A custom-made program.

Regardless of which tool you are using, ensure that the serial interface of the

equipment is set up as follows:

• 19.200 baud

• 8 data bits

• 1 stop bit

• No parity checking.

For a direct serial connection, the ECL 2000 uses no handshaking, neither hard-

ware nor software handshaking. See page 102 for information on handshaking on a

modem connection.

2.2 Interactive Protocol

The interactive protocol is used to communicate with the ECL 2000 via the fol-

lowing connections:

• Direct serial line.

• Modem. When connected via modem, the ECL 2000 also supports a CRC en-

coded protocol, which is documented on page 104.

• LON. Using the serial interface protocol via LON is accomplished by using the

LON facility known as direct messaging. See the Technical Manual for the

ECL 2000 LON Option (ref. [5]) for details.

Serial Interface Protocol

VI.74.M3.02

4

2.2.1 Character Level

At the character level, the main characteristics of the protocol are:

• Characters are expected to arrive in sequence.

• On a direct serial line, all characters are echoed. When LON communication is

used, or when the CRC encoded protocol is used for modem communication,

the ECL 2000 does not echo characters.

• <BS> (08 hexadecimal) deletes the last received character.

• <LF> (0A hexadecimal) ends a line, that is, the ECL 2000 starts interpreting

and executing the command.

• <CR> (0D hexadecimal) is ignored. When communicating over a serial line,

<CR> is converted to <LF>.

• The capacity of the input buffer is 127 characters.

2.2.2 Command Level

Welcome message When the ECL 2000 is powered on (or re-booted), it issues a message similar to the

following over the interface:

ECL2000 Serial Command Handler

Time=09:50:00 Date=04-07-2000

Enter ? for list of commands

>

Prompts The ECL 2000 issues 2 different prompts over the interface:

> indicates that the ECL 2000 is waiting for the next command

: indicates that the ECL 2000 is waiting for data input, e.g. a new value for a prop-

erty that is about to be written.

Normal communication Normally, when communicating with the ECL 2000, the external device (PC) con-

nected to the ECL 2000 initiates communication by sending a command to the

ECL 2000, which then responds by sending the requested data or feedback that an

operation has been performed.

Unsolicited messages However, the ECL 2000 can send unsolicited messages, alarm notifications, when

configured to do so. This facility is described in Chapter 5 starting on page 81.

Command interrupt When the ECL 2000 receives the character # (23 hexadecimal) followed by a

<LF> in response to the : prompt, it interrupts the interpretation/execution of the

current command and issues the > prompt.

Command concatenation Several commands can be sent in sequence to the ECL 2000 by separating com-

mands with ;. A sequence of commands must, however, end with the <LF> char-

acter in order to make the ECL 2000 start interpreting the commands.

Serial Interface Protocol

VI.74.M3.02

5

Empty command When the ECL 2000 receives a command consisting only of the <LF> character, it

responds with the > prompt. If the ECL 2000 is prompting for data (e.g. for writing

a property – see page 10), it issues an error message prior to sending the > prompt.

In Chapter 3, the individual commands of the protocol are described in detail.

Serial Interface Protocol

VI.74.M3.02

6

Command Reference

VI.74.M3.02

7

3. COMMAND REFERENCE

3.1 Command Format

All serial interface commands supported by the ECL 2000 start by a letter, which is

followed by 0, 1 or more parameters.

Most numerical command parameters are decimal numbers. However, hexadecimal

number format is used in the following places:

• When specifying object id and instance number (with the S command, see

page 9)

• When specifying which of the front panel LED’s are to be set during a LED

test (see page 22).

Note:

Furthermore, commands exist that dump the contents of the ECL 2000’s RAM and

EEPROM. These commands also result in hexadecimal output. These commands

are strictly for internal use by Danfoss R&D staff and are not documented in this

manual.

According to their function, the commands can be divided into the following

groups:

• Property read/write commands

• Log commands

• List commands

• Commands that simulate front panel keys

• System commands

• Production test commands

• Miscellaneous commands.

Command example For an example of the dialog with the ECL 2000, see the following command se-

quence used to set the internal clock of the ECL 2000 (

boldface indicates char-

acters sent to the ECL 2000 by an external unit or by a user):

> s 8 0

ObjId set

> w 57

Hour : 13

Minute : 11

Second : 00

Data written !

The following sections describe the individual commands.

Command Reference

VI.74.M3.02

8

3.2 Read/Write Property Commands

3.2.1 BACnet Objects and Properties

Objects and Properties BACnet, the Building Automation and Control Network Protocol defined by

ASHRAE

1

, specifies a set of standard object types (see Ref. [4]).

The internal data structure of the ECL 2000 is built around standard BACnet ob-

jects, with the addition of a number of proprietary Danfoss objects.

An object contains a number of properties. Properties hold variable values, such as

settings or measured values. All properties can be read but not all can be written.

BACnet objects are addressed via a unique object id, consisting of an object type

and an instance number. Properties are identified by a property identifier (a num-

ber).

Function Blocks Function blocks are software modules within the ECL 2000. Function blocks are

softwired (connected) in order to build applications for automatic control of, for

example, a heat circuit.

All function blocks in the ECL 2000 correspond to a BACnet object, for example

‘Analog Input 1’ or ‘Digital (binary) Output 2’.

Thus, reading and writing variables in function blocks (for example, present value)

are accomplished by reading/writing BACnet object properties.

In addition to the BACnet objects that describe function blocks, the ECL 2000 has

a number of BACnet objects that are used for other purposes. One example is the

device object, which stores system information about the controller.

The major part of the actions necessary to perform remote monitoring and control

of the ECL 2000 is performed by reading and writing BACnet object properties.

Command sequence Before reading or writing a BACnet property, you must select the appropriate ob-

ject. This is done using the S command (see the table below). After having selected

the object, you can read (R command) and/or write (W command) several properties

within the selected object, without having to issue more S commands. In the lists of

commands in this manual, S commands are often repeated for the sake of clarity.

However, keep in mind that it is possible to optimize the communication with the

ECL 2000 by issuing only strictly necessary S commands.

1

The American Society of Heating, Refrigerating, and Air-Conditioning Engineers, Inc.

Command Reference

VI.74.M3.02

9

3.2.2 Commands

Command syntax Example Description

S <obj_id> <inst_no> [<factory>]

> s 8 0

ObjId set

Select BACnet object no. 8 instance

0, i.e. the device object

Note: <obj_id> and <inst_no>

must be specified in hexadecimal

format

The <factory> parameter is optional:

0: object in RAM selected (de-

fault). This is the actual value

of the object

≠ 0: object in PROM selected. This

is the factory setting for the

object

D

> d

Current ObjId : 8 0

Display selected object

> r 112

Device status : 0

Read property no. 112 in selected

object (System_Status in the device

object)

> r 677 0

Sensor Setup:

Sensor no: 8 Sensor type: 3

Measuring Type: 5 Circuit: 1

Read property no. 677, index 0 in

selected object (Sensor_Setup of sen-

sor S8, in the device object)

Note that the parameter <index> is

optional and only applies to properties

that are arrays

R <prop_no> [<index>]

> r 514

boolean : 1

Read property no. 514 in selected

object (Automatic change to daylight

saving time, in the device object)

Command Reference

VI.74.M3.02

10

Command syntax Example Description

W <prop_no> [<index>]

> w 514

Boolean (0/1) : 0

Data written !

Write to property no. 514 in device

object (set automatic switch to day-

light saving time OFF)

The A command is used to add an

element to a list. The A command is

used to add dates to the holiday pe-

riod (see page 44)

> s 6 700

ObjId set

Select the Calendar object of heat

circuit 1

A <prop_no>

> a 23

Year (1996 .. 2050) : 1999

Month : 12

Day : 25

Element added !

Add the date 25. December 1999 to

the list of holiday dates

The B command is used to remove an

element from a list. The B command

is used to remove a date from the

holiday period (see page 44)

> s 6 700

ObjId set

Select the Calendar object of heat

circuit 1

B <prop_no>

> b 23

Year (1996 .. 2050) : 1999

Month : 12

Day : 25

Element removed !

Remove the date 25. December 1999

from the list of holiday dates

Command Reference

VI.74.M3.02

11

3.3 Read File (Log)

The file read command is used to read ECL 2000’s internal log of data read from

the sensor inputs:

• S1 – S11 (type 1: S1 – S9)

• L1 – L4 (when LON option is installed)

• AI1 – AI10 (analog input sensors connected via LON)

• DI1 – DI10 (digital input sensors connected via LON).

Command syntax Example

F <sensor_no> [<1st_log_pt>

[<no_of_log_pts>]]

Example 1: Read full log

> F 0

NoOfValues: 150 07-05-2000

00:00 19.00 19.00 18.81 18.81

01:00 19.00 19.00 18.81 18.81

02:00 18.81 59.03 51.37 22.87

03:00 21.78 21.22 20.47 20.28

04:00 20.09 19.94 19.72 19.34

05:00 19.34 19.19 19.19 19.19

06:00 19.19 19.19 19.19 67.84

07:00 65.03 23.06 21.78 21.03

08:00 20.47 20.47 20.09 19.94

09:00 19.72 19.53 19.53 19.34

10:00 19.34 19.19 19.19 19.19

11:00 19.19 19.19 19.19 19.19

12:00 19.19 19.19 19.00 60.91

13:00 25.47 23.25 22.31 21.41

14:00 21.03 20.66 20.28 61.66

15:00 64.28 64.09 24.34 23.06

16:00 64.84 57.72 25.66 23.81

17:00 22.50 21.97 21.22 20.84

18:00 20.47 20.09 19.94 19.72

19:00 19.34 19.34 19.19 19.00

20:00 19.19 19.00 18.81 18.81

21:00 18.81 18.81 19.00 19.00

22:00 19.19 59.41 67.09 24.94

23:00 23.25 22.16 21.41 20.84

00:00 20.47 20.09 19.94 19.72

01:00 19.72 19.53 19.19 19.19

02:00 19.19 19.19 19.19 19.00

03:00 19.00 19.00 19.00 19.19

04:00 19.00 19.00 19.00 18.81

05:00 19.00 18.81 18.81 19.00

06:00 19.00 19.00 19.00 63.72

07:00 24.94 23.06 22.16 21.22

08:00 20.84 20.47 20.09 19.94

09:00 66.16 58.66 24.94 22.87

10:00 21.97 21.22 20.84 20.47

11:00 20.09 19.72 19.72 19.53

12:00 19.34 63.34 58.47 24.56

13:00 23.06 22.16

time stamp

Command Reference

VI.74.M3.02

12

Example (cont.)

Example 2: Read today’s log

> F 0 96

NoOfValues: 54 08-05-2000

00:00 20.47 20.09 19.94 19.72

01:00 19.72 19.53 19.19 19.19

02:00 19.19 19.19 19.19 19.00

03:00 19.00 19.00 19.00 19.19

04:00 19.00 19.00 19.00 18.81

05:00 19.00 18.81 18.81 19.00

06:00 19.00 19.00 19.00 63.72

07:00 24.94 23.06 22.16 21.22

08:00 20.84 20.47 20.09 19.94

09:00 66.16 58.66 24.94 22.87

10:00 21.97 21.22 20.84 20.47

11:00 20.09 19.72 19.72 19.53

12:00 19.34 63.34 58.47 24.56

13:00 23.06 22.16

Example 3: Read 10 first log points from today’s log

> F 0 96 10

NoOfValues: 10 08-05-2000

00:00 20.47 20.09 19.94 19.72

01:00 19.72 19.53 19.19 19.19

02:00 19.19 19.19

Command parameters The command parameters have the following significance:

Parameter Description

<sensor_no>

The number of the data log to be read:

0 – 10

11

12

13

14

15

16 – 25

26 – 35

Sensor S1 – S11 (S10 and S11 only ECL 2000 type 2)

Outdoor temperature measured by LON sensor

Wind speed measured by LON sensor

Flow measured by LON sensor

Energy (power) measured by LON sensor

Accumulated energy measured by LON sensor

Analog input sensors 1 – 10 connected via LON

Digital input sensors 1 – 10 connected via LON

<1st_log_pt>

The number of the first log point to be read (0 – 191):

0

96

191

Log point midnight yesterday (1

st

point in log, default)

Log point midnight today

Maximum log point number

<no_of_log_pts>

The number of log points to be read (1 –192). If not specified, or if

greater than the number of log points available, all points up to and

including the last point in the log are read

Page is loading ...

Danfoss ECL 2000 Operating instructions

Related papers

Other documents