ГОСТ Р 56947—2016
Путь «Path»: 1451/TransducerAccess/StartWriteData.
Метод «POST» («Отправить»): записывает данные преобразователя в назначенный канал пре
образователя в заданном ИМП. подключенном к СПП (хосту), и возвращает результат в заданном фор
мате.
12.3.2.2.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- L’lr .tl6
- u :n tl6
tim id — значение «timid» ИМП. содержащего канал преобразователя для считывания:
cha nn elid — значение «ChanneilD» заданного преобразователя;
- Tim elnstance trig g e rT im e —данный аргумент задает время, когда следует начать операцию
записи;
- Tim eD uratior. tim eout — данный аргумент определяет время ожидания после записи данных
без генерации ошибки тайм-аута в случае неполучения ответа. Значения «secs==0» и «nsecs==-1»
указывают на непрерывное (бесконечное) время ожидания. Использование значений «непрерывное
(бесконечное) время ожидания» является крайне опасным, поскольку при этом ресурс может быть за
блокирован;
- U lnt8 SamplingMode — данный аргумент задает триггерный механизм. Подробная информа
ция представлена в 5.10.1 и 7.1.2.4;
- Argum entArray transducerD ata — данный массив содержит данные, считанные из заданно
го канала преобразователя выбранного ИМП;
- _ S trin g responseFormat — задает формат ответа, как это определено в 12.1.2.
12.3.2.2.2 HTTP-ответ для API «StartWriteData» («Начать запись данных»)
Ответ на вызов данного API должен содержать следующие параметры:
- u :n t!6
- u in tl€
- u in tl6
errorC ode — информация об ошибке, как определено в 9.3.1.2;
tim id — значение «timid» заданного ИМП;
cha nn elid — значение «channellD» заданного канала преобразователя.
12.3.2.2.3 Схема XML-ответа для API «StartWriteData» («Начать запись данных»)
Если формат ответа — «ХМ1_». то для ответа должна быть использована следующая схема:
<?xml v e rs io n -» 1.0» encoding-»UTF-8»?>
< xs: schema xm ln s:xs-»
h ttp ://www.w3.org/2001/XMLSchema»
xm lns: s tm l-
h ttp ://g ro u p e r.ie e e .o rg /g ro u p s /1 4 51/0 /1 451HTTPAPI
<xs:com plexType nam e-"StartW riteDataHTTPRespcnse">
<xs: sequence»
<xs:elem er.t nam e-"errorC ode” ty p e -"s tm l: L *In tl6 "/>
<xs:elem ent na m e-"tim ld" ty p e -” s tm l:U In t!6 A rra y "/»
<xs:elem er.t nam e-"channelId” ty p e -"s tm l: U In tl6 ” />
< /x s : sequence»
< /x s : complexType»
</xs:schem a>
12.4 API управления ЭТДП
API управления ЭТДП включают в себя интерфейсы: «ReadTEDS» («Считать ЭТДП») для считы
вания ЭТДП и «WriteTEDS» («Записать ЭТДП») для записи ЭТДП.
12.4.1 Интерфейс «ReadTEDS» («Считать ЭТДП»)
Данный API поддерживает получение данных ЭТДП. связанных с указанным каналом преобразо
вателя или ИМП от заданного СПП (хоста). Данный метод осуществляет считывание требуемого блока
ЭТДП из кэш-памяти ЭТДП. Если считывание ЭТДП из кэш-памяти недоступно, то метод будет считы
вать ЭТДП из ИМП. Данный API соответствует A rgs: :U In tl6 readTeds <), как описано в 10.4.1.
Путь «Path»: 1451/TEDSManager/ReadTEDS.
Метод «GET» («Получить»): извлекает ЭТДП из заданного канала преобразователя или ИМП на
СПП (хосте) и возвращает результат в заданном формате.
12.4.1.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
- U In tl6
- U ln tl6
tim id — значение «timid» ИМП. содержащего канал преобразователя для считывания:
channelid — значение «channellD» заданного канала преобразователя. Данный аргу
мент равен «0». если осуществляется доступ к ЭТДП. связанной со всем ИМП;
1 9 4