view src/g23m-gprs/upm/upm.c @ 638:cab2f315827e

FFS dev.c: added Spansion PL032J to the "generic" table With the discovery of first GTM900 and then Tango, it now appears that Openmoko was not the only manuf after all who kept TI's TCS211 firmware largely intact (as opposed to changing it beyond all recognition like Compal, Chi-Mei and BenQ did), thus we are now getting new "alien" targets on which we reuse the original manuf's FFS with IMEI and RF calibration tables as if it were native. On these targets we use the original device table for FFS, even though we previously thought that it would never apply to any target other than dsample, leonardo and gtamodem. We have previously added Samsung K5L33xxCAM (a new kind of multi-ID device) to the generic table to support its use in Huawei GTM900-B modules; now we got news that some slightly older GTM900-B specimen used S71PL032J instead, so we are now adding PL032J as well.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 30 Jan 2020 17:45:48 +0000
parents 2cf312e56ee7
children
line wrap: on
line source

/*----------------------------------------------------------------------------
|  Project :  3G PS
|  Module  :  UPM
+-----------------------------------------------------------------------------
|             Copyright 2003 Texas Instruments.
|             All rights reserved. 
| 
|             This file is confidential and a trade secret of Texas 
|             Instruments .
|             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. 
+-----------------------------------------------------------------------------
| Purpose:    Utility functions for the UPM entity.
|             For design details, see:
|             8010.939 UPM Detailed Specification
+---------------------------------------------------------------------------*/

/*==== DECLARATION CONTROL =================================================*/

/*==== INCLUDES ============================================================*/

#include "upm.h"

/*==== CONSTS ===============================================================*/

/*==== TYPES ================================================================*/

T_UPM_DATA upm_data;

/*==== LOCALS ===============================================================*/

/*==== PUBLIC FUNCTIONS =====================================================*/

/*
+------------------------------------------------------------------------------
| Function    : upm_pfree
+------------------------------------------------------------------------------
| Description : PFREE macro replacement
|
| Parameters  : data                - memory to free
+------------------------------------------------------------------------------
*/
void upm_pfree(/*@only@*/ /*@null@*/ /*@out@*/ void *data)
{
  if (data != NULL)
  {
    vsi_c_pfree((T_VOID_STRUCT **)&data FILE_LINE_MACRO);
  }
}

/*
+------------------------------------------------------------------------------
| Function    : upm_mfree
+------------------------------------------------------------------------------
| Description : Wrapper for MFREE macro.
|
| Parameters  : data                   - memory to free (NULL allowed)
+------------------------------------------------------------------------------
*/
void upm_mfree(/*@only@*/ /*@out@*/ /*@null@*/ void *data)
{
  if (data != NULL) {
    MFREE(data);
  }
}

/*
+------------------------------------------------------------------------------
| Function    : upm_nsapi2nsapi_set
+------------------------------------------------------------------------------
| Description : Return nsapi_set corresponding to NSAPI
|
| Parameters  : nsapi                  - NSAPI
+------------------------------------------------------------------------------
*/
U16 upm_nsapi2nsapi_set(int /*@alt U8@*/ nsapi) /*@*/
{
  TRACE_ASSERT ((T_NAS_nsapi)nsapi >= NAS_NSAPI_5 &&  nsapi <= NAS_NSAPI_15);

  return (U16)(1UL << (U16)nsapi);
}

/*
+------------------------------------------------------------------------------
| Function    : upm_get_context_data_from_nsapi
+------------------------------------------------------------------------------
| Description : Returns context data structure associated with indicated NSAPI.
|
| Parameters  : nsapi                  - NSAPI index
+------------------------------------------------------------------------------
*/
/*@null@*/ /*@exposed@*/
struct T_CONTEXT_DATA *upm_get_context_data_from_nsapi(int /*@alt U8@*/ nsapi)
{
  TRACE_ASSERT (((T_NAS_nsapi)nsapi >= NAS_NSAPI_5 && nsapi <= NAS_NSAPI_15));

  /*lint -e{661} upm_context_array causes out of bounds access, it does not! */
  return (upm_data.upm_context_array[nsapi - (int)NAS_NSAPI_5]);
}

/*
+------------------------------------------------------------------------------
| Function    : upm_assign_context_data_to_nsapi
+------------------------------------------------------------------------------
| Description : Assign context data structure to global context array.
|
| Parameters  : ptr_context_data       - Pointer to context data
|               nsapi                  - NSAPI index
+------------------------------------------------------------------------------
*/
void upm_assign_context_data_to_nsapi(/*@keep@*/
				      struct T_CONTEXT_DATA *ptr_context_data,
				      int /*@alt U8@*/ nsapi)
{
  (void)TRACE_EVENT_P2("upm_assign_context_data_to_nsapi: NSAPI%3d = %p", nsapi, ptr_context_data);

  TRACE_ASSERT ((T_NAS_nsapi)nsapi >= NAS_NSAPI_5 && nsapi <= NAS_NSAPI_15);

  /*lint -e{661} upm_context_array causes out of bounds access, it does not! */
  upm_data.upm_context_array[nsapi - (int)NAS_NSAPI_5] = ptr_context_data;
  ptr_context_data->nsapi = nsapi;
}

