22.06

doc/AppMgmt.xml

@@ -4,19 +4,19 @@
   <info>
     <title>Application Management Service Specification</title>
     <titleabbrev>App Mgmt</titleabbrev>
-    <releaseinfo>21.12</releaseinfo>
+    <releaseinfo>22.06</releaseinfo>
     <author>
       <orgname>ONVIF™</orgname>
       <uri>www.onvif.org</uri>
     </author>
-    <pubdate> December, 2021</pubdate>
+    <pubdate> June, 2022</pubdate>
     <mediaobject>
       <imageobject>
         <imagedata fileref="media/logo.png" contentwidth="60mm"/>
       </imageobject>
     </mediaobject>
     <copyright>
-      <year>2008-2021</year>
+      <year>2008-2022</year>
       <holder>ONVIF™ All rights reserved.</holder>
     </copyright>
     <legalnotice>
@@ -64,6 +64,14 @@
         </author>
         <revremark>Fix inconsistencies between appmgmt schema and doc.</revremark>
       </revision>
+      <revision>
+        <revnumber>22.06</revnumber>
+        <date>Jun-2022</date>
+        <author>
+          <personname>Sujith Raman</personname>
+        </author>
+        <revremark>Correct namespace of event State member.</revremark>
+      </revision>
     </revhistory>
   </info>
   <chapter>
@@ -584,7 +592,7 @@
     <tt:SimpleItemDescription Name="AppID" Type="xs:string"/>
   </tt:Source>
   <tt:Data>
-    <tt:SimpleItemDescription Name="State" Type="tam:State"/>
+    <tt:SimpleItemDescription Name="State" Type="ans:AppState"/>
     <tt:SimpleItemDescription Name="Status" Type="xs:string"/>
   </tt:Data>
 </tt:MessageDescription>]]></programlisting>

doc/DeviceIo.xml

@@ -4,19 +4,19 @@
   <info>
     <title>Device IO Service Specification</title>
     <titleabbrev>Device-IO</titleabbrev>
-    <releaseinfo>19.06</releaseinfo>
+    <releaseinfo>22.06</releaseinfo>
     <author>
       <orgname>ONVIF™</orgname>
       <uri>www.onvif.org</uri>
     </author>
-    <pubdate>June, 2019</pubdate>
+    <pubdate>June, 2022</pubdate>
     <mediaobject>
       <imageobject>
         <imagedata fileref="media/logo.png" contentwidth="60mm" />
       </imageobject>
     </mediaobject>
     <copyright>
-      <year>2008-2020</year>
+      <year>2008-2022</year>
       <holder>ONVIF™ All rights reserved.</holder>
     </copyright>
     <legalnotice>
@@ -147,6 +147,14 @@ Change Request 2065</revremark>
         </author>
         <revremark>Change Request 2454</revremark>
       </revision>
+      <revision>
+        <revnumber>22.06</revnumber>
+        <date>Jun-2022</date>
+        <author>
+          <personname>Sergey Bogdanov</personname>
+        </author>
+        <revremark>Rename sections to show real name of service command.</revremark>
+      </revision>
     </revhistory>
   </info>
   <chapter>
@@ -967,7 +975,7 @@ Change Request 2065</revremark>
         </variablelist>
       </section>
       <section>
-        <title>Send ReceiveSerialCommand</title>
+        <title>SendReceiveSerialCommand</title>
         <para>This section describes operations to transmit/receive <emphasis>generic</emphasis> controlling data to/from a serial device that is connected to the serial port of the device.</para>
         <para>This operation can be used for the following purposes.</para>
         <itemizedlist>
@@ -1041,7 +1049,7 @@ Change Request 2065</revremark>
       </section>
     </section>
     <section>
-      <title>Capabilities</title>
+      <title>GetServiceCapabilities</title>
       <para>The capabilities reflect optional functions and functionality of a service. The information is static and does not change during device operation. </para>
       <variablelist role="op">
         <varlistentry>

