Эта страница является
переводом страницы
Tion. Перевод выполнен на 100%.
iRidium for Tion
a set of tools to create control interfaces for equipment by Tion.
The documentation was updated on 14.10.2022
Description
iRidium for Tion is a set of tools that allow to create an interface to control Tion climate equipment.
iRidium for Tion allows control panels (iOS, Android, Windows, Mac) to connect to equipment via a cloud by Tion.
We recomment using the driver in a server project.
Connection
To connect to Tion equipment, do the following:
1 Download the MagicAir app (for iOS or Android). The MagicAir app is available in Google Play and App Store;
2 Register an account. You will use the login and password of the MagicAir account when adding Tion driver in iRidium Studio;
3 Initiate MagicAir basic station;
4 Create a new room and add MagicAir station to it;
5 Add other devices to the room.
You can read detailed information about setting equipment and connecting to it in the official Tion documentation.
Operation Principles
iRidium Studio connects to the Magic Air basic station via Tion cloud service (using HTTP connection) with Magic Air login and password.
After connection you can control separate climate devices and several of them via Magic Air station. The station sends commands to equipment via a radio frequency.
Work in iRidium
Create a new project and add Tion Network driver to it with the help of a scanner or entering data manually.
Scanning devices
During scanning iRidium Studio connects to Tion cloud and it allows to add to a project all Tion devices with preset commands.
1 Click Scan in a created project then click Tion network scanner in the DEVICES window.
2 Enter the login and password of MagicAir account.
If the scanner can't find equipment, you can enter the driver settings manually:
Setting Driver
1 Add Tion Network driver in the DEVICES tab to a created project.
2 Enter the driver connection settings:
- Log Level - the level of logging;
- Host - the address to work with Tion cloud service (api2.magicair.tion.ru);
- Login / Password - the login and password of MagicAir account;
- SSL - the type of encrypting (Tion cloud supports SSL v2.3);
- Keep Alive - connection holding time in milliseconds.
3 Click left mouse button on the added Tion Network driver and add required devices. Each device has a preset list of commands and feedback channels according to its type.
Setting Commands and Feedback Channels
To control equipment it is required to set commands (Commands) and feedback channels (Feedbacks). To send a command, drag'n'drop it on a graphic item and enter a value to send. To display feedback drag'n'drop a feedback channel on a graphic item and choose how to output or display a value.
Read more about work with graphic items in the
"Types of graphic items" article.
Tion commands and feedback channels have no settings. They are preset when a device is added. Commands can't be added and their types can't be changed. A device is controlled by sending a value to a command (Send number, Send string, send value from object). Depending on the model of equipment some commands may not work.
Zone sensors
| Command / Feedback |
Input / expected values |
Description
|
| Command: |
|
|
| СО2 target |
500-1500 int |
СО2 value that equipment in this zone will try to reach.
|
| Mode |
"unknown",
"off",
"manual",
"auto". |
Selection of a work mode for MagicAir in a zone.
|
| ModeInt |
0 - unknown,
1 - off,
2 - manual,
3 - auto. |
Selection of a work mode for MagicAir in a zone.
|
| Feedback: |
|
|
| СО2 |
value |
Current СО2 value.
|
| СО2 target |
value |
Target СО2 value.
|
| Temperature |
value |
Current temperature value
|
| Humidity |
value |
Current humidity value.
|
| Mode |
"unknown",
"off",
"manual",
"auto". |
Current work mode of MagicAir in this zone.
|
| ModeInt |
0 - unknown,
1 - off,
2 - manual,
3 - auto. |
Current work mode of MagicAir in this zone.
|
Magic Air
| Command/ Feedback |
Input / expected values |
Description
|
| Command: |
|
|
| СО2 target |
500-1500 int |
СО2 value the equipment will try to reach.
|
| Mode |
off,
manual,
auto,
unknown. |
Selection of a work mode for MagicAir.
|
| ModeInt |
0 - unknown,
1 - off,
2 - manual,
3 - auto. |
Selection of a work mode for MagicAir.
|
| Feedback: |
|
|
| СО2 |
value |
Current СО2 value.
|
| СО2 target |
value |
Target СО2 value.
|
| Temperature |
value |
Current temperature value.
|
| Humidity |
value |
Current humidity value.
|
| Mode |
"unknown",
"off",
"manual",
"auto". |
The current work mode of MagicAir.
|
| ModeInt |
0 - unknown,
1 - off,
2 - manual,
3 - auto. |
The current work mode of MagicAir in this zone.
|
Tion Breezer 3S
| Command / feedback |
Input / expected values |
Description
|
| Command: |
|
|
| On/Off |
0-1 |
Turn on / off breezer.
|
| Speed |
1-6 |
Switching breezer speed.
|
| MinSpeed |
1-6 |
Set the min speed of breezer.
|
| MaxSpeed |
1-6 |
Set the max speed of breezer.
|
| Set Temperature |
0-30 |
Set a required temperature of air heating.
|
| HeaterEnable |
0-1 |
Turn on / off air heating.
It works only if the intake of air from outside is on.
|
| Gate |
0 - from room,
1 - mixed mode,
2 - from outside. |
Switching modes of air intake.
|
| Feedback: |
|
|
| IsOn |
0-1 |
The on state of equipment.
|
| Speed |
1-6 |
The current speed of breezer work.
|
| MinSpeed |
1-6 |
The current set min speed of work.
|
| MaxSpeed |
1-6 |
The current set max speed of work.
|
| Target temperature |
0-30 |
The required temperature of air heating.
|
| HeaterEnabled |
0-1 |
Turn on / off air heating.
It works only if the intake of air from outside is on.
|
| Gate |
0 - from room,
1 - mixed mode,
2 - from outside. |
Mode of air intake.
|
Breezer 4
| Command / feedback |
Input / expected values |
Description
|
| Command: |
|
|
| On/Off |
0-1 |
Turn on/off breezer.
|
| Speed |
1-6 |
Switching breezer speed.
|
| MinSpeed |
1-6 |
Set the min speed of breezer work.
|
| MaxSpeed |
1-6 |
Set the max speed of breezer work.
|
| Set Temperature |
0-30 |
Set a required temperature of air heating.
|
| HeaterMode |
"heat",
"maintenance". |
Work mode to hear air.
|
| HeaterModeInt |
0 - unknown,
1 - heat,
2 - maintenance |
Work mode to heat air.
|
| Gate |
0 - from room,
1 - mixed mode,
2 - from outside |
Switching modes of air intake.
|
| Feedback: |
|
|
| IsOn |
0-1 |
The on state of equipment.
|
| Speed |
1-6 |
The current work speed of breezer.
|
| MinSpeed |
1-6 |
The current set min speed of work.
|
| MaxSpeed |
1-6 |
The current set max speed of work.
|
| Target temperature |
0-30 |
The required temperature of air heating.
|
| HeaterMode |
"heat",
"maintenance" |
Work mode to heat air.
|
| HeaterModeInt |
0 - unknown,
1 - heat,
2 - maintenance |
Work mode to heat air.
|
| Gate |
0 - from room,
1 - mixed mode,
2 - from outside. |
Mode of air intake.
|
BreezerTionO2MAC
| Command / feedback |
Input / expected values |
Description
|
| Command: |
|
|
| On/Off |
0-1 |
Turn on / off breezer.
|
| Speed |
1-6 |
Switching breezer speed.
|
| MinSpeed |
1-6 |
Set the min speed of breezer work
|
| MaxSpeed |
1-6 |
Set the max speed of breezer work.
|
| Set Temperature |
0-30 |
Set a required temperature of air heating.
|
| HeaterEnable |
0-1 |
Turn on / off air heating.
|
| Feedback: |
|
|
| IsOn |
0-1 |
The on state of equipment.
|
| Speed |
1-6 |
The current speed of breezer work.
|
| MinSpeed |
1-6 |
The current set min speed of work.
|
| MaxSpeed |
1-6 |
The current set max speed of work.
|
| Target temperature |
0-30 |
The required temperature of air heating.
|
| HeaterEnabled |
0-1 |
Turn on / off air heating.
|
DanfosECO2Thermostat
| Command / Feedback |
Input / expected values |
Description
|
| Command: |
|
|
| Set Temperature |
5-28 (0,5 step) |
Set a required temperature.
|
| Feedback: |
|
|
| Target temperature |
value |
Required temperature
|
TionClever
| Command / feedback |
Input / оexpected values |
Description
|
| Command: |
|
|
| On/Off |
0-1 |
Turn on / off breezer.
|
| Speed |
1-2 |
Switching breezer speed.
|
| Feedback: |
|
|
| IsOn |
0-1 |
The on state of equipment.
|
| Speed |
value |
The current speed of breezer work.
|
UniversalConditioner
| Command / feedback |
Input / expected values |
Description
|
| Command: |
|
|
| On/Off |
0-1 |
Turn on/off breezer.
|
| Mode |
auto,
cool,
heat,
dry,
fan. |
Selection of a work mode of the air conditioner.
A set of modes depends on the model of an air conditioner.
|
| ModeInt |
0 - unknown,
1 - auto,
2 - cool,
3 - heat,
4 - dry,
5 - fan |
Selection of a work mode of the air conditioner.
A set of modes depends on the model of an air conditioner.
|
| Speed |
0-n |
Switching the the speed of a conditionder.
A set of speeds depends on the model and on the selected work mode of a conditioner.
|
| Set Temperature |
16-32 |
Set a required temperature.
It depends on the model and the mode of a conditioner.
|
| Set Lamella Vertical |
-2 - step,
-1 - turn on flap swinging,
0 - turn off flap swinging,
1...n - position. |
Changing the vertical direction of the air flow.
|
| Set Lamella Horizontal |
-2 - step,
-1 - turn on flap swinging,
0 - turn off flap swinging,
1...n - position. |
Changing the horizontal direction of the air flow.
|
| Feedback: |
|
|
| IsOn |
0-1 |
The on state of the equipment.
|
| Mode |
auto,
cool,
heat,
dry,
fan. |
The current work mode.
A set of modes depends on the model of an air conditioner.
|
| ModeInt |
0 - unknown, 1 - auto, 2 - cool, 3 - heat, 4 - dry, 5 - fan |
The current work mode.
A set of modes depends on the model of an air conditioner.
|
| Speed |
value |
The current work speed of the conditioner.
|
| Target temperature |
value |
A required temperature
|
| LamellaVertical |
-2 - step,
-1 - turn on flap swinging,
0 - turn off flap swinging,
1...n - position. |
The current vertical direction of the air flow.
|
| LamellaHorizontal |
-2 - step,
-1 - turn on flap swinging,
0 - turn off flap swinging,
1...n - position. |
The current horizontal direction of the air flow.
|
