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

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

Устройства Galileosky предназначены для мониторинга за состоянием любых подвижных средств и применяются в различных кейсах от грузоперевозок и такси до контроля стиля вождения и каршеринга.

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

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

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

Теги из протокола, уже имеющиеся в базовой модели могут быть скрыты в интерфейсе объекта с помощью специального флажка “Режим видимости” напротив иконки сохранения.

Воспользуйтесь функцией поиска по модели, чтобы найти нужный параметр. Отредактировать параметр проще, чем создавать новый!

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

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

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

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

Необходимо указать имя параметра, тип данных и источник.

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

Поле «Источник» указывает на используемый тег в соответствии с протоколом и формируется по следующему принципу: tag_<тег параметра из протокола>. Если из параметра по указанному тегу нужно взять только определенный бит, то укажите далее номер бита через точку: .<номер бита>. Например, tag_40.2 — третий бит (отсчет от нуля) в параметре 68.

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

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

Рекомендуется сразу разносить создаваемые параметры по смысловым группам для удобства отображения в интерфейсе.

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

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

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

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

Список доступных тегов и команд может зависеть от конкретного устройства и его конфигурации. Для терминалов Galileosky список команд, как правило, представлен в руководстве пользователя на конкретное устройство. Руководство можно найти на сайте производителя.

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

Ниже представлен пример описания команды и ее создание в модели.

Формат команды
Status

Пояснение
Позволяет получить статус устройства на момент посыла команды.
Dev — номер данного устройства;
Soft — текущая версия прошивки;
Pack – Порядковый номер последнего записанного пакета в память;
TmDt – Текущие время и дата;
Per – Текущий период записи пакетов в память (во время движения и стоянки разный);
Nav – Правильность определения координат. 0 – координаты определены.
Lat – Географическая широта;
Lon – Географическая долгота;
Speed – Линейная скорость (скорость движения автомобиля);
HDOP – Горизонтальная точность (Чем ближе к единице, тем лучше);
SatCnt – Количество видимых спутников;
A – Дирекционный угол направления движения.

Пример
Запрос: Status
Ответ:Dev50 Soft=91 Pack=17230 TmDt=10:58:6 20.6.9 Per=60 Nav=0
Lat=60.4007
Lon=31.0070 Speed=0.0194 HDOP=0.88 SatCnt=10 A=27.55

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

Команды управления транзисторными выходами

Устройства Galileosky оснащены транзисторными выходами для реализации управления дополнительным оборудованием. Для изменения состояния выходов служит команда Out с определенным ключом, введенным через пробел.

Ключ должен содержать номер выхода (начиная с 0) и его состояние (0-открыт или 1-закрыт), указанные через запятую.

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

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

Для связи с платформой конкретного устройства Galileosky необходимо создать объект, на основе соответствующей модели. Для этого необходимо перейти в меню «Объекты» и открыть диалоговое окно создания нового объекта.

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

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