/******************************************************************************
 *
 *  Copyright (c) 2013, The Linux Foundation. All rights reserved.
 *  Not a Contribution.
 *  Copyright (C) 2002-2012 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 HIDD_API_H
#define HIDD_API_H

#include "hiddefs.h"
#include "sdp_api.h"

/*****************************************************************************
**  Type Definitions
*****************************************************************************/

enum {
    HID_CHANNEL_INTR,
    HID_CHANNEL_CTRL
};

/*
    HID_DHOST_EVT_OPEN  - connected to host device (CTRL and INTR), data = n/a
    HID_DHOST_EVT_CLOSE - disconnected from host device, data=reason
    HID_DHOST_EVT_GET_REPORT - got GET_REPORT from host
    HID_DHOST_EVT_SET_REPORT - got SET_REPORT from host
    HID_DHOST_EVT_SET_PROTOCOL - got SET_PROTOCOL from host
*/

enum
{
    HID_DHOST_EVT_OPEN,
    HID_DHOST_EVT_CLOSE,
    HID_DHOST_EVT_GET_REPORT,
    HID_DHOST_EVT_SET_REPORT,
    HID_DHOST_EVT_SET_PROTOCOL,
    HID_DHOST_EVT_INTR_DATA,
    HID_DHOST_EVT_VC_UNPLUG,
    HID_DHOST_EVT_SUSPEND,
    HID_DHOST_EVT_EXIT_SUSPEND,
};
typedef void (tHID_DEV_HOST_CALLBACK) (BD_ADDR bd_addr, UINT8 event, UINT32 data, BT_HDR *p_buf);

/*****************************************************************************
**  External Function Declarations
*****************************************************************************/
#ifdef __cplusplus
extern "C"
{
#endif

/*******************************************************************************
**
** Function         HID_DevInit
**
** Description      Initializes control block
**
** Returns          void
**
*******************************************************************************/
extern void HID_DevInit(void);

/*******************************************************************************
**
** Function         HID_DevRegister
**
** Description      Registers HID device with lower layers
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevRegister(tHID_DEV_HOST_CALLBACK *host_cback);

/*******************************************************************************
**
** Function         HID_DevDeregister
**
** Description      Deregisters HID device with lower layers
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevDeregister(void);

/*******************************************************************************
**
** Function         HID_DevSetSecurityLevel
**
** Description      Sets security level for HID device connections
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevSetSecurityLevel(UINT8 sec_lvl);

/*******************************************************************************
**
** Function         HID_DevAddRecord
**
** Description      Creates SDP record for HID device
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevAddRecord(UINT32 handle, char *p_name, char *p_description,
                                            char *p_provider, UINT16 subclass, UINT16 desc_len,
                                            UINT8 *p_desc_data);

/*******************************************************************************
**
** Function         HID_DevSendReport
**
** Description      Sends report
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevSendReport(UINT8 channel, UINT8 type, UINT8 id, UINT16 len,
                                            UINT8 *p_data);

/*******************************************************************************
**
** Function         HID_DevVirtualCableUnplug
**
** Description      Sends Virtual Cable Unplug
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevVirtualCableUnplug(void);

/*******************************************************************************
**
** Function         HID_DevPlugDevice
**
** Description      Establishes virtual cable to given host
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevPlugDevice(BD_ADDR addr);

/*******************************************************************************
**
** Function         HID_DevUnplugDevice
**
** Description      Unplugs virtual cable from given host
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevUnplugDevice(BD_ADDR addr);

/*******************************************************************************
**
** Function         HID_DevConnect
**
** Description      Connects to device
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevConnect(void);

/*******************************************************************************
**
** Function         HID_DevDisconnect
**
** Description      Disconnects from device
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevDisconnect(void);

/*******************************************************************************
**
** Function         HID_DevSetIncomingPolicy
**
** Description      Sets policy for incoming connections (allowed/disallowed)
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevSetIncomingPolicy(BOOLEAN allow);

/*******************************************************************************
**
** Function         HID_DevReportError
**
** Description      Reports error for Set Report via HANDSHAKE
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevReportError(UINT8 error);

/*******************************************************************************
**
** Function         HID_DevGetDevice
**
** Description      Returns the BD Address of virtually cabled device
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevGetDevice(BD_ADDR *addr);

/*******************************************************************************
**
** Function         HID_DevSetIncomingQos
**
** Description      Sets Incoming QoS values for Interrupt L2CAP Channel
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevSetIncomingQos(UINT8 service_type, UINT32 token_rate,
                                            UINT32 token_bucket_size, UINT32 peak_bandwidth,
                                            UINT32 latency, UINT32 delay_variation);

/*******************************************************************************
**
** Function         HID_DevSetOutgoingQos
**
** Description      Sets Outgoing QoS values for Interrupt L2CAP Channel
**
** Returns          tHID_STATUS
**
*******************************************************************************/
extern tHID_STATUS HID_DevSetOutgoingQos(UINT8 service_type, UINT32 token_rate,
                                            UINT32 token_bucket_size, UINT32 peak_bandwidth,
                                            UINT32 latency, UINT32 delay_variation);

/*******************************************************************************
**
** Function         HID_DevSetTraceLevel
**
** Description      This function sets the trace level for HID Dev. If called with
**                  a value of 0xFF, it simply reads the current trace level.
**
** Returns          the new (current) trace level
**
*******************************************************************************/
extern UINT8 HID_DevSetTraceLevel (UINT8 new_level);


#ifdef __cplusplus
}
#endif

#endif  /* HIDD_API_H */