/* * Copyright (C) 2013 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 "EffectProxy" //#define LOG_NDEBUG 0 #include #include #include #include #include #include #include #include namespace android { // This is a dummy proxy descriptor just to return to Factory during the initial // GetDescriptor call. Later in the factory, it is replaced with the // SW sub effect descriptor // proxy UUID af8da7e0-2ca1-11e3-b71d-0002a5d5c51b const effect_descriptor_t gProxyDescriptor = { EFFECT_UUID_INITIALIZER, // type {0xaf8da7e0, 0x2ca1, 0x11e3, 0xb71d, { 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b }}, // uuid EFFECT_CONTROL_API_VERSION, //version of effect control API (EFFECT_FLAG_TYPE_INSERT | EFFECT_FLAG_INSERT_LAST | EFFECT_FLAG_VOLUME_CTRL), // effect capability flags 0, // CPU load 1, // Data memory "Proxy", //effect name "AOSP", //implementor name }; static const effect_descriptor_t *const gDescriptors[] = { &gProxyDescriptor, }; int EffectProxyCreate(const effect_uuid_t *uuid, int32_t sessionId, int32_t ioId, effect_handle_t *pHandle) { effect_descriptor_t* desc; audio_effect_library_t** aeli; sub_effect_entry_t** sube; EffectContext* pContext; if (pHandle == NULL || uuid == NULL) { ALOGE("EffectProxyCreate() called with NULL pointer"); return -EINVAL; } ALOGV("EffectProxyCreate start.."); pContext = new EffectContext; pContext->sessionId = sessionId; pContext->ioId = ioId; pContext->uuid = *uuid; pContext->common_itfe = &gEffectInterface; // The sub effects will be created in effect_command when the first command // for the effect is received pContext->eHandle[SUB_FX_HOST] = pContext->eHandle[SUB_FX_OFFLOAD] = NULL; // Get the HW and SW sub effect descriptors from the effects factory desc = new effect_descriptor_t[SUB_FX_COUNT]; aeli = new audio_effect_library_t*[SUB_FX_COUNT]; sube = new sub_effect_entry_t*[SUB_FX_COUNT]; pContext->sube = new sub_effect_entry_t*[SUB_FX_COUNT]; pContext->desc = new effect_descriptor_t[SUB_FX_COUNT]; pContext->aeli = new audio_effect_library_t*[SUB_FX_COUNT]; int retValue = EffectGetSubEffects(uuid, sube, SUB_FX_COUNT); // EffectGetSubEffects returns the number of sub-effects copied. if (retValue != SUB_FX_COUNT) { ALOGE("EffectCreate() could not get the sub effects"); delete[] sube; delete[] desc; delete[] aeli; delete[] pContext->sube; delete[] pContext->desc; delete[] pContext->aeli; return -EINVAL; } // Check which is the HW descriptor and copy the descriptors // to the Context desc array // Also check if there is only one HW and one SW descriptor. // HW descriptor alone has the HW_TUNNEL flag. desc[0] = *(effect_descriptor_t*)(sube[0])->object; desc[1] = *(effect_descriptor_t*)(sube[1])->object; aeli[0] = sube[0]->lib->desc; aeli[1] = sube[1]->lib->desc; if ((desc[0].flags & EFFECT_FLAG_HW_ACC_TUNNEL) && !(desc[1].flags & EFFECT_FLAG_HW_ACC_TUNNEL)) { pContext->sube[SUB_FX_OFFLOAD] = sube[0]; pContext->desc[SUB_FX_OFFLOAD] = desc[0]; pContext->aeli[SUB_FX_OFFLOAD] = aeli[0]; pContext->sube[SUB_FX_HOST] = sube[1]; pContext->desc[SUB_FX_HOST] = desc[1]; pContext->aeli[SUB_FX_HOST] = aeli[1]; } else if ((desc[1].flags & EFFECT_FLAG_HW_ACC_TUNNEL) && !(desc[0].flags & EFFECT_FLAG_HW_ACC_TUNNEL)) { pContext->sube[SUB_FX_HOST] = sube[0]; pContext->desc[SUB_FX_HOST] = desc[0]; pContext->aeli[SUB_FX_HOST] = aeli[0]; pContext->sube[SUB_FX_OFFLOAD] = sube[1]; pContext->desc[SUB_FX_OFFLOAD] = desc[1]; pContext->aeli[SUB_FX_OFFLOAD] = aeli[1]; } delete[] desc; delete[] aeli; delete[] sube; #if (LOG_NDEBUG == 0) effect_uuid_t uuid_print = pContext->desc[SUB_FX_HOST].uuid; ALOGV("EffectCreate() UUID of HOST: %08X-%04X-%04X-%04X-%02X%02X%02X%02X" "%02X%02X\n",uuid_print.timeLow, uuid_print.timeMid, uuid_print.timeHiAndVersion, uuid_print.clockSeq, uuid_print.node[0], uuid_print.node[1], uuid_print.node[2], uuid_print.node[3], uuid_print.node[4], uuid_print.node[5]); ALOGV("EffectCreate() UUID of OFFLOAD: %08X-%04X-%04X-%04X-%02X%02X%02X%02X" "%02X%02X\n", uuid_print.timeLow, uuid_print.timeMid, uuid_print.timeHiAndVersion, uuid_print.clockSeq, uuid_print.node[0], uuid_print.node[1], uuid_print.node[2], uuid_print.node[3], uuid_print.node[4], uuid_print.node[5]); #endif pContext->replySize = PROXY_REPLY_SIZE_DEFAULT; pContext->replyData = (char *)malloc(PROXY_REPLY_SIZE_DEFAULT); *pHandle = (effect_handle_t)pContext; ALOGV("EffectCreate end"); return 0; } //end EffectProxyCreate int EffectProxyRelease(effect_handle_t handle) { EffectContext * pContext = (EffectContext *)handle; if (pContext == NULL) { ALOGV("ERROR : EffectRelease called with NULL pointer"); return -EINVAL; } ALOGV("EffectRelease"); delete[] pContext->desc; free(pContext->replyData); if (pContext->eHandle[SUB_FX_HOST]) pContext->aeli[SUB_FX_HOST]->release_effect(pContext->eHandle[SUB_FX_HOST]); if (pContext->eHandle[SUB_FX_OFFLOAD]) pContext->aeli[SUB_FX_OFFLOAD]->release_effect(pContext->eHandle[SUB_FX_OFFLOAD]); delete[] pContext->aeli; delete[] pContext->sube; delete pContext; pContext = NULL; return 0; } /*end EffectProxyRelease */ int EffectProxyGetDescriptor(const effect_uuid_t *uuid, effect_descriptor_t *pDescriptor) { const effect_descriptor_t *desc = NULL; if (pDescriptor == NULL || uuid == NULL) { ALOGV("EffectGetDescriptor() called with NULL pointer"); return -EINVAL; } desc = &gProxyDescriptor; *pDescriptor = *desc; return 0; } /* end EffectProxyGetDescriptor */ /* Effect Control Interface Implementation: Process */ int Effect_process(effect_handle_t self, audio_buffer_t *inBuffer, audio_buffer_t *outBuffer) { EffectContext *pContext = (EffectContext *) self; int ret = 0; if (pContext != NULL) { int index = pContext->index; // if the index refers to HW , do not do anything. Just return. if (index == SUB_FX_HOST) { ret = (*pContext->eHandle[index])->process(pContext->eHandle[index], inBuffer, outBuffer); } } return ret; } /* end Effect_process */ /* Effect Control Interface Implementation: Command */ int Effect_command(effect_handle_t self, uint32_t cmdCode, uint32_t cmdSize, void *pCmdData, uint32_t *replySize, void *pReplyData) { EffectContext *pContext = (EffectContext *) self; int status = 0; if (pContext == NULL) { ALOGV("Effect_command() Proxy context is NULL"); return -EINVAL; } if (pContext->eHandle[SUB_FX_HOST] == NULL) { ALOGV("Effect_command() Calling HOST EffectCreate"); status = pContext->aeli[SUB_FX_HOST]->create_effect( &pContext->desc[SUB_FX_HOST].uuid, pContext->sessionId, pContext->ioId, &(pContext->eHandle[SUB_FX_HOST])); if (status != NO_ERROR || (pContext->eHandle[SUB_FX_HOST] == NULL)) { ALOGV("Effect_command() Error creating SW sub effect"); return status; } } if (pContext->eHandle[SUB_FX_OFFLOAD] == NULL) { ALOGV("Effect_command() Calling OFFLOAD EffectCreate"); status = pContext->aeli[SUB_FX_OFFLOAD]->create_effect( &pContext->desc[SUB_FX_OFFLOAD].uuid, pContext->sessionId, pContext->ioId, &(pContext->eHandle[SUB_FX_OFFLOAD])); if (status != NO_ERROR || (pContext->eHandle[SUB_FX_OFFLOAD] == NULL)) { ALOGV("Effect_command() Error creating HW effect"); pContext->eHandle[SUB_FX_OFFLOAD] = NULL; // Do not return error here as SW effect is created // Return error if the CMD_OFFLOAD sends the index as OFFLOAD } pContext->index = SUB_FX_HOST; } // EFFECT_CMD_OFFLOAD used to (1) send whether the thread is offload or not // (2) Send the ioHandle of the effectThread when the effect // is moved from one type of thread to another. // pCmdData points to a memory holding effect_offload_param_t structure if (cmdCode == EFFECT_CMD_OFFLOAD) { ALOGV("Effect_command() cmdCode = EFFECT_CMD_OFFLOAD"); if (cmdSize == 0 || pCmdData == NULL) { ALOGV("effectsOffload: Effect_command: CMD_OFFLOAD has no data"); *(int*)pReplyData = FAILED_TRANSACTION; return FAILED_TRANSACTION; } effect_offload_param_t* offloadParam = (effect_offload_param_t*)pCmdData; // Assign the effect context index based on isOffload field of the structure pContext->index = offloadParam->isOffload ? SUB_FX_OFFLOAD : SUB_FX_HOST; // if the index is HW and the HW effect is unavailable, return error // and reset the index to SW if (pContext->eHandle[pContext->index] == NULL) { ALOGV("Effect_command()CMD_OFFLOAD sub effect unavailable"); *(int*)pReplyData = FAILED_TRANSACTION; return FAILED_TRANSACTION; } pContext->ioId = offloadParam->ioHandle; ALOGV("Effect_command()CMD_OFFLOAD index:%d io %d", pContext->index, pContext->ioId); // Update the DSP wrapper with the new ioHandle. // Pass the OFFLOAD command to the wrapper. // The DSP wrapper needs to handle this CMD if (pContext->eHandle[SUB_FX_OFFLOAD]) { ALOGV("Effect_command: Calling OFFLOAD command"); return (*pContext->eHandle[SUB_FX_OFFLOAD])->command( pContext->eHandle[SUB_FX_OFFLOAD], cmdCode, cmdSize, pCmdData, replySize, pReplyData); } *(int*)pReplyData = NO_ERROR; ALOGV("Effect_command OFFLOAD return 0, replyData %d", *(int*)pReplyData); return NO_ERROR; } int index = pContext->index; if (index != SUB_FX_HOST && index != SUB_FX_OFFLOAD) { ALOGV("Effect_command: effect index is neither offload nor host"); return -EINVAL; } // Getter commands are only sent to the active sub effect. int *subStatus[SUB_FX_COUNT]; uint32_t *subReplySize[SUB_FX_COUNT]; void *subReplyData[SUB_FX_COUNT]; uint32_t tmpSize; int tmpStatus; // grow temp reply buffer if needed if (replySize != NULL) { tmpSize = pContext->replySize; while (tmpSize < *replySize && tmpSize < PROXY_REPLY_SIZE_MAX) { tmpSize *= 2; } if (tmpSize > pContext->replySize) { ALOGV("Effect_command grow reply buf to %d", tmpSize); pContext->replyData = (char *)realloc(pContext->replyData, tmpSize); pContext->replySize = tmpSize; } if (tmpSize > *replySize) { tmpSize = *replySize; } } else { tmpSize = 0; } // tmpSize is now the actual reply size for the non active sub effect // Send command to sub effects. The command is sent to all sub effects so that their internal // state is kept in sync. // Only the reply from the active sub effect is returned to the caller. The reply from the // other sub effect is lost in pContext->replyData for (int i = 0; i < SUB_FX_COUNT; i++) { if (pContext->eHandle[i] == NULL) { continue; } if (i == index) { subStatus[i] = &status; subReplySize[i] = replySize; subReplyData[i] = pReplyData; } else { subStatus[i] = &tmpStatus; subReplySize[i] = replySize == NULL ? NULL : &tmpSize; subReplyData[i] = pReplyData == NULL ? NULL : pContext->replyData; } *subStatus[i] = (*pContext->eHandle[i])->command( pContext->eHandle[i], cmdCode, cmdSize, pCmdData, subReplySize[i], subReplyData[i]); } return status; } /* end Effect_command */ /* Effect Control Interface Implementation: get_descriptor */ int Effect_getDescriptor(effect_handle_t self, effect_descriptor_t *pDescriptor) { EffectContext * pContext = (EffectContext *) self; const effect_descriptor_t *desc; ALOGV("Effect_getDescriptor"); if (pContext == NULL || pDescriptor == NULL) { ALOGV("Effect_getDescriptor() invalid param"); return -EINVAL; } if (pContext->desc == NULL) { ALOGV("Effect_getDescriptor() could not get descriptor"); return -EINVAL; } desc = &pContext->desc[SUB_FX_HOST]; *pDescriptor = *desc; pDescriptor->uuid = pContext->uuid; // Replace the uuid with the Proxy UUID // Also set/clear the EFFECT_FLAG_OFFLOAD_SUPPORTED flag based on the sub effects availability if (pContext->eHandle[SUB_FX_OFFLOAD] != NULL) pDescriptor->flags |= EFFECT_FLAG_OFFLOAD_SUPPORTED; else pDescriptor->flags &= ~EFFECT_FLAG_OFFLOAD_SUPPORTED; return 0; } /* end Effect_getDescriptor */ } // namespace android __attribute__ ((visibility ("default"))) audio_effect_library_t AUDIO_EFFECT_LIBRARY_INFO_SYM = { .tag = AUDIO_EFFECT_LIBRARY_TAG, .version = EFFECT_LIBRARY_API_VERSION, .name = "Effect Proxy", .implementor = "AOSP", .create_effect = android::EffectProxyCreate, .release_effect = android::EffectProxyRelease, .get_descriptor = android::EffectProxyGetDescriptor, };