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

Для каждого типа услуг мониторинга определены свои типы пакетов и логика работы. Отдельные типы пакетов могут использоваться в нескольких типах услуг мониторинга (например: пакет NPH_RESULT - пакет подтверждения, отсылающийся на не требующий получения данных запрос). Участник соединения может не поддерживать отдельные пакеты в определенном типе услуг мониторинга.

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

Пакет NPH имеет следующий формат:

	Поле	Длина	Тип	Описание	Может ли данное поле (значение) изменяться
заголовок пакета NPH		2	unsigned int16	Тип услуги	Нет. В поле всегда должно быть установлено значение 0100 - NPH_SRV_NAVDATA
		2	unsigned int16	Тип пакета	Да
		2	unsigned int16	Флаги пакета (определяет необходимость подтверждения). Bit 0 NPH_FLAG_REQUEST - определяет необходимость подтверждения пакета. Принимает значения: 0 - пакет не требует подтверждения; 1 - пакет требует подтверждения. Возможен случай, когда бит установлен, но подтверждение не высылается. Подтверждение высылается только в том случае, когда направление подтверждения предусматривается протоколом обмена.	Нет. В поле всегда должно быть установлено значение 1 - пакет требует подтверждения
		4	unsigned int32	Идентификатор пакета, используется для подтверждения запроса. ID пакетов рекомендуется делать уникальным хотя бы в рамках одной сессии передачи данных. Например, выбрать некоторое значение ID при установке соединения и для каждого последующего пакета увеличивать его ID на единицу. При достижении 0xFFFFFFFF следующее значение ID будет равно 0x00000000 и т.д.	Да
данные пакета NPH		var	var	Поле содержит данные, является необязательным. Наличие и структура поля должны однозначно определяться типом услуг () и типом пакета ().	Да

Тип пакета NPH_RESULT относится ко всем типам услуг.

4.4. Общий пакет подтверждения: NPH_RESULT

Пакет NPH_RESULT является общим для всех типов услуг, если запрос не предусматривает получения каких либо данных. В ответ на пакет запроса посылается пакет подтверждения NPH_RESULT.

Пакет подтверждения NPH_RESULT имеет следующий формат поля данных:

поле	длина	тип	описание	может ли данное поле (значение) изменяться
	4	unsigned int32	0 в случае успешного выполнения запроса или код ошибки	Да

Поле пакета NPH_RESULT может принимать следующие значения:

- 0 - успешное выполнение запроса;

Общие ошибки:

- NPH_RESULT_OK - запрос выполнен успешно;

- NPH_RESULT_UNDEFINED - код для ошибок, не имеющих описания;

- NPH_RESULT_BUSY - участник соединения не может обработать пакет в данный момент;

- NPH_RESULT_SERVICE_NOT_SUPPORTED - тип услуг не поддерживается;

- NPH_RESULT_SERVICE_NOT_ALLOWED - тип услуг запрещен для данного участника соединения;

- NPH_RESULT_SERVICE_NOT_AVIALABLE - тип услуг недоступен в данный момент;

- NPH_RESULT_PACKET_NOT_SUPPORTED - неизвестный тип пакета, либо тип пакет не поддерживается;

- NPH_RESULT_PACKET_INVALID_FORMAT - неверный формат пакета;

- NPH_RESULT_PACKET_INVALID_PARAMETER - неверный параметр пакета;

Ошибки установки соединения:

- NPH_RESULT_PROTO_VER_NOT_SUPPORTED - версия протокола не поддерживается;

- NPH_RESULT_CLIENT_NOT_REGISTERED - клиент не зарегистрирован на сервере (в БД);

- NPH_RESULT_CLIENT_TYPE_NOT_SUPPORTED - тип клиента не поддерживается;

- NPH_RESULT_CLIENT_AUTH_FAILED - ошибка аутентификации клиента.

5. Установка соединения с сервером

Соединение с сервером может быть защищенным или незащищенным. Параметры соединения задаются инициатором соединения в поле пакета NPH_SGC_CONN_REQUEST. В первом случае все пакеты передаются в зашифрованном виде, за исключением пакетов установки соединения:

- NPH_SGC_CONN_REQUEST;

- NPH_SGC_CONN_AUTH_STRING.

В случае отказа в установке соединении (на любом этапе) сервер посылает клиенту незашифрованный пакет NPH_RESULT с кодом ошибки.

Пакет запроса установки соединения NPH_SGC_CONN_REQUEST имеет следующий формат поля :

Поле	Длина	Тип	Описание	Может ли данное поле (значение) изменяться
	2	unsigned int16	Версия протокола NDTP (старший номер)	Нет. В поле всегда должно быть установлено значение 1
	2	unsigned int16	Версия протокола NDTP (младший номер)	Да
	2	unsigned int16	Опции соединения, определяет настройки соединения, которые будут использоваться после установки соединения. (бит2: рассчитывать CRC пакетов (0 - нет, 1 - да)	Нет. Все значения битов кроме второго должны быть установлены в 0. Значение второго бита должно быть установлено в 1
	4	unsigned int32	Адрес участника соединения, пославшего пакет	Да
	4	unsigned int32	Максимальный размер пакета, который сможет обработать данный участник соединения	Нет. Все значения битов должны быть установлены в 0

Так как сервер не устанавливает соединения, то пакет запроса соединения посылают только клиенты (СТС).

Поля и определяют версию протокола, по которой собирается работать клиент. всегда должно быть установлено в 1.

Пакет с массивом данных для аутентификации клиента NPH_SGC_CONN_AUTH_STRING имеет следующий формат поля :

Поле	Длина	Тип	Описание	Может ли данное поле (значение) изменяться
	var	char[]	Массив данных. Длина массива определяется по полю пакета NPL	Да

6. Мониторинг транспортных средств: NPH_SRV_NAVDATA

Навигационные данные передаются в типе передачи NPH_SRV_NAVDATA.

Существует два типа пакетов:

- NPH_SND_REALTIME - передача навигационных данных в реальном времени;

- NPH_SND_HISTORY - передача навигационных данных, сохраненных в памяти устройства ("ретроспективы").

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

Поле	Длина	Тип	Описание	Может ли данное поле (значение) изменяться
< Type >	1	unsigned int8	Тип ячейки (определяет длину и содержимое). Различаются следующие типы: 0 - основные навигационные данные; 2 - данные от внутренних портов; 8 - данные от датчиков уровня продукта в отсеках.	Да
< Number >	1	unsigned int8	Определяет навигационный приемник: N=0 - GPS приемник, N=1 - GLONASS приемник. Если Type=13, данное поле определяет номер отсека, к которому подключен уровнемер.	Да
< Data >	var	сhar[]	Данные от датчика. Структура определяется полем .	Да

Пакеты передачи навигационных данных NPH_SND_HISTORY и NPH_SND_REALTIME имеют следующий формат поля :

Структура поля состоит из ячеек, каждая из которых имеет поля , и переменной длины. Длина каждой ячейки поля определяется полем .

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

Ячейка 2

Ячейка 1