Интеграция оборудования Гарвекс: как подготовить запрос описания протокола контроллера

Интеграция оборудования Гарвекс начинается с понятного описания задачи. Письмо «пришлите протокол» оставляет открытыми главные вопросы: какой контроллер установлен, куда должны поступать сведения и потребуется ли управление выдачей. Подготовленный запрос помогает обсудить конкретную схему обмена и заранее определить, как проверить результат.

Сначала определите границу интеграции

На странице контроллеров «Квота» Гарвекс описывает открытый протокол для взаимодействия со сторонним оборудованием и программным обеспечением, в том числе вариант «Квота-RS485». Это основание для технического обсуждения, но не подтверждение совместимости любой пары устройств.

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

Если нужен обмен между учётной программой и облачным сервисом, уточняйте именно этот уровень. В разделе документации Гарвекс есть описание API «АЗС-Онлайн», а также паспорта и руководства оборудования. Документ для сервиса нельзя автоматически считать описанием интерфейса контроллера.

Какие исходные данные собрать

Составьте короткую карточку объекта. Неизвестные параметры отмечайте прямо: «версия не определена», «схему требуется проверить». Предположение, записанное как факт, может направить разработку по неверному пути.

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

Что спросить о сопряжении по RS-485

Параметры подключения

Наличие одинакового интерфейса само по себе не означает, что устройства понимают команды друг друга. При обсуждении сопряжения по RS-485 запросите применимую схему, параметры обмена, правила адресации и ограничения выбранной конфигурации. Не переносите настройки со случайно похожего оборудования.

Уточните, какая сторона инициирует обмен, как распределяется доступ к линии и как обрабатывается отсутствие ответа. Конкретные параметры для вашей модели и версии уточнит менеджер Гарвекс с привлечением технического специалиста.

Содержание сообщений

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

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

Шаблон содержательного запроса

Используйте такую структуру письма, заменив поля в квадратных скобках:

• Объект: [назначение площадки и состав оборудования].
• Контроллер: [модель, серийный номер, версия прошивки].
• Вторая сторона: [устройство или программа, версия].
• Задача: [какие данные читать, нужны ли команды управления].
• Предполагаемый канал: [интерфейс и схема соединений].
• Просим предоставить: [применимое описание протокола, примеры обмена, ограничения].
• Просим подтвердить: [совместимость конфигурации и порядок испытаний].
• Ответственный: [контакт технического специалиста].

Добавьте пример ожидаемого результата: «После завершения выдачи запись должна появиться в нашей системе один раз с корректным временем и объёмом». Это требование проекта, а не утверждение о готовой функции оборудования.

Как принять результат проверки

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

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

Вывод

Хороший запрос описания протокола содержит состав оборудования, маршрут данных и проверяемую цель. Подготовьте карточку объекта и передайте её через контакты Гарвекс. Доступность документации, совместимость и порядок реализации уточнит менеджер Гарвекс.