Контроллер поставляется собранным, прошитым и готовым к работе, но перед его использованием надо выполнить несколько шагов:

1. Прикрутите антенну Wi-Fi к разъёму SMA.
   
2. Подключите питание контроллера к клеммнику 9-48V или к интерфейсу Ethernet 1, если вы используете Passive PoE. Варианты подключения и схему смотрите в разделе Питание.
3. Переведите переключатель на лицевой панели корпуса в положение ON, подождите пару минут, пока загружается ОС Linux. В рабочем режиме индикатор контроллера будет мигать зелёным с частотой один раз в секунду.

С контроллером можно взаимодействовать через встроенный веб-интерфейс или через командную строку. В обоих случаях вам нужно подключить контроллер к компьютеру и узнать его IP-адрес.

В контроллере есть несколько интерфейсов для связи с компьютером: Debug Network, Wi-Fi, Ethernet и Debug Console.
Для первоначальной настройки удобно использовать Debug Network, в повседневной эксплуатации Wi-Fi или Ethernet, а в экстренных случаях Debug Console, которая предоставляет доступ к логам загрузчика и командной строке.

Если у вас на компьютере ОС Windows 7 и новее, а также с ОС Linux — для первого подключения удобно использовать специальный разъём Debug Network. На компьютерах с MacOS и телефонах он не работает, используйте подключение через Wi-Fi или Ethernet.
При подключении через Debug Network в компьютере создаётся виртуальная сетевая карта с фиксированным IP-адресом, через которую можно получить доступ к веб-интерфейсу и командной строке. Чтобы сетевая карта заработала, контроллер должен быть полностью загружен, а его индикатор равномерно мигать зелёным.
Внешнее питание можно не подключать, в этом случае контроллер будет питаться от USB-порта компьютера. Питание там маломощное, поэтому отключите от контроллера все внешние устройства: боковые модули и устройства, подключенные к Vout, +5V, USB.

Как пользоваться:

1. Подключите внешнее питание.
2. Переведите выключатель на передней панели в положение ON.
3. Подключите USB-C кабель к разъёму Debug Network и компьютеру.
4. Дождитесь, полной загрузки контроллера — это когда индикатор возле кнопки включения равномерно мигает зелёным.
5. Как только контроллер загрузится, на компьютере будет обнаружен накопитель с меткой PhitoSmart. В нём будет ссылка на веб-интерфейс и небольшая инструкция с IP-адресом.
   

Debug Network — это универсальный разъём и кроме доступа к консоли и веб-интерфейсу, с его помощью можно обновлять прошивку контроллера или удалять данные с откатом к заводской версии ПО

Контроллер создает Wi-Fi точку доступа без пароля:

• Откройте на ноутбуке или телефоне список Wi-Fi точек доступа.
• Выберите из списка точку доступа с именем PhitoSmart-XXXXXXXX. Где XXXXXXXX - серийный номер контроллера.
  

Оба Ethernet порта контроллера настроены на получение IP-адреса по DHCP, поэтому вам понадобится роутер с настроенной раздачей IP-адресов — обычно это любые роутеры, стоящие в квартире или офисе:

1. Возьмите патчкорд с коннекторами RJ-45 и воткните его с одной стороной в свободный порт роутера, а с другой в один из портов контроллера.
2. Зайдите в настройки вашего роутера и посмотрите, какой IP-адрес он выдал контроллеру.
3. Откройте на компьютере, подключённому к тому же роутеру, что и контроллер, веб-браузер и введите IP-адрес из предыдущего пункта.

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

Контроллер PhitoSmart управляется ОС Linux, поэтому все настройки хранятся в файлах. Большая часть настроек делается из веб-интерфейса контроллера, но иногда без командной строки не обойтись, например, если надо установить дополнительные программы, или настроить часовой пояс.
Для доступа к командной строке подключитесь к контроллеру по протоколу SSH или через отладочный порт.

Обновите прошивку контроллера, чтобы иметь самую свежую версию, проще всего это сделать через веб-интерфейс.
После того, как вы немного познакомились с контроллером, нужно подумать о безопасности:

1. Сменить пароль пользователя root по инструкции.
2. Установить пароль на Wi-Fi — инструкция по настройке сети.
3. При использовании контроллера на предприятии надо защитить веб-интерфейс паролем.
4. Если планируете открывать доступ к контроллеру из интернета, то делайте это через VPN или Tailscale. Никогда не назначайте контроллеру белый IP-адрес, вас могут взломать.

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

