Difference between revisions of "Mitsubishi"

From HSYCO
Jump to navigation Jump to search
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The MITSUBISHI air-conditioning system equipped with one of the centralized controllers among G-50, GB-50, or AG-150 allows for remote control and supervision, via Ethernet communication, of the whole framework.
+
The Mitsubishi I/O Server can control air-conditioning devices connected to a Mitsubishi M-NET bus via a centralized controller and the Ethernet LAN.
  
 +
The following models of Mitsubishi M-NET controllers, with support for the XML API, are supported:
 +
*EB-50
 +
*EW-50
 +
*G-50
 +
*GB-50
 +
*AG-150
 +
*AE-200
  
 +
This I/O Server complies with the XML API for the Mitsubishi M-NET proprietary protocol.
 +
 +
{{note|In order to connect the Mitsubishi controller with HSYCO, the Web Monitor and Annual Schedule pin codes activation are required. On request, Mitsubishi will provide a document to be compiled for the activation.}}
  
 
[[Category:I/O Server]]
 
[[Category:I/O Server]]
  
== Communication ==
+
== M-NET Architecture ==
 +
All the devices comprising the M-NET architecture are assigned an address ranging from 0 to 250. 
 +
 
 +
Conditioners and lossnay modules can be associated to  50 different groups (indexed from 1 to 50). The control of these modules is thus performed addressing the group they belong to.
 +
 
 +
Further, it is possible to expand the system using up to three ECs which allow to replicate a full M-NET architecture under each EC. In this case, modules are addressed specifying both the EC and the group they belong to.
  
The Mitsubishi controller replies on the port 80 (10 sockets) or 1025 (4 sockets) of its IP address.
+
The following image shows a possible configuration of a simple system:
  
== M-NET Configuration ==
+
[[File:IOServer_Mitsubishi_Architecture.png|600px|border]]
This I/O Server complies with the XML API for the Mitsubishi M-NET proprietary protocol.
 
  
{{note|In order to connect the Mitsubishi controller with HSYCO, the Web Monitor and Annual Schedule pin codes activation is required. On request, Mitsubishi will provide a document to be compiled for the activation.}}
+
The Mitsubishi controller replies on the port 80 (10 sockets) or 1025 (4 sockets) of its IP address.
  
All the devices comprising the M-NET architecture are assigned an address ranging from 0 to 250. 
+
== HSYCO Configuration ==
 +
