# 乐鑫自定义 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 return the value in command

  备注

  The init function is `bt_stack_enableEchoVsCmd(true)`

ESP_BT_VS_SET_COEX_STATUS_OCF

  Set/Clear coexistence status (OCF: 0x0082)

  备注

  The init function is `bt_stack_enableCoexVsCmd(true)`

ESP_BT_VS_CONFIG_DUP_EXC_LIST_OCF

  Config scanning duplicate exceptional list (OCF: 0x0108)

  备注

  The init function is `advFilter_stack_enableDupExcListCmd(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 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_MIN_ENC_KEY_SIZE_OCF

  Set Classic Bluetooth minimum encryption key size (OCF: 0x0182)

  备注

  The init function is `bt_stack_enableSecCtrlVsCmd(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)`

ESP_BT_VS_LEGACY_REM_AUTH_EVT_SUBCODE

  This event indicates legacy authentication is completed by remote device (EVTCODE: 0xFF, SUBCODE: 0x03)

  备注

  The init function is `bt_stack_enableSecCtrlVsCmd(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_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_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_RELATED_SUBCMD_MAX

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

ESP_BT_VS_WR_DM1_ENABLE_OCF

  备注

  The init function is `bt_stack_enablePktCtrlVsCmd(true)`

ESP_BT_VS_CLK_UPDATE_OCF

  备注

  The init function is `bt_stack_enableClkCtrlVsCmd(true)`

ESP_BT_VS_SET_AFH_OCF

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

ESP_BT_VS_SET_EVT_MASK_OCF

  备注

  The init function is `bt_stack_enableBasicVsCmd(true)`

ESP_BT_VS_SET_AFH_REPORTING_MODE_OCF

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

ESP_BT_VS_MASK_RMT_CHANNEL_CLASSIFICATION_OCF

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

ESP_BT_VS_WR_AUTO_RATE_INIT_OCF

  备注

  The init function is `bt_stack_enableRateCtrlVsCmd(true)`

## 乐鑫内部调试 HCI 事件

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

ESP_BT_VS_AFH_CHG_EVT_SUBCODE

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

ESP_BT_VS_CH_CLASSIFICATION_EVT_SUBCODE

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

ESP_BT_VS_CH_CLASSIFICATION_REPORTING_MODE_EVT_SUBCODE

  备注

  The init function is `bt_stack_enableAfhVsCmd(true)`

此文档对您有帮助吗？

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

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