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

FAQ: различия между версиями

Материал из XIOT Wiki
oldwiki>Admin
 
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показано 27 промежуточных версий этого же участника)
Строка 1: Строка 1:
__NOTOC__
Эта страница предназначена для интеграторов и владельцев платформы '''XIOT'''. 


= ❓ Часто задаваемые вопросы =
Здесь собраны ответы на типовые вопросы по установке, настройке, обновлению и эксплуатации системы.


Эта страница предназначена для интеграторов платформы XIOT. Здесь собраны ответы на типовые технические и организационные вопросы, возникающие при настройке и поддержке проектов.
== 🔐 Регистрация и лицензия ==


== 🔐 Регистрация и лицензия ==
'''Как создать новый проект?''' 
 
Лицензию для каждого нового проекта приобретает интегратор. После покупки лицензионный ключ направляется на его email. Интегратор входит в [https://xiot.pro XIOT-EDITOR] под этой учётной записью и активирует ключ — при этом создаётся новый проект.


'''Как зарегистрировать новый проект?''' 
Пошаговая инструкция: [[First-project-in-xiot-editor|Создание первого проекта в XIOT-EDITOR]]. Получение ключа: [[Getting-a-license-key|Получение лицензионного ключа]].
Откройте [https://xiot.pro xiot.pro], войдите в редактор, введите лицензионный ключ, задайте имя проекта.


'''Где взять лицензионный ключ?'''   
'''Где взять лицензионный ключ?'''   
Лицензионный ключ можно получить у представителей компании XIOT или у официальных партнёров.
 
Лицензионный ключ направляется на email интегратора после покупки лицензии для проекта. Актуальный состав и стоимость указаны в [https://xiot.ru/xiot_calc_license.html калькуляторе лицензии ПО XIOT].


'''Привязывается ли лицензия к контроллеру?'''   
'''Привязывается ли лицензия к контроллеру?'''   
Нет. Лицензия используется для создания проекта в редакторе. Контроллер можно привязать к проекту, отвязать и заменить при необходимости.
 
Нет. Лицензия используется для создания проекта в редакторе. Перед заменой устройства-хоста вручную сохраните актуальную версию проекта и убедитесь, что она получила статус '''В облаке'''; после установки XIOT-PLC на новое устройство и привязки к проекту конфигурацию нужно загрузить отдельно.


'''Можно ли сменить контроллер, если старый вышел из строя?'''   
'''Можно ли сменить контроллер, если старый вышел из строя?'''   
Да. В редакторе отвяжите старый контроллер от проекта и привяжите новый — без потери конфигурации.
 
Да, но одна только привязка нового XIOT-PLC к проекту не восстанавливает его конфигурацию. Откройте проверенную сохранённую версию проекта и выполните '''Загрузить конфигурацию на контроллер''': команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.


'''Кто назначает интегратора?'''   
'''Кто назначает интегратора?'''   
По умолчанию интегратором становится тот, кто активировал лицензию. Владелец может сменить интегратора в мобильном приложении.
 
Учётная запись интегратора, активировавшая лицензионный ключ, при создании проекта получает роли '''Владелец''' и '''Интегратор'''. После завершения работ владелец проекта может быть изменён по административной процедуре.
 
Если впоследствии требуется сменить интегратора, владелец подтверждает запрос, а назначение выполняет администратор XIOT. Самостоятельная смена интегратора в приложении не выполняется.
 
Пошаговая инструкция: [[Changing-your-xiot-integrator|Как сменить интегратора в XIOT]].


== ⚙️ Установка и запуск ==
== ⚙️ Установка и запуск ==


'''Какие контроллеры поддерживает XIOT-PLC?'''   
'''Какие контроллеры поддерживает XIOT-PLC?'''   
Wiren Board, JetHome и другие устройства на базе Linux.
 
Поддерживаются Wiren Board 6/7/8/9, JetHome, Raspberry Pi, Orange Pi, NanoPi, x86-ПК (включая Intel NUC) и VDS/VPS с Debian-совместимой Linux-системой. Поддерживаемые архитектуры: <code>armhf</code>, <code>arm64</code> и <code>amd64</code>.


'''Как установить XIOT-PLC?'''   
'''Как установить XIOT-PLC?'''   
Подробная инструкция — в разделе [[Установка_PLC|Установка XIOT-PLC]].
 
Скачайте <code>xiot.deb</code> по прямой ссылке и установите пакет на поддерживаемое устройство-хост или контроллер командой <code>dpkg -i xiot.deb</code>. Затем из доверенной локальной сети откройте <code>http://IP_устройства:5551</code> и введите текущие email и пароль XIOT. Порт <code>5551</code> должен оставаться внутри доверенной локальной сети. 
 
Подробная инструкция: [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].


'''Как контроллер узнает о проекте?'''   
'''Как контроллер узнает о проекте?'''   
После установки XIOT-PLC на контроллер необходимо авторизоваться, указав логин и пароль от редактора. Затем выбрать нужный проект, к которому хотите привязать контроллер.
 
После установки XIOT-PLC войдите в его локальный интерфейс по email и паролю XIOT, выберите проект и завершите привязку XIOT-PLC к проекту. К одному проекту сейчас привязывается один XIOT-PLC.
 
'''Можно ли подключить несколько Wiren Board?'''
 
Да. Один XIOT-PLC может иметь до шести MQTT-подключений Wiren Board. Это не означает шесть XIOT-PLC: в текущей версии в проекте доступен один PLC-слот. Для двух независимых XIOT-PLC сейчас нужны два отдельных проекта и две лицензии на проекты. Несколько XIOT-PLC в одном проекте — планируемая, но ещё не доступная возможность.


'''Как обновить версию XIOT-PLC?'''   
'''Как обновить версию XIOT-PLC?'''   
Выберите нужную версию в редакторе XIOT и нажмите кнопку '''Обновить версию на контроллере'''. Контроллер скачает и установит обновление автоматически.
 
Если XIOT-EDITOR показывает доступную версию XIOT-PLC, откройте блок версии и подтвердите обновление. На время установки связь с контроллером может прерываться. Перед обновлением сохраните проект и дождитесь статуса '''В облаке'''. После обновления проверьте версию, связь и основные устройства.
 
== 💻 Системные требования для XIOT-EDITOR ==
 
Редактор '''XIOT-EDITOR''' работает через веб-браузер и не требует установки. Доступен по адресу [https://xiot.pro https://xiot.pro].
 
Для работы используйте компьютер или ноутбук. Актуальный список поддерживаемых браузеров, порядок входа, режимы работы и сохранение описаны в статье [[Xiot-editor-access|Доступ к XIOT-EDITOR]].
 
== 📱 Установка и использование XIOT-APP ==
 
'''Как установить мобильное приложение XIOT-APP?'''
 
Приложение '''XIOT-APP''' доступно для телефонов и планшетов под управлением iOS и Android.
Оно обеспечивает полный доступ к управлению системой XIOT из любого места 🌍.
 
Ссылки на App Store, RuStore и веб-версию, а также инструкция по установке: [[Xiot-app|Приложение для телефона и планшета XIOT-APP]].
 
Для ознакомления используйте проверенный демонстрационный доступ из раздела [[Xiot-app#Демонстрационный проект|«Демонстрационный проект»]]. Реквизиты хранятся только в основной статье XIOT-APP, чтобы разные инструкции не расходились.


== 🏗️ Структура проекта ==
== 🏗️ Структура проекта ==


'''Как правильно выстроить структуру проекта?'''   
'''Как правильно выстроить структуру проекта?'''   
Создайте этажи, комнаты, затем добавьте виртуальные устройства. Используйте визуальный редактор — структура формируется drag-n-drop.
 
Создайте иерархию: дом → этажи → комнаты → устройства.
 
Это позволит системе автоматически формировать агрегированные параметры и логику.


'''Как связать виртуальные устройства с физическими?'''   
'''Как связать виртуальные устройства с физическими?'''   
Через теги. Настройте драйверы (Modbus, MQTT, KNX и др.), получите список тэгов, затем укажите их в параметрах устройства.


'''Что такое SaveVal и где он хранится?'''  
Через адреса управления и состояния. Настройте драйверы XIOT (Modbus, MQTT, KNX и др.), получите список адресов и укажите их в параметрах устройства.  
Это служебный файл на контроллере, где хранятся все значения переменных (включая состояния устройств и настройки).
 
Подробнее: [[Xiot-tags|Адреса управления и состояния в XIOT]].


== 📦 Устройства ==
== 📦 Устройства ==


'''Какие устройства доступны в редакторе?'''   
'''Какие устройства доступны в редакторе?'''   
Список представлен в разделе [[Виртуальные_устройства_XIOT|Виртуальные устройства XIOT]]. Доступны датчики, освещение, климат, кнопки, реле и др.
 
Список представлен в разделе [[Xiot-devices|Виртуальные устройства XIOT]].
 
Доступны устройства освещения 💡, климата 🌡️, безопасности 🛡️, счётчики, реле и датчики.


'''Как работают устройства без физической привязки?'''   
'''Как работают устройства без физической привязки?'''   
Они считаются виртуальными. Вы можете использовать их в логике, тестировании и имитации.


== 🎯 Сценарии ==
Они считаются виртуальными и используются для тестирования, симуляции и логических сценариев без подключения к оборудованию.
 
== 🎯 Сценарии и автоматизация ==


'''Какие типы сценариев доступны?'''   
'''Какие типы сценариев доступны?'''   
Предусмотрены: по времени, по событию, имитация рассвета/заката, циркадные ритмы, кастомный сценарий и др.


'''Как передать параметры в сценарий?'''  
Платформа поддерживает сценарии:
Каждый сценарий имеет входы, на которые можно подать значения с устройств или логики.
* по времени (таймеры, графики);  
* по событиям (реакция на изменение состояния); 
* имитация рассвета/заката 🌅; 
* циркадные ритмы 🌤️; 
* комбинированные и кастомные логики.


== 🛠️ Отладка и обслуживание ==
== 🛠️ Обслуживание и отладка ==
 
'''Как просмотреть текущие значения тегов?''' 
На контроллере — через терминал или Web-интерфейс. В редакторе — при выборе устройства или через редактор логики.


'''Как выполнить резервное копирование проекта?'''   
'''Как выполнить резервное копирование проекта?'''   
Проект сохраняется в облаке. Вы можете экспортировать его файл в редакторе, нажать кнопку загрузить в списке истории сохранений.


'''Как отключить сценарий временно?'''
Нажмите '''Сохранить проект'''. После успешной записи появится локальная датированная копия; отправка в облако выполняется отдельно и может потребовать проверки актуальности версии. Статус '''В облаке''' подтверждает облачное сохранение, но не публикацию приложения для телефона. До подтверждённой синхронизации или получения проверенного файла резервной копии не очищайте данные браузера.
Можно отключить и временно скрыть сценарий.


= 📲 Интерфейс и управление =
'''Создать версию''' — результат сохранения, а не отдельная команда. Отдельное сохранение удобно как самостоятельная контрольная точка, особенно во время вёрстки в Pro, и не изменяет конфигурацию XIOT-PLC. Если нужно применить конфигурацию на объекте, нажмите '''Загрузить конфигурацию на контроллер''': команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Во время сохранения и загрузки не редактируйте проект. Отдельное сохранение остаётся доступно для самостоятельной контрольной точки.


Раздел посвящён вопросам, связанным с мобильным приложением XIOT, отображением интерфейса, управлением состоянием дома и пользовательским опытом.
У выбранной резервной копии можно нажать '''Скачать файл'''; в старом меню команда называется '''Скачать сохранение'''. Импорт через '''Загрузить из файла''' сначала сохраняет копию только на текущем устройстве и не обновляет PLC. Перед передачей или восстановлением проверьте выбранную версию и полученный файл.
'''Как проверить, что сценарий работает?'''
В редакторе можно просмотреть журнал исполнения. Также используйте встроенные уведомления и статусы устройств.


'''Можно ли сделать сценарий видимым только в определённых комнатах?'''
Подробная инструкция: [[Project-backup|Сохранение резервной копии проекта]].
Да. У каждого сценария можно задать «используемые комнаты». Это влияет на его отображение в интерфейсе пользователя.


'''Можно ли изменить порядок отображения комнат в приложении?'''
'''Как отключить сценарий временно?'''
Да. В редакторе вы можете задать порядок отображения этажей и комнат. Он будет отражён в мобильном интерфейсе.
 
'''Как работает переключение состояния "Я дома" / "Ушёл" / "Отпуск"?'''
На главной странице мобильного приложения отображается текущее состояние дома. При его смене автоматически запускаются сценарии, назначенные интегратором.
 
'''Можно ли скрыть состояние "Ушёл" или "Отпуск"?'''
Да. В настройках устройства «Дом» можно отключить отображение кнопок состояний в интерфейсе пользователя.
 
'''Можно ли изменить иконки устройств и сценариев?'''
Да. В редакторе можно выбрать иконку из предложенного набора или загрузить собственную SVG-иконку.
 
'''Отображаются ли состояния и датчики в реальном времени?'''
Да. Интерфейс автоматически отображает актуальные значения с устройств: статусы, показания датчиков и активные сценарии.
 
'''Какие страницы доступны пользователю в приложении?'''
Пользователь видит главную страницу с комнатами, страницу сценариев, уведомления, погодную информацию и текущее состояние дома.


'''Можно ли ограничить доступ к отдельным страницам?'''
В редакторе откройте сценарий и переключите его статус на '''Отключен'''.
Нет. В текущей версии приложения доступ ограничивается только на уровне помещений. Пользователь видит только те комнаты, к которым ему открыт доступ.


== 👥 Пользователи и роли ==
Сценарий останется в проекте, но не будет выполняться до включения.


'''Какие права у интегратора?'''   
'''Как восстановить проект после поломки контроллера?'''   
Полный доступ к проекту, конфигурации, сценарию, устройствам и обновлениям. Не имеет доступа к управлению пользователями.


'''Можно ли добавить пользователей в проект?'''
Установите XIOT-PLC на новое поддерживаемое устройство-хост или контроллер по инструкции [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]] и привяжите XIOT-PLC к нужному проекту. В XIOT-EDITOR откройте и проверьте нужную сохранённую версию, затем выполните '''Загрузить конфигурацию на контроллер'''. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. После восстановления связи проверьте устройства и основные сценарии.
Нет. Пользователей добавляет только Владелец через приложение.
== 🧩 Дополнительно ==


'''Как ограничить доступ пользователей к комнатам?''' 
Это настраивается Владельцем при добавлении пользователя — можно указать конкретные этажи и помещения.


== 🧪 Дополнительно ==


'''Можно ли подключить внешний API?'''   
'''Куда обращаться за поддержкой?'''   
Да, в XIOT есть API.


'''Как работают голосовые команды?'''
Сначала проверьте подходящий ответ в FAQ. По существующему объекту владельцу следует обратиться к интегратору, который его настраивал. Для технической поддержки XIOT подготовьте данные по чек-листу и напишите на '''info@xiot.ru''': [[Support|Связь с поддержкой]]. Если нужен новый специалист для внедрения или сопровождения, используйте [[Certified-xiot-integrators|реестр сертифицированных интеграторов XIOT]].
Интеграция с Яндекс Алисой осуществляется автоматически. Поддерживаются устройства.

Текущая версия от 22:00, 2 октября 2026

Эта страница предназначена для интеграторов и владельцев платформы XIOT.

Здесь собраны ответы на типовые вопросы по установке, настройке, обновлению и эксплуатации системы.

🔐 Регистрация и лицензия

Как создать новый проект?

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

Пошаговая инструкция: Создание первого проекта в XIOT-EDITOR. Получение ключа: Получение лицензионного ключа.

Где взять лицензионный ключ?

Лицензионный ключ направляется на email интегратора после покупки лицензии для проекта. Актуальный состав и стоимость указаны в калькуляторе лицензии ПО XIOT.

Привязывается ли лицензия к контроллеру?

Нет. Лицензия используется для создания проекта в редакторе. Перед заменой устройства-хоста вручную сохраните актуальную версию проекта и убедитесь, что она получила статус В облаке; после установки XIOT-PLC на новое устройство и привязки к проекту конфигурацию нужно загрузить отдельно.

Можно ли сменить контроллер, если старый вышел из строя?

Да, но одна только привязка нового XIOT-PLC к проекту не восстанавливает его конфигурацию. Откройте проверенную сохранённую версию проекта и выполните Загрузить конфигурацию на контроллер: команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.

Кто назначает интегратора?

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

Если впоследствии требуется сменить интегратора, владелец подтверждает запрос, а назначение выполняет администратор XIOT. Самостоятельная смена интегратора в приложении не выполняется.

Пошаговая инструкция: Как сменить интегратора в XIOT.

⚙️ Установка и запуск

Какие контроллеры поддерживает XIOT-PLC?

Поддерживаются Wiren Board 6/7/8/9, JetHome, Raspberry Pi, Orange Pi, NanoPi, x86-ПК (включая Intel NUC) и VDS/VPS с Debian-совместимой Linux-системой. Поддерживаемые архитектуры: armhf, arm64 и amd64.

Как установить XIOT-PLC?

Скачайте xiot.deb по прямой ссылке и установите пакет на поддерживаемое устройство-хост или контроллер командой dpkg -i xiot.deb. Затем из доверенной локальной сети откройте http://IP_устройства:5551 и введите текущие email и пароль XIOT. Порт 5551 должен оставаться внутри доверенной локальной сети.

Подробная инструкция: Установка XIOT-PLC на контроллер.

Как контроллер узнает о проекте?

После установки XIOT-PLC войдите в его локальный интерфейс по email и паролю XIOT, выберите проект и завершите привязку XIOT-PLC к проекту. К одному проекту сейчас привязывается один XIOT-PLC.

Можно ли подключить несколько Wiren Board?

Да. Один XIOT-PLC может иметь до шести MQTT-подключений Wiren Board. Это не означает шесть XIOT-PLC: в текущей версии в проекте доступен один PLC-слот. Для двух независимых XIOT-PLC сейчас нужны два отдельных проекта и две лицензии на проекты. Несколько XIOT-PLC в одном проекте — планируемая, но ещё не доступная возможность.

Как обновить версию XIOT-PLC?

Если XIOT-EDITOR показывает доступную версию XIOT-PLC, откройте блок версии и подтвердите обновление. На время установки связь с контроллером может прерываться. Перед обновлением сохраните проект и дождитесь статуса В облаке. После обновления проверьте версию, связь и основные устройства.

💻 Системные требования для XIOT-EDITOR

Редактор XIOT-EDITOR работает через веб-браузер и не требует установки. Доступен по адресу https://xiot.pro.

Для работы используйте компьютер или ноутбук. Актуальный список поддерживаемых браузеров, порядок входа, режимы работы и сохранение описаны в статье Доступ к XIOT-EDITOR.

📱 Установка и использование XIOT-APP

Как установить мобильное приложение XIOT-APP?

Приложение XIOT-APP доступно для телефонов и планшетов под управлением iOS и Android. Оно обеспечивает полный доступ к управлению системой XIOT из любого места 🌍.

Ссылки на App Store, RuStore и веб-версию, а также инструкция по установке: Приложение для телефона и планшета XIOT-APP.

Для ознакомления используйте проверенный демонстрационный доступ из раздела «Демонстрационный проект». Реквизиты хранятся только в основной статье XIOT-APP, чтобы разные инструкции не расходились.

🏗️ Структура проекта

Как правильно выстроить структуру проекта?

Создайте иерархию: дом → этажи → комнаты → устройства.

Это позволит системе автоматически формировать агрегированные параметры и логику.

Как связать виртуальные устройства с физическими?

Через адреса управления и состояния. Настройте драйверы XIOT (Modbus, MQTT, KNX и др.), получите список адресов и укажите их в параметрах устройства.

Подробнее: Адреса управления и состояния в XIOT.

📦 Устройства

Какие устройства доступны в редакторе?

Список представлен в разделе Виртуальные устройства XIOT.

Доступны устройства освещения 💡, климата 🌡️, безопасности 🛡️, счётчики, реле и датчики.

Как работают устройства без физической привязки?

Они считаются виртуальными и используются для тестирования, симуляции и логических сценариев без подключения к оборудованию.

🎯 Сценарии и автоматизация

Какие типы сценариев доступны?

Платформа поддерживает сценарии:

  • по времени (таймеры, графики);
  • по событиям (реакция на изменение состояния);
  • имитация рассвета/заката 🌅;
  • циркадные ритмы 🌤️;
  • комбинированные и кастомные логики.

🛠️ Обслуживание и отладка

Как выполнить резервное копирование проекта?

Нажмите Сохранить проект. После успешной записи появится локальная датированная копия; отправка в облако выполняется отдельно и может потребовать проверки актуальности версии. Статус В облаке подтверждает облачное сохранение, но не публикацию приложения для телефона. До подтверждённой синхронизации или получения проверенного файла резервной копии не очищайте данные браузера.

Создать версию — результат сохранения, а не отдельная команда. Отдельное сохранение удобно как самостоятельная контрольная точка, особенно во время вёрстки в Pro, и не изменяет конфигурацию XIOT-PLC. Если нужно применить конфигурацию на объекте, нажмите Загрузить конфигурацию на контроллер: команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Во время сохранения и загрузки не редактируйте проект. Отдельное сохранение остаётся доступно для самостоятельной контрольной точки.

У выбранной резервной копии можно нажать Скачать файл; в старом меню команда называется Скачать сохранение. Импорт через Загрузить из файла сначала сохраняет копию только на текущем устройстве и не обновляет PLC. Перед передачей или восстановлением проверьте выбранную версию и полученный файл.

Подробная инструкция: Сохранение резервной копии проекта.

Как отключить сценарий временно?

В редакторе откройте сценарий и переключите его статус на Отключен.

Сценарий останется в проекте, но не будет выполняться до включения.

Как восстановить проект после поломки контроллера?

Установите XIOT-PLC на новое поддерживаемое устройство-хост или контроллер по инструкции Установка XIOT-PLC на контроллер и привяжите XIOT-PLC к нужному проекту. В XIOT-EDITOR откройте и проверьте нужную сохранённую версию, затем выполните Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. После восстановления связи проверьте устройства и основные сценарии.

🧩 Дополнительно

Куда обращаться за поддержкой?

Сначала проверьте подходящий ответ в FAQ. По существующему объекту владельцу следует обратиться к интегратору, который его настраивал. Для технической поддержки XIOT подготовьте данные по чек-листу и напишите на info@xiot.ru: Связь с поддержкой. Если нужен новый специалист для внедрения или сопровождения, используйте реестр сертифицированных интеграторов XIOT.