X-Cube-BLE2适配FreeRTOS实现BLE任务的方法咨询

版本差异说明 #

你观察到的函数实现差异并非库文件错配，是X-Cube-BLE2 v1.2.0版本后的官方正式设计调整，不存在版本遗漏问题。官方对该改动的说明如下：

Up to release version v1.2.0, a while loop was implemented to read out events from the queue as long as it is not empty. However, in a bare metal implementation, this leads to calling in a "blocking" mode hci_user_evt_proc() as long as events are received without giving the opportunity to run other tasks in the background.
From now, the events are reported one by one. When it is checked there is still an event pending in the queue, a request to the user is made to call again hci_user_evt_proc(). This gives the opportunity to the application to run other background tasks between each event.

简单说旧版本hci_user_evt_proc()内置while循环，会一次性清空所有BLE事件队列，裸机下会长时间占用CPU导致其他后台逻辑无法运行；新版本改为单次仅处理1条事件，队列有剩余事件时会自动触发再次调用请求，天然适配RTOS的任务调度逻辑。

标准适配流程 #

你不需要修改BLE协议栈库的核心代码，只需要按照以下步骤适配接口即可：

• 替换异步事件通知回调
  裸机版本的hci_notify_asynch_evt()一般实现为置位全局轮询标志，适配FreeRTOS时直接改为通过线程标志唤醒BLE处理任务即可，该函数是官方预留的OS适配层接口，无需改动底层驱动：

  void hci_notify_asynch_evt(void* pdata)
  {
    UNUSED(pdata);
    osThreadFlagsSet(HciUserEvtProcessId, 1);
    return;
  }
  

• 创建独立BLE事件处理任务
  任务入口逻辑无需自行实现队列遍历，按照官方示例实现阻塞等待逻辑即可：

  static void HciUserEvtProcess(void *argument)
  {
    UNUSED(argument);
    for(;;)
    {
      osThreadFlagsWait(1, osFlagsWaitAny, osWaitForever);
      hci_user_evt_proc();
    }
  }
  

  注意不要在该任务里额外加循环读取事件的逻辑：新版本hci_user_evt_proc()处理完单条事件后，如果检测到队列还有未处理事件，会自动调用hci_notify_asynch_evt()重新置位线程标志，触发任务下一次调度，中间会自动让出CPU给其他就绪任务。
• 适配回调上下文
  所有BLE用户层回调（连接状态变化、GATT读写请求、广播事件等）都会运行在HciUserEvtProcess任务上下文，不要在这些回调里添加长时间阻塞、延时的操作，避免破坏BLE协议栈时序要求。

任务优先级配置建议 #

不需要刻意将BLE任务和普通业务任务设为同优先级，按照实时性要求分层配置即可：

• BLE协议栈事件处理对实时性有基础要求，建议HciUserEvtProcess任务优先级 不低于 普通非实时业务任务，避免事件堆积导致广播异常、连接断连等问题。
• 新版本单事件处理的设计已经避免了BLE任务长时间占用CPU的问题：哪怕连续收到多包BLE事件，每处理完1条事件后任务就会重新进入阻塞等待状态，调度器会自动切换到其他就绪的高优先级、同优先级任务，不会阻塞其他业务运行。
• 对实时性要求极高的任务（比如高速采样、电机控制），只要将其优先级设置为高于BLE任务即可，完全不会被BLE处理逻辑抢占。

内容的提问来源于stack exchange，提问作者Nafiur Rahman