platform_hardware_interfaces/audio
Mikhail Naganov 1261ff4f9b Merge changes from topic "revert-2770886-AidlAudioHalModuleConfig-FQCMWOWMCH" into main am: 03a2fbc6a3 am: fb1d459f09 am: 9868600b48 am: 9ed9a05578 am: 0cfcc0f2f9
Original change: https://android-review.googlesource.com/c/platform/hardware/interfaces/+/2786757

Change-Id: I6b5a7c2db6ee69a63abc9897bb9c1716157f641e
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
2023-10-14 01:35:36 +00:00
..
2.0 [LSC] Add LOCAL_LICENSE_KINDS to hardware/interfaces 2021-02-23 14:26:20 -08:00
4.0 [LSC] Add LOCAL_LICENSE_KINDS to hardware/interfaces 2021-02-23 14:26:20 -08:00
5.0 [LSC] Add LOCAL_LICENSE_KINDS to hardware/interfaces 2021-02-23 14:26:20 -08:00
6.0 [LSC] Add LOCAL_LICENSE_KINDS to hardware/interfaces 2021-02-23 14:26:20 -08:00
7.0 audio: Fix parsing of arguments in the APM config update script am: b9e244dfc7 am: 188d6412b0 2021-06-11 22:06:36 +00:00
7.1 Make AUDIO_USAGE_NOTIFICATION_EVENT available to HALs 2022-02-12 00:03:49 +00:00
aidl Merge changes from topic "revert-2770886-AidlAudioHalModuleConfig-FQCMWOWMCH" into main am: 03a2fbc6a3 am: fb1d459f09 am: 9868600b48 am: 9ed9a05578 am: 0cfcc0f2f9 2023-10-14 01:35:36 +00:00
common Merge "Remove duplcated static libgtest" am: b06d1aeb9f am: 5a04a3a70b am: bb9d3e8211 2023-06-06 19:52:45 +00:00
core/all-versions Merge "Don't depend on String8 cast to C string [audio]" into main am: ecc3e1af82 2023-09-13 19:39:37 +00:00
effect audio: Properly handle closed effects in HIDL implementation 2023-08-25 11:15:43 -07:00
policy/1.0 Audio: add system usage to audio policy engine schemas 2023-08-21 22:41:27 +00:00
OWNERS audio: clean up OWNERS 2022-12-29 23:22:02 +00:00
README.md audio: Update README.md to add info about the AIDL version 2023-01-20 21:54:17 +00:00

Audio HAL

Directory structure of the audio HAL related code.

Directory Structure for AIDL audio HAL

The AIDL version is located inside aidl directory. The tree below explains the role of each subdirectory:

  • aidl_api — snapshots of the API created each Android release. Every release, the current version of the API becomes "frozen" and gets assigned the next version number. If the API needs further modifications, they are made on the "current" version. After making modifications, run m <package name>-update-api to update the snapshot of the "current" version.
  • android/hardware/audio/common — data structures and interfaces shared between various HALs: BT HAL, core and effects audio HALs.
  • android/hardware/audio/core — data structures and interfaces of the core audio HAL.
  • default — the default, reference implementation of the audio HAL service.
  • vts — VTS tests for the AIDL HAL.

Directory Structure for HIDL audio HAL

Run common/all-versions/copyHAL.sh to create a new version of the HIDL audio HAL based on an existing one. Note that this isn't possible since Android T release. Android U and above uses AIDL audio HAL.

  • 2.0 — version 2.0 of the core HIDL API. Note that .hal files can not be moved into the core directory because that would change its namespace and include path.
    • config — the XSD schema for the Audio Policy Manager configuration file.
  • 4.0 — version 4.0 of the core HIDL API.
  • ...
  • common — common types for audio core and effect HIDL API.
    • 2.0 — version 2.0 of the common types HIDL API.
    • 4.0 — version 4.0.
    • ...
    • 7.0 — version 7.0.
      • example — example implementation of the core and effect V7.0 API. It represents a "fake" audio HAL that doesn't actually communicate with hardware.
    • all-versions — code common to all version of both core and effect API.
      • default — shared code of the default implementation.
        • service — vendor HAL service for hosting the default implementation.
      • test — utilities used by tests.
      • util — utilities used by both implementation and tests.
  • core — VTS tests and the default implementation of the core API (not HIDL API, it's in audio/N.M).
    • 7.0 — code specific to version V7.0 of the core HIDL API
    • all-versions — the code is common between all versions, version-specific parts are enclosed into conditional directives of preprocessor or reside in dedicated files.
      • default — code that wraps the legacy API (from hardware/libhardware).
        • util — utilities for the default implementation.
      • vts VTS tests for the core HIDL API.
  • effect — same for the effect HIDL API.
    • 2.0
      • config — the XSD schema for the Audio Effects configuration file.
    • 4.0
    • ...
    • all-versions
      • default — code that wraps the legacy API (from hardware/libhardware).
        • util — utilities for the default implementation.
      • vts VTS tests for the effect HIDL API.
  • policy — Configurable Audio Policy schemes.
    • 1.0 — note that versions of CAP are not linked to the versions of audio HAL.
      • vts — VTS tests for validating actual configuration files.
      • xml — XSD schemas for CAP configuration files.