hci_vs.h

Go to the documentation of this file.

/* hci_vs.h - Bluetooth Host Control Interface Vendor Specific definitions */
 
/*
 * Copyright (c) 2017-2018 Nordic Semiconductor ASA
 * Copyright (c) 2015-2016 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_
 
#include <stdint.h>
 
#include <zephyr/bluetooth/addr.h>
#include <zephyr/bluetooth/hci.h>
#include <zephyr/bluetooth/hci_types.h>
#include <zephyr/net_buf.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BT_VS_CMD_BIT_VERSION                       0
#define BT_VS_CMD_BIT_SUP_CMD                       1
#define BT_VS_CMD_BIT_SUP_FEAT                      2
#define BT_VS_CMD_BIT_SET_EVT_MASK                  3
#define BT_VS_CMD_BIT_RESET                         4
#define BT_VS_CMD_BIT_WRITE_BDADDR                  5
#define BT_VS_CMD_BIT_SET_TRACE_ENABLE              6
#define BT_VS_CMD_BIT_READ_BUILD_INFO               7
#define BT_VS_CMD_BIT_READ_STATIC_ADDRS             8
#define BT_VS_CMD_BIT_READ_KEY_ROOTS                9
#define BT_VS_CMD_BIT_READ_CHIP_TEMP               10
#define BT_VS_CMD_BIT_READ_HOST_STACK_CMD          11
#define BT_VS_CMD_BIT_SET_SCAN_REP_ENABLE          12
#define BT_VS_CMD_BIT_WRITE_TX_POWER               13
#define BT_VS_CMD_BIT_READ_TX_POWER                14
 
#define BT_VS_CMD_SUP_FEAT(cmd)                 BT_LE_FEAT_TEST(cmd, \
                                                BT_VS_CMD_BIT_SUP_FEAT)
#define BT_VS_CMD_READ_STATIC_ADDRS(cmd)        BT_LE_FEAT_TEST(cmd, \
                                                BT_VS_CMD_BIT_READ_STATIC_ADDRS)
#define BT_VS_CMD_READ_KEY_ROOTS(cmd)           BT_LE_FEAT_TEST(cmd, \
                                                BT_VS_CMD_BIT_READ_KEY_ROOTS)
 
#define BT_HCI_VS_HW_PLAT_INTEL                 0x0001
#define BT_HCI_VS_HW_PLAT_NORDIC                0x0002
#define BT_HCI_VS_HW_PLAT_NXP                   0x0003
#define BT_HCI_VS_HW_PLAT_ESPRESSIF             0x0004
 
#define BT_HCI_VS_HW_VAR_NORDIC_NRF51X          0x0001
#define BT_HCI_VS_HW_VAR_NORDIC_NRF52X          0x0002
#define BT_HCI_VS_HW_VAR_NORDIC_NRF53X          0x0003
#define BT_HCI_VS_HW_VAR_NORDIC_NRF54HX         0x0004
#define BT_HCI_VS_HW_VAR_NORDIC_NRF54LX         0x0005
 
#define BT_HCI_VS_HW_VAR_ESP32                  0x0001
#define BT_HCI_VS_HW_VAR_ESP32S3                0x0002
#define BT_HCI_VS_HW_VAR_ESP32C2                0x0003
#define BT_HCI_VS_HW_VAR_ESP32C3                0x0004
#define BT_HCI_VS_HW_VAR_ESP32C6                0x0005
#define BT_HCI_VS_HW_VAR_ESP32H2                0x0006
 
#define BT_HCI_VS_FW_VAR_STANDARD_CTLR          0x0001
#define BT_HCI_VS_FW_VAR_VS_CTLR                0x0002
#define BT_HCI_VS_FW_VAR_FW_LOADER              0x0003
#define BT_HCI_VS_FW_VAR_RESCUE_IMG             0x0004
#define BT_HCI_OP_VS_READ_VERSION_INFO          BT_OP(BT_OGF_VS, 0x0001)
struct bt_hci_rp_vs_read_version_info {
        uint8_t  status;
        uint16_t hw_platform;
        uint16_t hw_variant;
        uint8_t  fw_variant;
        uint8_t  fw_version;
        uint16_t fw_revision;
        uint32_t fw_build;
} __packed;
 
#define BT_HCI_OP_VS_READ_SUPPORTED_COMMANDS    BT_OP(BT_OGF_VS, 0x0002)
struct bt_hci_rp_vs_read_supported_commands {
        uint8_t  status;
        uint8_t  commands[64];
} __packed;
 
#define BT_HCI_OP_VS_READ_SUPPORTED_FEATURES    BT_OP(BT_OGF_VS, 0x0003)
struct bt_hci_rp_vs_read_supported_features {
        uint8_t  status;
        uint8_t  features[8];
} __packed;
 
#define BT_HCI_OP_VS_SET_EVENT_MASK             BT_OP(BT_OGF_VS, 0x0004)
struct bt_hci_cp_vs_set_event_mask {
        uint8_t  event_mask[8];
} __packed;
 
#define BT_HCI_VS_RESET_SOFT                    0x00
#define BT_HCI_VS_RESET_HARD                    0x01
#define BT_HCI_OP_VS_RESET                      BT_OP(BT_OGF_VS, 0x0005)
struct bt_hci_cp_vs_reset {
        uint8_t  type;
} __packed;
 
#define BT_HCI_OP_VS_WRITE_BD_ADDR              BT_OP(BT_OGF_VS, 0x0006)
struct bt_hci_cp_vs_write_bd_addr {
        bt_addr_t bdaddr;
} __packed;
 
#define BT_HCI_VS_TRACE_DISABLED                0x00
#define BT_HCI_VS_TRACE_ENABLED                 0x01
 
#define BT_HCI_VS_TRACE_HCI_EVTS                0x00
#define BT_HCI_VS_TRACE_VDC                     0x01
#define BT_HCI_OP_VS_SET_TRACE_ENABLE           BT_OP(BT_OGF_VS, 0x0007)
struct bt_hci_cp_vs_set_trace_enable {
        uint8_t  enable;
        uint8_t  type;
} __packed;
 
#define BT_HCI_OP_VS_READ_BUILD_INFO            BT_OP(BT_OGF_VS, 0x0008)
struct bt_hci_rp_vs_read_build_info {
        uint8_t  status;
        uint8_t  info[0];
} __packed;
 
struct bt_hci_vs_static_addr {
        bt_addr_t bdaddr;
        uint8_t      ir[16];
} __packed;
 
#define BT_HCI_OP_VS_READ_STATIC_ADDRS          BT_OP(BT_OGF_VS, 0x0009)
struct bt_hci_rp_vs_read_static_addrs {
        uint8_t   status;
        uint8_t   num_addrs;
        struct bt_hci_vs_static_addr a[0];
} __packed;
 
#define BT_HCI_OP_VS_READ_KEY_HIERARCHY_ROOTS   BT_OP(BT_OGF_VS, 0x000a)
struct bt_hci_rp_vs_read_key_hierarchy_roots {
        uint8_t  status;
        uint8_t  ir[16];
        uint8_t  er[16];
} __packed;
 
#define BT_HCI_OP_VS_READ_CHIP_TEMP             BT_OP(BT_OGF_VS, 0x000b)
struct bt_hci_rp_vs_read_chip_temp {
        uint8_t  status;
        int8_t  temps;
} __packed;
 
struct bt_hci_vs_cmd {
        uint16_t vendor_id;
        uint16_t opcode_base;
} __packed;
 
#define BT_HCI_VS_VID_ANDROID                   0x0001
#define BT_HCI_VS_VID_MICROSOFT                 0x0002
#define BT_HCI_OP_VS_READ_HOST_STACK_CMDS       BT_OP(BT_OGF_VS, 0x000c)
struct bt_hci_rp_vs_read_host_stack_cmds {
        uint8_t   status;
        uint8_t   num_cmds;
        struct bt_hci_vs_cmd c[0];
} __packed;
 
#define BT_HCI_VS_SCAN_REQ_REPORTS_DISABLED     0x00
#define BT_HCI_VS_SCAN_REQ_REPORTS_ENABLED      0x01
#define BT_HCI_OP_VS_SET_SCAN_REQ_REPORTS       BT_OP(BT_OGF_VS, 0x000d)
struct bt_hci_cp_vs_set_scan_req_reports {
        uint8_t  enable;
} __packed;
 
#define BT_HCI_VS_LL_HANDLE_TYPE_ADV       0x00
#define BT_HCI_VS_LL_HANDLE_TYPE_SCAN      0x01
#define BT_HCI_VS_LL_HANDLE_TYPE_CONN      0x02
#define BT_HCI_VS_LL_TX_POWER_LEVEL_NO_PREF     0x7F
#define BT_HCI_OP_VS_WRITE_TX_POWER_LEVEL       BT_OP(BT_OGF_VS, 0x000e)
struct bt_hci_cp_vs_write_tx_power_level {
        uint8_t  handle_type;
        uint16_t handle;
        int8_t  tx_power_level;
} __packed;
 
struct bt_hci_rp_vs_write_tx_power_level {
        uint8_t  status;
        uint8_t  handle_type;
        uint16_t handle;
        int8_t  selected_tx_power;
} __packed;
 
#define BT_HCI_OP_VS_READ_TX_POWER_LEVEL        BT_OP(BT_OGF_VS, 0x000f)
struct bt_hci_cp_vs_read_tx_power_level {
        uint8_t  handle_type;
        uint16_t handle;
} __packed;
 
struct bt_hci_rp_vs_read_tx_power_level {
        uint8_t  status;
        uint8_t  handle_type;
        uint16_t handle;
        int8_t  tx_power_level;
} __packed;
 
#define BT_HCI_OP_VS_READ_USB_TRANSPORT_MODE    BT_OP(BT_OGF_VS, 0x0010)
 
struct bt_hci_rp_vs_read_usb_transport_mode {
        uint8_t  status;
        uint8_t  num_supported_modes;
        uint8_t  supported_mode[0];
} __packed;
 
#define BT_HCI_VS_USB_H2_MODE                  0x00
#define BT_HCI_VS_USB_H4_MODE                  0x01
 
#define BT_HCI_OP_VS_SET_USB_TRANSPORT_MODE    BT_OP(BT_OGF_VS, 0x0011)
 
struct bt_hci_cp_vs_set_usb_transport_mode {
        uint8_t  mode;
} __packed;
 
#define BT_HCI_OP_VS_SET_MIN_NUM_USED_CHANS    BT_OP(BT_OGF_VS, 0x0012)
 
struct bt_hci_cp_vs_set_min_num_used_chans {
        uint16_t handle;
        uint8_t  phys;
        uint8_t  min_used_chans;
} __packed;
 
/* Events */
 
