Files
moyuhai 41a602f89c V1.0
2026-06-09 16:39:17 +08:00

3742 lines
120 KiB
C

/**
****************************************************************************************
*
* @file co_bt_defines.h
*
* @brief This file contains the common Bluetooth defines, enumerations and structures
* definitions for use by all modules in RW stack.
*
* Copyright (C) RivieraWaves 2009-2016
*
*
****************************************************************************************
*/
#ifndef CO_BT_DEFINES_H_
#define CO_BT_DEFINES_H_
#include <stdbool.h>
#include <stdint.h>
/**
****************************************************************************************
* @addtogroup CO_BT_DEFINES Common Bluetooth defines
* @ingroup CO_BT
* @brief Common Bluetooth definitions and structures.
*
* @{
****************************************************************************************
*/
/*
* DEFINES
****************************************************************************************
*/
/// Bluetooth technologies version
#define BT40_VERSION (6)
#define BT41_VERSION (7)
#define BT42_VERSION (8)
#define BT50_VERSION (9)
#define BT51_VERSION (10)
#define BT52_VERSION (11)
/**
* BD Address format (values in bytes)
* | 3B | 1B | 2B |
* | LAP | UAP | NAP |
*/
#define BD_ADDR_LEN 6
#define BD_ADDR_LAP_POS 0
#define BD_ADDR_LAP_LEN 3
#define BD_ADDR_UAP_POS BD_ADDR_LAP_LEN
#define BD_ADDR_UAP_LEN 1
#define BD_ADDR_NAP_POS BD_ADDR_UAP_LEN
#define BD_ADDR_NAP_LEN 2
/**
* Resolvable private Address format (values in bytes)
* | 3B | 3B |
* | PRAND | HASH |
*/
/// Length of resolvable random address prand part
#define BD_ADDR_PRAND_LEN (3)
/// Length of resolvable random address hash part
#define BD_ADDR_HASH_LEN (3)
/// Random Address type
enum random_addr_type
{
/// Mask over the 2 MSBs
BD_ADDR_RND_ADDR_TYPE_MSK = 0xC0,
/// Static random address - 11 (MSB->LSB)
BD_ADDR_STATIC = 0xC0,
/// Private non resolvable address - 00 (MSB->LSB)
BD_ADDR_NON_RSLV = 0x00,
/// Private resolvable address - 01 (MSB->LSB)
BD_ADDR_RSLV = 0x40,
};
///Length of fields in Bluetooth messages, in number of bytes
#define EVT_MASK_LEN 8
#define DEV_CLASS_LEN 3
#define ACO_LEN 12
#define SRES_LEN 0x04
#define ACCESS_ADDR_LEN 0x04
#define LE_PASSKEY_LEN 0x04
#define BD_NAME_SIZE 0xF8 // Was 0x20 for BLE HL
#define ADV_DATA_LEN 0x1F
#define EXT_ADV_DATA_MAX_LEN 31 // HCI:7.7.65.13
#define PER_ADV_DATA_MAX_LEN 247 // 248 // HCI:7.7.65.16
#define BLE_DATA_LEN 0x1B
#define SCAN_RSP_DATA_LEN 0x1F
#define CONNECT_REQ_DATA_LEN 0x16
#define LE_CHNL_MAP_LEN 0x05
#define CHNL_MAP_LEN 0x0A
#define KEY_LEN 0x10
#define PIN_CODE_MIN_LEN 0x01
#define PIN_CODE_MAX_LEN 0x10
#define PRIV_KEY_192_LEN 24
#define PUB_KEY_192_LEN 48
#define PRIV_KEY_256_LEN 32
#define PUB_KEY_256_LEN 64
#define CFM_LEN 0x10
#define ENC_DATA_LEN 0x10
#define RAND_VAL_LEN 0x10
#define RAND_NB_LEN 0x08
#define LE_FEATS_LEN 0x08
#define SUPP_CMDS_LEN 0x40
#define FEATS_LEN 0x08
#define NAME_VECT_SIZE 14
#define LMP_FEATS_LEN 0x08
#define LE_STATES_LEN 0x08
#define WHITE_LIST_LEN 0x0A
#define LE_FREQ_LEN 0x28
#define LE_DATA_FREQ_LEN 0x25
#define CRC_INIT_LEN 0x03
#define SESS_KEY_DIV_LEN 0x08
#define INIT_VECT_LEN 0x04
#define MIC_LEN 0x04
#define IV_LEN 0x08
#define SK_DIV_LEN 0x10
// Session Key Diversifier Master or slave
#define SKD_M_OFFSET 0x00
#define SKD_S_OFFSET 0x08
// Initialization Vector Master or slave
#define IV_M_OFFSET 0x00
#define IV_S_OFFSET 0x04
// BT 4.2 - Secure Connections
#define PUBLIC_KEY_P256_LEN 0x20
#define DHKEY_CHECK_LEN 0x10
#define DH_KEY_LEN 0x20
// BT 5.0 - Slot Availability Masks
#define SAM_SUBMAPS_LEN 12
#define SAM_TYPE0_SUBMAP_LEN 14
#define SAM_SLOT_NOT_AVAILABLE 0
#define SAM_SLOT_TX_AVAILABLE 1
#define SAM_SLOT_RX_AVAILABLE 2
#define SAM_SLOT_TX_RX_AVAILABLE 3
#define SAM_INDEX_MAX 3
#define SAM_INDEX_CONTINUE 3
#define SAM_DISABLED 0xFF
#define SAM_UPDATE_INVALIDATE_MAPS 0
#define SAM_UPDATE_IMMEDIATE 1
#define SAM_UPDATE_AT_SUBINTERVAL 2
#define T_SAM_SM_MIN 2
#define T_SAM_SM_MAX 56
#define SAM_SLOTS_SUBMAPPED 0
#define SAM_SLOTS_AVAILABLE 1
#define SAM_SLOTS_UNAVAILABLE 2
/// Maximum maskable event code
#define EVT_MASK_CODE_MAX EVT_MASK_LEN * 8
/// Default event mask
#define EVT_MASK_DEFAULT {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x9F, 0x00, 0x20}
/// Advertising and Data Channel Indices (chapter 6.B.1.4.1)
#define DATA_CHANNEL_MIN 0
#define DATA_CHANNEL_MAX 36
#define DATA_CHANNEL_NB 37
#define ADV_CHANNEL_37 37
#define ADV_CHANNEL_38 38
#define ADV_CHANNEL_39 39
/// Minimum number of used channel in the map (chapter 6.B.4.5.8.1)
#define DATA_CHANNEL_USED_NB_MIN 2
/// Advertising interval (in 625us slot) (chapter 2.E.7.8.5)
#define ADV_INTERVAL_MIN 0x0020 //(20 ms)
#define ADV_INTERVAL_MAX 0x4000 //(10.24 sec)
#define ADV_INTERVAL_DFT 0x0800 //(1.28 sec)
/// Scanning interval (in 625us slot) (chapter 2.E.7.8.10)
#define SCAN_INTERVAL_MIN 0x0004 //(2.5 ms)
#define SCAN_INTERVAL_MAX 0x4000 //(10.24 sec)
#define SCAN_INTERVAL_DFT 0x0010 //(10 ms)
/// Scanning window (in 625us slot) (chapter 2.E.7.8.10)
#define SCAN_WINDOW_MIN 0x0004 //(2.5 ms)
#define SCAN_WINDOW_MAX 0x4000 //(10.24 sec)
#define SCAN_WINDOW_DFT 0x0010 //(10 ms)
/// Sync Timeout (in Time = N*10ms)
#define SYNC_TIMEOUT_MIN 0x000A //(100 ms)
#define SYNC_TIMEOUT_MAX 0x4000 //(163.84 s)
/// Advertising SID valid Range
#define SYNC_SID_MIN 0x00
#define SYNC_SID_MAX 0x0F
/// Periodic Adv Skip valid Range
#define SYNC_SKIP_MIN 0x0000
#define SYNC_SKIP_MAX 0x01F3
/// Length of Codec ID value
#define CODEC_ID_LEN 5
/// Connection interval (N*1.250ms) (chapter 2.E.7.8.12)
#if defined(CFG_ISO_MODE_0)
#define CON_INTERVAL_MIN_AUDIO 0x0002 //(2.5 msec)
#define CON_INTERVAL_MIN CON_INTERVAL_MIN_AUDIO
#else // !defined(CFG_ISO_MODE_0)
#define CON_INTERVAL_MIN 0x0006 //(7.5 msec)
#endif // defined(CFG_ISO_MODE_0)
#define CON_INTERVAL_MAX 0x0C80 //(4 sec)
/// Connection latency (N*cnx evt) (chapter 2.E.7.8.12)
#define CON_LATENCY_MIN 0x0000
#define CON_LATENCY_MAX 0x01F3 // (499)
/// Supervision TO (N*10ms) (chapter 2.E.7.8.12)
#define CON_SUP_TO_MIN 0x000A //(100 msec)
#define CON_SUP_TO_MAX 0x0C80 //(32 sec)
/// Format of the Advertising packets
#define ADV_ADDR_OFFSET 0
#define ADV_ADDR_LEN BD_ADDR_LEN
#define ADV_DATA_OFFSET (ADV_ADDR_OFFSET + ADV_ADDR_LEN)
/// List of supported BLE Features LL:4.6
enum ble_feature
{
//byte 0
BLE_FEAT_ENC = (0),
BLE_FEAT_CON_PARAM_REQ_PROC = (1),
BLE_FEAT_EXT_REJ_IND = (2),
BLE_FEAT_SLAVE_INIT_FEAT_EXCHG = (3),
BLE_FEAT_PING = (4),
BLE_FEAT_DATA_PKT_LEN_EXT = (5),
BLE_FEAT_LL_PRIVACY = (6),
BLE_FEAT_EXT_SCAN_FILT_POLICY = (7),
//byte 1
BLE_FEAT_2M_PHY = (8),
BLE_FEAT_STABLE_MOD_IDX_TX = (9),
BLE_FEAT_STABLE_MOD_IDX_RX = (10),
BLE_FEAT_CODED_PHY = (11),
BLE_FEAT_EXT_ADV = (12),
BLE_FEAT_PER_ADV = (13),
BLE_FEAT_CHAN_SEL_ALGO_2 = (14),
BLE_FEAT_PWR_CLASS_1 = (15),
//byte 2
BLE_FEAT_MIN_NUM_USED_CHAN_PROC = (16),
BLE_FEAT_CON_CTE_REQ = (17),
BLE_FEAT_CON_CTE_RSP = (18),
BLE_FEAT_CONLESS_CTE_TX = (19),
BLE_FEAT_CONLESS_CTE_RX = (20),
BLE_FEAT_AOD = (21),
BLE_FEAT_AOA = (22),
BLE_FEAT_CTE_RX = (23),
//byte 3
BLE_FEAT_PER_ADV_SYNC_TRANSF_TX = (24),
BLE_FEAT_PER_ADV_SYNC_TRANSF_RX = (25),
BLE_FEAT_SLEEP_CLK_ACC_UPD = (26),
BLE_FEAT_PUB_KEY_VALID = (27),
BLE_FEAT_CON_ISO_STREAM_MASTER = (28),
BLE_FEAT_CON_ISO_STREAM_SLAVE = (29),
BLE_FEAT_ISO_BROADCASTER = (30),
BLE_FEAT_SYNCED_RECEIVER = (31),
//byte 4
BLE_FEAT_ISO_CHANNELS_HOST_SUPPORT = (32),
BLE_FEAT_POWER_CONTROL_REQ = (33),
BLE_FEAT_POWER_CHANGE_IND = (34),
BLE_FEAT_PATH_LOSS_MONITORING = (35),
};
/// BLE supported states
//byte 0
#define BLE_NON_CON_ADV_STATE 0x01
#define BLE_DISC_ADV_STATE 0x02
#define BLE_CON_ADV_STATE 0x04
#define BLE_HDC_DIRECT_ADV_STATE 0x08
#define BLE_PASS_SCAN_STATE 0x10
#define BLE_ACTIV_SCAN_STATE 0x20
#define BLE_INIT_MASTER_STATE 0x40
#define BLE_CON_SLAVE_STATE 0x80
//byte 1
#define BLE_NON_CON_ADV_PASS_SCAN_STATE 0x01
#define BLE_DISC_ADV_PASS_SCAN_STATE 0x02
#define BLE_CON_ADV_PASS_SCAN_STATE 0x04
#define BLE_HDC_DIRECT_ADV_PASS_SCAN_STATE 0x08
#define BLE_NON_CON_ADV_ACTIV_SCAN_STATE 0x10
#define BLE_DISC_ADV_ACTIV_SCAN_STATE 0x20
#define BLE_CON_ADV_ACTIV_SCAN_STATE 0x40
#define BLE_HDC_DIRECT_ADV_ACTIV_SCAN_STATE 0x80
//byte 2
#define BLE_NON_CON_ADV_INIT_STATE 0x01
#define BLE_DISC_ADV_INIT_STATE 0x02
#define BLE_NON_CON_ADV_MASTER_STATE 0x04
#define BLE_DISC_ADV_MASTER_STATE 0x08
#define BLE_NON_CON_ADV_SLAVE_STATE 0x10
#define BLE_DISC_ADV_SLAVE_STATE 0x20
#define BLE_PASS_SCAN_INIT_STATE 0x40
#define BLE_ACTIV_SCAN_INIT_STATE 0x80
//byte 3
#define BLE_PASS_SCAN_MASTER_STATE 0x01
#define BLE_ACTIV_SCAN_MASTER_STATE 0x02
#define BLE_PASS_SCAN_SLAVE_STATE 0x04
#define BLE_ACTIV_SCAN_SLAVE_STATE 0x08
#define BLE_INIT_MASTER_MASTER_STATE 0x10
#define BLE_LDC_DIRECT_ADV_STATE 0x20
#define BLE_LDC_DIRECT_ADV_PASS_SCAN_STATE 0x40
#define BLE_LDC_DIRECT_ADV_ACTIV_SCAN_STATE 0x80
//byte 4
#define BLE_CON_ADV_INIT_MASTER_SLAVE_STATE 0x01
#define BLE_HDC_DIRECT_ADV_INIT_MASTER_SLAVE_STATE 0x02
#define BLE_LDC_DIRECT_ADV_INIT_MASTER_SLAVE_STATE 0x04
#define BLE_CON_ADV_MASTER_SLAVE_STATE 0x08
#define BLE_HDC_DIRECT_ADV_MASTER_SLAVE_STATE 0x10
#define BLE_LDC_DIRECT_ADV_MASTER_SLAVE_STATE 0x20
#define BLE_CON_ADV_SLAVE_SLAVE_STATE 0x40
#define BLE_HDC_DIRECT_ADV_SLAVE_SLAVE_STATE 0x80
//byte 5
#define BLE_LDC_DIRECT_ADV_SLAVE_SLAVE_STATE 0x01
#define BLE_INIT_MASTER_SLAVE_STATE 0x02
/// BLE supported commands
//byte0
#define BLE_DISC_CMD 0x20
//byte2
#define BLE_RD_REM_VERS_CMD 0x80
//byte5
#define BLE_SET_EVT_MSK_CMD 0x40
#define BLE_RESET_CMD 0x80
//byte10
#define BLE_RD_TX_PWR_CMD 0x04
#define BLE_SET_CTRL_TO_HL_FCTRL_CMD 0x20
#define BLE_HL_BUF_SIZE_CMD 0x40
#define BLE_HL_NB_CMP_PKT_CMD 0x80
//byte14
#define BLE_RD_LOC_VERS_CMD 0x08
#define BLE_RD_LOC_SUP_FEAT_CMD 0x20
//byte15
#define BLE_RD_BD_ADDR_CMD 0x02
#define BLE_RD_RSSI_CMD 0x20
//byte22
#define BLE_SET_EVT_MSK_PG2_CMD 0x04
//byte25
#define BLE_LE_SET_EVT_MSK_CMD 0x01
#define BLE_LE_RD_BUF_SIZE_CMD 0x02
#define BLE_LE_RD_LOC_SUP_FEAT_CMD 0x04
#define BLE_LE_SET_RAND_ADDR_CMD 0x10
#define BLE_LE_SET_ADV_PARAM_CMD 0x20
#define BLE_LE_RD_ADV_TX_PWR_CMD 0x40
#define BLE_LE_SET_ADV_DATA_CMD 0x80
//byte26
#define BLE_LE_SET_SC_RSP_DATA_CMD 0x01
#define BLE_LE_SET_ADV_EN_CMD 0x02
#define BLE_LE_SET_SC_PARAM_CMD 0x04
#define BLE_LE_SET_SC_EN_CMD 0x08
#define BLE_LE_CREAT_CNX_CMD 0x10
#define BLE_LE_CREAT_CNX_CNL_CMD 0x20
#define BLE_LE_RD_WL_SIZE_CMD 0x40
#define BLE_LE_CLEAR_WL_CMD 0x80
//byte27
#define BLE_LE_ADD_DEV_WL_CMD 0x01
#define BLE_LE_REM_DEV_WL_CMD 0x02
#define BLE_LE_CNX_UPDATE_CMD 0x04
#define BLE_LE_SET_HL_CH_CLASS_CMD 0x08
#define BLE_LE_RD_CH_MAP_CMD 0x10
#define BLE_LE_RD_REM_FEAT_CMD 0x20
#define BLE_LE_ENCRYPT_CMD 0x40
#define BLE_LE_RAND_CMD 0x80
//byte28
#define BLE_LE_EN_ENC_CMD 0x01
#define BLE_LE_LTK_REQ_RPLY_CMD 0x02
#define BLE_LE_LTK_REQ_NEG_RPLY_CMD 0x04
#define BLE_LE_RD_SUPP_STATES_CMD 0x08
#define BLE_LE_RX_TEST_V1_CMD 0x10
#define BLE_LE_TX_TEST_V1_CMD 0x20
#define BLE_LE_STOP_TEST_CMD 0x40
//byte32
#define BLE_RD_AUTH_PAYL_TO_CMD 0x10
#define BLE_WR_AUTH_PAYL_TO_CMD 0x20
//byte33
#define BLE_LE_REM_CON_PARA_REQ_RPLY_CMD 0x10
#define BLE_LE_REM_CON_PARA_REQ_NEG_RPLY_CMD 0x20
#define BLE_LE_SET_DATA_LEN_CMD 0x40
#define BLE_LE_RD_SUGGTED_DFT_DATA_LEN_CMD 0x80
//byte34
#define BLE_LE_WR_SUGGTED_DFT_DATA_LEN_CMD 0x01
#define BLE_LE_RD_LOC_P256_PUB_KEY_CMD 0x02
#define BLE_LE_GEN_DHKEY_V1_CMD 0x04
#define BLE_LE_ADD_DEV_TO_RESOLV_LIST_CMD 0x08
#define BLE_LE_REM_DEV_FROM_RESOLV_LIST_CMD 0x10
#define BLE_LE_CLEAR_RESOLV_LIST_CMD 0x20
#define BLE_LE_RD_RESOLV_LIST_SIZE_CMD 0x40
#define BLE_LE_RD_PEER_RESOLV_ADDR_CMD 0x80
//byte35
#define BLE_LE_RD_LOCAL_RESOLV_ADDR_CMD 0x01
#define BLE_LE_SET_ADDR_RESOL_CMD 0x02
#define BLE_LE_SET_RESOLV_PRIV_ADDR_TO_CMD 0x04
#define BLE_LE_RD_MAX_DATA_LEN_CMD 0x08
#define BLE_LE_RD_PHY_CMD 0x10
#define BLE_LE_SET_DFT_PHY_CMD 0x20
#define BLE_LE_SET_PHY_CMD 0x40
#define BLE_LE_RX_TEST_V2_CMD 0x80
//byte36
#define BLE_LE_TX_TEST_V2_CMD 0x01
#define BLE_LE_SET_ADV_SET_RAND_ADDR_CMD 0x02
#define BLE_LE_SET_EXT_ADV_PARAM_CMD 0x04
#define BLE_LE_SET_EXT_ADV_DATA_CMD 0x08
#define BLE_LE_SET_EXT_SCAN_RSP_DATA_CMD 0x10
#define BLE_LE_SET_EXT_ADV_EN_CMD 0x20
#define BLE_LE_RD_MAX_ADV_DATA_LEN_CMD 0x40
#define BLE_LE_RD_NB_SUPP_ADV_SETS_CMD 0x80
//byte37
#define BLE_LE_RMV_ADV_SET_CMD 0x01
#define BLE_LE_CLEAR_ADV_SETS_CMD 0x02
#define BLE_LE_SET_PER_ADV_PARAM_CMD 0x04
#define BLE_LE_SET_PER_ADV_DATA_CMD 0x08
#define BLE_LE_SET_PER_ADV_EN_CMD 0x10
#define BLE_LE_SET_EXT_SCAN_PARAM_CMD 0x20
#define BLE_LE_SET_EXT_SCAN_EN_CMD 0x40
#define BLE_LE_EXT_CREATE_CON_CMD 0x80
//byte38
#define BLE_LE_PER_ADV_CREATE_SYNC_CMD 0x01
#define BLE_LE_PER_ADV_CREATE_SYNC_CANCEL_CMD 0x02
#define BLE_LE_PER_ADV_TERM_SYNC_CMD 0x04
#define BLE_LE_ADD_DEV_TO_PER_ADV_LIST_CMD 0x08
#define BLE_LE_RMV_DEV_FROM_PER_ADV_LIST_CMD 0x10
#define BLE_LE_CLEAR_PER_ADV_LIST_CMD 0x20
#define BLE_LE_RD_PER_ADV_LIST_SIZE_CMD 0x40
#define BLE_LE_RD_TX_PWR_CMD 0x80
//byte39
#define BLE_LE_RD_RF_PATH_COMP_CMD 0x01
#define BLE_LE_WR_RF_PATH_COMP_CMD 0x02
#define BLE_LE_SET_PRIV_MODE_CMD 0x04
#define BLE_LE_RX_TEST_V3_CMD 0x08
#define BLE_LE_TX_TEST_V3_CMD 0x10
#define BLE_LE_SET_CONLESS_CTE_TX_PARAM_CMD 0x20
#define BLE_LE_SET_CONLESS_CTE_TX_EN_CMD 0x40
#define BLE_LE_SET_CONLESS_IQ_SAMPL_EN_CMD 0x80
//byte40
#define BLE_LE_SET_CON_CTE_RX_PARAM_CMD 0x01
#define BLE_LE_SET_CON_CTE_TX_PARAM_CMD 0x02
#define BLE_LE_CON_CTE_REQ_EN_CMD 0x04
#define BLE_LE_CON_CTE_RSP_EN_CMD 0x08
#define BLE_LE_RD_ANTENNA_INF_CMD 0x10
#define BLE_LE_SET_PER_ADV_RX_EN_CMD 0x20
#define BLE_LE_PER_ADV_SYNC_TRANSF_CMD 0x40
#define BLE_LE_PER_ADV_SET_INFO_TRANSF_CMD 0x80
//byte41
#define BLE_LE_SET_PER_ADV_SYNC_TRANSF_PARAM_CMD 0x01
#define BLE_LE_SET_DFT_PER_ADV_SYNC_TRANSF_PARAM_CMD 0x02
#define BLE_LE_GEN_DHKEY_V2_CMD 0x04
#define BLE_LE_MOD_SLP_CLK_ACC_CMD 0x10
#define BLE_LE_RD_BUF_SIZE_V2_CMD 0x20
#define BLE_LE_RD_ISO_TX_SYNC_CMD 0x40
#define BLE_LE_SET_CIG_PARAMS_CMD 0x80
//byte42
#define BLE_LE_SET_CIG_PARAMS_TEST_CMD 0x01
#define BLE_LE_CREATE_CIS_CMD 0x02
#define BLE_LE_REMOVE_CIG_CMD 0x04
#define BLE_LE_ACCEPT_CIS_REQ_CMD 0x08
#define BLE_LE_REJECT_CIS_REQ_CMD 0x10
#define BLE_LE_CREATE_BIG_CMD 0x20
#define BLE_LE_CREATE_BIG_TEST_CMD 0x40
#define BLE_LE_TERMINATE_BIG_CMD 0x80
//byte43
#define BLE_LE_CREATE_BIG_SYNC_CMD 0x01
#define BLE_LE_BIG_TERMINATE_SYNC_CMD 0x02
#define BLE_LE_REQ_PEER_SCA_CMD 0x04
#define BLE_LE_SETUP_ISO_DATA_PATH_CMD 0x08
#define BLE_LE_REMOVE_ISO_DATA_PATH_CMD 0x10
#define BLE_LE_ISO_TX_TEST_CMD 0x20
#define BLE_LE_ISO_RX_TEST_CMD 0x40
#define BLE_LE_ISO_RD_TEST_COUNTERS_CMD 0x80
//byte 44
#define BLE_LE_ISO_TEST_END_CMD 0x01
#define BLE_LE_SET_HOST_FEAT_CMD 0x02
#define BLE_LE_RD_ISO_LINK_QUALITY_CMD 0x04
#define BLE_LE_ENH_RD_TX_POWER_LEVEL_CMD 0x08
#define BLE_LE_RD_REMOTE_TX_POWER_CMD 0x10
#define BLE_LE_SET_PATH_LOSS_REPORTING_PARAMS_CMD 0x20
#define BLE_LE_SET_PATH_LOSS_REPORTING_ENABLE_CMD 0x40
#define BLE_LE_SET_TX_POWER_REPORTING_ENABLE_CMD 0x80
//byte 45
#define BLE_LE_TX_TEST_V4_CMD 0x01
#define BLE_LE_SET_ECO_BASE_INTERVAL_CMD 0x02
#define BLE_LE_RD_LOC_SUPP_CODECS_V2_CMD 0x04
#define BLE_LE_RD_LOC_SUPP_CODEC_CAP_CMD 0x08
#define BLE_LE_RD_LOC_SUPP_CTRL_DELAY_CMD 0x10
#define BLE_LE_CONFIG_DATA_PATH_CMD 0x20
// Inquiry Length HCI:7.1.1
#define INQ_LEN_MIN 0x01
#define INQ_LEN_MAX 0x30
// Inquiry Length HCI:7.1.3
#define INQ_MIN_PER_LEN_MIN 0x0002
#define INQ_MIN_PER_LEN_MAX 0xFFFE
#define INQ_MAX_PER_LEN_MIN 0x0003
#define INQ_MAX_PER_LEN_MAX 0xFFFF
// IAC support
#define NB_IAC_MIN 0x01
#define NB_IAC_MAX 0x40
/// Most significant bit of the Bluetooth clock (in 312.5us half-slots)
#define BT_CLOCK_MSB (1L << 27)
/// Logical Transport Adresses BB:4.2
#define LT_ADDR_BCST 0x00
#define LT_ADDR_MIN 0x01
#define LT_ADDR_MAX 0x07
/// Link type HCI:7.7.3
#define SCO_TYPE 0
#define ACL_TYPE 1
#define ESCO_TYPE 2
#define UNKNOWN_TYPE 3 // Used in LM
#define LE_TYPE 4
/// Allow Role Switch HCI:4.6.8
#define MASTER_ROLE 0
#define SLAVE_ROLE 1
#define UNKNOWN_ROLE 0xFF //Used in LC to init the links role
/// Link policy HCI:4.6.9 and HCI:4.6.10
#define POLICY_SWITCH 0x0001
#define POLICY_HOLD 0x0002
#define POLICY_SNIFF 0x0004
#define POLICY_PARK 0x0008
/// Allow Role Switch HCI:4.5.5
#define ROLE_SWITCH_NOT_ALLOWED 0
#define ROLE_SWITCH_ALLOWED 1
/// AcceptConnection Role HCI:4.5.8
#define ACCEPT_SWITCH_TO_MASTER 0
#define ACCEPT_REMAIN_SLAVE 1
/// Packet Type Flags HCI:7.1.14
#define PACKET_TYPE_EDR_MSK 0x330E
#define PACKET_TYPE_GFSK_MSK 0xCCF8
#define PACKET_TYPE_NO_2_DH1_FLAG 0x0002
#define PACKET_TYPE_NO_3_DH1_FLAG 0x0004
#define PACKET_TYPE_DM1_FLAG 0x0008
#define PACKET_TYPE_DH1_FLAG 0x0010
#define PACKET_TYPE_HV1_FLAG 0x0020
#define PACKET_TYPE_HV2_FLAG 0x0040
#define PACKET_TYPE_HV3_FLAG 0x0080
#define PACKET_TYPE_NO_2_DH3_FLAG 0x0100
#define PACKET_TYPE_NO_3_DH3_FLAG 0x0200
#define PACKET_TYPE_DM3_FLAG 0x0400
#define PACKET_TYPE_DH3_FLAG 0x0800
#define PACKET_TYPE_NO_2_DH5_FLAG 0x1000
#define PACKET_TYPE_NO_3_DH5_FLAG 0x2000
#define PACKET_TYPE_DM5_FLAG 0x4000
#define PACKET_TYPE_DH5_FLAG 0x8000
/// Synchronous Packet Types HCI:7.1.14
#define SYNC_PACKET_TYPE_HV1_FLAG 0x0001
#define SYNC_PACKET_TYPE_HV2_FLAG 0x0002
#define SYNC_PACKET_TYPE_HV3_FLAG 0x0004
#define SYNC_PACKET_TYPE_EV3_FLAG 0x0008
#define SYNC_PACKET_TYPE_EV4_FLAG 0x0010
#define SYNC_PACKET_TYPE_EV5_FLAG 0x0020
#define SYNC_PACKET_TYPE_NO_EV3_2_FLAG 0x0040
#define SYNC_PACKET_TYPE_NO_EV3_3_FLAG 0x0080
#define SYNC_PACKET_TYPE_NO_EV5_2_FLAG 0x0100
#define SYNC_PACKET_TYPE_NO_EV5_3_FLAG 0x0200
#define SYNC_PACKET_TYPE_EV3_2_FLAG 0x0040
#define SYNC_PACKET_TYPE_EV3_3_FLAG 0x0080
#define SYNC_PACKET_TYPE_EV5_2_FLAG 0x0100
#define SYNC_PACKET_TYPE_EV5_3_FLAG 0x0200
/// RWBT 1.2
#define SYNC_EV3_PACKET_SIZE 30
#define SYNC_EV4_PACKET_SIZE 120
#define SYNC_EV5_PACKET_SIZE 180
/// Packet Boundary Flag HCI:5.4.2
#define PBF_1ST_NF_HL_FRAG 0x00 // Non-flushable packets
#define PBF_CONT_HL_FRAG 0x01
#define PBF_1ST_HL_FRAG 0x02
#define PBF_CMP_PDU 0x03
#define PBF_MASK 0x03
/// Broadcast Flag HCI:5.4.2
#define BCF_P2P 0x00
#define BCF_ACTIVE_SLV_BCST 0x01
#define BCF_PARK_SLV_BCST 0x02
#define BCF_MASK 0x03
/// Synchronous Packet Status Flag HCI:5.4.3
#define CORRECTLY_RX_FLAG 0x00
#define POSSIBLY_INVALID_FLAG 0x01
#define NO_RX_DATA_FLAG 0x02
#define PARTIALLY_LOST_FLAG 0x03
/// Park mode defines LMP:3.17
#define MACCESS_MSK 0x0F
#define ACCSCHEM_MSK 0xF0
/// Support 3 feature pages
#define FEATURE_PAGE_MAX 3
#define FEATURE_PAGE_0 0
#define FEATURE_PAGE_1 1
#define FEATURE_PAGE_2 2
/// Feature mask definition LMP:3.3
#define B0_3_SLOT_POS 0
#define B0_3_SLOT_MSK 0x01
#define B0_5_SLOT_POS 1
#define B0_5_SLOT_MSK 0x02
#define B0_ENC_POS 2
#define B0_ENC_MSK 0x04
#define B0_SLOT_OFF_POS 3
#define B0_SLOT_OFF_MSK 0x08
#define B0_TIMING_ACCU_POS 4
#define B0_TIMING_ACCU_MSK 0x10
#define B0_ROLE_SWITCH_POS 5
#define B0_ROLE_SWITCH_MSK 0x20
#define B0_HOLD_MODE_POS 6
#define B0_HOLD_MODE_MSK 0x40
#define B0_SNIFF_MODE_POS 7
#define B0_SNIFF_MODE_MSK 0x80
#define B1_PARK_POS 0
#define B1_PARK_MSK 0x01
#define B1_RSSI_POS 1
#define B1_RSSI_MSK 0x02
#define B1_CQDDR_POS 2
#define B1_CQDDR_MSK 0x04
#define B1_SCO_POS 3
#define B1_SCO_MSK 0x08
#define B1_HV2_POS 4
#define B1_HV2_MSK 0x10
#define B1_HV3_POS 5
#define B1_HV3_MSK 0x20
#define B1_MULAW_POS 6
#define B1_MULAW_MSK 0x40
#define B1_ALAW_POS 7
#define B1_ALAW_MSK 0x80
#define B2_CVSD_POS 0
#define B2_CVSD_MSK 0x01
#define B2_PAGING_PAR_NEGO_POS 1
#define B2_PAGING_PAR_NEGO_MSK 0x02
#define B2_PWR_CTRL_POS 2
#define B2_PWR_CTRL_MSK 0x04
#define B2_TRANSPARENT_SCO_POS 3
#define B2_TRANSPARENT_SCO_MSK 0x08
#define B2_FLOW_CTRL_LAG_POS 4
#define B2_FLOW_CTRL_LAG_MSK 0x70
#define B2_BCAST_ENC_POS 7
#define B2_BCAST_ENC_MSK 0x80
#define B3_EDR_2MBPS_ACL_POS 1
#define B3_EDR_2MBPS_ACL_MSK 0x02
#define B3_EDR_3MBPS_ACL_POS 2
#define B3_EDR_3MBPS_ACL_MSK 0x04
#define B3_ENH_INQSCAN_POS 3
#define B3_ENH_INQSCAN_MSK 0x08
#define B3_INT_INQSCAN_POS 4
#define B3_INT_INQSCAN_MSK 0x10
#define B3_INT_PAGESCAN_POS 5
#define B3_INT_PAGESCAN_MSK 0x20
#define B3_RSSI_INQ_RES_POS 6
#define B3_RSSI_INQ_RES_MSK 0x40
#define B3_ESCO_EV3_POS 7
#define B3_ESCO_EV3_MSK 0x80
#define B4_EV4_PKT_POS 0
#define B4_EV4_PKT_MSK 0x01
#define B4_EV5_PKT_POS 1
#define B4_EV5_PKT_MSK 0x02
#define B4_AFH_CAP_SLV_POS 3
#define B4_AFH_CAP_SLV_MSK 0x08
#define B4_AFH_CLASS_SLV_POS 4
#define B4_AFH_CLASS_SLV_MSK 0x10
#define B4_BR_EDR_NOT_SUPP_POS 5
#define B4_BR_EDR_NOT_SUPP_MSK 0x20
#define B4_LE_SUPP_POS 6
#define B4_LE_SUPP_MSK 0x40
#define B4_3_SLOT_EDR_ACL_POS 7
#define B4_3_SLOT_EDR_ACL_MSK 0x80
#define B5_5_SLOT_EDR_ACL_POS 0
#define B5_5_SLOT_EDR_ACL_MSK 0x01
#define B5_SSR_POS 1
#define B5_SSR_MSK 0x02
#define B5_PAUSE_ENC_POS 2
#define B5_PAUSE_ENC_MSK 0x04
#define B5_AFH_CAP_MST_POS 3
#define B5_AFH_CAP_MST_MSK 0x08
#define B5_AFH_CLASS_MST_POS 4
#define B5_AFH_CLASS_MST_MSK 0x10
#define B5_EDR_ESCO_2MBPS_POS 5
#define B5_EDR_ESCO_2MBPS_MSK 0x20
#define B5_EDR_ESCO_3MBPS_POS 6
#define B5_EDR_ESCO_3MBPS_MSK 0x40
#define B5_3_SLOT_EDR_ESCO_POS 7
#define B5_3_SLOT_EDR_ESCO_MSK 0x80
#define B6_EIR_POS 0
#define B6_EIR_MSK 0x01
#define B6_SIM_LE_BREDR_DEV_CAP_POS 1
#define B6_SIM_LE_BREDR_DEV_CAP_MSK 0x02
#define B6_SSP_POS 3
#define B6_SSP_MSK 0x08
#define B6_ENCAPS_PDU_POS 4
#define B6_ENCAPS_PDU_MSK 0x10
#define B6_ERR_DATA_REP_POS 5
#define B6_ERR_DATA_REP_MSK 0x20
#define B6_NONFLUSH_PBF_POS 6
#define B6_NONFLUSH_PBF_MSK 0x40
#define B7_LST_CHANGE_EVT_POS 0
#define B7_LST_CHANGE_EVT_MSK 0x01
#define B7_INQRES_TXPOW_POS 1
#define B7_INQRES_TXPOW_MSK 0x02
#define B7_ENH_PWR_CTRL_POS 2
#define B7_ENH_PWR_CTRL_MSK 0x04
#define B7_EXT_FEATS_POS 7
#define B7_EXT_FEATS_MSK 0x80
/// Extended feature mask definition page 1 LMP:3.3
#define B0_HOST_SSP_POS 0
#define B0_HOST_SSP_MSK 0x01
#define B0_HOST_LE_POS 1
#define B0_HOST_LE_MSK 0x02
#define B0_HOST_LE_BR_EDR_POS 2
#define B0_HOST_LE_BR_EDR_MSK 0x04
#define B0_HOST_SECURE_CON_POS 3
#define B0_HOST_SECURE_CON_MSK 0x08
/// Extended feature mask definition page 2 LMP:3.3
#define B0_CSB_MASTER_POS 0
#define B0_CSB_MASTER_MSK 0x01
#define B0_CSB_SLAVE_POS 1
#define B0_CSB_SLAVE_MSK 0x02
#define B0_SYNC_TRAIN_POS 2
#define B0_SYNC_TRAIN_MSK 0x04
#define B0_SYNC_SCAN_POS 3
#define B0_SYNC_SCAN_MSK 0x08
#define B0_INQ_RES_NOTIF_EVT_POS 4
#define B0_INQ_RES_NOTIF_EVT_MSK 0x10
#define B0_GEN_INTERL_SCAN_POS 5
#define B0_GEN_INTERL_SCAN_MSK 0x20
#define B0_COARSE_CLK_ADJ_POS 6
#define B0_COARSE_CLK_ADJ_MSK 0x40
#define B1_SEC_CON_CTRL_POS 0
#define B1_SEC_CON_CTRL_MSK 0x01
#define B1_PING_POS 1
#define B1_PING_MSK 0x02
#define B1_SAM_POS 2
#define B1_SAM_MSK 0x04
#define B1_TRAIN_NUDGING_POS 3
#define B1_TRAIN_NUDGING_MSK 0x08
/// Features definitions
#define FEAT_3_SLOT_BIT_POS 0
#define FEAT_5_SLOT_BIT_POS 1
#define FEAT_ENC_BIT_POS 2
#define FEAT_SLOT_OFFSET_BIT_POS 3
#define FEAT_TIMING_ACC_BIT_POS 4
#define FEAT_SWITCH_BIT_POS 5
#define FEAT_HOLD_BIT_POS 6
#define FEAT_SNIFF_BIT_POS 7
#define FEAT_PARK_BIT_POS 8
#define FEAT_RSSI_BIT_POS 9
#define FEAT_QUALITY_BIT_POS 10
#define FEAT_SCO_BIT_POS 11
#define FEAT_HV2_BIT_POS 12
#define FEAT_HV3_BIT_POS 13
#define FEAT_ULAW_BIT_POS 14
#define FEAT_ALAW_BIT_POS 15
#define FEAT_CVSD_BIT_POS 16
#define FEAT_PAGING_BIT_POS 17
#define FEAT_POWER_BIT_POS 18
#define FEAT_TRANSP_SCO_BIT_POS 19
#define FEAT_BCAST_ENCRYPT_BIT_POS 23
#define FEAT_EDR_2MB_BIT_POS 25
#define FEAT_EDR_3MB_BIT_POS 26
#define FEAT_ENH_INQSCAN_BIT_POS 27
#define FEAT_INT_INQSCAN_BIT_POS 28
#define FEAT_INT_PAGESCAN_BIT_POS 29
#define FEAT_RSSI_INQRES_BIT_POS 30
#define FEAT_EV3_BIT_POS 31
#define FEAT_EV4_BIT_POS 32
#define FEAT_EV5_BIT_POS 33
#define FEAT_AFH_CAPABLE_S_BIT_POS 35
#define FEAT_AFH_CLASS_S_BIT_POS 36
#define FEAT_BR_EDR_NO_SUPP_BIT_POS 37
#define FEAT_LE_BIT_POS 38
#define FEAT_3_SLOT_EDR_BIT_POS 39
#define FEAT_5_SLOT_EDR_BIT_POS 40
#define FEAT_SNIFF_SUBRAT_BIT_POS 41
#define FEAT_PAUSE_ENCRYPT_BIT_POS 42
#define FEAT_AFH_CAPABLE_M_BIT_POS 43
#define FEAT_AFH_CLASS_M_BIT_POS 44
#define FEAT_EDR_ESCO_2MB_BIT_POS 45
#define FEAT_EDR_ESCO_3MB_BIT_POS 46
#define FEAT_3_SLOT_EDR_ESCO_BIT_POS 47
#define FEAT_EIR_BIT_POS 48
#define FEAT_LE_BR_EDR_BIT_POS 49
#define FEAT_SSP_BIT_POS 51
#define FEAT_ENCAP_PDU_BIT_POS 52
#define FEAT_ERRO_DATA_REP_BIT_POS 53
#define FEAT_NFLUSH_PBF_BIT_POS 54
#define FEAT_LSTO_CHG_EVT_BIT_POS 56
#define FEAT_INQ_TXPWR_BIT_POS 57
#define FEAT_EPC_BIT_POS 58
#define FEAT_EXT_FEATS_BIT_POS 63
#define FEAT_SSP_HOST_BIT_POS 64
#define FEAT_LE_HOST_BIT_POS 65
#define FEAT_LE_BR_EDR_HOST_BIT_POS 66
#define FEAT_SEC_CON_HOST_BIT_POS 67
#define FEAT_CSB_MASTER_BIT_POS 128
#define FEAT_CSB_SLAVE_BIT_POS 129
#define FEAT_SYNC_TRAIN_BIT_POS 130
#define FEAT_SYNC_SCAN_BIT_POS 131
#define FEAT_INQ_RES_NOTIF_EVT_BIT_POS 132
#define FEAT_GEN_INTERL_SCAN_BIT_POS 133
#define FEAT_COARSE_CLK_ADJ_BIT_POS 134
#define FEAT_SEC_CON_CTRL_BIT_POS 136
#define FEAT_PING_BIT_POS 137
#define FEAT_SAM_BIT_POS 138
#define FEAT_TRAIN_NUDGING_BIT_POS 139
/// Maximum number of feature bits per page (8 bytes x 8 bits)
#define MAX_FEAT_BITS_PER_PAGE 64
/// Poll interval defines LMP:5.2
#define POLL_INTERVAL_MIN 0x0006
#ifdef BT_SIMULATION
#define POLL_INTERVAL_DFT 0x0008
#else
#define POLL_INTERVAL_DFT 0x0028
#endif
#define POLL_INTERVAL_MAX 0x1000
/// Power Adjustment Request LMP:5.2
#define PWR_ADJ_REQ_DEC_1_STEP 0x00
#define PWR_ADJ_REQ_INC_1_STEP 0x01
#define PWR_ADJ_REQ_INC_MAX 0x02
/// Power Adjustment Response LMP:5.2
#define PWR_ADJ_RES_GFSK_POS 0
#define PWR_ADJ_RES_GFSK_MASK 0x03
#define PWR_ADJ_RES_DQPSK_POS 2
#define PWR_ADJ_RES_DQPSK_MASK 0x0C
#define PWR_ADJ_RES_8DPSK_POS 4
#define PWR_ADJ_RES_8DPSK_MASK 0x30
#define PWR_ADJ_RES_NOT_SUPP 0x00
#define PWR_ADJ_RES_CHG_1_STEP 0x01
#define PWR_ADJ_RES_MAX 0x02
#define PWR_ADJ_RES_MIN 0x03
/// Nb of Broadcast retransmissions defines
#define NB_BROADCAST_DFT 0x01
/// Nb of Broadcast CLK_ADJ PDU Baseband:4.1.14.1
#define NB_BROADCAST_CLK_ADJ 0x06
/// Min PCA clk_adj_instant (in slots) LMP:4.1.14.1
#define PCA_INSTANT_MIN 12
/// Piconet Clock Adjustment clk_adj_mode LMP:4.1.14.1
#define CLK_ADJ_BEFORE_INSTANT 0
#define CLK_ADJ_AFTER_INSTANT 1
/// Different packet types BaseBand:6.7
/* Packet and buffer sizes. These sizes do not include payload header (except for FHS
* packet where there is no payload header) since payload header is written or read by
* the RWBT in a different control structure part (TX/RXPHDR) */
#define FHS_PACKET_SIZE 18
#define DM1_PACKET_SIZE 17
#define DH1_PACKET_SIZE 27
#define DH1_2_PACKET_SIZE 54
#define DH1_3_PACKET_SIZE 83
#define DV_ACL_PACKET_SIZE 9
#define DM3_PACKET_SIZE 121
#define DH3_PACKET_SIZE 183
#define DH3_2_PACKET_SIZE 367
#define DH3_3_PACKET_SIZE 552
#define DM5_PACKET_SIZE 224
#define DH5_PACKET_SIZE 339
#define DH5_2_PACKET_SIZE 679
#define DH5_3_PACKET_SIZE 1021
#define AUX1_PACKET_SIZE 29
#define HV1_PACKET_SIZE 10
#define HV2_PACKET_SIZE 20
#define HV3_PACKET_SIZE 30
#define EV3_PACKET_SIZE 30
#define EV3_2_PACKET_SIZE 60
#define EV3_3_PACKET_SIZE 90
#define EV4_PACKET_SIZE 120
#define EV5_PACKET_SIZE 180
#define EV5_2_PACKET_SIZE 360
#define EV5_3_PACKET_SIZE 540
/// SCO Packet coding LMP:5.2
#define SCO_PACKET_HV1 0x00
#define SCO_PACKET_HV2 0x01
#define SCO_PACKET_HV3 0x02
/// eSCO Packet coding LMP:5.2
#define ESCO_PACKET_NULL 0x00
#define ESCO_PACKET_EV3 0x07
#define ESCO_PACKET_EV4 0x0C
#define ESCO_PACKET_EV5 0x0D
#define ESCO_PACKET_EV3_2 0x26
#define ESCO_PACKET_EV3_3 0x37
#define ESCO_PACKET_EV5_2 0x2C
#define ESCO_PACKET_EV5_3 0x3D
/// Max number of HV packet BaseBand:4.4.2.1
#define MAX_NB_HV1 1
#define MAX_NB_HV2 2
#define MAX_NB_HV3 3
/// Tsco (ScoInterval) BaseBand:4.4.2.1
#define TSCO_HV1 2
#define TSCO_HV2 4
#define TSCO_HV3 6
/* Inquiry train repetition length , Baseband :Table 10.4
* - 256 repetitions if no SCO
* - 512 repetitions if 1 SCO
* - 768 repetitions if 2 SCO */
#define INQ_TRAIN_LENGTH_NO_SCO 256
#define INQ_TRAIN_LENGTH_1_SCO 512
#define INQ_TRAIN_LENGTH_2_SCO 768
/* Counter for train length, Npage (N*16 slots) depends on the slave page scan mode and
* the number of active SCO:
* | SR mode | no SCO | one SCO | two SCO |
* | R0 | >=1 | >=2 | >=3 |
* | R1 | >=128 | >=256 | >=384 |
* | R2 | >=256 | >=512 | >=768 | */
#define PAGE_TRAIN_LENGTH_R0 1
#define PAGE_TRAIN_LENGTH_R1 128
#define PAGE_TRAIN_LENGTH_R2 256
/// Synchronisation defines
#define NORMAL_SYNC_POS (64 + 4) // End of Synchro word at bit 68 (64 + 4)
#define SLOT_SIZE 625 // A slot is 625 us
#define HALF_SLOT_SIZE 625 // A half slot is 312.5 us (in half us)
#define HALF_SLOT_TIME_MIN (0) // Minimum offset within a half-slot is 0 half-us
#define HALF_SLOT_TIME_MAX (HALF_SLOT_SIZE - 1) // Maximum offset within a half-slot is 624 half-us
/// Baseband timeout default value, Baseband timers: 1.1
#define PAGE_RESP_TO_DEF 8
#define INQ_RESP_TO_DEF 128
#define NEW_CONNECTION_TO 32
/// LMP Response Timeout (in sec)
#define LMP_RSP_TO 30
/// LLCP Response Timeout (in units of 10 ms)
#define LLCP_RSP_TO 4000 // 40 secs
/// Athenticated Payload Timeout (in units of 10 ms)
#define AUTH_PAYL_TO_DFT 0x0BB8 // 30 secs
#define AUTH_PAYL_TO_MIN 0x0001
/// Voice mute pattern defines
#define MU_LAW_MUTE 0xFF
#define ALAW_CVSD_MUTE 0x55
#define TRANSP_MUTE 0x00
/// Air Mode LMP:5.2
#define MU_LAW_MODE 0
#define A_LAW_MODE 1
#define CVSD_MODE 2
#define TRANS_MODE 3
/// eSCO negotiation State LMP:5.2
#define ESCO_NEGO_INIT 0
#define ESCO_NEGO_LATEST_POSSIBLE 1
#define ESCO_NEGO_SLOT_VIOLATION 2
#define ESCO_NEGO_LAT_VIOLATION 3
#define ESCO_NEGO_UNSUPPORTED 4
#define SCO_BANDWIDTH 8000
#define SYNC_BANDWIDTH_DONT_CARE 0xFFFFFFFF
#define SYNC_MIN_LATENCY 0x0004
#define SYNC_MAX_LATENCY_ESCO_S1 0x0007
#define SYNC_MAX_LATENCY_ESCO_S2 0x0007
#define SYNC_MAX_LATENCY_ESCO_S3 0x000A
#define SYNC_DONT_CARE_LATENCY 0xFFFF
#define SYNC_NO_RE_TX 0x00
#define SYNC_RE_TX_POWER 0x01
#define SYNC_RE_TX_QUALITY 0x02
#define SYNC_RE_TX_DONT_CARE 0xFF
/// Timing Control Flags LMP:5.2
#define TIM_CHANGE_FLAG 0x01
#define INIT2_FLAG 0x02
#define ACCESS_WIN_FLAG 0x04
/// Sniff request parameters LMP:5.2
#define SNIFF_INTERVAL_MIN 0x0006
#define SNIFF_INTERVAL_MAX 0x0540
#define SNIFF_TIMEOUT_MAX 0x0028
/// Packet Type Table defines LMP:4.1.11
#define PACKET_TABLE_1MBPS 0x00
#define PACKET_TABLE_2_3MBPS 0x01
/// Data Rate defines LMP:5.2
#define FEC_RATE_MSK 0x01
#define USE_FEC_RATE 0x00
#define NO_FEC_RATE 0x01
#define PREF_PACK_MSK 0x06
#define NO_PREF_PACK_SIZE 0x00
#define USE_1_SLOT_PACKET 0x02
#define USE_3_SLOT_PACKET 0x04
#define USE_5_SLOT_PACKET 0x06
#define PREF_EDR_MSK 0x18
#define USE_DM1_ONLY 0x00
#define USE_2_MBPS_RATE 0x08
#define USE_3_MBPS_RATE 0x10
#define PREF_PACK_EDR_MSK 0x60
#define USE_1_SLOT_EDR_PKT 0x20
#define USE_3_SLOT_EDR_PKT 0x40
#define USE_5_SLOT_EDR_PKT 0x60
/// EIR Data Size HCI:6.24
#define EIR_DATA_SIZE 240
/// Voice setting HCI:4.7.29 & 4.7.30
#define INPUT_COD_LIN 0x0000
#define INPUT_COD_MULAW 0x0100
#define INPUT_COD_ALAW 0x0200
#define INPUT_COD_MSK 0x0300
#define INPUT_COD_OFF 8
#define INPUT_DATA_1COMP 0x0000
#define INPUT_DATA_2COMP 0x0040
#define INPUT_DATA_SMAG 0x0080
#define INPUT_DATA_UNSIGNED 0x00C0
#define INPUT_DATAFORM_MSK 0x00C0
#define INPUT_DATAFORM_OFF 6
#define INPUT_SAMP_8BIT 0x0000
#define INPUT_SAMP_16BIT 0x0020
#define INPUT_SAMPSIZE_MSK 0x0020
#define INPUT_SAMPSIZE_OFF 5
#define LIN_PCM_BIT_POS_MSK 0x001C
#define LIN_PCM_BIT_POS_OFF 2
#define AIR_COD_CVSD 0x0000
#define AIR_COD_MULAW 0x0001
#define AIR_COD_ALAW 0x0002
#define AIR_COD_TRANS 0x0003
#define AIR_COD_MSK 0x0003
#define AIR_COD_OFF 0
/// ScanEnable HCI:6.1
#define BOTH_SCAN_DISABLE 0
#define INQUIRY_SCAN_ENABLE 1
#define PAGE_SCAN_ENABLE 2
#define BOTH_SCAN_ENABLE 3
#ifdef BT_SIMULATION
/// PageScanInterval HCI:6.8
#define PAGE_SCAN_INTV_MIN 0x0008
#define PAGE_SCAN_INTV_MAX 0x1000
#define PAGE_SCAN_INTV_DFT 0x0011
/// PageScanWindow HCI:6.9
#define PAGE_SCAN_WIN_MIN 0x0008
#define PAGE_SCAN_WIN_MAX 0x1000
#define PAGE_SCAN_WIN_DFT 0x0008
/// InquiryScanInterval HCI:6.2
#define INQ_SCAN_INTV_MIN 0x0012
#define INQ_SCAN_INTV_MAX 0x1000
#define INQ_SCAN_INTV_DFT 0x1000
/// InquiryScanWindow HCI:6.3
#define INQ_SCAN_WIN_MIN 0x008
#define INQ_SCAN_WIN_MAX 0x1000
#define INQ_SCAN_WIN_DFT 0x0011
#else
/// PageScanInterval HCI:6.8
#define PAGE_SCAN_INTV_MIN 0x0012
#define PAGE_SCAN_INTV_MAX 0x1000
#define PAGE_SCAN_INTV_DFT 0x0800
/// PageScanWindow HCI:6.9
#define PAGE_SCAN_WIN_MIN 0x0011
#define PAGE_SCAN_WIN_MAX 0x1000
#define PAGE_SCAN_WIN_DFT 0x0012
/// InquiryScanInterval HCI:6.2
#define INQ_SCAN_INTV_MIN 0x0012
#define INQ_SCAN_INTV_MAX 0x1000
#define INQ_SCAN_INTV_DFT 0x1000
/// InquiryScanWindow HCI:6.3
#define INQ_SCAN_WIN_MIN 0x0011
#define INQ_SCAN_WIN_MAX 0x1000
#define INQ_SCAN_WIN_DFT 0x0012
#endif
/// General/Unlimited Inquiry Access Code (GIAC)
#define GIAC_LAP_0 0x33
#define GIAC_LAP_1 0x8B
#define GIAC_LAP_2 0x9E
/// Limited Dedicated Inquiry Access Code (LIAC)
#define LIAC_LAP_0 0x00
#define LIAC_LAP_1 0x8B
#define LIAC_LAP_2 0x9E
/// Maximum Dedicated Inquiry Access Code (DIAC MAX)
#define DIAC_MAX_LAP_0 0x3F
#define DIAC_MAX_LAP_1 0x8B
#define DIAC_MAX_LAP_2 0x9E
/// PIN Type HCI:6.13
#define VARIABLE_PIN 0
#define FIXED_PIN 1
/// ConnectionAcceptTimeout HCI:6.7
#define CON_ACCEPT_TO_MIN 0x00A0
#define CON_ACCEPT_TO_MAX 0xB540
#define CON_ACCEPT_TO_DFT 0x1FA0
/// PageTimeout HCI:6.6
#define PAGE_TO_MIN 0x0016
#define PAGE_TO_MAX 0xFFFF
#define PAGE_TO_DFT 0x2000
/// Clock offset valid flag in clock offset field HCI:7.1.5/7.1.19
#define CLK_OFFSET_VALID_FLAG_POS 15
#define CLK_OFFSET_VALID_FLAG_MSK 0x8000
/// AuthenticationEnable HCI:4.7.24
#define AUTH_DISABLED 0x00 // Default
#define AUTH_ENABLED 0x01
/// EncryptionMode HCI:4.7.26
#define ENC_DISABLED 0x00 // Default
#define ENC_PP_ENABLED 0x01
#define ENC_PP_BC_ENABLED 0x02
/// AutomaticFlushTimeout HCI:4.7.32
#define AUTO_FLUSH_TIMEOUT_MAX 0x07FF
#define AUTO_FLUSH_TIMEOUT_OFF 0x0000
#define AUTO_FLUSH_TIMEOUT_DFT AUTO_FLUSH_TIMEOUT_OFF // Default (no automatic flush timeout)
/// Link Supervision Time Out (in slots) HCI:6.21
#define LSTO_OFF 0x0000
#define LSTO_MIN 0x0001
#define LSTO_DFT 0x7D00 // Default is 20 s
#define LSTO_MAX 0xFFFF
/// PageScanRepetitionMode HCI:4.5.5
#define R0 0x00
#define R1 0x01
#define R2 0x02
#define PAGESCAN_REP_DEF R1 // Default
/// PageScanPeriodMode HCI:4.7.49
#define P0 0x00 // Default
#define P1 0x01
#define P2 0x02
/// PageScanMode HCI:4.7.51
#define MANDATORY_PAGE_SCAN_MODE 0x00 // Default
#define OPT_PAGE_SCAN_MODE_1 0x01
#define OPT_PAGE_SCAN_MODE_2 0x02
#define OPT_PAGE_SCAN_MODE_3 0x03
/// Encryption Enable HCI:4.5.17
#define ENCRYPTION_OFF 0x00
#define ENCRYPTION_ON 0x01
/// Country Code HCI:4.8.4
#define NORTH_AMERICA_EUROPE 0x00
#define FRANCE 0x01
#define SPAIN 0x02
#define JAPAN 0x03
/// Loopback mode HCI:7.6.2
#define NO_LOOPBACK 0x00 // Default
#define LOCAL_LOOPBACK 0x01
#define REMOTE_LOOPBACK 0x02
/// Erroneous Data Reporting HCI:7.3.65
#define ERR_DATA_REP_DIS 0x00 // Default
#define ERR_DATA_REP_EN 0x01
/// LM modes HCI:5.2.20
#define LM_ACTIVE_MODE 0x00
#define LM_HOLD_MODE 0x01
#define LM_SNIFF_MODE 0x02
#define LM_PARK_MODE 0x03
/// Key Type HCI:5.2.24
#define COMB_KEY 0
#define LOCAL_UNIT_KEY 1
#define REMOTE_UNIT_KEY 2
#define DEBUG_COMB_KEY 3
#define UNAUTH_COMB_KEY_192 4
#define AUTH_COMB_KEY_192 5
#define CHANGED_COMB_KEY 6
#define UNAUTH_COMB_KEY_256 7
#define AUTH_COMB_KEY_256 8
/// Key Flag HCI:5.4.18
#define SEMI_PERMANENT_KEY 0x00
#define TEMPORARY_KEY 0x01
/// QOS Service Type HCI:4.6.6
#define QOS_NO_TRAFFIC 0x00
#define QOS_BEST_EFFORT 0x01
#define QOS_GUARANTEED 0x02
#define QOS_NOTSPECIFIED 0xFF
#define QOS_WILD_CARD 0xFFFFFFFF
/// RSSI golden range
#define RSSI_GOLDEN_RG 0x00
/// Inquiry TX power level (in dBm) HCI:7.3.62
#define INQ_TX_PWR_DBM_MIN -70
#define INQ_TX_PWR_DBM_DFT 0
#define INQ_TX_PWR_DBM_MAX +20
/// Bluetooth Test Mode defines Bluetooth Test Mode: Table 3.2
#define PAUSE_MODE 0x00
#define TXTEST0_MODE 0x01
#define TXTEST1_MODE 0x02
#define TXTEST10_MODE 0x03
#define PRAND_MODE 0x04
#define ACLLOOP_MODE 0x05
#define SCOLOOP_MODE 0x06
#define ACLNOWHIT_MODE 0x07
#define SCONOWHIT_MODE 0x08
#define TXTEST1100_MODE 0x09
#define EXITTEST_MODE 0xFF
#define HOPSINGLE 0x00
#define HOPUSA 0x01
#define FIXTXPOW 0x00
#define ADAPTTXPOW 0x01
/// Maximum frequency value for test mode HCI:7.8.28
#define TEST_FREQ_MAX 39
/// Minimum PHY value for test mode HCI:7.8.50
#define TEST_PHY_MIN 0x01
/// Maximum PHY value for the receiver test mode HCI:7.8.50
#define RX_TEST_PHY_MAX 0x03
/// Maximum PHY value for the transmitter test mode HCI:7.8.51
#define TX_TEST_PHY_MAX 0x04
/// Packet type parameter bit field of LMP_test_control
#define LMP_TEST_CTRL_PKT_TYPE_CODE_POS 0
#define LMP_TEST_CTRL_PKT_TYPE_CODE_MSK 0x0F
#define LMP_TEST_CTRL_PKT_TYPE_LINK_POS 4
#define LMP_TEST_CTRL_PKT_TYPE_LINK_MSK 0xF0
#define TEST_ACLSCO 0
#define TEST_ESCO 1
#define TEST_EDRACL 2
#define TEST_EDRESCO 3
/// LMP_encapsulated_header parameters LMP:5.3
#define LMP_ENCAPS_P192_MAJ_TYPE 1
#define LMP_ENCAPS_P192_MIN_TYPE 1
#define LMP_ENCAPS_P192_PAYL_LEN 48
#define LMP_ENCAPS_P192_PAYL_NB 3
#define LMP_ENCAPS_P256_MAJ_TYPE 1
#define LMP_ENCAPS_P256_MIN_TYPE 2
#define LMP_ENCAPS_P256_PAYL_LEN 64
#define LMP_ENCAPS_P256_PAYL_NB 4
/// Number of bits in the passkey code used during Secure Simple Pairing
#define SSP_PASSKEY_NB_BITS 20
// Event Filter HCI 4.7.3
/// Filter type
#define CLEAR_ALL_FILTER_TYPE 0x00
#define INQUIRY_FILTER_TYPE 0x01
#define CONNECTION_FILTER_TYPE 0x02
/// Filter size
#define CLEAR_ALL_FILTER_SIZE 0
/// Inquiry & Connection Setup Filter Condition Type
#define ALL_FILTER_CONDITION_TYPE 0x00
#define CLASS_FILTER_CONDITION_TYPE 0x01
#define BD_ADDR_FILTER_CONDITION_TYPE 0x02
/// Auto Accept Flag
#define DO_NOT_AUTO_ACCEPT_CONNECTION 0x01
#define ACCEPT_CONNECTION_SLAVE 0x02
#define ACCEPT_CONNECTION_MASTER 0x03
/// Event Mask HCI 4.7.1
#define NO_EVENTS_SPECIFIED_FILTER 0x00000000
#define INQUIRY_COMPLETE_EVENT_FILTER 0x00000001
#define INQUIRY_RESULT_EVENT_FILTER 0x00000002
#define CONNECTION_COMPLETE_EVENT_FILTER 0x00000004
#define CONNECTION_REQUEST_EVENT_FILTER 0x00000008
#define DISCONNECTION_COMPLETE_EVENT_FILTER 0x00000010
#define AUTHENTICATION_COMPLETE_EVENT_FILTER 0x00000020
#define REMOTE_NAME_REQUEST_COMPLETE_EVENT_FILTER 0x00000040
#define ENCRYPTION_CHANGE_EVENT_FILTER 0x00000080
#define CHANGE_CONNECTION_LINK_KEY_COMPLETE_EVENT_FILTER 0x00000100
#define MASTER_LINK_KEY_COMPLETE_EVENT_FILTER 0x00000200
#define READ_REMOTE_SUPPORTED_FEATURES_COMPLETE_EVENT_FILTER 0x00000400
#define READ_REMOTE_VERSION_INFORMATION_COMPLETE_EVENT_FILTER 0x00000800
#define QOS_SETUP_COMPLETE_EVENT_FILTER 0x00001000
#define COMMAND_COMPLETE_EVENT_FILTER 0x00002000 // Unchecked */
#define COMMAND_STATUS_EVENT_FILTER 0x00004000 // Unchecked */
#define HARDWARE_ERROR_EVENT_FILTER 0x00008000
#define FLUSH_OCCURRED_EVENT_FILTER 0x00010000
#define ROLE_CHANGE_EVENT_FILTER 0x00020000
#define NUMBER_OF_COMPLETED_PACKETS_EVENT_FILTER 0x00040000 // Unchecked */
#define MODE_CHANGE_EVENT_FILTER 0x00080000
#define RETURN_LINK_KEYS_EVENT_FILTER 0x00100000
#define PIN_CODE_REQUEST_EVENT_FILTER 0x00200000
#define LINK_KEY_REQUEST_EVENT_FILTER 0x00400000
#define LINK_KEY_NOTIFICATION_EVENT_FILTER 0x00800000
#define LOOPBACK_COMMAND_EVENT_FILTER 0x01000000 // Not implemented */
#define DATA_BUFFER_OVERFLOW_EVENT_FILTER 0x02000000
#define MAX_SLOTS_CHANGE_EVENT_FILTER 0x04000000
#define READ_CLOCK_OFFSET_COMPLETE_EVENT_FILTER 0x08000000
#define CONNECTION_PACKET_TYPE_CHANGED_EVENT_FILTER 0x10000000
#define QOS_VIOLATION_EVENT_FILTER 0x20000000
#define PAGE_SCAN_MODE_CHANGE_EVENT_FILTER 0x40000000 // Deprecated */
#define PAGE_SCAN_REPETITION_MODE_CHANGE_EVENT_FILTER 0x80000000
#define FLOW_SPECIFICATION_COMPLETE_EVENT_FILTER 0x00000001
#define INQUIRY_RESULT_WITH_RSSI_EVENT_FILTER 0x00000002
#define READ_REMOTE_EXTENDED_FEATURES_COMPLETE_EVENT_FILTER 0x00000004
#define SYNCHRONOUS_CONNECTION_COMPLETE_EVENT_FILTER 0x00000800
#define SYNCHRONOUS_CONNECTION_CHANGE_EVENT_FILTER 0x00001000
#define SNIFF_SUBRATING_EVENT_FILTER 0x00002000
#define EXTENDED_INQUIRY_RESULT_EVENT_FILTER 0x00004000
#define ENCRYPTION_KEY_REFRESH_COMPLETE_EVENT_FILTER 0x00008000
#define IO_CAPABILITY_REQUEST_EVENT_FILTER 0x00010000
#define IO_CAPABILITY_REQUEST_REPLY_EVENT_FILTER 0x00020000
#define USER_CONFIRMATION_REQUEST_EVENT_FILTER 0x00040000
#define USER_PASSKEY_REQUEST_EVENT_FILTER 0x00080000
#define REMOTE_OOB_DATA_REQUEST_EVENT_FILTER 0x00100000
#define SIMPLE_PAIRING_COMPLETE_EVENT_FILTER 0x00200000
#define LINK_SUPERVISION_TIMEOUT_CHANGE_EVENT_FILTER 0x00800000
#define ENHANCED_FLUSH_COMPLETE_EVENT_FILTER 0x01000000
#define USER_PASSKEY_NOTIFICATION_EVENT_FILTER 0x04000000
#define KEYPRESS_NOTIFICATION_EVENT_FILTER 0x08000000
#define REM_HOST_SUPPORTED_FEATURES_NOTIFICATION_EVENT_FILTER 0x10000000
/// HostControllerToHostFlowControl (ACL) HCI 7.3.40
#define FLOW_CONTROL_OFF 0x00
#define FLOW_CONTROL_ACL 0x01
#define FLOW_CONTROL_SCO 0x02
#define FLOW_CONTROL_ACL_SCO 0x03
/// SynchroinousFlowControlEnable (SCO) HCI 7.3.39
#define SYNC_FLOW_CONTROL_OFF 0x00
#define SYNC_FLOW_CONTROL_ON 0x01
/// Tx Power HCI:4.7.37
#define CURRENT_TX_POWER 0x00
#define MAX_TX_POWER 0x01
/// Flow_direction HCI:7.2.13
#define FLOW_DIR_OUT 0x00
#define FLOW_DIR_IN 0x01
/// Drift and Jitter default value LMP 5.2 (in ppm)
#define BLE_MAX_DRIFT_SLEEP 500
#define BT_MAX_DRIFT_SLEEP 250
#define JITTER_DFT 10
#define BT_MAX_DRIFT_ACTIVE 20 // BB:2.2.5
#define BLE_MAX_DRIFT_ACTIVE 50
/// MAX LP Clock Jitter allowed by the specification (in us) (Core 4.2 - vol 6, -B - 4.2.2)
#define BLE_MAX_JITTER (16)
/// Read Stored Link Key HCI:4.7.8
#define LINK_KEY_BD_ADDR 0x00
#define LINK_KEY_ALL 0x01
/// Read/Write Hold Mode Activity HCI:4.7.35 and 4.7.36
#define HOLD_MODE_ACTIV_DEFAULT 0x00
#define HOLD_MODE_ACTIV_SUSP_PAGE_SCAN 0x01
#define HOLD_MODE_ACTIV_SUSP_INQUIRY_SCAN 0x02
#define HOLD_MODE_ACTIV_SUSP_PERIODIC_INQ 0x04
#define HOLD_MODE_ACTIV_NOT_MASK 0xF8
/// AFH Mode
#define AFH_DISABLED 0x00
#define AFH_ENABLED 0x01
/// AFH Reporting Mode
#define AFH_REPORTING_DISABLED 0x00
#define AFH_REPORTING_ENABLED 0x01
/// AFH channel assessment Mode
#define AFH_CH_ASS_DISABLED 0x00
#define AFH_CH_ASS_ENABLED 0x01
/// AFH MIn/Max interval, in BT slots (1s - 30s)
#define AFH_REPORT_INTERVAL_MIN 0x0640
#define AFH_REPORT_INTERVAL_MAX 0xBB80
/// Channel classification values for frequency pairs
#define AFH_CH_CLASS_UNKNOWN 0x0
#define AFH_CH_CLASS_GOOD 0x1
#define AFH_CH_CLASS_RESERVED 0x2
#define AFH_CH_CLASS_BAD 0x3
/// Maximum number of frequencies used in adapted channel hopping sequence
#define AFH_NB_CHANNEL_MIN 20
#define AFH_NB_CHANNEL_MAX 79
/// Number of frequencies available in standard hopping sequence
#define HOP_NB_CHANNEL 79
/// Base frequency in MHz of first BT hop channel [f=2402+k MHz, k=0,...,78]
#define HOP_CHANNEL_BASE_MHZ 2402
/// Maximum number of frequencies used in synchronization train BB:2.6.4.8
#define SYNC_TRAIN_CHANNEL_NB 3
/// Indices of frequencies used in synchronization train
#define SYNC_TRAIN_CHANNEL_0 0
#define SYNC_TRAIN_CHANNEL_1 24
#define SYNC_TRAIN_CHANNEL_2 78
/// Maximum delay in synchronization train (in slots) BB:2.7.2
#define SYNC_TRAIN_DELAY_MAX_DFT 16
/// Maximum delay in synchronization train for Coarse clock adjustment (in slots) BB:2.7.2
#define SYNC_TRAIN_DELAY_MAX_CLK_ADJ 4
/// Synchronization train interval for Coarse clock adjustment (in slots) BB:2.7.2
#define SYNC_TRAIN_INTV_CLK_ADJ 32
/// Future CSB instant value offset for Coarse clock adjustment (in slots) BB: 8.11.2
#define SYNC_TRAIN_CSB_INSTANT_OFFSET_CLK_ADJ 1600
/// Minimum value for synchronization train interval (in slots) HCI:7.3.90
#define SYNC_TRAIN_INTV_MIN 0x20
/// Minimum value for synchronization train timeout (in slots) HCI:7.3.90
#define SYNC_TRAIN_TO_MIN 0x00000002
/// Maximum value for synchronization train timeout (in slots) HCI:7.3.90
#define SYNC_TRAIN_TO_MAX 0x07FFFFFE
/// Default value for synchronization train interval (in slots) HCI:6.36
#define SYNC_TRAIN_INTV_DEFAULT 0x80
/// Default value for synchronization train timeout (in slots) HCI:6.37
#define SYNC_TRAIN_TO_DEFAULT 0x0002EE00
/// Default value for synchronization scan timeout for CCA recovery mode (in slots) BB: Appendix B.1.8
#define SYNC_TRAIN_TO_CCA_RM_DEFAULT 0x8000
/// Default value for synchronization train service data HCI:6.39
#define SYNC_TRAIN_SVC_DATA_DEFAULT 0x00
/// Minimum value for synchronization scan timeout (in slots) HCI:7.1.52
#define SYNC_SCAN_TO_MIN 0x22
/// Minimum value for synchronization scan window (in slots) HCI:7.1.52
#define SYNC_SCAN_WIN_MIN 0x22
/// Minimum value for synchronization scan interval (in slots) HCI:7.1.52
#define SYNC_SCAN_INTV_MIN 0x02
/// Default value for synchronization scan timeout (in slots) BB: Apppendix B
#define SYNC_SCAN_TO_DEFAULT 0x2000
/// Default value for synchronization scan timeout for CCA recovery mode (in slots) BB: Appendix B.1.9
#define SYNC_SCAN_TO_CCA_RM_DEFAULT 0x8000
/// Recommended value for synchronization scan window (91.25ms) GAP: Appendix A
#define SYNC_SCAN_WIN_DEFAULT 0x0092
/// Recommended value for synchronization scan interval (320 ms) GAP: Appendix A
#define SYNC_SCAN_INTV_DEFAULT 0x0200
/// CSB receive enable HCI:7.1.50
#define CSB_RX_MODE_DIS 0x00
#define CSB_RX_MODE_EN 0x01
/// CSB fragment HCI:7.2.88
#define CSB_CONTINUATION_FRAGMENT 0
#define CSB_STARTING_FRAGMENT 1
#define CSB_ENDING_FRAGMENT 2
#define CSB_NO_FRAGMENTATION 3
/// CSB max fragment size HCI:7.2.88
#define CSB_FRAGMENT_SIZE_MAX 0xFF
/// MWS Channel_Enable
#define MWS_CHANNEL_DISABLED 0x00
#define MWS_CHANNEL_ENABLED 0x01
/// MWS Channel_Type
#define MWS_TDD_CHANNEL_TYPE 0x00
#define MWS_FDD_CHANNEL_TYPE 0x01
/// MWS Transport_Layer
#define MWS_SIGNALING_ONLY 0x00
#define MWS_WCI_1 0x01
#define MWS_WCI_2 0x02
#define MWS_TRANSPORT_TYPE_MAX 0x02
/// MWS PATTERN Index
#define MWS_PATTERN_INDEX_MAX 2
/// MWS PATTERN IntervalType
#define MWS_PATTERN_NO_TXRX 0
#define MWS_PATTERN_TX_ALLOWED 1
#define MWS_PATTERN_RX_ALLOWED 2
#define MWS_PATTERN_TXRX_ALLOWED 3
#define MWS_PATTERN_EXT_FRAME 4
#define MWS_PATTERN_TYPE_MAX 4
/// MWS Ext_Num_Periods
#define MWS_EXT_NUM_PERIODS_MIN 0x01
#define MWS_EXT_NUM_PERIODS_MAX 0x32
/// MWS Period_Type
#define MWS_PERIOD_TYPE_DOWNLINK 0x00
#define MWS_PERIOD_TYPE_UPLINK 0x01
#define MWS_PERIOD_TYPE_BIDIRECTIONAL 0x02
#define MWS_PERIOD_TYPE_GUARD_PERIOD 0x03
#define MWS_PERIOD_TYPE_RESERVED 0x04
/// MWS inactivity duration 7B(WCI-1):3.1.4.
#define MWS_INACT_DUR_INFINITE 0x1F
/// Simple pairing mode HCI:7.3.58/HCI:7.3.59
#define SP_MODE_DIS 0x00
#define SP_MODE_EN 0x01
/// Inquiry Scan Type and Page Scan Type HCI:6.4/HCI:6.11
#define STANDARD_SCAN 0x00
#define INTERLACED_SCAN 0x01
/// Default interlace offset used for frequency selection during interlaced inquiry/page scan BB:8.3.1/8.4.1
#define INTERLACE_OFFSET_DFT 16
/// Inquiry Mode
#define STANDARD_INQUIRY 0x00
#define RSSI_INQUIRY 0x01
#define EXTENDED_INQUIRY 0x02
/// Maximum number of link keys Host can write via HCI Write Stored Link Key Command
#define NB_LINK_KEY 0x0B
/// LMP Version
#define BT_LMP_V1_0 0
#define BT_LMP_V1_1 1
#define BT_LMP_V1_2 2
#define BT_LMP_V2_0 3
#define BT_LMP_V2_1 4
#define BT_LMP_V3_0 5
#define BT_LMP_V4_0 6
#define BT_LMP_V4_1 7
/// WhichClock parameter
#define LOCAL_CLOCK 0
#define PICONET_CLOCK 1
/// Clock Accuracy parameter
#define CLOCK_ACCURACY_UNKNOWN 0xFFFF
#define SP_PASSKEY_STARTED 0x00
#define SP_PASSKEY_DIGIT_ENTERED 0x01
#define SP_PASSKEY_DIGIT_ERASED 0x02
#define SP_PASSKEY_CLEARED 0x03
#define SP_PASSKEY_COMPLETED 0x04
// Flags for ld_util_get_nb_acl function
/// Flag for master link
#define MASTER_FLAG 0x01
/// Flag for slave link
#define SLAVE_FLAG 0x02
/// BLE packet info in bytes
#define BLE_PKT_HDR_LEN (2)
#define BLE_PKT_CRC_LEN (3)
#define BLE_PKT_ACCESS_LEN (4)
/// IFS duration in us
#define BLE_IFS_DUR (150)
/// MAFS duration in us
#define BLE_MAFS_DUR (300)
/// MSS duration in us
#define BLE_MSS_DUR (150)
/// Offset threshold in us, below which Offset Units is set to 0
#define OFFSET_THRESHOLD 245700
/// Maximum offset value (in us) that can be represented by the Sync Packet Offset
#define OFFSET_LIMIT 2457300
/// Offset adjust value in us
#define OFFSET_ADJUST 2457600
/// Maximum time difference (in us) between lastPaEventCount and EventCounter
#define OFFSET_DIFF_MAX 5000000
/// CTE defines
/**
* Sync CTE type, specifies whether to only sync to periodic advertising with certain types of
* Constant Tone Extension (HCI:7.8.67)
*/
enum sync_cte_type
{
NO_SYNC_AOA_BIT = (0x01) ,
NO_SYNC_AOA_POS = (0) ,
NO_SYNC_AOD_1US_BIT = (0x02) ,
NO_SYNC_AOD_1US_POS = (1) ,
NO_SYNC_AOD_2US_BIT = (0x04) ,
NO_SYNC_AOD_2US_POS = (2) ,
NO_SYNC_NO_CTE_BIT = (0x10) ,
NO_SYNC_NO_CTE_POS = (4) ,
};
/// Modulation index
#define STANDARD_MOD_IDX (0)
#define STABLE_MOD_IDX (1)
/// CTE length (in number of 8us periods)
#define NO_CTE (0)
#define CTE_LEN_MIN (0x02)
#define CTE_LEN_MAX (0x14)
/// CTE type
#define CTE_TYPE_AOA (0)
#define CTE_TYPE_AOD_1US (1)
#define CTE_TYPE_AOD_2US (2)
#define CTE_TYPE_NO_CTE (0xFF)
/// CTE types
enum cte_types
{
CTE_TYPES_AOA_BIT = (0x01) ,
CTE_TYPES_AOA_POS = (0) ,
CTE_TYPES_AOD_1US_BIT = (0x02) ,
CTE_TYPES_AOD_1US_POS = (1) ,
CTE_TYPES_AOD_2US_BIT = (0x04) ,
CTE_TYPES_AOD_2US_POS = (2) ,
};
/// Slot durations (in us)
#define SLOT_DUR_1US (1)
#define SLOT_DUR_2US (2)
/// Length of switching pattern
#define MIN_SWITCHING_PATTERN_LEN (0x02)
#define MAX_SWITCHING_PATTERN_LEN (0x4B)
/// CTE count
#define MIN_CTE_CNT (0x01)
#define MAX_CTE_CNT (0x10)
/// CTE enable
#define CTE_DIS (0)
#define CTE_EN (1)
/// Sampling enable
#define IQ_SAMPL_DIS (0)
#define IQ_SAMPL_EN (1)
/// CTE request interval (in number of connection events) HCI:7.8.85
#define CTE_ASAP (0x0000)
#define MIN_CTE_INTV (0x0001)
#define MAX_CTE_INTV (0xFFFF)
/// Supported switching sampling rates
#define AOD_TX_1_US (0x01)
#define AOD_RX_1_US (0x02)
#define AOA_RX_1_US (0x04)
/// Number of antennae
#define MIN_ANTENNAE_NUM (0x01)
#define MAX_ANTENNAE_NUM (0x4B)
/// Sample count
#define MIN_SAMPLE_CNT (0x09)
#define MAX_SAMPLE_CNT (0x52)
/// No valid sample available
#define NO_VALID_SAMPLE (0x80)
/// CTE packet status HCI:7.7.65.21
#define CTE_PKT_STAT_CRC_OK (0x00)
#define CTE_PKT_STAT_CRC_KO_LEN_USED (0x01)
#define CTE_PKT_STAT_CRC_KO_OTHER_WAY (0x02)
#define CTE_PKT_STAT_INSUF_RES (0xFF)
/// Periodic advertising sync transfer defines
/**
* Periodic advertising sync information reception mode HCI:7.8.91
* 0x00 - No attempt is made to synchronize to the periodic advertising and no HCI_LE_Periodic_Advertising_Sync_Transfer_Received event is sent to the Host.
* 0x01 - An HCI_LE_Periodic_Advertising_Sync_Transfer_Received event is sent to the Host. HCI_LE_Periodic_Advertising_Report events will be disabled.
* 0x02 - An HCI_LE_Periodic_Advertising_Sync_Transfer_Received event is sent to the Host. HCI_LE_Periodic_Advertising_Report events will be enabled.
*/
enum per_adv_sync_info_rec_mode
{
NO_SYNC = 0x00,
SYNC_REP_DIS = 0x01,
SYNC_REP_EN = 0x02,
};
/**
* Private key type HCI:7.8.93
* 0x00 - Use the generated private key
* 0x01 - Use the debug private key
*/
enum priv_key_type
{
USE_GEN_PRIV_KEY = 0x00,
USE_DBG_PRIV_KEY = 0x01,
};
/**
* Action on clock accuracy HCI:7.8.94
* 0x00 - Switch to a more accurate clock
* 0x01 - Switch to a less accurate clock
*/
enum clk_acc_action
{
SWITCH_TO_MORE_ACC_CLK = 0x00,
SWITCH_TO_LESS_ACC_CLK = 0x01,
};
/**
* Test mode transmit power level in dBm HCI:7.8.122
* -127 - Lowest transmit power level
* 20 - Highest transmit power level
* 0x7E - Minimum transmit power level
* 0x7F - Maximum transmit power level
*/
enum test_mode_tx_pwr_lvl
{
LOW_TX_PWR_LVL = -127,
HIGH_TX_PWR_LVL = 20,
MIN_TX_PWR_LVL = 0x7E,
MAX_TX_PWR_LVL = 0x7F,
};
/// BLE event mask
enum le_evt_mask
{
LE_EVT_MASK_CON_CMP_EVT_BIT = 0,
LE_EVT_MASK_CON_CMP_EVT_MSK = 0x00000001,
LE_EVT_MASK_ADV_REP_EVT_BIT = 1,
LE_EVT_MASK_ADV_REP_EVT_MSK = 0x00000002,
LE_EVT_MASK_CON_UPD_EVT_BIT = 2,
LE_EVT_MASK_CON_UPD_EVT_MSK = 0x00000004,
LE_EVT_MASK_CON_RD_REM_FEAT_EVT_BIT = 3,
LE_EVT_MASK_CON_RD_REM_FEAT_EVT_MSK = 0x00000008,
LE_EVT_MASK_LG_TR_KEY_REQ_EVT_BIT = 4,
LE_EVT_MASK_LG_TR_KEY_REQ_EVT_MSK = 0x00000010,
LE_EVT_MASK_REM_CON_PARA_REQ_EVT_BIT = 5,
LE_EVT_MASK_REM_CON_PARA_REQ_EVT_MSK = 0x00000020,
LE_EVT_MASK_DATA_LEN_CHG_EVT_BIT = 6,
LE_EVT_MASK_DATA_LEN_CHG_EVT_MSK = 0x00000040,
LE_EVT_MASK_RD_LOC_P256_PUB_KEY_CMP_EVT_BIT = 7,
LE_EVT_MASK_RD_LOC_P256_PUB_KEY_CMP_EVT_MSK = 0x00000080,
LE_EVT_MASK_GEN_DHKEY_CMP_EVT_BIT = 8,
LE_EVT_MASK_GEN_DHKEY_CMP_EVT_MSK = 0x00000100,
LE_EVT_MASK_ENH_CON_CMP_EVT_BIT = 9,
LE_EVT_MASK_ENH_CON_CMP_EVT_MSK = 0x00000200,
LE_EVT_MASK_DIR_ADV_REP_EVT_BIT = 10,
LE_EVT_MASK_DIR_ADV_REP_EVT_MSK = 0x00000400,
LE_EVT_MASK_PHY_UPD_CMP_EVT_BIT = 11,
LE_EVT_MASK_PHY_UPD_CMP_EVT_MSK = 0x00000800,
LE_EVT_MASK_EXT_ADV_REPORT_EVT_BIT = 12,
LE_EVT_MASK_EXT_ADV_REPORT_EVT_MSK = 0x00001000,
LE_EVT_MASK_PER_ADV_SYNC_EST_EVT_BIT = 13,
LE_EVT_MASK_PER_ADV_SYNC_EST_EVT_MSK = 0x00002000,
LE_EVT_MASK_PER_ADV_REPORT_EVT_BIT = 14,
LE_EVT_MASK_PER_ADV_REPORT_EVT_MSK = 0x00004000,
LE_EVT_MASK_PER_ADV_SYNC_LOST_EVT_BIT = 15,
LE_EVT_MASK_PER_ADV_SYNC_LOST_EVT_MSK = 0x00008000,
LE_EVT_MASK_EXT_SCAN_TIMEOUT_EVT_BIT = 16,
LE_EVT_MASK_EXT_SCAN_TIMEOUT_EVT_MSK = 0x00010000,
LE_EVT_MASK_EXT_ADV_SET_TERMINATED_EVT_BIT = 17,
LE_EVT_MASK_EVT_ADV_SET_TERMINATED_EVT_MSK = 0x00020000,
LE_EVT_MASK_SCAN_REQ_RECEIVED_EVT_BIT = 18,
LE_EVT_MASK_SCAN_REQ_RECEIVED_EVT_MSK = 0x00040000,
LE_EVT_MASK_CH_SEL_ALGO_EVT_BIT = 19,
LE_EVT_MASK_CH_SEL_ALGO_EVT_MSK = 0x00080000,
LE_EVT_MASK_CONLESS_IQ_REPORT_EVT_BIT = 20,
LE_EVT_MASK_CONLESS_IQ_REPORT_EVT_MSK = 0x00100000,
LE_EVT_MASK_CON_IQ_REPORT_EVT_BIT = 21,
LE_EVT_MASK_CON_IQ_REPORT_EVT_MSK = 0x00200000,
LE_EVT_MASK_CTE_REQ_FAILED_EVT_BIT = 22,
LE_EVT_MASK_CTE_REQ_FAILED_EVT_MSK = 0x00400000,
LE_EVT_MASK_PER_ADV_SYNC_TRANSF_REC_EVT_BIT = 23,
LE_EVT_MASK_PER_ADV_SYNC_TRANSF_REC_EVT_MSK = 0x00800000,
LE_EVT_MASK_CIS_EST_EVT_BIT = 24,
LE_EVT_MASK_CIS_EST_EVT_MSK = 0x01000000,
LE_EVT_MASK_CIS_REQ_EVT_BIT = 25,
LE_EVT_MASK_CIS_REQ_EVT_MSK = 0x02000000,
LE_EVT_MASK_CREATE_BIG_CMP_EVT_BIT = 26,
LE_EVT_MASK_CREATE_BIG_CMP_EVT_MSK = 0x04000000,
LE_EVT_MASK_TERM_BIG_CMP_EVT_BIT = 27,
LE_EVT_MASK_TERM_BIG_CMP_EVT_MSK = 0x08000000,
LE_EVT_MASK_BIG_SYNC_EST_EVT_BIT = 28,
LE_EVT_MASK_BIG_SYNC_EST_EVT_MSK = 0x10000000,
LE_EVT_MASK_BIG_SYNC_LOST_EVT_BIT = 29,
LE_EVT_MASK_BIG_SYNC_LOST_EVT_MSK = 0x20000000,
LE_EVT_MASK_REQ_PEER_SCA_CMP_EVT_BIT = 30,
LE_EVT_MASK_REQ_PEER_SCA_CMP_EVT_MSK = 0x40000000,
LE_EVT_MASK_PATH_LOSS_THRESHOLD_EVT_BIT = 31,
LE_EVT_MASK_PATH_LOSS_THRESHOLD_EVT_MSK = 0x80000000,
LE_EVT_MASK_TX_POWER_REP_EVT_BIT = 32,
LE_EVT_MASK_TX_POWER_REP_EVT_MSK = 0x100000000,
LE_EVT_MASK_BIGINFO_ADV_REP_EVT_BIT = 33,
LE_EVT_MASK_BIGINFO_ADV_REP_EVT_MSK = 0x200000000,
LE_EVT_MASK_DFT = 0x0000001F,
};
/// Enhanced Synchronous Connection HCI:7.1.41 & 7.1.42
#define CODING_FORMAT_ULAW 0x00
#define CODING_FORMAT_ALAW 0x01
#define CODING_FORMAT_CVSD 0x02
#define CODING_FORMAT_TRANSP 0x03
#define CODING_FORMAT_LINPCM 0x04
#define CODING_FORMAT_MSBC 0x05
#define CODING_FORMAT_VENDSPEC 0xFF
#define PCM_FORMAT_NA 0x00
#define PCM_FORMAT_1SCOMP 0x01
#define PCM_FORMAT_2SCOMP 0x02
#define PCM_FORMAT_SIGNMAG 0x03
#define PCM_FORMAT_UNSIGNED 0x04
#define PCM_SAMPLE_SIZE_8BITS 8
#define PCM_SAMPLE_SIZE_16BITS 16
#define AUDIO_DATA_PATH_HCI 0
#define AUDIO_DATA_PATH_PCM 1
/// Default maximum number of slots per packet
#define MAX_SLOT_DFT 1
/// Packet type code interpretation possibilities BB:6.5
#define ID_NUL_TYPE 0x0
#define POLL_TYPE 0x1
#define FHS_TYPE 0x2
#define DM1_TYPE 0x3
#define DH1_TYPE 0x4
#define DH1_2_TYPE 0x4
#define DH1_3_TYPE 0x8
#define HV1_TYPE 0x5
#define HV2_TYPE 0x6
#define EV3_2_TYPE 0x6
#define HV3_TYPE 0x7
#define EV3_TYPE 0x7
#define EV3_3_TYPE 0x7
#define DV_TYPE 0x8
#define AUX1_TYPE 0x9
#define DM3_TYPE 0xA
#define DH3_TYPE 0xB
#define DH3_2_TYPE 0xA
#define DH3_3_TYPE 0xB
#define EV4_TYPE 0xC
#define EV5_2_TYPE 0xC
#define EV5_TYPE 0xD
#define EV5_3_TYPE 0xD
#define DM5_TYPE 0xE
#define DH5_TYPE 0xF
#define DH5_2_TYPE 0xE
#define DH5_3_TYPE 0xF
/// Format of the FHS payload BB:6.5.1.4
#define FHS_PAR_BITS_POS 0
#define FHS_PAR_BITS_LEN 34
#define FHS_PAR_BITS_END (FHS_PAR_BITS_POS + FHS_PAR_BITS_LEN)
#define FHS_LAP_POS FHS_PAR_BITS_END
#define FHS_LAP_LEN 24
#define FHS_LAP_END (FHS_LAP_POS + FHS_LAP_LEN)
#define FHS_EIR_POS FHS_LAP_END
#define FHS_EIR_LEN 1
#define FHS_EIR_END (FHS_EIR_POS + FHS_EIR_LEN)
#define FHS_UNDEF_POS FHS_EIR_END
#define FHS_UNDEF_LEN 1
#define FHS_UNDEF_END (FHS_UNDEF_POS + FHS_UNDEF_LEN)
#define FHS_SR_POS FHS_UNDEF_END
#define FHS_SR_LEN 2
#define FHS_SR_END (FHS_SR_POS + FHS_SR_LEN)
#define FHS_RSVD_POS FHS_SR_END
#define FHS_RSVD_LEN 2
#define FHS_RSVD_END (FHS_RSVD_POS + FHS_RSVD_LEN)
#define FHS_UAP_POS FHS_RSVD_END
#define FHS_UAP_LEN 8
#define FHS_UAP_END (FHS_UAP_POS + FHS_UAP_LEN)
#define FHS_NAP_POS FHS_UAP_END
#define FHS_NAP_LEN 16
#define FHS_NAP_END (FHS_NAP_POS + FHS_NAP_LEN)
#define FHS_CLASS_OF_DEV_POS FHS_NAP_END
#define FHS_CLASS_OF_DEV_LEN 24
#define FHS_CLASS_OF_DEV_END (FHS_CLASS_OF_DEV_POS + FHS_CLASS_OF_DEV_LEN)
#define FHS_LT_ADDR_POS FHS_CLASS_OF_DEV_END
#define FHS_LT_ADDR_LEN 3
#define FHS_LT_ADDR_END (FHS_LT_ADDR_POS + FHS_LT_ADDR_LEN)
#define FHS_CLK_POS FHS_LT_ADDR_END
#define FHS_CLK_LEN 26
#define FHS_CLK_END (FHS_CLK_POS + FHS_CLK_LEN)
#define FHS_PAGE_SCAN_MODE_POS FHS_CLK_END
#define FHS_PAGE_SCAN_MODE_LEN 3
#define FHS_PAGE_SCAN_MODE_END (FHS_PAGE_SCAN_MODE_POS + FHS_PAGE_SCAN_MODE_LEN)
/// Format of the STP payload BB:8.11.2
#define STP_CLK_POS 0
#define STP_CLK_LEN 4
#define STP_FUT_CSB_INST_POS 4
#define STP_FUT_CSB_INST_LEN 4
#define STP_AFH_CH_MAP_POS 8
#define STP_AFH_CH_MAP_LEN 10
#define STP_MST_BD_ADDR_POS 18
#define STP_MST_BD_ADDR_LEN 6
#define STP_CSB_INTV_POS 24
#define STP_CSB_INTV_LEN 2
#define STP_CSB_LT_ADDR_POS 26
#define STP_CSB_LT_ADDR_LEN 1
#define STP_SVC_DATA_POS 27
#define STP_SVC_DATA_LEN 1
#define STP_PACKET_SIZE 28
/// CSB Receive status HCI:7.7.69
#define CSB_RX_OK 0x00
#define CSB_RX_KO 0x01
/// HCI 7.8.33 LE Set Data Length Command
/// Preferred minimum number of payload octets
#define LE_MIN_OCTETS (27)
/// Preferred minimum number of microseconds
#define LE_MIN_TIME (328)
/// Preferred minimum number of microseconds LL:4.5.10
#define LE_MIN_TIME_CODED (2704)
/// Preferred maximum number of payload octets
#define LE_MAX_OCTETS (251)
/// Preferred maximum number of microseconds
#define LE_MAX_TIME (2120)
/// Preferred maximum number of microseconds LL:4.5.10
#define LE_MAX_TIME_CODED (17040)
/// LE LL 2.1.2 Access Address
#define LE_ADV_CH_ACC_ADDR_H 0x8E89
#define LE_ADV_CH_ACC_ADDR_L 0xBED6
/// Resolvable private address timeout (in seconds) HCI:7.8.45
#define RPA_TO_MAX 0xA1B8 // approximately 11.5 hours
#define RPA_TO_DFT 0x0384 // 900 seconds or 15 minutes
#define RPA_TO_MIN 0x0001 // 1 second
/// Max scanning PHYs which can be set HCI:7.8.64
#if (BLE_SCAN_EXT)
#define MAX_SCAN_PHYS 1
#else // (BLE_SCAN_EXT)
#define MAX_SCAN_PHYS 2
#endif // (BLE_SCAN_EXT)
/// Max initiating PHYs which can be set HCI:7.8.66
#define MAX_INIT_PHYS 3
/// Ext Scanning interval (in 625us slot) (chapter 2.E.7.8.64)
#define EXT_SCAN_INTERVAL_MIN 0x0004 //(2.5 ms)
#define EXT_SCAN_INTERVAL_MAX 0xFFFF //(40.96 sec)
/// Ext Scanning window (in 625us slot) (chapter 2.E.7.8.64)
#define EXT_SCAN_WINDOW_MIN 0x0004 //(2.5 ms)
#define EXT_SCAN_WINDOW_MAX 0xFFFF //(40.96 sec)
/// Duration of 1MBPS PDU of specified payload length in microseconds (chapter 6.B.2.1)
#define PDU_1MBPS_LEN_US(n_bytes) ((8 + (2 + n_bytes))*8) // (1 + 4 + (2 + payload_len) + 3)*8
/// Duration of 2MBPS PDU of specified payload length in microseconds (chapter 6.B.2.1)
#define PDU_2MBPS_LEN_US(n_bytes) ((9 + (2 + n_bytes))*4) // (2 + 4 + (2 + payload_len) + 3)*4
/// Duration of 500KBPS PDU of specified payload length in microseconds (chapter 6.B.2.2)
#define PDU_500KBPS_LEN_US(n_bytes) (430 + (2 + n_bytes)*16) // 80 + 256 + 16 + 24 + (2 + payload_len)*8*2 + 24*2 + 3*2
/// Duration of 125KBPS PDU of specified payload length in microseconds (chapter 6.B.2.2)
#define PDU_125KBPS_LEN_US(n_bytes) (592 + (2 + n_bytes)*64) // 80 + 256 + 16 + 24 + (2 + payload_len)*8*8 + 24*8 + 3*8
/// Maximum length of BLE advertising channel PDU payloads ((chapter 6.B.2.3))
#define PDU_ADV_PAYLOAD_LEN_MAX 255
// The total amount of Host Advertising Data before fragmentation shall not exceed 1650 octets (chapter 6.B.2.3.4.9).
#define HOST_ADV_DATA_LEN_MAX 1650
/// SyncInfo Sync Packet Offset unspecified (chapter 6.B.2.3)
#define PER_SYNC_OFFSET_UNSPECIFIED 0
/// SyncInfo Sync Interval min in 1.25ms units (chapter 6.B.2.3)
#define PER_SYNC_INTERVAL_MIN 6 // (7.5ms)
/// Ext Adv Report - ADV SID - Define for no ADI filed in the PDU HCI:7.7.65.13
#define REP_ADV_NO_ADI 0xFF
/// Ext Adv Report - Tx Power & RSSI dBm - Define for information not available HCI:7.7.65.13
#define REP_ADV_DBM_UNKNOWN 127
/// Periodic Advertising Report - Unused parameter - mandatory value HCI:7.7.65.15
#define PER_ADV_REPORT_TRAIL_BYTE 0xFF
/// Maximum advertising handle HCI:7.8.53
#define ADV_HDL_MAX 0xEF
/// Maximum advertising Set ID HCI:7.8.53
#define ADV_SID_MAX 0x0F
/// Advertising_Tx_Power, Host has no preference HCI:7.8.53
#define ADV_TX_PWR_NO_PREF 127
/// Address type of devices sending anonymous advertisements, HCI 7.8.16
#define ANONYMOUS_ADV_ADDR_TYPE 0xFF
/// Invalid param_req offset, 2.4.2.16 LL_CONNECTION_PARAM_REQ
#define PARAM_REQ_INVALID_OFFSET 0xFFFF
/*
* ***********************************************************
* ISOCHRONOUS CHANNEL DEFINES
* ***********************************************************
*/
/// Maximum Payload Size value
#define BLE_ISO_MAX_PAYLOAD_SIZE (0xFB)
/// Minimum Number of Subevents value
#define BLE_ISO_MIN_NSE (0x01)
/// Maximum Number of Subevents value
#define BLE_ISO_MAX_NSE (0x1F)
/// Mask for PHY type value received from host
#define BLE_ISO_PHY_MASK (0x07)
/// Maximum SDU Size
#define BLE_ISO_MAX_SDU_SIZE (0xFFF)
/// Minimum SDU Interval (in microseconds)
#define BLE_ISO_MIN_SDU_INTERVAL (0x000FF)
/// Maximum SDU Interval (in microseconds)
#define BLE_ISO_MAX_SDU_INTERVAL (0xFFFFF)
/// Minimum Transport Latency (in milliseconds)
#define BLE_ISO_MIN_TRANS_LATENCY (0x0005)
/// Maximum Transport Latency (in milliseconds)
#define BLE_ISO_MAX_TRANS_LATENCY (0x0FA0)
/// Minimum ISO Interval value
#define BLE_ISO_MIN_INTERVAL (0x0004)
/// Maximum ISO Interval value
#define BLE_ISO_MAX_INTERVAL (0x0C80)
/// Maximum CIG ID value
#define BLE_CIG_MAX_ID (0xEF)
/// Maximum Channel ID value
#define BLE_CIS_MAX_ID (0xEF)
/// Minimum Flush Timeout value
#define BLE_CIS_MIN_FT (0x01)
/// Maximum Flush Timeout value
#define BLE_CIS_MAX_FT (0xFF)
/// Maximum Burst Number value
#define BLE_CIS_MAX_BN (0x0F)
/// Minimum CIS offset value - 500us
#define BLE_CIS_MIN_OFFSET (500)
/// Minimum Subevent interval value - 400us
#define BLE_CIS_MIN_SUBEVENT_INTV (400)
/// Maximum number of retransmission
#define BLE_CIS_MAX_RTN (0x0F)
/// Maximum BIG Handle value
#define BLE_BIG_MAX_HANDLE (0xEF)
/// Maximum BIG Control PDU length, currently the number of payload bytes in a BIG_CHANNEL_MAP_IND
#define BLE_BIG_MAX_CTRL_PDU_LEN (0x08)
/// Minimum BIS Number value
#define BLE_BIS_MIN_NB (0x01)
/// Maximum BIS Number value
#define BLE_BIS_MAX_NB (0x1F)
/// Minimum Burst Number value for BIS
#define BLE_BIS_MIN_BN (0x01)
/// Maximum Burst Number value for BIS
#define BLE_BIS_MAX_BN (0x07)
/// Minimum Number of Immediate Retransmission Count value
#define BLE_BIS_MIN_IRC (0x01)
/// Maximum Number of Immediate Retransmission Count value
#define BLE_BIS_MAX_IRC (0x0F)
/// Maximum Number of Pre-Transmission Offset value
#define BLE_BIS_MAX_PTO (0x0F)
/// Size of payload count
#define BLE_PLD_CNT_SIZE (5)
/// Invalid connection link id
#define BLE_INVALID_LINK_ID (0xFF)
/// Invalid channel handle
#define BLE_INVALID_CHANHDL (0xFF)
/// Invalid Group handle
#define BLE_INVALID_GROUP_HDL (0xFF)
/// Invalid Isochronous handle
#define BLE_INVALID_ISOHDL (0xFFFF)
/// segmentation header size
#define BLE_ISOAL_SEG_HEADER_SIZE (2)
/// Time offset information header size
#define BLE_ISOAL_TIME_OFFSET_SIZE (3)
/// LLID of isochronous channel PDU
enum iso_llid
{
/// 0b00 = Unframed CIS Data PDU; end fragment of an SDU or a complete SDU.
/// 0b00 = Unframed BIS Data PDU; end fragment of an SDU or a complete SDU.
LLID_UNFRAMED_END = 0,
/// 0b01 = Unframed CIS Data PDU; start or continuation fragment of an SDU.
/// 0b01 = Unframed BIS Data PDU; start or continuation fragment of an SDU.
LLID_UNFRAMED_CONT = 1,
/// 0b10 = Framed CIS Data PDU; one or more segments of an SDU.
/// 0b10 = Framed BIS Data PDU; one or more segments of an SDU.
LLID_FRAMED_SEG = 2,
/// 0b11 = Reserved for future use.
/// 0b11 = BIG Control PDU.
LLID_ISO_RFU = 3,
};
/// Isochronous Channel Direction selection
enum iso_rx_tx_select
{
/// Isochronous tx buffer selection: Host to Controller
ISO_SEL_TX,
/// Isochronous rx buffer selection: Controller to Host
ISO_SEL_RX,
ISO_SEL_MAX,
};
/// Isochronous Group packing preference
enum iso_packing
{
/// Sequential stream packing
ISO_PACKING_SEQUENTIAL = 0,
/// Interleaved stream packing
ISO_PACKING_INTERLEAVED,
ISO_PACKING_MAX,
};
/// Isochronous PDU Framing mode
enum iso_frame
{
/// Unframed mode
ISO_UNFRAMED_MODE = 0,
/// Framed mode
ISO_FRAMED_MODE,
ISO_FRAME_MODE_MAX,
};
/// Segmentation header of framed PDU
enum iso_seg_header
{
/// The Start or Continuation (SC) field indicates that the data following the Segmentation Header is the start of
/// a new SDU or the continuation of a previous SDU.
/// When SC is set to 0, it indicates the start of a new SDU and that the data that follows the header is part
/// of a new SDU.
/// If SC is set to 1, it indicates a continuation of an SDU that was partially transmitted in a previous
/// isochronous PDU.
ISO_SEG_HDR_SC_POS = 0,
ISO_SEG_HDR_SC_BIT = 0x0001,
/// The Completion (CMPLT) field indicates that the segment following the Segmentation Header in the PDU is the end
/// segment of an SDU.
/// When CMPLT is set to 0, not all data of the SDU has been included in the current PDU. One or more additional
/// framed PDUs are required to complete the SDU transfer.
/// When CMPLT is set to 1, all data of the SDU is included in the segment and the SDU may be transferred to the
/// higher layer.
ISO_SEG_HDR_CMPLT_POS = 1,
ISO_SEG_HDR_CMPLT_BIT = 0x0002,
/// The length field indicates the size, in octets, of the segment that follows the Segmentation Header
/// in this PDU and, when present, includes the Time_Offset parameter.
ISO_SEG_HDR_LENGTH_LSB = 8,
ISO_SEG_HDR_LENGTH_MASK = 0xFF00,
};
/*
* ENUMERATIONS
****************************************************************************************
*/
/// Specify if Host has no preference into all_phys parameter HCI:7.8.48 / HCI:7.8.49
enum le_phys_preference
{
/// The Host has no preference among the transmitter PHYs supported by the Controller
ALL_PHYS_TX_NO_PREF = (1 << 0),
/// The Host has no preference among the receiver PHYs supported by the Controller
ALL_PHYS_RX_NO_PREF = (1 << 1),
};
/// Specify what PHY the Controller has changed for TX/RX. HCI:7.7.65.12
/*@TRACE*/
enum le_phy_value
{
PHY_UNDEF_VALUE = 0,
PHY_1MBPS_VALUE = 1,
PHY_2MBPS_VALUE = 2,
PHY_CODED_VALUE = 3,
};
/// Specify what PHY Host prefers to use for RX or TX HCI:7.8.48 / HCI:7.8.49
enum le_phy_mask
{
/// The Host prefers to use the LE 1M transmitter/receiver PHY (possibly among others)
PHY_1MBPS_BIT = (1<<0),
PHY_1MBPS_POS = (0),
/// The Host prefers to use the LE 2M transmitter/receiver PHY (possibly among others)
PHY_2MBPS_BIT = (1<<1),
PHY_2MBPS_POS = (1),
/// The Host prefers to use the LE Coded transmitter/receiver PHY (possibly among others)
PHY_CODED_BIT = (1<<2),
PHY_CODED_POS = (2),
/// The Host prefers to use the LE Coded transmitter/receiver PHY (possibly among others)
PHY_ALL = (PHY_1MBPS_BIT | PHY_2MBPS_BIT | PHY_CODED_BIT),
};
/// Specify what rate Host prefers to use in transmission on coded PHY. HCI:7.8.49
enum le_phy_opt
{
/// The Host has no preferred coding when transmitting on the LE Coded PHY
PHY_OPT_NO_LE_CODED_TX_PREF,
/// The Host prefers that S=2 coding be used when transmitting on the LE Coded PHY
PHY_OPT_S2_LE_CODED_TX_PREF,
/// The Host prefers that S=8 coding be used when transmitting on the LE Coded PHY
PHY_OPT_S8_LE_CODED_TX_PREF,
};
enum le_phy_mode
{
PHYS_MOD_STANDARD ,
PHYS_MOD_STABLE ,
PHYS_MOD_MAX,
};
///Transmit Power level types. HCI:7.3.35
enum
{
///Current Power Level
TX_PW_LVL_CURRENT = 0x00,
///Maximum power level
TX_PW_LVL_MAX,
};
/// Specify which PHY the Controller is specifying transmit power. HCI:7.8.117 / HCI:7.8.118
enum le_phy_pwr_value
{
PHY_PWR_1MBPS_VALUE = 1,
PHY_PWR_2MBPS_VALUE = 2,
PHY_PWR_S8_CODED_VALUE = 3,
PHY_PWR_S2_CODED_VALUE = 4,
};
/// Specify what PHY is selected for power control LL:2.4.2.33 LL:2.4.2.35
enum le_phy_pwr_mask
{
/// Specifies 1MBPS power level (possibly among others)
PHY_PWR_1MBPS_BIT = (1<<0),
PHY_PWR_1MBPS_POS = (0),
/// Specifies 2MBSP power level (possibly among others)
PHY_PWR_2MBPS_BIT = (1<<1),
PHY_PWR_2MBPS_POS = (1),
/// Specifies coded phy with S=8 data coding (possibly among others)
PHY_PWR_S8_CODED_BIT = (1<<2),
PHY_PWR_S8_CODED_POS = (2),
/// Specifies coded phy with S=8 data coding (possibly among others)
PHY_PWR_S2_CODED_BIT = (1<<3),
PHY_PWR_S2_CODED_POS = (3),
/// Specifies all PHY
PHY_PWR_ALL = (PHY_PWR_1MBPS_BIT | PHY_PWR_2MBPS_BIT | PHY_PWR_S8_CODED_BIT | PHY_PWR_S2_CODED_BIT),
};
/// ISO Tx/Rx test payload type HCI:7.8.111 / HCI:7.8.112
enum le_iso_test_payl_type
{
ISO_TEST_ZERO_LEN = 0,
ISO_TEST_VARIABLE_LEN = 1,
ISO_TEST_MAX_LEN = 2,
};
/// ISO Tx/Rx test packet counter size in octets LL:7 ISO_TEST_MODE
#define ISO_TEST_PKT_CNT_SIZE 4
/// Maximum path loss configuraable (threshold+hysteresis) for path loss monitoring. HCI:7.8.119
#define PHY_PATH_LOSS_MAX 0xFF
/// Power Control Bit Field parameters. LL:2.4.2.34, LL:2.4.2.35, HCI:7.7.65.3
enum pwr_ctrl_flags
{
/// bit[0] - Sender is at the minimum supported power level
BLE_PWR_CTRL_MIN_BIT = 0x01,
BLE_PWR_CTRL_MIN_POS = 0,
/// bit[1] - Sender is at the maximum supported power level
BLE_PWR_CTRL_MAX_BIT = 0x02,
BLE_PWR_CTRL_MAX_POS = 1,
};
/// Acceptable Power Reduction unable to determine a value. LL:2.4.2.34
#define PWR_CTRL_APR_UNKNOWN 0xFF
/// Delta requested MAX for the recipiant's transmit power. LL: 2.4.2.33
#define PWR_CTRL_DELTA_MAX 0x7F
/// Minimum number of connection events after an APR before sending new power control. LL 5.1.17.1
#define PWR_CTRL_EVT_CNT_MIN 2
/// Power Control Tx Power special values. LL:2.4.2.33, LL:5.1.17, HCI:7.7.65.3
enum
{
BLE_PWR_CTRL_UNUSED = 0x7E,
BLE_PWR_UNKNOWN = 0x7F,
};
/// Transmit Power reporting event reason. HCI:7.7.65.33
enum pwr_report_reason
{
BLE_PWR_LOC_TX_CHG = 0x00,
BLE_PWR_REM_TX_CHG = 0x01,
BLE_PWR_HCI_REQ = 0x02,
};
/// Transmit Power reporting enable. HCI:7.8.121
enum pwr_report_en
{
/// Disable transmit power reports
BLE_TX_PWR_REP_DIS = 0,
BLE_TX_PWR_REP_EN = 1,
};
/// Path Loss zones. HCI:7.8.118
enum le_path_loss_zone
{
/// Entered Low zone
BLE_PATH_LOSS_LOW = 0,
/// Entered Middle zone
BLE_PATH_LOSS_MID = 1,
/// Entered High zone
BLE_PATH_LOSS_HIGH = 2,
};
///Controller to Host flow control
enum
{
/// C-> H flow control off
FLOW_CTRL_OFF = 0x00,
///C->H ACL flow control on only
FLOW_CTRL_ON_ACL_OFF_SYNC,
///C->H Sync flow control on only
FLOW_CTRL_OFF_ACL_ON_SYNC,
///C->H ACL and Sync flow control on
FLOW_CTRL_ON_ACL_ON_SYNC,
};
///LE Supported Host enable
enum
{
///Disable LE supported Host
LE_SUPP_HOST_DIS = 0x00,
///Enable LE Supported Host
LE_SUPP_HOST_EN,
};
///Simultaneous LE Host enable
enum
{
///Disable LE simultaneous Host disable
SIMULT_LE_HOST_DIS = 0x00,
///Enable LE simultaneous Host disable
SIMULT_LE_HOST_EN,
};
///Advertising HCI Type
enum
{
///Connectable Undirected advertising
ADV_CONN_UNDIR = 0x00,
///Connectable high duty cycle directed advertising
ADV_CONN_DIR,
///Discoverable undirected advertising
ADV_DISC_UNDIR,
///Non-connectable undirected advertising
ADV_NONCONN_UNDIR,
///Connectable low duty cycle directed advertising
ADV_CONN_DIR_LDC,
};
///Advertising event properties values for legacy PDUs
enum
{
///Connectable and scannable undirected
ADV_IND = 0x13,
///Connectable directed (low duty cycle)
ADV_DIRECT_LO_IND = 0x15,
///Connectable directed (high duty cycle)
ADV_DIRECT_HI_IND = 0x1D,
///Connectable directed (received)
ADV_DIRECT_IND = 0x15,
///Scannable undirected
ADV_SCAN_IND = 0x12,
///Non-connectable and non-scannable undirected
ADV_NONCONN_IND = 0x10,
///Scan response to an ADV_IND
SCAN_RSP_TO_ADV_IND = 0x1B,
///Scan response to an ADV_SCAN_IND
SCAN_RSP_TO_ADV_SCAN_IND = 0x1A,
};
///Advertising event properties masks
enum
{
///Connectable advertising
ADV_CON = 0x01,
///Scannable advertising
ADV_SCAN = 0x02,
///Directed advertising
ADV_DIRECT = 0x04,
///High duty cycle directed connectable advertising
ADV_DIRECT_HI = 0x08,
///Use legacy advertising PDUs
ADV_LEGACY = 0x10,
///Omit advertiser's address from all PDUs ("anonymous advertising")
ADV_ANONYMOUS = 0x20,
///Include TxPower in the extended header of the advertising PDU
ADV_TX_PWR = 0x40,
};
///Scanning HCI Type
enum
{
///Scan request
SCAN_REQ,
///Scan response
SCAN_RSP,
};
///BD address type
enum addr_type
{
///Public BD address
ADDR_PUBLIC = 0x00,
///Random BD Address
ADDR_RAND,
/// Controller generates Resolvable Private Address based on the
/// local IRK from resolving list. If resolving list contains no matching
/// entry, use public address.
ADDR_RPA_OR_PUBLIC,
/// Controller generates Resolvable Private Address based on the
/// local IRK from resolving list. If resolving list contains no matching
/// entry, use random address.
ADDR_RPA_OR_RAND,
/// mask used to determine Address type in the air
ADDR_MASK = 0x01,
/// mask used to determine if an address is an RPA
ADDR_RPA_MASK = 0x02,
/// Random device address (controller unable to resolve)
ADDR_RAND_UNRESOLVED = 0xFE,
/// No address provided (anonymous advertisement)
ADDR_NONE = 0xFF,
};
///Privacy mode type
enum
{
///Network privacy mode
PRIV_TYPE_NETWORK = 0x00,
///Device privacy mode
PRIV_TYPE_DEVICE = 0x01,
};
/// Random Address type (2 MSB of the LE BD Address)
enum rnd_addr_type
{
/// Static random address - 11 (MSB->LSB)
RND_STATIC_ADDR = 0xC0,
/// Private non resolvable address - 00 (MSB->LSB)
RND_NON_RSLV_ADDR = 0x00,
/// Private resolvable address - 01 (MSB->LSB)
RND_RSLV_ADDR = 0x40,
};
///Advertising channels enables
enum adv_channel_map
{
///Byte value for advertising channel map for channel 37 enable
ADV_CHNL_37_EN = 0x01,
///Byte value for advertising channel map for channel 38 enable
ADV_CHNL_38_EN = 0x02,
///Byte value for advertising channel map for channel 39 enable
ADV_CHNL_39_EN = 0x04,
///Byte value for advertising channel map for channel 37, 38 and 39 enable
ADV_ALL_CHNLS_EN = 0x07,
};
///Advertising filter policy
enum adv_filter_policy
{
///Allow both scan and connection requests from anyone
ADV_ALLOW_SCAN_ANY_CON_ANY = 0x00,
///Allow both scan req from White List devices only and connection req from anyone
ADV_ALLOW_SCAN_WLST_CON_ANY,
///Allow both scan req from anyone and connection req from White List devices only
ADV_ALLOW_SCAN_ANY_CON_WLST,
///Allow scan and connection requests from White List devices only
ADV_ALLOW_SCAN_WLST_CON_WLST,
};
///Advertising enables
enum
{
///Disable advertising
ADV_DIS = 0x00,
///Enable advertising
ADV_EN,
};
///LE Scan type
enum
{
///Passive scan
SCAN_PASSIVE = 0x00,
///Active scan
SCAN_ACTIVE,
};
///Scan filter policy
enum scan_filter_policy
{
///Allow advertising packets from anyone
SCAN_ALLOW_ADV_ALL = 0x00,
///Allow advertising packets from White List devices only
SCAN_ALLOW_ADV_WLST,
///Allow advertising packets from anyone and Direct adv using RPA in InitA
SCAN_ALLOW_ADV_ALL_AND_INIT_RPA,
///Allow advertising packets from White List devices only and Direct adv using RPA in InitA
SCAN_ALLOW_ADV_WLST_AND_INIT_RPA,
};
///Le Scan enables
enum
{
///Disable scan
SCAN_DIS = 0x00,
///Enable scan
SCAN_EN,
};
///Filter duplicates
enum scan_dup_filter_policy
{
///Disable filtering of duplicate packets
SCAN_FILT_DUPLIC_DIS = 0x00,
///Enable filtering of duplicate packets
SCAN_FILT_DUPLIC_EN,
///Enable filtering of duplicate packets per scan period
SCAN_FILT_DUPLIC_EN_PER_PERIOD,
};
///Initiator Filter policy
enum
{
///Initiator will ignore White List
INIT_FILT_IGNORE_WLST = 0x00,
///Initiator will use White List
INIT_FILT_USE_WLST,
};
///Periodic Synchronization Filter policy
enum
{
///Use the Advertising SID, Advertising Address Type and Advertising Address parameters to determine
///which advertiser to listen to
PER_SYNC_FILT_IGNORE_PAL = 0x00,
///Use the Periodic Advertiser List to determine which advertiser to listen to
PER_SYNC_FILT_USE_PAL,
};
/// Periodic Synchronization Options
enum per_sync_opt
{
/**
* Use the Periodic Advertiser List to determine which advertiser to listen to, otherwise use the Advertising SID,
* Advertising Address Type and Advertising Address parameters
*/
PER_SYNC_FILT_USE_PAL_POS = 0,
PER_SYNC_FILT_USE_PAL_BIT = 0x01,
/// Periodic advertising reports initially enabled or disabled (default enabled)
PER_SYNC_REP_INIT_DIS_POS = 1,
PER_SYNC_REP_INIT_DIS_BIT = 0x02,
};
///Transmitter test Packet Payload Type
enum
{
///Pseudo-random 9 TX test payload type
PAYL_PSEUDO_RAND_9 = 0x00,
///11110000 TX test payload type
PAYL_11110000,
///10101010 TX test payload type
PAYL_10101010,
///Pseudo-random 15 TX test payload type
PAYL_PSEUDO_RAND_15,
///All 1s TX test payload type
PAYL_ALL_1,
///All 0s TX test payload type
PAYL_ALL_0,
///00001111 TX test payload type
PAYL_00001111,
///01010101 TX test payload type
PAYL_01010101,
};
/// Constant defining the role
enum
{
///Master role
ROLE_MASTER,
///Slave role
ROLE_SLAVE,
};
/// Constant clock accuracy
enum SCA
{
///Clock accuracy at 500PPM
SCA_500PPM,
///Clock accuracy at 250PPM
SCA_250PPM,
///Clock accuracy at 150PPM
SCA_150PPM,
///Clock accuracy at 100PPM
SCA_100PPM,
///Clock accuracy at 75PPM
SCA_75PPM,
///Clock accuracy at 50PPM
SCA_50PPM,
///Clock accuracy at 30PPM
SCA_30PPM,
///Clock accuracy at 20PPM
SCA_20PPM
};
///Advertising pdu Type
/*@TRACE*/
enum ble_adv_type
{
/// Undirected advertising
BLE_ADV_IND = 0x00,
/// Directed advertising
BLE_ADV_DIRECT_IND = 0x01,
/// Non Connectable advertising
BLE_ADV_NONCONN_IND = 0x02,
/// Scan Request on primary channel
BLE_SCAN_REQ = 0x03,
/// Scan Response on secondary channel
BLE_AUX_SCAN_REQ = 0x03,
/// Scan Response
BLE_SCAN_RSP = 0x04,
/// Connect Request on primary channel
BLE_CONNECT_IND = 0x05,
/// Connect Request on secondary channel
BLE_AUX_CONNECT_REQ = 0x05,
/// Discoverable advertising
BLE_ADV_SCAN_IND = 0x06,
/// Extended Advertising indication on primary channel
BLE_ADV_EXT_IND = 0x07,
/// ADV data indication on secondary channel
BLE_AUX_ADV_IND = 0x07,
/// Scan response data on secondary channel
BLE_AUX_SCAN_RSP = 0x07,
/// Periodic Advertising packet on secondary channel
BLE_AUX_SYNC_IND = 0x07,
/// Continuation of advertising data on secondary channel
BLE_AUX_CHAIN_IND = 0x07,
/// Response of the AUX_CONNECT_REQ on secondary channel to confirm that connection is accepted
BLE_AUX_CONNECT_RSP = 0x08,
/// Reserved
BLE_RESERVED_PDU_TYPE,
};
/// LE Advertising Report Event Type HCI:7.7.65.2
enum
{
/// Connectable undirected advertising
ADV_IND_EVT = 0x00,
/// Connectable directed advertising
ADV_DIRECT_IND_EVT,
/// Scannable undirected advertising
ADV_SCAN_IND_EVT,
/// Non connectable undirected advertising
ADV_NONCONN_IND_EVT,
/// Scan Response
SCAN_RSP_EVT,
/// Reserved
RESERVED_ADV_EVT_TYPES,
};
/// LE Extended Advertising Report Event Type Bit Mask HCI:7.7.65.13
/// Connectable advertising event
#define CON_ADV_EVT_MSK 0x01
/// Scannable advertising event
#define SCAN_ADV_EVT_MSK 0x02
/// Directed advertising event
#define DIR_ADV_EVT_MSK 0x04
/// Scan Response
#define SCAN_RSP_EVT_MSK 0x08
/// Legacy advertising PDUs
#define LGCY_ADV_EVT_MSK 0x10
/// Connectable undirected advertising
#define LGCY_ADV_IND_EVT 0x13 //LGCY_ADV_EVT_MSK|SCAN_ADV_EVT_MSK|CON_ADV_EVT_MSK
/// Connectable directed advertising
#define LGCY_ADV_DIRECT_IND_EVT 0x15 //LGCY_ADV_EVT_MSK|DIR_ADV_EVT_MSK|CON_ADV_EVT_MSK
/// Scannable undirected advertising
#define LGCY_ADV_SCAN_IND_EVT 0x12 //LGCY_ADV_EVT_MSK|SCAN_ADV_EVT_MSK
/// Non connectable undirected advertising
#define LGCY_ADV_NONCONN_IND_EVT 0x10 //LGCY_ADV_EVT_MSK
/// Scan Response to ADV_IND
#define LGCY_SCAN_RSP_TO_ADV_IND_EVT 0x1B //LGCY_ADV_EVT_MSK|SCAN_RSP_EVT_MSK|SCAN_ADV_EVT_MSK|CON_ADV_EVT_MSK
/// Scan Response to ADV_SCAN_IND
#define LGCY_SCAN_RSP_TO_ADV_SCAN_IND_EVT 0x1A //LGCY_ADV_EVT_MSK|SCAN_RSP_EVT_MSK|SCAN_ADV_EVT_MSK
/// Offset of data status field in event type value
#define ADV_EVT_DATA_STATUS_LSB 5
/// Mask for data status field in event type value
#define ADV_EVT_DATA_STATUS_MASK 0x0060
/// Data status of extended advertising event - Complete
#define ADV_EVT_DATA_STATUS_COMPLETE 0
/// Data status of extended advertising event - Incomplete, more data to come
#define ADV_EVT_DATA_STATUS_INCOMPLETE 1
/// Data status of extended advertising event - Incomplete, data truncated, no more to come
#define ADV_EVT_DATA_STATUS_TRUNCATED 2
/// Data status of extended advertising event - Reserved for future use
#define ADV_EVT_DATA_STATUS_RESERVED 3
/// Data status of periodic advertising event - Complete
#define PER_ADV_EVT_DATA_STATUS_COMPLETE 0
/// Data status of periodic advertising event - Incomplete, more data to come
#define PER_ADV_EVT_DATA_STATUS_INCOMPLETE 1
/// Data status of periodic advertising event - Incomplete, data truncated, no more to come
#define PER_ADV_EVT_DATA_STATUS_TRUNCATED 2
/// LLID packet
enum
{
/// Reserved for future use
LLID_RFU,
/// Continue
LLID_CONTINUE,
/// Start
LLID_START,
/// Control
LLID_CNTL
};
/// Remote OOB Data present parameter value HCI:7.1.29
enum
{
REM_OOB_DATA_NO = 0x00,
REM_OOB_DATA_P192 = 0x01,
REM_OOB_DATA_P256 = 0x02,
REM_OOB_DATA_P192_P256 = 0x03,
};
/// Encryption enabled parameter in HCI_Enc_Chg_Evt HCI:7.7.8
enum
{
ENC_OFF = 0x00,
ENC_BRDER_E0_LE_AESCCM = 0x01,
ENC_BREDR_AESCC = 0x02,
};
/// Combined duration of Preamble and Access Address depending on the PHY used (in us)
#define BLE_PREAMBLE_ACCESS_ADDR_DUR_1MBPS (5*8)
#define BLE_PREAMBLE_ACCESS_ADDR_DUR_2MBPS (6*4)
#define BLE_PREAMBLE_ACCESS_ADDR_DUR_125KBPS (80+256)
#define BLE_PREAMBLE_ACCESS_ADDR_DUR_500KBPS (80+256)
/// size of the Maximum Adv Extended header length
#define BLE_EXT_MAX_HEADER_LEN (63)
/// size of the LEN & MODE info preceeding the extended header
#define BLE_EXT_ADV_PRE_HEADER_LEN (1)
/// size of the FLAGS info at start of the extended header
#define BLE_EXT_ADV_HEADER_FLAGS_LEN (1)
/// size of the extended header in bytes (pre-header + flags)
#define BLE_EXT_ADV_HEADER_LEN (2)
/// Size of CTE info in extended header
#define BLE_EXT_CTE_INFO_LEN (1)
/// Size of ADV Data Info in extended header
#define BLE_EXT_ADI_LEN (2)
/// Size of Aux Pointer info in extended header
#define BLE_EXT_AUX_PTR_LEN (3)
/// Size of Sync PTR info in extended header
#define BLE_EXT_SYNC_LEN (18)
/// Size of TX Power info in extended header
#define BLE_EXT_TX_PWR_LEN (1)
/// Size of the Channel Map Update Indication in extended header
#define BLE_EXT_CHM_UPD_IND_LEN (9)
/// AD Types for ACAD data
#define BLE_EXT_ACAD_CHANNEL_MAP_UPDATE_INDICATION_AD_TYPE (0x28)
/// Size of ACAD Data for BIG info - Not Encrypted
#define BLE_EXT_ACAD_BIG_INFO_LEN (33)
/// Size of ACAD Data for BIG info - Encrypted
#define BLE_EXT_ACAD_BIG_INFO_ENC_LEN (57)
/// maximum duration in us of Big Offset with 30 us step
#define BLE_BIG_OFFSET_30_US_MAX (491460)
/// AD Type reserved for BIGInfo ACAD data
#define BLE_EXT_ACAD_BIG_INFO_AD_TYPE (0x2C)
/// Extended Header Flags
enum ble_ext_header_flags
{
// AdvA
ADVA_BIT = 0x01,
ADVA_POS = 0,
// TargetA
TARGETA_BIT = 0x02,
TARGETA_POS = 1,
// SuppInfo
SUPPINFO_BIT = 0x04,
SUPPINFO_POS = 2,
// AdvDataInfo (ADI)
ADI_BIT = 0x08,
ADI_POS = 3,
// AuxPtr
AUXPTR_BIT = 0x10,
AUXPTR_POS = 4,
// SyncInfo
SYNCINFO_BIT = 0x20,
SYNCINFO_POS = 5,
// TxPower
TXPOWER_BIT = 0x40,
TXPOWER_POS = 6,
};
/// AUX pointer description
enum ble_aux_ptr
{
// Aux LL Channel
BLE_AUX_LL_CHANNEL_MASK = 0x0000003F,
BLE_AUX_LL_CHANNEL_LSB = 0,
// Aux Clock Accuracy
BLE_AUX_CA_BIT = 0x00000040,
BLE_AUX_CA_POS = 6,
// Aux Offset Unit
BLE_AUX_OFFSET_UNIT_BIT = 0x00000080,
BLE_AUX_OFFSET_UNIT_POS = 7,
// Aux ADV offset
BLE_AUX_OFFSET_MASK = 0x001FFF00,
BLE_AUX_OFFSET_LSB = 8,
// Aux PHY
BLE_AUX_PHY_MASK = 0x00E00000,
BLE_AUX_PHY_LSB = 21,
};
/// CTEInfo field description
enum ble_cte_info
{
// CTETime (5 bits)
BLE_CTE_INFO_CTE_TIME_MASK = 0x0000001F,
BLE_CTE_INFO_CTE_TIME_LSB = 0,
// RFU (1 bit)
BLE_CTE_INFO_RFU_BIT = 0x00000020,
BLE_CTE_INFO_RFU_POS = 5,
// CTEType (2 bits)
BLE_CTE_INFO_CTE_TYPE_MASK = 0x000000C0,
BLE_CTE_INFO_CTE_TYPE_LSB = 6,
};
/// Aux PHY values LL:2.3.4.5
enum aux_phy
{
AUX_PHY_1MBPS = 0,
AUX_PHY_2MBPS = 1,
AUX_PHY_CODED = 2,
};
/// SyncInfo - various fileds description
enum syncinfo_fields
{
/// SyncInfo - Sync Offset description (13 bits)
BLE_SYNC_OFFSET_MASK = 0x1FFF,
BLE_SYNC_OFFSET_LSB = 0,
/// SyncInfo - Offset Units description (1 bit)
BLE_SYNC_OFFSET_UNITS_BIT = 0x2000,
BLE_SYNC_OFFSET_UNITS_POS = 13,
/// SyncInfo - Offset Adjust description (1 bit)
BLE_SYNC_OFFSET_ADJUST_BIT = 0x4000,
BLE_SYNC_OFFSET_ADJUST_POS = 14,
/// SyncInfo[8] - ChM description (5 bits of 37 bits)
BLE_SYNC_CHMAP_END_MASK = 0x1F,
BLE_SYNC_CHMAP_END_LSB = 0,
/// SyncInfo[8] - SCA description (3 bits)
BLE_SYNC_SCA_MASK = 0xE0,
BLE_SYNC_SCA_LSB = 5,
};
/// AdvDataInfo (ADI) field description
enum ble_adi
{
// Advertising Data ID (DID)
BLE_ADI_DID_MASK = 0x0FFF,
BLE_ADI_DID_LSB = 0,
// Advertising Set ID (SID)
BLE_ADI_SID_MASK = 0xF000,
BLE_ADI_SID_LSB = 12,
};
/// Advertising mode
enum ble_adv_mode
{
/// Non connectable and non scannable mode
BLE_MODE_NON_CON_SCAN = 0,
/// Connectable Mode (accept connection request)
BLE_MODE_CONNECTABLE = 1,
/// Scannable Mode (accept scan request)
BLE_MODE_SCANNABLE = 2,
/// Reserved Advertising mode
BLE_MODE_RESERVED = 3,
};
/// Advertising data operation
enum adv_data_op
{
/// Intermediate fragment of fragmented extended advertising data
ADV_DATA_OP_INTERMEDIATE_FRAG = 0,
/// First fragment of fragmented extended advertising data
ADV_DATA_OP_FIRST_FRAG = 1,
/// Last fragment of fragmented extended advertising data
ADV_DATA_OP_LAST_FRAG = 2,
/// Complete extended advertising data
ADV_DATA_OP_COMPLETE = 3,
/// Unchanged data (just update the Advertising DID)
ADV_DATA_OP_UNCHANGED_DATA = 4,
};
/// Advertising data fragment preference
enum adv_data_frag_pref
{
/// The Controller may fragment all Host advertising data
ADV_DATA_MAY_FRAG = 0,
/// The Controller should not fragment nor minimize fragmentation of Host advertising data
ADV_DATA_SHOULD_NOT_FRAG = 1,
};
/*
* STRUCTURE DEFINITONS
****************************************************************************************
*/
///BD name structure
struct bd_name
{
///length for name
uint8_t namelen;
///array of bytes for name
uint8_t name[BD_NAME_SIZE];
};
///Structure device name
/*@TRACE*/
struct device_name
{
///array of bytes for name
uint8_t name[BD_NAME_SIZE];
};
///Structure name vector
/*@TRACE*/
struct name_vect
{
uint8_t vect[NAME_VECT_SIZE];
};
/// lap structure
/*@TRACE*/
struct lap
{
/// LAP
uint8_t A[BD_ADDR_LAP_LEN];
};
/// class structure
/*@TRACE*/
struct devclass
{
/// class
uint8_t A[DEV_CLASS_LEN];
};
///Extended inquiry response structure
/*@TRACE*/
struct eir
{
/// eir data
uint8_t data[EIR_DATA_SIZE];
};
///Event mask structure
/*@TRACE*/
struct evt_mask
{
///8-byte array for mask value
uint8_t mask[EVT_MASK_LEN];
};
///Host number of completed packets structure, for 1 connection handle
struct host_cmpl_pkts
{
///Connection handle
uint16_t con_hdl;
///Number of completed packets
uint16_t nb_cmpl_pkts;
};
///BD Address structure
/*@TRACE*/
struct bd_addr
{
///6-byte array address value
uint8_t addr[BD_ADDR_LEN];
};
///Access Address structure
/*@TRACE*/
struct access_addr
{
///4-byte array access address
uint8_t addr[ACCESS_ADDR_LEN];
};
///Advertising data structure
/*@TRACE*/
struct adv_data
{
///Maximum length data bytes array
uint8_t data[ADV_DATA_LEN];
};
///Scan response data structure
/*@TRACE*/
struct scan_rsp_data
{
///Maximum length data bytes array
uint8_t data[SCAN_RSP_DATA_LEN];
};
///Channel map structure
/*@TRACE*/
struct chnl_map
{
///10-bytes channel map array
uint8_t map[CHNL_MAP_LEN];
};
///Channel map structure
/*@TRACE*/
struct le_chnl_map
{
///5-byte channel map array
uint8_t map[LE_CHNL_MAP_LEN];
};
/// External frame period (duration & type) structure
struct ext_fr_period
{
/// Period_Duration
uint16_t duration;
/// Period_Type
uint8_t type;
};
/// MWS scan frequency (low & high) structure
struct mws_scan_freq
{
///Scan_Frequency_Low
uint16_t low;
///Scan_Frequency_High
uint16_t high;
};
/// MWS pattern interval (duration & type) structure
struct mws_pattern_intv
{
///MWS_PATTERN_IntervalDuration
uint16_t duration;
///MWS_PATTERN_IntervalType
uint8_t type;
};
/// MWS transport rates structure
struct mws_trans_rate
{
///To_MWS_Baud_Rate
uint32_t to_mws_baud_rate;
///From_MWS_Baud_Rate
uint32_t from_mws_baud_rate;
};
/// MWS transports strucutre
struct mws_transport
{
///Transport_Layer
uint8_t layer_id;
///Num_Baud_Rates
uint8_t num_baud_rates;
///To/From_MWS_Baud_Rates
struct mws_trans_rate *rates;
};
/// SAM submaps structure
struct sam_submaps
{
//12-byte SAM submaps array of 2-bit fields
//The nth (numbering from 0) such field defines the submap type of the nth submap in the map:
// - SAM_SLOTS_SUBMAPPED: Each slot is individually available or unavailable as configured.
// - SAM_SLOTS_AVAILABLE: All slots are available for transmission and reception.
// - SAM_SLOTS_UNAVAILABLE: All slots are unavailable for transmission and reception.
// - Other: Reserved for future use.
uint8_t map[SAM_SUBMAPS_LEN];
};
/// SAM type0 submap structure
struct sam_type0_submap
{
//14-byte type0 submap array of 2-bit fields
//The nth (numbering from 0) such field defines the submap type of the nth submap in the map:
// - SAM_SLOT_NOT_AVAILABLE: The slot is not available for transmision or reception.
// - SAM_SLOT_TX_AVAILABLE: The slot is available for transmission but not reception.
// - SAM_SLOT_RX_AVAILABLE: The slot is available for reception but not transmission.
// - SAM_SLOT_TX_RX_AVAILABLE: The slot is available for both transmission and reception.
uint8_t map[SAM_TYPE0_SUBMAP_LEN];
};
///Long Term Key structure
/*@TRACE*/
struct ltk
{
///16-byte array for LTK value
uint8_t ltk[KEY_LEN];
};
///Identity Resolving Key structure
/*@TRACE*/
struct irk
{
///16-byte array for IRK value
uint8_t key[KEY_LEN];
};
/// Initialization vector (for AES-CCM encryption)
/*@TRACE*/
struct initialization_vector
{
///8-byte array
uint8_t vect[IV_LEN];
};
/// Bluetooth address with link key
struct bd_addr_plus_key
{
/// BD Address
struct bd_addr bd_addr;
/// Link Key
struct ltk link_key;
};
///Random number structure
/*@TRACE*/
struct rand_nb
{
///8-byte array for random number
uint8_t nb[RAND_NB_LEN];
};
///Advertising report structure
/*@TRACE*/
struct adv_report
{
///Event type:
/// - ADV_CONN_UNDIR: Connectable Undirected advertising
/// - ADV_CONN_DIR: Connectable directed advertising
/// - ADV_DISC_UNDIR: Discoverable undirected advertising
/// - ADV_NONCONN_UNDIR: Non-connectable undirected advertising
uint8_t evt_type;
///Advertising address type: public/random
uint8_t adv_addr_type;
///Advertising address value
struct bd_addr adv_addr;
///Data length in advertising packet
uint8_t data_len;
///Data of advertising packet
uint8_t data[ADV_DATA_LEN];
///RSSI value for advertising packet (in dBm, between -127 and +20 dBm)
int8_t rssi;
};
///Direct Advertising report structure
/*@TRACE*/
struct dir_adv_report
{
///Event type:
/// - ADV_CONN_DIR: Connectable directed advertising
uint8_t evt_type;
///Address type: public/random
uint8_t addr_type;
///Address value
struct bd_addr addr;
///Direct address type: public/random
uint8_t dir_addr_type;
///Direct address value
struct bd_addr dir_addr;
///RSSI value for advertising packet (in dBm, between -127 and +20 dBm)
int8_t rssi;
};
///Exteneded Advertising report structure
/*@TRACE*/
struct ext_adv_report
{
///Event type
uint16_t evt_type;
///Advertising address type: public/random
uint8_t adv_addr_type;
///Advertising address value
struct bd_addr adv_addr;
///Primary PHY
uint8_t phy;
///Secondary PHY
uint8_t phy2;
///Advertising SID
uint8_t adv_sid;
///Tx Power
uint8_t tx_power;
///RSSI value for advertising packet (in dBm, between -127 and +20 dBm)
int8_t rssi;
///Periodic Advertising interval (Time=N*1.25ms)
uint16_t interval;
///Direct address type
uint8_t dir_addr_type;
///Direct address value
struct bd_addr dir_addr;
///Data length in advertising packet
uint8_t data_len;
///Data of advertising packet
uint8_t data[EXT_ADV_DATA_MAX_LEN];
};
///Supported LE Features structure
/*@TRACE*/
struct le_features
{
///8-byte array for LE features
uint8_t feats[LE_FEATS_LEN];
};
///Simple pairing hash structure
/*@TRACE*/
struct hash
{
///16-byte array for LTK value
uint8_t C[KEY_LEN];
};
///Simple pairing randomizer structure
/*@TRACE*/
struct randomizer
{
///16-byte array for LTK value
uint8_t R[KEY_LEN];
};
///Pin code structure
/*@TRACE*/
struct pin_code
{
///16-byte array for PIN value
uint8_t pin[PIN_CODE_MAX_LEN];
};
///Sres structure
/*@TRACE*/
struct sres_nb
{
///8-byte array for random number
uint8_t nb[SRES_LEN];
};
///aco structure
/*@TRACE*/
struct aco
{
///8-byte array for random number
uint8_t a[ACO_LEN];
};
///struct byte 16 to stay align with the sdl version
/*@TRACE*/
struct byte16
{
uint8_t A[16];
};
///Controller number of completed packets structure
/*@TRACE*/
struct nb_cmpl_pk
{
///Connection handle
uint16_t con_hdl;
///Controller number of data packets that have been completed since last time
uint16_t nb_hc_cmpl_pkts;
};
///Supported Features structure
/*@TRACE*/
struct features
{
///8-byte array for features
uint8_t feats[FEATS_LEN];
};
///Supported commands structure
/*@TRACE*/
struct supp_cmds
{
///64-byte array for supported commands
uint8_t cmds[SUPP_CMDS_LEN];
};
///Supported LMP features structure
struct lmp_features
{
///8-byte array for LMp features
uint8_t feats[FEATS_LEN];
};
///Simple pairing IO capabilities
struct io_capability
{
///IO capability
uint8_t io_cap;
/// Out Of Band Data present
bool oob_data_present;
///Authentication Requirement
uint8_t aut_req;
};
///Public key
struct pub_key_192
{
uint8_t p_key[PUB_KEY_192_LEN/2];
};
///Public key
struct pub_key_256
{
uint8_t p_key[PUB_KEY_256_LEN/2];
};
///Simple pairing public keys 192
struct sp_pub_key_192
{
///Public key X
struct pub_key_192 X;
///Public key Y
struct pub_key_192 Y;
};
///Simple pairing public keys 256
struct sp_pub_key_256
{
///Public key X
struct pub_key_256 X;
///Public key Y
struct pub_key_256 Y;
};
///Supported LE states structure
/*@TRACE*/
struct le_states
{
///8-byte array for LE states
uint8_t supp_states[LE_STATES_LEN];
};
///White List element structure
struct white_list
{
///BD address of device entry
struct bd_addr wl_bdaddr;
///BD address type of device entry
uint8_t wl_bdaddr_type;
};
///RAL element structure
struct ral_entry
{
/// Peer ID address
struct bd_addr bd_addr;
/// Peer address type
uint8_t addr_type;
/// Local IRK
struct irk local_irk;
/// Peer IRK
struct irk peer_irk;
};
///CRC initial value structure
/*@TRACE*/
struct crc_init
{
///3-byte array CRC initial value
uint8_t crc[CRC_INIT_LEN];
};
///Session key diversifier master or slave structure
/*@TRACE*/
struct sess_k_div_x
{
///8-byte array for diversifier value
uint8_t skdiv[SESS_KEY_DIV_LEN];
};
///Session key diversifier structure
struct sess_k_div
{
///16-byte array for session key diversifier.
uint8_t skd[2*SESS_KEY_DIV_LEN];
};
///Initiator vector
/*@TRACE*/
struct init_vect
{
///4-byte array for vector
uint8_t iv[INIT_VECT_LEN];
};
/*@TRACE*/
typedef struct t_public_key
{
uint8_t x[PUBLIC_KEY_P256_LEN];
uint8_t y[PUBLIC_KEY_P256_LEN];
} t_public_key;
/// structure connection request LLData
struct pdu_con_req_lldata
{
/// Access address
struct access_addr aa;
/// CRC init
struct crc_init crcinit;
/// Window size (in units of 1,25 ms, i.e. 2 slots)
uint8_t winsize;
/// Window offset (in units of 1,25 ms, i.e. 2 slots)
uint16_t winoffset;
/// Interval (in units of 1,25 ms, i.e. 2 slots)
uint16_t interval;
/// Latency
uint16_t latency;
/// Timeout (in units of 10 ms, i.e. 16 slots)
uint16_t timeout;
/// Channel mapping
struct le_chnl_map chm;
/// Hopping
uint8_t hop_sca;
};
/// structure connection request
struct pdu_con_req
{
/// Initiator address
struct bd_addr inita;
/// Advertiser address
struct bd_addr adva;
/// LLData
struct pdu_con_req_lldata lldata;
};
/// structure advertising syncinfo field
/*@TRACE*/
struct sync_info
{
/// Sync offset (in offset units)
uint16_t sync_offset;
/// Offset units (0: 30us, 1: 300us)
uint8_t offset_units;
/// Offset adjust (0: no action, 1: add 2.4576 seconds)
uint8_t offset_adjust;
/// Interval (in units of 1,25 ms, i.e. 2 slots)
uint16_t interval;
/// Channel mapping
struct le_chnl_map ch_map;
/// Clock accuracy (@see enum SCA)
uint8_t sca;
/// Access address
struct access_addr aa;
/// CRC init
struct crc_init crcinit;
/// Event counter
uint16_t evt_counter;
};
/// BIG info fields
enum big_info_fields
{
// (14 bits) BIG_Offset
BIG_OFFSET_POS = 0,
BIG_OFFSET_LSB = 0,
BIG_OFFSET_MASK = 0x00003FFF,
// (1 bit) BIG_Offset_Units
BIG_OFFSET_UNIT_POS = 0,
BIG_OFFSET_UNIT_LSB = 14,
BIG_OFFSET_UNIT_MASK = 0x00004000,
// (12 bits) ISO_Interval
BIG_ISO_INTERVAL_POS = 0,
BIG_ISO_INTERVAL_LSB = 15,
BIG_ISO_INTERVAL_MASK = 0x07FF8000,
// (5 bits) NumBIS
BIG_NUM_BIS_POS = 0,
BIG_NUM_BIS_LSB = 27,
BIG_NUM_BIS_MASK = 0xF8000000,
// (5 bits) NSE
BIG_NSE_POS = 4,
BIG_NSE_LSB = 0,
BIG_NSE_MASK = 0x1F,
// (3 bits) BN
BIG_BN_POS = 4,
BIG_BN_LSB = 5,
BIG_BN_MASK = 0xE0,
// (20 bits) Sub_Interval
BIG_SUB_INTERVAL_POS = 5,
BIG_SUB_INTERVAL_LSB = 0,
BIG_SUB_INTERVAL_MASK = 0x000FFFFF,
// (4 bits) PTO
BIG_PTO_POS = 5,
BIG_PTO_LSB = 20,
BIG_PTO_MASK = 0x00F00000,
// (20 bits) BIS_Spacing
BIG_BIS_SPACING_POS = 8,
BIG_BIS_SPACING_LSB = 0,
BIG_BIS_SPACING_MASK = 0x000FFFFF,
// (4 bits) IRC
BIG_IRC_POS = 8,
BIG_IRC_LSB = 20,
BIG_IRC_MASK = 0x00F00000,
// (8 bits) Max_PDU
BIG_MAX_PDU_POS = 11,
// (1 octet) RFU
BIG_RFU_POS = 12,
// (4 octets) SeedAccessAddress
BIG_SEED_ACCESS_ADDRESS_POS = 13,
// (20 bits) SDU_Interval
BIG_SDU_INTERVAL_POS = 17,
BIG_SDU_INTERVAL_LSB = 0,
BIG_SDU_INTERVAL_MASK = 0x000FFFFF,
// (12 bits) Max_SDU
BIG_MAX_SDU_POS = 17,
BIG_MAX_SDU_LSB = 20,
BIG_MAX_SDU_MASK = 0xFFF00000,
// (2 octets) BaseCRCInit
BIG_BASE_CRC_INIT_POS = 21,
// (37 bits) Channel Map
BIG_CHMAP_LSB_POS = 23,
BIG_CHMAP_MSB_POS = 27,
BIG_CHMAP_MSB_LSB = 0,
BIG_CHMAP_MSB_MASK = 0x1F,
// (3 bits) PHY
BIG_PHY_POS = 27,
BIG_PHY_LSB = 5,
BIG_PHY_MASK = 0xE0,
// (39 bits) bisPayloadCount
BIG_BIS_PLD_COUNT_LSB_POS = 28,
BIG_BIS_PLD_COUNT_MSB_POS = 32,
BIG_BIS_PLD_COUNT_MSB_LSB = 0,
BIG_BIS_PLD_COUNT_MSB_MASK = 0x7F,
// (1 bit) Framing
BIG_FRAMING_POS = 32,
BIG_FRAMING_LSB = 7,
BIG_FRAMING_MASK = 0x80,
// (8 octets) GIV
BIG_GIV_POS = 33,
// (16 octets) GSKD
BIG_GSKD_POS = 41,
};
/// BIG Sync Info format
/*@TRACE*/
struct big_info
{
/// BIG_Offset field contains the time from the start of the packet containing the BIGInfo to the next
/// BIG anchor point. The value of the BIG_Offset field is in the unit of time indicated by the BIG_Offset_Units
/// field; the actual time offset is determined by multiplying the value of BIG_Offset by the units.
/// The BIG_Offset shall be in the range 600 us to ISO_Interval of the associated BIG.
uint16_t big_offset;
/// If the BIG_Offset_Units bit is set then the unit is 300 us; otherwise it is 30 us.
/// The BIG_Offset_Units field shall be set to 0 if the offset is less than (2^14 – 2) us.
/// The BIG event anchor point shall be no earlier than the BIG_Offset and no later than the BIG_Offset
/// plus one BIG_Offset_Unit after the start of the relevant packet.
uint8_t big_offset_unit;
/// ISO interval (1.25ms unit, range: 5ms to 4s)
uint16_t iso_interval;
/// Number of BIS transmitted. (range 1 to 31)
uint8_t num_bis;
/// Number of subevents (range 1 to 31)
uint8_t nse;
/// BN which is the number of new payloads per BIS channel in every BIS channel interval (range 1 to 7).
uint8_t bn;
/// Time in microseconds of every subevent in the BIG
uint32_t sub_interval;
/// PreTransmission offset numbers which is the number of Stream Interval spacing used for selecting
/// payloads of events from the current channel event (range 0 to 15).
uint8_t pto;
/// Time in microseconds between an anchor point of a BIS and the anchor point of the next BIS
uint32_t bis_spacing;
/// Immediate Repetition Count which is the number of subevents that are used for transmissions
/// of the intended payload for that channel event (range 1 to 15).
uint8_t irc;
/// Maximum size of payload in each Data PDU of each BIS in the BIG
uint8_t max_pdu;
/// SDU interval in microseconds
uint32_t sdu_interval;
/// ISOAL Framing mode, 0: Unframed, 1: Framed
uint8_t framing;
/// Maximum size of SDU in each SDU interval
uint16_t max_sdu;
/// Indicates the PHY used to transmit the Isochronous Channel PDUs (see enum le_phy_mask).
uint8_t phy;
/// Number from which the CRC initialization value for all Data PDUs and Control PDUs are derived.
uint16_t base_crc_init;
/// Number from which the Access Addresses for all Broadcast
uint32_t seed_access_addr;
/// Channel Map
uint8_t chmap[LE_CHNL_MAP_LEN];
/// Payload Counter field contains 39bits payload counter of the BIS channel Data PDU.
/// MSB of the Payload Counter field shall be set to 0.
uint8_t bis_pkt_cnt[BLE_PLD_CNT_SIZE];
// Encryption (Optional)
/// Used to know if BIG is encrypted
bool encrypted;
/// GIV field is the Group Initialization Vector to be used to encrypt the BIS channel Data PDUs.
uint8_t giv[IV_LEN];
/// GSKD field is the Group Session Key Diversifier used to encrypt the BIS channel Data PDUs
uint8_t gskd[KEY_LEN];
};
/// @} CO_BT_DEFINES
#endif // CO_BT_DEFINES_H_