https://github.com/break-pointer/homebridge-tion

Homebridge plugin to control Tion breezers
https://github.com/break-pointer/homebridge-tion

3s airpurifier breezer co2 homebridge homebridge-plugin humidity magicair o2 sensor smarthome temperature tion

Last synced: 3 months ago
JSON representation

Homebridge plugin to control Tion breezers

• Host: GitHub
• URL: https://github.com/break-pointer/homebridge-tion
• Owner: break-pointer
• License: mit
• Created: 2019-09-07T13:33:08.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-06-18T09:37:27.000Z (over 1 year ago)
• Last Synced: 2025-08-04T21:19:40.989Z (5 months ago)
• Topics: 3s, airpurifier, breezer, co2, homebridge, homebridge-plugin, humidity, magicair, o2, sensor, smarthome, temperature, tion
• Language: TypeScript
• Size: 4.31 MB
• Stars: 36
• Watchers: 6
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# homebridge-tion

[![NPM](https://nodei.co/npm/homebridge-tion.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/homebridge-tion/)

[![npm](https://img.shields.io/npm/dm/homebridge-tion.svg)](https://www.npmjs.com/package/homebridge-tion)

[![npm](https://img.shields.io/npm/v/homebridge-tion.svg)](https://www.npmjs.com/package/homebridge-tion)

Плагин для [Homebridge](https://github.com/nfarina/homebridge), позволяющий управлять климатической техникой [Tion](https://tion.ru/product/magicair/) (базовой станций MagicAir, бризерами 3S и O2).

## Поддерживаемые устройства

| Модель |

|--------|

| [Базовая станция MagicAir](https://tion.ru/product/magicair/) |

| [Бризер Тион 4S](https://tion.ru/product/breezer-tion-4s/) |

| [Бризер Тион 3S](https://tion.ru/product/breezer-tion-3s/) |

| [Бризер Тион O2](https://tion.ru/product/breezer-tion-o2/) |

| [Модуль CO2](https://tion.ru/product/co2plus/) |

Для устройств, которых нет в списке, поддержка пока не реализована. Если вы хотите добавить поддержку новых устройства, свяжитесь со мной или предложите pull-request.

## Функции

- управление бризером (вкл/выкл, скорость, нагрев, температура, рециркуляция)

- мониторинг состояния фильтра бризера

- мониторинг качества воздуха (уровень CO2, температура, влажность)

- управление подсветкой базовой станции

- сигнализация превышения допустимого уровня CO2

- мониторинг температуры уличного воздуха

| ![Демо](docs/homekit-demo.png) | ![Демо](docs/homekit-demo1.png) | ![Демо](docs/homekit-demo2.png) |

| ------------------------------------------- | ------------------------------------------- | -------------------------------------------- |

| ![Демо](docs/homekit-demo3.png) | ![Демо](docs/homekit-demo4.png) |

## Установка

0. Настройте базовую станцию:

   Из [веб-интерфейса](https://magicair.tion.ru) или из приложения для [iOS](https://apps.apple.com/ru/app/magicair/id1111104830) или [Android](https://play.google.com/store/apps/details?id=com.tion.magicair)

1. Если у вас уже есть [Config UI X](https://github.com/oznu/homebridge-config-ui-x), рекомендую устанавливать и конфигурировать плагин с его помощью, а дальнейшие шаги можно пропустить.

   ![Настройки](docs/homebridge-tion-page.png)

2. Установите плагин:

    ```shell

    $ npm install -g homebridge-tion --production

    ```

3. Обновите конфигурацию Homebridge:

   Добавьте в секцию `platforms` следующую запись (см. описание полей ниже):

    ```json

    "platforms": [

        {

            "platform": "Tion",

            "name": "Tion",

            "homeName": ИМЯ_ДОМА_В_MAGICAIR_В_ДВОЙНЫХ_КАВЫЧКАХ,

            "userName": ИМЯ_ПОЛЬЗОВАТЕЛЯ_В_MAGICAIR_В_ДВОЙНЫХ_КАВЫЧКАХ,

            "password": ПАРОЛЬ_В_MAGICAIR_В_ДВОЙНЫХ_КАВЫЧКАХ

        }

    ]

    ```

4. Перезапустите Homebridge

   

## Конфигурация

| Поле | Тип | Описание | Обязательно поле | Значение по-умолчанию |

|--------|------|-------------|----------|---------------|

| `name` | `string` | Имя плагина в Homebridge | Да | `Tion` |

| `homeName` | `string` | Имя дома в MagicAir. Если у вас один дом в MagicAir, оставьте это поле пустым. Если у вас несколько домов, укажите имя дома в MagicAir, приборами в котором вы хотите управлять. | Нет |  |

| `userName` | `string` | Имя пользователя в MagicAir | Да |  |

| `password` | `string` | Пароль в MagicAir | Да |  |

| `co2Threshold` | `number` | Уровень CO2 (ppm), выше которого будет сигнализировать датчик CO2 в Homekit | Нет | `800` |

| `percentSpeed` | `boolean` | Задаёт вид регулировки скорости бризера в процентах (0-100%, как принято в Homekit) или фиксированными значениями (1-4, 1-6, как принято в MagicAir) | Нет | `false` |

| `apiRequestTimeout` | `number` | Таймаут (мс), по истечении которого запрос к серверу MagicAir принудительно завершается с ошибкой | Нет | `1500` |

## Todo

- [ ] связь с базовой станцией напрямую (локальный режим)

## Disclaimer

> Плагин не является заменой официального приложения MagicAir. 

> Я не имею никакого отношения к компании Tion.

> Мне просто нравится климатическая техника Tion и хочется качественного UX с моими устройствами Apple.

## Автор

Илья Рузаков

[t.me/break-pointer](https://t.me/break-pointer)