Difference between revisions of "Mitsubishi"

From HSYCO
Jump to navigation Jump to search
 
(18 intermediate revisions by 2 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 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.
  
 +
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 72:
  
 
== 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 130:
 
|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 243:
 
|-
 
|-
 
|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 394:
  
 
|}
 
|}
 +
 +
<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 424:
 
|-
 
|-
  
−
|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 599: Line 617:
 
|-
 
|-
  
−
|rowspan="2"|g<n>.prohibit
+
|rowspan="4"|g<n>.prohibit
 
|drive
 
|drive
 
|switch the state (on/off) of the drive prohibition for this group
 
|switch the state (on/off) of the drive prohibition for this group
Line 614: Line 632:
  
 
|}
 
|}
−
 
−
<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 “ecS” and the specified temperature parameter doesn’t respect the above mentioned ranges for a group, then the temperature is not changed for that group and an error message is logged.
 
−
</span>
 
  
 
== Release Notes ==
 
== Release Notes ==
−
=== 3.0 ===
+
=== 3.0.0 ===
−
*initial release versione
+
*initial release version
  
 
----
 
----

Latest revision as of 12:38, 28 March 2014

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.

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.0.0

  • initial release version


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

Retrieved from "http://wiki.hsyco.com/3.3.0/index.php?title=Mitsubishi&oldid=4545"