view src/ui3/mfw/mfw_em.h @ 600:8f50b202e81f

board preprocessor conditionals: prep for more FC hw in the future This change eliminates the CONFIG_TARGET_FCDEV3B preprocessor symbol and all preprocessor conditionals throughout the code base that tested for it, replacing them with CONFIG_TARGET_FCFAM or CONFIG_TARGET_FCMODEM. These new symbols are specified as follows: CONFIG_TARGET_FCFAM is intended to cover all hardware designs created by Mother Mychaela under the FreeCalypso trademark. This family will include modem products (repackagings of the FCDEV3B, possibly with RFFE or even RF transceiver changes), and also my desired FreeCalypso handset product. CONFIG_TARGET_FCMODEM is intended to cover all FreeCalypso modem products (which will be firmware-compatible with the FCDEV3B if they use TI Rita transceiver, or will require a different fw build if we switch to one of Silabs Aero transceivers), but not the handset product. Right now this CONFIG_TARGET_FCMODEM preprocessor symbol is used to conditionalize everything dealing with MCSI. At the present moment the future of FC hardware evolution is still unknown: it is not known whether we will ever have any beyond-FCDEV3B hardware at all (contingent on uncertain funding), and if we do produce further FC hardware designs, it is not known whether they will retain the same FIC modem core (triband), if we are going to have a quadband design that still retains the classic Rita transceiver, or if we are going to switch to Silabs Aero II or some other transceiver. If we produce a quadband modem that still uses Rita, it will run exactly the same fw as the FCDEV3B thanks to the way we define TSPACT signals for the RF_FAM=12 && CONFIG_TARGET_FCFAM combination, and the current fcdev3b build target will be renamed to fcmodem. OTOH, if that putative quadband modem will be Aero-based, then it will require a different fw build target, the fcdev3b target will stay as it is, and the two targets will both define CONFIG_TARGET_FCFAM and CONFIG_TARGET_FCMODEM, but will have different RF_FAM numbers. But no matter which way we are going to evolve, it is not right to have conditionals on CONFIG_TARGET_FCDEV3B in places like ACI, and the present change clears the way for future evolution.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 01 Apr 2019 01:05:24 +0000
parents f914fb46e1a5
children
line wrap: on
line source

#ifndef _MFW_EM_H_
#define MFW_EM_H_

/*
+--------------------------------------------------------------------+
| PROJECT: MMI-Framework (8417)         $Workfile:: mfw_em.h      $|
| $Author: KGT                          $Revision:: 1               $|
| CREATED: 13.02.2001                   $Modtime::  13.02.2001      $|
| STATE  : code                                                      |
+--------------------------------------------------------------------+

   MODULE  : MFW_EM

   PURPOSE : Interfaces between ACI EM Driver and MMI.

   ********************************************************************************
 $History: Mfw_em.h

    Apr 24, 2006    ERT: OMAPS00067603 x0043642
    Description: Engineering mode
    Solution:  Added Enums to handle different em categories.
 $End



*************************************Includes*************************************
*/

#include "mfw_mfw.h"
#include "mfw_sys.h"

/*
*************************************Datatypes*************************************
*/

typedef enum MFW_EM_DataType
{
#ifndef NEPTUNE_BOARD
	EM_MOBILE_INFO = 0x01,
	EM_SERVING_CELL_PARAMS = 0x02,
	EM_NEIGHBOURING_CELL_PARAMS = 0x04,
	EM_LOCATION_PARAMS = 0x08, 
	EM_CIPH_HOP_DTX_PARAMS = 0x10,
	EM_GPRS_PARAMS = 0x20
#else /*  NEPTUNE BOARD */ /*EngMode */
    EM_SERVING_CELL_PARAMS,
    EM_SERVING_CELL_RF_PARAMS,
    EM_SERVING_CHANNEL_PARAMS,
    EM_AMR_PARAMS,
    EM_SNDCP_PARAMS,
    EM_USERLEVEL_PARAMS,
    EM_LLCTRACING_PARAMS,
    EM_RLC_MAC_PARAMS,
    EM_GMM_INFO_PARAMS,
    EM_CALL_STATUS_PARAMS,
    EM_LAYER_MESSAGE_PARAMS,
    EM_NEIGHBOURING_CELL_PARAMS,
    EM_WCDMA_LAYER_MESSAGE_PARAMS,
    EM_3G_INFO_PARAMS,
    EM_PACKET_DATA_PARAMS
#endif
}	MfwEmDataType;