• Установите верный часовой пояс.
• Для активных пользователей и проектов на стадии стройки и пусконаладки рекомендуем переключить ПО контроллера на Testing релиз.
• Если вы забыли пароль для входа — можете сбросить пароль пользователя root.
• Если возникли неполадки с контроллером, вы можете провести диагностику.
• Настройте автоматизацию с помощью правил

Если в процессе экспериментов что-то пошло не так, или вам надо откатить контроллер к заводским настройкам, можете удалить все данные и вернуть установленное на заводе ПО.

В контроллерах Phito Smart есть светодиодный индикатор из светодиодов зеленого и красного цветов. Они включаются поочередно или вместе, поэтому возможны три варианта свечения: зеленый, красный и оранжевый.
Индикатор показывает основные этапы загрузки и его можно использовать для быстрого поиска неисправностей при старте. Для детальной информации о происходящем в контроллере используйте отладочный порт.
После загрузки операционной системы вы можете управлять индикатором из своего программного обеспечения.

PhitoSmart работает под управлением Debian Linux. Для архитектуры используемого процессора есть официальный порт, поэтому любое стандартное Linux-приложение можно установить из репозитория одной командой apt install имя_пакета.
Программное обеспечение контроллеров PhitoSmart состоит из множества пакетов, которые мы объединяем в релизы stable — стоит на новых контроллерах и testing — rolling-релиз с самыми свежими версиями пакетов.

Очередь сообщений MQTT — «скелет» программной архитектуры PhitoSmart. Все сервисы контроллера общаются между собой по общей «шине», в роли которой и выступает брокер MQTT.
Веб-интерфейс PhitoSmart работает непосредственно на контроллере. В нём можно:

• следить за состоянием контроллера и подключённых устройств и управлять ими,
• подключать устройства к контроллеру,
• настраивать контроллер и обновлять его ПО,
• писать правила на встроенном движке,
• настраивать SMS- и email-уведомления,
• смотреть графики истории значений параметров: температуры, напряжения и т.п.

Движок правил ps-rules позволяет создавать собственные правила для контроллера, например: «Если температура датчика меньше 18°С, включи нагреватель». Правила создаются через веб-интерфейс и пишутся на простом Javascript-подобном языке

Для работы с SCADA-системами есть:

• Агент Zabbix
• Шлюз Modbus TCP/RTU
• Шлюз OPC UA
• Шлюз МЭК 104
• Агент SNMP
• MQTT

Дополнительно можно установить:

• Node-RED — инструмент визуального программирования.
• МЭК 61131-3 — программирование контроллеров с помощью языков FBD, ST, LD, SFC.
• Grafana — мощный инструмент архивирования и визуализации данных.
• IntraSCADA — платформа для систем диспетчеризации зданий, мониторинга и автоматизации промышленных объектов и инженерных сооружений (СМИС).
• Rapid SCADA — это платформа для промышленной автоматизации с открытым исходным кодом.
• Home Assistant — платформа для домашней автоматизации с открытым исходным кодом.
• Docker — программное обеспечение для запуска приложений в изолированной среде.

А также сотни пакетов из репозитория Debian Linux и программное обеспечение партнёров.

Вы можете разрабатывать своё ПО для контроллеров PhitoSmart или собрать собственный образ прошивки с нужными вам настройками, лицензиями и пакетами. Свой образ прошивки можно установить в контроллеры самостоятельно штатными средствами, или мы можем делать это сразу на производстве при заказе отдельной партии.

Внутренние модули расширения — это небольшие платы, устанавливаемые внутрь корпуса контроллера Phyto Smart и расширяющие его функциональность: дополнительные порты RS-485, RS-232, релейные выходы и т. д.
В контроллере есть четыре слота для подключения модулей расширения двух разных типов. Для трёх из этих модулей выведено по 3 внешних клеммника для каждого.
Модули ввода-вывода стыкуются с боковым разъемом контроллера с правой стороны; каждый модуль добавляет к контроллеру от 8 до 16 цифровых или аналоговых портов.
Последовательно можно подключать до 8 модулей: до 4 модулей ввода (типа I) и до 4-х модулей вывода (типа O и IO).
Модуль резервного питания — дополнительные мезонинные платы, устанавливаются внутрь корпуса PhitoSmart и обеспечивает работу контроллера до 3 часов.

