bluetooth.h

Go to the documentation of this file.

 
#ifndef ZEPHYR_INCLUDE_DRIVERS_BLUETOOTH_H_
#define ZEPHYR_INCLUDE_DRIVERS_BLUETOOTH_H_
 
#include <stdbool.h>
#include <stdint.h>
#include <zephyr/net_buf.h>
#include <zephyr/bluetooth/buf.h>
#include <zephyr/bluetooth/addr.h>
#include <zephyr/bluetooth/hci_vs.h>
#include <zephyr/device.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct bt_hci_setup_params {
        bt_addr_t public_addr;
};
 
enum {
        /* The host should never send HCI_Reset */
        BT_HCI_QUIRK_NO_RESET = BIT(0),
        /* The controller does not auto-initiate a DLE procedure when the
         * initial connection data length parameters are not equal to the
         * default data length parameters. Therefore the host should initiate
         * the DLE procedure after connection establishment.
         *
         * That requirement is stated in Core Spec v5.4 Vol 6 Part B. 4.5.10
         * Data PDU length management:
         *
         * > For a new connection:
         * > - ... If either value is not 27, then the Controller should
         * >   initiate the Data Length Update procedure at the earliest
         * >   practical opportunity.
         */
        BT_HCI_QUIRK_NO_AUTO_DLE = BIT(1),
};
 
enum bt_hci_bus {
        BT_HCI_BUS_VIRTUAL       = 0,
        BT_HCI_BUS_USB           = 1,
        BT_HCI_BUS_PCCARD        = 2,
        BT_HCI_BUS_UART          = 3,
        BT_HCI_BUS_RS232         = 4,
        BT_HCI_BUS_PCI           = 5,
        BT_HCI_BUS_SDIO          = 6,
        BT_HCI_BUS_SPI           = 7,
        BT_HCI_BUS_I2C           = 8,
        BT_HCI_BUS_SMD           = 9,
        BT_HCI_BUS_VIRTIO        = 10,
        BT_HCI_BUS_IPC           = 11,
        /* IPM is deprecated and simply an alias for IPC */
        BT_HCI_BUS_IPM           = BT_HCI_BUS_IPC,
};
 
#define BT_DT_HCI_QUIRK_OR(node_id, prop, idx) \
        UTIL_CAT(BT_HCI_QUIRK_, DT_STRING_UPPER_TOKEN_BY_IDX(node_id, prop, idx))
#define BT_DT_HCI_QUIRKS_GET(node_id) COND_CODE_1(DT_NODE_HAS_PROP(node_id, bt_hci_quirks), \
                                                  (DT_FOREACH_PROP_ELEM_SEP(node_id, \
                                                                            bt_hci_quirks, \
                                                                            BT_DT_HCI_QUIRK_OR, \
                                                                            (|))), \
                                                  (0))
#define BT_DT_HCI_QUIRKS_INST_GET(inst) BT_DT_HCI_QUIRKS_GET(DT_DRV_INST(inst))
 
#define BT_DT_HCI_NAME_GET(node_id) DT_PROP_OR(node_id, bt_hci_name, "HCI")
#define BT_DT_HCI_NAME_INST_GET(inst) BT_DT_HCI_NAME_GET(DT_DRV_INST(inst))
 
#define BT_DT_HCI_BUS_GET(node_id) \
        UTIL_CAT(BT_HCI_BUS_, DT_STRING_UPPER_TOKEN_OR(node_id, bt_hci_bus, VIRTUAL))
#define BT_DT_HCI_BUS_INST_GET(inst) BT_DT_HCI_BUS_GET(DT_DRV_INST(inst))
 
typedef int (*bt_hci_recv_t)(const struct device *dev, struct net_buf *buf);
 
__subsystem struct bt_hci_driver_api {
        int (*open)(const struct device *dev, bt_hci_recv_t recv);
        int (*close)(const struct device *dev);
        int (*send)(const struct device *dev, struct net_buf *buf);
#if defined(CONFIG_BT_HCI_SETUP)
        int (*setup)(const struct device *dev,
                     const struct bt_hci_setup_params *param);
#endif /* defined(CONFIG_BT_HCI_SETUP) */
};
 
static inline int bt_hci_open(const struct device *dev, bt_hci_recv_t recv)
{
        const struct bt_hci_driver_api *api = (const struct bt_hci_driver_api *)dev->api;
 
        return api->open(dev, recv);
}
 
static inline int bt_hci_close(const struct device *dev)
{
        const struct bt_hci_driver_api *api = (const struct bt_hci_driver_api *)dev->api;
 
        if (api->close == NULL) {
                return -ENOSYS;
        }
 
        return api->close(dev);
}
 
static inline int bt_hci_send(const struct device *dev, struct net_buf *buf)
{
        const struct bt_hci_driver_api *api = (const struct bt_hci_driver_api *)dev->api;
 
        return api->send(dev, buf);
}
 
#if defined(CONFIG_BT_HCI_SETUP) || defined(__DOXYGEN__)
static inline int bt_hci_setup(const struct device *dev, struct bt_hci_setup_params *params)
{
        const struct bt_hci_driver_api *api = (const struct bt_hci_driver_api *)dev->api;
 
        if (api->setup == NULL) {
                return -ENOSYS;
        }
 
        return api->setup(dev, params);
}
#endif
 
/* The following functions are not strictly part of the HCI driver API, in that
 * they do not take as input a struct device which implements the HCI driver API.
 */
 
int bt_hci_transport_setup(const struct device *dev);
 
int bt_hci_transport_teardown(const struct device *dev);
 
struct net_buf *bt_hci_evt_create(uint8_t evt, uint8_t len);
 
struct net_buf *bt_hci_cmd_complete_create(uint16_t op, uint8_t plen);
 
struct net_buf *bt_hci_cmd_status_create(uint16_t op, uint8_t status);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_BLUETOOTH_H_ */