view src/aci2/bmi/mmiHomezone.h @ 640:16eb1b9640dc

target gtm900 renamed to gtm900mgc2 This change reflects the fact that the build target in question supports MGC2GSMT hardware only, and will NOT work on other hw that confusing bears the same end user name of GTM900, neither the LoCosto-based GTM900-C nor the Calypso-based MG01GSMT that has a different and incompatible RFFE. If we ever get our hands on a piece of MG01GSMT hw and add support for it, that other target will be named gtm900mg01.
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 31 Jan 2020 00:46:07 +0000
parents 3c2acfa1a72f
children
line wrap: on
line source

#ifndef _DEF_MMI_HOMEZONE_H_
#define _DEF_MMI_HOMEZONE_H_

/*******************************************************************************

					CONDAT (UK)

********************************************************************************                                                                              

 This software product is the property of Condat (UK) Ltd and may not be
 disclosed to any third party without the express permission of the owner.                                 
                                                                              
********************************************************************************

 $Project name:	Basic MMI                                                      
 $Project code:	BMI                                                            
 $Module:		SMS
 $File:		    MmiHomezone.h
 $Revision:		1.0                                                       
                                                                              
 $Author:		Condat(UK)                                                         
 $Date:		    25/10/00                                                      
                                                                               
********************************************************************************
                                                                              
 Description: Homezone functionality in MMI
 
   
                        
********************************************************************************

 $History: MmiHomezone.h

	15/02/02			Original Condat(UK) BMI version.	

	Jun 14, 2005 REF: MMI-FIX-30439 x0018858
   	Description: The homezone/cityzone tags were not being displayed properly.
   	Solution: Modified to save the tags properly in caches and also made the 
	appropriate modifications to update the same properly during mobility.
	   
 $End

*******************************************************************************/

/****************************************************************************
 *																			*
 *   CONSTANTS 																*
 *																			*
 ****************************************************************************/

#define	HZ_ZONES_MAX					4				// Max number of homezones the user can have
#define	HZ_RECENT_MAX	 				5				// Number of recent cells to be stored
#define	HZ_CACHE_MAX					21				// Size of cache for each homezone
#define	HZ_DISTANCE_MAX					100000			// Maximum distance in metres that user can be from centre of homezone

#define	HZ_IDENTIFIER					221				// Message ID that identifies a homezone CB
#define	HZ_COORD_DIGITS					6				// Number of digits in coordinates received in CB message
#define	HZ_ACTIVE_FLAG					0x01			// If homezone is active, first bit in byte is set
#define	HZ_CITYZONE_FLAG				0x02			// If homezone is a cityzone, second bit in byte is set

#define	HZ_SIM_PARAMETERS				0x6F60			// Field in SIM storing homezone parameters
#define	HZ_SIM_PARAMETERS_SIZE			123				// Size of this field in bytes
#define	HZ_SIM_FIRST_ZONE				17				// Offset from start of parameters file that first zone is found
#define	HZ_SIM_ZONE_SIZE				27				// Size of each zone in bytes
#define	HZ_SIM_CELL_CACHE				0x6F61			// First of series of caches storing homezone cells
#define	HZ_SIM_CELL_CACHE_SIZE			4				// Size of each cache entry (there will be HZ_CACHE_MAX of these per zone)
#define	HZ_NAME_LENGTH					12				// Length of homezone name tag

#define	HZ_NOT_IN_ZONE					0xFF			// Value for current_zone when we aren't in a homezone

#define	HZ_CB_NAME						"Homezone"		// Homezone cell broadcast channel name

/****************************************************************************
 *																			*
 *   Permitted Network Names												*
 *																			*
 ****************************************************************************/

#define HZ_PERMITTED_NETWORKS			1

static char *homezoneMNC_MCC[HZ_PERMITTED_NETWORKS] =
{
	"26207", /* VIAG Interkom */
};

/****************************************************************************
 *																			*
 *   Information storage for individual homezone							*
 *   T_homezone																*
 *																			*
 ****************************************************************************/

typedef struct
{
	UBYTE	zoneID;			// The ID of the homezone
 	BOOL	active;			// Whether the homezone is activated at the moment
 	BOOL	cityzone;		// TRUE if the zone is a cityzone
	U32		X;				// The X position of its centre
	U32		Y;				// The Y position of its centre
	U32		Rsquared;		// The radius of the homezone, squared
	char 	Tag[13];		// The text tag to be displayed when in the homezone
	USHORT	lac[HZ_CACHE_MAX];  // The cache of location area codes of cells known to be in this homezone
	USHORT	cid[HZ_CACHE_MAX];  // The cache of cell IDs known to be in this homezone
} T_homezone;


/****************************************************************************
 *																			*
 *   General homezone information storage 									*
 *   T_homezone_data														*
 *																			*
 ****************************************************************************/

typedef struct
{	
	UBYTE			current_zone;							// Current zone number (1 to HZ_ZONES_MAX). 0 if none.
	
	U32				current_X;								// Coordinates (received from CB) of centre of current cell
	U32				current_Y;

	UBYTE			received;								// Makes sure we have received all necessary data
	UBYTE			new_cell_res;							// TRUE if a new cell reselection has just occurred
	USHORT			lac;
	USHORT			cid;

	UBYTE			recent_cell_index;						// Location of recent cells that are within one of the user's homezones.
	USHORT 			recent_cell[HZ_RECENT_MAX];				// These are used for quick lookup
	UBYTE			recent_cell_zone[HZ_RECENT_MAX];		// The homezone/cityzone of the recent cell

	T_homezone		homezone[HZ_ZONES_MAX];					// The user's homezones, up to HZ_ZONES_MAX

	UBYTE 			buffer[HZ_SIM_PARAMETERS_SIZE];			// Buffers for reading from or writing to the SIM
	UBYTE			buffer2[HZ_SIM_CELL_CACHE_SIZE];
} T_homezone_data;

typedef enum
{
	HZ_RECEIVED_CB = 1,
	HZ_RECEIVED_CELLRES = 2,
	HZ_RECEIVED_SIMDATA = 4,
	HZ_RECEIVED_ALL = 7,
	HZ_RECEIVED_HZ_OFF = 128				/* Homezone is switched off */
};

typedef enum
{
	HZ_READ_ONCE_ONLY = 0,					/* Only read SIM first time this function is called */
	HZ_READ_SIM_AGAIN = 1					/* Read SIM any number of times */
};

/****************************************************************************
 *																			*
 *   FUNCTION PROTOTYPES													*
 *																			*
 ****************************************************************************/

void homezoneInit();

void homezoneCBData(char *message);

void homezoneReadSim(UBYTE read_again);

void homezoneReadSimCb(USHORT field, USHORT record, USHORT result);

void homezoneWriteSim(USHORT field, USHORT record);

void homezoneWriteSimCb(USHORT field, USHORT record, USHORT result);

//Jun 14, 2005 REF: MMI-FIX-30439 x0018858
// Added third argument to the function
//begin 30439
void homezoneUpdate(USHORT lac, USHORT cid, UBYTE keep);
//end 30439

void homezoneUpdateDisplay(void);

void homezoneActivateCB(void);
#endif