Модуль Wi-Fi в PhitoSmart можно настроить на работу в одном из трёх режимов:

• режим точки доступа, включён по умолчанию 
• режим клиента
• одновременная работа в режиме и точки доступа, и клиента

Модуль Bluetooth 4.0 (Bluetooth Low Energy) — можно отслеживать приближение других Bluetooth устройств, например, мобильного телефона или Bluetooth-метки.
USB-стик Z-Wave - подключается к USB-разъему и обеспечивает поддержку устройств стандарта Z-Wave.
Антенны Wi-Fi, GSM и радиомодулей подключаются к разъемам SMA.
При слабом сигнале GSM рекомендуем использовать выносную антенну и располагать ее вдали от контроллера.
Модуль сотовой связи — 4G (LTE) или NB-IoT устанавливается в контроллер модулем расширения. Требуется SIM-карта формата nanoSIM.
Модем позволяет отправлять и принимать SMS, подключаться к интернету. Работа с двумя SIM-картами в режиме мультиплексирования. SIM-карты расположены под крышкой контролера.
Антенны Wi-Fi, GSM и радиомодулей подключаются к разъемам SMA. При слабом сигнале рекомендуется использовать выносную антенну и располагать ее вдали от контроллера.

Два интерфейса Ethernet поддерживают скорость 10/100 Мбит/с.
Интерфейс USB. Контроллер оборудован одним портом USB 2.0 (A/F), который работает в режиме USB Host и поддерживает загрузку прошивки контроллера.
Интерфейс RS-485 — стандарт коммуникации по двухпроводной шине.
Контроллер имеет 2 порта RS-485 + можно добавить еще 3 порта модулями расширения
Стандартно в PhitoSmart с подключёнными по RS-485 устройствами работает драйвер ps-mqtt-serial через систему MQTT-сообщений.
CAN — это стандарт коммуникации по двухпроводной шине. На контроллере мультиплексирован (выведен на те же клеммники) со вторым портом RS-485.
Может работать в режиме UART-CAN (также называемая иногда просто шиной CAN или RS-CAN) - используется физический уровень CAN для полудуплексного последовательного порта UART. Шина UART-CAN используется преимущественно в приборах учёта, таких как счётчики электроэнергии Меркурий.
Режим работы второго порта RS-485 (обычный RS-485, UART-CAN, обычный CAN) можно выбрать в веб-интерфейсе: на вкладке Hardware Modules Configuration в настройках RS485-2/CAN interface config.
1-Wire — шина для подключения внешних датчиков по двум или трём проводам. Так как это шина, можно подключить несколько устройств на один порт 1-Wire. ПО контроллера поддерживает подключение температурных датчиков типа DS18B20.
Debug Console (отладочный порт) — это резервный инструмент, через который можно получить доступ к консоли контроллера и взаимодействовать с загрузчиком, следить за загрузкой операционной системы и выполнять команды в командной строке.
Debug Network — USB-C разъём, через который можно получить доступ к веб-интерфейсу или консоли контроллера, а также обновить прошивку или удалить все данные со сбросом к заводским настройкам.

В контроллере есть высокоскоростной слот для карт памяти MicroSD, который расположен на левом торце корпуса и поддерживает чтение/запись на скорости до 60 Мбайт/с (25 Мбайт/с в ревизии 7.2.1). Карта памяти вставляется контактами вниз до лёгкого щелчка.
Карту MicroSD удобно использовать для хранения бэкапов, лог-файлов или как расширение основной памяти контроллера.
После установки карта памяти будет доступна в устройстве /dev/mmcblk1, первый раздел которого будет автоматически примонтирован в /mnt/sdcard.

Входное сопротивление каналов 30 кОм начиная с версии 7.2.1. У ранних версий входное сопротивление каналов 100 кОм.
Режимы дискретный и аналоговый вход работают одновременно. При работе канала в режиме входа переключатель Ax_OUT (D1_OUT) должен быть выключен.
Канал в режиме выхода управляется переключателем Ax_OUT (D1_OUT): выключатель включён — выход замкнут на GND.

Каналы W1 и W2 могут работать как интерфейс для подключения датчиков 1-Wire (по умолчанию) или как дискретные входы типа «сухой контакт».
Режим каналов выбирается независимо для каждого канала в веб-интерфейсе контроллера в разделе Настройки → Конфигурационные файлы → Модули расширения и порты → Режим W1 (Wx terminal mode).

