Перейти к содержанию

Как добавить нестандартное устройство в проект🔗

В T-Studio есть большая библиотека инженерных объектов, которые можно добавлять в проект. Это объекты систем освещения, вентиляции, видеонаблюдения и других систем.

Иногда при проектировании может возникнуть ситуация, когда нужно добавить какое-то устройство, которого нет в библиотеке. В таком случае вы можете выбрать один из универсальных инженерных объектов и с его помощью реализовать устройство в проекте.

К универсальным инженерным объектам относятся:

  • индикатор;
  • кнопка;
  • селектор;
  • регулятор;
  • портал;
  • дашборд.

Порядок действий при добавлении устройства🔗

  1. Проектировщик и инженер обсуждают задачу и определяют технические детали: какой универсальный инженерный объект подойдет для устройства и какие параметры ему задать.
  2. Проектировщик создает в T-Studio универсальный инженерный объект и сохраняет прошивку.
  3. Инженер загружает новую прошивку проекта на контроллер. Теперь инженерный объект доступен в брокере, к нему можно привязать скрипт, который будет связывать конечное устройство и инженерный объект.
  4. Инженер пишет скрипт и проверяет работу инженерного объекта в приложении.

Кратко об инженерных объектах🔗

Индикатор — устройство, которое отображает изменения какого-либо параметра контролируемого процесса или состояния. Подходит для различных датчиков, счетчиков и других устройств, которые используются для мониторинга показателей.

Кнопка — элементарное устройство для передачи сигнала различным устройствам. Подходит для аварийных кнопок, кнопок вызова лифта и т. д.

Селектор — устройство, с помощью которого можно выбрать тот или иной режим работы связанного оборудования. Принцип работы похож на кнопку, но вариантов больше. Подходит для кнопочных панелей, встроенных пресетов устройства (например, кондиционера) и т. д.

Регулятор — устройство, которое регулирует значение параметра контролируемого процесса. Подходит для регуляторов громкости, скорости, температуры и т. д.

Портал — ссылка на другой проект. Подробнее

Дашборд — инженерный объект, который представляет собой ссылку на сторонний скрипт или сайт. Подробнее

Как добавить объект в T-Studio🔗

