14fa6ee5b1
The 'surroundFormats' section must allow specifying vendor-provided formats (vendor extensions). This has been fixed in Audio HAL V7. Backporting to earlier versions. Bug: 173647783 Test: atest VtsHalAudioV6_0TargetTest Change-Id: I8ae1687087bab3f1c9020f351bdf7b81b9e74e50
635 lines
33 KiB
XML
635 lines
33 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!-- Copyright (C) 2019 The Android Open Source Project
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
<!-- TODO: define a targetNamespace. Note that it will break retrocompatibility -->
|
|
<xs:schema version="2.0"
|
|
elementFormDefault="qualified"
|
|
attributeFormDefault="unqualified"
|
|
xmlns:xs="http://www.w3.org/2001/XMLSchema">
|
|
<!-- List the config versions supported by audio policy. -->
|
|
<xs:simpleType name="version">
|
|
<xs:restriction base="xs:decimal">
|
|
<xs:enumeration value="1.0"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="halVersion">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
Version of the interface the hal implements.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:restriction base="xs:decimal">
|
|
<!-- List of HAL versions supported by the framework. -->
|
|
<xs:enumeration value="2.0"/>
|
|
<xs:enumeration value="3.0"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:element name="audioPolicyConfiguration">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<xs:element name="globalConfiguration" type="globalConfiguration"/>
|
|
<xs:element name="modules" type="modules" maxOccurs="unbounded"/>
|
|
<xs:element name="volumes" type="volumes" maxOccurs="unbounded"/>
|
|
<xs:element name="surroundSound" type="surroundSound" minOccurs="0" />
|
|
</xs:sequence>
|
|
<xs:attribute name="version" type="version"/>
|
|
</xs:complexType>
|
|
<xs:key name="moduleNameKey">
|
|
<xs:selector xpath="modules/module"/>
|
|
<xs:field xpath="@name"/>
|
|
</xs:key>
|
|
<xs:unique name="volumeTargetUniqueness">
|
|
<xs:selector xpath="volumes/volume"/>
|
|
<xs:field xpath="@stream"/>
|
|
<xs:field xpath="@deviceCategory"/>
|
|
</xs:unique>
|
|
<xs:key name="volumeCurveNameKey">
|
|
<xs:selector xpath="volumes/reference"/>
|
|
<xs:field xpath="@name"/>
|
|
</xs:key>
|
|
<xs:keyref name="volumeCurveRef" refer="volumeCurveNameKey">
|
|
<xs:selector xpath="volumes/volume"/>
|
|
<xs:field xpath="@ref"/>
|
|
</xs:keyref>
|
|
</xs:element>
|
|
<xs:complexType name="globalConfiguration">
|
|
<xs:attribute name="speaker_drc_enabled" type="xs:boolean" use="required"/>
|
|
<xs:attribute name="call_screen_mode_supported" type="xs:boolean" use="optional"/>
|
|
<xs:attribute name="engine_library" type="engineSuffix" use="optional"/>
|
|
</xs:complexType>
|
|
<xs:complexType name="modules">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
There should be one section per audio HW module present on the platform.
|
|
Each <module/> contains two mandatory tags: “halVersion” and “name”.
|
|
The module "name" is the same as in previous .conf file.
|
|
Each module must contain the following sections:
|
|
- <devicePorts/>: a list of device descriptors for all
|
|
input and output devices accessible via this module.
|
|
This contains both permanently attached devices and removable devices.
|
|
- <mixPorts/>: listing all output and input streams exposed by the audio HAL
|
|
- <routes/>: list of possible connections between input
|
|
and output devices or between stream and devices.
|
|
A <route/> is defined by a set of 3 attributes:
|
|
-"type": mux|mix means all sources are mutual exclusive (mux) or can be mixed (mix)
|
|
-"sink": the sink involved in this route
|
|
-"sources": all the sources than can be connected to the sink via this route
|
|
- <attachedDevices/>: permanently attached devices.
|
|
The attachedDevices section is a list of devices names.
|
|
Their names correspond to device names defined in "devicePorts" section.
|
|
- <defaultOutputDevice/> is the device to be used when no policy rule applies
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:sequence>
|
|
<xs:element name="module" maxOccurs="unbounded">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<xs:element name="attachedDevices" type="attachedDevices" minOccurs="0">
|
|
<xs:unique name="attachedDevicesUniqueness">
|
|
<xs:selector xpath="item"/>
|
|
<xs:field xpath="."/>
|
|
</xs:unique>
|
|
</xs:element>
|
|
<xs:element name="defaultOutputDevice" type="xs:token" minOccurs="0"/>
|
|
<xs:element name="mixPorts" type="mixPorts" minOccurs="0"/>
|
|
<xs:element name="devicePorts" type="devicePorts" minOccurs="0"/>
|
|
<xs:element name="routes" type="routes" minOccurs="0"/>
|
|
</xs:sequence>
|
|
<xs:attribute name="name" type="xs:string" use="required"/>
|
|
<xs:attribute name="halVersion" type="halVersion" use="required"/>
|
|
</xs:complexType>
|
|
<xs:unique name="mixPortNameUniqueness">
|
|
<xs:selector xpath="mixPorts/mixPort"/>
|
|
<xs:field xpath="@name"/>
|
|
</xs:unique>
|
|
<xs:key name="devicePortNameKey">
|
|
<xs:selector xpath="devicePorts/devicePort"/>
|
|
<xs:field xpath="@tagName"/>
|
|
</xs:key>
|
|
<xs:unique name="devicePortUniqueness">
|
|
<xs:selector xpath="devicePorts/devicePort"/>
|
|
<xs:field xpath="@type"/>
|
|
<xs:field xpath="@address"/>
|
|
</xs:unique>
|
|
<xs:keyref name="defaultOutputDeviceRef" refer="devicePortNameKey">
|
|
<xs:selector xpath="defaultOutputDevice"/>
|
|
<xs:field xpath="."/>
|
|
</xs:keyref>
|
|
<xs:keyref name="attachedDeviceRef" refer="devicePortNameKey">
|
|
<xs:selector xpath="attachedDevices/item"/>
|
|
<xs:field xpath="."/>
|
|
</xs:keyref>
|
|
<!-- The following 3 constraints try to make sure each sink port
|
|
is reference in one an only one route. -->
|
|
<xs:key name="routeSinkKey">
|
|
<!-- predicate [@type='sink'] does not work in xsd 1.0 -->
|
|
<xs:selector xpath="devicePorts/devicePort|mixPorts/mixPort"/>
|
|
<xs:field xpath="@tagName|@name"/>
|
|
</xs:key>
|
|
<xs:keyref name="routeSinkRef" refer="routeSinkKey">
|
|
<xs:selector xpath="routes/route"/>
|
|
<xs:field xpath="@sink"/>
|
|
</xs:keyref>
|
|
<xs:unique name="routeUniqueness">
|
|
<xs:selector xpath="routes/route"/>
|
|
<xs:field xpath="@sink"/>
|
|
</xs:unique>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:complexType name="attachedDevices">
|
|
<xs:sequence>
|
|
<xs:element name="item" type="xs:token" minOccurs="0" maxOccurs="unbounded"/>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<!-- TODO: separate values by space for better xsd validations. -->
|
|
<xs:simpleType name="audioInOutFlags">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
"|" separated list of audio_output_flags_t or audio_input_flags_t.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="|[_A-Z]+(\|[_A-Z]+)*"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="role">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="sink"/>
|
|
<xs:enumeration value="source"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:complexType name="mixPorts">
|
|
<xs:sequence>
|
|
<xs:element name="mixPort" minOccurs="0" maxOccurs="unbounded">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<xs:element name="profile" type="profile" minOccurs="0" maxOccurs="unbounded"/>
|
|
<xs:element name="gains" type="gains" minOccurs="0"/>
|
|
</xs:sequence>
|
|
<xs:attribute name="name" type="xs:token" use="required"/>
|
|
<xs:attribute name="role" type="role" use="required"/>
|
|
<xs:attribute name="flags" type="audioInOutFlags"/>
|
|
<xs:attribute name="maxOpenCount" type="xs:unsignedInt"/>
|
|
<xs:attribute name="maxActiveCount" type="xs:unsignedInt"/>
|
|
<xs:attribute name="preferredUsage" type="audioUsageList">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
When choosing the mixPort of an audio track, the audioPolicy
|
|
first considers the mixPorts with a preferredUsage including
|
|
the track AudioUsage preferred .
|
|
If non support the track format, the other mixPorts are considered.
|
|
Eg: a <mixPort preferredUsage="AUDIO_USAGE_MEDIA" /> will receive
|
|
the audio of all apps playing with a MEDIA usage.
|
|
It may receive audio from ALARM if there are no audio compatible
|
|
<mixPort preferredUsage="AUDIO_USAGE_ALARM" />.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
</xs:attribute>
|
|
</xs:complexType>
|
|
<xs:unique name="mixPortProfileUniqueness">
|
|
<xs:selector xpath="profile"/>
|
|
<xs:field xpath="format"/>
|
|
<xs:field xpath="samplingRate"/>
|
|
<xs:field xpath="channelMasks"/>
|
|
</xs:unique>
|
|
<xs:unique name="mixPortGainUniqueness">
|
|
<xs:selector xpath="gains/gain"/>
|
|
<xs:field xpath="@name"/>
|
|
</xs:unique>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<!-- Enum values of audio_device_t in audio.h
|
|
TODO: generate from hidl to avoid manual sync.
|
|
TODO: separate source and sink in the xml for better xsd validations. -->
|
|
<xs:simpleType name="audioDevice">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="AUDIO_DEVICE_NONE"/>
|
|
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_EARPIECE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_SPEAKER"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_WIRED_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_WIRED_HEADPHONE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_SCO"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_A2DP"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_AUX_DIGITAL"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_HDMI"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_USB_ACCESSORY"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_USB_DEVICE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_REMOTE_SUBMIX"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_TELEPHONY_TX"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_LINE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_HDMI_ARC"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_SPDIF"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_FM"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_AUX_LINE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_SPEAKER_SAFE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_IP"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_BUS"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_PROXY"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_USB_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_HEARING_AID"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_ECHO_CANCELLER"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_DEFAULT"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_OUT_STUB"/>
|
|
|
|
<!-- Due to the xml format, IN types can not be a separated from OUT types -->
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_COMMUNICATION"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_AMBIENT"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BUILTIN_MIC"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_WIRED_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_AUX_DIGITAL"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_HDMI"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_VOICE_CALL"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_TELEPHONY_RX"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BACK_MIC"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_REMOTE_SUBMIX"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_USB_ACCESSORY"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_USB_DEVICE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_FM_TUNER"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_TV_TUNER"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_LINE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_SPDIF"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BLUETOOTH_A2DP"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_LOOPBACK"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_IP"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BUS"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_PROXY"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_USB_HEADSET"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_BLUETOOTH_BLE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_HDMI_ARC"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_ECHO_REFERENCE"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_DEFAULT"/>
|
|
<xs:enumeration value="AUDIO_DEVICE_IN_STUB"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="vendorExtension">
|
|
<!-- Vendor extension names must be prefixed by "VX_" to distinguish them from AOSP values.
|
|
Vendor are encouraged to namespace their module names to avoid conflicts.
|
|
Example for an hypothetical Google virtual reality device:
|
|
<devicePort tagName="VR" type="VX_GOOGLE_VR" role="sink">
|
|
-->
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="VX_[_a-zA-Z0-9]+"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="extendableAudioDevice">
|
|
<xs:union memberTypes="audioDevice vendorExtension"/>
|
|
</xs:simpleType>
|
|
<!-- Enum values of audio_format_t in audio.h
|
|
TODO: generate from hidl to avoid manual sync. -->
|
|
<xs:simpleType name="audioFormat">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_16_BIT" />
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_8_BIT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_32_BIT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_8_24_BIT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_FLOAT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_PCM_24_BIT_PACKED"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MP3"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AMR_NB"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AMR_WB"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_MAIN"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_SSR"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LTP"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_HE_V1"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_SCALABLE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ERLC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_HE_V2"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ELD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_MAIN"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_LC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_SSR"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_LTP"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_HE_V1"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_SCALABLE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_ERLC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_LD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_HE_V2"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_ELD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_VORBIS"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_HE_AAC_V1"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_HE_AAC_V2"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_OPUS"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AC3"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_E_AC3"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_DTS"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_DTS_HD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_IEC61937"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_DOLBY_TRUEHD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_EVRC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_EVRCB"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_EVRCWB"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_EVRCNW"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADIF"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_WMA"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_WMA_PRO"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AMR_WB_PLUS"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MP2"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_QCELP"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_DSD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_FLAC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_ALAC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_APE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_SBC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_APTX"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_APTX_HD"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AC4"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_LDAC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_E_AC3_JOC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MAT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MAT_1_0"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MAT_2_0"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_MAT_2_1"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_XHE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_ADTS_XHE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LATM"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LATM_LC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LATM_HE_V1"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_AAC_LATM_HE_V2"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_CELT"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_APTX_ADAPTIVE"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_LHDC"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_LHDC_LL"/>
|
|
<xs:enumeration value="AUDIO_FORMAT_APTX_TWSP"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="extendableAudioFormat">
|
|
<xs:union memberTypes="audioFormat vendorExtension"/>
|
|
</xs:simpleType>
|
|
<!-- Enum values of audio::common::4_0::AudioUsage
|
|
TODO: generate from HIDL to avoid manual sync. -->
|
|
<xs:simpleType name="audioUsage">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="AUDIO_USAGE_UNKNOWN" />
|
|
<xs:enumeration value="AUDIO_USAGE_MEDIA" />
|
|
<xs:enumeration value="AUDIO_USAGE_VOICE_COMMUNICATION" />
|
|
<xs:enumeration value="AUDIO_USAGE_VOICE_COMMUNICATION_SIGNALLING" />
|
|
<xs:enumeration value="AUDIO_USAGE_ALARM" />
|
|
<xs:enumeration value="AUDIO_USAGE_NOTIFICATION" />
|
|
<xs:enumeration value="AUDIO_USAGE_NOTIFICATION_TELEPHONY_RINGTONE" />
|
|
<xs:enumeration value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
|
|
<xs:enumeration value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
|
|
<xs:enumeration value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
|
|
<xs:enumeration value="AUDIO_USAGE_GAME" />
|
|
<xs:enumeration value="AUDIO_USAGE_VIRTUAL_SOURCE" />
|
|
<xs:enumeration value="AUDIO_USAGE_ASSISTANT" />
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:simpleType name="audioUsageList">
|
|
<xs:list itemType="audioUsage"/>
|
|
</xs:simpleType>
|
|
<!-- TODO: Change to a space separated list to xsd enforce correctness. -->
|
|
<xs:simpleType name="samplingRates">
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="[0-9]+(,[0-9]+)*"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<!-- TODO: Change to a space separated list to xsd enforce correctness. -->
|
|
<xs:simpleType name="channelMask">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
Comma (",") separated list of channel flags
|
|
from audio_channel_mask_t.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="[_A-Z][_A-Z0-9]*(,[_A-Z][_A-Z0-9]*)*"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:complexType name="profile">
|
|
<xs:attribute name="name" type="xs:token" use="optional"/>
|
|
<xs:attribute name="format" type="extendableAudioFormat" use="optional"/>
|
|
<xs:attribute name="samplingRates" type="samplingRates" use="optional"/>
|
|
<xs:attribute name="channelMasks" type="channelMask" use="optional"/>
|
|
</xs:complexType>
|
|
<xs:simpleType name="gainMode">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="AUDIO_GAIN_MODE_JOINT"/>
|
|
<xs:enumeration value="AUDIO_GAIN_MODE_CHANNELS"/>
|
|
<xs:enumeration value="AUDIO_GAIN_MODE_RAMP"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:complexType name="gains">
|
|
<xs:sequence>
|
|
<xs:element name="gain" minOccurs="0" maxOccurs="unbounded">
|
|
<xs:complexType>
|
|
<xs:attribute name="name" type="xs:token" use="required"/>
|
|
<xs:attribute name="mode" type="gainMode" use="required"/>
|
|
<xs:attribute name="channel_mask" type="channelMask" use="optional"/>
|
|
<xs:attribute name="minValueMB" type="xs:int" use="optional"/>
|
|
<xs:attribute name="maxValueMB" type="xs:int" use="optional"/>
|
|
<xs:attribute name="defaultValueMB" type="xs:int" use="optional"/>
|
|
<xs:attribute name="stepValueMB" type="xs:int" use="optional"/>
|
|
<xs:attribute name="minRampMs" type="xs:int" use="optional"/>
|
|
<xs:attribute name="maxRampMs" type="xs:int" use="optional"/>
|
|
<xs:attribute name="useForVolume" type="xs:boolean" use="optional"/>
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:complexType name="devicePorts">
|
|
<xs:sequence>
|
|
<xs:element name="devicePort" minOccurs="0" maxOccurs="unbounded">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<xs:element name="profile" type="profile" minOccurs="0" maxOccurs="unbounded"/>
|
|
<xs:element name="gains" type="gains" minOccurs="0"/>
|
|
</xs:sequence>
|
|
<xs:attribute name="tagName" type="xs:token" use="required"/>
|
|
<xs:attribute name="type" type="extendableAudioDevice" use="required"/>
|
|
<xs:attribute name="role" type="role" use="required"/>
|
|
<xs:attribute name="address" type="xs:string" use="optional" default=""/>
|
|
<!-- Note that XSD 1.0 can not check that a type only has one default. -->
|
|
<xs:attribute name="default" type="xs:boolean" use="optional">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
The default device will be used if multiple have the same type
|
|
and no explicit route request exists for a specific device of
|
|
that type.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
</xs:attribute>
|
|
<xs:attribute name="encodedFormats" type="audioFormatsList" use="optional"
|
|
default="" />
|
|
</xs:complexType>
|
|
<xs:unique name="devicePortProfileUniqueness">
|
|
<xs:selector xpath="profile"/>
|
|
<xs:field xpath="format"/>
|
|
<xs:field xpath="samplingRate"/>
|
|
<xs:field xpath="channelMasks"/>
|
|
</xs:unique>
|
|
<xs:unique name="devicePortGainUniqueness">
|
|
<xs:selector xpath="gains/gain"/>
|
|
<xs:field xpath="@name"/>
|
|
</xs:unique>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:simpleType name="mixType">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="mix"/>
|
|
<xs:enumeration value="mux"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:complexType name="routes">
|
|
<xs:sequence>
|
|
<xs:element name="route" minOccurs="0" maxOccurs="unbounded">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
List all available sources for a given sink.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:complexType>
|
|
<xs:attribute name="type" type="mixType" use="required"/>
|
|
<xs:attribute name="sink" type="xs:string" use="required"/>
|
|
<xs:attribute name="sources" type="xs:string" use="required"/>
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:complexType name="volumes">
|
|
<xs:sequence>
|
|
<xs:element name="volume" type="volume" minOccurs="0" maxOccurs="unbounded"/>
|
|
<xs:element name="reference" type="reference" minOccurs="0" maxOccurs="unbounded">
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<!-- TODO: Always require a ref for better xsd validations.
|
|
Currently a volume could have no points nor ref
|
|
as it can not be forbidden by xsd 1.0.-->
|
|
<xs:simpleType name="volumePoint">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
Comma separated pair of number.
|
|
The fist one is the framework level (between 0 and 100).
|
|
The second one is the volume to send to the HAL.
|
|
The framework will interpolate volumes not specified.
|
|
Their MUST be at least 2 points specified.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="([0-9]{1,2}|100),-?[0-9]+"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<!-- Enum values of audio_stream_type_t in audio-base.h
|
|
TODO: generate from hidl to avoid manual sync. -->
|
|
<xs:simpleType name="stream">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="AUDIO_STREAM_VOICE_CALL"/>
|
|
<xs:enumeration value="AUDIO_STREAM_SYSTEM"/>
|
|
<xs:enumeration value="AUDIO_STREAM_RING"/>
|
|
<xs:enumeration value="AUDIO_STREAM_MUSIC"/>
|
|
<xs:enumeration value="AUDIO_STREAM_ALARM"/>
|
|
<xs:enumeration value="AUDIO_STREAM_NOTIFICATION"/>
|
|
<xs:enumeration value="AUDIO_STREAM_BLUETOOTH_SCO"/>
|
|
<xs:enumeration value="AUDIO_STREAM_ENFORCED_AUDIBLE"/>
|
|
<xs:enumeration value="AUDIO_STREAM_DTMF"/>
|
|
<xs:enumeration value="AUDIO_STREAM_TTS"/>
|
|
<xs:enumeration value="AUDIO_STREAM_ACCESSIBILITY"/>
|
|
<xs:enumeration value="AUDIO_STREAM_ASSISTANT"/>
|
|
<xs:enumeration value="AUDIO_STREAM_REROUTING"/>
|
|
<xs:enumeration value="AUDIO_STREAM_PATCH"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<!-- Enum values of device_category from Volume.h.
|
|
TODO: generate from hidl to avoid manual sync. -->
|
|
<xs:simpleType name="deviceCategory">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="DEVICE_CATEGORY_HEADSET"/>
|
|
<xs:enumeration value="DEVICE_CATEGORY_SPEAKER"/>
|
|
<xs:enumeration value="DEVICE_CATEGORY_EARPIECE"/>
|
|
<xs:enumeration value="DEVICE_CATEGORY_EXT_MEDIA"/>
|
|
<xs:enumeration value="DEVICE_CATEGORY_HEARING_AID"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
<xs:complexType name="volume">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
Volume section defines a volume curve for a given use case and device category.
|
|
It contains a list of points of this curve expressing the attenuation in Millibels
|
|
for a given volume index from 0 to 100.
|
|
<volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_SPEAKER">
|
|
<point>0,-9600</point>
|
|
<point>100,0</point>
|
|
</volume>
|
|
|
|
It may also reference a reference/@name to avoid duplicating curves.
|
|
<volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_SPEAKER"
|
|
ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
|
|
<reference name="DEFAULT_MEDIA_VOLUME_CURVE">
|
|
<point>0,-9600</point>
|
|
<point>100,0</point>
|
|
</reference>
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:sequence>
|
|
<xs:element name="point" type="volumePoint" minOccurs="0" maxOccurs="unbounded"/>
|
|
</xs:sequence>
|
|
<xs:attribute name="stream" type="stream"/>
|
|
<xs:attribute name="deviceCategory" type="deviceCategory"/>
|
|
<xs:attribute name="ref" type="xs:token" use="optional"/>
|
|
</xs:complexType>
|
|
<xs:complexType name="reference">
|
|
<xs:sequence>
|
|
<xs:element name="point" type="volumePoint" minOccurs="2" maxOccurs="unbounded"/>
|
|
</xs:sequence>
|
|
<xs:attribute name="name" type="xs:token" use="required"/>
|
|
</xs:complexType>
|
|
<xs:complexType name="surroundSound">
|
|
<xs:annotation>
|
|
<xs:documentation xml:lang="en">
|
|
Surround Sound section provides configuration related to handling of
|
|
multi-channel formats.
|
|
</xs:documentation>
|
|
</xs:annotation>
|
|
<xs:sequence>
|
|
<xs:element name="formats" type="surroundFormats"/>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:simpleType name="audioFormatsList">
|
|
<xs:list itemType="extendableAudioFormat" />
|
|
</xs:simpleType>
|
|
<xs:complexType name="surroundFormats">
|
|
<xs:sequence>
|
|
<xs:element name="format" minOccurs="0" maxOccurs="unbounded">
|
|
<xs:complexType>
|
|
<xs:attribute name="name" type="extendableAudioFormat" use="required"/>
|
|
<xs:attribute name="subformats" type="audioFormatsList" />
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
<xs:simpleType name="engineSuffix">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="default"/>
|
|
<xs:enumeration value="configurable"/>
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
</xs:schema>
|