Перейти к основному содержимому

iRidium для Nest

Набор инструментов для создания интерфейсов управления оборудованием от производителей Nest.

примечание
  • Драйвер только для серверного проекта.

документация обновлена 01.01.2024

iRidium для Nest - это набор инструментов, позволяющий создать интерфейс для управления оборудованием Nest. Облачный драйвер общается с оборудованием посредством HTTP запросов.

Подключение

Для подключения к оборудованию Nest:

  1. Настройте Google аккаунт на работу с оборудованием Nest.

  2. Создайте облачный объект для вашего проекта iRidium Pro.

  3. Перейдите по ссылке и авторизуйтесь под вашим аккаунтом iRidium.

  4. Выберите Connect (Установить) для драйвера Nest.

IR_assistant_nest_connect.png

  1. Примите разрешение на просмотр и использование данных о вашем доме из приложения Google Home.

  2. Выберите необходимый объект на облаке iRidium.

IR_assistant_choose_object.png

  1. Нажмите Link (Связать). Обратите внимание, что сессия для связывания может истечь, в таком случае вы получите ошибку invalid_grant / Bad Request , следует вернуться к пункту 4 и повторить последующие шаги.

IR_assistant_nest_connect_2.png

  1. Скачайте JS файл со структурой драйвера. Ниже мы можем видеть актуальный токен OAuth2.0 для доступа к оборудованию. Этот токен заменяет обычную авторизацию.

Download_json.png

  1. Импортируйте скачанный JS файл в iRidium Studio.

  2. Загрузите ваш проект с драйвером Nest на объект облака iRidium.

Важно

Так как драйвер облачный, он работает только при запуске проекта с облака.

В случае, если токен авторизации стал неактуален:

  1. Перейдите по ссылке.

  2. Нажмите Issued tokens (Выданные токены).

  3. Выберите объект i3pro с привязанным аккаунтом Google и Nest оборудованием.

  4. Синхронизируйте токен и нажмите Devices and structures (Устройства и структура).

  5. Скопируйте токен доступа.

  6. Можете обновить токен в проекте через настройки драйвера в iRidium Studio (после этого необходимо обновить проект на облаке) или ввести новый токен в настройках устройств в веб-интерфейсе сервера.

Работа в iRidium

Создайте новый проект и добавьте драйвер Nest Network с помощью импорта или ручным вводом данных.

Импорт данных

Чтобы импортировать команды и каналы обратной связи оборудования из JS проекта:

  1. Запустите iRidium studio, создайте проект и откройте боковую панель Devices .

Nest1.png

  1. Во вкладке Scanner / Import выберите **Universal import from JS (.js, .json) и откройте файл проекта.

Nest2.png

Добавление драйвера вручную

  1. В созданном проекте на вкладке Devices добавьте драйвер Nest Network :

Nest3.png

  1. Нажатием ЛКМ по драйверу добавьте подустройство (Add subdevice ) и укажите настройки подключения драйвера:

Nest4.png

  • Log Level - уровень логирования;
  • Token - токен авторизации OAuth2.0 (подставляется автоматически при импорте).
  • Driver Version - версия драйвера.

Nest5.png

  • Name - имя подустройства;
  • Driver Type - тип драйвера;
  • Subdevice ID - идентификатор подустройства;
  • Device Type - тип подустройства.

Устройства

У команд и фидбеков устройств Nest нет специфических настроек. Они заранее фиксировано создаются при добавлении устройства. Управление оборудованием происходит посредством отправки value в команду (Send number, Send string, send value from object).

Thermostat

Command:

Команда / фидбекЗначениеОписание
Mode OffValueВыбор режима — выключить
HeatValueВыбор режима — нагрев
CoolValueВыбор режима — охлаждение
HeatCoolValueВыбор режима — нагрев-охлаждение
Heat Temperature9–32Целевая температура нагрева
Cool Temperature9–32Целевая температура охлаждения
HeatCool Low Temperature9–32Нижний температурный предел для режима нагрев-охлаждение
HeatCool High Temperature9–32Верхний температурный предел для режима нагрев-охлаждение
Eco Mode OnValueВключить режим эко
Eco Mode OffValueВыключить режим эко
Fan Timer OnValueВключить вентиляцию на срок в минутах
Fan Timer OffValueОтключить вентиляцию

Feedback:

Команда / фидбекЗначениеОписание
ModeOff
Heat
Cool
HeatCool
Текущий режим
HVAC"OFF"
"HEATING"
"COOLING"
Текущее состояние работы устройства
Eco Mode0–1Текущий режим эко: 1 — режим manual eco, 0 — выключен
Eco HeatValueТемпература, при которой будет работать обогрев в режиме эко
Eco CoolValueТемпература, при которой будет работать охлаждение в режиме эко
Temperature Heat9–32Текущая целевая температура нагрева
Temperature Cool9–32Текущая целевая температура охлаждения
Temperature HeatCool High9–32Текущий заданный верхний температурный предел для режима нагрев-охлаждение
Temperature HeatCool Low9–32Текущий заданный нижний температурный предел для режима нагрев-охлаждение
Connectivity0–1Подключение термостата: 1 — включен, 0 — выключен
Fan Mode"on / off"Текущее состояние вентиляции: on — включена, off — выключена
Fan Timer TimeoutValueВремя истечения таймера работы вентиляции
Humidity0–100Текущая влажность (%)
Info"Thermostat"Имя устройства в приложении Nest
Settings"CELSIUS"Единица измерения температуры: CELSIUS — цельсии, FAHRENHEIT — фаренгейты
Ambient TemperatureValueТекущая температура