Docs: Typo fixes.

Test: ./cdd_gen.sh --version 9 --branch pie-dev
Change-Id: Ic4a076c8c09bcae2317edc4251502caedef3a3d1

CDD: correct file type for USAC

Remove requirement for .loas and .xhe files, not required by P.

Bug: 77327971
Test: stage CDD
Change-Id: Ibf085b5f3f1e6466c5e839de84916561003cfcfa

Docs: Errata for Android 9 CDD.

- Fixed Section 9.10 by removing C-2-1 due to the introduction of C-0-2
- Fixed typos in other sections

Bug: 112010610

Test: ./cdd_gen.sh --version 9 --branch pie-dev
Change-Id: Ie4003beb20425a7fc83cf68ea23772aca389b85b

Merge "CDD: Require HEIF decoding." into pi-dev

Merge "CDD: Recommended values for AAudioStream_getFramesPerBurst()" into pi-dev

CDD: Recommended values for AAudioStream_getFramesPerBurst()

In order for AAudio to work properly, device implementations should
always have a burst size which is the same or less than that reported
by PROPERTY_OUTPUT_FRAMES_PER_BUFFER.

Bug: 74756238
Test: N/A
Change-Id: I1c365b6651357c3125339dd45d56f325e1153667

Docs: HDMI in at least one configuration.

Clarification to HDMI requirement, if device include HDMI port
and at least one configuration supports 24 bit/8 channels it is
considered compliant.

Bug: 76418651
Test: N/A
Change-Id: Iabfd2c75c2013c5acea1a30853b57d611e3ef9bd

Merge "CDD: Latency requirements also applicable to AAudio native APIs (in addition to OpenSL ES)" into pi-dev

Merge "CDD: Add recommendation for touch input to audio output latency for Pro Audio." into pi-dev

CDD: Add recommendation for touch input to audio output latency for Pro Audio.

Pro audio devices should not have a Touch input to audio output latency more
than 40 ms. This is useful for apps that require pro audio and low latency.

Bug: 28160677
Test: N/A
Change-Id: I173b454734b687582a46dc53db5c1b169f047675

CDD: Latency requirements also applicable to AAudio native APIs (in addition to OpenSL ES)

AAudio [AAudio native audio](https://developer.android.com/ndk/guides/audio/aaudio/aaudio.html)
is a newer native audio API for Android, with several advantages
over the OpenSL ES audio API.  Requiring the corresponding performance
in AAudio as OpenSL ES will enable app developers to move towards AAudio.

Bug: 63663812
Test: N/A
Change-Id: Id4f6435b31d29d567461ff5dfa17b75d2776fdb5

Merge "CDD: Audio decoding requirements for xHE-AAC support" into pi-dev

CDD: Require HEIF decoding.

HEIF (HEIC) decoding relies on HEVC decoding which is already mandatory
in Android (since Lollipop) so added requirements for HEIF decoding.

Bug: 74978402
Test: CDD update only

Change-Id: I4e88e3b712fa99cfd55aaa1afb389d219202ee2d

Merge "CDD: Clarification to HDCP requirement for automotive." into pi-dev

Merge "CDD: Requirement for Dynamics Processing Effect." into pi-dev

CDD: Clarification to HDCP requirement for automotive.

Automotive device implementations MUST support HDCP 1.2 or higher for
all external displays connected via a user accessible wired port as
opposed to earlier the requirement was all external displays
connected.

The justification is that, it is unnecessary to specify the video
standard for a permanently installed connection (eg: instrument cluster
or rear seat entertainment screen in a car).


Change-Id: Iafda116268286355a74613b79d9d1ddf514f0f2f
Fixes: 74887951
Test: none

CDD: require timestamps to be accurate to +/- 1 ms

Developers need a reliable and accurate method of obtaining a device's
audio latency so that they can optimize their app's performance for
that device.  As it stands there has been insufficient testing with
the "getTimestamp" method of obtaining audio device latency.  Adding a
requirement to CDD permits the accuracy of getTimestamp to be tested in
CTS or CTS verifier.  The initial strength of requirement is STRONGLY
RECOMMEND.  The corresponding test is tracked separately.

Test: CTS or CTS verifier
Bug: 64140129
Change-Id: If569a2f494534e101587e90afb72dc5ce3250bcb

CDD: Requirement for Dynamics Processing Effect.

DynamicsProcessing is an audio effect for equalizing and changing
dynamic range properties of the sound. It is useful for accessibility and
other apps.

Bug: 77336085
Bug: 64161702
Bug: 38266419

Test: manual testing and CTS tests
Change-Id: If19d63039c3ae0d5e4caddecfd4da833b26d5323

CDD: Audio decoding requirements for xHE-AAC support

Add requirements for xHE-AAC:
  ISO/IEC 23003-3 Extended HE AAC Profile (includes USAC
  Baseline Profile) with support for ISO/IEC 23003-4
  Dynamic Range Control Profile).

