CoolAutomation CoolMasterNet, CooLinkNet, CooLinkHub, CooLinkBridge Integration Manuallines

BACnet Integration Guidelines

CoolMasterNet CooLinkNet CooLinkHub CooLinkBridge

BACne t Integration Guidelines

Document Revision 0.2 Thur sday, June 14, 2018

www.coolautomation.com

BACnet Integration Guidelines

Table of Contents

Contents

2

1 Connection

1.1

BACnet MS/TP Connection

1.2

BACnet IP Connection

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 3

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 4

2 Configuration

2.1

BACnet MS/TP Configuration

2.2

BACnet IP Configuration

2.3

VA's Configuration

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 5

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 6

3 BACnet Tables

3.1

In door Unit Objects

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 8

4 Commands Reference

4.1

4.2

4.3

bacnet line va

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 9

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... ........... .... 10

3

5

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... . 6BACnet MS/TP MAC Address

... ...... ...... ........... ........... ........... ........... ........... ........... ........... ...... ........... ........... ........... ........... ........... . 6BACnet MS/TP Frame Format

8

9

BACnet Integration Guidelines Rev 0.2

CoolMasterNet BACnet MS/TP Connection

Connection

3

1

CoolAutomation devices support BACnet M S/ TP and/or BACnet I P pr ot ocols with accordance to the ANSI/ASHRAE Standard 135-2004.

1.1

In BACnet MS/TP mode physical connection t o the CoolAut omation devices is implement ed over “Two-W ire” electrical interface in accordance t o EIA/ TI A-485 st andard. Connection is made via 485-A and 485-B terminals. Ground w ire connection is not mandatory but highly r ecommended.

Connection

BACnet MS/TP Connection

In CoolMast er Net Line L3 is recommended for BACnet MS/TP connection, although Lines L4, L5, L6 and L7 can also be used for that purpose. Picture above shows connection to Line L3.

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

CooLinkNet/CooLinkHub/CooLinkBridge BACnet MS/TP Connection

In CooLin kNet/CooLin kHub/Co oLinkBridge device s only Line L3 can be used for BACnet MS/TP connection.

Connection

4

1.2

BACnet IP Connection

BACnet IP is supported in CoolMasterNet and CooLinkNet/CooLinkHub/CooLinkBridge devices. Devices are communicating on the Ethernet TCP/IP network using UDP protocol. Physical connection in this case is made via RJ45 Ethernet connector.

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

Configuration

5

2

Configuration

CoolAutomation device must be configured to support BACnet functionality. Configurat ion is made via CoolA utomation's proprietary ASCII_IF interface described in details in Programmer Reference Manual (PRM) docu m e nt for the correspon di ng device. One BACnet MS/TP and one BACnet I P connect ion can r un simultaneously on CoolAutomation device. Addit ional MS/TP connections are not supported although physical interf aces may be available.

2.1

BACnet MS/TP Configuration

BACnet MS/TP interface module of CoolAutomation device has to be activated by assigning appropriate communication Line. In CoolMasterNet it is highly recommended to use Line L3, although it is possible t o use any of the flowing lines: L4, L5, L6, L7 lines. Using line L3 in CooLinkNet/CooLinkHub/CooLinkBridge for BACnet MS/TP is man datory.

CoolMasterNet BACnet MS/TP activation:

>line type L3 BAC OK, Boot Required!

CooLinkNet/CooLinkHub/CooLinkBridge BACnet MS/TP activation:

>line type L3 BAC OK, Boot Required!

Use line command to check if BACnet MS/TP module is already activated and to display it 's parameters.

CoolMasterNet:

>line L1 : DK Mast er U00/G00 myid:0B Tx:2/2 Rx:2/2 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L2: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L3: BACnet T S:0x4 0(64) DEV_INST :0x000040 (64) 9600_ 8N1 Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L4: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L5: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L6: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L7: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L8: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 OK

CooLinkNet/CooLinkHub/CooLinkBridge:

>line L1: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L2: Unused Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0

L3: BACnet T S:0x4 0(64) DEV_ID_I NST:0x000 040(64) 9600_8 N1 Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L4: M1M2 Slave U00/G00 Not Connected Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 L5: Unu sed Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0 OK

