Transcription of ONVIF Device IO Service Specification
1 ONVIF 1 Device -IO Spec. Ver. ONVIF Device IO Service Specification Version December, 2013 ONVIF 2 Device -IO Spec. Ver. 2008-2012 by ONVIF : Open Network Video Interface Forum All rights reserved. Recipients of this document may copy, distribute, publish, or display this document so long as this copyright notice, license and disclaimer are retained with all copies of the document. No license is granted to modify this document. THIS DOCUMENT IS PROVIDED "AS IS," AND THE CORPORATION AND ITS MEMBERS AND THEIR AFFILIATES, MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THIS DOCUMENT ARE SUITABLE FOR ANY PURPOSE; OR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
2 IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THIS DOCUMENT, WHETHER OR NOT (1) THE CORPORATION, MEMBERS OR THEIR AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR (2) SUCH DAMAGES WERE REASONABLY FORESEEABLE, AND ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THIS DOCUMENT. THE FOREGOING DISCLAIMER AND LIMITATION ON LIABILITY DO NOT APPLY TO, INVALIDATE, OR LIMIT REPRESENTATIONS AND WARRANTIES MADE BY THE MEMBERS AND THEIR RESPECTIVE AFFILIATES TO THE CORPORATION AND OTHER MEMBERS IN CERTAIN WRITTEN POLICIES OF THE CORPORATION. ONVIF 3 Device -IO Spec. Ver. CONTENTS 1 Scope 5 2 Normative references 5 3 Terms and Definitions 5 5 Abbreviations .. 5 4 Overview 6 5 Service 8 VideoOutputs.
3 8 GetVideoOutputs .. 8 VideoOutputConfiguration .. 8 8 SetVideoOutputConfiguration .. 9 GetVideoOutputConfigurationOptions .. 10 VideoSources .. 10 GetVideoSources .. 10 VideoSourceConfiguration .. 11 GetVideoSourceConfiguration .. 11 SetVideoSourceConfiguration .. 11 GetVideoSourceConfigurationOptions .. 12 AudioOutputs .. 13 GetAudioOutputs .. 13 AudioOutputConfiguration .. 13 13 SetAudioOutputConfiguration .. 14 GetAudioOutputConfigurationOptions .. 14 AudioSources .. 15 GetAudioSources .. 15 AudioSourceConfiguration .. 16 GetAudioSourceConfiguration .. 16 SetAudioSourceConfiguration .. 16 GetAudioSourceConfigurationOptions .. 17 Relay Outputs .. 18 Get relay outputs .. 18 Get relay output options .. 18 Set relay output settings .. 19 Trigger relay output .. 20 Digital Inputs .. 21 GetDigitalInputs .. 21 SerialPorts.
4 21 GetSerialPorts .. 21 SerialPort Configuration .. 22 GetSerialPortConfiguration .. 22 SetSerialPortConfiguration .. 23 GetSerialPortConfigurationOptions .. 24 Send and/or Receive serial command .. 25 Capabilities .. 27 Events .. 28 DigitalInput State Change .. 28 ONVIF 4 Device -IO Spec. Ver. Relay Output Trigger .. 28 Configuration Change .. 28 Service specific fault codes .. 30 Annex A. Revision History 31 ONVIF 5 Device -IO Spec. Ver. 1 Scope This document defines the web Service interface for all physical inputs and outputs. For most inputs and outputs this is a pure get interface while for relays also configuration and control is include. Web Service usage is outside of the scope of this document. Please refer to the ONVIF core Specification . 2 Normative references ONVIF Core Specification < > ONVIF Media Service Specification < > 3 Terms and Definitions Definitions Input/Output (I/O) Currently relay ports and Video/Audio Inputs/Outputs are handled.
5 Abbreviations ONVIF Open Network Video Interface Forum ONVIF 6 Device -IO Spec. Ver. 4 Overview The DevideIO Service offers commands to retrieve and configure the settings of physical inputs and outputs of a Device . The DeviceIO Service supports the configuration of the following Device interfaces: VideoOutputs VideoSources AudioOutputs AudioSources RelayOutputs DigitalInputs Send and/or Receive serial data communication The following commands list existing interfaces: GetVideoOutputs Gets all existing video outputs of the Device . GetVideoSources Gets all existing video sources of the Device . GetAudioOutputs Gets all existing audio outputs of the Device . GetAudioSources Gets all existing audio sources of the Device GetRelayOutputs Gets all existing relay outputs of the Device GetDigitalInputs Gets all existing digital inputs of the Device GetSerialPorts - Gets a list of all available serial ports and their settings.
6 For VideoOutputs, VideoSources, AudioOutputs and AudioSources the following commands are supported: Set< Device name>Configuration Modifies the configuration of a specific interface. Get< Device name >Configuration Gets the configuration of a specific interface. Get< Device name >ConfigurationOptions Gets the supported property values for a specific interface. RelayOutputs supports following commands: SetRelayOutputSettings Modifies the configuration of a relay output SetRelayOutputState Sets the logical state ONVIF 7 Device -IO Spec. Ver. SerialPorts additionally support the following command: Send and/or Receive serial command - Transmit/receive generic controlling data to/from a serial Device WSDL for the DeviceIO Service is specified in Table 1: Referenced namespaces (with prefix) Prefix Namespace URI env ter xs tt tmd ONVIF 8 Device -IO Spec.
7 Ver. 5 Service This Service offers commands to retrieve and configure the physical Inputs and Outputs of a Device . Commands to request the available video and audio in- and outputs are defined as well as commands to request the available relays. This Service also offers functions to request and change the configuration of these entities. A Device that has physical sources and outputs SHALL support this Service as described in [ ]. Some functionality of this Service overlaps with functionality that is defined in the Media Service . If a Device ( a NVT) needs to implement both services it should use the commands that are defined in this Service to configure its audio in- and outputs or its video sources. VideoOutputs The VideoOutput type represents the physical Video Outputs of a Device that can be connected to a monitor to display the video signal.
8 The structure contains the Layout Settings that can be configured using the Display Service . GetVideoOutputs This command lists all available video outputs of a Device . A Device that has one or more physical video outputs shall support listing of available video outputs through the GetVideoOutputs command. Table 2: GetVideoOutputs command GetVideoOutputs Access Class: READ_MEDIA Message name Description GetVideoOutputsRequest This is an empty message. GetVideoOutputsResponse Contains a list of structures describing all available video outputs of the Device . If a Device has no VideoOutputs an empty list is returned. tt:VideoOutput VideoOutputs [0][unbounded] Fault codes Description No specific fault codes. VideoOutputConfiguration GetVideoOutputConfiguration This operation requests the configuration of a Video Output.
9 A Device that has one or more Video Outputs shall support the retrieval of the VideoOutputConfiguration through this command. ONVIF 9 Device -IO Spec. Ver. Table 3: GetVideoOutputConfiguration command GetVideoOutputConfiguration Access Class: READ_MEDIA Message name Description GetVideoOutputConfigurationRequest This message contains the token of the VideoOutput. tt:ReferenceToken VideoOutputToken [1][1] GetVideoOutputConfigurationResponse This message contains the requested VideoOutputConfiguration with the matching token. tt:VideoOutputConfiguration VideoOutputConfiguration [1][1] Fault codes Description env:Sender ter:InvalidArgVal ter:NoVideoOutput The requested VideoOutput indicated with VideoOutputToken does not exist. SetVideoOutputConfiguration This operation modifies a video output configuration. A Device that has one or more video outputs shall support the setting of its video output configuration through this command.
10 Table 4: SetVideoOutputConfiguration command SetVideoOutputConfiguration Access Class: ACTUATE Message name Description SetVideoOutputConfiguration-Request The Configuration element contains the modified VideoOutput configuration. The ForcePersistence element determines if the configuration changes shall be stored and remain after reboot. If true, changes shall be persistent. If false, changes MAY revert to previous values after reboot. tt:VideoOutputConfiguration Configuration [1][1] xs:boolean ForcePersistence [1][1] SetVideoOutputConfiguration-Response This message is empty. Fault codes Description env:Sender ter:InvalidArgVal ter:NoVideoOutput The requested Video Output does not exist env:Sender ter:InvalidArgVal ter:ConfigModify The configuration parameters are not possible to set. ONVIF 10 Device -IO Spec. Ver. GetVideoOutputConfigurationOptions This operation requests the VideoOutputConfigurationOptions of a VideoOutput.