struct bt_hci_evt_vs {
        uint8_t  subevent;
} __packed;
 
#define BT_HCI_EVT_VS_ERROR_DATA_TYPE_STACK_FRAME   0x01
#define BT_HCI_EVT_VS_ERROR_DATA_TYPE_CTRL_ASSERT   0x02
#define BT_HCI_EVT_VS_ERROR_DATA_TYPE_TRACE         0x03
struct bt_hci_vs_fatal_error_cpu_data_cortex_m {
        uint32_t a1;
        uint32_t a2;
        uint32_t a3;
        uint32_t a4;
        uint32_t ip;
        uint32_t lr;
        uint32_t pc;
        uint32_t xpsr;
} __packed;
 
#define BT_HCI_EVT_VS_ERROR_CPU_TYPE_CORTEX_M  0x01
struct bt_hci_vs_fatal_error_stack_frame {
        uint32_t reason;
        uint8_t cpu_type;
        uint8_t cpu_data[0];
} __packed;
 
struct bt_hci_evt_vs_fatal_error_trace_data {
        uint64_t pc;
        uint8_t err_info[0];
} __packed;
 
struct bt_hci_evt_vs_fatal_error {
        uint8_t type;
        uint8_t data[0];
} __packed;
 
#define BT_HCI_VS_TRACE_LMP_TX                 0x01
#define BT_HCI_VS_TRACE_LMP_RX                 0x02
#define BT_HCI_VS_TRACE_LLCP_TX                0x03
#define BT_HCI_VS_TRACE_LLCP_RX                0x04
#define BT_HCI_VS_TRACE_LE_CONN_IND            0x05
#define BT_HCI_EVT_VS_TRACE_INFO               0x03
struct bt_hci_evt_vs_trace_info {
        uint8_t  type;
        uint8_t  data[0];
} __packed;
 
