1# Audio HAL
2
3Directory structure of the audio HAL related code.
4
5## Directory Structure for AIDL audio HAL
6
7The AIDL version is located inside `aidl` directory. The tree below explains
8the role of each subdirectory:
9
10* `aidl_api` — snapshots of the API created each Android release. Every
11  release, the current version of the API becomes "frozen" and gets assigned
12  the next version number. If the API needs further modifications, they are
13  made on the "current" version. After making modifications, run
14  `m <package name>-update-api` to update the snapshot of the "current"
15  version.
16* `android/hardware/audio/common` — data structures and interfaces shared
17  between various HALs: BT HAL, core and effects audio HALs.
18* `android/hardware/audio/core` — data structures and interfaces of the
19  core audio HAL.
20* `default` — the default, reference implementation of the audio HAL service.
21* `vts` — VTS tests for the AIDL HAL.
22
23## Directory Structure for HIDL audio HAL
24
25Run `common/all-versions/copyHAL.sh` to create a new version of the HIDL audio
26HAL based on an existing one. Note that this isn't possible since Android T
27release. Android U and above uses AIDL audio HAL.
28
29* `2.0` — version 2.0 of the core HIDL API. Note that `.hal` files
30  can not be moved into the `core` directory because that would change
31  its namespace and include path.
32   - `config` — the XSD schema for the Audio Policy Manager
33     configuration file.
34* `4.0` — version 4.0 of the core HIDL API.
35* ...
36* `common` — common types for audio core and effect HIDL API.
37   - `2.0` — version 2.0 of the common types HIDL API.
38   - `4.0` — version 4.0.
39   - ...
40   - `7.0` — version 7.0.
41      - `example` — example implementation of the core and effect
42        V7.0 API. It represents a "fake" audio HAL that doesn't
43        actually communicate with hardware.
44   - `all-versions` — code common to all version of both core and effect API.
45      - `default` — shared code of the default implementation.
46         - `service` — vendor HAL service for hosting the default
47           implementation.
48      - `test` — utilities used by tests.
49      - `util` — utilities used by both implementation and tests.
50* `core` — VTS tests and the default implementation of the core API
51  (not HIDL API, it's in `audio/N.M`).
52   - `7.0` — code specific to version V7.0 of the core HIDL API
53   - `all-versions` — the code is common between all versions,
54     version-specific parts are enclosed into conditional directives
55     of preprocessor or reside in dedicated files.
56       - `default` — code that wraps the legacy API (from
57         `hardware/libhardware`).
58         - `util` — utilities for the default implementation.
59       - `vts` VTS tests for the core HIDL API.
60* `effect` — same for the effect HIDL API.
61   - `2.0`
62      - `config` — the XSD schema for the Audio Effects configuration file.
63   - `4.0`
64   - ...
65   - `all-versions`
66       - `default` — code that wraps the legacy API (from
67         `hardware/libhardware`).
68         - `util` — utilities for the default implementation.
69       - `vts` VTS tests for the effect HIDL API.
70* `policy` — Configurable Audio Policy schemes.
71   - `1.0` — note that versions of CAP are not linked to the versions
72     of audio HAL.
73      - `vts` — VTS tests for validating actual configuration files.
74      - `xml` — XSD schemas for CAP configuration files.
75