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.

3 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 .. 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.

4 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 .. 21 GetSerialPorts .. 21 SerialPort Configuration .. 22 GetSerialPortConfiguration .. 22 SetSerialPortConfiguration .. 23 GetSerialPortConfigurationOptions .. 24 Send and/or Receive serial command .. 25 Capabilities .. 27 Events.

5 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.

6 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 .

7 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. 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.

8 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. Ver. 5 Service This Service offers commands to retrieve and configure the physical Inputs and Outputs of a Device .

9 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.

10 VideoOutputs The VideoOutput type represents the physical Video Outputs of a Device that can be connected to a monitor to display the video signal. 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.