Пример подключения устройства по протоколу Teltonika

Конфигурирование модели

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

Рассмотрим пример подключения к системе автомобиля, оснащенного устройством Teltonika. Для этого создадим соответствующую модель:

Базовая модель включает ряд сгруппированных параметров, а также команды, объединенные в соответствующую подсистему. В большинстве случаев, для использования оборудования Teltonika достаточно предустановленных параметров. Однако, при использовании специфического оборудования, предустановленный шаблон может как содержать лишние элементы, которые можно просто удалить из модели, так и не содержать необходимых параметров и команд — их можно легко добавить в модель.

Создание нового параметра

Наиболее оптимальным способом создания нового параметра является копирование существующего.

Перед добавлением нового параметра воспользуйтесь функцией поиска по модели, чтобы проверить, что он не был создан ранее.

Поля создаваемого параметра заполнятся автоматически. В качестве типа выбирается “аргумент”. Поле “Идентификатор” можно оставить без изменений, если не предполагается использование API.

Подробнее о назначении полей смотреть раздел Модель объекта контроля.

Если необходимо использовать API платформы, рекомендуется изменить идентификатор, автоматически сгенерированный платформой, на более понятный.

Поменяйте имя параметра, тип данных и источник.

Имя параметра должно быть удобным для дальнейшего просмотра в интерфейсе, а тип — соответствовать типу значения параметра (boolean для логических состояний True/False, number для чисел и т.д.).

Поле «Источник» указывается адрес параметра в соответствии с протоколом обмена и формируется по следующему принципу: in_out_<номер параметра в протоколе (Property ID in AVL packet)>. Если из параметра по указанному адресу нужно взять только определенный бит, то укажите далее номер бита через точку: .<номер бита>. Например, in_out_85.2 — третий бит (отсчет от нуля) в параметре 85.

scheme

Источники GPS-параметров, соответствующие возможностям протокола, в модели уже представлены (navigation.latitude, navigation.speed и т.д.)
GPS-параметры в протоколе Teltonika:

ИмяРазмер, байтОписание
Longitude4Долгота
Latitude4Широта
Altitude2Высота
Angle2Угол в градусах от севера по часовой стрелке
Satellites1Количество видимых спутников
Speed2Скорость, в км/ч (при ошибке GPS возвращается значение 0x0000).

Также можно выбрать единицу измерения и иконку с изображением, где выставить уровни по цветам (только для числа или логического значения). Уровни можно обозначить произвольным текстом, который будет выводиться в интерфейсе рядом со значением параметра.

В случае, если новый параметр был создан на основе существующего, рекомендуется обратить внимание на вкладку “При разборе”, которая по умолчанию скрыта. В ней может быть указан множитель!

Рекомендуется сразу разносить создаваемые параметры по смысловым группам для удобства отображения в интерфейсе.
Чтобы создать группу параметров (подсистему) необходимо выбрать в поле параметра “Тип” значение “Подсистема”.
Для перемещения параметров между собой или занесения их в подсистемы поддерживается drag-and-drop с помощью мыши.

Создание новой команды

Протокол Teltonika предусматривает управление объектом контроля с помощью текстовых команд. Механизм создания команд аналогичен механизму создания параметра. Создать новую команду можно с помощью пункта меню “добавить” или “копировать”, доступных по клику на правую кнопку мыши.

Рекомендуется создавать подсистемы для команд, объединенных смысловым значением — например: “Информационные команды”, “Управляющие команды”, “Каршеринг” и т.д. Крайне не рекомендуется создавать команды в Параметрах!

Список доступных команд зависит от конкретного устройства и его конфигурации. Например для оборудования серии FMB список команд можно найти на сайте производителя.

После создания шаблона команды необходимо любым из способов заполнить поля “Идентификатор”, “Имя” (будет отображаться в интерфейсе), “Описание” (опционально); выбрать в поле “Отправить” значение “Текстовая команда” и в поле “Текст” записать текст команды.

При необходимости, существует возможность просмотреть представление текста команды в шестнадцатеричном формате, перейдя на вкладку HEX.

Команды управления реле

Для управления внутренними реле устройств Teltonica служит команда setdigout с определенным ключом, введенным через пробел.
Ключ должен отражать состояние всех реле устройства, однако, если управлять реле не требуется, его состояние обозначается “?” (знаком вопроса).

Таким образом, команды по управлению конкретным реле строятся следующим образом:

1. Слово setdigout + пробел

2. Состояния реле (количество символов должно соответствовать кол-ву реле терминала. если конкретное реле не должно менять своего состояние то вместо значения “1” — вкл и “0” — выкл нужно передавать знак вопроса “?”).

Например, для включения третьего реле (из четырех возможных) необходимо отправить команду:

setdigout ??1?

для выключения:

setdigout ??0?

если реле всего два, то команда на включения второго реле будет выглядеть так:

setdigout ?1

если нужно включить оба реле:

setdigout 11

3. При необходимости указать длительность замыкания реле. Через пробелы указывается время включения для нужного реле (также позиционно). Для реле, которые не должны изменять своего состояния (“?”), необходимо поставить 0. Время необходимо передавать для каждого реле.

Например, команда для включения четвертого реле на 5 секунд будет выглядеть так

setdigout ???1 0 0 0 5

Примечания

Примечание 1

Если количество реле не известно, предусмотрена команда getio, в ответ на которую подключенное устройство вернет информацию об имеющихся входах и выходах. Количество параметров in_out_DO и будет числом реле в подключенном устройстве.

Создание объекта

Для связи с платформой конкретного устройства Teltonika необходимо создать объект, на основе соответствующей модели. Для этого необходимо перейти в меню «Объекты» и открыть диалоговое окно создания нового объекта.Из выпадающего списка выбирается модель. В поле идентификатор необходимо указать IMEI вашего устройства с префиксом teltonika (например, teltonika:123456789000001). Это необходимо для идентификации устройства при его подключении к платформе. Далее вводится имя объекта, при необходимости заполняются остальные поля.

После того, как были созданы модель и объект, а само устройство было настроено и сконфигурировано, его можно считать подключенным к платформе. Теперь остается убедиться, что данные от устройства действительно присылаются на платформу и отображаются в ее интерфейсе.