235 lines
7.0 KiB
C
235 lines
7.0 KiB
C
/** @file
|
|
* @brief Bluetooth L2CAP handling
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2015 Intel Corporation
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1) Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2) Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3) Neither the name of Intel Corporation nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
#ifndef __BT_L2CAP_H
|
|
#define __BT_L2CAP_H
|
|
|
|
/**
|
|
* @brief L2CAP
|
|
* @defgroup bt_l2cap L2CAP
|
|
* @ingroup bluetooth
|
|
* @{
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if defined(CONFIG_BLUETOOTH_CENTRAL) || defined(CONFIG_BLUETOOTH_PERIPHERAL)
|
|
#include <net/buf.h>
|
|
#include <bluetooth/conn.h>
|
|
|
|
/** @brief L2CAP Endpoint structure. */
|
|
struct bt_l2cap_endpoint {
|
|
/** Endpoint CID */
|
|
uint16_t cid;
|
|
/** Endpoint Maximum PDU payload Size */
|
|
uint16_t mps;
|
|
/** Endpoint Maximum Transmission Unit */
|
|
uint16_t mtu;
|
|
/** Endpoint credits */
|
|
struct nano_sem credits;
|
|
};
|
|
|
|
/** @brief L2CAP Channel structure. */
|
|
struct bt_l2cap_chan {
|
|
/** Channel connection reference */
|
|
struct bt_conn *conn;
|
|
|
|
/** Channel operations reference */
|
|
struct bt_l2cap_chan_ops *ops;
|
|
|
|
/** Channel Transmission Endpoint */
|
|
struct bt_l2cap_endpoint tx;
|
|
/** Channel Receiving Endpoint */
|
|
struct bt_l2cap_endpoint rx;
|
|
|
|
struct net_buf *_sdu;
|
|
uint16_t _sdu_len;
|
|
|
|
uint8_t _ident;
|
|
|
|
struct bt_l2cap_chan *_next;
|
|
};
|
|
|
|
/** @brief L2CAP Channel operations structure. */
|
|
struct bt_l2cap_chan_ops {
|
|
/** Channel connected callback
|
|
*
|
|
* If this callback is provided it will be called whenever the
|
|
* connection completes.
|
|
*
|
|
* @param chan The channel that has been connected
|
|
*/
|
|
void (*connected)(struct bt_l2cap_chan *chan);
|
|
|
|
/** Channel disconnected callback
|
|
*
|
|
* If this callback is provided it will be called whenever the
|
|
* channel is disconnected, including when a connection gets
|
|
* rejected.
|
|
*
|
|
* @param chan The channel that has been Disconnected
|
|
*/
|
|
void (*disconnected)(struct bt_l2cap_chan *chan);
|
|
|
|
/** Channel encrypt_change callback
|
|
*
|
|
* If this callback is provided it will be called whenever the
|
|
* security level changed.
|
|
*
|
|
* @param chan The channel which has encryption status changed.
|
|
*/
|
|
void (*encrypt_change)(struct bt_l2cap_chan *chan);
|
|
|
|
/** Channel alloc_buf callback
|
|
*
|
|
* If this callback is provided the channel will use it to allocate
|
|
* buffers to store incoming data.
|
|
*
|
|
* @param chan The channel requesting a buffer.
|
|
*
|
|
* @return Allocated buffer.
|
|
*/
|
|
struct net_buf *(*alloc_buf)(struct bt_l2cap_chan *chan);
|
|
|
|
/** Channel recv callback
|
|
*
|
|
* @param chan The channel receiving data.
|
|
* @param buf Buffer containing incoming data.
|
|
*/
|
|
void (*recv)(struct bt_l2cap_chan *chan, struct net_buf *buf);
|
|
};
|
|
|
|
#if defined(CONFIG_BLUETOOTH_L2CAP_DYNAMIC_CHANNEL)
|
|
/** @def BT_L2CAP_CHAN_SEND_RESERVE
|
|
* @brief Headroom needed for outgoing buffers
|
|
*/
|
|
#define BT_L2CAP_CHAN_SEND_RESERVE (CONFIG_BLUETOOTH_HCI_SEND_RESERVE + 4 + 4 \
|
|
+ 2)
|
|
|
|
/** @brief L2CAP Server structure. */
|
|
struct bt_l2cap_server {
|
|
/** Server PSM */
|
|
uint16_t psm;
|
|
|
|
/** Server accept callback
|
|
*
|
|
* This callback is called whenever a new incoming connection requires
|
|
* authorization.
|
|
*
|
|
* @param conn The connection that is requesting authorization
|
|
* @param chan Pointer to received the allocated channel
|
|
*
|
|
* @return 0 in case of success or negative value in case of error.
|
|
*/
|
|
int (*accept)(struct bt_conn *conn, struct bt_l2cap_chan **chan);
|
|
|
|
struct bt_l2cap_server *_next;
|
|
};
|
|
|
|
/** @brief Register L2CAP server.
|
|
*
|
|
* Register L2CAP server for a PSM, each new connection is authorized using
|
|
* the accept() callback which in case of success shall allocate the channel
|
|
* structure to be used by the new connection.
|
|
*
|
|
* @param server Server structure.
|
|
*
|
|
* @return 0 in case of success or negative value in case of error.
|
|
*/
|
|
int bt_l2cap_server_register(struct bt_l2cap_server *server);
|
|
|
|
#if defined(CONFIG_BLUETOOTH_BREDR)
|
|
/** @brief Register L2CAP server on BR/EDR oriented connection.
|
|
*
|
|
* Register L2CAP server for a PSM, each new connection is authorized using
|
|
* the accept() callback which in case of success shall allocate the channel
|
|
* structure to be used by the new connection.
|
|
*
|
|
* @param server Server structure.
|
|
*
|
|
* @return 0 in case of success or negative value in case of error.
|
|
*/
|
|
int bt_l2cap_br_server_register(struct bt_l2cap_server *server);
|
|
#endif /* CONFIG_BLUETOOTH_BREDR */
|
|
|
|
/** @brief Connect L2CAP channel
|
|
*
|
|
* Connect L2CAP channel by PSM, once the connection is completed channel
|
|
* connected() callback will be called. If the connection is rejected
|
|
* disconnected() callback is called instead.
|
|
*
|
|
* @param conn Connection object.
|
|
* @param chan Channel object.
|
|
* @param psm Channel PSM to connect to.
|
|
*
|
|
* @return 0 in case of success or negative value in case of error.
|
|
*/
|
|
int bt_l2cap_chan_connect(struct bt_conn *conn, struct bt_l2cap_chan *chan,
|
|
uint16_t psm);
|
|
|
|
/** @brief Disconnect L2CAP channel
|
|
*
|
|
* Disconnect L2CAP channel, if the connection is pending it will be
|
|
* canceled and as a result the channel disconnected() callback is called.
|
|
*
|
|
* @param chan Channel object.
|
|
*
|
|
* @return 0 in case of success or negative value in case of error.
|
|
*/
|
|
int bt_l2cap_chan_disconnect(struct bt_l2cap_chan *chan);
|
|
|
|
/** @brief Send data to L2CAP channel
|
|
*
|
|
* Send data from buffer to the channel. This procedure may block waiting for
|
|
* credits to send data therefore it shall be used from a fiber to be able to
|
|
* receive credits when necessary.
|
|
*
|
|
* @return Bytes sent in case of success or negative value in case of error.
|
|
*/
|
|
int bt_l2cap_chan_send(struct bt_l2cap_chan *chan, struct net_buf *buf);
|
|
|
|
#endif /* CONFIG_BLUETOOTH_L2CAP_DYNAMIC_CHANNEL */
|
|
#endif /* CONFIG_BLUETOOTH_CENTRAL || CONFIG_BLUETOOTH_PERIPHERAL */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* __BT_L2CAP_H */
|