bt_system.h

/* Copyright Statement:
 *
 * (C) 2005-2016  MediaTek Inc. All rights reserved.
 *
 * This software/firmware and related documentation ("MediaTek Software") are
 * protected under relevant copyright laws. The information contained herein
 * is confidential and proprietary to MediaTek Inc. ("MediaTek") and/or its licensors.
 * Without the prior written permission of MediaTek and/or its licensors,
 * any reproduction, modification, use or disclosure of MediaTek Software,
 * and information contained herein, in whole or in part, shall be strictly prohibited.
 * You may only use, reproduce, modify, or distribute (as applicable) MediaTek Software
 * if you have agreed to and been bound by the applicable license agreement with
 * MediaTek ("License Agreement") and been granted explicit permission to do so within
 * the License Agreement ("Permitted User").  If you are not a Permitted User,
 * please cease any access or use of MediaTek Software immediately.
 * BY OPENING THIS FILE, RECEIVER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
 * THAT MEDIATEK SOFTWARE RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES
 * ARE PROVIDED TO RECEIVER ON AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL
 * WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
 * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
 * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
 * SUPPLIED WITH MEDIATEK SOFTWARE, AND RECEIVER AGREES TO LOOK ONLY TO SUCH
 * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. RECEIVER EXPRESSLY ACKNOWLEDGES
 * THAT IT IS RECEIVER'S SOLE RESPONSIBILITY TO OBTAIN FROM ANY THIRD PARTY ALL PROPER LICENSES
 * CONTAINED IN MEDIATEK SOFTWARE. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE FOR ANY MEDIATEK
 * SOFTWARE RELEASES MADE TO RECEIVER'S SPECIFICATION OR TO CONFORM TO A PARTICULAR
 * STANDARD OR OPEN FORUM. RECEIVER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND
 * CUMULATIVE LIABILITY WITH RESPECT TO MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
 * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE MEDIATEK SOFTWARE AT ISSUE,
 * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY RECEIVER TO
 * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
 */

#ifndef __BT_SYSTEM_H__
#define __BT_SYSTEM_H__

#include "bt_platform.h"
#include "bt_type.h"

BT_EXTERN_C_BEGIN

/* -------------- The buffer size of a single control block. --------------------- */
#define BT_CONTROL_BLOCK_SIZE_OF_TIMER            (20)     
#define BT_CONTROL_BLOCK_SIZE_OF_LE_CONNECTION    (100)    
#define BT_CONTROL_BLOCK_SIZE_OF_EDR_CONNECTION   (56)     
#define BT_CONTROL_BLOCK_SIZE_OF_RFCOMM           (48)     
#define BT_CONTROL_BLOCK_SIZE_OF_HFP              (76)     
#define BT_CONTROL_BLOCK_SIZE_OF_AVRCP            (48)     
#define BT_CONTROL_BLOCK_SIZE_OF_A2DP_SEP         (16)     
#define BT_CONTROL_BLOCK_SIZE_OF_A2DP             (132)    
#define BT_CONTROL_BLOCK_SIZE_OF_PBAPC            (100)    
#define BT_CONTROL_BLOCK_SIZE_OF_SPP              (44)     
#define BT_CONTROL_BLOCK_SIZE_OF_AWS              (100)     
#define BT_CONTROL_BLOCK_SIZE_OF_GATT             (32)     
typedef enum {
    BT_MEMORY_CONTROL_BLOCK_TIMER = 0,          
    BT_MEMORY_CONTROL_BLOCK_LE_CONNECTION,      
    BT_MEMORY_CONTROL_BLOCK_EDR_CONNECTION,     
    BT_MEMORY_CONTROL_BLOCK_RFCOMM,             
    BT_MEMORY_CONTROL_BLOCK_AVRCP,              
    BT_MEMORY_CONTROL_BLOCK_PBAPC,              
    BT_MEMORY_CONTROL_BLOCK_A2DP_SEP,           
    BT_MEMORY_CONTROL_BLOCK_A2DP,               
    BT_MEMORY_CONTROL_BLOCK_HFP,                
    BT_MEMORY_CONTROL_BLOCK_SPP,                
    BT_MEMORY_CONTROL_BLOCK_AWS,                
    BT_MEMORY_CONTROL_BLOCK_GATT,               
    BT_MEMORY_CONTROL_BLOCK_NUM                 
} bt_memory_control_block_t;

typedef enum {
    BT_MEMORY_TX_BUFFER = 0,     
    BT_MEMORY_RX_BUFFER          
} bt_memory_packet_t;

#define BT_MEMORY_TX_BUFFER_AVAILABLE_IND     (BT_MODULE_MM | 0x00010000)     
#define BT_MEMORY_FREE_GARBAGE_IND            (BT_MODULE_MM | 0x00010001)      
typedef struct {
    uint32_t      size; 
} bt_memory_tx_buffer_available_ind_t;

void  bt_memory_init_packet(bt_memory_packet_t type, char *buf, uint32_t size);
void  bt_memory_init_control_block(bt_memory_control_block_t type, char *buf, uint32_t size);

#define BT_PANIC                            (BT_MODULE_SYSTEM | 0x0003)    
#define BT_PANIC_SOURCE_HOST                0                              
#define BT_PANIC_SOURCE_CONTROLLER          1                              
typedef struct {
    uint8_t source; 
} bt_panic_t;

#define BT_POWER_ON_CNF                     (BT_MODULE_SYSTEM | 0x0001)    
#define BT_POWER_OFF_CNF                    (BT_MODULE_SYSTEM | 0x0002)    
typedef struct {
    const bt_bd_addr_t      local_public_addr; 
} bt_power_on_cnf_t;

typedef struct {
    uint8_t    bt_init_tx_power_level; 
    uint8_t    bt_max_tx_power_level;  
    uint8_t    le_init_tx_power_level; 
} bt_config_tx_power_t;

bt_status_t bt_power_on(bt_bd_addr_ptr_t public_addr, bt_bd_addr_ptr_t random_addr);

bt_status_t bt_power_off(void);

bt_status_t bt_config_tx_power_level(const bt_config_tx_power_t *tx_power_info);

bt_status_t bt_app_event_callback(bt_msg_type_t msg, bt_status_t status, void *buf);

void *bt_alloc_rx_buffer_from_external(uint32_t buffer_size);

BT_EXTERN_C_END

#endif