FreeCalypso > hg > fc-magnetite
diff src/cs/services/dar/dar_env.c @ 0:945cf7f506b2
src/cs: chipsetsw import from tcs211-fcmodem
binary blobs and LCD demo files have been excluded,
all line endings are LF only
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Sun, 25 Sep 2016 22:50:11 +0000 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cs/services/dar/dar_env.c Sun Sep 25 22:50:11 2016 +0000 @@ -0,0 +1,282 @@ +/****************************************************************************/ +/* */ +/* File Name: dar_env.c */ +/* */ +/* Purpose: This file contains routines that will be called in order to: */ +/* - notify the Environment of the diagnose's Memory Banks */ +/* requirements, */ +/* - set diagnose's addr and memory banks IDs */ +/* - initialize all the diagnose's data structures, */ +/* - start the diagnose's task */ +/* - stop the diagnose's task */ +/* - kill the diagnose's task */ +/* */ +/* Version 0.1 */ +/* */ +/* Date Modification */ +/* ------------------------------------ */ +/* 26 September 2001 Create */ +/* */ +/* Author Stephanie Gerthoux */ +/* */ +/* (C) Copyright 2001 by Texas Instruments Incorporated, All Rights Reserved*/ +/****************************************************************************/ + +#include "rv/rv_defined_swe.h" +#ifdef RVM_DAR_SWE + #include "rv/rv_general.h" + #include "rvm/rvm_gen.h" + #include "rvm/rvm_priorities.h" + #include "rvm/rvm_use_id_list.h" + #include "dar/dar_api.h" + #include "dar/dar_env.h" + #include "dar/dar_macro_i.h" + + #include <string.h> + + extern T_RV_RET dar_core(void); + + /**** Initialisation of the pointer to the Global Environment Control block ****/ + T_DAR_ENV_CTRL_BLK *dar_gbl_var_p = NULL; + + /**** Define extern variables ****/ + /* Get the last status of the system */ + extern T_DAR_RECOVERY_STATUS dar_current_status; + + /* Get the last exception of the system */ + extern UINT8 dar_exception_status; + + /* Define the recovery buffer */ + extern UINT32 dar_recovery_buffer; + + /* DAR previous status */ + extern T_DAR_RECOVERY_STATUS dar_previous_status; + + /* DAR previous status */ + extern UINT8 dar_previous_exception; + + /********************************************************************************/ + /* Function : dar_get_info */ + /* */ + /* Description : This function is called by the RV Environment to learn */ + /* diagnose requirements in terms of memory, SWEs... */ + /* */ + /* Parameters : T_RVM_INFO_SWE * swe_info: pointer to the structure to fill */ + /* containing infos related to the diagnose SWE. */ + /* */ + /* Return : T_RV_RETURN */ + /* */ + /* History : 0.1 (26-September-2001) */ + /* */ + /* */ + /********************************************************************************/ + T_RVM_RETURN dar_get_info(T_RVM_INFO_SWE *infoSWEnt) + { + /* SWE info */ + infoSWEnt->swe_type = RVM_SWE_TYPE_4; + infoSWEnt->type_info.type4.swe_use_id = DAR_USE_ID; + + memcpy( infoSWEnt->type_info.type4.swe_name, "DAR", sizeof("DAR") ); + + infoSWEnt->type_info.type4.stack_size = DAR_STACK_SIZE; + infoSWEnt->type_info.type4.priority = RVM_DAR_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, "DAR_MB", sizeof("DAR_MB")); + infoSWEnt->type_info.type4.mem_bank[0].initial_params.size = DAR_MB_SIZE; + infoSWEnt->type_info.type4.mem_bank[0].initial_params.watermark = DAR_MB_WATERMARK; + + /* linked SWE info */ + /* this SWE requires the FFS SWE to run */ + + infoSWEnt->type_info.type4.nb_linked_swe = 0x01; + infoSWEnt->type_info.type4.linked_swe_id[0]= FFS_USE_ID; + + /* generic functions */ + infoSWEnt->type_info.type4.set_info = dar_set_info; + infoSWEnt->type_info.type4.init = dar_init; + infoSWEnt->type_info.type4.core = dar_core; + infoSWEnt->type_info.type4.stop = dar_stop; + infoSWEnt->type_info.type4.kill = dar_kill; + + return RVM_OK; + } + + /**************** End of dar_get_info function ********************************/ + + /********************************************************************************/ + /* Function : dar_set_info */ + /* */ + /* Description : This function is called by the RV Environment to inform */ + /* the diagnose SWE about addr_id, mb_id and error function. */ + /* */ + /* Parameters : - T_RVF_ADDR_ID addrId: address 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 : 0.1 (27-September-2001 ) */ + /* */ + /* */ + /********************************************************************************/ + T_RVM_RETURN dar_set_info(T_RVF_ADDR_ID addrId, + T_RV_RETURN return_path[], + T_RVF_MB_ID mbId[], + T_RVM_RETURN (*callBackFctError) ( 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[0], + sizeof(T_DAR_ENV_CTRL_BLK), + (T_RVF_BUFFER **) & dar_gbl_var_p); + + /* If insufficient resources to properly run the DAR's task, then abort. */ + switch (mb_status) + { + case RVF_GREEN: + { + /* Initialize the Global Environment Control Block */ + memset((UINT8 *) dar_gbl_var_p, + 0x00, + sizeof (T_DAR_ENV_CTRL_BLK)); + + /* Store the memory bank IDs assigned to the DAR */ + dar_gbl_var_p->mb_dar = mbId[0]; + + /* Store the addr ID assigned to the DAR */ + dar_gbl_var_p->addrId = addrId; + + /* Store the function to be called whenever any unrecoverable */ + /* error occurs. */ + dar_gbl_var_p->callBackFctError = callBackFctError; + DAR_SEND_TRACE(" Diagnose And Recovery (env). DAR's information set ", + RV_TRACE_LEVEL_DEBUG_LOW); + break; + } + case RVF_YELLOW: + { + rvf_free_buf((T_RVF_BUFFER *) dar_gbl_var_p); + DAR_TRACE_WARNING(" DAR memory warning (orange memory)"); + return (RV_MEMORY_ERR); + } + default: + { + DAR_TRACE_WARNING(" DAR memory warning (red memory)"); + return (RV_MEMORY_ERR); + } + } /* switch (mb_status) */ + + return (RV_OK); + } /*************** End of dar_set_info function ********************************/ + + + + /********************************************************************************/ + /* Function : dar_init */ + /* */ + /* Description : This function is called by the RV Environment to initialize the*/ + /* diagnose SWE before creating the task and calling dar_start. */ + /* */ + /* Parameters : None */ + /* */ + /* Return : T_RVM_RETURN */ + /* */ + /* History : 0.1 (27-September-2001) */ + /* */ + /* */ + /********************************************************************************/ + T_RVM_RETURN dar_init(void) + { + /*** Declare local variables ***/ + UINT16 i = 0; + + /*** Initialization of the DAR global structure ***/ + + /* Initialization of the dar_filter_array */ + for (i=0;i<DAR_MAX_GROUP_NB;i++) + { + dar_gbl_var_p ->dar_filter_array[i].group_nb = DAR_INITIALIZATION_VALUE; + dar_gbl_var_p ->dar_filter_array[i].mask_warning = DAR_INITIALIZATION_VALUE; + dar_gbl_var_p ->dar_filter_array[i].mask_debug = DAR_INITIALIZATION_VALUE; + } + + /*Initialization of the index and the free index */ + dar_gbl_var_p ->index = DAR_INVALID_VALUE; + dar_gbl_var_p ->free_index = DAR_INVALID_VALUE; + + /*** Value of the DAR recovery status ***/ + dar_previous_status = dar_current_status; + + /* erase the dar_current_status value */ + dar_current_status = DAR_POWER_ON_OFF; + + /*** Value of the DAR exception status ***/ + dar_previous_exception = dar_exception_status; + + /* erase the dar_exception_status value */ + dar_exception_status = DAR_NO_ABORT_EXCEPTION; + + return RV_OK; + } + + + /*************************************************************************************/ + /* Function : dar_stop */ + /* */ + /* Description : This function is called by the RV Environment to stop the diagnose */ + /* SWE. */ + /* */ + /* Parameters : None */ + /* */ + /* Return : T_RVM_RETURN */ + /* */ + /* History : 0.1 (27-September-2001) */ + /* */ + /* */ + /*************************************************************************************/ + T_RVM_RETURN dar_stop(void) + { + /* other SWEs have not been killed yet, DAR can send messages to other SWEs */ + + return RV_OK; + } + + + /*************************************************************************************/ + /* Function : dar_kill */ + /* */ + /* Description : This function is called by the RV Environment to kill the diagnose */ + /* SWE, after the diagnose_stop function has been called. */ + /* */ + /* Parameters : None */ + /* */ + /* Return : T_RVM_RETURN */ + /* */ + /* History : 0.1 (27-September-2001) */ + /* */ + /* */ + /*************************************************************************************/ + T_RVM_RETURN dar_kill (void) + { + /* free all memory buffer previously allocated */ + rvf_free_buf ((T_RVF_BUFFER *) dar_gbl_var_p); + return RV_OK; + } + +#endif /* #ifdef RVM_DAR_SWE */