说明
AdvertiseLE 命令负责启用 LE 广播。此命令在成功执行时返回零，而在出现任何错误时返回负值。
参数
唯一必需的参数决定是发送还是禁用广播报告。要禁用，请使用 0 作为第一个参数；要启用，请改用 1。
命令调用示例
- “AdvertiseLE 1”尝试在本地蓝牙设备上启用低功耗广播。
- “AdvertiseLE 0”尝试在本地蓝牙设备上禁用低功耗广播。
可能的返回值
- (0) 成功设置可配对性模式
- (-4) FUNCTION_ERROR
- (-6) INVALID_PARAMETERS_ERROR
- (-8) INVALID_STACK_ID_ERROR
- (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
- (-1) BTPS_ERROR_INVALID_PARAMETER
- (-56) BTPS_ERROR_GAP_NOT_INITIALIZED
- (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE
- (-57) BTPS_ERROR_DEVICE_HCI_ERROR
API 调用
根据第一个参数值：
- GAP_LE_Advertising_Disable(BluetoothStackID)
- GAP_LE_Set_Advertising_Data(BluetoothStackID, (Advertisement_Data_Buffer.AdvertisingData.Advertising_Data[0] + 1), &(Advertisement_Data_Buffer.AdvertisingData))
- GAP_LE_Set_Scan_Response_Data(BluetoothStackID, (Advertisement_Data_Buffer.ScanResponseData.Scan_Response_Data[0] + 1), &(Advertisement_Data_Buffer.ScanResponseData))
- GAP_LE_Advertising_Enable(BluetoothStackID, TRUE, &AdvertisingParameters, &ConnectabilityParameters, GAP_LE_Event_Callback, 0)
API 原型
- int BTPSAPI GAP_LE_Advertising_Disable(unsigned int BluetoothStackID)
- int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)
- int BTPSAPI GAP_LE_Set_Scan_Response_Data(unsigned int BluetoothStackID, unsigned int Length, Scan_Response_Data_t *Scan_Response_Data)
- int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)
- int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)
API 说明
- 提供的 GAP_LE_Advertising_Disable 函数使本地主机能够取消（停止）正在进行的广播过程。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
- 提供的 GAP_LE_Set_Advertising_Data 使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
- 提供的 GAP_LE_Set_Scan_Response_Data 函数使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
- 提供的 GAP_LE_Set_Advertising_Data 函数使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。