Difference between revisions of "Mitsubishi"
(25 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | The | + | 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]] | ||
− | == | + | == 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: | |
− | |||
− | + | [[File:IOServer_Mitsubishi_Architecture.png|600px|border]] | |
− | + | 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 [[Settings#I/O Servers|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 === | === Options === | ||
Line 63: | Line 80: | ||
== Datapoints == | == Datapoints == | ||
− | In the following | + | 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 | + | |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 | + | |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 == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== UISET Actions === | === UISET Actions === | ||
Line 406: | Line 432: | ||
|- | |- | ||
− | | | + | |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 625: | ||
|- | |- | ||
− | |rowspan=" | + | |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 615: | Line 641: | ||
|} | |} | ||
− | + | == Release Notes == | |
− | + | ||
− | + | === 3.5.0=== | |
− | * | + | *response timeout increased |
− | + | ||
− | * | + | === 3.4.0=== |
− | + | *bug fix: inlet temperature not working with decimal values | |
− | |||
− | + | === 3.0.0 === | |
− | === 3.0 === | + | *initial release version |
− | *initial release | ||
---- | ---- |
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.
Contents
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:
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.