# 乐鑫自定义 HCI 命令

[English]

## 乐鑫蓝牙主机专用的自定义 HCI 命令

以下自定义 HCI 命令仅适用于乐鑫的蓝牙主机（ESP-Bluedroid 主机 或 ESP-NimBLE 主机）。如果使用非 ESP 主机或 HCI UART，这些命令将默认禁用，除非应用程序调用了相应的初始化函数。请注意，这些初始化函数及附加的自定义 HCI 命令仅供乐鑫蓝牙主机使用。应用程序开发者 不应 在其应用程序中调用这些初始化函数。

ESP_BT_VS_CONFIG_DUP_EXC_LIST_OCF

  Config scanning duplicate exceptional list (OCF: 0x0108)

  备注

  The init function is `advFilter_stack_eanbleDupExcListCmd(true)`

ESP_BT_VS_SET_ADV_REPORT_FLOW_CTRL_OCF

  Enable/disable advertising report flow control (OCF: 0x0109)

  备注

  The init function is `scan_stack_enableAdvFlowCtrlVsCmd(true)`

ESP_BT_VS_UPD_ADV_REPORT_FLOW_CTRL_NUM_OCF

  Update the number of advertising report in ADV flow control (OCF: 0x010A)

  备注

  The init function is `scan_stack_enableAdvFlowCtrlVsCmd(true)`

ESP_BT_VS_CLR_LEGACY_ADV_OCF

  Clear legacy advertising (same as HCI_LE_Clear_Advertising_Sets) (OCF: 0x010C)

  备注

  The init function is `adv_stack_enableClearLegacyAdvVsCmd(true)`

ESP_BT_VS_SET_DUP_LIST_PARAMS_OCF

  Set parameters of duplicate list (OCF: 0x010D)

  备注

  The init function is `advFilter_stack_eanbleDupExcListCmd(true)`

ESP_BT_VS_ENABLE_DUP_EXC_LIST_OCF

  Enable/disable duplicate and exception list (OCF: 0x010E)

  备注

  The init function is `advFilter_stack_eanbleDupExcListCmd(true)`

ESP_BT_VS_ENABLE_ARRANGEMENT_OCF

  Enable optimization of multiple connections (OCF: 0x010F)

  备注

  The init function is `arr_stack_enableMultiConnVsCmd(true)`

ESP_BT_VS_SET_SCHED_ROLE_LEN_OCF

  Set scheduling length for a certain role (OCF: 0x0110)

  备注

  The init function is `arr_stack_enableMultiConnVsCmd(true)`

ESP_BT_VS_SET_PCL_RSSI_THRESH_OCF

  Set RSSI threshold for automatic power control (OCF: 0x0111)

  备注

  The init function is `pcl_stack_enableSetRssiThreshVsCmd(true)`

ESP_BT_VS_ENABLE_CSA2_OCF

  Enable/disable channel selection algorithm #2 (OCF: 0x0112)

  备注

  The init function is `chanSel_stack_enableSetCsaVsCmd(true)`

ESP_BT_VS_SET_LOG_PARAMS_OCF

  Set parameters of controller logs (OCF: 0x0114)

  备注

  The init function is `log_stack_enableLogsRelatedVsCmd(true)`

ESP_BT_VS_SET_LE_VENDOR_EVTS_MASK_OCF

  Set BLE vendor events mask (OCF: 0x0116)

  备注

  The init function is `hci_stack_enableSetVsEvtMaskVsCmd(true)`

## 乐鑫蓝牙主机专用的自定义 HCI 事件

以下自定义 HCI 事件仅适用于乐鑫的蓝牙主机（ESP-Bluedroid 主机 或 ESP-NimBLE 主机）。如果使用非 ESP 主机或 HCI UART，这些事件将默认禁用，除非应用程序调用了相应的初始化函数。请注意，这些初始化函数及附加的自定义 HCI 事件仅供乐鑫蓝牙主机使用。应用程序开发者 不应 在其应用程序中调用这些初始化函数。

ESP_BT_VS_LE_CONN_SCAN_REQ_RXED_EVT_SUBCODE

  BLE Scan/Connect Request, Aux Connect Response received event (EVTCODE: 0xFF, SUBCODE: 0xC0)

  备注

  The init function is `adv_stack_enableScanReqRxdVsEvent(true)`

ESP_BT_VS_LE_CHAN_UPDATE_COMP_EVT_SUBCODE

  BLE Channel Map Update Completion event (EVTCODE: 0xFF, SUBCODE: 0xC1)

  备注

  The init function is `conn_stack_enableChanMapUpdCompVsEvent(true)`

ESP_BT_VS_LE_ADV_LOST_EVT_SUBCODE

  BLE advertising report lost event for flow control (EVTCODE: 0x3E, SUBCODE: 0xF0)

  备注

  The init function is `scan_stack_enableAdvFlowCtrlVsCmd(true)`

## 乐鑫内部调试 HCI 命令

以下调试 HCI 命令已包含在乐鑫低功耗蓝牙控制器的预编译库中。这些命令不会被链接到应用程序的二进制文件中，除非应用程序中调用了 esp_ble_internalTestFeaturesEnable(true)。这些命令仅供乐鑫内部使用。应用程序开发者 不应 在其应用程序中调用 esp_ble_internalTestFeaturesEnable(true)。

ESP_BT_VS_CFG_TEST_RELATED_OCF

ESP_BT_VS_CFG_TEST_ENABLE_SUBCMD

ESP_BT_VS_CFG_TEST_ENABLE_ADV_DELAY_SUBCMD

ESP_BT_VS_CFG_TEST_SET_PREF_CODED_SUBCMD

ESP_BT_VS_CFG_TEST_SET_DEFAULT_PRIV_MODE_SUBCMD

