ГОСТ Р 56947—2016
<xs:elem ent na m e-"tim id" ty p e -” s tm lrU In tl6 "/>
<xs:elem er.t r.am e-"trar.sducerld" typei-v’stm l:U lr.cL 6 w/>
<xs: elem ent r.am e-"transducerD ata“ ty p e -” s tm l:Argum entArrayTypew/>
< /x s : aequence>
< /x s : complexType>
</xs:schem a>
12.3.2 Интерфейс «TransducerWriteDataAPI» («API записи данных преобразователя»)
API записи преобразователя используется для записи данных (значения) канала преобразователя.
12.3.2.1 Интерфейс «WriteData» («Записать данные»)
В данном API осуществляется запись данных преобразователя заданного преобразователя для
заданного ИМП заданного СПП (хоста). Данный метод выполняет блокирующую запись заданных кана
лов преобразователя или преобразователей. Данный API соответствует A rgs: :U ln tl6 w rite D a ta (), как
описано в 10.2.7.
Путь «Path»: 1451/TransducerAccess/WriteData.
Метод «POST» («Отправить»): записывает данные преобразователя в назначенный канал пре
образователя для заданного ИМП. подключенного к СПП (хосту).
12.3.2.1.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- u in tl6 tim id — значение «timid» ИМП. содержащего канал преобразователя для записи;
- иI n t i б channelid — значение «ChannellD» заданного канала преобразователя;
- Tim eO uratior. tim eo ut — данный аргумент определяет время ожидания после записи данных
без генерации ошибки тайм-аута в случае неполучения ответа. Значения «secs==0» и «nsecs==-1»
указывают на непрерывное (бесконечное) время ожидания. Использование значений «непрерывное
(бесконечное) время ожидания» является крайне опасным, поскольку при этом ресурс может быть за
блокирован;
- Ulnt.8 SamplingMode — данный аргумент задает механизм осуществления выборки. Подроб
ная информация представлена в 5.10.1 и 7.1.2.4;
- Argum entArray transducerD ata — данный массив содержит данные для записи в заданный
канал преобразователя выбранного ИМП;
- _ S trin g responsefc’ormat — задает формат ответа, как это определено в 12.1.2.
12.3.2.1.2 HTTP-ответ для API «WriteData» («Записать данные»)
Ответ на вызов данного API должен содержать следующие параметры:
- U ln tl6
- U ln tl6
errorC ode — информация об ошибке, как определено в 9.3.1.2;
tim id — значение «timid» заданного ИМП:
- D in t 16 cha nn elid — значение «channellD» заданного канала преобразователя.
12.3.2.1.3 Схема XML-ответа для API «WriteData» («Записать данные»)
Если формат ответа — «XML», то для ответа должна быть использована следующая схема:
<?xmi v e rs io n -» l.0» encoding-»UTF-8»?>
<xs: schema xm ln s:xs-»
h ttp ://www.w3.org/2001/XML3cheraa»
xm lns: s tm l-
h ttp ://g ro u p e r. ieee.org/groups/1451/0/1451H TTPAPl
<xs rcomplexType name-"WriteDataHTTPResponse">
<xs:sequence>
<xs:elem ent nam e-"errorC ode" ty p e -” s tm l: U in tl6 w/>
<xs:elem ent name-” tim ld w ty p e -"s tm l:U In tl6 A rra y "/>
<xs:elem ent nam e-"channelld" ty p e -” s tm l: U In tl6 ” />
< /x s : sequence>
< /x s : complexType>
</xs:schem a>
12.3.2.2 Интерфейс «StartWriteData» («Запустить запись данных»)
В данном API осуществляется запись данных преобразователя заданного преобразователя для
заданного ИМП заданного СПП (хоста). Данный метод выполняет неблокирующую запись указанно го
канала преобразователя. Пользователь несет ответственность за определение завершения ко манды
путем отправки вызова «SendCommand» («Отправить команду») (см. 12.5.1) с заданием ко манды
«ReadStatusEventRegister» («Считать регистр статуса события») (см. 7.1.1.8) и проверки бита
«DataProcessed» («Данные обработаны») (см. 5.13.10). который должен быть установлен. Данный API
соответствует A rg s: :U In tl6 sta rtW rite D a ta О , как описано в 10.2.9.
1 9 3