Bug: 71430241
Test: stage CDD
Change-Id: I8f2ccacffc8022bbdd6e34a9c98e551edece8c17

CDD: Update Section 5.5.1 for 8-bit, float and multichannel PCM,
48/96kHz

Platforms should support playback of the audio formats output
  by the mandated audio decoders, i.e. some compressed audio
  bitstreams can be decoded, but not played.
Also the platform has been extended to support hi-res audio and
  multichannel since M, but the corresponding CDD requirements
  were not updated.
The action is to update the document to add:
  - 8-bit and float samples
  - multichannel
  - 48 and 96kHz, with 96 only in 1 or 2ch

Bug: 79989468
Test: stage CDD
Change-Id: I7d26f9271d11a5e167660485a9e4cd1f9401e4af

Merge "CDD: Proper MIDI support" into oc-mr1-dev
am: dd5f00385e

Change-Id: I200e380425d4763dae585239ad7ff8eb995f133f

Merge "CDD: Strongly recommend predictable CPU performance mode in pro audio." into oc-mr1-dev
am: 15a657b316

Change-Id: I102298f76ee4f23200b8ac2a2b2ef0c69b0e4829

Merge "CDD: Proper MIDI support" into oc-mr1-dev

Merge "CDD: Strongly recommend predictable CPU performance mode in pro audio." into oc-mr1-dev

Merge "Docs: Minor fixes in section 5.10 Professional Audio and section 7.8.2 Audio Output." into oc-mr1-dev
am: a2781ed5e9

Change-Id: I91c9679cf9628654f1ae8271d4261d3351b9d53b

CDD: Strongly recommend predictable CPU performance mode in pro audio.

Predictable CPU performance mode maintains the CPU clock at a stable
rate while low-latency audio is active, permitting applications to have
more consistent CPU bandwidth available on short notice.  Without this
mode, if a low-latency audio task is not using high CPU load for a
moment, the governor can decrease the CPU bandwidth.  However, when the
audio task's CPU load increases, the governor may be unable to respond
quickly enough to meet the audio task's requirements, resulting in an
audible glitch. This mode solves that problem and so is recommended for
devices that claim the pro audio feature.

Bug: 32809154
Test: builds OK
Change-Id: I7006af18a614dca841527053b48a83dbf3dd7280

Docs: Minor fixes in section 5.10 Professional Audio and section 7.8.2
Audio Output.

Bug: 64042820
Test: builds OK
Change-Id: I112ef764596ddd2270e97ae55d29287439d5980c

CDD: Proper MIDI support

Device implementations exposing the MIDI capability to third-party
apps, MUST also have properly implemented MIDI support.

This will help app developers, as they would know that standard MIDI
APIs are supported on a device that declares MIDI support.

Bug: 36465422
Test: N/A
Change-Id: I1b1e63636a2bec1f0208d737dc1bc6253d7ec115

Docs: Move dev-specific reqs to Ch 2.

Test: python make_cdd.py --version <version-number>  --branch <mybranch>

Bug: 64164626
Merged-In: Ie091c0be79ad4a797f26a60e95ee2594f053f804
Change-Id: Ie091c0be79ad4a797f26a60e95ee2594f053f804
(cherry picked from commit 0ece682cb7f915f4289ba6d7b5c86957e6d5d276)
(cherry picked from commit d72cc3b7971126e352c0c8fd83693f458d3785ec)

Docs: Move dev-specific reqs to Ch 2.

Test: python make_cdd.py --version <version-number>  --branch <mybranch>