/*
+------------------------------------------------------------------------------
| Function    : upm_free_context_data
+------------------------------------------------------------------------------
| Description : Free context data structure associated with indicated NSAPI.
|
| Parameters  : nsapi                  - NSAPI index
+------------------------------------------------------------------------------
*/
void upm_free_context_data(int /*@alt U8@*/ nsapi)
{
  TRACE_ASSERT ((T_NAS_nsapi)nsapi >= NAS_NSAPI_5 && nsapi <= NAS_NSAPI_15);

  /*lint -e661 (upm_context_array causes out of bounds access, it does not!) */
  if ( upm_data.upm_context_array[nsapi - (int)NAS_NSAPI_5] != NULL ) {
    upm_mfree(upm_data.upm_context_array[nsapi - (int)NAS_NSAPI_5]);
    upm_data.upm_context_array[nsapi - (int)NAS_NSAPI_5] = NULL;
  /*lint +e661 (upm_context_array causes out of bounds access, it does not!) */	
  }
}

/*
+------------------------------------------------------------------------------
| Function    : upm_check_for_released_context_and_release
+------------------------------------------------------------------------------
| Description : Check whether a context is released (both link and DTI
|               connections released), and if so, freee context data structure
|               associated with indicated NSAPI.
|
| Parameters  : nsapi                  - NSAPI index
+------------------------------------------------------------------------------
*/
void upm_check_for_released_context_and_release(struct T_CONTEXT_DATA *context)
{
  if (upm_is_link_released(context)
#ifndef UPM_WITHOUT_USER_PLANE
      && upm_is_dti_disconnected(context)
#endif
      )
  {
    U8 nsapi = context->nsapi;

    upm_free_context_data(nsapi);
    (void)TRACE_EVENT_P1("upm_check_for_released_context_and_release on NSAPI %d: Context data freed...", nsapi);
  }
}

/*
+------------------------------------------------------------------------------
| Function    : upm_get_current_rat
+------------------------------------------------------------------------------
| Description : Returns the RAT in which UPM is currently active
|
| Parameters  : None
+------------------------------------------------------------------------------
*/
#ifdef TI_DUAL_MODE
T_PS_rat upm_get_current_rat(void)
{
  return upm_data.upm_rat;
}
#endif /* TI_DUAL_MODE */

/*
+------------------------------------------------------------------------------
| Function    : upm_set_current_rat
+------------------------------------------------------------------------------
| Description : Sets currently active RAT
|
| Parameters  : rat                    - RAT received from SM or MM
+------------------------------------------------------------------------------
*/
#ifdef TI_DUAL_MODE
void upm_set_current_rat(T_PS_rat rat)
     /*@modifies upm_data.upm_rat@*/
{
  upm_data.upm_rat = rat;
}
#endif /* TI_DUAL_MODE */

/*
+------------------------------------------------------------------------------
| Function    : upm_ll_entity_test
+------------------------------------------------------------------------------
| Description : Returns TRUE if upm_ll_entity_test is set in UPM data struct
|
| Parameters  : None
+------------------------------------------------------------------------------
*/
BOOL upm_ll_entity_test(void)
{
  return upm_data.upm_ll_entity_test;
}

/*
+------------------------------------------------------------------------------
| Function    : upm_activate_ll_entity_test
+------------------------------------------------------------------------------
| Description : Enables lower layer stubs for entity test
|
| Parameters  : None
+------------------------------------------------------------------------------
*/
void upm_activate_ll_entity_test(void)
{
  upm_data.upm_ll_entity_test = TRUE;
}

/*
+------------------------------------------------------------------------------
| Function    : upm_set_sequence_number
+------------------------------------------------------------------------------
| Description : Stores the receive sequence number from MM for later retrieval
|
| Parameters  : ptr_context_data    - Context data
|               seq_no              - Receive sequence number
+------------------------------------------------------------------------------
*/
void upm_set_sequence_number(struct T_CONTEXT_DATA *ptr_context_data, U8 seq_no)
{
  (void)TRACE_FUNCTION("upm_set_sequence_number");

  ptr_context_data->seq_nos_valid = (U8)TRUE;
  ptr_context_data->recv_seq_no   = seq_no;
}

/*
+------------------------------------------------------------------------------
| Function    : upm_get_sequence_number
+------------------------------------------------------------------------------
| Description : Retrieves the receive sequence number previously gotten from MM
|
| Parameters  : ptr_context_data    - Context data
+------------------------------------------------------------------------------
*/
U8 upm_get_sequence_number(struct T_CONTEXT_DATA *ptr_context_data)
{
  (void)TRACE_FUNCTION("upm_get_sequence_number");

  if (ptr_context_data->seq_nos_valid != (U8)0)
  {
    ptr_context_data->seq_nos_valid = (U8)0;
    return ptr_context_data->recv_seq_no;
  } else {
    return (U8)0;
  }
}

/*==== END OF FILE ==========================================================*/