iRidium для Tion
Набор инструментов для создания интерфейсов управления оборудованием от производителей Tion.
документация обновлена 01.01.2024
Пример: Tion
iRidium для Tion - это набор инструментов, позволяющий создать интерфейс для управления климатическим оборудованием Tion.
iRidium для Tion позволяет панели управления (iOS, Android, Windows, Mac) подключиться к оборудованию через облако производителей Tion.
Рекомендуется использовать драйвер в серверном проекте.
Подключение
Для подключения к оборудованию Tion необходимо:
- Скачать мобильное приложение MagicAir (для iOS или Android). Приложение MagicAir доступно в Google Play и App Store;
- Зарегистрировать аккаунт. Логин и пароль от аккаунта MagicAir вы используете при добавлении драйвера в iRidium Studio;
- Инициировать базовую станцию MagicAir;
- Создать новое помещение и добавить в него станцию MagicAir;
- Добавить остальные устройства в помещение.
Принципы работы
iRidium Studio подключается к базовой станции Magic Air через облачный сервер Tion (по HTTP подключению) по логину и паролю Magic Air. После подключения вы можете управлять как отдельными климатическими устройствами, так и их совокупностью через станцию Magic Air. Станция передает команды оборудованию по радио частоте.

Работа в iRidium
Создайте новый проект и добавьте драйвер Tion Network с помощью сканера или ручным вводом данных.
Сканирование устройств
При сканировании устройств, iRidium Studio обращается к облаку производителя Tion - оно позволяет быстро добавить в проект iRidium все устройства Tion с преднастроенными для них командами.
- В созданном проекте нажмите клавишу Scan > Tion network scanner в окне DEVICES:

- Укажите логин и пароль от аккаунта MagicAir:

Если сканер не находит оборудование, то вы можете прописать данные настройки драйвера вручную:
Настройка драйвера
- В созданном проекте на вкладке DEVICES добавьте драйвер Tion Network:

- Укажите настройки подключения драйвера:

- Log Level - уровень логирования;
- Host - адрес для работы с облачным сервисом Tion (api2.magicair.tion.ru);
- Login / Password - логин и пароль от аккаунта MagicAir;
- SSL - тип шифрования (облако tion поддерживает SSL v2.3);
- Keep Alive - время удержания соединения в милисекундах.
- Щелкните ЛКМ по добавленному драйверу Tion Network и добавьте необходимые устройства. Каждое устройство имеет предустановленный список команд и фидбеков в соответствии со своим типом.

