/* $NetBSD: hci.h,v 1.45.4.1 2019/09/28 07:32:02 martin Exp $ */ /*- * Copyright (c) 2005 Iain Hibbert. * Copyright (c) 2006 Itronix Inc. * 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. The name of Itronix Inc. may not be used to endorse * or promote products derived from this software without specific * prior written permission. * * THIS SOFTWARE IS PROVIDED BY ITRONIX INC. ``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 ITRONIX INC. 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. */ /*- * Copyright (c) 2001 Maksim Yevmenkin * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * $Id: hci.h,v 1.45.4.1 2019/09/28 07:32:02 martin Exp $ * $FreeBSD: src/sys/netgraph/bluetooth/include/ng_hci.h,v 1.6 2005/01/07 01:45:43 imp Exp $ */ /* * This file contains everything that applications need to know from * Host Controller Interface (HCI). Information taken from Bluetooth * Core Specifications (v1.1, v2.0, v2.1 + EDR, v3.0 + HS, * v4.0 and v4.2) * * This file can be included by both kernel and userland applications. * * NOTE: Here and after Bluetooth device is called a "unit". Bluetooth * specification refers to both devices and units. They are the * same thing (I think), so to be consistent word "unit" will be * used. */ #ifndef _NETBT_HCI_H_ #define _NETBT_HCI_H_ #include #include /************************************************************************** ************************************************************************** ** Common defines and types (HCI) ************************************************************************** **************************************************************************/ #define HCI_LAP_SIZE 3 /* unit LAP */ #define HCI_KEY_SIZE 16 /* link key */ #define HCI_PIN_SIZE 16 /* link PIN */ #define HCI_EVENT_MASK_SIZE 8 /* event mask */ #define HCI_CLASS_SIZE 3 /* unit class */ #define HCI_FEATURES_SIZE 8 /* LMP features */ #define HCI_UNIT_NAME_SIZE 248 /* unit name size */ #define HCI_DEVNAME_SIZE 16 /* same as dv_xname */ #define HCI_COMMANDS_SIZE 64 /* supported commands mask */ /* HCI specification */ #define HCI_SPEC_V10 0x00 /* v1.0b */ #define HCI_SPEC_V11 0x01 /* v1.1 */ #define HCI_SPEC_V12 0x02 /* v1.2 */ #define HCI_SPEC_V20 0x03 /* v2.0 + EDR */ #define HCI_SPEC_V21 0x04 /* v2.1 + EDR */ #define HCI_SPEC_V30 0x05 /* v3.0 + HS */ #define HCI_SPEC_V40 0x06 /* v4.0 */ #define HCI_SPEC_V41 0x07 /* v4.1 */ #define HCI_SPEC_V42 0x08 /* v4.2 */ #define HCI_SPEC_V50 0x09 /* v5.0 */ /* 0x0A - 0xFF - reserved for future use */ /* LMP features (and page 0 of extended features) */ /* ------------------- byte 0 --------------------*/ #define HCI_LMP_3SLOT 0x01 #define HCI_LMP_5SLOT 0x02 #define HCI_LMP_ENCRYPTION 0x04 #define HCI_LMP_SLOT_OFFSET 0x08 #define HCI_LMP_TIMIACCURACY 0x10 #define HCI_LMP_ROLE_SWITCH 0x20 #define HCI_LMP_HOLD_MODE 0x40 #define HCI_LMP_SNIFF_MODE 0x80 /* ------------------- byte 1 --------------------*/ #define HCI_LMP_PARK_MODE 0x01 #define HCI_LMP_RSSI 0x02 #define HCI_LMP_CHANNEL_QUALITY 0x04 #define HCI_LMP_SCO_LINK 0x08 #define HCI_LMP_HV2_PKT 0x10 #define HCI_LMP_HV3_PKT 0x20 #define HCI_LMP_ULAW_LOG 0x40 #define HCI_LMP_ALAW_LOG 0x80 /* ------------------- byte 2 --------------------*/ #define HCI_LMP_CVSD 0x01 #define HCI_LMP_PAGISCHEME 0x02 #define HCI_LMP_POWER_CONTROL 0x04 #define HCI_LMP_TRANSPARENT_SCO 0x08 #define HCI_LMP_FLOW_CONTROL_LAG0 0x10 #define HCI_LMP_FLOW_CONTROL_LAG1 0x20 #define HCI_LMP_FLOW_CONTROL_LAG2 0x40 #define HCI_LMP_BC_ENCRYPTION 0x80 /* ------------------- byte 3 --------------------*/ /* reserved 0x01 */ #define HCI_LMP_EDR_ACL_2MBPS 0x02 #define HCI_LMP_EDR_ACL_3MBPS 0x04 #define HCI_LMP_ENHANCED_ISCAN 0x08 #define HCI_LMP_INTERLACED_ISCAN 0x10 #define HCI_LMP_INTERLACED_PSCAN 0x20 #define HCI_LMP_RSSI_INQUIRY 0x40 #define HCI_LMP_EV3_PKT 0x80 /* ------------------- byte 4 --------------------*/ #define HCI_LMP_EV4_PKT 0x01 #define HCI_LMP_EV5_PKT 0x02 /* reserved 0x04 */ #define HCI_LMP_AFH_CAPABLE_SLAVE 0x08 #define HCI_LMP_AFH_CLASS_SLAVE 0x10 #define HCI_LMP_BR_EDR_UNSUPPORTED 0x20 #define HCI_LMP_LE_CONTROLLER 0x40 #define HCI_LMP_3SLOT_EDR_ACL 0x80 /* ------------------- byte 5 --------------------*/ #define HCI_LMP_5SLOT_EDR_ACL 0x01 #define HCI_LMP_SNIFF_SUBRATING 0x02 #define HCI_LMP_PAUSE_ENCRYPTION 0x04 #define HCI_LMP_AFH_CAPABLE_MASTER 0x08 #define HCI_LMP_AFH_CLASS_MASTER 0x10 #define HCI_LMP_EDR_eSCO_2MBPS 0x20 #define HCI_LMP_EDR_eSCO_3MBPS 0x40 #define HCI_LMP_3SLOT_EDR_eSCO 0x80 /* ------------------- byte 6 --------------------*/ #define HCI_LMP_EXTENDED_INQUIRY 0x01 #define HCI_LMP_LE_BR_EDR_CONTROLLER 0x02 /* reserved 0x04 */ #define HCI_LMP_SIMPLE_PAIRING 0x08 #define HCI_LMP_ENCAPSULATED_PDU 0x10 #define HCI_LMP_ERRDATA_REPORTING 0x20 #define HCI_LMP_NOFLUSH_PB_FLAG 0x40 /* reserved 0x80 */ /* ------------------- byte 7 --------------------*/ #define HCI_LMP_LINK_SUPERVISION_TO 0x01 #define HCI_LMP_INQ_RSP_TX_POWER 0x02 #define HCI_LMP_ENHANCED_POWER_CONTROL 0x04 #define HCI_LMP_EXTENDED_FEATURES 0x80 /* page 1 of extended features */ /* ------------------- byte 0 --------------------*/ #define HCI_LMP_SSP 0x01 #define HCI_LMP_LE_HOST 0x02 #define HCI_LMP_LE_BR_EDR_HOST 0x04 #define HCI_LMP_SECURE_CONN_HOST 0x08 /* page 2 of extended features */ /* ------------------- byte 0 --------------------*/ #define HCI_LMP_CONNLESS_MASTER 0x01 #define HCI_LMP_CONNLESS_SLAVE 0x02 #define HCI_LMP_SYNC_TRAIN 0x04 #define HCI_LMP_SYNC_SCAN 0x08 #define HCI_LMP_INQ_RSP_NOTIFY 0x10 #define HCI_LMP_INTERLACE_SCAN 0x20 #define HCI_LMP_COARSE_CLOCK 0x40 /* reserved 0x80 */ /* ------------------- byte 0 --------------------*/ #define HCI_LMP_SECURE_CONN_CONTROLLER 0x01 #define HCI_LMP_PING 0x02 /* reserved 0x04 */ #define HCI_LMP_TRAIN_NUDGING 0x08 /* Link types */ #define HCI_LINK_SCO 0x00 /* Voice */ #define HCI_LINK_ACL 0x01 /* Data */ #define HCI_LINK_eSCO 0x02 /* eSCO */ /* 0x03 - 0xFF - reserved for future use */ /* * ACL/SCO packet type bits are set to enable the * packet type, except for 2MBPS and 3MBPS when they * are unset to enable the packet type. */ /* ACL Packet types for "Create Connection" */ #define HCI_PKT_2MBPS_DH1 0x0002 #define HCI_PKT_3MBPS_DH1 0x0004 #define HCI_PKT_DM1 0x0008 #define HCI_PKT_DH1 0x0010 #define HCI_PKT_2MBPS_DH3 0x0100 #define HCI_PKT_3MBPS_DH3 0x0200 #define HCI_PKT_DM3 0x0400 #define HCI_PKT_DH3 0x0800 #define HCI_PKT_2MBPS_DH5 0x1000 #define HCI_PKT_3MBPS_DH5 0x2000 #define HCI_PKT_DM5 0x4000 #define HCI_PKT_DH5 0x8000 /* SCO Packet types for "Setup Synchronous Connection" */ #define HCI_PKT_HV1 0x0001 #define HCI_PKT_HV2 0x0002 #define HCI_PKT_HV3 0x0004 #define HCI_PKT_EV3 0x0008 #define HCI_PKT_EV4 0x0010 #define HCI_PKT_EV5 0x0020 #define HCI_PKT_2MBPS_EV3 0x0040 #define HCI_PKT_3MBPS_EV3 0x0080 #define HCI_PKT_2MBPS_EV5 0x0100 #define HCI_PKT_3MBPS_EV5 0x0200 /* * Connection modes/Unit modes * * This is confusing. It means that one of the units change its mode * for the specific connection. For example one connection was put on * hold (but i could be wrong :) */ /* Page scan modes (are deprecated) */ #define HCI_MANDATORY_PAGE_SCAN_MODE 0x00 #define HCI_OPTIONAL_PAGE_SCAN_MODE1 0x01 #define HCI_OPTIONAL_PAGE_SCAN_MODE2 0x02 #define HCI_OPTIONAL_PAGE_SCAN_MODE3 0x03 /* 0x04 - 0xFF - reserved for future use */ /* Page scan repetition modes */ #define HCI_SCAN_REP_MODE0 0x00 #define HCI_SCAN_REP_MODE1 0x01 #define HCI_SCAN_REP_MODE2 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Page scan period modes */ #define HCI_PAGE_SCAN_PERIOD_MODE0 0x00 #define HCI_PAGE_SCAN_PERIOD_MODE1 0x01 #define HCI_PAGE_SCAN_PERIOD_MODE2 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Scan enable */ #define HCI_NO_SCAN_ENABLE 0x00 #define HCI_INQUIRY_SCAN_ENABLE 0x01 #define HCI_PAGE_SCAN_ENABLE 0x02 /* 0x04 - 0xFF - reserved for future use */ /* Hold mode activities */ #define HCI_HOLD_MODE_NO_CHANGE 0x00 #define HCI_HOLD_MODE_SUSPEND_PAGE_SCAN 0x01 #define HCI_HOLD_MODE_SUSPEND_INQUIRY_SCAN 0x02 #define HCI_HOLD_MODE_SUSPEND_PERIOD_INQUIRY 0x04 /* 0x08 - 0x80 - reserved for future use */ /* Connection roles */ #define HCI_ROLE_MASTER 0x00 #define HCI_ROLE_SLAVE 0x01 /* 0x02 - 0xFF - reserved for future use */ /* Key flags */ #define HCI_USE_SEMI_PERMANENT_LINK_KEYS 0x00 #define HCI_USE_TEMPORARY_LINK_KEY 0x01 /* 0x02 - 0xFF - reserved for future use */ /* Pin types */ #define HCI_PIN_TYPE_VARIABLE 0x00 #define HCI_PIN_TYPE_FIXED 0x01 /* Link key types */ #define HCI_LINK_KEY_TYPE_COMBINATION_KEY 0x00 #define HCI_LINK_KEY_TYPE_LOCAL_UNIT_KEY 0x01 #define HCI_LINK_KEY_TYPE_REMOTE_UNIT_KEY 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Encryption modes */ #define HCI_ENCRYPTION_MODE_NONE 0x00 #define HCI_ENCRYPTION_MODE_P2P 0x01 #define HCI_ENCRYPTION_MODE_ALL 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Quality of service types */ #define HCI_SERVICE_TYPE_NO_TRAFFIC 0x00 #define HCI_SERVICE_TYPE_BEST_EFFORT 0x01 #define HCI_SERVICE_TYPE_GUARANTEED 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Link policy settings */ #define HCI_LINK_POLICY_DISABLE_ALL_LM_MODES 0x0000 #define HCI_LINK_POLICY_ENABLE_ROLE_SWITCH 0x0001 /* Master/Slave switch */ #define HCI_LINK_POLICY_ENABLE_HOLD_MODE 0x0002 #define HCI_LINK_POLICY_ENABLE_SNIFF_MODE 0x0004 #define HCI_LINK_POLICY_ENABLE_PARK_MODE 0x0008 /* 0x0010 - 0x8000 - reserved for future use */ /* Event masks */ #define HCI_EVMSK_ALL 0x00000000ffffffff #define HCI_EVMSK_NONE 0x0000000000000000 #define HCI_EVMSK_INQUIRY_COMPL 0x0000000000000001 #define HCI_EVMSK_INQUIRY_RESULT 0x0000000000000002 #define HCI_EVMSK_CON_COMPL 0x0000000000000004 #define HCI_EVMSK_CON_REQ 0x0000000000000008 #define HCI_EVMSK_DISCON_COMPL 0x0000000000000010 #define HCI_EVMSK_AUTH_COMPL 0x0000000000000020 #define HCI_EVMSK_REMOTE_NAME_REQ_COMPL 0x0000000000000040 #define HCI_EVMSK_ENCRYPTION_CHANGE 0x0000000000000080 #define HCI_EVMSK_CHANGE_CON_LINK_KEY_COMPL 0x0000000000000100 #define HCI_EVMSK_MASTER_LINK_KEY_COMPL 0x0000000000000200 #define HCI_EVMSK_READ_REMOTE_FEATURES_COMPL 0x0000000000000400 #define HCI_EVMSK_READ_REMOTE_VER_INFO_COMPL 0x0000000000000800 #define HCI_EVMSK_QOS_SETUP_COMPL 0x0000000000001000 #define HCI_EVMSK_COMMAND_COMPL 0x0000000000002000 #define HCI_EVMSK_COMMAND_STATUS 0x0000000000004000 #define HCI_EVMSK_HARDWARE_ERROR 0x0000000000008000 #define HCI_EVMSK_FLUSH_OCCUR 0x0000000000010000 #define HCI_EVMSK_ROLE_CHANGE 0x0000000000020000 #define HCI_EVMSK_NUM_COMPL_PKTS 0x0000000000040000 #define HCI_EVMSK_MODE_CHANGE 0x0000000000080000 #define HCI_EVMSK_RETURN_LINK_KEYS 0x0000000000100000 #define HCI_EVMSK_PIN_CODE_REQ 0x0000000000200000 #define HCI_EVMSK_LINK_KEY_REQ 0x0000000000400000 #define HCI_EVMSK_LINK_KEY_NOTIFICATION 0x0000000000800000 #define HCI_EVMSK_LOOPBACK_COMMAND 0x0000000001000000 #define HCI_EVMSK_DATA_BUFFER_OVERFLOW 0x0000000002000000 #define HCI_EVMSK_MAX_SLOT_CHANGE 0x0000000004000000 #define HCI_EVMSK_READ_CLOCK_OFFSET_COMLETE 0x0000000008000000 #define HCI_EVMSK_CON_PKT_TYPE_CHANGED 0x0000000010000000 #define HCI_EVMSK_QOS_VIOLATION 0x0000000020000000 #define HCI_EVMSK_PAGE_SCAN_MODE_CHANGE 0x0000000040000000 #define HCI_EVMSK_PAGE_SCAN_REP_MODE_CHANGE 0x0000000080000000 /* 0x0000000100000000 - 0x8000000000000000 - reserved for future use */ /* Filter types */ #define HCI_FILTER_TYPE_NONE 0x00 #define HCI_FILTER_TYPE_INQUIRY_RESULT 0x01 #define HCI_FILTER_TYPE_CON_SETUP 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Filter condition types for HCI_FILTER_TYPE_INQUIRY_RESULT */ #define HCI_FILTER_COND_INQUIRY_NEW_UNIT 0x00 #define HCI_FILTER_COND_INQUIRY_UNIT_CLASS 0x01 #define HCI_FILTER_COND_INQUIRY_BDADDR 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Filter condition types for HCI_FILTER_TYPE_CON_SETUP */ #define HCI_FILTER_COND_CON_ANY_UNIT 0x00 #define HCI_FILTER_COND_CON_UNIT_CLASS 0x01 #define HCI_FILTER_COND_CON_BDADDR 0x02 /* 0x03 - 0xFF - reserved for future use */ /* Xmit level types */ #define HCI_XMIT_LEVEL_CURRENT 0x00 #define HCI_XMIT_LEVEL_MAXIMUM 0x01 /* 0x02 - 0xFF - reserved for future use */ /* Host Controller to Host flow control */ #define HCI_HC2H_FLOW_CONTROL_NONE 0x00 #define HCI_HC2H_FLOW_CONTROL_ACL 0x01 #define HCI_HC2H_FLOW_CONTROL_SCO 0x02 #define HCI_HC2H_FLOW_CONTROL_BOTH 0x03 /* 0x04 - 0xFF - reserved future use */ /* Loopback modes */ #define HCI_LOOPBACK_NONE 0x00 #define HCI_LOOPBACK_LOCAL 0x01 #define HCI_LOOPBACK_REMOTE 0x02 /* 0x03 - 0xFF - reserved future use */ /************************************************************************** ************************************************************************** ** Link level defines, headers and types ************************************************************************** **************************************************************************/ /* * Macro(s) to combine OpCode and extract OGF (OpCode Group Field) * and OCF (OpCode Command Field) from OpCode. */ #define HCI_OPCODE(gf,cf) ((((gf) & 0x3f) << 10) | ((cf) & 0x3ff)) #define HCI_OCF(op) ((op) & 0x3ff) #define HCI_OGF(op) (((op) >> 10) & 0x3f) /* * Macro(s) to extract/combine connection handle, BC (Broadcast) and * PB (Packet boundary) flags. */ #define HCI_CON_HANDLE(h) ((h) & 0x0fff) #define HCI_PB_FLAG(h) (((h) & 0x3000) >> 12) #define HCI_BC_FLAG(h) (((h) & 0xc000) >> 14) #define HCI_MK_CON_HANDLE(h, pb, bc) \ (((h) & 0x0fff) | (((pb) & 3) << 12) | (((bc) & 3) << 14)) /* PB flag values */ /* 00 - reserved for future use */ #define HCI_PACKET_FRAGMENT 0x1 #define HCI_PACKET_START 0x2 /* 11 - reserved for future use */ /* BC flag values */ #define HCI_POINT2POINT 0x0 /* only Host controller to Host */ #define HCI_BROADCAST_ACTIVE 0x1 /* both directions */ #define HCI_BROADCAST_PICONET 0x2 /* both directions */ /* 11 - reserved for future use */ /* HCI command packet header */ typedef struct { uint8_t type; /* MUST be 0x01 */ uint16_t opcode; /* OpCode */ uint8_t length; /* parameter(s) length in bytes */ } __packed hci_cmd_hdr_t; #define HCI_CMD_PKT 0x01 #define HCI_CMD_PKT_SIZE (sizeof(hci_cmd_hdr_t) + 0xff) /* ACL data packet header */ typedef struct { uint8_t type; /* MUST be 0x02 */ uint16_t con_handle; /* connection handle + PB + BC flags */ uint16_t length; /* payload length in bytes */ } __packed hci_acldata_hdr_t; #define HCI_ACL_DATA_PKT 0x02 #define HCI_ACL_PKT_SIZE (sizeof(hci_acldata_hdr_t) + 0xffff) /* SCO data packet header */ typedef struct { uint8_t type; /* MUST be 0x03 */ uint16_t con_handle; /* connection handle + reserved bits */ uint8_t length; /* payload length in bytes */ } __packed hci_scodata_hdr_t; #define HCI_SCO_DATA_PKT 0x03 #define HCI_SCO_PKT_SIZE (sizeof(hci_scodata_hdr_t) + 0xff) /* HCI event packet header */ typedef struct { uint8_t type; /* MUST be 0x04 */ uint8_t event; /* event */ uint8_t length; /* parameter(s) length in bytes */ } __packed hci_event_hdr_t; #define HCI_EVENT_PKT 0x04 #define HCI_EVENT_PKT_SIZE (sizeof(hci_event_hdr_t) + 0xff) /* HCI status return parameter */ typedef struct { uint8_t status; /* 0x00 - success */ } __packed hci_status_rp; /************************************************************************** ************************************************************************** ** OGF 0x01 Link control commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_LINK_CONTROL 0x01 #define HCI_OCF_INQUIRY 0x0001 #define HCI_CMD_INQUIRY 0x0401 typedef struct { uint8_t lap[HCI_LAP_SIZE]; /* LAP */ uint8_t inquiry_length; /* (N x 1.28) sec */ uint8_t num_responses; /* Max. # of responses */ } __packed hci_inquiry_cp; /* No return parameter(s) */ #define HCI_OCF_INQUIRY_CANCEL 0x0002 #define HCI_CMD_INQUIRY_CANCEL 0x0402 /* No command parameter(s) */ typedef hci_status_rp hci_inquiry_cancel_rp; #define HCI_OCF_PERIODIC_INQUIRY 0x0003 #define HCI_CMD_PERIODIC_INQUIRY 0x0403 typedef struct { uint16_t max_period_length; /* Max. and min. amount of time */ uint16_t min_period_length; /* between consecutive inquiries */ uint8_t lap[HCI_LAP_SIZE]; /* LAP */ uint8_t inquiry_length; /* (inquiry_length * 1.28) sec */ uint8_t num_responses; /* Max. # of responses */ } __packed hci_periodic_inquiry_cp; typedef hci_status_rp hci_periodic_inquiry_rp; #define HCI_OCF_EXIT_PERIODIC_INQUIRY 0x0004 #define HCI_CMD_EXIT_PERIODIC_INQUIRY 0x0404 /* No command parameter(s) */ typedef hci_status_rp hci_exit_periodic_inquiry_rp; #define HCI_OCF_CREATE_CON 0x0005 #define HCI_CMD_CREATE_CON 0x0405 typedef struct { bdaddr_t bdaddr; /* destination address */ uint16_t pkt_type; /* packet type */ uint8_t page_scan_rep_mode; /* page scan repetition mode */ uint8_t page_scan_mode; /* reserved - set to 0x00 */ uint16_t clock_offset; /* clock offset */ uint8_t accept_role_switch; /* accept role switch? 0x00 == No */ } __packed hci_create_con_cp; /* No return parameter(s) */ #define HCI_OCF_DISCONNECT 0x0006 #define HCI_CMD_DISCONNECT 0x0406 typedef struct { uint16_t con_handle; /* connection handle */ uint8_t reason; /* reason to disconnect */ } __packed hci_discon_cp; /* No return parameter(s) */ /* Add SCO Connection is deprecated */ #define HCI_OCF_ADD_SCO_CON 0x0007 #define HCI_CMD_ADD_SCO_CON 0x0407 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t pkt_type; /* packet type */ } __packed hci_add_sco_con_cp; /* No return parameter(s) */ #define HCI_OCF_CREATE_CON_CANCEL 0x0008 #define HCI_CMD_CREATE_CON_CANCEL 0x0408 typedef struct { bdaddr_t bdaddr; /* destination address */ } __packed hci_create_con_cancel_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* destination address */ } __packed hci_create_con_cancel_rp; #define HCI_OCF_ACCEPT_CON 0x0009 #define HCI_CMD_ACCEPT_CON 0x0409 typedef struct { bdaddr_t bdaddr; /* address of unit to be connected */ uint8_t role; /* connection role */ } __packed hci_accept_con_cp; /* No return parameter(s) */ #define HCI_OCF_REJECT_CON 0x000a #define HCI_CMD_REJECT_CON 0x040A typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t reason; /* reason to reject */ } __packed hci_reject_con_cp; /* No return parameter(s) */ #define HCI_OCF_LINK_KEY_REP 0x000b #define HCI_CMD_LINK_KEY_REP 0x040B typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t key[HCI_KEY_SIZE]; /* key */ } __packed hci_link_key_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* unit address */ } __packed hci_link_key_rep_rp; #define HCI_OCF_LINK_KEY_NEG_REP 0x000c #define HCI_CMD_LINK_KEY_NEG_REP 0x040C typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_link_key_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* unit address */ } __packed hci_link_key_neg_rep_rp; #define HCI_OCF_PIN_CODE_REP 0x000d #define HCI_CMD_PIN_CODE_REP 0x040D typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t pin_size; /* pin code length (in bytes) */ uint8_t pin[HCI_PIN_SIZE]; /* pin code */ } __packed hci_pin_code_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* unit address */ } __packed hci_pin_code_rep_rp; #define HCI_OCF_PIN_CODE_NEG_REP 0x000e #define HCI_CMD_PIN_CODE_NEG_REP 0x040E typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_pin_code_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* unit address */ } __packed hci_pin_code_neg_rep_rp; #define HCI_OCF_CHANGE_CON_PACKET_TYPE 0x000f #define HCI_CMD_CHANGE_CON_PACKET_TYPE 0x040F typedef struct { uint16_t con_handle; /* connection handle */ uint16_t pkt_type; /* packet type */ } __packed hci_change_con_pkt_type_cp; /* No return parameter(s) */ #define HCI_OCF_AUTH_REQ 0x0011 #define HCI_CMD_AUTH_REQ 0x0411 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_auth_req_cp; /* No return parameter(s) */ #define HCI_OCF_SET_CON_ENCRYPTION 0x0013 #define HCI_CMD_SET_CON_ENCRYPTION 0x0413 typedef struct { uint16_t con_handle; /* connection handle */ uint8_t encryption_enable; /* 0x00 - disable, 0x01 - enable */ } __packed hci_set_con_encryption_cp; /* No return parameter(s) */ #define HCI_OCF_CHANGE_CON_LINK_KEY 0x0015 #define HCI_CMD_CHANGE_CON_LINK_KEY 0x0415 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_change_con_link_key_cp; /* No return parameter(s) */ #define HCI_OCF_MASTER_LINK_KEY 0x0017 #define HCI_CMD_MASTER_LINK_KEY 0x0417 typedef struct { uint8_t key_flag; /* key flag */ } __packed hci_master_link_key_cp; /* No return parameter(s) */ #define HCI_OCF_REMOTE_NAME_REQ 0x0019 #define HCI_CMD_REMOTE_NAME_REQ 0x0419 typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t page_scan_rep_mode; /* page scan repetition mode */ uint8_t page_scan_mode; /* page scan mode */ uint16_t clock_offset; /* clock offset */ } __packed hci_remote_name_req_cp; /* No return parameter(s) */ #define HCI_OCF_REMOTE_NAME_REQ_CANCEL 0x001a #define HCI_CMD_REMOTE_NAME_REQ_CANCEL 0x041A typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_remote_name_req_cancel_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_remote_name_req_cancel_rp; #define HCI_OCF_READ_REMOTE_FEATURES 0x001b #define HCI_CMD_READ_REMOTE_FEATURES 0x041B typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_remote_features_cp; /* No return parameter(s) */ #define HCI_OCF_READ_REMOTE_EXTENDED_FEATURES 0x001c #define HCI_CMD_READ_REMOTE_EXTENDED_FEATURES 0x041C typedef struct { uint16_t con_handle; /* connection handle */ uint8_t page; /* page number */ } __packed hci_read_remote_extended_features_cp; /* No return parameter(s) */ #define HCI_OCF_READ_REMOTE_VER_INFO 0x001d #define HCI_CMD_READ_REMOTE_VER_INFO 0x041D typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_remote_ver_info_cp; /* No return parameter(s) */ #define HCI_OCF_READ_CLOCK_OFFSET 0x001f #define HCI_CMD_READ_CLOCK_OFFSET 0x041F typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_clock_offset_cp; /* No return parameter(s) */ #define HCI_OCF_READ_LMP_HANDLE 0x0020 #define HCI_CMD_READ_LMP_HANDLE 0x0420 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_lmp_handle_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t lmp_handle; /* LMP handle */ uint32_t reserved; /* reserved */ } __packed hci_read_lmp_handle_rp; #define HCI_OCF_SETUP_SCO_CON 0x0028 #define HCI_CMD_SETUP_SCO_CON 0x0428 typedef struct { uint16_t con_handle; /* connection handle */ uint32_t tx_bandwidth; /* transmit bandwidth */ uint32_t rx_bandwidth; /* receive bandwidth */ uint16_t latency; /* maximum latency */ uint16_t voice; /* voice setting */ uint8_t rt_effort; /* retransmission effort */ uint16_t pkt_type; /* packet types */ } __packed hci_setup_sco_con_cp; /* No return parameter(s) */ #define HCI_OCF_ACCEPT_SCO_CON_REQ 0x0029 #define HCI_CMD_ACCEPT_SCO_CON_REQ 0x0429 typedef struct { bdaddr_t bdaddr; /* remote address */ uint32_t tx_bandwidth; /* transmit bandwidth */ uint32_t rx_bandwidth; /* receive bandwidth */ uint16_t latency; /* maximum latency */ uint16_t content; /* voice setting */ uint8_t rt_effort; /* retransmission effort */ uint16_t pkt_type; /* packet types */ } __packed hci_accept_sco_con_req_cp; /* No return parameter(s) */ #define HCI_OCF_REJECT_SCO_CON_REQ 0x002a #define HCI_CMD_REJECT_SCO_CON_REQ 0x042a typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t reason; /* reject error code */ } __packed hci_reject_sco_con_req_cp; /* No return parameter(s) */ #define HCI_OCF_IO_CAPABILITY_REP 0x002b #define HCI_CMD_IO_CAPABILITY_REP 0x042a typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t io_cap; /* IO capability */ uint8_t oob_data; /* OOB data present */ uint8_t auth_req; /* auth requirements */ } __packed hci_io_capability_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_io_capability_rep_rp; #define HCI_OCF_USER_CONFIRM_REP 0x002c #define HCI_CMD_USER_CONFIRM_REP 0x042c typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_user_confirm_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_confirm_rep_rp; #define HCI_OCF_USER_CONFIRM_NEG_REP 0x002d #define HCI_CMD_USER_CONFIRM_NEG_REP 0x042d typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_user_confirm_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_confirm_neg_rep_rp; #define HCI_OCF_USER_PASSKEY_REP 0x002e #define HCI_CMD_USER_PASSKEY_REP 0x042e typedef struct { bdaddr_t bdaddr; /* remote address */ uint32_t value; /* 000000 - 999999 */ } __packed hci_user_passkey_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_passkey_rep_rp; #define HCI_OCF_USER_PASSKEY_NEG_REP 0x002f #define HCI_CMD_USER_PASSKEY_NEG_REP 0x042f typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_user_passkey_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_passkey_neg_rep_rp; #define HCI_OCF_OOB_DATA_REP 0x0030 #define HCI_CMD_OOB_DATA_REP 0x0430 typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t c[16]; /* pairing hash */ uint8_t r[16]; /* pairing randomizer */ } __packed hci_user_oob_data_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_oob_data_rep_rp; #define HCI_OCF_OOB_DATA_NEG_REP 0x0033 #define HCI_CMD_OOB_DATA_NEG_REP 0x0433 typedef struct { bdaddr_t bdaddr; /* remote address */ } __packed hci_user_oob_data_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_user_oob_data_neg_rep_rp; #define HCI_OCF_IO_CAPABILITY_NEG_REP 0x0034 #define HCI_CMD_IO_CAPABILITY_NEG_REP 0x0434 typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t reason; /* error code */ } __packed hci_io_capability_neg_rep_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_io_capability_neg_rep_rp; /************************************************************************** ************************************************************************** ** OGF 0x02 Link policy commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_LINK_POLICY 0x02 #define HCI_OCF_HOLD_MODE 0x0001 #define HCI_CMD_HOLD_MODE 0x0801 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t max_interval; /* (max_interval * 0.625) msec */ uint16_t min_interval; /* (max_interval * 0.625) msec */ } __packed hci_hold_mode_cp; /* No return parameter(s) */ #define HCI_OCF_SNIFF_MODE 0x0003 #define HCI_CMD_SNIFF_MODE 0x0803 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t max_interval; /* (max_interval * 0.625) msec */ uint16_t min_interval; /* (max_interval * 0.625) msec */ uint16_t attempt; /* (2 * attempt - 1) * 0.625 msec */ uint16_t timeout; /* (2 * attempt - 1) * 0.625 msec */ } __packed hci_sniff_mode_cp; /* No return parameter(s) */ #define HCI_OCF_EXIT_SNIFF_MODE 0x0004 #define HCI_CMD_EXIT_SNIFF_MODE 0x0804 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_exit_sniff_mode_cp; /* No return parameter(s) */ #define HCI_OCF_PARK_MODE 0x0005 #define HCI_CMD_PARK_MODE 0x0805 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t max_interval; /* (max_interval * 0.625) msec */ uint16_t min_interval; /* (max_interval * 0.625) msec */ } __packed hci_park_mode_cp; /* No return parameter(s) */ #define HCI_OCF_EXIT_PARK_MODE 0x0006 #define HCI_CMD_EXIT_PARK_MODE 0x0806 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_exit_park_mode_cp; /* No return parameter(s) */ #define HCI_OCF_QOS_SETUP 0x0007 #define HCI_CMD_QOS_SETUP 0x0807 typedef struct { uint16_t con_handle; /* connection handle */ uint8_t flags; /* reserved for future use */ uint8_t service_type; /* service type */ uint32_t token_rate; /* bytes per second */ uint32_t peak_bandwidth; /* bytes per second */ uint32_t latency; /* microseconds */ uint32_t delay_variation; /* microseconds */ } __packed hci_qos_setup_cp; /* No return parameter(s) */ #define HCI_OCF_ROLE_DISCOVERY 0x0009 #define HCI_CMD_ROLE_DISCOVERY 0x0809 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_role_discovery_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t role; /* role for the connection handle */ } __packed hci_role_discovery_rp; #define HCI_OCF_SWITCH_ROLE 0x000b #define HCI_CMD_SWITCH_ROLE 0x080B typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t role; /* new local role */ } __packed hci_switch_role_cp; /* No return parameter(s) */ #define HCI_OCF_READ_LINK_POLICY_SETTINGS 0x000c #define HCI_CMD_READ_LINK_POLICY_SETTINGS 0x080C typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_link_policy_settings_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t settings; /* link policy settings */ } __packed hci_read_link_policy_settings_rp; #define HCI_OCF_WRITE_LINK_POLICY_SETTINGS 0x000d #define HCI_CMD_WRITE_LINK_POLICY_SETTINGS 0x080D typedef struct { uint16_t con_handle; /* connection handle */ uint16_t settings; /* link policy settings */ } __packed hci_write_link_policy_settings_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_write_link_policy_settings_rp; #define HCI_OCF_READ_DEFAULT_LINK_POLICY_SETTINGS 0x000e #define HCI_CMD_READ_DEFAULT_LINK_POLICY_SETTINGS 0x080E /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t settings; /* link policy settings */ } __packed hci_read_default_link_policy_settings_rp; #define HCI_OCF_WRITE_DEFAULT_LINK_POLICY_SETTINGS 0x000f #define HCI_CMD_WRITE_DEFAULT_LINK_POLICY_SETTINGS 0x080F typedef struct { uint16_t settings; /* link policy settings */ } __packed hci_write_default_link_policy_settings_cp; typedef hci_status_rp hci_write_default_link_policy_settings_rp; #define HCI_OCF_FLOW_SPECIFICATION 0x0010 #define HCI_CMD_FLOW_SPECIFICATION 0x0810 typedef struct { uint16_t con_handle; /* connection handle */ uint8_t flags; /* reserved */ uint8_t flow_direction; uint8_t service_type; uint32_t token_rate; uint32_t token_bucket; uint32_t peak_bandwidth; uint32_t latency; } __packed hci_flow_specification_cp; /* No return parameter(s) */ #define HCI_OCF_SNIFF_SUBRATING 0x0011 #define HCI_CMD_SNIFF_SUBRATING 0x0810 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t max_latency; uint16_t max_timeout; /* max remote timeout */ uint16_t min_timeout; /* min local timeout */ } __packed hci_sniff_subrating_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_sniff_subrating_rp; /************************************************************************** ************************************************************************** ** OGF 0x03 Host Controller and Baseband commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_HC_BASEBAND 0x03 #define HCI_OCF_SET_EVENT_MASK 0x0001 #define HCI_CMD_SET_EVENT_MASK 0x0C01 typedef struct { uint8_t event_mask[HCI_EVENT_MASK_SIZE]; /* event_mask */ } __packed hci_set_event_mask_cp; typedef hci_status_rp hci_set_event_mask_rp; #define HCI_OCF_RESET 0x0003 #define HCI_CMD_RESET 0x0C03 /* No command parameter(s) */ typedef hci_status_rp hci_reset_rp; #define HCI_OCF_SET_EVENT_FILTER 0x0005 #define HCI_CMD_SET_EVENT_FILTER 0x0C05 typedef struct { uint8_t filter_type; /* filter type */ uint8_t filter_condition_type; /* filter condition type */ /* variable size condition uint8_t condition[]; -- conditions */ } __packed hci_set_event_filter_cp; typedef hci_status_rp hci_set_event_filter_rp; #define HCI_OCF_FLUSH 0x0008 #define HCI_CMD_FLUSH 0x0C08 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_flush_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_flush_rp; #define HCI_OCF_READ_PIN_TYPE 0x0009 #define HCI_CMD_READ_PIN_TYPE 0x0C09 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t pin_type; /* PIN type */ } __packed hci_read_pin_type_rp; #define HCI_OCF_WRITE_PIN_TYPE 0x000a #define HCI_CMD_WRITE_PIN_TYPE 0x0C0A typedef struct { uint8_t pin_type; /* PIN type */ } __packed hci_write_pin_type_cp; typedef hci_status_rp hci_write_pin_type_rp; #define HCI_OCF_CREATE_NEW_UNIT_KEY 0x000b #define HCI_CMD_CREATE_NEW_UNIT_KEY 0x0C0B /* No command parameter(s) */ typedef hci_status_rp hci_create_new_unit_key_rp; #define HCI_OCF_READ_STORED_LINK_KEY 0x000d #define HCI_CMD_READ_STORED_LINK_KEY 0x0C0D typedef struct { bdaddr_t bdaddr; /* address */ uint8_t read_all; /* read all keys? 0x01 - yes */ } __packed hci_read_stored_link_key_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t max_num_keys; /* Max. number of keys */ uint16_t num_keys_read; /* Number of stored keys */ } __packed hci_read_stored_link_key_rp; #define HCI_OCF_WRITE_STORED_LINK_KEY 0x0011 #define HCI_CMD_WRITE_STORED_LINK_KEY 0x0C11 typedef struct { uint8_t num_keys_write; /* # of keys to write */ /* these are repeated "num_keys_write" times bdaddr_t bdaddr; --- remote address(es) uint8_t key[HCI_KEY_SIZE]; --- key(s) */ } __packed hci_write_stored_link_key_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint8_t num_keys_written; /* # of keys successfully written */ } __packed hci_write_stored_link_key_rp; #define HCI_OCF_DELETE_STORED_LINK_KEY 0x0012 #define HCI_CMD_DELETE_STORED_LINK_KEY 0x0C12 typedef struct { bdaddr_t bdaddr; /* address */ uint8_t delete_all; /* delete all keys? 0x01 - yes */ } __packed hci_delete_stored_link_key_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t num_keys_deleted; /* Number of keys deleted */ } __packed hci_delete_stored_link_key_rp; #define HCI_OCF_WRITE_LOCAL_NAME 0x0013 #define HCI_CMD_WRITE_LOCAL_NAME 0x0C13 typedef struct { char name[HCI_UNIT_NAME_SIZE]; /* new unit name */ } __packed hci_write_local_name_cp; typedef hci_status_rp hci_write_local_name_rp; #define HCI_OCF_READ_LOCAL_NAME 0x0014 #define HCI_CMD_READ_LOCAL_NAME 0x0C14 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ char name[HCI_UNIT_NAME_SIZE]; /* unit name */ } __packed hci_read_local_name_rp; #define HCI_OCF_READ_CON_ACCEPT_TIMEOUT 0x0015 #define HCI_CMD_READ_CON_ACCEPT_TIMEOUT 0x0C15 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t timeout; /* (timeout * 0.625) msec */ } __packed hci_read_con_accept_timeout_rp; #define HCI_OCF_WRITE_CON_ACCEPT_TIMEOUT 0x0016 #define HCI_CMD_WRITE_CON_ACCEPT_TIMEOUT 0x0C16 typedef struct { uint16_t timeout; /* (timeout * 0.625) msec */ } __packed hci_write_con_accept_timeout_cp; typedef hci_status_rp hci_write_con_accept_timeout_rp; #define HCI_OCF_READ_PAGE_TIMEOUT 0x0017 #define HCI_CMD_READ_PAGE_TIMEOUT 0x0C17 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t timeout; /* (timeout * 0.625) msec */ } __packed hci_read_page_timeout_rp; #define HCI_OCF_WRITE_PAGE_TIMEOUT 0x0018 #define HCI_CMD_WRITE_PAGE_TIMEOUT 0x0C18 typedef struct { uint16_t timeout; /* (timeout * 0.625) msec */ } __packed hci_write_page_timeout_cp; typedef hci_status_rp hci_write_page_timeout_rp; #define HCI_OCF_READ_SCAN_ENABLE 0x0019 #define HCI_CMD_READ_SCAN_ENABLE 0x0C19 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t scan_enable; /* Scan enable */ } __packed hci_read_scan_enable_rp; #define HCI_OCF_WRITE_SCAN_ENABLE 0x001a #define HCI_CMD_WRITE_SCAN_ENABLE 0x0C1A typedef struct { uint8_t scan_enable; /* Scan enable */ } __packed hci_write_scan_enable_cp; typedef hci_status_rp hci_write_scan_enable_rp; #define HCI_OCF_READ_PAGE_SCAN_ACTIVITY 0x001b #define HCI_CMD_READ_PAGE_SCAN_ACTIVITY 0x0C1B /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t page_scan_interval; /* interval * 0.625 msec */ uint16_t page_scan_window; /* window * 0.625 msec */ } __packed hci_read_page_scan_activity_rp; #define HCI_OCF_WRITE_PAGE_SCAN_ACTIVITY 0x001c #define HCI_CMD_WRITE_PAGE_SCAN_ACTIVITY 0x0C1C typedef struct { uint16_t page_scan_interval; /* interval * 0.625 msec */ uint16_t page_scan_window; /* window * 0.625 msec */ } __packed hci_write_page_scan_activity_cp; typedef hci_status_rp hci_write_page_scan_activity_rp; #define HCI_OCF_READ_INQUIRY_SCAN_ACTIVITY 0x001d #define HCI_CMD_READ_INQUIRY_SCAN_ACTIVITY 0x0C1D /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t inquiry_scan_interval; /* interval * 0.625 msec */ uint16_t inquiry_scan_window; /* window * 0.625 msec */ } __packed hci_read_inquiry_scan_activity_rp; #define HCI_OCF_WRITE_INQUIRY_SCAN_ACTIVITY 0x001e #define HCI_CMD_WRITE_INQUIRY_SCAN_ACTIVITY 0x0C1E typedef struct { uint16_t inquiry_scan_interval; /* interval * 0.625 msec */ uint16_t inquiry_scan_window; /* window * 0.625 msec */ } __packed hci_write_inquiry_scan_activity_cp; typedef hci_status_rp hci_write_inquiry_scan_activity_rp; #define HCI_OCF_READ_AUTH_ENABLE 0x001f #define HCI_CMD_READ_AUTH_ENABLE 0x0C1F /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t auth_enable; /* 0x01 - enabled */ } __packed hci_read_auth_enable_rp; #define HCI_OCF_WRITE_AUTH_ENABLE 0x0020 #define HCI_CMD_WRITE_AUTH_ENABLE 0x0C20 typedef struct { uint8_t auth_enable; /* 0x01 - enabled */ } __packed hci_write_auth_enable_cp; typedef hci_status_rp hci_write_auth_enable_rp; /* Read Encryption Mode is deprecated */ #define HCI_OCF_READ_ENCRYPTION_MODE 0x0021 #define HCI_CMD_READ_ENCRYPTION_MODE 0x0C21 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t encryption_mode; /* encryption mode */ } __packed hci_read_encryption_mode_rp; /* Write Encryption Mode is deprecated */ #define HCI_OCF_WRITE_ENCRYPTION_MODE 0x0022 #define HCI_CMD_WRITE_ENCRYPTION_MODE 0x0C22 typedef struct { uint8_t encryption_mode; /* encryption mode */ } __packed hci_write_encryption_mode_cp; typedef hci_status_rp hci_write_encryption_mode_rp; #define HCI_OCF_READ_UNIT_CLASS 0x0023 #define HCI_CMD_READ_UNIT_CLASS 0x0C23 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t uclass[HCI_CLASS_SIZE]; /* unit class */ } __packed hci_read_unit_class_rp; #define HCI_OCF_WRITE_UNIT_CLASS 0x0024 #define HCI_CMD_WRITE_UNIT_CLASS 0x0C24 typedef struct { uint8_t uclass[HCI_CLASS_SIZE]; /* unit class */ } __packed hci_write_unit_class_cp; typedef hci_status_rp hci_write_unit_class_rp; #define HCI_OCF_READ_VOICE_SETTING 0x0025 #define HCI_CMD_READ_VOICE_SETTING 0x0C25 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t settings; /* voice settings */ } __packed hci_read_voice_setting_rp; #define HCI_OCF_WRITE_VOICE_SETTING 0x0026 #define HCI_CMD_WRITE_VOICE_SETTING 0x0C26 typedef struct { uint16_t settings; /* voice settings */ } __packed hci_write_voice_setting_cp; typedef hci_status_rp hci_write_voice_setting_rp; #define HCI_OCF_READ_AUTO_FLUSH_TIMEOUT 0x0027 #define HCI_CMD_READ_AUTO_FLUSH_TIMEOUT 0x0C27 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_auto_flush_timeout_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t timeout; /* 0x00 - no flush, timeout * 0.625 msec */ } __packed hci_read_auto_flush_timeout_rp; #define HCI_OCF_WRITE_AUTO_FLUSH_TIMEOUT 0x0028 #define HCI_CMD_WRITE_AUTO_FLUSH_TIMEOUT 0x0C28 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t timeout; /* 0x00 - no flush, timeout * 0.625 msec */ } __packed hci_write_auto_flush_timeout_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_write_auto_flush_timeout_rp; #define HCI_OCF_READ_NUM_BROADCAST_RETRANS 0x0029 #define HCI_CMD_READ_NUM_BROADCAST_RETRANS 0x0C29 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t counter; /* number of broadcast retransmissions */ } __packed hci_read_num_broadcast_retrans_rp; #define HCI_OCF_WRITE_NUM_BROADCAST_RETRANS 0x002a #define HCI_CMD_WRITE_NUM_BROADCAST_RETRANS 0x0C2A typedef struct { uint8_t counter; /* number of broadcast retransmissions */ } __packed hci_write_num_broadcast_retrans_cp; typedef hci_status_rp hci_write_num_broadcast_retrans_rp; #define HCI_OCF_READ_HOLD_MODE_ACTIVITY 0x002b #define HCI_CMD_READ_HOLD_MODE_ACTIVITY 0x0C2B /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t hold_mode_activity; /* Hold mode activities */ } __packed hci_read_hold_mode_activity_rp; #define HCI_OCF_WRITE_HOLD_MODE_ACTIVITY 0x002c #define HCI_CMD_WRITE_HOLD_MODE_ACTIVITY 0x0C2C typedef struct { uint8_t hold_mode_activity; /* Hold mode activities */ } __packed hci_write_hold_mode_activity_cp; typedef hci_status_rp hci_write_hold_mode_activity_rp; #define HCI_OCF_READ_XMIT_LEVEL 0x002d #define HCI_CMD_READ_XMIT_LEVEL 0x0C2D typedef struct { uint16_t con_handle; /* connection handle */ uint8_t type; /* Xmit level type */ } __packed hci_read_xmit_level_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ char level; /* -30 <= level <= 30 dBm */ } __packed hci_read_xmit_level_rp; #define HCI_OCF_READ_SCO_FLOW_CONTROL 0x002e #define HCI_CMD_READ_SCO_FLOW_CONTROL 0x0C2E /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t flow_control; /* 0x00 - disabled */ } __packed hci_read_sco_flow_control_rp; #define HCI_OCF_WRITE_SCO_FLOW_CONTROL 0x002f #define HCI_CMD_WRITE_SCO_FLOW_CONTROL 0x0C2F typedef struct { uint8_t flow_control; /* 0x00 - disabled */ } __packed hci_write_sco_flow_control_cp; typedef hci_status_rp hci_write_sco_flow_control_rp; #define HCI_OCF_HC2H_FLOW_CONTROL 0x0031 #define HCI_CMD_HC2H_FLOW_CONTROL 0x0C31 typedef struct { uint8_t hc2h_flow; /* Host Controller to Host flow control */ } __packed hci_hc2h_flow_control_cp; typedef hci_status_rp hci_h2hc_flow_control_rp; #define HCI_OCF_HOST_BUFFER_SIZE 0x0033 #define HCI_CMD_HOST_BUFFER_SIZE 0x0C33 typedef struct { uint16_t max_acl_size; /* Max. size of ACL packet (bytes) */ uint8_t max_sco_size; /* Max. size of SCO packet (bytes) */ uint16_t num_acl_pkts; /* Max. number of ACL packets */ uint16_t num_sco_pkts; /* Max. number of SCO packets */ } __packed hci_host_buffer_size_cp; typedef hci_status_rp hci_host_buffer_size_rp; #define HCI_OCF_HOST_NUM_COMPL_PKTS 0x0035 #define HCI_CMD_HOST_NUM_COMPL_PKTS 0x0C35 typedef struct { uint8_t nu_con_handles; /* # of connection handles */ /* these are repeated "num_con_handles" times uint16_t con_handle; --- connection handle(s) uint16_t compl_pkts; --- # of completed packets */ } __packed hci_host_num_compl_pkts_cp; /* No return parameter(s) */ #define HCI_OCF_READ_LINK_SUPERVISION_TIMEOUT 0x0036 #define HCI_CMD_READ_LINK_SUPERVISION_TIMEOUT 0x0C36 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_link_supervision_timeout_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t timeout; /* Link supervision timeout * 0.625 msec */ } __packed hci_read_link_supervision_timeout_rp; #define HCI_OCF_WRITE_LINK_SUPERVISION_TIMEOUT 0x0037 #define HCI_CMD_WRITE_LINK_SUPERVISION_TIMEOUT 0x0C37 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t timeout; /* Link supervision timeout * 0.625 msec */ } __packed hci_write_link_supervision_timeout_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_write_link_supervision_timeout_rp; #define HCI_OCF_READ_NUM_SUPPORTED_IAC 0x0038 #define HCI_CMD_READ_NUM_SUPPORTED_IAC 0x0C38 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t num_iac; /* # of supported IAC during scan */ } __packed hci_read_num_supported_iac_rp; #define HCI_OCF_READ_IAC_LAP 0x0039 #define HCI_CMD_READ_IAC_LAP 0x0C39 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t num_iac; /* # of IAC */ /* these are repeated "num_iac" times uint8_t laps[HCI_LAP_SIZE]; --- LAPs */ } __packed hci_read_iac_lap_rp; #define HCI_OCF_WRITE_IAC_LAP 0x003a #define HCI_CMD_WRITE_IAC_LAP 0x0C3A typedef struct { uint8_t num_iac; /* # of IAC */ /* these are repeated "num_iac" times uint8_t laps[HCI_LAP_SIZE]; --- LAPs */ } __packed hci_write_iac_lap_cp; typedef hci_status_rp hci_write_iac_lap_rp; /* Read Page Scan Period Mode is deprecated */ #define HCI_OCF_READ_PAGE_SCAN_PERIOD 0x003b #define HCI_CMD_READ_PAGE_SCAN_PERIOD 0x0C3B /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t page_scan_period_mode; /* Page scan period mode */ } __packed hci_read_page_scan_period_rp; /* Write Page Scan Period Mode is deprecated */ #define HCI_OCF_WRITE_PAGE_SCAN_PERIOD 0x003c #define HCI_CMD_WRITE_PAGE_SCAN_PERIOD 0x0C3C typedef struct { uint8_t page_scan_period_mode; /* Page scan period mode */ } __packed hci_write_page_scan_period_cp; typedef hci_status_rp hci_write_page_scan_period_rp; /* Read Page Scan Mode is deprecated */ #define HCI_OCF_READ_PAGE_SCAN 0x003d #define HCI_CMD_READ_PAGE_SCAN 0x0C3D /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t page_scan_mode; /* Page scan mode */ } __packed hci_read_page_scan_rp; /* Write Page Scan Mode is deprecated */ #define HCI_OCF_WRITE_PAGE_SCAN 0x003e #define HCI_CMD_WRITE_PAGE_SCAN 0x0C3E typedef struct { uint8_t page_scan_mode; /* Page scan mode */ } __packed hci_write_page_scan_cp; typedef hci_status_rp hci_write_page_scan_rp; #define HCI_OCF_SET_AFH_CLASSIFICATION 0x003f #define HCI_CMD_SET_AFH_CLASSIFICATION 0x0C3F typedef struct { uint8_t classification[10]; } __packed hci_set_afh_classification_cp; typedef hci_status_rp hci_set_afh_classification_rp; #define HCI_OCF_READ_INQUIRY_SCAN_TYPE 0x0042 #define HCI_CMD_READ_INQUIRY_SCAN_TYPE 0x0C42 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t type; /* inquiry scan type */ } __packed hci_read_inquiry_scan_type_rp; #define HCI_OCF_WRITE_INQUIRY_SCAN_TYPE 0x0043 #define HCI_CMD_WRITE_INQUIRY_SCAN_TYPE 0x0C43 typedef struct { uint8_t type; /* inquiry scan type */ } __packed hci_write_inquiry_scan_type_cp; typedef hci_status_rp hci_write_inquiry_scan_type_rp; #define HCI_OCF_READ_INQUIRY_MODE 0x0044 #define HCI_CMD_READ_INQUIRY_MODE 0x0C44 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t mode; /* inquiry mode */ } __packed hci_read_inquiry_mode_rp; #define HCI_OCF_WRITE_INQUIRY_MODE 0x0045 #define HCI_CMD_WRITE_INQUIRY_MODE 0x0C45 typedef struct { uint8_t mode; /* inquiry mode */ } __packed hci_write_inquiry_mode_cp; typedef hci_status_rp hci_write_inquiry_mode_rp; #define HCI_OCF_READ_PAGE_SCAN_TYPE 0x0046 #define HCI_CMD_READ_PAGE_SCAN_TYPE 0x0C46 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t type; /* page scan type */ } __packed hci_read_page_scan_type_rp; #define HCI_OCF_WRITE_PAGE_SCAN_TYPE 0x0047 #define HCI_CMD_WRITE_PAGE_SCAN_TYPE 0x0C47 typedef struct { uint8_t type; /* page scan type */ } __packed hci_write_page_scan_type_cp; typedef hci_status_rp hci_write_page_scan_type_rp; #define HCI_OCF_READ_AFH_ASSESSMENT 0x0048 #define HCI_CMD_READ_AFH_ASSESSMENT 0x0C48 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t mode; /* assessment mode */ } __packed hci_read_afh_assessment_rp; #define HCI_OCF_WRITE_AFH_ASSESSMENT 0x0049 #define HCI_CMD_WRITE_AFH_ASSESSMENT 0x0C49 typedef struct { uint8_t mode; /* assessment mode */ } __packed hci_write_afh_assessment_cp; typedef hci_status_rp hci_write_afh_assessment_rp; #define HCI_OCF_READ_EXTENDED_INQUIRY_RSP 0x0051 #define HCI_CMD_READ_EXTENDED_INQUIRY_RSP 0x0C51 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t fec_required; uint8_t response[240]; } __packed hci_read_extended_inquiry_rsp_rp; #define HCI_OCF_WRITE_EXTENDED_INQUIRY_RSP 0x0052 #define HCI_CMD_WRITE_EXTENDED_INQUIRY_RSP 0x0C52 typedef struct { uint8_t fec_required; uint8_t response[240]; } __packed hci_write_extended_inquiry_rsp_cp; typedef hci_status_rp hci_write_extended_inquiry_rsp_rp; #define HCI_OCF_REFRESH_ENCRYPTION_KEY 0x0053 #define HCI_CMD_REFRESH_ENCRYPTION_KEY 0x0C53 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_refresh_encryption_key_cp; typedef hci_status_rp hci_refresh_encryption_key_rp; #define HCI_OCF_READ_SIMPLE_PAIRING_MODE 0x0055 #define HCI_CMD_READ_SIMPLE_PAIRING_MODE 0x0C55 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t mode; /* simple pairing mode */ } __packed hci_read_simple_pairing_mode_rp; #define HCI_OCF_WRITE_SIMPLE_PAIRING_MODE 0x0056 #define HCI_CMD_WRITE_SIMPLE_PAIRING_MODE 0x0C56 typedef struct { uint8_t mode; /* simple pairing mode */ } __packed hci_write_simple_pairing_mode_cp; typedef hci_status_rp hci_write_simple_pairing_mode_rp; #define HCI_OCF_READ_LOCAL_OOB_DATA 0x0057 #define HCI_CMD_READ_LOCAL_OOB_DATA 0x0C57 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t c[16]; /* pairing hash */ uint8_t r[16]; /* pairing randomizer */ } __packed hci_read_local_oob_data_rp; #define HCI_OCF_READ_INQUIRY_RSP_XMIT_POWER 0x0058 #define HCI_CMD_READ_INQUIRY_RSP_XMIT_POWER 0x0C58 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ int8_t power; /* TX power */ } __packed hci_read_inquiry_rsp_xmit_power_rp; #define HCI_OCF_WRITE_INQUIRY_RSP_XMIT_POWER 0x0059 #define HCI_CMD_WRITE_INQUIRY_RSP_XMIT_POWER 0x0C59 typedef struct { int8_t power; /* TX power */ } __packed hci_write_inquiry_rsp_xmit_power_cp; typedef hci_status_rp hci_write_inquiry_rsp_xmit_power_rp; #define HCI_OCF_READ_DEFAULT_ERRDATA_REPORTING 0x005A #define HCI_CMD_READ_DEFAULT_ERRDATA_REPORTING 0x0C5A /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t reporting; /* erroneous data reporting */ } __packed hci_read_default_errdata_reporting_rp; #define HCI_OCF_WRITE_DEFAULT_ERRDATA_REPORTING 0x005B #define HCI_CMD_WRITE_DEFAULT_ERRDATA_REPORTING 0x0C5B typedef struct { uint8_t reporting; /* erroneous data reporting */ } __packed hci_write_default_errdata_reporting_cp; typedef hci_status_rp hci_write_default_errdata_reporting_rp; #define HCI_OCF_ENHANCED_FLUSH 0x005F #define HCI_CMD_ENHANCED_FLUSH 0x0C5F typedef struct { uint16_t con_handle; /* connection handle */ uint8_t packet_type; } __packed hci_enhanced_flush_cp; /* No response parameter(s) */ #define HCI_OCF_SEND_KEYPRESS_NOTIFICATION 0x0060 #define HCI_CMD_SEND_KEYPRESS_NOTIFICATION 0x0C60 typedef struct { bdaddr_t bdaddr; /* remote address */ uint8_t type; /* notification type */ } __packed hci_send_keypress_notification_cp; typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote address */ } __packed hci_send_keypress_notification_rp; /************************************************************************** ************************************************************************** ** OGF 0x04 Informational commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_INFO 0x04 #define HCI_OCF_READ_LOCAL_VER 0x0001 #define HCI_CMD_READ_LOCAL_VER 0x1001 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t hci_version; /* HCI version */ uint16_t hci_revision; /* HCI revision */ uint8_t lmp_version; /* LMP version */ uint16_t manufacturer; /* Hardware manufacturer name */ uint16_t lmp_subversion; /* LMP sub-version */ } __packed hci_read_local_ver_rp; #define HCI_OCF_READ_LOCAL_COMMANDS 0x0002 #define HCI_CMD_READ_LOCAL_COMMANDS 0x1002 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t commands[HCI_COMMANDS_SIZE]; /* opcode bitmask */ } __packed hci_read_local_commands_rp; #define HCI_OCF_READ_LOCAL_FEATURES 0x0003 #define HCI_CMD_READ_LOCAL_FEATURES 0x1003 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t features[HCI_FEATURES_SIZE]; /* LMP features bitmsk*/ } __packed hci_read_local_features_rp; #define HCI_OCF_READ_LOCAL_EXTENDED_FEATURES 0x0004 #define HCI_CMD_READ_LOCAL_EXTENDED_FEATURES 0x1004 typedef struct { uint8_t page; /* page number */ } __packed hci_read_local_extended_features_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint8_t page; /* page number */ uint8_t max_page; /* maximum page number */ uint8_t features[HCI_FEATURES_SIZE]; /* LMP features */ } __packed hci_read_local_extended_features_rp; #define HCI_OCF_READ_BUFFER_SIZE 0x0005 #define HCI_CMD_READ_BUFFER_SIZE 0x1005 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint16_t max_acl_size; /* Max. size of ACL packet (bytes) */ uint8_t max_sco_size; /* Max. size of SCO packet (bytes) */ uint16_t num_acl_pkts; /* Max. number of ACL packets */ uint16_t num_sco_pkts; /* Max. number of SCO packets */ } __packed hci_read_buffer_size_rp; /* Read Country Code is deprecated */ #define HCI_OCF_READ_COUNTRY_CODE 0x0007 #define HCI_CMD_READ_COUNTRY_CODE 0x1007 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t country_code; /* 0x00 - NAM, EUR, JP; 0x01 - France */ } __packed hci_read_country_code_rp; #define HCI_OCF_READ_BDADDR 0x0009 #define HCI_CMD_READ_BDADDR 0x1009 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* unit address */ } __packed hci_read_bdaddr_rp; /************************************************************************** ************************************************************************** ** OGF 0x05 Status commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_STATUS 0x05 #define HCI_OCF_READ_FAILED_CONTACT_CNTR 0x0001 #define HCI_CMD_READ_FAILED_CONTACT_CNTR 0x1401 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_failed_contact_cntr_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t counter; /* number of consecutive failed contacts */ } __packed hci_read_failed_contact_cntr_rp; #define HCI_OCF_RESET_FAILED_CONTACT_CNTR 0x0002 #define HCI_CMD_RESET_FAILED_CONTACT_CNTR 0x1402 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_reset_failed_contact_cntr_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_reset_failed_contact_cntr_rp; #define HCI_OCF_READ_LINK_QUALITY 0x0003 #define HCI_CMD_READ_LINK_QUALITY 0x1403 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_link_quality_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t quality; /* higher value means better quality */ } __packed hci_read_link_quality_rp; #define HCI_OCF_READ_RSSI 0x0005 #define HCI_CMD_READ_RSSI 0x1405 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_rssi_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ char rssi; /* -127 <= rssi <= 127 dB */ } __packed hci_read_rssi_rp; #define HCI_OCF_READ_AFH_CHANNEL_MAP 0x0006 #define HCI_CMD_READ_AFH_CHANNEL_MAP 0x1406 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_afh_channel_map_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t mode; /* AFH mode */ uint8_t map[10]; /* AFH Channel Map */ } __packed hci_read_afh_channel_map_rp; #define HCI_OCF_READ_CLOCK 0x0007 #define HCI_CMD_READ_CLOCK 0x1407 typedef struct { uint16_t con_handle; /* connection handle */ uint8_t clock; /* which clock */ } __packed hci_read_clock_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint32_t clock; /* clock value */ uint16_t accuracy; /* clock accuracy */ } __packed hci_read_clock_rp; #define HCI_OCF_READ_ENCRYPTION_KEY_SIZE 0x0008 #define HCI_CMD_READ_ENCRYPTION_KEY_SIZE 0x1408 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_read_encryption_key_size_cp; typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t size; /* key size */ } __packed hci_read_encryption_key_size_rp; /************************************************************************** ************************************************************************** ** OGF 0x06 Testing commands and return parameters ************************************************************************** **************************************************************************/ #define HCI_OGF_TESTING 0x06 #define HCI_OCF_READ_LOOPBACK_MODE 0x0001 #define HCI_CMD_READ_LOOPBACK_MODE 0x1801 /* No command parameter(s) */ typedef struct { uint8_t status; /* 0x00 - success */ uint8_t lbmode; /* loopback mode */ } __packed hci_read_loopback_mode_rp; #define HCI_OCF_WRITE_LOOPBACK_MODE 0x0002 #define HCI_CMD_WRITE_LOOPBACK_MODE 0x1802 typedef struct { uint8_t lbmode; /* loopback mode */ } __packed hci_write_loopback_mode_cp; typedef hci_status_rp hci_write_loopback_mode_rp; #define HCI_OCF_ENABLE_UNIT_UNDER_TEST 0x0003 #define HCI_CMD_ENABLE_UNIT_UNDER_TEST 0x1803 /* No command parameter(s) */ typedef hci_status_rp hci_enable_unit_under_test_rp; #define HCI_OCF_WRITE_SIMPLE_PAIRING_DEBUG_MODE 0x0004 #define HCI_CMD_WRITE_SIMPLE_PAIRING_DEBUG_MODE 0x1804 typedef struct { uint8_t mode; /* simple pairing debug mode */ } __packed hci_write_simple_pairing_debug_mode_cp; typedef hci_status_rp hci_write_simple_pairing_debug_mode_rp; /************************************************************************** ************************************************************************** ** OGF 0x3e Bluetooth Logo Testing ** OGF 0x3f Vendor Specific ************************************************************************** **************************************************************************/ #define HCI_OGF_BT_LOGO 0x3e #define HCI_OGF_VENDOR 0x3f /* Ericsson specific FC */ #define HCI_CMD_ERICSSON_WRITE_PCM_SETTINGS 0xFC07 #define HCI_CMD_ERICSSON_SET_UART_BAUD_RATE 0xFC09 #define HCI_CMD_ERICSSON_SET_SCO_DATA_PATH 0xFC1D /* Cambridge Silicon Radio specific FC */ #define HCI_CMD_CSR_EXTN 0xFC00 /************************************************************************** ************************************************************************** ** Events and event parameters ************************************************************************** **************************************************************************/ #define HCI_EVENT_INQUIRY_COMPL 0x01 typedef struct { uint8_t status; /* 0x00 - success */ } __packed hci_inquiry_compl_ep; #define HCI_EVENT_INQUIRY_RESULT 0x02 typedef struct { uint8_t num_responses; /* number of responses */ /* hci_inquiry_response[num_responses] -- see below */ } __packed hci_inquiry_result_ep; typedef struct { bdaddr_t bdaddr; /* unit address */ uint8_t page_scan_rep_mode; /* page scan rep. mode */ uint8_t page_scan_period_mode; /* page scan period mode */ uint8_t page_scan_mode; /* page scan mode */ uint8_t uclass[HCI_CLASS_SIZE]; /* unit class */ uint16_t clock_offset; /* clock offset */ } __packed hci_inquiry_response; #define HCI_EVENT_CON_COMPL 0x03 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ bdaddr_t bdaddr; /* remote unit address */ uint8_t link_type; /* Link type */ uint8_t encryption_mode; /* Encryption mode */ } __packed hci_con_compl_ep; #define HCI_EVENT_CON_REQ 0x04 typedef struct { bdaddr_t bdaddr; /* remote unit address */ uint8_t uclass[HCI_CLASS_SIZE]; /* remote unit class */ uint8_t link_type; /* link type */ } __packed hci_con_req_ep; #define HCI_EVENT_DISCON_COMPL 0x05 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t reason; /* reason to disconnect */ } __packed hci_discon_compl_ep; #define HCI_EVENT_AUTH_COMPL 0x06 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_auth_compl_ep; #define HCI_EVENT_REMOTE_NAME_REQ_COMPL 0x07 typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote unit address */ char name[HCI_UNIT_NAME_SIZE]; /* remote unit name */ } __packed hci_remote_name_req_compl_ep; #define HCI_EVENT_ENCRYPTION_CHANGE 0x08 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ uint8_t encryption_enable; /* 0x00 - disable */ } __packed hci_encryption_change_ep; #define HCI_EVENT_CHANGE_CON_LINK_KEY_COMPL 0x09 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ } __packed hci_change_con_link_key_compl_ep; #define HCI_EVENT_MASTER_LINK_KEY_COMPL 0x0a typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ uint8_t key_flag; /* Key flag */ } __packed hci_master_link_key_compl_ep; #define HCI_EVENT_READ_REMOTE_FEATURES_COMPL 0x0b typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ uint8_t features[HCI_FEATURES_SIZE]; /* LMP features bitmsk*/ } __packed hci_read_remote_features_compl_ep; #define HCI_EVENT_READ_REMOTE_VER_INFO_COMPL 0x0c typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ uint8_t lmp_version; /* LMP version */ uint16_t manufacturer; /* Hardware manufacturer name */ uint16_t lmp_subversion; /* LMP sub-version */ } __packed hci_read_remote_ver_info_compl_ep; #define HCI_EVENT_QOS_SETUP_COMPL 0x0d typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t flags; /* reserved for future use */ uint8_t service_type; /* service type */ uint32_t token_rate; /* bytes per second */ uint32_t peak_bandwidth; /* bytes per second */ uint32_t latency; /* microseconds */ uint32_t delay_variation; /* microseconds */ } __packed hci_qos_setup_compl_ep; #define HCI_EVENT_COMMAND_COMPL 0x0e typedef struct { uint8_t num_cmd_pkts; /* # of HCI command packets */ uint16_t opcode; /* command OpCode */ /* command return parameters (if any) */ } __packed hci_command_compl_ep; #define HCI_EVENT_COMMAND_STATUS 0x0f typedef struct { uint8_t status; /* 0x00 - pending */ uint8_t num_cmd_pkts; /* # of HCI command packets */ uint16_t opcode; /* command OpCode */ } __packed hci_command_status_ep; #define HCI_EVENT_HARDWARE_ERROR 0x10 typedef struct { uint8_t hardware_code; /* hardware error code */ } __packed hci_hardware_error_ep; #define HCI_EVENT_FLUSH_OCCUR 0x11 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_flush_occur_ep; #define HCI_EVENT_ROLE_CHANGE 0x12 typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* address of remote unit */ uint8_t role; /* new connection role */ } __packed hci_role_change_ep; #define HCI_EVENT_NUM_COMPL_PKTS 0x13 typedef struct { uint8_t num_con_handles; /* # of connection handles */ /* these are repeated "num_con_handles" times uint16_t con_handle; --- connection handle(s) uint16_t compl_pkts; --- # of completed packets */ } __packed hci_num_compl_pkts_ep; #define HCI_EVENT_MODE_CHANGE 0x14 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t unit_mode; /* remote unit mode */ uint16_t interval; /* interval * 0.625 msec */ } __packed hci_mode_change_ep; #define HCI_EVENT_RETURN_LINK_KEYS 0x15 typedef struct { uint8_t num_keys; /* # of keys */ /* these are repeated "num_keys" times bdaddr_t bdaddr; --- remote address(es) uint8_t key[HCI_KEY_SIZE]; --- key(s) */ } __packed hci_return_link_keys_ep; #define HCI_EVENT_PIN_CODE_REQ 0x16 typedef struct { bdaddr_t bdaddr; /* remote unit address */ } __packed hci_pin_code_req_ep; #define HCI_EVENT_LINK_KEY_REQ 0x17 typedef struct { bdaddr_t bdaddr; /* remote unit address */ } __packed hci_link_key_req_ep; #define HCI_EVENT_LINK_KEY_NOTIFICATION 0x18 typedef struct { bdaddr_t bdaddr; /* remote unit address */ uint8_t key[HCI_KEY_SIZE]; /* link key */ uint8_t key_type; /* type of the key */ } __packed hci_link_key_notification_ep; #define HCI_EVENT_LOOPBACK_COMMAND 0x19 typedef hci_cmd_hdr_t hci_loopback_command_ep; #define HCI_EVENT_DATA_BUFFER_OVERFLOW 0x1a typedef struct { uint8_t link_type; /* Link type */ } __packed hci_data_buffer_overflow_ep; #define HCI_EVENT_MAX_SLOT_CHANGE 0x1b typedef struct { uint16_t con_handle; /* connection handle */ uint8_t lmp_max_slots; /* Max. # of slots allowed */ } __packed hci_max_slot_change_ep; #define HCI_EVENT_READ_CLOCK_OFFSET_COMPL 0x1c typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* Connection handle */ uint16_t clock_offset; /* Clock offset */ } __packed hci_read_clock_offset_compl_ep; #define HCI_EVENT_CON_PKT_TYPE_CHANGED 0x1d typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t pkt_type; /* packet type */ } __packed hci_con_pkt_type_changed_ep; #define HCI_EVENT_QOS_VIOLATION 0x1e typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_qos_violation_ep; /* Page Scan Mode Change Event is deprecated */ #define HCI_EVENT_PAGE_SCAN_MODE_CHANGE 0x1f typedef struct { bdaddr_t bdaddr; /* destination address */ uint8_t page_scan_mode; /* page scan mode */ } __packed hci_page_scan_mode_change_ep; #define HCI_EVENT_PAGE_SCAN_REP_MODE_CHANGE 0x20 typedef struct { bdaddr_t bdaddr; /* destination address */ uint8_t page_scan_rep_mode; /* page scan repetition mode */ } __packed hci_page_scan_rep_mode_change_ep; #define HCI_EVENT_FLOW_SPECIFICATION_COMPL 0x21 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t flags; /* reserved */ uint8_t direction; /* flow direction */ uint8_t type; /* service type */ uint32_t token_rate; /* token rate */ uint32_t bucket_size; /* token bucket size */ uint32_t peak_bandwidth; /* peak bandwidth */ uint32_t latency; /* access latency */ } __packed hci_flow_specification_compl_ep; #define HCI_EVENT_RSSI_RESULT 0x22 typedef struct { uint8_t num_responses; /* number of responses */ /* hci_rssi_response[num_responses] -- see below */ } __packed hci_rssi_result_ep; typedef struct { bdaddr_t bdaddr; /* unit address */ uint8_t page_scan_rep_mode; /* page scan rep. mode */ uint8_t blank; /* reserved */ uint8_t uclass[HCI_CLASS_SIZE]; /* unit class */ uint16_t clock_offset; /* clock offset */ int8_t rssi; /* rssi */ } __packed hci_rssi_response; #define HCI_EVENT_READ_REMOTE_EXTENDED_FEATURES 0x23 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t page; /* page number */ uint8_t max; /* max page number */ uint8_t features[HCI_FEATURES_SIZE]; /* LMP features bitmsk*/ } __packed hci_read_remote_extended_features_ep; #define HCI_EVENT_SCO_CON_COMPL 0x2c typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ bdaddr_t bdaddr; /* unit address */ uint8_t link_type; /* link type */ uint8_t interval; /* transmission interval */ uint8_t window; /* retransmission window */ uint16_t rxlen; /* rx packet length */ uint16_t txlen; /* tx packet length */ uint8_t mode; /* air mode */ } __packed hci_sco_con_compl_ep; #define HCI_EVENT_SCO_CON_CHANGED 0x2d typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint8_t interval; /* transmission interval */ uint8_t window; /* retransmission window */ uint16_t rxlen; /* rx packet length */ uint16_t txlen; /* tx packet length */ } __packed hci_sco_con_changed_ep; #define HCI_EVENT_SNIFF_SUBRATING 0x2e typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ uint16_t tx_latency; /* max transmit latency */ uint16_t rx_latency; /* max receive latency */ uint16_t remote_timeout; /* remote timeout */ uint16_t local_timeout; /* local timeout */ } __packed hci_sniff_subrating_ep; #define HCI_EVENT_EXTENDED_RESULT 0x2f typedef struct { uint8_t num_responses; /* must be 0x01 */ bdaddr_t bdaddr; /* remote device address */ uint8_t page_scan_rep_mode; uint8_t reserved; uint8_t uclass[HCI_CLASS_SIZE]; uint16_t clock_offset; int8_t rssi; uint8_t response[240]; /* extended inquiry response */ } __packed hci_extended_result_ep; #define HCI_EVENT_ENCRYPTION_KEY_REFRESH 0x30 typedef struct { uint8_t status; /* 0x00 - success */ uint16_t con_handle; /* connection handle */ } __packed hci_encryption_key_refresh_ep; #define HCI_EVENT_IO_CAPABILITY_REQ 0x31 typedef struct { bdaddr_t bdaddr; /* remote device address */ } __packed hci_io_capability_req_ep; #define HCI_EVENT_IO_CAPABILITY_RSP 0x32 typedef struct { bdaddr_t bdaddr; /* remote device address */ uint8_t io_capability; uint8_t oob_data_present; uint8_t auth_requirement; } __packed hci_io_capability_rsp_ep; #define HCI_EVENT_USER_CONFIRM_REQ 0x33 typedef struct { bdaddr_t bdaddr; /* remote device address */ uint32_t value; /* 000000 - 999999 */ } __packed hci_user_confirm_req_ep; #define HCI_EVENT_USER_PASSKEY_REQ 0x34 typedef struct { bdaddr_t bdaddr; /* remote device address */ } __packed hci_user_passkey_req_ep; #define HCI_EVENT_REMOTE_OOB_DATA_REQ 0x35 typedef struct { bdaddr_t bdaddr; /* remote device address */ } __packed hci_remote_oob_data_req_ep; #define HCI_EVENT_SIMPLE_PAIRING_COMPL 0x36 typedef struct { uint8_t status; /* 0x00 - success */ bdaddr_t bdaddr; /* remote device address */ } __packed hci_simple_pairing_compl_ep; #define HCI_EVENT_LINK_SUPERVISION_TO_CHANGED 0x38 typedef struct { uint16_t con_handle; /* connection handle */ uint16_t timeout; /* link supervision timeout */ } __packed hci_link_supervision_to_changed_ep; #define HCI_EVENT_ENHANCED_FLUSH_COMPL 0x39 typedef struct { uint16_t con_handle; /* connection handle */ } __packed hci_enhanced_flush_compl_ep; #define HCI_EVENT_USER_PASSKEY_NOTIFICATION 0x3b typedef struct { bdaddr_t bdaddr; /* remote device address */ uint32_t value; /* 000000 - 999999 */ } __packed hci_user_passkey_notification_ep; #define HCI_EVENT_KEYPRESS_NOTIFICATION 0x3c typedef struct { bdaddr_t bdaddr; /* remote device address */ uint8_t notification_type; } __packed hci_keypress_notification_ep; #define HCI_EVENT_REMOTE_FEATURES_NOTIFICATION 0x3d typedef struct { bdaddr_t bdaddr; /* remote device address */ uint8_t features[HCI_FEATURES_SIZE]; /* LMP features bitmsk*/ } __packed hci_remote_features_notification_ep; #define HCI_EVENT_BT_LOGO 0xfe #define HCI_EVENT_VENDOR 0xff /************************************************************************** ************************************************************************** ** HCI Socket Definitions ************************************************************************** **************************************************************************/ /* HCI socket options */ #define SO_HCI_EVT_FILTER 1 /* get/set event filter */ #define SO_HCI_PKT_FILTER 2 /* get/set packet filter */ #define SO_HCI_DIRECTION 3 /* packet direction indicator */ /* Control Messages */ #define SCM_HCI_DIRECTION SO_HCI_DIRECTION /* * HCI socket filter and get/set routines * * for ease of use, we filter 256 possible events/packets */ struct hci_filter { uint32_t mask[8]; /* 256 bits */ }; static __inline void hci_filter_set(uint8_t bit, struct hci_filter *filter) { uint8_t off = (uint8_t)((bit - 1) >> 5); uint8_t sh = (uint8_t)((bit - 1) & 0x1f); filter->mask[off] |= 1U << sh; } static __inline void hci_filter_clr(uint8_t bit, struct hci_filter *filter) { uint8_t off = (uint8_t)((bit - 1) >> 5); uint8_t sh = (uint8_t)((bit - 1) & 0x1f); filter->mask[off] &= ~(1U << sh); } static __inline int hci_filter_test(uint8_t bit, const struct hci_filter *filter) { uint8_t off = (uint8_t)((bit - 1) >> 5); uint8_t sh = (uint8_t)((bit - 1) & 0x1f); return (int)((filter->mask[off] >> sh) & 1U); } /* * HCI socket ioctl's * * Apart from GBTINFOA, these are all indexed on the unit name */ #define SIOCGBTINFO _IOWR('b', 5, struct btreq) /* get unit info */ #define SIOCGBTINFOA _IOWR('b', 6, struct btreq) /* get info by address */ #define SIOCNBTINFO _IOWR('b', 7, struct btreq) /* next unit info */ #define SIOCSBTFLAGS _IOWR('b', 8, struct btreq) /* set unit flags */ #define SIOCSBTPOLICY _IOWR('b', 9, struct btreq) /* set unit link policy */ #define SIOCSBTPTYPE _IOWR('b', 10, struct btreq) /* set unit packet type */ #define SIOCGBTSTATS _IOWR('b', 11, struct btreq) /* get unit statistics */ #define SIOCZBTSTATS _IOWR('b', 12, struct btreq) /* zero unit statistics */ #define SIOCBTDUMP _IOW('b', 13, struct btreq) /* print debug info */ #define SIOCSBTSCOMTU _IOWR('b', 17, struct btreq) /* set sco_mtu value */ #define SIOCGBTFEAT _IOWR('b', 18, struct btreq) /* get unit features */ struct bt_stats { uint32_t err_tx; uint32_t err_rx; uint32_t cmd_tx; uint32_t evt_rx; uint32_t acl_tx; uint32_t acl_rx; uint32_t sco_tx; uint32_t sco_rx; uint32_t byte_tx; uint32_t byte_rx; }; struct btreq { char btr_name[HCI_DEVNAME_SIZE]; /* device name */ union { struct { bdaddr_t btri_bdaddr; /* device bdaddr */ uint16_t btri_flags; /* flags */ uint16_t btri_num_cmd; /* # of free cmd buffers */ uint16_t btri_num_acl; /* # of free ACL buffers */ uint16_t btri_num_sco; /* # of free SCO buffers */ uint16_t btri_acl_mtu; /* ACL mtu */ uint16_t btri_sco_mtu; /* SCO mtu */ uint16_t btri_link_policy; /* Link Policy */ uint16_t btri_packet_type; /* Packet Type */ uint16_t btri_max_acl; /* max ACL buffers */ uint16_t btri_max_sco; /* max SCO buffers */ } btri; struct { uint8_t btrf_page0[HCI_FEATURES_SIZE]; /* basic */ uint8_t btrf_page1[HCI_FEATURES_SIZE]; /* extended */ uint8_t btrf_page2[HCI_FEATURES_SIZE]; /* extended */ } btrf; struct bt_stats btrs; /* unit stats */ } btru; }; #define btr_flags btru.btri.btri_flags #define btr_bdaddr btru.btri.btri_bdaddr #define btr_num_cmd btru.btri.btri_num_cmd #define btr_num_acl btru.btri.btri_num_acl #define btr_num_sco btru.btri.btri_num_sco #define btr_acl_mtu btru.btri.btri_acl_mtu #define btr_sco_mtu btru.btri.btri_sco_mtu #define btr_link_policy btru.btri.btri_link_policy #define btr_packet_type btru.btri.btri_packet_type #define btr_max_acl btru.btri.btri_max_acl #define btr_max_sco btru.btri.btri_max_sco #define btr_features0 btru.btrf.btrf_page0 #define btr_features1 btru.btrf.btrf_page1 #define btr_features2 btru.btrf.btrf_page2 #define btr_stats btru.btrs /* hci_unit & btr_flags */ #define BTF_UP (1<<0) /* unit is up */ #define BTF_RUNNING (1<<1) /* unit is running */ #define BTF_XMIT_CMD (1<<2) /* unit is transmitting CMD packets */ #define BTF_XMIT_ACL (1<<3) /* unit is transmitting ACL packets */ #define BTF_XMIT_SCO (1<<4) /* unit is transmitting SCO packets */ #define BTF_XMIT (BTF_XMIT_CMD | BTF_XMIT_ACL | BTF_XMIT_SCO) #define BTF_INIT_BDADDR (1<<5) /* waiting for bdaddr */ #define BTF_INIT_BUFFER_SIZE (1<<6) /* waiting for buffer size */ #define BTF_INIT_FEATURES (1<<7) /* waiting for features */ #define BTF_POWER_UP_NOOP (1<<8) /* should wait for No-op on power up */ #define BTF_INIT_COMMANDS (1<<9) /* waiting for supported commands */ #define BTF_MASTER (1<<10) /* request Master role */ #define BTF_INIT (BTF_INIT_BDADDR \ | BTF_INIT_BUFFER_SIZE \ | BTF_INIT_FEATURES \ | BTF_INIT_COMMANDS) /************************************************************************** ************************************************************************** ** HCI Kernel Definitions ************************************************************************** **************************************************************************/ #ifdef _KERNEL #include #include struct l2cap_channel; struct mbuf; struct sco_pcb; struct socket; struct sockopt; /* global HCI kernel variables */ /* sysctl variables */ extern int hci_memo_expiry; extern int hci_acl_expiry; extern int hci_sendspace, hci_recvspace; extern int hci_eventq_max, hci_aclrxq_max, hci_scorxq_max; /* * HCI Connection Information */ struct hci_link { struct hci_unit *hl_unit; /* our unit */ TAILQ_ENTRY(hci_link) hl_next; /* next link on unit */ /* common info */ uint16_t hl_state; /* connection state */ uint16_t hl_flags; /* link flags */ bdaddr_t hl_bdaddr; /* dest address */ uint16_t hl_handle; /* connection handle */ uint8_t hl_type; /* link type */ /* ACL link info */ uint8_t hl_lastid; /* last id used */ uint16_t hl_refcnt; /* reference count */ uint16_t hl_mtu; /* signalling mtu for link */ uint16_t hl_flush; /* flush timeout */ uint16_t hl_clock; /* remote clock offset */ TAILQ_HEAD(,l2cap_pdu) hl_txq; /* queue of outgoing PDUs */ int hl_txqlen; /* number of fragments */ struct mbuf *hl_rxp; /* incoming PDU (accumulating)*/ callout_t hl_expire; /* connection expiry timer */ TAILQ_HEAD(,l2cap_req) hl_reqs; /* pending requests */ /* SCO link info */ struct hci_link *hl_link; /* SCO ACL link */ struct sco_pcb *hl_sco; /* SCO pcb */ MBUFQ_HEAD() hl_data; /* SCO outgoing data */ }; /* hci_link state */ #define HCI_LINK_CLOSED 0 /* closed */ #define HCI_LINK_WAIT_CONNECT 1 /* waiting to connect */ #define HCI_LINK_WAIT_AUTH 2 /* waiting for auth */ #define HCI_LINK_WAIT_ENCRYPT 3 /* waiting for encrypt */ #define HCI_LINK_WAIT_SECURE 4 /* waiting for secure */ #define HCI_LINK_OPEN 5 /* ready and willing */ #define HCI_LINK_BLOCK 6 /* open but blocking (see hci_acl_start) */ /* hci_link flags */ #define HCI_LINK_AUTH_REQ (1<<0) /* authentication requested */ #define HCI_LINK_ENCRYPT_REQ (1<<1) /* encryption requested */ #define HCI_LINK_SECURE_REQ (1<<2) /* secure link requested */ #define HCI_LINK_AUTH (1<<3) /* link is authenticated */ #define HCI_LINK_ENCRYPT (1<<4) /* link is encrypted */ #define HCI_LINK_SECURE (1<<5) /* link is secured */ #define HCI_LINK_CREATE_CON (1<<6) /* "Create Connection" pending */ /* * Bluetooth Memo * cached device information for remote devices that this unit has seen */ struct hci_memo { struct timeval time; /* time of last response */ bdaddr_t bdaddr; uint8_t page_scan_rep_mode; uint8_t page_scan_mode; uint16_t clock_offset; LIST_ENTRY(hci_memo) next; }; /* * The Bluetooth HCI interface attachment structure */ struct hci_if { int (*enable)(device_t); void (*disable)(device_t); void (*output_cmd)(device_t, struct mbuf *); void (*output_acl)(device_t, struct mbuf *); void (*output_sco)(device_t, struct mbuf *); void (*get_stats)(device_t, struct bt_stats *, int); int ipl; /* for locking */ }; /* * The Bluetooth HCI device unit structure */ struct hci_unit { device_t hci_dev; /* bthci handle */ device_t hci_bthub; /* bthub(4) handle */ const struct hci_if *hci_if; /* bthci driver interface */ /* device info */ bdaddr_t hci_bdaddr; /* device address */ uint16_t hci_flags; /* see BTF_ above */ kcondvar_t hci_init; /* sleep on this */ uint16_t hci_packet_type; /* packet types */ uint16_t hci_acl_mask; /* ACL packet capabilities */ uint16_t hci_sco_mask; /* SCO packet capabilities */ uint16_t hci_link_policy; /* link policy */ uint16_t hci_lmp_mask; /* link policy capabilities */ uint8_t hci_feat0[HCI_FEATURES_SIZE]; /* features mask */ uint8_t hci_feat1[HCI_FEATURES_SIZE]; /* extended page 1 */ uint8_t hci_feat2[HCI_FEATURES_SIZE]; /* extended page 2 */ uint8_t hci_cmds[HCI_COMMANDS_SIZE]; /* opcode bitmask */ /* flow control */ uint16_t hci_max_acl_size; /* ACL payload mtu */ uint16_t hci_num_acl_pkts; /* free ACL packet buffers */ uint16_t hci_max_acl_pkts; /* max ACL packet buffers */ uint8_t hci_num_cmd_pkts; /* free CMD packet buffers */ uint8_t hci_max_sco_size; /* SCO payload mtu */ uint16_t hci_num_sco_pkts; /* free SCO packet buffers */ uint16_t hci_max_sco_pkts; /* max SCO packet buffers */ TAILQ_HEAD(,hci_link) hci_links; /* list of ACL/SCO links */ LIST_HEAD(,hci_memo) hci_memos; /* cached memo list */ /* input queues */ void *hci_rxint; /* receive interrupt cookie */ kmutex_t hci_devlock; /* device queue lock */ MBUFQ_HEAD() hci_eventq; /* Event queue */ MBUFQ_HEAD() hci_aclrxq; /* ACL rx queue */ MBUFQ_HEAD() hci_scorxq; /* SCO rx queue */ uint16_t hci_eventqlen; /* Event queue length */ uint16_t hci_aclrxqlen; /* ACL rx queue length */ uint16_t hci_scorxqlen; /* SCO rx queue length */ /* output queues */ MBUFQ_HEAD() hci_cmdwait; /* pending commands */ MBUFQ_HEAD() hci_scodone; /* SCO done queue */ SIMPLEQ_ENTRY(hci_unit) hci_next; }; extern SIMPLEQ_HEAD(hci_unit_list, hci_unit) hci_unit_list; /* * HCI layer function prototypes */ /* hci_event.c */ void hci_event(struct mbuf *, struct hci_unit *); /* hci_ioctl.c */ int hci_ioctl_pcb(unsigned long, void *); /* hci_link.c */ struct hci_link *hci_acl_open(struct hci_unit *, bdaddr_t *); struct hci_link *hci_acl_newconn(struct hci_unit *, bdaddr_t *); void hci_acl_close(struct hci_link *, int); void hci_acl_timeout(void *); int hci_acl_setmode(struct hci_link *); void hci_acl_linkmode(struct hci_link *); void hci_acl_recv(struct mbuf *, struct hci_unit *); int hci_acl_send(struct mbuf *, struct hci_link *, struct l2cap_channel *); void hci_acl_start(struct hci_link *); void hci_acl_complete(struct hci_link *, int); struct hci_link *hci_sco_newconn(struct hci_unit *, bdaddr_t *); void hci_sco_recv(struct mbuf *, struct hci_unit *); void hci_sco_start(struct hci_link *); void hci_sco_complete(struct hci_link *, int); struct hci_link *hci_link_alloc(struct hci_unit *, bdaddr_t *, uint8_t); void hci_link_free(struct hci_link *, int); struct hci_link *hci_link_lookup_bdaddr(struct hci_unit *, bdaddr_t *, uint8_t); struct hci_link *hci_link_lookup_handle(struct hci_unit *, uint16_t); /* hci_misc.c */ int hci_route_lookup(bdaddr_t *, bdaddr_t *); struct hci_memo *hci_memo_find(struct hci_unit *, bdaddr_t *); struct hci_memo *hci_memo_new(struct hci_unit *, bdaddr_t *); void hci_memo_free(struct hci_memo *); /* hci_socket.c */ void hci_drop(void *); void hci_init(void); int hci_ctloutput(int, struct socket *, struct sockopt *); void hci_mtap(struct mbuf *, struct hci_unit *); /* hci_unit.c */ struct hci_unit *hci_attach_pcb(const struct hci_if *, device_t, uint16_t); void hci_detach_pcb(struct hci_unit *); int hci_enable(struct hci_unit *); void hci_disable(struct hci_unit *); struct hci_unit *hci_unit_lookup(const bdaddr_t *); int hci_send_cmd(struct hci_unit *, uint16_t, void *, uint8_t); void hci_num_cmds(struct hci_unit *, uint8_t); bool hci_input_event(struct hci_unit *, struct mbuf *); bool hci_input_acl(struct hci_unit *, struct mbuf *); bool hci_input_sco(struct hci_unit *, struct mbuf *); bool hci_complete_sco(struct hci_unit *, struct mbuf *); void hci_output_cmd(struct hci_unit *, struct mbuf *); void hci_output_acl(struct hci_unit *, struct mbuf *); void hci_output_sco(struct hci_unit *, struct mbuf *); #endif /* _KERNEL */ #endif /* _NETBT_HCI_H_ */