AAudioServiceDefinitions.h revision f53e613b3dedab3ecada2c93d8846233c442d129
1/*
2 * Copyright (C) 2016 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#ifndef BINDING_AAUDIOSERVICEDEFINITIONS_H
18#define BINDING_AAUDIOSERVICEDEFINITIONS_H
19
20#include <stdint.h>
21#include <utils/RefBase.h>
22#include <binder/TextOutput.h>
23#include <binder/IInterface.h>
24
25#include <aaudio/AAudio.h>
26
27using android::NO_ERROR;
28using android::IBinder;
29
30namespace android {
31
32enum aaudio_commands_t {
33    OPEN_STREAM = IBinder::FIRST_CALL_TRANSACTION,
34    CLOSE_STREAM,
35    GET_STREAM_DESCRIPTION,
36    START_STREAM,
37    PAUSE_STREAM,
38    FLUSH_STREAM,
39    REGISTER_AUDIO_THREAD,
40    UNREGISTER_AUDIO_THREAD
41};
42
43} // namespace android
44
45namespace aaudio {
46
47enum aaudio_commands_t {
48    OPEN_STREAM = IBinder::FIRST_CALL_TRANSACTION,
49    CLOSE_STREAM,
50    GET_STREAM_DESCRIPTION,
51    START_STREAM,
52    PAUSE_STREAM,
53    FLUSH_STREAM,
54    REGISTER_AUDIO_THREAD,
55    UNREGISTER_AUDIO_THREAD
56};
57
58// TODO Expand this to include all the open parameters.
59typedef struct AAudioServiceStreamInfo_s {
60    int32_t             deviceId;
61    int32_t             samplesPerFrame;  // number of channels
62    aaudio_sample_rate_t  sampleRate;
63    aaudio_audio_format_t audioFormat;
64} AAudioServiceStreamInfo;
65
66// This must be a fixed width so it can be in shared memory.
67enum RingbufferFlags : uint32_t {
68    NONE = 0,
69    RATE_ISOCHRONOUS = 0x0001,
70    RATE_ASYNCHRONOUS = 0x0002,
71    COHERENCY_DMA = 0x0004,
72    COHERENCY_ACQUIRE_RELEASE = 0x0008,
73    COHERENCY_AUTO = 0x0010,
74};
75
76// This is not passed through Binder.
77// Client side code will convert Binder data and fill this descriptor.
78typedef struct RingBufferDescriptor_s {
79    uint8_t* dataAddress;       // offset from read or write block
80    int64_t* writeCounterAddress;
81    int64_t* readCounterAddress;
82    int32_t  bytesPerFrame;     // index is in frames
83    int32_t  framesPerBurst;    // for ISOCHRONOUS queues
84    int32_t  capacityInFrames;  // zero if unused
85    RingbufferFlags flags;
86} RingBufferDescriptor;
87
88// This is not passed through Binder.
89// Client side code will convert Binder data and fill this descriptor.
90typedef struct EndpointDescriptor_s {
91    // Set capacityInFrames to zero if Queue is unused.
92    RingBufferDescriptor upMessageQueueDescriptor;   // server to client
93    RingBufferDescriptor downMessageQueueDescriptor; // client to server
94    RingBufferDescriptor upDataQueueDescriptor;      // eg. record
95    RingBufferDescriptor downDataQueueDescriptor;    // eg. playback
96} EndpointDescriptor;
97
98} // namespace aaudio
99
100#endif //BINDING_AAUDIOSERVICEDEFINITIONS_H
101