--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cs/services/Audio/Audio_bgd/audio_bgd_env.c	Sun Jul 15 04:39:26 2018 +0000
@@ -0,0 +1,254 @@
+/****************************************************************************/
+/*                                                                          */
+/*  File Name:  audio_env_bgd.c                                             */
+/*                                                                          */
+/*  Purpose:  This file contains routines that will be called in order to:  */
+/*              Memory Banks requirements,                                  */
+/*            - set AUDIO BACKGROUND task and memory banks IDs              */
+/*            - initialize all the AUDIO BACKGROUND data structures,        */
+/*            - start the task                                              */
+/*            - stop the task                                               */
+/*            - kill the task                                               */
+/*                                                                          */
+/*  Version   1                                                             */
+/*                                                                          */
+/*  Date         Modification                                               */
+/*  ------------------------------------                                    */
+/*  19 June 2003  Create                                                    */
+/*                                                                          */
+/*  Author       Frederic Turgis                                            */
+/*                                                                          */
+/* (C) Copyright 2001 by Texas Instruments Incorporated, All Rights Reserved*/
+/****************************************************************************/
+
+#include "rv/rv_defined_swe.h"
+
+// DO NOT REMOVE: ensures library is not created empty to avoid issue at linking
+void audio_bgd_dummy(void)
+{
+}
+
+#ifdef RVM_AUDIO_BGD_SWE
+
+  #include "rvm/rvm_use_id_list.h"
+  #include "rvm/rvm_priorities.h"
+  #include "rvf/rvf_pool_size.h"
+  #include "audio/audio_bgd/audio_bgd_structs_i.h"
+  #include "audio/audio_bgd/audio_bgd_macro_i.h"
+  #include "audio/audio_pool_size.h"
+
+  #include <string.h>
+
+  T_RVM_RETURN audio_bgd_get_info (T_RVM_INFO_SWE  *infoSWEnt);
+  T_RVM_RETURN audio_bgd_set_info(T_RVF_ADDR_ID addrId,
+                                T_RV_RETURN   return_path[],
+                                T_RVF_MB_ID   mbId[],
+                                T_RVM_RETURN  (*callBackFct) ( T_RVM_NAME SWEntName,
+                                                               T_RVM_RETURN errorCause,
+                                                               T_RVM_ERROR_TYPE errorType,
+                                                               T_RVM_STRING errorMsg) );
+  T_RVM_RETURN audio_bgd_init (void);
+  T_RVM_RETURN audio_bgd_stop (void);
+  T_RVM_RETURN audio_bgd_kill (void);
+
+  extern T_RV_RET audio_bgd_core(void);
+
+  /* Initialisation of the pointer to the Global Environment Control block */
+  T_AUDIO_BGD_ENV_CTRL_BLK *p_audio_bgd_gbl_var = NULL;
+
+
+  /********************************************************************************/
+  /* Function   : audio_bgd_get_info                                              */
+  /*                                                                              */
+  /* Description : This function is called by the Bt Environment to learn         */
+  /*               audio background requirements in terms of memory, SWEs...      */
+  /*                                                                              */
+  /* Parameters  : T_RVM_INFO_SWE  * swe_info: pointer to the structure to fill   */
+  /*               containing infos related to the Audio SWE.                     */
+  /*                                                                              */
+  /* Return      :  T_BTE_RETURN                                                  */
+  /*                                                                              */
+  /* History      : 0.1 (11-May-2001)                                             */
+  /*                                                                              */
+  /*                                                                              */
+  /********************************************************************************/
+  T_RVM_RETURN audio_bgd_get_info(T_RVM_INFO_SWE  *infoSWEnt)
+  {
+    /* SWE info */
+    infoSWEnt->swe_type = RVM_SWE_TYPE_4;
+    infoSWEnt->type_info.type4.swe_use_id = AUDIO_BGD_USE_ID;
+
+    memcpy( infoSWEnt->type_info.type4.swe_name, "AUDIO_BGD", sizeof("AUDIO_BGD") );
+
+    infoSWEnt->type_info.type4.stack_size = AUDIO_BGD_STACK_SIZE;
+    infoSWEnt->type_info.type4.priority   = RVM_AUDIO_BGD_TASK_PRIORITY;
+
+
+    /* Set the return path */
+    infoSWEnt->type_info.type4.return_path.callback_func  = NULL;
+    infoSWEnt->type_info.type4.return_path.addr_id        = 0;
+
+
+    /* memory bank info */
+    infoSWEnt->type_info.type4.nb_mem_bank = 0x01;
+
+    /* Memory bank used to receive/send the message to/from the entity */
+    memcpy ((UINT8 *) ((infoSWEnt->type_info.type4.mem_bank[0]).bank_name), "AUDIO_BGD",sizeof("AUDIO_BGD"));
+    ((infoSWEnt->type_info.type4.mem_bank[0]).initial_params).size          = AUDIO_BGD_MB1_SIZE;
+    ((infoSWEnt->type_info.type4.mem_bank[0]).initial_params).watermark     = AUDIO_BGD_MB1_SIZE;
+
+    /* linked SWE info */
+    /* this SWE requires no SWE to run in PC environement*/
+    infoSWEnt->type_info.type4.nb_linked_swe   = 0x00;
+
+    /* generic functions */
+    infoSWEnt->type_info.type4.set_info = audio_bgd_set_info;
+    infoSWEnt->type_info.type4.init     = audio_bgd_init;
+    infoSWEnt->type_info.type4.core     = audio_bgd_core;
+    infoSWEnt->type_info.type4.stop     = audio_bgd_stop;
+    infoSWEnt->type_info.type4.kill     = audio_bgd_kill;
+
+    return (RV_OK);
+  } /**************** End of audio_bgd_get_info function ******************************/
+
+  /********************************************************************************/
+  /* Function   : audio_bgd_set_info                                              */
+  /*                                                                              */
+  /* Description : This function is called by the RV Environment to inform        */
+  /*               the audio SWE about task_id, mb_id and error function.         */
+  /*                                                                              */
+  /* Parameters  : - T_RVM_TASK_ID  taskId[]: array of task_id.                   */
+  /*               - task_id[0] contains audio task_id.                           */
+  /*               - T_RVF_MB_ID mb_id[]: array of memory bank ids.               */
+  /*                - callback function to call in case of unrecoverable error.   */
+  /*                                                                              */
+  /* Return      : T_RVM_RETURN                                                   */
+  /*                                                                              */
+  /* History    : 1 (19-June-2003 )                                               */
+  /*                                                                              */
+  /*                                                                              */
+  /********************************************************************************/
+  T_RVM_RETURN audio_bgd_set_info(T_RVF_ADDR_ID addrId,
+                              T_RV_RETURN   return_path[],
+                              T_RVF_MB_ID   mbId[],
+                              T_RVM_RETURN  (*callBackFct) ( T_RVM_NAME SWEntName,
+                                                             T_RVM_RETURN errorCause,
+                                                             T_RVM_ERROR_TYPE errorType,
+                                                             T_RVM_STRING errorMsg) )
+  {
+
+    /* Declare local variable.*/
+    T_RVF_MB_STATUS mb_status = RVF_GREEN;
+
+    /* Allocate memory required to store the Global Environment control Block. */
+    mb_status = rvf_get_buf(mbId[1],
+                            sizeof(T_AUDIO_BGD_ENV_CTRL_BLK),
+                            (T_RVF_BUFFER **) & p_audio_bgd_gbl_var);
+
+    /* If insufficient resources to properly run the AUDIO's task, then abort. */
+    switch (mb_status)
+    {
+      case RVF_GREEN:
+      {
+        /* Initialize the Global Environment Control Block */
+        memset((UINT8 *) p_audio_bgd_gbl_var,
+               0x00,
+               sizeof (T_AUDIO_BGD_ENV_CTRL_BLK));
+
+        /* Store the memory bank IDs assigned to the AUDIO */
+        p_audio_bgd_gbl_var->mb = mbId[0];
+
+        /* Store the address ID assigned to the AUDIO */
+        p_audio_bgd_gbl_var->addrId = addrId;
+
+        /* Store the function to be called whenever any unrecoverable */
+        /* error occurs.                                              */
+        p_audio_bgd_gbl_var->callBackFct = callBackFct;
+        AUDIO_BGD_SEND_TRACE(" AUDIO BGD (env). information set ",
+                             RV_TRACE_LEVEL_DEBUG_LOW);
+      }
+      break; // case RVF_GREEN:
+      case RVF_YELLOW:
+      {
+        rvf_free_buf((T_RVF_BUFFER *) p_audio_bgd_gbl_var);
+        AUDIO_BGD_TRACE_WARNING(" AUDIO BGD memory warning (orange memory)");
+        return (RV_MEMORY_ERR);
+      }
+      break; // case RVF_YELLOW:
+      default:
+      {
+        AUDIO_BGD_TRACE_WARNING(" AUDIO BGD memory warning (red memory)");
+        return (RV_MEMORY_ERR);
+      }
+    } /* switch (mb_status) */
+
+    return (RV_OK);
+  } /*************** End of audio_bgd_set_info function ********************************/
+
+
+
+  /********************************************************************************/
+  /* Function   : audio_bgd_init                                                      */
+  /*                                                                              */
+  /* Description : This function is called by the BT Environment to initialize the*/
+  /*               audio SWE before creating the task and calling audio_start.    */
+  /*                                                                              */
+  /* Parameters  : None                                                           */
+  /*                                                                              */
+  /* Return      : T_RVM_RETURN                                                   */
+  /*                                                                              */
+  /* History    : 0.1 (20-August-2000)                                            */
+  /*                                                                              */
+  /*                                                                              */
+  /********************************************************************************/
+  T_RVM_RETURN audio_bgd_init(void)
+  {
+    /* Put global audio initialization */
+
+    return RV_OK;
+  }
+
+
+  /*************************************************************************************/
+  /* Function	  : audio_bgd_stop                                                           */
+  /*                                                                                   */
+  /* Description : This function is called by the BT Environment to stop the audio SWE.*/
+  /*                                                                                   */
+  /* Parameters  : None                                                                */
+  /*                                                                                   */
+  /* Return      : T_RVM_RETURN                                                        */
+  /*                                                                                   */
+  /* History    : 0.1 (11-May-2001)                                                    */
+  /*                                                                                   */
+  /*                                                                                   */
+  /*************************************************************************************/
+  T_RVM_RETURN audio_bgd_stop(void)
+  {
+    /* other SWEs have not been killed yet, audio can send messages to other SWEs      */
+
+    return RV_OK;
+  }
+
+
+  /*************************************************************************************/
+  /* Function   : audio_bgd_kill                                                           */
+  /*                                                                                   */
+  /* Description : This function is called by the BT Environment to kill the audio     */
+  /*               SWE, after the audio_stop function has been called.                 */
+  /*                                                                                   */
+  /* Parameters  : None                                                                */
+  /*                                                                                   */
+  /* Return      : T_BTE_RETURN                                                        */
+  /*                                                                                   */
+  /* History     : 0.1 (11-May-2001)                                                   */
+  /*                                                                                   */
+  /*                                                                                   */
+  /*************************************************************************************/
+  T_RVM_RETURN audio_bgd_kill (void)
+  {
+    /* free all memory buffer previously allocated */
+    rvf_free_buf ((T_RVF_BUFFER *) p_audio_bgd_gbl_var);
+    return RV_OK;
+  }
+
+#endif // #ifdef RVM_AUDIO_BGD_SWE