view src/cs/services/dar/dar_env.c @ 629:3231dd9b38c1

armio.c: make GPIOs 8 & 13 outputs driving 1 on all "classic" targets Calypso GPIOs 8 & 13 are pinmuxed with MCUEN1 & MCUEN2, respectively, and on powerup these pins are MCUEN, i.e., outputs driving 1. TI's code for C-Sample and earlier turns them into GPIOs configured as outputs also driving 1 - so far, so good - but TI's code for BOARD 41 (which covers D-Sample, Leonardo and all real world Calypso devices derived from the latter) switches them from MCUEN to GPIOs, but then leaves them as inputs. Given that the hardware powerup state of these two pins is outputs driving 1, every Calypso board design MUST be compatible with such driving; typically these GPIO signals will be either unused and unconnected or connected as outputs driving some peripheral. Turning these pins into GPIO inputs will result in floating inputs on every reasonably-wired board, thus I am convinced that this configuration is nothing but a bug on the part of whoever wrote this code at TI. This floating input bug had already been fixed earlier for GTA modem and FCDEV3B targets; the present change makes the fix unconditional for all "classic" targets. The newly affected targets are D-Sample, Leonardo, Tango and GTM900.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 02 Jan 2020 05:38:26 +0000
parents 945cf7f506b2
children
line wrap: on
line source

/****************************************************************************/
/*                                                                          */
/*  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 */