Настройка команд и фидбеков

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).
Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".
У команд и фидбеков устройств Tion нет настроек. Они заранее фиксировано создаются при добавлении устройства. Добавлять команды или изменить их тип нельзя. Управление происходит посредством отправки value в команду (Send number, Send string, send value from object). В зависимости от модели оборудования, какие-то команды могут не работать.
Zone sensors
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| СО2 target | 500-1500 int | Значение СО2, к которому будет стремиться оборудование в этой зоне. |
| Mode | "unknown", "off", "manual", "auto". | Выбор режима работы MagicAir в зоне. |
| ModeInt | 0 - unknown, 1 - off, 2 - manual, 3 - auto. | Выбор режима работы MagicAir в зоне. |
| Feedback : | ||
| СО2 | value | Текущее значение СО2. |
| СО2 target | value | Целевое значение СО2. |
| Temperature | value | Текущее значение температуры. |
| Humidity | value | Текущее значение влажности. |
| Mode | "unknown", "off", "manual", "auto". | Текущий режим работы MagicAir в этой зоне. |
| ModeInt | 0 - unknown, 1 - off, 2 - manual, 3 - auto. | Текущий режим работы MagicAir в этой зоне. |
Magic Air
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| СО2 target | 500-1500 int | Значение СО2, к которому будет стремиться оборудование. |
| Mode | "unknown", "off", "manual", "auto". | Выбор режима работы MagicAir в зоне расположения MagicAir. |
| ModeInt | 0 - unknown, 1 - off, 2 - manual, 3 - auto. | Выбор режима работы MagicAir в зоне расположения MagicAir. |
| Feedback : | ||
| СО2 | value | Текущее значение СО2. |
| СО2 target | value | Целевое значение СО2. |
| Temperature | value | Текущее значение температуры. |
| Humidity | value | Текущее значение влажности. |
| Mode | "unknown", "off", "manual", "auto". | Текущий режим работы MagicAir. |
| ModeInt | 0 - unknown, 1 - off, 2 - manual, 3 - auto. | Текущий режим работы MagicAir в этой зоне. |
Tion Breezer 3S
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| On/Off | 0-1 | Включить / выключить бризер. |
| Speed | 1-6 | Переключение скорости бризера. |
| MinSpeed | 1-6 | Выставить минимальную скорость работы бризера. |
| MaxSpeed | 1-6 | Выставить максимальную скорость работы бризера. |
| Set Temperature | 0-30 | Выставить целевую температуру нагрева воздуха. |
| HeaterEnable | 0-1 | Включение / выключение нагрева воздуха. * Работает только при включенном заборе воздуха с улицы. |
| Gate | 0 - из комнаты, 1 - смешанный режим, 2 - с улицы. | Переключение режимов забора воздуха. |
| Feedback : | ||
| IsOn | 0-1 | Состояние включенности оборудования. |
| Speed | 1-6 | Текущая скорость работы бризера. |
| MinSpeed | 1-6 | Текущая выставленная минимальная скорость работы. |
| MaxSpeed | 1-6 | Текущая выставленная максимальная скорость работы. |
| Target temperature | 0-30 | Целевая температуру нагрева воздуха. |
| HeaterEnabled | 0-1 | Включение / выключение нагрева воздуха. * Работает только при включенном заборе воздуха с улицы. |
| Gate | 0 - из комнаты, 1 - смешанный режим, 2 - с улицы. | Режим забора воздуха. |
Breezer 4
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| On/Off | 0-1 | Включить/выключить бризер. |
| Speed | 1-6 | Переключение скорости бризера. |
| MinSpeed | 1-6 | Выставить минимальную скорость работы бризера. |
| MaxSpeed | 1-6 | Выставить максимальную скорость работы бризера. |
| Set Temperature | 0-30 | Выставить целевую температуру нагрева воздуха. |
| HeaterMode | "heat", "maintenance". | Режим работы нагрева воздуха. |
| HeaterModeInt | 0 - unknown, 1 - heat, 2 - maintenance | Режим работы нагрева воздуха. |
| Gate | 0 - из комнаты, 1 - смешанный режим, 2 - с улицы | Переключение режимов забора воздуха. |
| Feedback : | ||
| IsOn | 0-1 | Состояние включенности оборудования. |
| Speed | 1-6 | Текущая скорость работы бризера. |
| MinSpeed | 1-6 | Текущая выставленная минимальная скорость работы. |
| MaxSpeed | 1-6 | Текущая выставленная максимальная скорость работы. |
| Target temperature | 0-30 | Целевая температуру нагрева воздуха. |
| HeaterMode | "heat", "maintenance" | Режим работы нагрева воздуха. |
| HeaterModeInt | 0 - unknown, 1 - heat, 2 - maintenance | Режим работы нагрева воздуха. |
| Gate | 0 - из комнаты, 1 - смешанный режим, 2 - с улицы. | Режим забора воздуха. |
BreezerTionO2MAC
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| On/Off | 0-1 | Включить/выключить бризер. |
| Speed | 1-6 | Переключение скорости бризера. |
| MinSpeed | 1-6 | Выставить минимальную скорость работы бризера. |
| MaxSpeed | 1-6 | Выставить максимальную скорость работы бризера. |
| Set Temperature | 0-30 | Выставить целевую температуру нагрева воздуха. |
| HeaterEnable | 0-1 | Включение / выключение нагрева воздуха. |
| Feedback : | ||
| IsOn | 0-1 | Состояние включенности оборудования. |
| Speed | 1-6 | Текущая скорость работы бризера. |
| MinSpeed | 1-6 | Текущая выставленная минимальная скорость работы. |
| MaxSpeed | 1-6 | Текущая выставленная максимальная скорость работы. |
| Target temperature | 0-30 | Целевая температуру нагрева воздуха. |
| HeaterEnabled | 0-1 | Включение / выключение нагрева воздуха. |
DanfosECO2Thermostat
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| Set Temperature | 5-28 (шаг 0,5) | Выставить целевую температуру. |
| Feedback : | ||
| Target temperature | value | Целевая температура. |
TionClever
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| On/Off | 0-1 | Включить / выключить бризер. |
| Speed | 1-2 | Переключение скорости бризера. |
| Feedback : | ||
| IsOn | 0-1 | Состояние включенности оборудования. |
| Speed | value | Текущая скорость работы бризера. |
UniversalConditioner
| Команда / фидбек | Входные / ожидаемые значения | Описание |
|---|---|---|
| Command : | ||
| On/Off | 0-1 | Включить/выключить кондиционер. |
| Mode | "auto", "cool", "heat", "dry", "fan". | Выбор режима работы кондиционера. * Набор режимов зависит от конкретной модели кондиционера. |
| ModeInt | 0 - unknown, 1 - auto, 2 - cool, 3 - heat, 4 - dry, 5 - fan | Выбор режима работы кондиционера. * Набор режимов зависит от конкретной модели кондиционера. |
| Speed | 0-n | Переключение скорости кондиционера. * Набор скоростей зависит как от модели, так и от режима работы. |
| Set Temperature | 16-32 | Выставить целевую температуру. * Зависит от режима и от модели кондиционера. |
| Set Lamella Vertical | -2 - шаг, -1 - включение качания, 0 - выключение качания, 1...n - положение. | Изменение потока воздуха в вертикальном направлении. |
| Set Lamella Horizontal | -2 - шаг, -1 - включение качания, 0 - выключение качания, 1...n - положение. | Изменение потока воздуха в горизонтальном направлении. |
| Feedback : | ||
| IsOn | 0-1 | Состояние включенности оборудования. |
| Mode | auto, cool, heat, dry, fan. | Текущий режим работы. * Набор режимов зависит от конкретной модели кондиционера. |
| ModeInt | 0 - unknown, 1 - auto, 2 - cool, 3 - heat, 4 - dry, 5 - fan | Текущий режим работы кондиционера. * Набор режимов зависит от конкретной модели кондиционера. |
| Speed | value | Текущая скорость работы кондиционера. |
| Target temperature | value | Целевая температура. |
| LamellaVertical | -2 - шаг, -1 - включение качания, 0 - выключение качания, 1...n - положение. | Текущее направление потока воздуха в вертикальном направлении. |
| LamellaHorizontal | -2 - шаг, -1 - включение качания, 0 - выключение качания, 1...n - положение. | Текущее направление потока воздуха в горизонтальном направлении. |