ГОСТ Р 56947—2016
данных для каждого входного аргумента. Данный API соответствует
Args: :Ulntl6 sendCommand(),
как описано в 10.3.5.
Путь «Path»: 1451/TransducerManager/SendCommand.
Метод «POST» («Отправить»): отправляет команду каналу преобразователя или ИМП СПП (хо
ста) и возвращает результат в заданном формате.
12.5.1.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
-u:nt!6 timid —
значение «timid» заданного ИМП;
- и
inti6 channelid
— значение «channellD» заданного канала преобразователя;
-Timel>uration timeout
— данный аргумент определяет время ожидания после записи данных
без генерации ошибки тайм-аута в случае неполучения ответа. Значения «secs==0» и «nsecs==-1»
указывают на непрерывное (бесконечное) время ожидания. Использование значений «непрерывное
(бесконечное) время ожидания» является крайне опасным, поскольку при этом ресурс может быть за
блокирован;
-Uint8 cmdCiassld
— задает требуемый код класса команды, как описано в 7.1 и таблице 15;
- Uint8cmdFunctionld
— задает требуемый код функции команды. Данные коды
«cmdFunctionlds» определены при описании каждой команды в разделе 7 и перечисляются в командной
ЭТДП для нестандартных команд:
-ArgumentArray inArgs
— представляет собой входные аргументы в форме массива аргумен
тов «ArgumentArray»;
-_string ResponseFormat —
задает формат ответа, как это определено в 12.1.2.
12.5.1.2 HTTP-ответ для API «SendCommand» («Отправить команду»)
Ответ на вызов данного API должен содержать следующие параметры:
-иInti6 errorCode —
информация об ошибке, как определено в 9.3.1.2;
-UIntl6 timid —
значение «timid» заданного ИМП;
-uintie ChannellD —
значение «channellD» заданного канала преобразователя;
-ArgumentArray outArgs —
возвращаемые выходные аргументы.
12.5.1.3 Схема XML-ответа для API «SendCommand» («Отправить команду»)
Если формат ответа — «XML», то для ответа должна быть использована следующая схема:
<?xml version-»1.0» encoding-»Ul’F-8»?>
<xs:schema xmlns:xs-»
http://www.w3.org/2001/XMLSchema»
xmlns:stml-
http://grouper.ieee.org/groups/1451/0/1451HTTPAPI
<xs:complexType name~»SendCommandHTTPResponse»>
<xs:sequence>
<xs:element name-»errorCode» type-»stml:UIntl6»/>
<xs:element name-»timld>> type-»stml :UIntl6Array»/>
<xs:element name-"channelld’’ type-"stml:UIntl6”/>
<xs:element name-’’outArgs” type-”stml:ArgumentArrayType"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
12.5.2 Интерфейс «StartCommand» («Запустить команду»)
Данный метод осуществляет неблокирующую операцию. Формат входных аргументов зависит
от вида команды. Отправитель запроса должен убедиться, что использует правильные типы дан
ных для каждого входного аргумента. Данный API соответствует
Args: :Ulntl6 StartCommand О ,
как описано в 10.3.7. Возвращаемый массив аргументов «ArgumentArray» завершается вызовом API
«CompleteCommand» («Завершить команду»).
Путь «Path»: 1451/TransducerManager/StartCommand.
Метод «GET» («Получить»): отправляет команду каналу преобразователя или ИМП СПП (хоста)
и возвращает результат в заданном формате.
12.5.2.1 Входные параметры
Следующие параметры должны поставляться вместе с вызовом данного API:
-U2ntl6 timid —
значение «timid» заданного ИМП;
-Ulntl6 channelld —
значение «channellD» заданного канала преобразователя или значе
ние «0». адресованное ИМП;
-Timelnstance triggerTime —
задает время начала операции;
1 9 9