Bluetooth low energy - A beginning at least.
This was the start of support for low energy bluetooth support that I have not as yet completed. I'm committing this as it gives the hci defines for an impementation in NetBSD.
This commit is contained in:
nat
parent
b2b5b66905
commit
1a2ee0e952
|
|
@ -0,0 +1,368 @@
|
|||
/* $NetBSD: hci_le.h,v 1.1 2024/03/13 07:22:16 nat Exp $ */
|
||||
|
||||
/*-
|
||||
* Copyright (c) 2020 Nathanial Sloss <nathanialsloss@yahoo.com.au>
|
||||
* 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
|
||||
*/
|
||||
|
||||
#define HCI_ADVERT_DATA_SIZE 31 /* advertising data size */
|
||||
#define HCI_SCAN_DATA_SIZE 31 /* scan resp. data size */
|
||||
|
||||
/* LE Event masks */
|
||||
#define HCI_LE_EVMSK_ALL 0x000000000000001f
|
||||
#define HCI_LE_EVMSK_NONE 0x0000000000000000
|
||||
#define HCI_LE_EVMSK_CON_COMPL 0x0000000000000001
|
||||
#define HCI_LE_EVMSK_ADV_REPORT 0x0000000000000002
|
||||
#define HCI_LE_EVMSK_CON_UPDATE_COMPL 0x0000000000000004
|
||||
#define HCI_LE_EVMSK_READ_REMOTE_FEATURES_COMPL 0x0000000000000008
|
||||
#define HCI_LE_EVMSK_LONG_TERM_KEY_REQ 0x0000000000000010
|
||||
/* 0x0000000000000020 - 0x8000000000000000 - reserved for future use */
|
||||
|
||||
/**************************************************************************
|
||||
**************************************************************************
|
||||
** OGF 0x08 Bluetooth Low Energy (LE) Link commands
|
||||
**************************************************************************
|
||||
**************************************************************************/
|
||||
|
||||
#define HCI_OGF_LE 0x08
|
||||
|
||||
#define HCI_OCF_LE_SET_EVENT_MASK 0x0001
|
||||
#define HCI_CMD_LE_SET_EVENT_MASK 0x2001
|
||||
typedef struct {
|
||||
uint8_t event_mask[HCI_EVENT_MASK_SIZE]; /* event_mask */
|
||||
} __packed hci_le_set_event_mask_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_event_mask_rp;
|
||||
|
||||
#define HCI_OCF_LE_READ_BUFFER_SIZE 0x0002
|
||||
#define HCI_CMD_LE_READ_BUFFER_SIZE 0x2002
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t le_data_pktlen; /* buffer len*/
|
||||
uint8_t le_num_pkts; /* no. acl data packets */
|
||||
} __packed hci_le_read_buffer_size_rp;
|
||||
|
||||
#define HCI_OCF_LE_READ_LOCAL_FEATURES 0x0003
|
||||
#define HCI_CMD_LE_READ_LOCAL_FEATURES 0x2003
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint8_t features[HCI_FEATURES_SIZE]; /* le features */
|
||||
} __packed hci_le_read_local_features_rp;
|
||||
|
||||
#define HCI_OCF_LE_SET_RND_ADDR 0x0005
|
||||
#define HCI_CMD_LE_SET_RND_ADDR 0x2005
|
||||
typedef struct {
|
||||
bdaddr_t bdaddr; /* random local address */
|
||||
} __packed hci_le_set_rnd_addr_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_rnd_addr_rp;
|
||||
/* XXX NS Finish defines. */
|
||||
#define HCI_OCF_LE_SET_ADVERT_PARAM 0x0006
|
||||
#define HCI_CMD_LE_SET_ADVERT_PARAM 0x2006
|
||||
typedef struct {
|
||||
uint16_t min_interval; /* min interval * 0.625ms */
|
||||
uint16_t max_interval; /* max_interval * 0.625ms */
|
||||
uint8_t advert_type;
|
||||
uint8_t own_address_type;
|
||||
uint8_t direct_address_type;
|
||||
bdaddr_t direct_address; /* remote address */
|
||||
uint8_t advert_channel_map;
|
||||
uint8_t advert_filter_policy;
|
||||
} __packed hci_le_set_advert_param_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_advert_param_rp;
|
||||
|
||||
#define HCF_OCF_LE_READ_ADVERT_CHAN_TX_PWR 0x0007
|
||||
#define HCF_CMD_LE_READ_ADVERT_CHAN_TX_PWR 0x2007
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
int8_t tx_power_level; /* -20 - 10 dBm */
|
||||
} __packed hci_le_read_advert_chan_tx_pwr_rp;
|
||||
|
||||
#define HCF_OCF_LE_SET_ADVERT_DATA 0x0008
|
||||
#define HCF_CMD_LE_SET_ADVERT_DATA 0x2008
|
||||
typedef struct {
|
||||
uint8_t advert_data_len; /* 0x00 - 0x1f */
|
||||
uint8_t advert_data[HCI_ADVERT_DATA_SIZE]; /* def all 0's */
|
||||
} __packed hci_le_set_advert_data_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_advert_data_rp;
|
||||
|
||||
#define HCF_OCF_LE_SET_SCAN_RESP_DATA 0x0009
|
||||
#define HCF_CMD_LE_SET_SCAN_RESP_DATA 0x2009
|
||||
typedef struct {
|
||||
uint8_t scan_resp_data_len; /* 0x00 - 0x1f */
|
||||
uint8_t scan_resp_data[HCI_SCAN_DATA_SIZE]; /* def all 0's */
|
||||
} __packed hci_le_set_scan_resp_data_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_scan_resp_data_rp;
|
||||
|
||||
#define HCF_OCF_LE_SET_ADVERT_ENABLE 0x000a
|
||||
#define HCF_CMD_LE_SET_ADVERT_ENABLE 0x200A
|
||||
typedef struct {
|
||||
uint8_t advert_enable; /* 0x00 - disable 0x1 - enable */
|
||||
/* 0x2 - 0xff reserved */
|
||||
} __packed hci_le_set_advert_enable_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_advert_enable_rp;
|
||||
|
||||
#define HCI_OCF_LE_SET_SCAN_PARAM 0x000b
|
||||
#define HCI_CMD_LE_SET_SCAN_PARAM 0x200B
|
||||
typedef struct {
|
||||
uint8_t scan_type;
|
||||
uint16_t scan_interval; /* min interval * 0.625ms */
|
||||
uint16_t scan_window; /* max_interval * 0.625ms */
|
||||
uint8_t own_address_type;
|
||||
uint8_t scan_filter_policy;
|
||||
} __packed hci_le_set_scan_param_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_scan_param_rp;
|
||||
|
||||
#define HCF_OCF_LE_SET_SCAN_ENABLE 0x000c
|
||||
#define HCF_CMD_LE_SET_SCAN_ENABLE 0x200C
|
||||
typedef struct {
|
||||
uint8_t scan_enable; /* 0x00 - disable 0x1 - enable */
|
||||
/* 0x2 - 0xff reserved */
|
||||
uint8_t filter_dup; /* 0x00 - no filtering 0x1 - filter */
|
||||
/* 0x2 - 0xff reserved */
|
||||
} __packed hci_le_set_scan_enable_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_scan_enable_rp;
|
||||
|
||||
#define HCI_OCF_CREATE_CON_LE 0x000d
|
||||
#define HCI_CMD_CREATE_CON_LE 0x200D
|
||||
typedef struct {
|
||||
uint16_t scan_interval; /* min interval * 0.625ms */
|
||||
uint16_t scan_window; /* max_interval * 0.625ms */
|
||||
uint8_t initiator_filter_policy;
|
||||
uint8_t peer_address_type;
|
||||
bdaddr_t peer_address; /* remote address */
|
||||
uint8_t own_address_type;
|
||||
uint16_t con_interval_min; /* min interval * 1.25ms */
|
||||
uint16_t con_interval_max; /* max_interval * 1.25ms */
|
||||
uint16_t con_latency; /* 0x0 - 0x1f4 */
|
||||
uint16_t supervision_timo; /* timeout * 10ms */
|
||||
uint16_t min_ce_length; /* min length * 0.625ms */
|
||||
uint16_t max_ce_length; /* max length * 0.625ms */
|
||||
} __packed hci_create_con_le_cp;
|
||||
/* No return parameter(s) */
|
||||
|
||||
#define HCI_OCF_CREATE_CON_LE_CANCEL 0x000e
|
||||
#define HCI_CMD_CREATE_CON_LE_CANCEL 0x200E
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef hci_status_rp hci_create_con_le_cancel_rp;
|
||||
|
||||
#define HCI_OCF_LE_READ_WHITE_LIST_SIZE 0x000f
|
||||
#define HCI_CMD_LE_READ_WHITE_LIST_SIZE 0x200F
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint8_t white_list_size; /* 0x1 - 0xff */
|
||||
/* 0x0 reserved */
|
||||
} __packed hci_le_read_white_list_size_rp;
|
||||
|
||||
#define HCI_OCF_LE_CLEAR_WHITE_LIST 0x0010
|
||||
#define HCI_CMD_LE_CLEAR_WHITE_LIST 0x2010
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef hci_status_rp hci_le_clear_white_list_rp;
|
||||
|
||||
#define HCI_OCF_LE_ADD_DEV_TO_WHITE_LIST 0x0011
|
||||
#define HCI_CMD_LE_ADD_DEV_TO_WHITE_LIST 0x2011
|
||||
typedef struct {
|
||||
uint8_t address_type;
|
||||
bdaddr_t address; /* remote address */
|
||||
} __packed hci_le_add_dev_to_white_list_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_add_dev_to_white_list_rp;
|
||||
|
||||
#define HCI_OCF_LE_REMOVE_DEV_FROM_WHITE_LIST 0x0012
|
||||
#define HCI_CMD_LE_REMOVE_DEV_FROM_WHITE_LIST 0x2012
|
||||
typedef struct {
|
||||
uint8_t address_type;
|
||||
bdaddr_t address; /* remote address */
|
||||
} __packed hci_le_remove_dev_from_white_list_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_remove_dev_from_white_list_rp;
|
||||
|
||||
#define HCI_OCF_UPDATE_CON_LE 0x0013
|
||||
#define HCI_CMD_UPDATE_CON_LE 0x2013
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* handle 12 bits */
|
||||
uint16_t con_interval_min; /* min interval * 1.25ms */
|
||||
uint16_t con_interval_max; /* max_interval * 1.25ms */
|
||||
uint16_t con_latency; /* 0x0 - 0x1f4 */
|
||||
uint16_t supervision_timo; /* timeout * 10ms */
|
||||
uint16_t min_ce_length; /* min length * 0.625ms */
|
||||
uint16_t max_ce_length; /* max length * 0.625ms */
|
||||
} __packed hci_update_con_le_cp;
|
||||
/* No return parameter(s) */
|
||||
|
||||
#define HCI_OCF_LE_SET_HOST_CHAN_CLASSIFICATION 0x0014
|
||||
#define HCI_CMD_LE_SET_HOST_CHAN_CLASSIFICATION 0x2014
|
||||
typedef struct {
|
||||
uint8_t map[5];
|
||||
} __packed hci_le_set_host_chan_classification_cp;
|
||||
|
||||
typedef hci_status_rp hci_le_set_host_chan_classification_rp;
|
||||
|
||||
#define HCI_OCF_LE_READ_CHANNEL_MAP 0x0015
|
||||
#define HCI_CMD_LE_READ_CHANNEL_MAP 0x2015
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* connection handle */
|
||||
} __packed hci_le_read_channel_map_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t con_handle; /* connection handle */
|
||||
uint8_t map[5]; /* LE channel map */
|
||||
} __packed hci_le_read_channel_map_rp;
|
||||
|
||||
#define HCI_OCF_LE_READ_REMOTE_FEATURES 0x0016
|
||||
#define HCI_CMD_LE_READ_REMOTE_FEATURES 0x2016
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* connection handle */
|
||||
} __packed hci_le_read_remote_features_cp;
|
||||
/* No return parameter(s) */
|
||||
|
||||
#define HCI_OCF_LE_ENCRYPT 0x0017
|
||||
#define HCI_CMD_LE_ENCRYPT 0x2017
|
||||
typedef struct {
|
||||
uint8_t key[16];
|
||||
uint8_t plaintext_data[16];
|
||||
} __packed hci_le_encrypt_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t enc_data[16];
|
||||
} __packed hci_le_encrypt_rp;
|
||||
|
||||
#define HCI_OCF_LE_RAND 0x0018
|
||||
#define HCI_CMD_LE_RAND 0x2018
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint8_t rand_num[8];
|
||||
} __packed hci_le_rand_rp;
|
||||
|
||||
#define HCI_OCF_LE_START_ENCRYPT 0x0019
|
||||
#define HCI_CMD_LE_START_ENCRYPT 0x2019
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* connection handle */
|
||||
uint8_t rand_num[8];
|
||||
uint16_t enc_diversifier;
|
||||
uint8_t key[HCI_KEY_SIZE]; /* key */
|
||||
} __packed hci_le_start_encrypt_cp;
|
||||
/* No return parameter(s) */
|
||||
|
||||
#define HCI_OCF_LE_LONG_TERM_KEY_REQ_REP 0x001a
|
||||
#define HCI_CMD_LE_LONG_TERM_KEY_REQ_REP 0x201A
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* connection handle */
|
||||
uint8_t key[HCI_KEY_SIZE]; /* key */
|
||||
} __packed hci_le_long_term_key_req_rep_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t con_handle; /* connection handle */
|
||||
} __packed hci_le_long_term_key_req_rep_rp;
|
||||
|
||||
#define HCI_OCF_LE_LONG_TERM_KEY_REQ_REP_NEG 0x001b
|
||||
#define HCI_CMD_LE_LONG_TERM_KEY_REQ_REP_NEG 0x201B
|
||||
typedef struct {
|
||||
uint16_t con_handle; /* connection handle */
|
||||
} __packed hci_le_long_term_key_req_rep_neg_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t con_handle; /* connection handle */
|
||||
} __packed hci_le_long_term_key_req_rep_neg_rp;
|
||||
|
||||
/* XXX NS Read supported states */
|
||||
|
||||
#define HCI_OCF_LE_RECEIVER_TEST 0x001d
|
||||
#define HCI_CMD_LE_RECEIVER_TEST 0x201D
|
||||
typedef struct {
|
||||
uint8_t rx_freq; /* 0x00 - 0x27 (2402 - 2480MHz) */
|
||||
} __packed hci_le_receiver_test_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
} __packed hci_le_receiver_test_rp;
|
||||
|
||||
#define HCI_OCF_LE_TRANSMITTER_TEST 0x001e
|
||||
#define HCI_CMD_LE_TRANSMITTER_TEST 0x201E
|
||||
typedef struct {
|
||||
uint8_t tx_freq; /* 0x00 - 0x27 (2402 - 2480MHz) */
|
||||
uint8_t test_len; /* 0x00 - 0x25 bytes */
|
||||
/* 0x26 - 0xff reserved */
|
||||
uint8_t payload; /* 0x00 - 0x02 mandatory */
|
||||
/* 0x03 - 0x07 opt. test patterns */
|
||||
/* 0x08 - 0xff reserved */
|
||||
} __packed hci_le_transmitter_test_cp;
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
} __packed hci_le_transmitter_test_rp;
|
||||
|
||||
#define HCI_OCF_LE_TEST_END 0x001f
|
||||
#define HCI_CMD_LE_TEST_END 0x201F
|
||||
/* No command parameter(s) */
|
||||
|
||||
typedef struct {
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t num_pkts; /* num pkts received */
|
||||
/* 0x0000 for tx test */
|
||||
} __packed hci_le_test_end_rp;
|
||||
|
||||
/**************************************************************************
|
||||
**************************************************************************
|
||||
** Events and event parameters
|
||||
**************************************************************************
|
||||
**************************************************************************/
|
||||
|
||||
#define HCI_LE_META_EVENT 0x3e
|
||||
#define HCI_SUBEVT_CON_COMP 0x01
|
||||
typedef struct {
|
||||
uint8_t subevt_code;
|
||||
uint8_t status; /* status 0x00 = success */
|
||||
uint16_t con_handle; /* handle 12 bits */
|
||||
uint8_t role;
|
||||
uint8_t peer_address_type;
|
||||
bdaddr_t peer_address; /* remote address */
|
||||
uint8_t own_address_type;
|
||||
uint16_t con_interval; /* min interval * 1.25ms */
|
||||
uint16_t con_latency; /* 0x0 - 0x1f4 */
|
||||
uint8_t master_clk_accuracy;
|
||||
} __packed hci_le_con_comp_ep;
|
||||
|
||||
Loading…
Reference in New Issue