FreeCalypso > hg > fc-tourmaline

view src/g23m-aci/aci/cmh_gmm.h @ 220:0ed36de51973

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ABB semaphore protection overhaul The ABB semaphone protection logic that came with TCS211 from TI was broken in several ways: * Some semaphore-protected functions were called from Application_Initialize() context. NU_Obtain_Semaphore() called with NU_SUSPEND fails with NU_INVALID_SUSPEND in this context, but the return value wasn't checked, and NU_Release_Semaphore() would be called unconditionally at the end. The latter call would increment the semaphore count past 1, making the semaphore no longer binary and thus no longer effective for resource protection. The fix is to check the return value from NU_Obtain_Semaphore() and skip the NU_Release_Semaphore() call if the semaphore wasn't properly obtained. * Some SPI hardware manipulation was being done before entering the semaphore- protected critical section. The fix is to reorder the code: first obtain the semaphore, then do everything else. * In the corner case of L1/DSP recovery, l1_abb_power_on() would call some non-semaphore-protected ABB & SPI init functions. The fix is to skip those calls in the case of recovery. * A few additional corner cases existed, all of which are fixed by making ABB semaphore protection 100% consistent for all ABB functions and code paths. There is still one remaining problem of priority inversion: suppose a low- priority task calls an ABB function, and some medium-priority task just happens to preempt right in the middle of that semaphore-protected ABB operation. Then the high-priority SPI task is locked out for a non-deterministic time until that medium-priority task finishes its work and goes back to sleep. This priority inversion problem remains outstanding for now.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 26 Apr 2021 20:55:25 +0000
parents fa8dc04885d8
children
line wrap: on
line source

/* 
+----------------------------------------------------------------------------- 
|  Project :  
|  Modul   :  
+----------------------------------------------------------------------------- 
|  Copyright 2002 Texas Instruments Berlin, AG 
|                 All rights reserved. 
| 
|                 This file is confidential and a trade secret of Texas 
|                 Instruments Berlin, AG 
|                 The receipt of or possession of this file does not convey 
|                 any rights to reproduce or disclose its contents or to 
|                 manufacture, use, or sell anything it may describe, in 
|                 whole, or in part, without the specific written consent of 
|                 Texas Instruments Berlin, AG. 
+----------------------------------------------------------------------------- 
|  Purpose :  Definitions for the protocol stack adapter 
|             GPRS Mobility Mangement ( GMM ).
+----------------------------------------------------------------------------- 
*/ 

#ifdef GPRS

#ifndef CMH_GMM_H
#define CMH_GMM_H

/*==== CONSTANTS ==================================================*/
 
 
/*==== TYPES ======================================================*/
typedef enum
{
  GMMH_CMD_OK,
  GMMH_CMD_AT_NOT_HANDLED

} T_GMMH_RETURN;

typedef enum 
{
  GMMU_AT_GPRS,
  GMMU_AT_GSM

} T_GMM_USER;

typedef struct
{
  T_PERCENT_CGCLASS current;
  T_PERCENT_CGCLASS requested;

} T_GACI_MOBILE_CLASS;

/*==== PROTOTYPES =================================================*/
EXTERN void  cmhGMM_Init      ( void );
EXTERN void  cmhGMM_Attached  ( UBYTE attach_type, T_plmn *plmn, UBYTE search_running );
EXTERN void  cmhGMM_NoAttach  ( UBYTE detach_type, USHORT cause, UBYTE search_running );
EXTERN void  cmhGMM_Detached  ( UBYTE detach_type );
EXTERN void  cmhGMM_NetDetach ( UBYTE detach_type, USHORT cause, UBYTE search_running );
EXTERN SHORT cmhGMM_Plmn      ( void );
EXTERN SHORT cmhGMM_Suspend   ( UBYTE cell_state );
EXTERN SHORT cmhGMM_Resume    ( void );
EXTERN SHORT cmhGMM_Info      ( void );
EXTERN SHORT cmhGMM_CipheringInd ( UBYTE gsm_ciph, UBYTE gprs_ciph );


EXTERN T_ATTACH_STATE cmhGMM_Get_state  ( void );
EXTERN void           cmhGMM_Set_state  ( T_ATTACH_STATE state );
EXTERN T_ACI_RETURN   cmhGMM_attach_if_necessary ( T_ACI_CMD_SRC srcId, T_ACI_AT_CMD curCmd );
EXTERN SHORT          cmhGMM_inform_other_psa    ( SHORT state );

EXTERN UBYTE          cmhGMM_requested_attach_type ( T_GMM_USER usr, UBYTE m_class );
EXTERN UBYTE          cmhGMM_translate_gmm_cause_to_nreg_cs ( USHORT cause );
EXTERN BOOL           cmhGMM_isClassCG ( void );


EXTERN SHORT psaG_MM_CMD_REG            ( void );
EXTERN SHORT psaG_MM_CMD_DEREG          ( UBYTE  detach_type );
EXTERN SHORT psaG_MM_CMD_NET_SRCH       ( void );
EXTERN SHORT psaG_MM_CMD_NET_SEL        ( void );
EXTERN SHORT psaG_MM_CMD_SET_REGMD      ( UBYTE mode );

EXTERN SHORT gprs_sim_inserted          ( void );
EXTERN BOOL  cmhGMM_class_eq_CG         ( void );
EXTERN T_ACI_RETURN cmhGMM_attach       ( UBYTE mobile_class );

EXTERN void cmhGMM_send_percentNetworkRegistrationStatus( T_P_CGREG_STAT p_cgreg );
EXTERN void cmhGMM_send_NetworkRegistrationStatus( T_CGREG_STAT cgreg, T_P_CGREG_STAT p_cgreg );
EXTERN UBYTE cmhGMM_isPLMN_Home( void );
EXTERN UBYTE cmhGMM_isPLMN_Valid (void);
EXTERN void cmhGMM_setPLMN(T_plmn *plmn);


EXTERN void  cmhGMM_allContextsDeactivated  ( void );
EXTERN T_ACI_RETURN cmhGMM_contextActivation( T_ACI_CMD_SRC srcId, T_ACI_AT_CMD curCmd );

/*==== EXPORT =====================================================*/
#ifdef CMH_GMMF_C

GLOBAL T_ENT_STAT gmmEntStat;
GLOBAL T_GACI_MOBILE_CLASS gaciMobileClass;

#else

EXTERN T_ENT_STAT gmmEntStat;
EXTERN T_GACI_MOBILE_CLASS gaciMobileClass;

#endif /* CMH_GMMF_C */

#endif /* CMH_GMM_H */


#endif  /* GPRS */
/*==== EOF =======================================================*/