doc/ExportFileFormat.xml

@@ -4,19 +4,19 @@
   <info>
     <title>Export File Format Specification</title>
     <titleabbrev>ExportFileFormat</titleabbrev>
-    <releaseinfo>21.12</releaseinfo>
+    <releaseinfo>22.06</releaseinfo>
     <author>
       <orgname>ONVIF™</orgname>
       <uri>www.onvif.org</uri>
     </author>
-    <pubdate>December, 2021</pubdate>
+    <pubdate>June, 2022</pubdate>
     <mediaobject>
       <imageobject>
         <imagedata fileref="media/logo.png" contentwidth="60mm"/>
       </imageobject>
     </mediaobject>
     <copyright>
-      <year>2013-2021</year>
+      <year>2013-2022</year>
       <holder>ONVIF™ All rights reserved.</holder>
     </copyright>
     <legalnotice>
@@ -102,6 +102,14 @@
         </author>
         <revremark>Add timed metadata.</revremark>
       </revision>
+      <revision>
+        <revnumber>22.06</revnumber>
+        <date>Jun-2022</date>
+        <author>
+          <personname>Hans Busch</personname>
+        </author>
+        <revremark>Add location information.</revremark>
+      </revision>
     </revhistory>
   </info>
   <chapter>
@@ -124,6 +132,8 @@
     <para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://csrc.nist.gov/publications/detail/fips/180/4/final"></link>&gt;</para>
     <para>ISO/IEC 14888-2 Information technology – Security techniques – Digital signatures with appendix – Part 2: Integer factorization based mechanisms</para>
     <para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.iso.org/obp/ui/#iso:std:iso-iec:14888:-2:ed-2:v1:en"></link>&gt;</para>
+    <para>ETSI TS 126 244 3GPP file format </para>
+    <para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.etsi.org/deliver/etsi_ts/126200_126299/126244/16.01.00_60/ts_126244v160100p.pdf"></link>&gt;</para>
     <para>PKCS#1, v2.1 RSA Cryptographic Standard</para>
     <para>NIST FIPS 186 Digital Signature Standard (DSS)</para>
     <para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://csrc.nist.gov/publications/detail/fips/186/4/final"></link>&gt;</para>
@@ -178,6 +188,30 @@
       <para>The ISO Base File Format has been mainly designed for storing movies and music clips. It defines a media timeline relative to the beginning which is defined as time zero. For Video Surveillance purposes it is important that the file preserves the absolute time of the captured frames. This specification refers to ISO 23000-10 for storing the absolute start time. All other times can be derived using the relative time data defined in ISO/IEC 14496-12. Additional to this time information time corrections can be stored during the sealing process.</para>
       <para>In order to improve random access the ISOM baseline requires the movie fragment table at the end of the file. This redundant information does not require the protection seal.</para>
     </section>
+    <section>
+      <title>Location</title>
+      <para>Three mechanism for storing location information are defined for MP4 files by the mobile
+        industry.</para>
+      <para>This specification refers to the ETSI standard which has defined means for textual and
+        spherical representation using the so called 'loci' box. </para>
+      <para>Beside the ETSI standard two defacto standards exist for Android and iOS based mobile
+        phones:</para>
+      <itemizedlist>
+        <listitem>
+            <para>Android phones use the '©xyz' box holding an alphanumeric string with lon and lat
+              degrees.</para></listitem>
+        <listitem>
+            <para>Mobile phones based on iOS store similar information in sub atoms of the meta box.
+              Note that this meta box is incompatible with the ISO Base File Format
+              specification.</para>
+        </listitem>
+      </itemizedlist>
+      <para>The location information is designated to provide a best effort for the video location
+        in order to be able to geo-locate the video. For fixed cameras the location should
+        approximate to the intersection of the camera axis with the ground location. For moving
+        cameras such an appoach may not be feasible and a fallback to the camera location may be
+        more suitable.</para>
+    </section>
     <section>
       <title>Sealing</title>
       <para>All data that a user wishes to carry away separately are put into a metaphorical bag. The bag is then sealed to enable tamper detection. Anyone wanting to use the data from the bag first examines the seal. <phrase>The data in the bag are identical with the original data as long as the seal is intact.</phrase> Here, the metaphorical bag is represented by a file and the seal is represented by a signature over all data in the file.</para>