Add an MNET I/O Server in the [[Settings#I/O Servers|I/O Servers section of the Settings]] and set its parameters:
  
Conditioners and lossnay modules can be associated to  50 different groups (indexed from 1 to 50). The control of these modules is thus performed addressing the group they belong to.
+
=== Communication ===
 +
*'''IP Address''': IP address of the controller
 +
*'''IP Port''': TCP/IP port to use, can be set to 80 or 1025, leave blank to use default port 80.
  
Further, it is possible to expand the system using up to three ECs which allow to replicate a full M-NET architecture under each EC. In this case, modules are addressed specifying both the EC and the group they belong to.
+
=== High Availability ===
 +
*'''Shutdown when inactive''': defaults to true.
  
== HSYCO Configuration ==
 
 
=== Options ===
 
=== Options ===
  
Line 63: Line 80:
  
 
== Datapoints ==
 
== Datapoints ==
In the following table replace <target> with ''system'' to address the whole framework. If ECs are used you can specify ''ecS'' as target to address a single sub-system and as before, it is necessary to prepend the target EC number before specifying the group or the address.
+
In the following tables, replace <target> with "system" for sending the command to all the defined groups. If ECs are used (i.e. the option “ec” is set to a value greater than 0), you can specify “<nowiki>ec<s></nowiki>” (with <nowiki><s></nowiki> ranging from 1 to the specified value of ECs) as target to address a single sub-system.
 +
 
 +
Further, replace <nowiki><n></nowiki> in “g<nowiki><n></nowiki>” with a group number ranging from 1 to 50 and replace <nowiki><m></nowiki> in "a<nowiki><m></nowiki>" with an address from 0 to 250.
 +
 
 +
If ECs are used, it is necessary to specify the EC number we are addressing too. To this end, prepend the string “<nowiki>ec<s></nowiki>.” to the group or the address.
 +
 
 +
For instance, when an EC is used, the following datapoint ID is not correct:
 +
g1.power
 +
 
 +
The correct one to be used is the following:
 +
ec1.g1.power
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 111: Line 138:
 
|17 - 30
 
|17 - 30
 
|W
 
|W
|set the temperature of all the groups to the specified value (if compliant with the previously mentioned ranges)
+
|set the temperature of all the groups to the specified value (if compliant with the allowed ranges<sup>[[#note1|[Note 1]]]</sup>)
 
|-
 
|-
  
Line 224: Line 251:
 
|-
 
|-
 
|W
 
|W
|set the temperature of this group to the specified value (if compliant with the previously mentioned ranges)
+
|set the temperature of this group to the specified value (if compliant with the allowed ranges<sup>[[#note1|[Note 1]]]</sup>)
 
|-
 
|-
  
Line 375: Line 402:
  
 
|}
 
|}
 +
 +
<span id="note1">
 +
;Note 1 :
 +
For some modes the temperature must be set following these ranges:
 +
*modes “cool” or “dry”: 19 - 30
 +
*mode “heat”: 17 - 28
 +
*mode “auto”: 19 - 28
 +
If <target> is set to “system” or “ec<nowiki><s></nowiki>” and the specified temperature parameter doesn’t respect the above mentioned ranges for a group belonging to the target, then the temperature is not changed for that group and an error message is logged.
 +
</span>
  
 
== User Interface ==
 
== User Interface ==
 
In the following tables, replace <n> with a group number ranging from 1 to 50, and replace <m> with an address from 0 to 250.
 
If one or more ECs are used (i.e. the option field “ec” is set to a value greater than 0), it is necessary to specify the EC number we are addressing. To this end, prepend the string “ecS.” (with S ranging from 1 to the specified value of ECs) to the target group or the address.
 
 
For instance, when an EC is used the following ID or name is not correct:
 
 
mits.g1.power
 
 
The correct one to be used is the following:
 
mits.ec1.g1.power
 
  
 
=== UISET Actions ===
 
=== UISET Actions ===
Line 406: Line 432:
 
|-
 
|-
  
|ecS.power
+
|ec<nowiki><s></nowiki>.power
 
|value
 
|value
 
|the status of the sub-system connected to this EC: ON: at least one group is on; OFF: all the sub-system is off. Valid if the option “ec” is set to a value greater that 0.
 
|the status of the sub-system connected to this EC: ON: at least one group is on; OFF: all the sub-system is off. Valid if the option “ec” is set to a value greater that 0.
Line 500: Line 526:
 
!Action
 
!Action
 
|-
 
|-
 
  
 
|rowspan="2"|<target>.power
 
|rowspan="2"|<target>.power
Line 508: Line 533:
 
|off
 
|off
 
|turn the target off
 
|turn the target off
 +
|-
 +
 +
|rowspan="2"|<target>.mode
 +
|cool<br/>dry<br/>fan<br/>heat<br/>auto
 +
|air conditioner modes
 +
|-
 +
|heatrecovery<br/>lcauto<br/>bypass
 +
|LOSSNAY modes
 +
|-
 +
 +
|rowspan="3"|<target>.temp
 +
|17 - 30
 +
|set the target temperature<sup>[[#note1|[Note 1]]]</sup>
 +
|-
 +
|up
 +
|increase the target temperature by 1°C (if the upper limit is not reached)<sup>[[#note1|[Note 1]]]</sup>
 +
|-
 +
|down
 +
|decrease the target temperature by 1°C (if the lower limit is not reached)<sup>[[#note1|[Note 1]]]</sup>
 +
|-
 +
 +
|<target>.airdirection
 +
|horizontal<br/>mid1<br/>mid2<br/>vertical<br/>swing
 +
|set the air direction of the target to the specified mode
 +
|-
 +
 +
|rowspan="2"|g<n>.airdirection
 +
|up
 +
|change the air direction of this group according to the sequence: vertical - mid2 - mid1 - horizontal. If the current direction is set to swing, sets it to horizontal
 +
|-
 +
|down
 +
|change the air direction of this group according to the sequence: horizontal - mid1 - mid2 - vertical. If the current direction is set to swing, set it to vertical
 +
|-
 +
 +
|<target>.fanspeed
 +
|high<br/>mid1<br/>mid2<br/>low
 +
|set the fan speed of the target
 +
|-
 +
 +
|rowspan="2"|g<n>.fanspeed
 +
|up
 +
|change the fan speed of this group according to the sequence: low - mid2 - mid1 - high
 +
|-
 +
|down
 +
|change the fan speed of this group according to the sequence: low - mid2 - mid1 - high
 +
|-
 +
 +
|<target>.ventilation
 +
|high<br/>low<br/>off
 +
|set the operation status of the interlocked LOSSNAY or OA processing unit
 +
|-
 +
 +
|rowspan="2"|<target>.reset
 +
|error
 +
|reset the error signal of the terget
 +
|-
 +
|filter
 +
|reset the filter signal of the target
 +
|-
 +
 +
|rowspan="2"|<target>.prohibit.drive
 +
|on
 +
|prohibit power switching by remote control
 +
|-
 +
|off
 +
|allow power switching by remote control
 +
|-
 +
 +
|rowspan="2"|<target>.prohibit.mode
 +
|on
 +
|prohibit mode setting by remote control
 +
|-
 +
|off
 +
|allow mode setting by remote control
 +
|-
 +
 +
|rowspan="2"|<target>.prohibit.settemp
 +
|on
 +
|prohibit temperature setting by remote control
 +
|-
 +
|off
 +
|allow temperature setting by remote control
 +
|-
 +
 +
|rowspan="2"|<target>.prohibit.filter
 +
|on
 +
|prohibit filter signal reset by remote control
 +
|-
 +
|off
 +
|allow filter signal reset by remote control
 +
|-
 +
 +
|rowspan="4"|g<n>.prohibit
 +
|drive
 +
|switch the state (on/off) of the drive prohibition for this group
 +
|-
 +
|mode
 +
|switch the state (on/off) of the mode prohibition for this group
 +
|-
 +
|settemp
 +
|switch the state (on/off) of the temperature setting prohibition for this group
 +
|-
 +
|filter
 +
|switch the state (on/off) of the filter reset prohibition for this group
 
|-
 
|-
  
Line 513: Line 642:
  
 
== Release Notes ==
 
== Release Notes ==
=== 3.0 ===
+
 
*initial release versione
+
=== 3.5.0===
 +
*response timeout increased
 +
 
 +
=== 3.4.0===
 +
*bug fix: inlet temperature not working with decimal values
 +
 
 +
=== 3.0.0 ===
 +
*initial release version
  
 
----
 
----

Latest revision as of 10:18, 14 July 2015

The Mitsubishi I/O Server can control air-conditioning devices connected to a Mitsubishi M-NET bus via a centralized controller and the Ethernet LAN.

The following models of Mitsubishi M-NET controllers, with support for the XML API, are supported:

  • EB-50
  • EW-50
  • G-50
  • GB-50
  • AG-150
  • AE-200

This I/O Server complies with the XML API for the Mitsubishi M-NET proprietary protocol.

In order to connect the Mitsubishi controller with HSYCO, the Web Monitor and Annual Schedule pin codes activation are required. On request, Mitsubishi will provide a document to be compiled for the activation.

M-NET Architecture

All the devices comprising the M-NET architecture are assigned an address ranging from 0 to 250.

Conditioners and lossnay modules can be associated to 50 different groups (indexed from 1 to 50). The control of these modules is thus performed addressing the group they belong to.

Further, it is possible to expand the system using up to three ECs which allow to replicate a full M-NET architecture under each EC. In this case, modules are addressed specifying both the EC and the group they belong to.

The following image shows a possible configuration of a simple system:

IOServer Mitsubishi Architecture.png

The Mitsubishi controller replies on the port 80 (10 sockets) or 1025 (4 sockets) of its IP address.

HSYCO Configuration

Add an MNET I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

  • IP Address: IP address of the controller
  • IP Port: TCP/IP port to use, can be set to 80 or 1025, leave blank to use default port 80.

High Availability

  • Shutdown when inactive: defaults to true.

Options

ID Default Values Description
gui true true enable support for the UI object, UISET actions and USER commands
false disable UI support
startupevents false true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system
pollinterval 20 n > 0 the data acquisition interval, in seconds
ec 0 0 - 3 specifies the number of ECs connected to the main controller. A value of 0 indicates that no EC is used

Datapoints

In the following tables, replace <target> with "system" for sending the command to all the defined groups. If ECs are used (i.e. the option “ec” is set to a value greater than 0), you can specify “ec<s>” (with <s> ranging from 1 to the specified value of ECs) as target to address a single sub-system.

Further, replace <n> in “g<n>” with a group number ranging from 1 to 50 and replace <m> in "a<m>" with an address from 0 to 250.

If ECs are used, it is necessary to specify the EC number we are addressing too. To this end, prepend the string “ec<s>.” to the group or the address.

For instance, when an EC is used, the following datapoint ID is not correct:

g1.power

The correct one to be used is the following:

ec1.g1.power
ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the panel
<target>.power 1 R at least one group is on
W turn all the groups on
0 R the whole system is off
W turn the whole system off
<target>.mode cool
dry
fan
heat
auto
W set the mode of all the groups to the specified value (Air conditioner modes)
heatrecovery
lcauto
bypass
W set the mode of all the groups to the specified value (LOSSNAY modes)
<target>.temp 17 - 30 W set the temperature of all the groups to the specified value (if compliant with the allowed ranges[Note 1])
<target>.airdirection horizontal
mid1
mid2
vertical
swing
W set the air direction of all the groups to the specified value
<target>.fanspeed high
mid1
mid2
low
W set the speed of the fan of all the groups to the specified value
<target>.ventilation high
low
off
W set the operation status of the interlocked LOSSNAY or OA processing unit present in the whole system to the specified value
<target>.prohibit.drive 1 W prohibit power switching by remote control to all the groups
0 W allow power switching by remote control to all the groups
<target>.prohibit.mode 1 W prohibit mode setting by remote control to all the groups
0 W allow mode setting by remote control to all the groups
<target>.prohibit.settemp 1 W prohibit temperature setting by remote control to all the groups
0 W allow temperature setting by remote control to all the groups
<target>.prohibit.filter 1 W prohibit filter signal reset by remote control to all the groups
0 W allow filter signal reset by remote control to all the groups
<target>.reset error W reset the error signal of all the groups
filter W reset the filter signal of all the groups
g<n>.power 1 R this group is on
W turn this group on
0 R this group is off
W turn this group off
g<n>.mode cool
dry
fan
heat
auto
R the mode of this group is set to the reported value (Air conditioner modes)
W set the mode of this group to the specified value (Air conditioner modes)
autoheat
autocool
R the mode of this group is set to the reported value (Air conditioner modes)
heatrecovery
lcauto
bypass
R the mode of this group is set to the reported value (LOSSNAY modes)
W set the mode of this group to the specified value (LOSSNAY modes)
g<n>.temp 17 - 30 R the set temperature for this group correspond to the reported value (in °C)
W set the temperature of this group to the specified value (if compliant with the allowed ranges[Note 1])
g<n>.inlettemp 0 - 999 R the inlet measured temperature for this group (in tenth of °C)
g<n>.airdirection horizontal
mid1
mid2
vertical
swing
R the air direction for this group is set to the reported value
W set the air direction of this group to the specified value
g<n>.fanspeed high
mid1
mid2
low
R the fan speed for this group is set to the reported value
W set the speed of the fan of this group to the specified value
g<n>.ventilation high
low
off
R the operation status of the interlocked LOSSNAY or OA processing unit present in this group is set to the reported value
W set the operation status of the interlocked LOSSNAY or OA processing unit present in this group to the specified value
g<n>.prohibit.drive 1 R the power switching by remote control is prohibited to this group
W prohibit power switching by remote control to this group
0 R the power switching by remote control is allowed to this group
W allow power switching by remote control to this group
g<n>.prohibit.mode 1 R the mode setting by remote control is prohibited to this group
W prohibit mode setting by remote control to this group
0 R the mode setting by remote control is allowed to this group
W allow mode setting by remote control to this group
g<n>.prohibit.settemp 1 R the temperature setting by remote control is prohibited to this group
W prohibit temperature setting by remote control to this group
0 R the temperature setting by remote control is allowed to this group
W allow temperature setting by remote control to this group
g<n>.prohibit.filter 1 R the filter signal reset by remote control is prohibited to this group
W prohibit filter signal reset by remote control to this group
0 R the filter signal reset by remote control is allowed to this group
W allow filter signal reset by remote control to this group
g<n>.filter 1 R the filter signal of this group is on
0 R the filter signal of this group is off
g<n>.error 1 R the error signal of this group is on
0 R the error signal of this group is off
g<n>.reset filter W reset the filter signal of this group
error W reset the error signal of this group
a<m>.error 0 R no error is reported for this address
<xxxx> R the error with code <xxxx> is reported for this address
system.error 1 R an error is detected on some address
0 R no error detected on any address

Note 1 

For some modes the temperature must be set following these ranges:

  • modes “cool” or “dry”: 19 - 30
  • mode “heat”: 17 - 28
  • mode “auto”: 19 - 28

If <target> is set to “system” or “ec<s>” and the specified temperature parameter doesn’t respect the above mentioned ranges for a group belonging to the target, then the temperature is not changed for that group and an error message is logged.

User Interface

UISET Actions

ID Attribute Set to
connection visible true when the device appears offline, false otherwise
system.power value the status of the system: ON: at least one group is on; OFF: all the system is off
ec<s>.power value the status of the sub-system connected to this EC: ON: at least one group is on; OFF: all the sub-system is off. Valid if the option “ec” is set to a value greater that 0.
g<n>.power value the status of the specified group: ON, OFF
g<n>.mode value the set mode for this group: COOL, DRY, FAN, HEAT, AUTO, AUTOHEAT, AUTOCOOL, HEATRECOVERY, LCAUTO, BYPASS
g<n>.temp value the set temperature for this group: 17 - 30 °C
g<n>.inlettemp value the inlet measured temperature for the specified group: 0.0 - 99.9 °C
g<n>.airdirection value the air direction setting for this group: HORIZONTAL, MID1, MID2, VERTICAL, SWING
g<n>.fanspeed value the speed of the fan for this group: HIGH, MID1, MID2, LOW
g<n>.ventilation value operation status of the interlocked LOSSNAY or OA processing unit: HIGH, LOW, OFF
g<n>.prohibit.drive value power switching by remote control prohibition: ON, OFF
g<n>.prohibit.mode value mode changing by remote control prohibition: ON, OFF
g<n>.prohibit.settemp value temperature setting by remote control prohibition: ON, OFF
g<n>.prohibit.filter value filter signal reset by remote control prohibition: ON, OFF
g<n>.error visible true if the error state for this group is set, false otherwise
g<n>.filter visible true if the filter signal state for this group is set, false otherwise
a<m>.error visible true if an error is detected for the specified address, false if no error is signaled
a<m>.error value error code for the specified address
system.error visible true if an error is detected on any address, false otherwise

USER Commands

Name Param Action
<target>.power on turn the target on
off turn the target off
<target>.mode cool
dry
fan
heat
auto
air conditioner modes
heatrecovery
lcauto
bypass
LOSSNAY modes
<target>.temp 17 - 30 set the target temperature[Note 1]
up increase the target temperature by 1°C (if the upper limit is not reached)[Note 1]
down decrease the target temperature by 1°C (if the lower limit is not reached)[Note 1]
<target>.airdirection horizontal
mid1
mid2
vertical
swing
set the air direction of the target to the specified mode
g<n>.airdirection up change the air direction of this group according to the sequence: vertical - mid2 - mid1 - horizontal. If the current direction is set to swing, sets it to horizontal
down change the air direction of this group according to the sequence: horizontal - mid1 - mid2 - vertical. If the current direction is set to swing, set it to vertical
<target>.fanspeed high
mid1
mid2
low
set the fan speed of the target
g<n>.fanspeed up change the fan speed of this group according to the sequence: low - mid2 - mid1 - high
down change the fan speed of this group according to the sequence: low - mid2 - mid1 - high
<target>.ventilation high
low
off
set the operation status of the interlocked LOSSNAY or OA processing unit
<target>.reset error reset the error signal of the terget
filter reset the filter signal of the target
<target>.prohibit.drive on prohibit power switching by remote control
off allow power switching by remote control
<target>.prohibit.mode on prohibit mode setting by remote control
off allow mode setting by remote control
<target>.prohibit.settemp on prohibit temperature setting by remote control
off allow temperature setting by remote control
<target>.prohibit.filter on prohibit filter signal reset by remote control
off allow filter signal reset by remote control
g<n>.prohibit drive switch the state (on/off) of the drive prohibition for this group
mode switch the state (on/off) of the mode prohibition for this group
settemp switch the state (on/off) of the temperature setting prohibition for this group
filter switch the state (on/off) of the filter reset prohibition for this group

Release Notes

3.5.0

  • response timeout increased

3.4.0

  • bug fix: inlet temperature not working with decimal values

3.0.0

  • initial release version


Mitsubishi and M-NET are registered trademarks of MITSUBISHI ELECTRIC, Inc.