Bug: 64164626
Change-Id: Ie091c0be79ad4a797f26a60e95ee2594f053f804
(cherry picked from commit 0ece682cb7f915f4289ba6d7b5c86957e6d5d276)

CDD: Fixed a typo in section 5_3. am: 3588ecf111 am: aa59520f6d
am: a2727afa63

Change-Id: I283f41cf43b73bbae684c8abbfca0052dd3687db

CDD: Fixed a typo in section 5_3.

Bug: 68853248
Test: N/A
Change-Id: Ief6f26493423925206ab4c14d55c92421a92947c

resolve merge conflicts of ece1909 to oc-dr1-dev-plus-aosp

Test: I solemnly swear I tested this conflict resolution.

Change-Id: Ib9a6ce41855fccf246dd4a8234c91477f49ad3c6

Docs: Misc fixes for CDD.

Bug: 67405273

Test: make_cdd.py --version 8.0 --branch "oc-dev"
Change-Id: Icee371d41284f56ef6d9ad90ab8992c94134d5bd

resolve merge conflicts of 2e5325e to oc-dr1-dev-plus-aosp

Test: I solemnly swear I tested this conflict resolution.
Change-Id: I539253cb0f46b5b2058278e8472c0c579d5501c5

CDD: O errata changes

Fixing missing / incorrect IDs.

Bug: 66482816
Change-Id: I7fe68d21c1a554b0eb88e8e3a5e535648daf10be

Docs: Move dev-specific reqs to Ch 2.

Test: python make_cdd.py --version <version-number>  --branch <mybranch>

Bug: 64164626
Change-Id: Ie091c0be79ad4a797f26a60e95ee2594f053f804

Merge "Docs: Restructure Section 5.6" into oc-dev

Merge "Docs: Restructure Section 5.3" into oc-dev

Merge "Docs: Restructure Section 5.10" into oc-dev

Docs: Restructure Section 5.3

- Restructure with new ID rule.
- Move the requirements in the table footnotes in section 5.1
to the content body in this section for better readability.

Bug: 64811960

Change-Id: Icd11b6f73d74205565eaf41a7d5e551e9e7f2a04

Docs: Restructure Section 5.10

- Restructure with the new ID

Bug: 64811960

Change-Id: Ifc59abd8182956cfc307b3ee0b1ef5e0dc00f04c

Merge "Docs: Restructure Section 5.2" into oc-dev

Docs: Restructure Section 5.6

- Restructure with new ID rule
Bug: 64811960

Change-Id: I3ac0cc72c1a3addbad705d9492717ce34228cea2

Merge "Docs: Restructure Section 5.1" into oc-dev

Merge "Docs: Restructure Section 5.4" into oc-dev

Merge "Docs: Restructure Section 5.8" into oc-dev

Merge "Docs: Restructure Section 5.11" into oc-dev

Merge "Docs: Restructure Section 5.0" into oc-dev

Docs: Restructure Section 5.0

- Restructure with new ID rule
- Move section 5.1 to section 5

Bug: 64811960

Change-Id: I078ce470c3407fc491a3e419aa1f6b97fdae5db8

Docs: Restructure Section 5.2

- Restructure with new ID rule
- Move the requirements in the table footer in section 5.1 to the
content body in this section for better readability.

Bug: 64811960

Change-Id: I5d907aeead136dcc52f1933b57f1babaec317a98

Docs: Restructure Section 5.4

- Restructure with  new ID rule

Bug: 64811960
Change-Id: If59a99cafe2699ac3738d7535e56e688411db11d

Docs: Restructure Section 5.1

- Restructure with new ID rule.
- Moved video encoding and decoding requirements to 5.2 and 5.3
sections.

Bug: 64811960

Change-Id: I764407eb7c8c5dbb8c85422df8e790557741d583

Docs: Restructure Section 5.8

- Restructure with  new ID rule

Bug: 64811960
Change-Id: Ied34b3eff49b102ea8320a50ee097bef98f6daff

Docs: Restructure Section 5.11

- Restructure with new ID

Bug: 64811960

Change-Id: Iacf8457c9ef05391f0f14c13491003c1bb93f1bf

Merge "Docs: Restructure Section 5.5" into oc-dev

Merge "Docs: Restructure Section 5.7" into oc-dev

