Подключение контроллера

Для питания контроллера Telematic-X1 необходимо подать напряжение 24 В DC. Питание может быть подключено:

  • через винтовые клеммы;
  • через разъём DC 5,5 × 2,5 мм.

Потребляемый ток: номинальный — 11 мА; максимальный — 17 мА. Поэтому подойдёт практически любой источник питания 24 В DC.

Управление, настройка и программирование контролллера выполняются через встроенный веб-интерфейс. Для начала работы необходимо:

  1. Подключить контроллер к локальной сети через Ethernet.
  2. Определить IP-адрес контроллера.
  3. Открыть веб-интерфейс, введя IP-адрес контроллера в адресной строке браузера.

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

Определение IP-адреса

IP-адрес контроллера можно определить несколькими способами.

Через утилиту telematic_finder.exe

Используйте утилиту telematic_finder.exe. Она позволяет:

  • обнаруживать контроллеры Telematic в локальной сети;
  • изменять сетевые настройки контроллера;
  • открывать веб-интерфейс контроллера двойным щелчком по найденному устройству.

Утилита не требует установки и прав администратора. Это наиболее удобный и рекомендуемый способ.

Через USB-накопитель

Подключите USB-накопитель с файловой системой FAT32 или exFAT. Контроллер создаст файл: /telematic/%id_контроллера%/%id_контроллера_дата_время%.txt

Файл содержит системную и отладочную информацию, включая текущий IP-адрес контроллера.

Через сброс сетевых настроек

Удерживайте кнопку сброса в течение 10 секунд. После этого:

  • будет установлен IP-адрес по умолчанию — 192.168.0.127;
  • DHCP-клиент останется включённым.

Контроллер будет доступен по адресу 192.168.0.127 до получения нового адреса от DHCP-сервера.

Через DHCP-сервер

IP-адрес можно посмотреть в таблице выданных адресов DHCP-сервера.

Возможности веб-интерфейса

Веб-интерфейс контроллера позволяет:

  • создавать, редактировать, сохранять и запускать пользовательские сценарии на языках MicroPython и C;
  • работать с пользовательской HMI-панелью;
  • просматривать журналы событий и метрик;
  • настраивать параметры контроллера и его компонентов;
  • получать системную и отладочную информацию.

Подробное описание веб-интерфейса приведено в соответствующем разделе документации.

Запуск сценариев MicroPython

Рекомендуется начинать знакомство с контроллером с демонстрационных сценариев, предустановленных в системе. Демонстрационные сценарии не занимают место во Flash-памяти пользователя; доступны только для чтения до момента сохранения.

После сохранения демонстрационный сценарий становится пользовательским и может редактироваться.

Для запуска сценария:

  1. Выберите сценарий из раскрывающегося списка.
  2. Нажмите кнопку Старт или клавишу F9.

Компиляция сценариев MicroPython в байт-код выполняется непосредственно контроллером.

Если во время выполнения возникнет ошибка:

  • сценарий будет остановлен;
  • информация об ошибке будет выведена в консоль;
  • если контроллер работает в режиме Эксплуатация дудет активирована системная тревога и отправлено уведомление пользователю.

Информация о выполняемом сценарии (имя, состояние и время работы) отображается в верхней панели веб-интерфейса.

Компиляция и запуск сценариев C

В отличие от MicroPython, контроллер не выполняет компиляцию C-сценариев локально.

В зависимости от настроек компиляция выполняется:

  • на сервере Telematic;
  • либо с помощью утилиты telematic_compiler_c.exe в локальной сети.

Для запуска или компиляции сценария достаточно нажать кнопку:

  • Запуск — компиляция и запуск;
  • Компиляция — только компиляция.

Компиляция на сервере

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

Для этого контроллер должен:

  • иметь доступ в Интернет;
  • быть подключён к серверу Telematic.

Локальная компиляция

Утилита telematic_compiler_c.exe позволяет выполнять компиляцию в пределах локальной сети без использования внешнего сервера.

Для работы необходимо:

  1. Запустить telematic_compiler_c.exe на ПК разработчика.
  2. Указать в настройках контроллера: способ компиляции и IP-адрес ПК.

Утилита использует TCP-порт 8089; не требует установки; не требует прав администратора.

Результат компиляции сохраняется во Flash-памяти контроллера. Повторная компиляция требуется только после изменения исходного кода.

Особенности выполнения C-сценариев

Сценарии на языке C:

  • работают значительно быстрее MicroPython;
  • потребляют меньше ресурсов контроллера.

Однако C-сценарии выполняются непосредственно процессором контроллера, без изоляции виртуальной машины. Критическая ошибка в программе (например, HardFault) может привести:

  • к остановке системы;
  • последующей перезагрузке по Watchdog.

Подключение контроллера к серверу

Если контроллер имеет доступ в Интернет и подключение к серверу не запрещено настройками, соединение с сервером устанавливается автоматически.

Подключение к серверу позволяет:

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

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

Привязка контроллера к личному кабинету

Для работы требуется регистрация в личном кабинете:

http://lk.telematic.dev

Регистрация стандартная и требует подтверждения e-mail.

Чтобы привязать контроллер:

  1. Откройте страницу «Информация» в веб-интерфейсе контроллера.
  2. В разделе «Подключение к серверу» нажмите кнопку «Привязать».
  3. Скопируйте шестизначный код привязки.
  4. В личном кабинете на странице «Контроллеры» нажмите кнопку «Добавить».
  5. Введите код привязки.

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

Особенности:

  • код привязки действителен 5 минут;
  • контроллер может быть привязан только к одному личному кабинету.

Настройка уведомлений

Поддерживаются уведомления через:

  • e-mail;
  • Telegram;
  • MAX (российский мессенджер VK MAX).

Для использования Telegram или MAX необходимо предварительно подключить соответствующую учётную запись в разделе «Учётная запись» личного кабинета.

Настройка уведомлений выполняется на странице «Настройка», где можно:

  • выбрать типы тревог;
  • указать контроллеры;
  • настроить каналы доставки уведомлений.

Обновление прошивки контроллера

Обновление прошивки возможно несколькими способами.

Через веб-интерфейс

  • Из файла — на странице «Сервис» в разделе «Обновление прошивки».
  • С сервера — установка актуальной версии прошивки.

Через USB-накопитель

  1. Подготовьте USB-накопитель с файловой системой FAT32 или exFAT.
  2. Скопируйте файл прошивки в папку telematic.
  3. Подключите накопитель к контроллеру.

Через USB Type-A

  1. Подключите контроллер к ПК кабелем USB Type-A ↔ USB Type-A.
  2. На ПК появится съёмный диск.
  3. Скопируйте файл прошивки на этот диск.

Актуальная версия прошивки доступна здесь: https://telematic.dev/download/