@@ -348,6 +382,52 @@ class CorrectStartTimeBox extends Box (‘cstb’) {
         </varlistentry>
       </variablelist>
     </section>
+    <section>
+      <title>Location information</title>
+      <para>When available, the location of the camera view shall be provided as 'loci' box
+        according to ETSI TS 126 244. See below informal repetition of the definition.</para>
+      <para>
+        <emphasis role="bold">Location Box</emphasis>
+      </para>
+      <programlisting>Box Types: 'loci' 
+Container: User Data Box (‘udta’)
+Mandatory: No 
+Quantity:  Zero or one</programlisting>
+      <para>
+        <emphasis role="bold">Syntax</emphasis>
+      </para>
+      <programlisting><![CDATA[aligned(8) 
+class  LocationInformationBox extends FullBox (‘loci’) {
+  UInt(16) language;
+  String Name;
+  UInt(8) Role;
+  UInt(32) Logitude;
+  UInt(32) Latitude;
+  UInt(32) Altitude;
+  String AstronomicalBody;
+  String Notes;
+)
+]]></programlisting>
+      <para>All characters of string based fields shall be encoded as UTF-8. The following semantics apply:</para>
+      <variablelist>
+        <varlistentry>
+          <term>Role</term>
+          <listitem><para>Shall be '1' - real location</para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Name</term>
+          <listitem><para>Human readable street address of the location, optionally including building internal addressing.</para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Longitude and Latitude</term>
+          <listitem><para>16.16 bit fixed point angle in degree.</para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Altitude</term>
+          <listitem><para>Height of the location in meter.</para></listitem>
+        </varlistentry>
+      </variablelist>
+    </section>
     <section>
       <title>Timed metadata</title>
       <para>ONVIF metadata supports transport of frame related scene description, events and PTZ
@@ -655,6 +735,8 @@ class AdditionalUserInformationBox
                 <emphasis role="bold">stts</emphasis><superscript>1</superscript>       Sample index by time 
                 <emphasis role="bold">stsc</emphasis><superscript>1</superscript>       Sample to chunk mapping
                 <emphasis role="bold">stco</emphasis><superscript>1</superscript>       List of Chunk offsets inside 'mdat' relative to file begin 
+    <emphasis role="bold">udta</emphasis><superscript>1</superscript>                   User data
+        <emphasis role="bold">loci</emphasis><superscript>4</superscript>               Geo location information
     <emphasis role="bold">trak</emphasis><superscript>1</superscript>                   Third track with timed metadata
         <emphasis role="bold">tkhd</emphasis><superscript>1</superscript>               Track header with creation time, timescale, duration, track ID
         <emphasis role="bold">mdia</emphasis><superscript>1</superscript>
@@ -708,6 +790,8 @@ class AdditionalUserInformationBox
       <superscript>2</superscript> ISO/IEC 23000-10</para>
     <para>
       <superscript>3</superscript> This specification</para>
+    <para>
+      <superscript>4</superscript> ETSI TS 126 244</para>
   </appendix>
   <appendix role="revhistory">
     <title>Revision History</title>

doc/Imaging.xml

@@ -4,19 +4,19 @@
   <info>
     <title>Imaging Service Specification</title>
     <titleabbrev>Imaging</titleabbrev>
-    <releaseinfo>19.06</releaseinfo>
+    <releaseinfo>22.06</releaseinfo>
     <author>
       <orgname>ONVIF™</orgname>
       <uri>www.onvif.org</uri>
     </author>
-    <pubdate>June, 2019</pubdate>
+    <pubdate>June, 2022</pubdate>
     <mediaobject>
       <imageobject>
         <imagedata fileref="media/logo.png" contentwidth="60mm" />
       </imageobject>
     </mediaobject>
     <copyright>
-      <year>2008-2020</year>
+      <year>2008-2022</year>
       <holder>ONVIF™ All rights reserved.</holder>
     </copyright>
     <legalnotice>
@@ -126,6 +126,14 @@ Change Request 1843</revremark>
         <revremark>Added Focus Modes
 Change Request 2384, 2431, 2477, 2478</revremark>
       </revision>
+      <revision>
+        <revnumber>22.06</revnumber>
+        <date>June-2022</date>
+        <author>
+          <personname>Fredrik Svensson</personname>
+        </author>
+        <revremark>Change the "role" attribute for request access class.</revremark>
+      </revision>
     </revhistory>
   </info>
   <chapter>
@@ -569,9 +577,13 @@ Change Request 2384, 2431, 2477, 2478</revremark>
               <para role="text">The requested video source does not support imaging settings.</para>
             </listitem>
           </varlistentry>
+          <varlistentry>
+            <term>access class</term>
+            <listitem>
+              <para role="access">READ_MEDIA</para>
+            </listitem>
+          </varlistentry>
         </variablelist>
-        <para>Access Class: </para>
-        <para>	READ_MEDIA</para>
         <para>If the video source supports any of the imaging settings as defined by the ImagingSettings type in the [ONVIF Schema], then it should be possible to retrieve the imaging settings from the device through the GetImagingSettings command.</para>
       </section>
       <section xml:id="_Toc86847688">
@@ -644,9 +656,13 @@ Change Request 2384, 2431, 2477, 2478</revremark>
               <para role="text">The requested VideoSource does not support imaging settings.</para>
             </listitem>
           </varlistentry>
+          <varlistentry>
+            <term>access class</term>
+            <listitem>
+              <para role="access">READ_MEDIA</para>
+            </listitem>
+          </varlistentry>
         </variablelist>
-        <para>Access Class: </para>
-        <para>READ_MEDIA</para>
       </section>
     </section>
     <section xml:id="_Toc214944255">

doc/RecordingSearch.xml

@@ -4,12 +4,12 @@
   <info>
     <title>Recording Search Specification</title>
     <titleabbrev>RecordingSearch</titleabbrev>
-    <releaseinfo>21.12</releaseinfo>
+    <releaseinfo>22.06</releaseinfo>
     <author>
       <orgname>ONVIF™</orgname>
       <uri>www.onvif.org</uri>
     </author>
-    <pubdate>December, 2021</pubdate>
+    <pubdate>June, 2022</pubdate>
     <mediaobject>
       <imageobject>
         <imagedata fileref="media/logo.png" contentwidth="60mm" />
@@ -149,6 +149,14 @@ Change Request 1843, 2050, 2053, 2055, 2065</revremark>
         </author>
         <revremark>Change the "role" attribute for request access class.</revremark>
       </revision>
+      <revision>
+        <revnumber>22.06</revnumber>
+        <date>June-2022</date>
+        <author>
+          <personname>Fredrik Svensson</personname>
+        </author>
+        <revremark>Change the "role" attribute for request access class.</revremark>
+      </revision>
     </revhistory>
   </info>
   <chapter>
@@ -1337,13 +1345,13 @@ http://www.onvif.org/ver10/tptz/ZoomSpaces/PositionGenericSpace
             <para role="text">The search token is invalid.</para>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term>access class</term>
+          <listitem>
+            <para role="access">READ_MEDIA</para>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <para>ACCES CLASS:</para>
-      <itemizedlist>
-        <listitem>
-          <para>READ_MEDIA</para>
-        </listitem>
-      </itemizedlist>
     </section>
     <section>
       <title>GetServiceCapabilities</title>