ESP_BT_VS_CFG_TEST_SET_SCAN_FOREVER_SUBCMD

ESP_BT_VS_CFG_TEST_SET_EXPECTED_PEER_SUBCMD

ESP_BT_VS_CFG_TEST_GET_ADV_TXED_CNT_SUBCMD

ESP_BT_VS_CFG_TEST_GET_SCAN_RXED_CNT_SUBCMD

ESP_BT_VS_CFG_TEST_SET_TXPWR_LVL_SUBCMD

ESP_BT_VS_CFG_TEST_GET_TXPWR_LVL_SUBCMD

ESP_BT_VS_CFG_TEST_SET_TXPWR_LVL_ENH_SUBCMD

ESP_BT_VS_CFG_TEST_GET_TXPWR_LVL_ENH_SUBCMD

ESP_BT_VS_CFG_TEST_IGNORE_WL_FOR_DIR_ADV_SUBCMD

ESP_BT_VS_CFG_TEST_GET_ADV_RXED_RSSI_SUBCMD

ESP_BT_VS_CFG_TEST_ENABLE_CCA_SUBCMD

ESP_BT_VS_CFG_TEST_SET_CCA_WIN_SUBCMD

ESP_BT_VS_CFG_TEST_READ_CCA_DATA_SUBCM

ESP_BT_VS_CFG_TEST_CLEAR_RAND_ADDR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_MAX_TXPWR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_TXPWR_RANGE_SUBCMD

ESP_BT_VS_CFG_TEST_SET_SCAN_AA_SUBCMD

ESP_BT_VS_CFG_TEST_SET_ADV_AA_SUBCMD

ESP_BT_VS_CFG_TEST_SET_SCAN_CHAN_SUBCMD

ESP_BT_VS_CFG_TEST_SKIP_LIGHT_SLEEP_CHECK_SUBCMD

ESP_BT_VS_CFG_TEST_SET_WAKEUP_OVERHEAD_SUBCMD

ESP_BT_VS_CFG_TEST_GET_ADV_MIN_ITVL_SUBCMD

ESP_BT_VS_CFG_TEST_GET_CTRL_STATUS_SUBCMD

ESP_BT_VS_CFG_TEST_SET_CONN_PHY_TXPWR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_CONN_PHY_TXPWR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_RXBUF_EMPTY_CNT_SUBCMD

ESP_BT_VS_CFG_TEST_RESTART_SUBCMD

ESP_BT_VS_CFG_TEST_ENABLE_RECODE_RX_STATE_SUBCMD

ESP_BT_VS_CFG_TEST_GET_RECODE_CNT_SUBCMD

ESP_BT_VS_CFG_TEST_CLR_RECODE_CNT_SUBCMD

ESP_BT_VS_CFG_TEST_GET_CTRL_COMPILE_VER_SUBCMD

ESP_BT_VS_CFG_TEST_SET_AUX_ADV_OFFSET_SUBCMD

ESP_BT_VS_CFG_TEST_INIT_FLEXIBLE_MODE_SUBCMD

ESP_BT_VS_CFG_TEST_ENABLE_FLEXIBLE_MODE_SUBCMD

ESP_BT_VS_CFG_TEST_SET_FLEXIBLE_CONN_ERR_SUBCMD

ESP_BT_VS_CFG_TEST_SET_FLEXIBLE_ADV_ERR_SUBCMD

ESP_BT_VS_CFG_TEST_SET_FLEXIBLE_SCAN_ERR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_TXED_CRCERR_SUBCMD

ESP_BT_VS_CFG_TEST_GET_BACKOFF_UPLIMIT_SUBCMD

ESP_BT_VS_CFG_TEST_GET_RXED_ADV_ADI_SUBCMD

ESP_BT_VS_CFG_TEST_SET_SCH_RAND_MODE_SUBCMD

ESP_BT_VS_CFG_TEST_SET_RX_SENS_THRESH_SUBCMD

ESP_BT_VS_CFG_TEST_CHECK_MSYS_BUF_SUBCMD

ESP_BT_VS_CFG_TEST_UPDATE_BLE_TIMER_SUBCMD

ESP_BT_VS_CFG_TEST_UPDATE_BLE_RTC_SUBCMD

ESP_BT_VS_CFG_TEST_SET_LOCKED_MEM_NUM_SUBCMD

ESP_BT_VS_CFG_TEST_ALLOW_MEM_ALLOC_SUBCMD

ESP_BT_VS_CFG_TEST_SET_SCH_RAND_INFO_PTR_SUBCMD

ESP_BT_VS_CFG_TEST_SET_DIAG_IO_SUBCMD

ESP_BT_VS_CFG_TEST_SET_AGC_MAX_GAIN_SUBCMD

ESP_BT_VS_CFG_TEST_ENABLE_CHAN_ASSESS_SUBCMD

ESP_BT_VS_CFG_TEST_SET_BACKOFF_UPLIMIT_SUBCMD

ESP_BT_VS_CFG_TEST_SET_CONN_TOP_PRIO_RESV_THRESH_SUBCMD

ESP_BT_VS_CFG_TEST_SET_TEST_EVT_MSK_SUBCMD

ESP_BT_VS_CFG_TEST_GET_WAKEUP_TIMEOUT_SUBCMD

ESP_BT_VS_CFG_TEST_RELATED_SUBCMD_MAX

## 乐鑫内部调试 HCI 事件

以下调试 HCI 事件已包含在乐鑫蓝牙控制器的预编译库中。这些事件不会被链接到应用程序的二进制文件中，除非应用程序中调用了相应的初始化函数。这些事件仅供乐鑫内部使用。应用程序开发者 不应 在其应用程序中调用初始化函数。

ESP_BT_VS_LE_RUNNING_STATUS_EVT_SUBCODE

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。