/**
 *  UNPUBLISHED PROPRIETARY SOURCE CODE
 *  Copyright (c) 2016 MXCHIP Inc.
 *
 *  The contents of this file may not be disclosed to third parties, copied or
 *  duplicated in any form, in whole or in part, without the prior written
 *  permission of MXCHIP Corporation.
 *
 */
/** @file
 *
 * Bluetooth Synchronous Connection Oriented Channel Application Programming Interface
 *
 */

#ifdef SCO_ENABLE											//oscar for mindray

 
#pragma once

#include "mico.h"
#include "mico_bt_dev.h"
/******************************************************
 *              Constants
 ******************************************************/

/******************************************************
 *              Type Definitions
 ******************************************************/
/* Subset for the enhanced setup/accept synchronous connection paramters
 * See BT 4.1 or later HCI spec for details */
typedef struct
{
    uint16_t max_latency;                   /**< Maximum latency (0x4-0xFFFE in msecs) */
    uint16_t packet_types;                  /**< Packet Types */
    uint8_t retrans_effort;                 /**< 0x00-0x02, 0xFF don't care */
    mico_bool_t use_wbs;                   /**< True to use wide band, False to use narrow band */

} mico_bt_sco_params_t;

/**
 *  @addtogroup  sco_api_functions       Synchronous Connection Oriented (SCO) Channel
 *  @ingroup     micobt
 *
 *  SCO Functions
 *
 *  @{
 */

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

/**
 * Function         mico_bt_sco_create_as_initiator
 *
 *                  Creates a synchronous connection oriented connection as initiator.
 *
 *  @param[in]  bd_addr                 : Peer bd_addr
 *  @param[in]  p_params                : Pointer to the SCO parameter structure
 *  @param[out] p_sco_index             : SCO index returned
 *
 *  @return     <b> MICO_BT_UNKNOWN_ADDR </b>      : Create connection failed, ACL connection is not up
 *              <b> MICO_BT_BUSY </b>              : Create connection failed, another SCO is being
 *                                                    conncted to the same BD address
 *              <b> MICO_BT_WRONG_MODE </b>        : Create connection failed, wrong mode
 *              <b> MICO_BT_NO_RESOURCES </b>      : Create connection failed, max SCO limit has been
 *                                                    reached
 *              <b> BTM_CMD_STARTED </b>            : Create connection successfully, "p_sco_index" is returned
 */
mico_bt_dev_status_t mico_bt_sco_create_as_initiator (mico_bt_device_address_t bd_addr,
                                                        uint16_t *p_sco_index,
                                                        mico_bt_sco_params_t *p_params);

/**
 * Function         mico_bt_sco_create_as_acceptor
 *
 *                  Creates a synchronous connection oriented connection as acceptor.
 *
 *  @param[out] p_sco_index             : SCO index returned
 *
 *  @return     <b> MICO_BT_UNKNOWN_ADDR </b>      : Create connection failed, ACL connection is not up or
 *                                                    address is invalid
 *              <b> MICO_BT_BUSY </b>              : Create connection failed, a SCO connection is already
 *                                                    conncted to the same BD address
 *              <b> MICO_BT_WRONG_MODE </b>        : Create connection failed, link in park mode or
 *                                                    automatic un-park is not supported
 *              <b> MICO_BT_NO_RESOURCES </b>      : Create connection failed, max SCO limit has been
 *                                                    reached
 *              <b> BTM_CMD_STARTED </b>            : Create connection successfully, "p_sco_index" is returned
 */
mico_bt_dev_status_t mico_bt_sco_create_as_acceptor (uint16_t *p_sco_index);

/**
 * Function         mico_bt_sco_remove
 *
 *                  Removes a specific synchronous connection oriented connection.
 *
 *  @param[in]  sco_index           : SCO index to remove
 *
 *  @return     <b> MICO_BT_UNKNOWN_ADDR </b>      : Remove connection failed, invalid SCO index
 *              <b> MICO_BT_NO_RESOURCES </b>      : Remove connection failed, no resource
 *              <b> MICO_BT_SUCCESS </b>           : Remove connection successfully, device is still
 *                                                    listening for incoming connection
 *              <b> BTM_CMD_STARTED </b>            : Remove connection successfully
 */
mico_bt_dev_status_t mico_bt_sco_remove (uint16_t sco_index);

/**
 * Function         mico_bt_sco_accept_connection
 *
 *                  Called to handle (e)SCO connection request event (mico_bt_sco_connect_request_event).
 *
 *
 *  @param[in]  sco_index           : SCO index to remove
 *
 *  @param[in]  HCI status code     : HCI_SUCCESS 0x00
 *                                    HCI_ERR_HOST_REJECT_RESOURCES 0x0D
 *                                    HCI_ERR_HOST_REJECT_SECURITY  0x0E
 *                                    HCI_ERR_HOST_REJECT_DEVICE    0x0F
 *  @param[in]  p_params            : Pointer to the SCO parameter structure
 *
 */
void mico_bt_sco_accept_connection (uint16_t sco_index, uint8_t hci_status,
                                     mico_bt_sco_params_t *p_params);

#ifdef __cplusplus
}
#endif
/** @} micobt_sco */

#endif