/* * Copyright 2017 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. */ #define LOG_TAG "AAudioStreamParameters" #include #include #include "AAudioStreamParameters.h" using namespace aaudio; // TODO These defines should be moved to a central place in audio. #define SAMPLES_PER_FRAME_MIN 1 #define SAMPLES_PER_FRAME_MAX FCC_LIMIT #define SAMPLE_RATE_HZ_MIN 8000 // HDMI supports up to 32 channels at 1536000 Hz. #define SAMPLE_RATE_HZ_MAX 1600000 void AAudioStreamParameters::copyFrom(const AAudioStreamParameters &other) { mSamplesPerFrame = other.mSamplesPerFrame; mSampleRate = other.mSampleRate; mDeviceId = other.mDeviceId; mSessionId = other.mSessionId; mSharingMode = other.mSharingMode; mAudioFormat = other.mAudioFormat; mDirection = other.mDirection; mBufferCapacity = other.mBufferCapacity; mUsage = other.mUsage; mContentType = other.mContentType; mSpatializationBehavior = other.mSpatializationBehavior; mIsContentSpatialized = other.mIsContentSpatialized; mInputPreset = other.mInputPreset; mAllowedCapturePolicy = other.mAllowedCapturePolicy; mIsPrivacySensitive = other.mIsPrivacySensitive; mOpPackageName = other.mOpPackageName; mAttributionTag = other.mAttributionTag; mChannelMask = other.mChannelMask; mHardwareSamplesPerFrame = other.mHardwareSamplesPerFrame; mHardwareSampleRate = other.mHardwareSampleRate; mHardwareAudioFormat = other.mHardwareAudioFormat; } static aaudio_result_t isFormatValid(audio_format_t format) { switch (format) { case AUDIO_FORMAT_DEFAULT: case AUDIO_FORMAT_PCM_16_BIT: case AUDIO_FORMAT_PCM_32_BIT: case AUDIO_FORMAT_PCM_FLOAT: case AUDIO_FORMAT_PCM_24_BIT_PACKED: case AUDIO_FORMAT_PCM_8_24_BIT: case AUDIO_FORMAT_IEC61937: break; // valid default: ALOGD("audioFormat not valid, audio_format_t = 0x%08x", format); return AAUDIO_ERROR_INVALID_FORMAT; // break; } return AAUDIO_OK; } aaudio_result_t AAudioStreamParameters::validate() const { if (mSamplesPerFrame != AAUDIO_UNSPECIFIED && (mSamplesPerFrame < SAMPLES_PER_FRAME_MIN || mSamplesPerFrame > SAMPLES_PER_FRAME_MAX)) { ALOGD("channelCount out of range = %d", mSamplesPerFrame); return AAUDIO_ERROR_OUT_OF_RANGE; } if (mDeviceId < 0) { ALOGD("deviceId out of range = %d", mDeviceId); return AAUDIO_ERROR_OUT_OF_RANGE; } // All Session ID values are legal. switch (mSessionId) { case AAUDIO_SESSION_ID_NONE: case AAUDIO_SESSION_ID_ALLOCATE: default: break; } switch (mSharingMode) { case AAUDIO_SHARING_MODE_EXCLUSIVE: case AAUDIO_SHARING_MODE_SHARED: break; default: ALOGD("illegal sharingMode = %d", mSharingMode); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } aaudio_result_t result = isFormatValid (mAudioFormat); if (result != AAUDIO_OK) return result; if (mSampleRate != AAUDIO_UNSPECIFIED && (mSampleRate < SAMPLE_RATE_HZ_MIN || mSampleRate > SAMPLE_RATE_HZ_MAX)) { ALOGD("sampleRate out of range = %d", mSampleRate); return AAUDIO_ERROR_INVALID_RATE; } if (mBufferCapacity < 0) { ALOGD("bufferCapacity out of range = %d", mBufferCapacity); return AAUDIO_ERROR_OUT_OF_RANGE; } switch (mDirection) { case AAUDIO_DIRECTION_INPUT: case AAUDIO_DIRECTION_OUTPUT: break; // valid default: ALOGD("direction not valid = %d", mDirection); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } switch (mUsage) { case AAUDIO_UNSPECIFIED: case AAUDIO_USAGE_MEDIA: case AAUDIO_USAGE_VOICE_COMMUNICATION: case AAUDIO_USAGE_VOICE_COMMUNICATION_SIGNALLING: case AAUDIO_USAGE_ALARM: case AAUDIO_USAGE_NOTIFICATION: case AAUDIO_USAGE_NOTIFICATION_RINGTONE: case AAUDIO_USAGE_NOTIFICATION_EVENT: case AAUDIO_USAGE_ASSISTANCE_ACCESSIBILITY: case AAUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE: case AAUDIO_USAGE_ASSISTANCE_SONIFICATION: case AAUDIO_USAGE_GAME: case AAUDIO_USAGE_ASSISTANT: case AAUDIO_SYSTEM_USAGE_EMERGENCY: case AAUDIO_SYSTEM_USAGE_SAFETY: case AAUDIO_SYSTEM_USAGE_VEHICLE_STATUS: case AAUDIO_SYSTEM_USAGE_ANNOUNCEMENT: break; // valid default: ALOGD("usage not valid = %d", mUsage); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } switch (mContentType) { case AAUDIO_UNSPECIFIED: case AAUDIO_CONTENT_TYPE_MUSIC: case AAUDIO_CONTENT_TYPE_MOVIE: case AAUDIO_CONTENT_TYPE_SONIFICATION: case AAUDIO_CONTENT_TYPE_SPEECH: break; // valid default: ALOGD("content type not valid = %d", mContentType); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } switch (mSpatializationBehavior) { case AAUDIO_UNSPECIFIED: case AAUDIO_SPATIALIZATION_BEHAVIOR_AUTO: case AAUDIO_SPATIALIZATION_BEHAVIOR_NEVER: break; // valid default: ALOGD("spatialization behavior not valid = %d", mSpatializationBehavior); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } // no validation required for mIsContentSpatialized switch (mInputPreset) { case AAUDIO_UNSPECIFIED: case AAUDIO_INPUT_PRESET_GENERIC: case AAUDIO_INPUT_PRESET_CAMCORDER: case AAUDIO_INPUT_PRESET_VOICE_COMMUNICATION: case AAUDIO_INPUT_PRESET_VOICE_RECOGNITION: case AAUDIO_INPUT_PRESET_UNPROCESSED: case AAUDIO_INPUT_PRESET_VOICE_PERFORMANCE: case AAUDIO_INPUT_PRESET_SYSTEM_ECHO_REFERENCE: case AAUDIO_INPUT_PRESET_SYSTEM_HOTWORD: break; // valid default: ALOGD("input preset not valid = %d", mInputPreset); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } switch (mAllowedCapturePolicy) { case AAUDIO_UNSPECIFIED: case AAUDIO_ALLOW_CAPTURE_BY_ALL: case AAUDIO_ALLOW_CAPTURE_BY_SYSTEM: case AAUDIO_ALLOW_CAPTURE_BY_NONE: break; // valid default: ALOGD("allowed capture policy not valid = %d", mAllowedCapturePolicy); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; // break; } return validateChannelMask(); } aaudio_result_t AAudioStreamParameters::validateChannelMask() const { if (mChannelMask == AAUDIO_UNSPECIFIED) { return AAUDIO_OK; } if (mChannelMask & AAUDIO_CHANNEL_BIT_INDEX) { switch (mChannelMask) { case AAUDIO_CHANNEL_INDEX_MASK_1: case AAUDIO_CHANNEL_INDEX_MASK_2: case AAUDIO_CHANNEL_INDEX_MASK_3: case AAUDIO_CHANNEL_INDEX_MASK_4: case AAUDIO_CHANNEL_INDEX_MASK_5: case AAUDIO_CHANNEL_INDEX_MASK_6: case AAUDIO_CHANNEL_INDEX_MASK_7: case AAUDIO_CHANNEL_INDEX_MASK_8: case AAUDIO_CHANNEL_INDEX_MASK_9: case AAUDIO_CHANNEL_INDEX_MASK_10: case AAUDIO_CHANNEL_INDEX_MASK_11: case AAUDIO_CHANNEL_INDEX_MASK_12: case AAUDIO_CHANNEL_INDEX_MASK_13: case AAUDIO_CHANNEL_INDEX_MASK_14: case AAUDIO_CHANNEL_INDEX_MASK_15: case AAUDIO_CHANNEL_INDEX_MASK_16: case AAUDIO_CHANNEL_INDEX_MASK_17: case AAUDIO_CHANNEL_INDEX_MASK_18: case AAUDIO_CHANNEL_INDEX_MASK_19: case AAUDIO_CHANNEL_INDEX_MASK_20: case AAUDIO_CHANNEL_INDEX_MASK_21: case AAUDIO_CHANNEL_INDEX_MASK_22: case AAUDIO_CHANNEL_INDEX_MASK_23: case AAUDIO_CHANNEL_INDEX_MASK_24: return AAUDIO_OK; default: ALOGD("Invalid channel index mask %#x", mChannelMask); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; } } if (getDirection() == AAUDIO_DIRECTION_INPUT) { switch (mChannelMask) { case AAUDIO_CHANNEL_MONO: case AAUDIO_CHANNEL_STEREO: case AAUDIO_CHANNEL_FRONT_BACK: case AAUDIO_CHANNEL_2POINT0POINT2: case AAUDIO_CHANNEL_2POINT1POINT2: case AAUDIO_CHANNEL_3POINT0POINT2: case AAUDIO_CHANNEL_3POINT1POINT2: case AAUDIO_CHANNEL_5POINT1: return AAUDIO_OK; default: ALOGD("Invalid channel mask %#x, IN", mChannelMask); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; } } else { switch (mChannelMask) { case AAUDIO_CHANNEL_MONO: case AAUDIO_CHANNEL_STEREO: case AAUDIO_CHANNEL_2POINT1: case AAUDIO_CHANNEL_TRI: case AAUDIO_CHANNEL_TRI_BACK: case AAUDIO_CHANNEL_3POINT1: case AAUDIO_CHANNEL_2POINT0POINT2: case AAUDIO_CHANNEL_2POINT1POINT2: case AAUDIO_CHANNEL_3POINT0POINT2: case AAUDIO_CHANNEL_3POINT1POINT2: case AAUDIO_CHANNEL_QUAD: case AAUDIO_CHANNEL_QUAD_SIDE: case AAUDIO_CHANNEL_SURROUND: case AAUDIO_CHANNEL_PENTA: case AAUDIO_CHANNEL_5POINT1: case AAUDIO_CHANNEL_5POINT1_SIDE: case AAUDIO_CHANNEL_5POINT1POINT2: case AAUDIO_CHANNEL_5POINT1POINT4: case AAUDIO_CHANNEL_6POINT1: case AAUDIO_CHANNEL_7POINT1: case AAUDIO_CHANNEL_7POINT1POINT2: case AAUDIO_CHANNEL_7POINT1POINT4: case AAUDIO_CHANNEL_9POINT1POINT4: case AAUDIO_CHANNEL_9POINT1POINT6: return AAUDIO_OK; default: ALOGD("Invalid channel mask %#x. OUT", mChannelMask); return AAUDIO_ERROR_ILLEGAL_ARGUMENT; } } } void AAudioStreamParameters::dump() const { ALOGD("mDeviceId = %6d", mDeviceId); ALOGD("mSessionId = %6d", mSessionId); ALOGD("mSampleRate = %6d", mSampleRate); ALOGD("mSamplesPerFrame = %6d", mSamplesPerFrame); ALOGD("mChannelMask = %#x", mChannelMask); ALOGD("mSharingMode = %6d", (int)mSharingMode); ALOGD("mAudioFormat = %6d", (int)mAudioFormat); ALOGD("mDirection = %6d", mDirection); ALOGD("mBufferCapacity = %6d", mBufferCapacity); ALOGD("mUsage = %6d", mUsage); ALOGD("mContentType = %6d", mContentType); ALOGD("mSpatializationBehavior = %6d", mSpatializationBehavior); ALOGD("mIsContentSpatialized = %s", mIsContentSpatialized ? "true" : "false"); ALOGD("mInputPreset = %6d", mInputPreset); ALOGD("mAllowedCapturePolicy = %6d", mAllowedCapturePolicy); ALOGD("mIsPrivacySensitive = %s", mIsPrivacySensitive ? "true" : "false"); ALOGD("mOpPackageName = %s", !mOpPackageName.has_value() ? "(null)" : mOpPackageName.value().c_str()); ALOGD("mAttributionTag = %s", !mAttributionTag.has_value() ? "(null)" : mAttributionTag.value().c_str()); ALOGD("mHardwareSamplesPerFrame = %6d", mHardwareSamplesPerFrame); ALOGD("mHardwareSampleRate = %6d", mHardwareSampleRate); ALOGD("mHardwareAudioFormat = %6d", (int)mHardwareAudioFormat); }