view src/gpf3/frame/cust_os/cust_os.h @ 662:8cd8fd15a095

SIM speed enhancement re-enabled and made configurable TI's original code supported SIM speed enhancement, but Openmoko had it disabled, and OM's disabling of speed enhancement somehow caused certain SIM cards to start working which didn't work before (OM's bug #666). Because our FC community is much smaller in year 2020 than OM's community was in their day, we are not able to find one of those #666-affected SIMs, thus the real issue they had encountered remains elusive. Thus our solution is to re-enable SIM speed enhancement and simply wait for if and when someone runs into a #666-affected SIM once again. We provide a SIM_allow_speed_enhancement global variable that allows SIM speed enhancement to be enabled or disabled per session, and an /etc/SIM_spenh file in FFS that allows it to enabled or disabled on a non-volatile basis. SIM speed enhancement is now enabled by default.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 24 May 2020 05:02:28 +0000
parents c41a534f33c6
children
line wrap: on
line source

/* 
+------------------------------------------------------------------------------
|  File:       cust_os.h
+------------------------------------------------------------------------------
|  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 communication between L1 and L23 entities. 
|             This interface file provides an abstraction of the VSI 
|             interface, e.g. to avoid that macros like PALLOC need to be used
|             by the customer.
+----------------------------------------------------------------------------- 
*/ 
#ifndef CUST_OS_H
#define CUST_OS_H

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

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

#define OSX_OK     0
#define OSX_ERROR -1

#define L1S_TRACE_DISABLE           "L1S_TRACE_DISABLE"
#define L1S_TRACE_ENABLE            "L1S_TRACE_ENABLE"
#define NO_SPECIAL_MPHC_RXLEV_REQ   "NO_SPEC_MPHC_RXLEV_REQ"

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

/* Necessary defintions*/
typedef enum
{
  L1_QUEUE,    /* internal L1 communication          */
  DL_QUEUE,    /* L1->DL                             */
  RR_QUEUE,    /* L1->RR                             */
  GRR_QUEUE,   /* L1->GRR                            */
  LLC_QUEUE,   /* L1->LLC e.g. ciphering via CCI     */
  SNDCP_QUEUE, /* L1->SNDCP e.g. compression via CCI */
  GPF_ACI_QUEUE,   /* L1->ACI                        */
  MAX_OSX_QUEUE
} T_ENUM_OS_QUEUE;

typedef T_ENUM_OS_QUEUE ENUM_OS_QUEUE;

typedef struct {
       char dummychar;
} DummyStruct;

typedef struct xSignalHeaderStruct
{
  int           SignalCode;
  int           _dummy1;
  int           _dummy2;
  int           _dummy3;
  DummyStruct   *SigP;
  int           _dummy4;
} xSignalHeaderRec;

typedef struct
{
  int caller;
  int queue_handle;
  unsigned short queue_type;
} T_OSX_REGISTER;


/*==== EXPORTS ==============================================================*/

/*
 * =================================================
 * functional interface to the GPF frame environment
 * =================================================
 */

/*
 * initialize queue_type to queue_handle conversion table
 */
void _osx_init ( void );

/*
 * dynamic osx configuration
 */
int _osx_config ( const char *config );

/*
 * open an cust_os communication channel
 */
#ifdef _OSX_ON_OS_
int               _osx_open       (int,unsigned short,int,int);
#else
int               _osx_open       (int,unsigned short,int);
#endif

/*
 * allocation of a primitive container with a specific size e.g. sizeof (T_XXX_REQ)
 */
xSignalHeaderRec* osx_alloc_prim   (unsigned long);

xSignalHeaderRec* int_osx_alloc_prim    (int,unsigned long, int);

/*
 * allocation of a memory section with a specific size
 */
void*             osx_alloc_mem    (unsigned long);

void*             int_osx_alloc_mem     (int,unsigned long);

/*
 * deallocation of one primitive container
 */
void              osx_free_prim    (xSignalHeaderRec*);

void              int_osx_free_prim     (int,xSignalHeaderRec*);

/*
 * deallocation of one memory section
 */
void              osx_free_mem     (void*);

void              int_osx_free_mem      (int,void*);

/*
 * reception of a primitive. This function should be called from a thread. It suspends
 * the thread on an empty queue. Queue is specified by an idetifier, 
 */
xSignalHeaderRec* osx_receive_prim (T_ENUM_OS_QUEUE);

/*
 * reception of a primitive. This function should be called from a thread. It suspends
 * the thread on an empty queue. Queue is specified by its handle
 */
xSignalHeaderRec *int_osx_receive_prim  (int,int);

/*
 * send a primtive to a queue specified by an identifier (no frame handle!)
 */
void              osx_send_prim   (xSignalHeaderRec*, T_ENUM_OS_QUEUE);

/*
 * send a primtive to a queue specified by a handle
 */
void              int_osx_send_prim  (int,xSignalHeaderRec*, int);

/*
 * send a signal with a special signal code (ULONG) and a pointer to a specific memory
 * area to a queue specified by an identifier
 */
void              osx_send_sig  (unsigned long, void *, T_ENUM_OS_QUEUE);

/*
 * send a signal with a special signal code (ULONG) and a pointer to a specific memory
 * area to a queue specified by its handle
 */
void               int_osx_send_sig  (int,unsigned long,void*,int);

/*
 * ================================================
 * customizations for the L1 from Texas Instruments
 * ================================================
 */
#define L1C1_QUEUE  L1_QUEUE
#define DLL1_QUEUE  DL_QUEUE
#define RRM1_QUEUE  RR_QUEUE
#define GRRM1_QUEUE GRR_QUEUE
#define BACK_QUEUE  L1_QUEUE
#define ACI_QUEUE   GPF_ACI_QUEUE

#define os_alloc_sig   osx_alloc_prim
#define os_free_sig    osx_free_prim
#define os_send_sig    osx_send_prim
#define os_receive_sig osx_receive_prim

#define MEM_BUF_SIZE(SIG_PAR_SIZE) (SIG_PAR_SIZE + sizeof (xSignalHeaderRec))

#endif /* CUST_OS_H */