#define BT_HCI_EVT_VS_SCAN_REQ_RX              0x04
struct bt_hci_evt_vs_scan_req_rx {
        bt_addr_le_t addr;
        int8_t         rssi;
} __packed;
 
struct bt_hci_le_iq_sample16 {
        int16_t i;
        int16_t q;
} __packed;
 
#define BT_HCI_EVT_VS_LE_CONNECTIONLESS_IQ_REPORT 0x5
#define BT_HCI_VS_LE_CTE_REPORT_NO_VALID_SAMPLE   0x8000
struct bt_hci_evt_vs_le_connectionless_iq_report {
        uint16_t sync_handle;
        uint8_t chan_idx;
        int16_t rssi;
        uint8_t rssi_ant_id;
        uint8_t cte_type;
        uint8_t slot_durations;
        uint8_t packet_status;
        uint16_t per_evt_counter;
        uint8_t sample_count;
        struct bt_hci_le_iq_sample16 sample[0];
} __packed;
 
#define BT_HCI_EVT_VS_LE_CONNECTION_IQ_REPORT 0x6
struct bt_hci_evt_vs_le_connection_iq_report {
        uint16_t conn_handle;
        uint8_t rx_phy;
        uint8_t data_chan_idx;
        int16_t rssi;
        uint8_t rssi_ant_id;
        uint8_t cte_type;
        uint8_t slot_durations;
        uint8_t packet_status;
        uint16_t conn_evt_counter;
        uint8_t sample_count;
        struct bt_hci_le_iq_sample16 sample[0];
} __packed;
 
