ГОСТ Р 56947—2016
12.3.1 API считывания данных преобразователя
API считывания преобразователя используется для считывания данных (значения) преобразова
теля.
12.3.1.1 Интерфейс «ReadData» («Считать данные»)
Данный API поддерживает получение данных преобразователей от канала преобразователя с за
данным значением «channellD» на ИМП. заданном с помощью «timid» на заданном СПП (хосте).
Данный API соответствует A rgs: :U lr> tl6 readD ata(), как описано в 10.2.6.
Путь «Path»: 1451/TransducerAccess/ReadData.
Метод «GET» («Получить»): получает данные заданного канала преобразователя в заданном
ИМП СПП (хоста) и возвращает данные преобразователя в заданном формате.
12.3.1.1.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- Uinr.16 tim id — значение «timid» ИМП. содержащего канал преобразователя, данные которого
будут считываться:
- U ln tie channellD — значение «channellD» считываемого канала преобразователя;
- Tim eD uration tim eo ut — данный аргумент определяет время ожидания для выполнения
считывания без генерации ошибки тайм-аута в случае неполучения ответа. Значения «secs==0» и
«nsecs==-1» указывают на непрерывное (бесконечное) время ожидания. Использование значений «не
прерывное (бесконечное) время ожидания» является крайне опасным, поскольку при этом ресурс мо
жет быть заблокирован;
- U int8 SamplingMode —данный аргумент задает триггерный механизм. Подробная информа
ция представлена в 5.10.1 и 7.1.2.4;
- _ s trin g Respor.seFormat —задает формат ответа согласно 12.1.2.
12.3.1.1.2 HTTP-ответ для API «ReadData» («Считать данные») «ReadDataHTTPResponse»
Ответ на вызов данного API должен содержать следующие параметры:
- u :n t!6
- U in tl6
errorC ode —информация об ошибках, как определено в 9.3.1.2;
tim id — значение «timid» заданного ИМП;
- u in t l6 channellD — значение «channellD» заданного канала преобразователя;
- ArgumentAr ray transducerD ata —данный массив содержит данные, считанные из заданного
канала преобразователя выбранного ИМП.
12.3.1.1.3 Схема XML-ответа для API «ReadData» («Считать данные»)
Если формат ответа — «XML», то для ответа должна быть использована следующая схема:
<?xml v e rs io n » » l.0» encoding-»U?F-8»?>
<xs :schema xm lns:xs-*-»http: / /
www.w3.org/2001/XKLSchema»
xm lns: s tm l-
h ttp :/ /grouper.ieee.org/groups/1451/0/I451H T T P A P l
<xs rcomplexType name-wReadDataH’rTPResponse">
<xs:sequence>
<xs:elem ent nam e-"errorC ode" ty p e -” s tm l: U In tl6 "/>
<xs:eiem ent na m e-’’tim ld" ty p e -"s tm l :U In tl6 "/>
<xs:elem ent nam e-"channelldn ty p e -"s tm l: U In tl6 "/>
<xs: elem ent nam e-^transducerD ata" ty p e -"s tm l:Argum entArrayType"/>
< /x s : sequence>
< /x s : complexType>
</xs:achem a>
12.3.1.2 Интерфейс «StartReadData» («Начать считывание данных»)
Данный API поддерживает начало получения данных заданного преобразователя заданно
го ИМП для заданного СПП (хоста). Данный метод запускает неблокирующее считывание заданных
каналов преобразователя. Данный API соответствует A rg s ::U in tl6StartReadD ata о , как опи
сано в 10.2.8. Данные преобразователя, которые должны быть переданы, завершаются вызовом API
«MeasurementUpdale» («Обновить измерения»).
Путь «Path»: 1451/TransducerAccess/StartReadData.
Метод «GET» («Получить»): запускает извлечение данных преобразователя, доступного для за
данного ИМП СПП (хоста), и возвращает код ошибки в заданном формате.
12.3.1.2.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- u in ti6 tim id — значение «timid» ИМП. содержащего канал преобразователя для считывания:
191