| /****************************************************************************** |
| * |
| * Copyright (C) 2004-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. |
| * |
| ******************************************************************************/ |
| |
| /****************************************************************************** |
| * |
| * This is the interface file for data gateway call-out functions. |
| * |
| ******************************************************************************/ |
| #ifndef BTA_PAN_CO_H |
| #define BTA_PAN_CO_H |
| |
| #include "bta_pan_api.h" |
| |
| /***************************************************************************** |
| ** Constants |
| *****************************************************************************/ |
| |
| |
| |
| /* BT_HDR buffer offset */ |
| #define BTA_PAN_MIN_OFFSET PAN_MINIMUM_OFFSET |
| |
| |
| /* Data Flow Mask */ |
| #define BTA_PAN_RX_PUSH 0x00 /* RX push. */ |
| #define BTA_PAN_RX_PUSH_BUF 0x01 /* RX push with zero copy. */ |
| #define BTA_PAN_RX_PULL 0x02 /* RX pull. */ |
| #define BTA_PAN_TX_PUSH 0x00 /* TX push. */ |
| #define BTA_PAN_TX_PUSH_BUF 0x10 /* TX push with zero copy. */ |
| #define BTA_PAN_TX_PULL 0x20 /* TX pull. */ |
| |
| |
| |
| /***************************************************************************** |
| ** Function Declarations |
| *****************************************************************************/ |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_init |
| ** |
| ** Description This callout function is executed by PAN when a server is |
| ** started by calling BTA_PanEnable(). This function can be |
| ** used by the phone to initialize data paths or for other |
| ** initialization purposes. The function must return the |
| ** data flow mask as described below. |
| ** |
| ** |
| ** Returns Data flow mask. |
| ** |
| *******************************************************************************/ |
| BTA_API extern UINT8 bta_pan_co_init(UINT8 *q_level); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_open |
| ** |
| ** Description This function is executed by PAN when a connection |
| ** is opened. The phone can use this function to set |
| ** up data paths or perform any required initialization. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_open(UINT16 handle, UINT8 app_id, tBTA_PAN_ROLE local_role, tBTA_PAN_ROLE peer_role, BD_ADDR peer_addr); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_close |
| ** |
| ** Description This function is called by PAN when a connection to a |
| ** server is closed. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_close(UINT16 handle, UINT8 app_id); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_tx_path |
| ** |
| ** Description This function is called by PAN to transfer data on the |
| ** TX path; that is, data being sent from BTA to the phone. |
| ** This function is used when the TX data path is configured |
| ** to use the pull interface. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_tx_path(UINT16 handle, UINT8 app_id); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_rx_path |
| ** |
| ** Description This function is called by PAN to transfer data on the |
| ** RX path; that is, data being sent from the phone to BTA. |
| ** This function is used when the RX data path is configured |
| ** to use the pull interface. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_rx_path(UINT16 handle, UINT8 app_id); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_tx_write |
| ** |
| ** Description This function is called by PAN to send data to the phone |
| ** when the TX path is configured to use a push interface. |
| ** The implementation of this function must copy the data to |
| ** the phone's memory. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_tx_write(UINT16 handle, UINT8 app_id, BD_ADDR src, BD_ADDR dst, UINT16 protocol, UINT8 *p_data, |
| UINT16 len, BOOLEAN ext, BOOLEAN forward); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_tx_writebuf |
| ** |
| ** Description This function is called by PAN to send data to the phone |
| ** when the TX path is configured to use a push interface with |
| ** zero copy. The phone must free the buffer using function |
| ** GKI_freebuf() when it is through processing the buffer. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_tx_writebuf(UINT16 handle, UINT8 app_id, BD_ADDR src, BD_ADDR dst, UINT16 protocol, BT_HDR *p_buf, |
| BOOLEAN ext, BOOLEAN forward); |
| |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_rx_flow |
| ** |
| ** Description This function is called by PAN to enable or disable |
| ** data flow on the RX path when it is configured to use |
| ** a push interface. If data flow is disabled the phone must |
| ** not call bta_pan_ci_rx_write() or bta_pan_ci_rx_writebuf() |
| ** until data flow is enabled again. |
| ** |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_rx_flow(UINT16 handle, UINT8 app_id, BOOLEAN enable); |
| |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_filt_ind |
| ** |
| ** Description protocol filter indication from peer device |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_pfilt_ind(UINT16 handle, BOOLEAN indication, tBTA_PAN_STATUS result, |
| UINT16 len, UINT8 *p_filters); |
| |
| /******************************************************************************* |
| ** |
| ** Function bta_pan_co_mfilt_ind |
| ** |
| ** Description multicast filter indication from peer device |
| ** |
| ** Returns void |
| ** |
| *******************************************************************************/ |
| BTA_API extern void bta_pan_co_mfilt_ind(UINT16 handle, BOOLEAN indication, tBTA_PAN_STATUS result, |
| UINT16 len, UINT8 *p_filters); |
| |
| #endif /* BTA_PAN_CO_H */ |
| |