view src/aci2/mfw/mfw_bt_dm.h @ 631:597869e59805

config: introduced new CONFIG_MCSI_MODEM preprocessor symbol All MCSI functionality was previously conditionalized on CONFIG_TARGET_FCMODEM (even earlier it was CONFIG_TARGET_FCDEV3B), but having a dedicated preprocessor symbol for this purpose (defined in targets/*.h as appropriate) makes it much easier to support different modem targets with MCSI enabled.
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 04 Jan 2020 19:07:02 +0000
parents 93999a60b835
children
line wrap: on
line source

/*
+-------------------------------------------------------------------+
| PROJECT: MMI-Framework (8445)         $Workfile:: mfw_bt_dm.h				$|
| $Author:: NDH					     $Revision::  1						$|
| CREATED: 17.04.04				     $Modtime:: 17.04.04 10:48			$|
| STATE  : code														 |
+-------------------------------------------------------------------+


   MODULE  : MFW_BT

   PURPOSE : This module contains the definitions for MFW Bluetooth Device Manager Profile

*/

#ifndef DEF_MFW_BT_DM_HEADER
#define DEF_MFW_BT_DM_HEADER

#include "bta_api.h"
#include "bd.h"
#include "mfw_bte.h"

#define MFW_BT_NAME_LENGTH   34
#define MFW_BT_DEFAULT_INQ_DURATION 4
#define MFW_BT_MAX_PIN_CODE_LEN 16
#define MFW_BT_MAX_CONSEC_CONNECTIONS MAX_L2CAP_LINKS

/* redefine the BD_ADDR type in a "MFW-like" way */
typedef BD_ADDR					T_MFW_BT_DM_DEV_ADDR;
#define MFW_BT_DM_DEV_ADDR_LEN 	BD_ADDR_LEN

/*
** Event Parameter Structure Definitions
*/
typedef tBTA_DM_ENABLE			T_MFW_BT_DM_ENABLE;
typedef 	tBTA_DM_LINK_UP			T_MFW_BT_DM_LINK_UP;
typedef tBTA_DM_LINK_DOWN 		T_MFW_BT_DM_LINK_DOWN;
typedef tBTA_DM_PIN_REQ 		T_MFW_BT_DM_PIN_REQ;

typedef tBTA_DM_AUTHORIZE 		T_MFW_BT_DM_AUTHORIZE_REQ;
typedef tBTA_DM_SIG_STRENGTH 	T_MFW_BT_DM_SIG_STRENGTH_IND;

/* Search structures */
typedef tBTA_DM_INQ_RES 		T_MFW_BT_DM_INQ_RES;
typedef tBTA_DM_INQ_CMPL 		T_MFW_BT_DM_INQ_CMPL;

/* other BT structures*/
typedef tBTA_SERVICE_MASK		T_MFW_BT_SERVICE_MASK;
typedef tBTA_SIG_STRENGTH_MASK	T_MFW_BT_DM_SIG_STRENGTH;

typedef tBTA_DM_DISC 			T_MFW_BT_VIS_MASK;


enum
{
	MFW_BT_AUTH_FAIL = 0,
	MFW_BT_AUTH_ALWAYS,
	MFW_BT_AUTH_ONCE
};

typedef  UINT8 T_MFW_BT_AUTHORIZE;

typedef struct
{
	BD_ADDR				bd_addr;
	UINT8					bd_name[MFW_BT_NAME_LENGTH];
	BOOL					is_success;
}
T_MFW_BT_DM_AUTH_CMPL;

/* remote device */
typedef struct
{
	/* important!The first parameters should be the same as T_MFW_BT_REM_DEVICE_INFO */
	BD_ADDR				bd_addr;
	char      					friendly_name[MFW_BT_NAME_LENGTH];
	DEV_CLASS				dev_class;
	BOOL	   				link_key_present;
	BOOL	   				is_trusted;
	T_MFW_BT_SERVICE_MASK 	trusted_services;	
	T_MFW_BT_SERVICE_MASK	services;
	BOOL					is_new;
	/* then these are "internal" parameters */
	BOOL	   				in_use;
	char      					name[MFW_BT_NAME_LENGTH];
	LINK_KEY  				link_key;
} 
T_MFW_BT_REM_DEVICE;


/* remote device. !!! Please keep this structure synchronized with the 
	previous one: T_MFW_BT_REM_DEVICE !!! */
typedef struct
{
	BD_ADDR				bd_addr;
	char      					name[MFW_BT_NAME_LENGTH];
	DEV_CLASS				dev_class;
	BOOLEAN   				link_key_present;
	BOOLEAN   				is_trusted;
	T_MFW_BT_SERVICE_MASK 	trusted_services;	
	T_MFW_BT_SERVICE_MASK	services;
	BOOL					is_new;	/* specify whether this device is already or not into our device DB */
} 
T_MFW_BT_REM_DEVICE_INFO;

typedef T_MFW_BT_REM_DEVICE_INFO 		T_MFW_BT_DM_DISC_RES;


/* MFW_BT main control block */
typedef struct
{
	T_MFW_BT_SERVICE_MASK 	ui_current_active_connection;  	/* active connection mask */
	T_MFW_BT_REM_DEVICE	*p_selected_rem_device;        	/* pointer to selected device */
	BD_ADDR				peer_bdaddr;                             	/* peer bdaddr stored for pin_reply etc*/
	UINT8    					peer_name[MFW_BT_NAME_LENGTH];        /* bluetooth name of peer device for pin reply etc */
	T_MFW_BT_SERVICE_MASK	peer_service;					/* peer services stored for auth etc*/
	T_MFW_BT_SERVICE_MASK 	search_services;               		/* services to search for */
	BOOL					is_discovery;					/* remember if it's an inquiry or a discovery */
	T_MFW_BT_SERVICE_MASK	established_linked;				/* which services have an established link */
	BOOL					is_name_requested;				/* remember if we asked for the local name */
	BOOL					is_started;						/* if BT is not started, we will not call BTA APIs */
} 
T_MFW_BT_CB;

extern T_MFW_BT_CB 			mfw_bt_cb;



#define MFW_BT_NUM_REM_DEVICE 10

/* Inquiry results database */
typedef struct
{
    T_MFW_BT_REM_DEVICE    	remote_device[MFW_BT_NUM_REM_DEVICE];
    UINT8               				rem_index;
} 
tMFW_BT_INQ_DB;



/*
** The following Macros define the Device Manager Signals (BT -> Mfw)
*/
#define T_MFW_BT_DM_SEC_EVT			tBTA_DM_SEC_EVT
#define T_MFW_BT_DM_SEC_SIG_DATA		tBTA_DM_SEC

#define T_MFW_BT_DM_SRCH_EVT			tBTA_DM_SEARCH_EVT
#define T_MFW_BT_DM_SRCH_SIG_DATA	tBTA_DM_SEARCH

/*
** Event Identifiers (Mfw -> BMI)
*/
#define E_BT_DM_LINK_UP			(T_MFW_EVENT)0x00000010
#define E_BT_DM_LINK_DOWN			(T_MFW_EVENT)0x00000020
#define E_BT_DM_INQ_RES			(T_MFW_EVENT)0x00000030
#define E_BT_DM_INQ_CMPL			(T_MFW_EVENT)0x00000040
#define E_BT_DM_DISC_RES			(T_MFW_EVENT)0x00000050
#define E_BT_DM_DISC_CMPL			(T_MFW_EVENT)0x00000060
#define E_BT_DM_PIN_REQ			(T_MFW_EVENT)0x00000070
#define E_BT_DM_AUTH_CMPL			(T_MFW_EVENT)0x00000080
#define E_BT_DM_AUTHORIZE_REQ		(T_MFW_EVENT)0x00000090
#define E_BT_DM_DEV_NAME_REQ		(T_MFW_EVENT)0x000000A0
#define E_BT_DM_ENABLE				(T_MFW_EVENT)0x00000100


#define E_BT_DM_SIG_STRENGTH_IND	(T_MFW_EVENT)0x000000E0
#define E_BT_ALL_DM_SERVICES		(T_MFW_EVENT)0x000000F0





/*******************************************************************************
 $Function:		mfw_bt_dm_set_visibility
 $Description:		set visibility of local BT device
 $Returns:		T_MFW_BT_STATUS. Success or fail.	
 $Arguments:		is_visible: new visibility setting. is_temp: define whether it is a temporary
				modification ( TRUE ) or a permanent one ( FALSE ).
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_set_visibility( BOOL is_visible, BOOL is_temp);

/*******************************************************************************
 $Function:		mfw_bt_dm_get_visibility
 $Description:		get visibility of local BT device
 $Returns:		TRUE if visible, FALSE if not.
 $Arguments:		none
*******************************************************************************/
BOOL mfw_bt_dm_get_visibility( void );

/*******************************************************************************
 $Function:		mfw_bt_dm_get_local_name
 $Description:		read  local BT device name
 $Returns:		a pointer to a string. NULL if no name available. One should make a copy of
				string if he wants to use it/modify it. 
 $Arguments:		none
*******************************************************************************/
UINT8 * mfw_bt_dm_get_local_name( void );

/*******************************************************************************
 $Function:		mfw_bt_dm_set_local_name
 $Description:		set local BT device name
 $Returns:		T_MFW_BT_STATUS	
 $Arguments:		new name. Pointer to a string. This string is copied locally. Buffer is not freed.
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_set_local_name( INT8 *name );

/*******************************************************************************
 $Function:		mfw_bt_dm_get_bt_status
 $Description:		get the status of the local Bluetooth system. Used at start-up to decide whether
 				or not we want BT to be started by default.
 $Returns:		MFW_BT_SUCCESS is BT is started. 0 if OFF	
 $Arguments:		
*******************************************************************************/
BOOL mfw_bt_dm_get_bt_status( void );

/*******************************************************************************
 $Function:		mfw_bt_dm_pin_code
 $Description:		used by BMI to send back a pin code
 $Returns:		T_MFW_BT_STATUS. 	MFW_BT_NOT_INITIALISED is BT is not started.
 $Arguments:		pin code and pin code length. This data is copied.
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_pin_code(UINT8* pin_code, UINT8 pin_len);

/*******************************************************************************
 $Function:		mfw_bt_dm_bond
 $Description:		used by BMI to send a pin code in order to establish a bonding with a 
 			remote device.
 $Returns:		T_MFW_BT_STATUS. MFW_BT_NOT_INITIALISED is BT is not started.
 			
 $Arguments:		BD_ADDR of the remote device, pin code and pin code length. Data is copied.
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_bond(BD_ADDR bd_addr, UINT8* pin_code, UINT8 pin_len );

/*******************************************************************************
 $Function:		mfw_bt_dm_authorize_resp
 $Description:		used to answer to an authorization request
 $Returns:		T_MFW_BT_STATUS. SUCCESS/FAIL, but also:
				MFW_BT_NOT_INITIALISED is BT is not started. 
				MFW_BT_INVALID_DATA if auth value is not correct.
 				MFW_BT_UNKNOWN_DEVICE if BD_addr is not recognized.
 				MFW_BT_DATA_BASE_FULL if there are already too many devices in the DB.	
 $Arguments:		MFW_BT_AUTH_FAIL to refuse, 
 				MFW_BT_AUTH_ONCE to grant access temporarily,
 				MFW_BT_AUTH_ALWAYS to grant permanent access
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_authorize_resp( T_MFW_BT_AUTHORIZE auth);

/*******************************************************************************
 $Function:		mfw_bt_dm_sig_strength
 $Description:		ask for the link quality
 $Returns:		T_MFW_BT_STATUS. MFW_BT_NOT_INITIALISED if BT is not started.
 $Arguments:		T_MFW_BT_DM_SIG_STRENGTH sig_strength,  UINT16 period, 	BOOLEAN is_on
     			See BTA documentation for more details.
			
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_sig_strength (	T_MFW_BT_DM_SIG_STRENGTH sig_strength,
													UINT16 period,
													BOOLEAN is_on );

/*******************************************************************************
 $Function:		mfw_bt_dm_get_known_devices
 $Description:		used by BMI to get the list of known devices for a specified condition: either a 
				service mask, either a bd address ( union ). 
 				MFW will fill in the variables: pp_device => table of known devices
 				number_of_devices => number of devices.
 				MFW will allocate memory for each device found. It's up to BMI to free it!
 $Returns:		T_MFW_BT_STATUS. 
 				If BD_ADDR is specified, might return MFW_BT_UNKNOWN_DEVICE.
 				 The answers will be returned using BMI signals:
 				- E_BT_DM_INQ_CMPL with the number of devices
 				- E_BT_DM_DISC_RES for each device
 				- then E_BT_DM_DISC_CMPL when it's done.
 $Arguments:		BD_ADDR if looking for a particular device. services if looking for a 
 				category of device. If bd_addr is specified, ignore services. If services set
 				to 0, will return all the known devices.
*******************************************************************************/
void mfw_bt_dm_get_known_devices ( 	BD_ADDR bd_addr,
											T_MFW_BT_SERVICE_MASK services);

/*******************************************************************************
 $Function:		mfw_bt_dm_delete_device
 $Description:		remove a device from the local DB
 $Returns:		T_MFW_BT_STATUS ( MFW_BT_SUCCESS, MFW_BT_FAIL, MFW_BT_UNKNOWN_DEVICE )	
 $Arguments:		BD address
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_delete_device(BD_ADDR bd_addr);

/*******************************************************************************
 $Function:		mfw_bt_dm_add_device
 $Description:		This will store permanently a device in Flash.
 $Returns:		T_MFW_BT_STATUS
				errors: MFW_BT_UNKNOWN_DEVICE, MFW_BT_DATA_BASE_FULL, 				
 $Arguments:		new BD address
*******************************************************************************/
 T_MFW_BT_STATUS mfw_bt_dm_add_device(BD_ADDR bd_addr);

/*******************************************************************************
 $Function:		mfw_bt_dm_rename_device
 $Description:		modify the friendly name of a known ( already stored ) remote device
 $Returns:		T_MFW_BT_STATUS.
				MFW_BT_UNKNOWN_DEVICE, DATA_BASE_FULL, MFW_BT_INVALID_DATA...
 $Arguments:		bd address of the remote device and the new name associated
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_rename_device(BD_ADDR bd_addr, UINT8* new_name);




/*
**  Functions used to interact with the BT "search engine"
*/

/*******************************************************************************
 $Function:		mfw_bt_dm_discover_device
 $Description:		Discovers services on a new device
 $Returns:		T_MFW_BT_STATUS. MFW_BT_NOT_INITIALISED if BT not started.	
 $Arguments:		bd address of the remote device to discover
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_discover_device(BD_ADDR bd_addr);


/*******************************************************************************
 $Function:		mfw_bt_dm_is_discover
 $Description:	Checks if we are in discovering services process
 $Returns:		
 $Arguments:	None
*******************************************************************************/
UINT8 mfw_bt_dm_is_discover(void);

/*******************************************************************************
 $Function:		mfw_bt_dm_cancel_search
 $Description:		cancel an ongoing search
 $Returns:		MFW_BT_NOT_INITIALISED if BT not started.	
 $Arguments:		
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_cancel_search( void );

/*******************************************************************************
 $Function:		mfw_bt_dm_search
 $Description:		Searches for devices supporting the services specified. If services = 0, will 
				return all the found devices regardless of their functionalities.
 $Returns:		MFW_BT_NOT_INITIALISED if BT not started.	
 $Arguments:		services. If
*******************************************************************************/
T_MFW_BT_STATUS mfw_bt_dm_search(T_MFW_BT_SERVICE_MASK services);






/*
** Bluetooth Device Manager Profile Prototypes
*/
void	mfw_bt_dm_security_cb(T_MFW_BT_DM_SEC_EVT event, T_MFW_BT_DM_SEC_SIG_DATA *data);
void	mfw_bt_dm_search_cb(T_MFW_BT_DM_SRCH_EVT event, T_MFW_BT_DM_SRCH_SIG_DATA *data);

T_MFW_BT_STATUS	mfw_bt_dm_security_hndlr (T_MFW_BT_DM_SEC_EVT event, T_MFW_BT_DM_SEC_SIG_DATA *data);
T_MFW_BT_STATUS	mfw_bt_dm_search_hndlr (T_MFW_BT_DM_SRCH_EVT event, T_MFW_BT_DM_SRCH_SIG_DATA *data);








#endif