Docs: Restructure Section 5.5

- Restructure with new ID rule

Bug: 64811960
Change-Id: I2f655b1592cf4f6597cc4eeb4c57e3d48971d4e4

Docs: Restructure Section 5.7

- Restructure with  new ID rule
Bug: 64811960

Change-Id: I24b0c37d79046e89b03c11bbd99af5ed31e62dee

Docs: Restructure Section 5.9

- Restructure with  new ID

Bug: 64811960
Change-Id: I6d1ad5a5d4ba00fdb63c22b7235aff1744da9bfd

Merge "CDD: Clarified H.265/VP9 requirements." into oc-dev

Merge "CDD: Recommend simultaneous decoding of secure streams on Android Television devices." into oc-dev

Merge "CDD: Add requirements for AAudio native audio API" into oc-dev

CDD: Recommend simultaneous decoding of secure streams on Android
Television devices.

Video content providers would like to have 2 secure videos decoded
to improve the transition between titles video playback.
This can't be done today because most Android devices can only
instantiate a single secure decoder at a time.

The industry is not yet ready to adopt this universally but the
requirement is added in Android 8.0 as a STRONGLY RECOMMENDED clause
to signal the intention to introduce a more strict requirement in the
future.

Bug: 25978754
Test: N/A
Change-Id: Ide72f348dbf89b712d561a7cfd4bfb1382150cd6

CDD: Clarified H.265/VP9 requirements.

The new footnotes and existing requirements was confusing, so
made it more clearer.

Bug: 36459520
Test: N/A
Change-Id: I05592f13431d6dab61fc9df139636f2c363bf741

CDD: Add requirements for AAudio native audio API

Test: can build PDF
Bug: 34976501
Change-Id: I932f2325a984091bc7fda14968eab861893bd4af

Merge "CDD: Latency req. added for Pro audio when 3.5mm audio jack is omitted" into oc-dev

CDD: Updated missing footnotes for VP9/H.265.

REQUIRE atleast one of H.265 or VP9 decoding of the 720, 1080 and UHD
profiles for when the height as reported by the
`Display.getSupportedModes()` method is equal to or greater than the
video resolution.

Bug: 24915532
Test: N/A
Change-Id: I48084ea37c6d80b50196969c20f1e2329e6b6c06

CDD: Latency req. added for Pro audio when 3.5mm audio jack is omitted

We see some device makers omitting the 3.5mm audio jack, the interface
we have previously used to define the audio latency requirement for the
Pro Audio feature.

Hence we're updating the requirement to clarify that the audio latency
in this case should be measured on the USB host port interface.

Test: N/A
Bug: 35419299
Change-Id: I10d64ec7b9b4375d25b9438a583d87fb9963f70f

CDD: Relax H.265 1080p requirements from 10Mbps to 5Mbps

The 10Mbps was too strict for the industry to implement
widely enough.

http://r.android.com/209496 should have updated both VP9
and H.265 requirements but missed the H.265.

Bug: 27664397
Change-Id: I953b1f8534ee005e61971d866fea817e8ded9315
(cherry picked from commit 84b35c7bb6a3642a1ea06343d5b123b580bf86ec)

Merge "CDD: Fix typo in high frequency range for unprocessed audio" into nougat-mr1-dev

Docs: Final cleanup for CDD source.

   - Fix rowspan in table in section 2.1.
   - Put markdown links on a single line.
   - Escape parentheses in URLs.
   - Fix some internal links with dashes instead of underscores.
   - Replace tabs with spaces.
   - Other misc. cleanup.

Bug: 32070486
Change-Id: Ie44202b5a0bfe7133505880a0a9c74f08a9bac1f

CDD: Fix typo in high frequency range for unprocessed audio

Test: not applicable
Bug: 32645111
Change-Id: Ia35f0871b674976476358dd84d1ab019d19152fb
(cherry picked from commit 852dbf00119545bb398b2c9821d2b866d8a89bce)

Docs: Fix mdashes, remove comma, indent list..

Bug: 32070486
Change-Id: I35326874a7c6fae3d29548003a9dc3cfe7742558

CDD: Android TV video codec requirements change

Bug: 29640911

Change-Id: I494af22fcb29ae31aa523d034c2a7f00284ff03d

