5 Порядок следования запросов

5.1 Начало сеанса связи.

Первым запросом должен быть запрос «Начало сеанса связи». Ответ анализировать не нужно. Далее необходимо сделать запрос на «Чтение данных». В ответе вычислителя необходимо проанализировать поле «Версия сервера». После этого необходимо получить «свойства» (см. ниже), после чего можно приступать к получению архивных/текущих данных.

5.2 Получение «свойств».

Для корректной расшифровки ответов прибора необходимо получить так называемые «свойства».

К «свойствам» относятся:

• количество знаков дробной части для различных величин;

• наименование единиц измерения различных величин.

Вычислитель ВКТ-7 передает данные системе верхнего уровня в виде целых чисел (полученных в результате масштабирования вещественных), вещественных (только величины расхода и величина, измеряемая на дополнительном входе), а также просто целых чисел.

Примечание: Величины расходов G1Type, G2Type, G3Type, G1_2Type, G2_2Type, G_23Type, а также величина DopInpImpP_Type, измеряемая на дополнительном входе, передаются в виде вещественных чисел одинарной точности, соответствующих стандарту IEEE754.

Для получения верного строкового представления величины нужно выполнить следующие операции:

• преобразовать полученное число в строку. Если величина представлена не вещественным числом, то преобразовывать в строку следует как целое число (при реализации на языке программирования С это может быть вызов функции sprintf с параметром %d). В противном случае, преобразование должно выполняться как для вещественного числа (sprintf с параметром %f);

• если величина представлена не вещественным числом, отделить от конца строки заданное в «свойствах» количество знаков и поставить запятую (или точку).

Например, от прибора получено значение (и это какая-либо величина, но не расход и не величина, измеряемая на дополнительном входе), которое после преобразования в строку дало «12345», и из «свойств» известно, что количество знаков после запятой равно 2. В этом случае окончательное строковое представление величины будет иметь вид «123,45».

Для получения «свойств» следует выполнить приведенную ниже последовательность запросов:

1. Запись типа значение с номером 6 («свойства»);

2. Запись перечня элементов для чтения (формирование перечня для «свойств» будет описано ниже);

3. Чтение данных в соответствии с записанным перечнем. При получении ответа на этот запрос анализировать байты качества и нештатных ситуаций не нужно.

Для определения величин и свойств в тепловычислителе ВКТ-7 использовано следующее перечисление:

Примечание:

1) Наличие элементов QntNS_1 и QntNS_2 возможно только в версиях ПО вычислителя помеченных буквой м. Например ПВ 1.9’м.

2) Элемент QntTypeM в зависимости от того задействован или нет дополнительный вход (определяется по активности элемента DopInpImpP_Type) имеет смысл или единиц измерения счетчиков времени, или единиц измерения величины на дополнительном входе.

3) Величины с «условным адресом» QntNS_1, QntNS_2 представляют собой массивы длительностей нештатных ситуаций по тепловому вводу: НС по отключению питания, НС расход меньше минимума, НС расход больше максимума, НС по неисправности датчика температуры, НС dt<2 .C.

При формировании запроса на запись перечня элементов для чтения (для элементов данных «свойств»), массив должен состоять из следующих элементов:

TTypeM (единицы измерения t);

GtypeM (единицы измерения расхода);

VtypeM (единицы измерения объема);

MtypeM (единицы измерения массы);

PtypeM (единицы измерения давления);

QoTypeM (единицы измерения тепла);

QntTypeHIM (единицы измерения счетчиков времени);

QntTypeM (В зависимости от того задействован или нет дополнительный вход (определяется по активности элемента DopInpImpP_Type) – это или единицы измерения счетчиков времени, или единицы измерения величины на дополнительном входе.);

tTypeFractDigNum (количество знаков после запятой для t);

VTypeFractDigNum1 (количество знаков после запятой для объема ТВ1);

MTypeFractDigNum1 (количество знаков после запятой для массы ТВ1);

PTypeFractDigNum1 (количество знаков после запятой для давления);

QoTypeFractDigNum1 (количество знаков после запятой для тепла ТВ1);

MTypeFractDigNum2 (количество знаков после запятой для массы ТВ2);

VTypeFractDigNum2 (количество знаков после запятой для объема ТВ2);

QoTypeFractDigNum2 (количество знаков после запятой для тепла ТВ2).

Для единиц измерения размер в элементе массива равен 7 байт, для количества знаков после запятой–1 байт.

Пример элемента массива для единиц измерения:

Условный адрес: 0x40000000 | tTypeM;

Размер: 0x0007;

Пример элемента массива для количества знаков после запятой:

Условный адрес: 0x40000000 | QoTypeFractDigNum2;

Размер: 0x0001;

