/******************************************************************************
*
* Copyright (C) 1999-2013 Broadcom Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
******************************************************************************/
#ifndef SRVC_DIS_API_H
#define SRVC_DIS_API_H
#include "bt_target.h"
#include "gatt_api.h"
#include "gattdefs.h"
#define DIS_SUCCESS GATT_SUCCESS
#define DIS_ILLEGAL_PARAM GATT_ILLEGAL_PARAMETER
#define DIS_NO_RESOURCES GATT_NO_RESOURCES
typedef UINT8 tDIS_STATUS;
/*****************************************************************************
** Data structure for DIS
*****************************************************************************/
#define DIS_ATTR_SYS_ID_BIT 0x0001
#define DIS_ATTR_MODEL_NUM_BIT 0x0002
#define DIS_ATTR_SERIAL_NUM_BIT 0x0004
#define DIS_ATTR_FW_NUM_BIT 0x0008
#define DIS_ATTR_HW_NUM_BIT 0x0010
#define DIS_ATTR_SW_NUM_BIT 0x0020
#define DIS_ATTR_MANU_NAME_BIT 0x0040
#define DIS_ATTR_IEEE_DATA_BIT 0x0080
#define DIS_ATTR_PNP_ID_BIT 0x0100
typedef UINT16 tDIS_ATTR_MASK;
#define DIS_ATTR_ALL_MASK 0xffff
typedef tDIS_ATTR_MASK tDIS_ATTR_BIT ;
typedef struct
{
UINT16 len;
UINT8 *p_data;
}tDIS_STRING;
typedef struct
{
UINT16 vendor_id;
UINT16 product_id;
UINT16 product_version;
UINT8 vendor_id_src;
}tDIS_PNP_ID;
typedef union
{
UINT64 system_id;
tDIS_PNP_ID pnp_id;
tDIS_STRING data_str;
}tDIS_ATTR;
#define DIS_MAX_STRING_DATA 7
typedef struct
{
UINT16 attr_mask;
UINT64 system_id;
tDIS_PNP_ID pnp_id;
UINT8 *data_string[DIS_MAX_STRING_DATA];
}tDIS_VALUE;
typedef void (tDIS_READ_CBACK)(BD_ADDR addr, tDIS_VALUE *p_dis_value);
/*****************************************************************************
** Data structure used by Battery Service
*****************************************************************************/
typedef struct
{
BD_ADDR remote_bda;
BOOLEAN need_rsp;
UINT16 clt_cfg;
}tBA_WRITE_DATA;
#define BA_READ_CLT_CFG_REQ 1
#define BA_READ_PRE_FMT_REQ 2
#define BA_READ_RPT_REF_REQ 3
#define BA_READ_LEVEL_REQ 4
#define BA_WRITE_CLT_CFG_REQ 5
typedef void (tBA_CBACK)(UINT8 app_id, UINT8 event, tBA_WRITE_DATA *p_data);
#define BA_LEVEL_NOTIFY 0x01
#define BA_LEVEL_PRE_FMT 0x02
#define BA_LEVEL_RPT_REF 0x04
typedef UINT8 tBA_LEVEL_DESCR;
typedef struct
{
BOOLEAN is_pri;
tBA_LEVEL_DESCR ba_level_descr;
tGATT_TRANSPORT transport;
tBA_CBACK *p_cback;
}tBA_REG_INFO;
typedef union
{
UINT8 ba_level;
UINT16 clt_cfg;
tGATT_CHAR_RPT_REF rpt_ref;
tGATT_CHAR_PRES pres_fmt;
}tBA_RSP_DATA;
/*****************************************************************************
** External Function Declarations
*****************************************************************************/
#ifdef __cplusplus
extern "C"
{
#endif
/*****************************************************************************
** Service Engine API
*****************************************************************************/
/*******************************************************************************
**
** Function srvc_eng_init
**
** Description Initializa the GATT Service engine, register a GATT application
** as for a central service management.
**
*******************************************************************************/
extern tGATT_STATUS srvc_eng_init (void);
/*****************************************************************************
** DIS Server Function
*****************************************************************************/
/*******************************************************************************
**
** Function DIS_SrInit
**
** Description Initializa the Device Information Service Server.
**
*******************************************************************************/
extern tDIS_STATUS DIS_SrInit (tDIS_ATTR_MASK dis_attr_mask);
/*******************************************************************************
**
** Function DIS_SrUpdate
**
** Description Update the DIS server attribute values
**
*******************************************************************************/
extern tDIS_STATUS DIS_SrUpdate(tDIS_ATTR_BIT dis_attr_bit, tDIS_ATTR *p_info);
/*****************************************************************************
** DIS Client Function
*****************************************************************************/
/*******************************************************************************
**
** Function DIS_ReadDISInfo
**
** Description Read remote device DIS information.
**
** Returns void
**
*******************************************************************************/
extern BOOLEAN DIS_ReadDISInfo(BD_ADDR peer_bda, tDIS_READ_CBACK *p_cback,
tDIS_ATTR_MASK mask);
/*******************************************************************************
** BATTERY SERVICE API
*******************************************************************************/
/*******************************************************************************
**
** Function Battery_Instantiate
**
** Description Instantiate a Battery service
**
*******************************************************************************/
extern UINT16 Battery_Instantiate (UINT8 app_id, tBA_REG_INFO *p_reg_info);
/*******************************************************************************
**
** Function Battery_Rsp
**
** Description Respond to a battery service request
**
*******************************************************************************/
extern void Battery_Rsp (UINT8 app_id, tGATT_STATUS st, UINT8 event, tBA_RSP_DATA *p_rsp);
/*******************************************************************************
**
** Function Battery_Notify
**
** Description Send battery level notification
**
*******************************************************************************/
extern void Battery_Notify (UINT8 app_id, BD_ADDR remote_bda, UINT8 battery_level);
#ifdef __cplusplus
}
#endif
#endif