CDD: Remove detail from Raw image decoder requirement

The AOSP provides an implementation of the Raw decoder in Skia
which will display the embedded JPEG (aka "preview") data --
if available in the image file -- or the DNG format data.

The change here removes this implementation detail from the
requirement, as the device implementations may have different
choices for how the Raw image file is decoded.

Bug: 27152493

Change-Id: I660198b12374f7050cfb49fdf11408589750ad5c

Merge "CDD: Updates to media codec section." into nyc-dev

CDD: Updates to media codec section.

Bug: 28070873

Change-Id: Idba71e7928be65fb935fc10d7a7b40e0275d01d6

Merge "CDD: Additions for AAC DRC metadata support" into nyc-dev

CDD: Additions for AAC DRC metadata support

Bug 29881814

Change-Id: I102d29878a24a88097980d10d8c2b79d6163bd75

Merge "CDD: Require AAC support 5.0/1 w/o downmixing." into nyc-dev

CDD: Require AAC support 5.0/1 w/o downmixing.

Bug: 28384221

Change-Id: Ief14f9aaa59008a8b099cdcaf99ce41224acaff2

CDD: Require one of 44.1, 48 kHz sampling rates for voice recognition

Bug: 27665223

Change-Id: If0ea2e494584c98539eecae5704da36ac953da98

Merge "CDD: Clarify media codec/protocol requirements" into nyc-dev

CDD: Add recommendations for pro audio feature

Bug: 30831170
Change-Id: I0c111a9ad79f71ab8cd8c52611a83d7b77e0f776

Merge "CDD: Add new section 5.11 for unprocessed audio capturing" into nyc-dev

Merge "CDD: Pro Audio requires OpenSL ES PCM buffer queue API for latency and USB audio" into nyc-dev

CDD: Pro Audio requires OpenSL ES PCM buffer queue API for latency and USB audio

Latencies and USB audio requirements MUST be met using the
OpenSL ES PCM buffer queue API.

Bug: 29618142

Change-Id: I68189cd4b1992f6fd8b24474cafc93403ebcf7b4

CDD: Recommend stream-specific adjustment of volume for automotive

Audio management including focus and volume attenuation for
stream ducking is often conducted by an off-board system in
automotive. Android should support individual stream volume
adjustment so that off board mixing and management is handled
correctly in these cases. For some car-specific cases the new
CAR_AUDIO_USAGE_* usages are provided in the android.car API
package.

Change-Id: I748d1ae5d3aa42112eaea1f2f8eae9022ca2a9f8

Merge "CDD: Update audio latency definitions" into nyc-dev

Merge "CDD: MIDI over BLE is now required to report android.software.midi" into nyc-dev

CDD: Update audio latency definitions

Clarify the definitions of audio latency, jitter, and lost input.

Bug: 30695402
Change-Id: I5fa79a5fdcd24f56e243a402b60439e66976d7b0

CDD: Add new section 5.11 for unprocessed audio capturing

Bug: 30695417

Change-Id: I05c53e24dad0ebcdd55ef4f87e6f5cfc7591e0d7

CDD: Clarify media codec/protocol requirements

Bug: 23104087

Change-Id: I01d80a35f1f6922ebf5333a1888b9e2234a55310

CDD: MIDI over BLE is now required to report android.software.midi

Rationale: BLE over MIDI is now published by MIDI.org and has a stable
Android implementation.

Bug: 29611793

Change-Id: I6904fcda7f2dbbc3fa683ff5594c7dda1c4afd03

Merge "CDD: Require support of rendering RAW images." into nyc-dev

CDD: Require support of rendering RAW images.

RAW image support is added in Android 7.0.

Bug: 27152493

Change-Id: Ice230501fddf895c100046c90e999758a8199a9a

Merge "CDD: H.263 codecs are not any more required." into nyc-dev

CDD: H.263 codecs are not any more required.

H.263 is not any more required, as the functionality is mostly replaced
by more modern codecs.

Bug: 27221674

Change-Id: I874ef1c18e549d5357a929c7faaea96036557bee

Docs: Increased readability of Video Codecs
Bug: 29640911

Change-Id: Ie49fb877b8cc205a9258f66d5b59279a916c7fb0