# 乐鑫自定义 HCI 命令

[English]

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

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

ESP_BT_VS_COMMON_ECHO_OCF

  Test vendor HCI feature (OCF: 0x0081)

  The Controller returns the value in command.

  备注

  The init function is `bt_stack_enableEchoVsCmd(true)`

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_ENABLE_CSA2_OCF

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

  备注

  The init function is `chanSel_stack_enableSetCsaVsCmd(true)`

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

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

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_ENABLE_CCA_SUBCMD

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_GET_CTRL_STATUS_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_SET_AUX_OFFSET_THRESHOLD_SUBCMD

ESP_BT_VS_CFG_TEST_RELATED_SUBCMD_MAX

此文档对您有帮助吗？

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

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