При обработке ответа на чтение свойств следует иметь ввиду, что в зависимости от состояния поля «Версия сервера» (см. запрос «Начало сеанса связи») единицы измерения могут передаваться различными способами:

• «Версия сервера» равна 0. Наименование единиц измерения величин передаются в виде массива из семи символов в кодировке OEM;

• «Версия сервера» равна 1. Наименование единиц измерения величин передаются в виде структуры, имеющей два поля. Первое поле (типа unsigned short (16 бит)) определяет длину строки в байтах. Второе поле является массивом символов, имеющим длину, указанную в первом поле (символы в кодировке OEM).

Пример запроса на запись перечня элементов для чтения:

0x00 0x10 0x3F 0xFF 0x00 0x00 0x60 0x2C 0x00 0x00 0x40 0x07 0x00.

0x2D 0x00 0x00 0x40 0x07 0x00 0x2E 0x00 0x00 0x40 0x07 0x00 0x2F.

0x00 0x00 0x40 0x07 0x00 0x30 0x00 0x00 0x40 0x07 0x00 0x35 0x00.

0x00 0x40 0x07 0x00 0x37 0x00 0x00 0x40 0x07 0x00 0x38 0x00 0x00.

0x40 0x07 0x00 0x39 0x00 0x00 0x40 0x01 0x00 0x3B 0x00 0x00 0x40.

0x01 0x00 0x3C 0x00 0x00 0x40 0x01 0x00 0x3D 0x00 0x00 0x40 0x01.

0x00 0x42 0x00 0x00 0x40 0x01 0x00 0x46 0x00 0x00 0x40 0x01 0x00.

0x45 0x00 0x00 0x40 0x01 0x00 0x4C 0x00 0x00 0x40 0x01 0x00 0x8C.

0x75.

Вычислитель присылает в ответ на запрос стандартное подтверждение на запись:

0x00 0x10 0x3F 0xFF 0x00 0x00 0xFD 0xFC.

Пример запроса на чтение данных в соответствии с записанным перечнем:

0x00 0x03 0x3F 0xFE 0x00 0x00 0x29 0xFF.

Вычислитель присылает в ответ на запрос запрошенные «свойства»:

(Служебные байты: сетевой адрес, функция, длина всей секции данных) 0x00 0x03 0x4F.

5.3 Порядок получения необходимых данных.

За время сеанса связи система верхнего уровня должна не менее одного раза запросить «свойства» для определения наименований единиц измерения и количества знаков в дробной части для элементов данных. Далее нужно запросить перечень активных элементов, сформировать перечень элементов для чтения, и затем записать его в вычислитель. Из ответа на запрос «Чтение перечня активных элементов» для каждого элемента данных определяется его размер, то есть количество байт, которое нужно «взять» из полученного кадра, чтобы правильно интерпретировать значение.

Затем выполняются запросы на запись типа значений и запись даты (при чтении архива), а затем и собственно «Чтение данных…». При обработке ответа на запрос «Чтение данных…» используется следующая информация:

• Размер элемента данных (получен при ответе на запрос «Чтение перечня активных элементов»);

• Количество знаков в дробной части и наименование единиц измерения (получены при чтении «свойств»).

5.4 Получение архивных данных.

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

• запрос на запись типа значений с номером 0-3 в зависимости от желаемого типа данных;

• запрос на чтение перечня активных элементов;

• запрос на запись перечня элементов для чтения;

• запрос на запись даты;

• запрос на чтение данных в соответствии с записанным перечнем элементов для чтения.

Если выполняется циклическое чтение архивных данных, то первые три операции нужно выполнить единожды.

ВНИМАНИЕ! ПРИБОР ПРИСЫЛАЕТ ОТВЕТ С ДАННЫМИ, ОТНОСЯЩИМИСЯ К ТОЙ ДАТЕ, КОТОРАЯ БЫЛА ЗАПИСАНА В ПОСЛЕДНИЙ РАЗ.

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

Например, если при чтении суточного архива был получен код 3, то для получения суточной записи за эти сутки нужно использовать данные в часовом разрезе за эти же сутки. Если при получении данных в соответствии с записанным перечнем элементов для чтения получен код 5, это означает, что зафиксировано изменение схемы измерения. В этом случае нужно следовать рекомендациям, изложенным в разделе «Принципы организации данных, доступных через сеть, в тепловычислителе ВКТ-7».

5.5 Получение текущих и итоговых текущих данных.

Для получения текущих и итоговых текущих данных необходимо выполнить последовательность запросов:

• запрос на запись типа значений с номером 4 или 5 соответственно;

• запрос на чтение перечня активных элементов;

• запрос на запись перечня элементов для чтения;

• запрос на чтение данных в соответствии с записанным перечнем элементов для чтения.