Чтобы добавить объект в T-Studio, отрисуйте его в эскизном файле. Затем загрузите новый эскиз в нужный проект и настройте объект.

  1. В панели Конечное оборудование нажмите + и выберите Универсальные объекты → Индикатор.
  2. Укажите метку, которой обозначен объект в эскизном файле, и метку локации. Если метку не нужно показывать в клиентском приложении, отметьте флаг Скрывать метку.
  3. Введите название индикатора.
  4. Введите заголовок индикатора. Заголовок будет отображаться в клиентском приложении.
  5. Если необходимо, выберите подсистему, к которой относится объект. Если вы выберете подсистему, то индикатор по умолчанию будет такого же цвета, как другие объекты этой подсистемы.
  6. По желанию настройте внешний вид индикатора:
    • В поле Поверхности нажмите +.
    • В поле Подпись введите букву поверхности, которую хотите настроить. По умолчанию все инженерные объекты состоят минимум из одной поверхности S.
    • Укажите цвет заливки и контура. Если необходимо, отметьте флагами параметры Применять освещение и Рисовать в глубину.
    • Таким же образом добавьте другие поверхности, если необходимо.
    • Сохраните изменения.
  7. Настройте метрики, которые будет отображать индикатор:
    • В поле Метрики нажмите +.
    • Введите идентификатор метрики (например, Power), её название (например, Мощность) и единицы измерения. При необходимости укажите цвет для метрики и шаблон для демо-режима (значение, которое будет в нем отображаться).
    • Таким же образом добавьте другие метрики, если необходимо.
    • Сохраните изменения.
  1. В панели Конечное оборудование нажмите + и выберите Универсальные объекты → Кнопка.
  2. Укажите метку, которой обозначена кнопка в эскизном файле, и метку локации. Если метку не нужно показывать в клиентском приложении, отметьте флаг Скрывать метку.
  3. Введите название кнопки.
  4. Введите заголовок кнопки, который будет отображаться в клиентском приложении.
  5. Если необходимо, выберите подсистему, к которой относится кнопка. Если вы выберете подсистему, то кнопка по умолчанию будет такого же цвета, как другие объекты этой подсистемы.
  6. По желанию настройте внешний вид кнопки:
    • В поле Поверхности нажмите +.
    • В поле Подпись введите букву поверхности, которую хотите настроить. По умолчанию все инженерные объекты состоят минимум из одной поверхности S.
    • Укажите цвет заливки и контура. Если необходимо, отметьте флагами параметры Применять освещение и Рисовать в глубину.
    • Таким же образом добавьте другие поверхности, если необходимо.
    • Сохраните изменения.
  7. Задайте параметры визуализации кнопки во включенном и выключенном состоянии. Для этого укажите название состояния и цвет — они будут отображаться в приложении.
  8. Если необходимо, чтобы действия с кнопкой можно было добавлять в расписание, отметьте флагом параметр Расписание.
  1. В панели Конечное оборудование нажмите + и выберите Универсальные объекты → Селектор.
  2. Укажите метку, которой обозначен селектор в эскизном файле, и метку локации. Если метку не нужно показывать в клиентском приложении, отметьте флаг Скрывать метку.
  3. Введите название селектора.
  4. Введите заголовок селектора, который будет отображаться в клиентском приложении.
  5. Если необходимо, выберите подсистему, к которой относится селектор. Если вы выберете подсистему, то селектор по умолчанию будет такого же цвета, как другие объекты этой подсистемы.
  6. По желанию настройте внешний вид селектора:
    • В поле Поверхности нажмите +.
    • В поле Подпись введите букву поверхности, которую хотите настроить. По умолчанию все инженерные объекты состоят минимум из одной поверхности S.
    • Укажите цвет заливки и контура. Если необходимо, отметьте флагами параметры Применять освещение и Рисовать в глубину.
    • Таким же образом добавьте другие поверхности, если необходимо.
    • Сохраните изменения.
  7. Настройте режимы, которые можно будет задавать с помощью селектора:
    • В поле Режимы нажмите +.
    • Введите идентификатор режима (например, Hot), его название (например, Горячий) и выберите цвет.
    • Таким же образом добавьте другие режимы, если необходимо.
    • Сохраните изменения.
  8. Если необходимо, чтобы действия с селектором можно было добавлять в расписание, отметьте флагом параметр Расписание.
  1. В панели Конечное оборудование нажмите + и выберите Универсальные объекты → Регулятор.
  2. Укажите метку, которой обозначен регулятор в эскизном файле, и метку локации. Если метку не нужно показывать в клиентском приложении, отметьте флаг Скрывать метку.
  3. Введите название регулятора.
  4. Введите заголовок регулятора, который будет отображаться в клиентском приложении.
  5. Если необходимо, выберите подсистему, к которой относится регулятор. Если вы выберете подсистему, то регулятор по умолчанию будет такого же цвета, как другие объекты этой подсистемы.
  6. По желанию настройте внешний вид регулятора:
    • В поле Поверхности нажмите +.
    • В поле Подпись введите букву поверхности, которую хотите настроить. По умолчанию все инженерные объекты состоят минимум из одной поверхности S.
    • Укажите цвет заливки и контура. Если необходимо, отметьте флагами параметры Применять освещение и Рисовать в глубину.
    • Таким же образом добавьте другие поверхности, если необходимо.
    • Сохраните изменения.
  7. Настройте регулируемый параметр:
    • Укажите минимально и максимально доступные значения.
    • Укажите шаг, базовое значение и точность значения.
    • Сохраните изменения.
  8. Если необходимо, чтобы действия с регулятором можно было добавлять в расписание, отметьте флагом параметр Расписание.

После внесенных изменений сохраните проект и загрузите его на контроллер.

Порядок определения внешнего вида

Так как внешний вид можно задать разными способами, для избежания конфликтов есть порядок, который определяет, какие параметры приоритетнее.

Цвет заливки и контура

  1. Цвет, заданный для действий (Параметры визуализации состояния Вкл/Выкл, Режим, Уровень)
  2. Цвет, заданный в поверхностях объекта.
  3. Цвет подсистемы, к которой определили объект.
  4. Стандартный цвет универсальных инженерных объектов.

Параметры «Применять освещение», «Режим анимации» и «Рисовать в глубину»

  1. Значения, указанные в поверхностях объекта.
  2. Если значения не указаны, то по умолчанию параметры будут включены.

Редактирование и управление🔗

Управлять универсальными объектами можно в клиентском приложении и через API.

Редактировать объекты можно в T-Studio, некоторые возможности (например, изменить внешний вид) доступны по API.

C действиями и командами, доступными по API, можно ознакомиться здесь.