/* Event mask bits */
 
#define BT_EVT_MASK_VS_FATAL_ERROR             BT_EVT_BIT(1)
#define BT_EVT_MASK_VS_TRACE_INFO              BT_EVT_BIT(2)
#define BT_EVT_MASK_VS_SCAN_REQ_RX             BT_EVT_BIT(3)
#define BT_EVT_MASK_VS_LE_CONNECTIONLESS_IQ_REPORT BT_EVT_BIT(4)
#define BT_EVT_MASK_VS_LE_CONNECTION_IQ_REPORT     BT_EVT_BIT(5)
 
#define DEFAULT_VS_EVT_MASK                                                                        \
        BT_EVT_MASK_VS_FATAL_ERROR | BT_EVT_MASK_VS_TRACE_INFO | BT_EVT_MASK_VS_SCAN_REQ_RX |      \
                BT_EVT_MASK_VS_LE_CONNECTIONLESS_IQ_REPORT |                                       \
                BT_EVT_MASK_VS_LE_CONNECTION_IQ_REPORT
 
/* Mesh HCI commands */
#define BT_HCI_MESH_REVISION                   0x01
 
#define BT_HCI_OP_VS_MESH                      BT_OP(BT_OGF_VS, 0x0042)
#define BT_HCI_MESH_EVT_PREFIX                 0xF0
 
struct bt_hci_cp_mesh {
        uint8_t         opcode;
} __packed;
 
#define BT_HCI_OC_MESH_GET_OPTS                0x00
struct bt_hci_rp_mesh_get_opts {
        uint8_t      status;
        uint8_t      opcode;
        uint8_t      revision;
        uint8_t      ch_map;
        int8_t      min_tx_power;
        int8_t      max_tx_power;
        uint8_t      max_scan_filter;
        uint8_t      max_filter_pattern;
        uint8_t      max_adv_slot;
        uint8_t      max_tx_window;
        uint8_t      evt_prefix_len;
        uint8_t      evt_prefix;
} __packed;
 