Next: VA's have to be configured to u se BACnet MS/TP module. See: VA's Configuration.

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

Baud Rat e

9600 bps

Data Bits

8

Parity

None

Stop Bits

1

Configuration

6

2.1.1 BACnet MS/TP MAC Address

On MS/TP networks, MAC address or TS (This Station) address is t he eight bit address used to identify devices on a single RS-485 subnet. TS can be configured with line myid command (in this example TS will be set to 0x41 or 65 decimal):

>line myid L3 41 OK, Boot Required!

TS can be queried with bacnet or line command.

2.1.2 BACnet MS/TP Frame Format

The default BACnet MS/ TP frame format in CoolAutomation devices is 9600_8N1:

Frame format parameters are configurable with line baud command:

>line ba ud L3 19200 _8N2 OK, Boot Required!

In above example fr ame format will become 19200 bps, 8 data bits, no parity, 2 st op bits.

2.2

BACnet IP Configuration

BACnet IP module is activated with below command:

>bacnet IP enable OK, Boot Required!

BACnet IP server is start ed by device only after it establishes an Ethernet link and gets proper IP address (dynamic via DHCP or static). Ethernet and IP management is done with ifconfig command that is out of the spec of this document.

To query BACnet IP status use bacnet command without parameters:

>bacnet Dev instance : 64 (0x000040) BACnet IP : enabled UDP port : 47808 (0xBAC0) BACnet MSTP : L3 TS address : 64 (0x40) OK

The default UDP port number used by BACnet IP Server is 47808 (0xBAC0). This is "well- known" Ethernet port assigned for the BACnet IP protocol. If required port number can be changed (new port number in example below will be 503):

>bacnet port 503 OK, Boot Required!

Next: VA's have to be configured to u se BACnet IP Server. See: VA's Configuration.

2.3

VA's Configuration

VA's -Virtual Addresses are used by CoolAutomation devices in order to simplify translation of the Indoor Unit number - UID into Instance Number of the BACnet Object Identifyer.

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

Object Identifyer bits

31302928272625242322212019181716151413121110987654321

0

Type

Instance Number

VA

Index

Configuration

7

U ID is a string in format Ln.XYY. For Example: L1.102 - Indoor Unit 102 on line L1 L2.003 - Indoor Unit 003 on line L2

List of UID's detected (visible) by CoolAutomation device can be retrieved with ls command.

>ls L1.100 ON 19C 30C High Fan OK # 0 L1.101 OFF 28C 23C High Cool OK - 0

Each UID can have none, one or a number of associated VA's. VA's are plain numbers st ar ting f r om 1. Device can automatically allocate and associate VA's with existing (visible by ls command) UID's:

>va auto OK

To query allocated VA's use va command without parameters:

>va INDOORS L1.100 --> 0001 [Hex: 0x0011 | Dec: 00017] L1.101 --> 0002 [Hex: 0x0021 | Dec: 00033] OK

In example above UID L1.100 has a VA=0001 and UID L1.101 has a VA=0002. Numbers is '[' ' ]' braces are not applicable for BACnet modules (they are used for Modbus modules).

VA's can be allocated or deallocated (deleted) all together or separately. As shown above for automatic VA's allocation va aut o command is used. It is possible to allocat e VA for specific UID. For example, allocate VA 0004 for UID L1.102:

>va + L1 .102 0004 OK

In this case UID does not have to be detected (visible) by CoolAutomation device at the VA allocation time. It is allowed to allocate a number of VA's for any given UID.

To delete all allocated VA's:

>va delall OK

Specific VA can also be deleted (below command will delete VA 0004):

>va - 00 04 OK

Alternat ively all VA's associated with specific UID can be deleted (below command will delete all VA's associated with UID L1.102):

>va - L1 .102 OK

Once VA's are allocated BACnet MS/TP and/or BACnet IP can be used to access Indoor Unit parameters. Translation of the VA into Instance Number of the BACnet Object Identifyer is made according to the scheme below:

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

Object Type

Abbreviation

Read/Write

Encoding

Binary Value

BV

R/W

5

Binary I nput

BIRO3

Analog Value

AV

R/W

2

Analog Input

AIRO0

Multi St ate Value