#ifndef NEPTUNE_BOARD /*EngMode */
typedef struct 
{
	/*software_versions*/
	char		SIM_version[MAX_VER];
	char		CC_version[MAX_VER];
	char		SS_version[MAX_VER];
	char		SMS_version[MAX_VER];
	char		MM_version[MAX_VER];
	char		RR_version[MAX_VER];
	char		DL_version[MAX_VER];
	char		ALR_version[MAX_VER];
	
	char		IMEI[16];
	char 		IMSI[16];
	ULONG 	TMSI; /*SPR 1554, changed from LONG to ULONG*/
}MFW_EM_Mobile_Info;

typedef struct
{
	USHORT		arfcn;
	UBYTE		RSSI; //Received field strength
	UBYTE		RXQ; //received quality
	UBYTE		RLT; //radio link timeout counter
  SHORT   C1; //C1 Path lost criterion
  SHORT   C2; //C2 Parameter - often the same as RSSI for SC
  UBYTE   BSIC; //Base Station ID Code
  UBYTE   TAV;    //Timing Advanced
  USHORT  LAC;  //Location Area Code
}MFW_EM_Serving_Cell_Parameters;

typedef struct
{
	UBYTE   NUM; //number of neighbouring cells
	USHORT  arfcn[7];//channel numbers
	UBYTE   RSSI[7];//received signal strength
  SHORT   C2[7];//received C2 Parameter
  USHORT  LAC_NC[7]; //Location Area Code
  UBYTE   BSIC_NC[7];  //Base Station ID Code  
}	MFW_EM_Neighbour_Cell_Parameters;

typedef struct
{
	UBYTE LUP;//Location update period
	UBYTE MCC[4];//mobile country code
	UBYTE MNC[4];//mobile network code
	USHORT LAC; //location area code
	/*SPR 1554, removed cell id */
}MFW_EM_Location_Parameters;

typedef struct
{
	UBYTE ciph_status; //ciphering status
	/*USHORT ma[65]; //MA list after time
  USHORT ma2[65];//MA list before  time*/
	USHORT HSN; //hopping sequence number
 	UBYTE DTX_status;
}MFW_EM_Ciph_hop_DTX_Parameters;

typedef struct
{	/*SPR 1554, changed the data structure to only include the NMO*/
	UBYTE NMO; //network mode of operation
  UBYTE NDTS; //number of Downlink Timeslots
  UBYTE RAC;  //Routing Area Color
  SHORT C31; //C31 Criterion
  SHORT C32; //C32 Criterion
}
MFW_EM_GPRS_Parameter;

typedef struct
{
	MFW_EM_Mobile_Info MobileInfo;
	MFW_EM_Serving_Cell_Parameters SCInfo;
	MFW_EM_Neighbour_Cell_Parameters NCInfo;
	MFW_EM_Location_Parameters	LocInfo;
	MFW_EM_Ciph_hop_DTX_Parameters CHDTXInfo;
	MFW_EM_GPRS_Parameter GPRSInfo;
}
	MFW_EM_Data;

#endif


/*
*************************************Prototypes*************************************
*/

/* Initialise mfw_em module(which initialises EM driver);*/
int Mfw_em_init(void);

/* Bind events specified by mask to an MMI call-back function.*/
MfwHnd Mfw_em_create(MfwHnd hWin, MfwEvt event,  MfwCb cb_func);

/*Deallocate any memory for the module.*/
void Mfw_em_exit(void);

/* Request specified data from EM Driver.*/
int Mfw_em_get_data(MfwEmDataType type);

/* Added to remove warning Aug - 11 */
MfwRes em_delete (MfwHnd h);
EXTERN UBYTE dspl_Enable (UBYTE   in_Enable);
/* End - remove warning */

#endif