incubator-nuttx/wireless/bluetooth/bt_l2cap.h

/****************************************************************************
 * wireless/bluetooth/bt_l2cap.h
 * L2CAP handling
 *
 *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
 *   Author: Gregory Nutt <gnutt@nuttx.org>
 *
 * Ported from the Intel/Zephyr arduino101_firmware_source-v1.tar package
 * where the code was released with a compatible 3-clause BSD license:
 *
 *   Copyright (c) 2016, Intel Corporation
 *   All rights reserved.
 *
 * 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 the copyright holder 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 __WIRELESS_BLUETOOTH_BT_L2CAP_H
#define __WIRELESS_BLUETOOTH_BT_L2CAP_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

/****************************************************************************
 * Pre-processor Definitions
 ****************************************************************************/

#define BT_L2CAP_CID_ATT             0x0004
#define BT_L2CAP_CID_LE_SIG          0x0005
#define BT_L2CAP_CID_SMP             0x0006

#define BT_L2CAP_REJ_NOT_UNDERSTOOD  0x0000
#define BT_L2CAP_REJ_MTU_EXCEEDED    0x0001
#define BT_L2CAP_REJ_INVALID_CID     0x0002

#define BT_L2CAP_CMD_REJECT          0x01
#define BT_L2CAP_CONN_PARAM_REQ      0x12
#define BT_L2CAP_CONN_PARAM_RSP      0x13

/****************************************************************************
 * Public Types
 ****************************************************************************/

begin_packed_struct struct bt_l2cap_hdr_s
{
  uint16_t len;
  uint16_t cid;
} end_packed_struct;

begin_packed_struct struct bt_l2cap_sig_hdr_s
{
  uint8_t code;
  uint8_t ident;
  uint16_t len;
} end_packed_struct;

begin_packed_struct struct bt_l2cap_cmd_reject_s
{
  uint16_t reason;
  uint8_t data[0];
} end_packed_struct;

begin_packed_struct struct bt_l2cap_conn_param_req_s
{
  uint16_t min_interval;
  uint16_t max_interval;
  uint16_t latency;
  uint16_t timeout;
} end_packed_struct;

begin_packed_struct struct bt_l2cap_conn_param_rsp_s
{
  uint16_t result;
} end_packed_struct;

struct bt_l2cap_chan_s
{
  FAR struct bt_l2cap_chan_s *flink;
  FAR void *context;
  uint16_t cid;

  CODE void (*connected)(FAR struct bt_conn_s *conn,
              FAR void *context, uint16_t cid);
  CODE void (*disconnected)(FAR struct bt_conn_s *conn, FAR void *context,
              uint16_t cid);
  CODE void (*encrypt_change)(FAR struct bt_conn_s *conn,
              FAR void *context, uint16_t cid);
  CODE void (*receive)(FAR struct bt_conn_s *conn, FAR struct bt_buf_s *buf,
              FAR void *context, uint16_t cid);
};

/****************************************************************************
 * Public Function Prototypes
 ****************************************************************************/

/* Register a fixed L2CAP channel handler for L2CAP */

void bt_l2cap_chan_register(FAR struct bt_l2cap_chan_s *chan);

/* Register a default L2CAP channel handle for L2CAP */

void bt_l2cap_chan_default(FAR struct bt_l2cap_chan_s *chan);

/* Notify L2CAP channels of a new connection */

void bt_l2cap_connected(FAR struct bt_conn_s *conn);

/* Notify L2CAP channels of a disconnect event */

void bt_l2cap_disconnected(FAR struct bt_conn_s *conn);

/* Notify L2CAP channels of a change in encryption state */

void bt_l2cap_encrypt_change(FAR struct bt_conn_s *conn);

/* Prepare an L2CAP PDU to be sent over a connection */

FAR struct bt_buf_s *bt_l2cap_create_pdu(FAR struct bt_conn_s *conn);

/* Send L2CAP PDU over a connection */

void bt_l2cap_send(FAR struct bt_conn_s *conn, uint16_t cid,
                   FAR struct bt_buf_s *buf);

/* Receive a new L2CAP PDU from a connection */

void bt_l2cap_receive(FAR struct bt_conn_s *conn, FAR struct bt_buf_s *buf);

/* Perform connection parameter update request */

void bt_l2cap_update_conn_param(FAR struct bt_conn_s *conn);

/* Initialize L2CAP and supported channels */

int bt_l2cap_init(void);

#endif /* __WIRELESS_BLUETOOTH_BT_L2CAP_H */