Количество возможных датчиков и надёжность их работы зависит от длины шины, её топологии и кабеля. Обычно в домашних условиях надёжно работает до 20 датчиков по 5 метров кабеля, соединённых звездой.

В режиме дискретного входа срабатывание происходит при замыкании на землю (GND), в отличие от каналов A1-A3 и D1.

Для питания датчиков удобно использовать выход +5V. Он защищен от КЗ и подачи повышенного напряжения. При питании контроллера от аккумулятора выход +5V остается активным.
Также есть программное управление этим выходом (его можно отключать). В веб-интерфейсе выход представлен контролом 5V_OUT устройства Discrete I/O.

На клеммы Vout подаётся напряжение питания контроллера, убедитесь, что подключенные к клеммам устройства рассчитаны на это напряжение!
В контроллере есть два выхода Vout на которые подаётся напряжение питания контроллера, но с ограничением тока до 1 А суммарно, программным отключением и сохранением состояния при перезагрузке или отключении переключателем контроллера.
При питании контроллера от аккумулятора на выход подается напряжение +11 В.
Выходы можно отключить программно, контрол в веб-интерфейсе: устройство Discrete I/O → контрол V_OUT.
Защита построена на полифьюзе 1А, который восстанавливается через некоторое время после отключения нагрузки.

По стандарту RS-485 линия должна быть терминирована резисторами 100 — 120 Ом с обоих концов. Для упрощения монтажа контроллер имеет встроенные терминаторы, которые включаются программно.
Также на линиях стоят резисторы защитного смещения (failsafe bias, растяжка линий A и B). По умолчанию они включены. Если контроллер используется в режиме «slave», то эти резисторы необходимо отключить в веб-интерфейсе контроллера.
Для стабильной работы шины RS-485 строго следуйте рекомендациям, описанным на странице RS-485:Физическое подключение.

Часть клеммников может выполнять более одной функции.

Контроллер монтируется на стандартную DIN-рейку шириной 35 мм и занимает пространство в 6 DIN-юнитов.

Рекомендуем для монтажа использовать гибкие многожильные провода с обжатием концов втулочными наконечниками (НШВИ — наконечник штыревой втулочный изолированный).
При снятии изоляции провод должен зачищаться ровно по длине гильзы (можно зачистить больше, а потом откусить выступающий излишек). Для обжима (опрессовывания) используйте пресс-клещи (кримпер, «обжимка»). При монтаже обжатый наконечником провод не разрушается винтовым зажимом и надежно фиксируется.
Не прикладывайте чрезмерное усилие при завинчивании клеммы — это приводит к разрушению винтового разъема.

Зуммер (звуковой излучатель) — издает звуковой сигнал, частота настраивается.
Часы реального времени RTC питаются от собственного отдельного аккумулятора. Так как используется аккумулятор, периодическая замена батарейки не требуется. Ёмкости аккумулятора хватает на 2-3 месяца работы часов при отключенном питании контроллера.

Контроллер содержит отдельный аппаратный сторожевой таймер — watchdog, он перезагружает контроллер при зависании ПО.
Перед редактированием конфигурации сервисов, указанных в файле конфигурации watchdog — желательно остановить его выполнение. После внесения и проверки изменений снова запустите watchdog.
Если при редактировании конфигурации была допущена ошибка и watchdog вызывает циклическую перезагрузку — войдите в систему контроллера по SSH и остановите выполнение watchdog. На это у вас есть 10–12 секунд после запуска операционной системы.
Как остановить и запустить watchdog читайте в статье Watchdog.

У контроллера есть несколько входов для подключения питания:

• Клеммы V+ с общей землёй GND для подключения одного или двух блоков питания с напряжением от 9 до 48 В постоянного тока.
• Порт Ethernet 1 с поддержкой Passive PoE с напряжением до 48 В. Важно: напряжение с PoE подаётся напрямую на выходы Vout — проверьте, что подключенные к нему устройства рассчитаны на это напряжение.

Можно подключить разные источники к разным входам, в этом случае питание будет идти от источника с бо́льшим напряжением.
После установки контроллера на DIN-рейку и подачи питания, переведите переключатель на верхней крышке контроллера в положение ON. Начнется загрузка операционной системы контроллера. По окончании загрузки индикатор контроллера замигает зеленым.