#define BT_HCI_MESH_PATTERN_LEN_MAX            0x0f
 
#define BT_HCI_OC_MESH_SET_SCAN_FILTER         0x01
struct bt_hci_mesh_pattern {
        uint8_t pattern_len;
        uint8_t pattern[0];
} __packed;
 
struct bt_hci_cp_mesh_set_scan_filter {
        uint8_t      scan_filter;
        uint8_t      filter_dup;
        uint8_t      num_patterns;
        struct    bt_hci_mesh_pattern patterns[0];
} __packed;
struct bt_hci_rp_mesh_set_scan_filter {
        uint8_t      status;
        uint8_t      opcode;
        uint8_t      scan_filter;
} __packed;
 
#define BT_HCI_OC_MESH_ADVERTISE               0x02
struct bt_hci_cp_mesh_advertise {
        uint8_t      adv_slot;
        uint8_t      own_addr_type;
        bt_addr_t random_addr;
        uint8_t      ch_map;
        int8_t      tx_power;
        uint8_t      min_tx_delay;
        uint8_t      max_tx_delay;
        uint8_t      retx_count;
        uint8_t      retx_interval;
        uint8_t      scan_delay;
        uint16_t     scan_duration;
        uint8_t      scan_filter;
        uint8_t      data_len;
        uint8_t      data[31];
} __packed;
struct bt_hci_rp_mesh_advertise {
        uint8_t      status;
        uint8_t      opcode;
        uint8_t      adv_slot;
} __packed;
 
#define BT_HCI_OC_MESH_ADVERTISE_TIMED         0x03
struct bt_hci_cp_mesh_advertise_timed {
        uint8_t      adv_slot;
        uint8_t      own_addr_type;
        bt_addr_t random_addr;
        uint8_t      ch_map;
        int8_t      tx_power;
        uint8_t      retx_count;
        uint8_t      retx_interval;
        uint32_t     instant;
        uint16_t     tx_delay;
        uint16_t     tx_window;
        uint8_t      data_len;
        uint8_t      data[31];
} __packed;
struct bt_hci_rp_mesh_advertise_timed {
        uint8_t      status;
        uint8_t      opcode;
        uint8_t      adv_slot;
} __packed;
 
#define BT_HCI_OC_MESH_ADVERTISE_CANCEL        0x04
struct bt_hci_cp_mesh_advertise_cancel {
        uint8_t      adv_slot;
} __packed;
struct bt_hci_rp_mesh_advertise_cancel {
        uint8_t      status;
        uint8_t      opcode;
        uint8_t      adv_slot;
} __packed;
 
#define BT_HCI_OC_MESH_SET_SCANNING            0x05
struct bt_hci_cp_mesh_set_scanning {
        uint8_t      enable;
        uint8_t      ch_map;
        uint8_t      scan_filter;
} __packed;
struct bt_hci_rp_mesh_set_scanning {
        uint8_t      status;
        uint8_t      opcode;
} __packed;
 
/* Events */
struct bt_hci_evt_mesh {
        uint8_t  prefix;
        uint8_t  subevent;
} __packed;
 
#define BT_HCI_EVT_MESH_ADV_COMPLETE           0x00
struct bt_hci_evt_mesh_adv_complete {
        uint8_t         adv_slot;
} __packed;
 
#define BT_HCI_EVT_MESH_SCANNING_REPORT        0x01
struct bt_hci_evt_mesh_scan_report {
        bt_addr_le_t addr;
        uint8_t         chan;
        int8_t         rssi;
        uint32_t        instant;
        uint8_t         data_len;
        uint8_t         data[0];
} __packed;
struct bt_hci_evt_mesh_scanning_report {
        uint8_t num_reports;
        struct bt_hci_evt_mesh_scan_report reports[0];
} __packed;
 
struct net_buf *hci_vs_err_stack_frame(unsigned int reason, const struct arch_esf *esf);
struct net_buf *hci_vs_err_trace(const char *file, uint32_t line, uint64_t pc);
struct net_buf *hci_vs_err_assert(const char *file, uint32_t line);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_ */