1<?xml version='1.0' encoding='utf-8'?>
2<!-- Copyright (C) 2019 The Android Open Source Project
3
4     Licensed under the Apache License, Version 2.0 (the "License");
5     you may not use this file except in compliance with the License.
6     You may obtain a copy of the License at
7
8          http://www.apache.org/licenses/LICENSE-2.0
9
10     Unless required by applicable law or agreed to in writing, software
11     distributed under the License is distributed on an "AS IS" BASIS,
12     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13     See the License for the specific language governing permissions and
14     limitations under the License.
15-->
16
17<!-- Author : changyeon@google.com
18     Version: 1.0
19-->
20
21<!ELEMENT configuration (system,camera,display)>
22
23<!-- System Configuration that contains below informations:
24     - Number of cameras available to EVS.
25-->
26<!ELEMENT system (num_cameras)>
27    <!-- The number of cameras that are available to EVS on the vehicle.
28         This must be equal to number of camera elements of device element.
29    -->
30    <!ELEMENT num_cameras EMPTY>
31    <!ATTLIST num_cameras
32        value CDATA #REQUIRED
33    >
34
35<!-- Device descriptions -->
36<!ELEMENT camera (group|device)+>
37    <!-- Camera group descriptor
38         @attr group_id    : Unique logical camera group identifier.  Camera device use this to be
39                             a member of the group.
40         @attr device_id   : Comma-separated list of unique camera identifiers of member camera
41                             devices.
42         @attr synchronized: NONE if cameras are not synchronized.
43                             CALIBRATED if cameras are synchronized by hardware.
44                             APPROXIMATE if cameras are synchronized by other means.
45    -->
46    <!ELEMENT group (caps)>
47    <!ATTLIST group
48        group_id        CDATA #REQUIRED
49        device_id       CDATA #REQUIRED
50        synchronized    CDATA #REQUIRED
51    >
52    <!-- Please note that a camera group may have stream configurations.  If it has, all stream
53         configurations must be supported by each camera device in the group.
54    -->
55
56    <!-- Camera device descriptor
57         @attr id          : Unique camera identifier.
58         @attr position    : Must be one of front, rear, left, or right.
59    -->
60    <!ELEMENT device (caps,characteristics*)>
61    <!ATTLIST device
62        id              CDATA #REQUIRED
63        position        CDATA #REQUIRED
64    >
65        <!-- Camera metadata that contains:
66             - A list of supported controls.
67             - A list of supported stream configurations.
68        -->
69        <!ELEMENT caps (supported_controls|stream)*>
70            <!-- A list of supported controls.
71                 This must be a subset of android.hardware.automotive.evs@1.1::CameraParam.
72            -->
73            <!ELEMENT supported_controls (control)+>
74                <!-- A camera control parameter with its valid value range -->
75                <!ELEMENT control EMPTY>
76                <!ATTLIST control
77                    name    CDATA #REQUIRED
78                    min     CDATA #REQUIRED
79                    max     CDATA #REQUIRED
80                    step    CDATA '1'
81                >
82
83            <!-- A list of supported output sizes. -->
84            <!ELEMENT stream EMPTY>
85            <!ATTLIST stream
86                id        CDATA #REQUIRED
87                width     CDATA #REQUIRED
88                height    CDATA #REQUIRED
89                format    CDATA #REQUIRED
90                framerate CDATA #REQUIRED
91            >
92
93        <!-- Camera module characteristics including its optics and imaging sensor. -->
94        <!ELEMENT characteristics (parameter)*>
95                <!ELEMENT parameter EMPTY>
96                <!-- A name of camera characteristic.  This must be a subset of
97                     android.hardware.automotive.evs@1.1::CameraCharacteristics.
98                -->
99                <!ATTLIST parameter
100                    name  CDATA #REQUIRED
101                    type  CDATA #REQUIRED
102                    size  CDATA #REQUIRED
103                    value CDATA #REQUIRED
104                >
105
106<!-- Available display devices -->
107<!ELEMENT display (device)+>
108
109