MV

R/W

19

Charact er String Value

CSVRO40

Integer Value

IVRO45

Positive Integer Value

PIV

R/W

48

Object Identifier bits

Object Description

31 22

21 8

7 0

Type

Instance

VA

Index

BV

00

ON/OFF

AV

00

Room Temperature Set Point x10 °C

AI

00

Room Temperature x10 °C

MV

00

Fan Speed:

1 - Low

5 - T op

8 - HRV Super High

2 - Medium

6 - Very Low

9 - HRV Low FreshUp

3 - High

7 - Super High

10 - HRV High FreshUP

4 - Auto

MV

01

Operation Mode:

1 - Cool

5 - HAU X

9 - HRV Auto

2 - Heat

6 - Fan

10 - HRV Bypass

3 - Auto

7 - Heat +HAUX

11 - HRV Heat Exchange

4 - Dry

12 - HRV Normal

BI

00

H VA C Failure Indica tion .

Present Value = 0 - No Failure Present Value = 1 - Failur e. "Activ e Text" property contain s f ailure code

BV

01

Filter Sign.

BI

01

Demand State (Therm_ON)

MV

02

Louver

1 - Vertical

2 - 30 deg

6 - Auto (Swing)

5 - Hor izontal

3 - 45 deg

7 - Off

4 - 60 deg

8 - No Louver Control

BACnet Tables

8

3

BACnet Tables

Supported Object Types

3.1

Indoor Unit Objects

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

Commands Reference

9

4

line bacnet va

4.1

SYNOPSIS

DESCRIPTION

·

EXAMPLE

See examp les in Configuration chapter.

Commands Reference

bacnet

bacnet bacnet IP enable bacnet IP disable bacnet port <PORT> bacnet instance <DEV_INST>

Withou t parameters bacnet command displays current bacnet configuration.

bacnet IP command is used to enable or disable BACnet IP module. bacnet port command is used to configure UDP port used by BACnet IP module. bacnet instance command is used to configure Device I nstance of the Device Object Identifier.

4.2

line

SYNOPSIS

line line type <Ln> BAC line myid <Ln> <TS> line baud <Ln> <FRAME>

DESCRIPTION

<Ln> parameter denotes commun ication line number like for example: L3 or L4.

·

Withou t parameters line command prints status of all communication lines available in specific device.

·

line type command is used t o activate BACnet MS/TP module on line <Ln>.

·

line myid command is used to change TS address. <TS> parameter should be provided as hexadecimal

number without leading 0x.

·

line baud comma nd is used to change BACnet MS/TP frame format for line <Ln>. <FRAME> parameter

format is <BAUD>_<8|9><N|E|O><1|2>. Supported baud rates for <BAUD> parameter are: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200. Frame format change is effective only aft er pow er reset.

EXAMPLE

See examp les in BACnet M S/ TP Configuration chapter.

www.coolautomation.com

BACnet Integration Guidelines Rev 0.2

4.3

va

Commands Reference

SYNOPSIS

va va auto va + <UID> <VA> va delall va - <UID>|<VA> va ram <N>

DESCRIPTION

<UID> parameter den o tes Indoo r Unit identifier/n umber like for example: L1.100 or L2.003. <VA> parameter

den otes VA number in decimal format.

·

Withou t parameters va comm a nd prints status of all all o cated VA's.

·

va auto command is used t o automatically distr ibute VA's for all detected UID's one to one. Previously

allocated VA's will be deleted

·

va + <UID> <VA> command will allocate VA for given UID. Number of VA's allocated for UID is not limited.

·

va delall command will delet e all allocated VA's.

·

va - <UI D> will delete all allocated VA's for given UID.

·

va - <VA > will delet e specific VA.

·

va ram < N> resizes RAM memory use d for VA's. Parame ter <N> denotes a desired total number of VA's that

can be allocated. By default N=170. VA's memory resize is ef fective only after power reset.

10

EXAMPLE

See examp les in VA's Conf iguration chapter.

www.coolautomation.com

CoolAutomation CoolMasterNet, CooLinkNet, CooLinkHub, CooLinkBridge Integration Manuallines

Specifications and Main Features

Frequently Asked Questions

User Manual