CoolAutomation-PRM-CooLinkNet-v0

CoolAutomation-PRM-CooLinkNet-v0
CooLinkNet
Programmers Reference Manual (PRM)
CooLinkNet
Universal Interface Adapter
for HVAC Systems
Document Revision 0.1
12/15/2014
© 2014 CoolAutomation
www.coolautomation.com
CooLinkNet PRM
Contents
2
Table of Contents
1 Document Revision History
4
2 Acronyms
5
3 Outlines
6
3.1 Layout
........................................................................................................................................................................
6
3.2 Models
........................................................................................................................................................................
7
8
4 Connections
4.1 HVAC Lines ........................................................................................................................................................................ 8
4.2 RS232 Port
........................................................................................................................................................................
8
4.3 Ethernet
........................................................................................................................................................................
9
ASCII I/F IP Server ..........................................................................................................................................................
ModBus IP
..........................................................................................................................................................
9
9
4.4 RS485
........................................................................................................................................................................
ModBus RTU
..........................................................................................................................................................
9
9
4.5 USB
........................................................................................................................................................................
10
4.6 Power
........................................................................................................................................................................
10
11
5 ASCII I/F
5.1 General Protocol
........................................................................................................................................................................
11
Definitions
Messaging
Exit Code
UID
..........................................................................................................................................................
..........................................................................................................................................................
..........................................................................................................................................................
11
11
12
5.2 Commands Reference
........................................................................................................................................................................ 12
Configuration Commands
..........................................................................................................................................................
set
.........................................................................................................................................................
line
.........................................................................................................................................................
ifconfig
.........................................................................................................................................................
boot
.........................................................................................................................................................
HVAC Status and Control
..........................................................................................................................................................
Commands
on
.........................................................................................................................................................
off
.........................................................................................................................................................
cool
.........................................................................................................................................................
heat
.........................................................................................................................................................
fan
.........................................................................................................................................................
dry
.........................................................................................................................................................
auto
.........................................................................................................................................................
temp
.........................................................................................................................................................
fspeed
.........................................................................................................................................................
filt
.........................................................................................................................................................
stat
.........................................................................................................................................................
ls
.........................................................................................................................................................
www.coolautomation.com
12
12
13
14
15
15
15
16
16
17
17
17
18
18
19
19
20
20
© 2014 CoolAutomation
CooLinkNet PRM
query
swing
iset
feed
eco
6 ModBus RTU
Contents
3
.........................................................................................................................................................
.........................................................................................................................................................
.........................................................................................................................................................
.........................................................................................................................................................
.........................................................................................................................................................
21
22
22
23
24
25
6.1 ModBus Address
........................................................................................................................................................................
26
Map
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
1
Document Revision History
4
Document Revision History
0.1 - Preliminary
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
2
DTE
GPIO
HVAC
N.C.
TBD
Acronyms
5
Acronyms
Data Terminal Equipment
General Purpose Input/Output
Heating Ventilation and Air Conditioning
Not Connected
To Be Defined
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
3
Outlines
6
Outlines
3.1 Layout
(1) - Mini USB Device Connector
Used to connect CooLinkNet to PC USB Host for FW Update and maintenance.
(2) - RS232/IO Connector
Pin
Number
1
2
3
4
5
6
7
8
9
10
www.coolautomation.com
Pin
Name
VDC+
GPIO1
VDCGPIO2/CK
HVAC1
HVAC2
GPIO3/RS_TX
GPIO4/RS_RX
GPIO5/TX
GPIO6/RX
Function
Input Voltage
General Purpose IO
Ground
General Purpose IO
HVAC Line L2 / L4
General Purpose IO
General Purpose IO
General Purpose IO
General Purpose IO
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
11
12
Outlines
RS232_RX
RS232_TX
7
RS232 ASCII Interface
(3) Power, HVAC, ModBus Connector
Pin
Number
1
2
3
4
5
6
Pin
Name
VDC+
VDCHVAC1
HVAC2
MOD_A
MOD_B
Function
Input Voltage
Ground
HVAC Line L2 / L4
ModBus A(+) Terminal / HVAC Line L3
ModBus B(-) Terminal / HVAC Line L3
(4) I/F Connector
Pin
Number
1
2
3
4
5
6
Pin
Name
Function
N.C.
K1
K2
VDCVDC+
HVAC Line L4 for CooLinkNet TD
Ground
Input Voltage
N.C.
(5) ETH Connector
RJ45 Ethernet connector
3.2 Models
Model
HVAC Manufacturer
CooLinkNet ME
Mitsubishi Electric
CooLinkNet FU
Fujitsu
CooLinkNet TD
Tadiran
Lines
Number
Name
L4
L3
L4
L3
L2
L4
L3
M1M2
ModBus*
FUS
ModBus*
TI (Inverter)
TAD (Split)
ModBus*
ModBus* - Modbus RTU Slave for DTE integration.
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
4
Connections
8
Connections
DTE (Data Terminal Equipment) is used to denote the device connected to CooLinkNet e.g. PC or Home
Automation Controller.
4.1 HVAC Lines
Depending on the specific CooLinkNet model it supports up to four HVAC Lines denoted as L1, L2, L3, L4.
Below tables describe relation between physical connections and HVAC Line numbers.
· CoolLinkNet ME
CooLinkNet ME
Indoor Unit
Manufacturer
Mitsubishi
Electric
HVAC Line
Connectors
Terminal RS232 /IO
VDC+
TB6
No Polarity
VDC-
HVAC
1
HVAC
2
MOD
A
MOD
B
Name
I/F
2 wires
L4
M1M2
· CooLinkNet FU
CooLinkNet FU
Indoor Unit
Manufacturer
Fujitsu
HVAC Line
Connectors
Terminals RS232 /IO
VDC+
VDC-
HVAC
1
HVAC
2
MOD
A
MOD
B
Name
I/F
RED
BLACK
WHITE
L4
FUS
· CooLinkNet TD
CooLinkNet TD
Indoor Unit
Manufacturer
HVAC Lines
Connectors
Terminals RS232 /IO
VDC+
VDC-
HVAC
1
HVAC
2
MOD
A
MOD
B
Name
I/F
Tadiran
Inverter
RED
BLUE
YELLOW
GREEN
L2
TI
Tadiran Split
RJ11
L4
TAD
4.2 RS232 Port
RS232 Interface on CooLinkNet is available from the RS232/IO connector. Adapter cable (if provided) will route
RS232 signals to DB9 connector according to the table bleow
RS232/IO
Pin
DB9 Pin
Signal
Lvel
Description
12
11
3
2
3
5
1,4,6,7,8
±12V
±12V
GND
TxD Data from CooLinkNet
RxD Data to CooLinkNet
Ground
N.C.
Maximal length of the RS232 Cable should not exceed 25m. By default RS232 Interface is dedicated for ASCII I/
F. The default CooLinkNet RS232 Port settings are listed below:
Baud Rate
www.coolautomation.com
9600
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
Data Bits
Parity Control
Stop Bits
Flow Control
Connections
9
8
None
1
None
4.3 Ethernet
CooLinkNet incorporates an IEEE 802.3 compatible 10/100 Mb/s Ethernet port supported via RJ45 connector.
Below are main port features.
Parameter
Value
Notes
Max Ethernet Cable Length
137m
CAT5 twisted pair cable
Bit Rate
10/100 Mb/s
Supported Ethernet Protocols
10BASE-T/100BASE-TX
Protocol Auto-Negotiation
Enabled
Against Link Partner
RJ45 connector comprises Link and Activity indication LEDs used as specified below.
LED
Color
Function
Link Led
Green
ON for good link
OFF for no link
Activity Led
Orange
BLINK for Tx/Rx Activity
Ethernet interface is used by a number of protocol modules available in CooLinkNet
· ASCII I/F (via ASCII I/F IP Server)
· ModBus IP
· CoolRemote
Network setting of the CooLinkNet are controlled with ifconfig command.
4.3.1 ASCII I/F IP Server
ASCII I/F IP Server referenced as aserver is a classic TCP/IP socket server. Aserver has the following default
characteristics:
Maximal number of simultaneous
connections
Default TCP/IP port
4
10102
4.3.2 ModBus IP
Currently under development.
4.4 RS485
By default terminals MOD A and MOD B (Line L3) are used as an RS485 Interface line for DTE connection.
CooLinkNet supports the following RS485 based protocols:
· ModBus RTU (Slave mode)
4.4.1 ModBus RTU
CooLinkNet can be used as a ModBus RTU slave device working in accordance with Modbus-IDA.ORG
"MODBUS over serial line specification and implementation guide". RS485 default frame format is
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
Baud Rate
Data Bits
Parity Control
Stop Bits
Flow Control
Connections
10
9600
8
None
1
None
4.5 USB
CooLinkNet incorporate USB Device port. USB Device port is used for maintenance operations.
4.6 Power
CooLinkNet depending on the specific model type can be powered from different power sources:
· AC/DC adapter via VDC+ and VDC- terminals
· 12-24V DC from HVAC or other equipment via VDC+ and VDC- terminals
· USB Device port
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
5
ASCII I/F
11
ASCII I/F
CooLinkNet provides simple and comprehensive ASCII I/F Protocol, based on text (ASCII) strings, representing
verbal commands and responses . ASCII I/F implemented in CooLinkNet is fully backward compatible with
previous versions of CooLink products line, but has a number of significant extensions and improvements
mainly aimed to support additional CooLinkNet functionality. ASCII I/F can be utilized via RS232 interface (see
RS232 Port) or TCP/IP ASCII Server.
5.1 General Protocol Definitions
5.1.1 Messaging
Communication between DTE and CooLinkNet via ASCII I/F is based on text (ASCII) strings. Communication
example is shown below
çcommand
>ls L2
L2.102 OFF 20C 27C Auto Cool OK
L2.103 OFF 20C 24C Low Auto OK
- 0
- 0
çresponse
çexit code
çprompt
OK
>
DTE to CooLinkNet
CooLinkNet to DTE
Command string sent to CooLinkNet must be terminated with <CR> (carriage return 0x0D) <LF> (line feed
0x0A) sequence or a single <CR> character. Strings from CooLinkNet (except prompt character) are always
terminated with <CR> <LF>. Commands are case sensitive and should not contain leading or trailing spaces.
The only separator between command name and command parameter(s) is space (0x20) character.
Configuration parameter echo (see set command), defines if characters sent to CooLinkNet via RS232 interface
are echoed back or not. If echo is not zero - characters are echoed.
In case of RS232 interface, prompt character '>' is unconditionally sent by CooLinkNet. In case of ASCII Server
prompt sending is configurable.
5.1.2 Exit Code
CooLinkNet provides Exit Code in verbose or numeric form. Numeric form format is
ERROR:N
where N is a number in range 0...999. If verbose format is not specified in table below it means error has only
numeric format.
Numeric
0
1
2
3
4
5
6
7
8
9
10
Verbose
OK
Bad Format
Failed
Line Unused
Unknown Command
Bad Parameter
OK, Boot Required!
www.coolautomation.com
Description
Command executed successfully
UID not found
UID must be precise
Command format is wrong
Command execution failed
Line is unused
Command is unknown
Line number is wrong
Wrong function
Command parameter is wrong
Command execution will be effective after reboot
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
12
5.1.3 UID
UID is used to identify Indoor Unit or a set of Indoor Units. UID has the following format:
Line
LN
Dot
.
Indoor Number
X
YY
· Line is a CooLinkNet HVAC Line number in range L1..L4. L* means "any line". In some cases to provide
backward compatibility Line can be omitted from the UID.
· Dot is a separator between Line and Indoor Number. If Line is omitted or has a L* form, dot must also be
omitted.
· Indoor Number is an Indoor Unit number in HVAC system. Indoor Number can be '*' that means "any"
Examples:
L1.102
L2.003
L*100
L3.1*
L4
L*
203
Indoor Unit 102 on line L1
Indoor Unit 003 on line L2
Set of Indoor Units 100 on all lines
Set of Indoor Units 1xx on line L3 (L3.100, L3.101, ... )
All Indoors on line L4
All Indoors on all lines
Similar to L*203 (for backward compatibility only)
5.2 Commands Reference
Synopsis and description of the commands listed below have the following notation:
· Parameters or parameters group in angle brackets < > are mandatory.
· Parameters or parameters group in square brackets [ ] are optional and can be omitted.
· The curly braces ( ) are used to denote group inside braces
· The | character between parameters inside brackets means OR.
5.2.1 Configuration Commands
set
line
ifconfig
set
SYNOPSIS
set [<SETTING> <VALUE>]
set defaults
DESCRIPTION
Query or change CooLinkNet setting(s). Without parameters set command will list all supported settings and
their values. To change setting use format with <SETTING> and <VALUE>. Some settings are read only (RO)
and can not be changed.
set defaults will load default values to all settings
<SETTING>
S/N
version
Mode
www.coolautomation.com
RO
RO
Printed as
S/N
version
Value*
X.Y.Z
Description
CooLinkNet Serial Number
CooLinkNet Firmware Version
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
RW
app
baud
echo
verbose
aserver port
aserver prompt
deg
RW
RW
RW
RW
RW
RW
application
baud rate
echo
verbose
aserver port
aserver prompt
deg C/F
ASCII I/F
13
string
CooLinkNet Application
1200...115200 RS232 Interface baud rate. Default: 9600
0 or 1
RS232 Interface echo control. 0 - disabled, 1 - enabled
0 0r 1
Exit Code format. 0 - numeric, 1 - verbose
integer
aserver TCP port. Default: 10102
0 or 1
aserver prompt control
C or F
Temperature scale Celsius or Fahrenheit
* - Bold values are defaults.
EXAMPLE
Disable echo:
>set echo 0
OK
>
Change aserver TCP port:
>set aserver port 12345
OK
>
Load defaults:
>set defaults
OK
>
line
SYNOPSIS
line
line <PROPERTY> <Ln> <VAL>
DESCRIPTION
Query or change HVAC Lines status and configuration. In format without parameters line command will provide
information about current Lines status. Second format is used to change write enabled properties.
<PROPERTY>
master
Mode Value
R/W
simul
R/W
myID
R/W
baud
R/W
Tx
Rx
TO
CS
Col
NAK
RO
www.coolautomation.com
RO
RO
RO
RO
RO
Description
0 or 1 CooLinkNet acts as a Master device
Notes
FUS,M1M2
only
integer Simulate given number of Indoor Units. To disable simulation use
"0". Simulation is persistent (not disabled after power reset)
CooLinkNet Own address on given HVAC Line.
For ModBus RTU Line myID is a "Slave Device Address"
Configure UART parameters for given Line. Value format is:
<BAUD> <8|9><N|E|O><1|2>
For example: 9600 8N1
integer Transmitted messages
counter
Received messages
Timeout errors
Checksum errors
Collision errors
NAK errors
string
Where applicable
Printed as
Total/Last
Last means since
previous print
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ambtemp
WO
0 or 1
ASCII I/F
Ambient temperature in Slave mode is taken from:
0 - Master device
1 - Indoor return air
14
M1M2 only
EXAMPLE
>line
L1: Unused
Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0
L2: TI U00/G00
Tx:40/40 Rx:0/0 TO:39/39 CS:0/0 Col:0/0 NAK:0/0
L3: CLMB Address:0x50(80) 9600_8N1
Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0
L4: FUS Slave U00/G00 Not Connected
Tx:0/0 Rx:0/0 TO:0/0 CS:0/0 Col:0/0 NAK:0/0
OK
Become Slave on Line L4
>line master L4 0
OK, Boot Required!
Set Line L3 baud rate to 19200, 8 data bits, even parity, 1 stop bit
>line baud L3 19200 8E1
OK, Boot Required!
ifconfig
SYNOPSIS
ifconfig
ifconfig <PROPERTY> <VALUE>
ifconfig enable|disable
DESCRIPTION
Query or configure Ethernet network settings. Without parameters, ifconfig command will list current
configuration. To change configuration use format with <PROPERTY> and <VALUE>. Parameter IP can be set
to DHCP (DHCP client) or fixed IP number. In case of DHCP - Netmask and Gateway values are provided by
DHCP server. By default CooLinkNet is configured for DHCP client operation. CooLinkNet Ethernet module can
be enabled or disabled with corresponding command.
EXAMPLE
Query
>ifconfig
MAC
: 28:3B:96:FF:FF:FE
Link
: Up
IP
: 192.168.1.109 (DHCP)
Netmask: 255.255.255.0
Gateway: 192.168.1.1
OK
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
15
Configure fixed IP and Gateway
>ifconfig IP 192.168.1.102
OK, Boot Required!
>ifconfig Gateway 192.168.1.0
OK, Boot Required!
Configure DHCP client operation
>ifconfig IP DHCP
OK
Disable Ethernet
>ifconfig disable
OK, Boot Required!
boot
SYNOPSIS
boot
boot [N]
DESCRIPTION
· <N> omitted - Enter Boot Mode
· <N> = 2 - Reset CooLinkNet
5.2.2 HVAC Status and Control Commands
on
off
cool
heat
fan
dry
auto
temp
fspeed
swing
filt
stat
ls
query
iset
feed
eco
on
SYNOPSIS
on [UID]
DESCRIPTION
Turn on Indoor Unit(s).
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
16
EXAMPLE
Turn on Indoor Unit 102 on line L1
>on L1.102
OK
>
Turn on all Indoor Units on Line L2
>on L2*
OK
>
off
SYNOPSIS
off [UID]
DESCRIPTION
Turn off Indoor Unit(s).
EXAMPLE
Turn on Indoor Unit 102 on line L1
>off L1.102
OK
>
Turn on all Indoor Units on line L2
>off L2*
OK
>
cool
SYNOPSIS
cool [UID]
DESCRIPTION
Set Indoor Unit(s) operation mode to cool.
EXAMPLE
Set Indoor Unit 102 on line L1 to cool mode
>cool L1.102
OK
>
Set all Indoor Units on line L2 to cool mode
>cool L2*
OK
>
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
17
heat
SYNOPSIS
heat [UID]
DESCRIPTION
Set Indoor Unit(s) operation mode to heat.
EXAMPLE
Set Indoor Unit 102 on line L1 to heat mode
>heat L1.102
OK
>
Set all Indoor Units on line L2 to heat mode
>heat L2*
OK
>
fan
SYNOPSIS
fan [UID]
DESCRIPTION
Set Indoor Unit(s) operation mode to fan.
EXAMPLE
Set Indoor Unit 102 on line L1 to fan mode
>fan L1.102
OK
>
Set all Indoor Units on line L2 to fan mode
>fan L2*
OK
>
dry
SYNOPSIS
dry [UID]
DESCRIPTION
Set Indoor Unit(s) operation mode to dry.
EXAMPLE
Set Indoor Unit 102 on line L1 to dry mode
>dry L1.102
OK
>
Set all Indoor Units on line L2 to dry mode
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
18
>dry L2*
OK
>
auto
SYNOPSIS
auto [UID]
DESCRIPTION
Set Indoor Unit(s) operation mode to auto.
EXAMPLE
Set Indoor Unit 102 on line L1 to auto mode
>auto L1.102
OK
>
Set all Indoor Units on line L2 to auto mode
>auto L2*
OK
>
temp
SYNOPSIS
temp [UID] [±]<TEMP>
temp [UID] <TEMP.d>
DESCRIPTION
Change Indoor Unit(s) Set Temperature.
· In form temp <UID> [±]<TEMP>
<TEMP> parameter must be decimal natural number. Command can work in relative or absolute manner. If plus
'+' or minus '-' sign precedes <TEMP> parameter it's value will be added to or substituted from current Set
Temperature value. Otherwise Set Temperature will be set to the given <TEMP> value.
· In form temp <UID> <TEMP.d>
Set Temperature parameter <TEMP.d> is a fractal number with 0.1 precision. (In this case preceding +|- are not
allowed). If HVAC System does not support 0.1 precision for the Set Temperature (see table below), the final
value will be nearest supported value.
AC Type
DK
ME
Set Temperature
Precision
0.1ºC
0.1ºC
The deg setting (see set command) defines which temperature scale Celsius or Fahrenheit is used for <TEMP>
and <TEMP.d> parameters value.
EXAMPLE
Set Indoor Unit 102 on line L1 Set Temperature to 23º
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
19
>temp L1.102 23
OK
>
Decrease all Indoor Units on line L2 Set Temperature by 2º
>temp L2* -2
OK
>
Set all Indoor Units on line L2 Set Temperature to 24.5º
>temp L2* 24.5
OK
>
fspeed
SYNOPSIS
fspeed [UID] <l|m|h|t|a>
DESCRIPTION
Set Indoor Unit(s) Fan Speed to:
· l - low
· m - medium
· h - high
· t - top
· a - auto
Not all Indoor Units support Fan Speed options listed above. Specific Fan Speeds support depend on specific
Indoor Unit capabilities. If requested Fan Speed is not supported by Indoor Unit(s) fspeed command will have
no effect.
EXAMPLE
Set Indoor Unit 102 on line L1 Fan Speed to low
>fspeed L1.102 l
OK
>
Set all Indoor Units on Line L2 Fan Speed to high
>fspeed L2* h
OK
>
filt
SYNOPSIS
filt <UID>
DESCRIPTION
Reset Filter Sign.
EXAMPLE
Reset Filter Sign on Indoor Unit 102 0n line L1
>on L1.102
OK
>
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
20
Reset Filter Sign on all Indoor Units on Line L2
>on L2*
OK
>
stat
SYNOPSIS
stat [UID]
stat2 [UID]
stat3 [UID]
stat4 [UID]
DESCRIPTION
Get Indoor Unit(s) status list.
These commands are deprecated and are not recommended for use in CooLinkNet. They are implemented for
backward compatibility only. Detailed description of these commands can be found in the PRM of previous
CooLink versions.
ls
SYNOPSIS
ls [UID]
DESCRIPTION
Get Indoor Unit(s) status list. If UID is omitted all Indoor Units connected to CooLinkNet will be listed.
Indoor Unit status line has strict format, so that every status field is printed in fixed position.
· Indoor Unit status line with Celsius temperature scale
0123456789012345678901234567890123456
L2.102 OFF 20C 27C High Cool OK
- 0
· Indoor Unit status line with Fahrenheit temperature scale
012345678901234567890123456789012345678
L2.102 OFF 120F 127F High Cool OK
- 0
Field
UID
On/Off
Set Temperature
Room Temperature
Fan Speed
Operation Mode
Indoor Failure Code
Filter Sign
Demand
Position in string
Celsius
Fahrenheit
0-5
7-9
11-12
15-16
19-22
24-27
29-32
34
36
11-13
16-18
21-24
26-29
31-34
36
38
Values
LN.XYY
ON,OFF
nnC or nnnF
nnC or nnnF
Low, Med, High, Top, Auto
Cool, Heat, Fan, Dry, Auto
OK - no failure, else Indoor Failure Code
- or # (Filter Sign)
0 or 1
EXAMPLE
>ls L2
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
L2.101 ON
L2.102 OFF
OK
>ls L2.101
L2.101 ON
OK
>ls
L1.101 ON
L1.102 ON
L2.101 ON
L2.102 OFF
OK
ASCII I/F
25C 27C Low Cool OK
20C 27C High Cool OK
- 1
- 0
25C 27C Low
Cool OK
- 1
25C
22C
25C
20C
Cool
Cool
Cool
Cool
-
24C
23C
27C
27C
Low
Med
Low
High
OK
OK
OK
OK
21
1
0
1
0
query
SYNOPSIS
query <UID_STRICT> <o|m|f|t|h|e|a|s>
DESCRIPTION
Query one of the operation conditions of given Indoor Unit. <UID_STRICT> parameter must define single Indoor
Unit in form LN.XYY or XYY (see UID). Resulting value is printed as alpha-numeric value according to the table
below.
Query
o
m
Operation Condition
On/Off
Operation Mode
f
Fan Speed
t
e
Set Temperature
Failure Code
a
h
s
Ambient Temperature
Set Temperature
Louver Position
Value
0 - Off, 1 - On
0 - Cool
1 - Heat
2 - Auto
3 - Dry
4 - Haux
5 - Fan
0 - Low
1 - Medium
2 - High
3 - Auto
4 - Top
Natural
0 - No failure, otherwise failure code
same as in ls command
Natural
0.01º Precision
0 - No Louver Control
a - auto (swing)
h - horizontal
3 - 30º
4 - 45º
6 - 60º
v - vertical
EXAMPLE
>query L1.100 o
1
OK
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
>query
0
OK
>query
25
OK
>query
27
OK
>query
2
OK
>query
U4
OK
>query
0
OK
>query
20.50
OK
ASCII I/F
22
L1.100 m
L1.100 t
L1.100 a
L1.100 f
L1.100 e
L1.100 e
L1.100 h
swing
SYNOPSIS
swing <UID> <h|v|a|3|4|6>
DESCRIPTION
Set Indoor Unit(s) louver position to:
· h - horizontal
· v - vertical
· a - auto (swing)
· 3 - 30º
· 4 - 45º
· 6 - 60º
Not all Indoor Units support louver position options listed about or have louver position control at all. Louver
control is capability of the specific Indoor Unit type. If requested louver position is not supported by Indoor
Unit(s), swing command will have no effect.
EXAMPLE
Set Indoor Unit 102 on line L1 louver to horizontal position
>swing L1.102 h
OK
>
iset
SYNOPSIS
iset <UID> <SETN>
iset <UID> <SETN> <VAL>
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
23
DESCRIPTION
Read/Write Indoor Unit internal parameter (setting). If value not specified the parameter is read otherwise it is
written with <VAL> and read back. Below is the list of the most useful settings.
<SETN>
02
Function
Ambient
Temperature
05
Auto Mode
Mode Value
Description
M1M2 (Mitsubishi Electric)
1
Average
R/W
2
Indoor Unit return air sensor
3
Wired Thermostat sensor
1
Enabled
R/W
2
Disabled
FUS (Fujitsu)
42
Ambient
Temperature
R/W
48
Ambient
Temperature with
Wired Thermostat
R/W
0
1
0
Indoor Unit sensor only
Depends on setting 48
Indoor Unit and Wired Thermostat sensors
1
Wired Thermostat sensor only
The complete up-to-date information about internal parameters and their values should be taken from related
manual of the specific HVAC system and Indoor Unit type. Information in above table is provided only for
reference.
COMPATIBILITY
M1M2
TAD
FUS
Yes
N.A.
Yes
feed
SYNOPSIS
feed <Ln> [±]<TEMP[.d]>
DESCRIPTION
This command defines CooLinkNet Own Ambient Temperature (as if it were measured by CooLinkNet itself).
Command can work in relative or absolute manner. If plus '+' or minus '-' sign precedes <TEMP> parameter it's
value will be added to or substituted from current value. Otherwise Own Ambient Temperature will be set to the
given <TEMP> value. <TEMP> can be provided with 0.1 precision. If <TEMP> is zero CooLinkNet will not use
Own Ambient Temperature for it's operation.
CooLinkNet keeps separate Own Ambient Temperature for each HVAC Line. If <Ln> is omitted the first not
"Unused" HVAC Line will be taken.
Own Ambient Temp usage depends on HVAC Line type.
HVAC Line
Own Ambient Temp usage
M1M2
If non zero, sent to Indoor Unit as Wired Thermostat temperature sensor value
FUS
TAD
Temperature sent to Indoor Unit in i-feel message
EXAMPLE
>feed 24.5 L2
OK
>
www.coolautomation.com
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ASCII I/F
24
eco
SYNOPSIS
eco [UID]<0|1>
DESCRIPTION
Turns off - 0 or on - 1 ECO (economy) mode on Indoor Unit(s).
EXAMPLE
Turn on ECO mode on Indoor Unit 102 on line L2
>eco L2.102 1
OK
>
COMPATIBILITY
M1M2
TAD
FUS
www.coolautomation.com
N.A.
N.A.
Yes
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
6
ModBus RTU
25
ModBus RTU
CooLinkNet is fully compliant with following ModBus specifications:
· MODBUS over Serial Line Specification and Implementation Guide V1.02
· MODBUS application protocol specification V1.1b
ModBus Interface Physical Layer
CooLinkNet physical connection to ModBus is Two-Wire EIA/TIA-485 standard interface via 485-A and 485-B
terminals, recommended by ModBus specification. On such 2W-bus, at any time only one driver has the right for
transmitting thus a ModBus communication is always initiated by the master. CooLinkNet will never transmit
without receiving a request from master. A number of CooLinkNet devices can be connected to single 2W-bus.
Each CooLinkNet in this case must have unique ModBus slave address (command line myID <Ln> <VAL>).
ModBus RTU Frame Format
CooLinkNet by default supports ModBus RTU Transmission Mode with following frame format:
Baud Rate
Start Bits
Data Bits
Parity
Stop Bits
9600
1
8
No
1
Frame format can be changed with line baud <Ln> <VAL> command.
Supported MODBUS Functions
Function Code
03 (0x03)
06 (0x06)
16 (0x10)
43 14 (0x2B 0x0E)
www.coolautomation.com
Function Description
Read Holding Registers
Write Single Register
Write Multiple registers
Read Device Information
© 2014 CoolAutomation
CooLinkNet PRM Rev 0.1
ModBus RTU
26
6.1 ModBus Address Map
Holding Reg
Address*
Description
Read
Write
Hex
Dec
0001
0002
0003
0004
1
2
3
4
CooLinkNet Internals
CooLinkNet Version
CooLinkNet S/N
CooLinkNet Model
ModBus Address
0005
5
Reset
W
0010
16
R
0011
0012
17
18
0100
0101
0102
0103
0104
0105
256
257
258
259
260
261
Internal State
· 0 - Not Connected to RC line
· 1 - Connecting
· 2 - Connected as single RC
· 3 - Connected as Master RC. Detected
Slave RC
· 4 - Connected as Slave RC
0 - Master Mode (default) 1 - Slave Mode
UID
Indoor Status and Control
On/Off 0-Off, 1-On
Operation Mode (see Mode Encoding )
Fan Speed (see Fan Speed Encoding )
Set Point °C
Failure Code
Indoor Ambient Temperature °C
0110
272
Feed Temperature °C
Required**
R
R
R
RW
RW
R
R
R
R
R
Notes
Version Model
ModBus Address change is
effective only after reset
1 - Enter Boot mode
CooLinkNet does not respond to
the write request into this register
2 - Reset
0.0.4
MSB - X, LSB - YY
W
W
W
W
R
R
MSB - Integer Part
LSB - Fraction Part
RW
*On the ModBus wire registers address range starts from 0 and thus register address is sent decremented (-1).
** If Version or Model is not specified, it means that register is supported in any CooLinkNet version and/or
model. N.A. means future option.
Mode Encoding
Cool
0
Heat
1
Auto
2
Dry
3
Haux
4
Fan
5
Fan Speed Encoding
Low
0
Medium
1
High
2
Auto
3
Top
4
www.coolautomation.com
© 2014 CoolAutomation
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement