GSDK v3.x 中 Bluetooth 与专有 RAIL 协议的动态多协议开发

┌─────────────────────────────────────────────────────┐
│                 DMP 应用程序层                       │
├───────────────────────┬─────────────────────────────┤
│   Bluetooth App Task  │   Proprietary App Task       │
│  (sl_bt_on_event())   │  (proprietaryAppTask())       │
├───────────────────────┼─────────────────────────────┤
│  Bluetooth Host Task  │   RAIL API（直接访问）        │
│  Bluetooth LL Task    │   sl_rail_app_on_event()      │
├───────────────────────┴─────────────────────────────┤
│           RAIL 多协议库（含无线电调度器）              │
├─────────────────────────────────────────────────────┤
│                  EFR32 无线电硬件                    │
└─────────────────────────────────────────────────────┘

// 多协议场景中，发送完成后必须让出无线电
static void sl_rail_app_on_event(RAIL_Handle_t railHandle, RAIL_Events_t events)
{
    if (events & RAIL_EVENT_TX_PACKET_SENT) {
        RAIL_YieldRadio(railHandle);  // 必须调用！
    }
}

// 定义任务间通信标志
#define CHARACTERISTIC_CHANGED ((OS_FLAGS)0x01)

// 在 proprietary_app.c 中定义 Tx FIFO
#define RAIL_TX_FIFO_SIZE (64)
static uint8_t txFifo[RAIL_TX_FIFO_SIZE];

// 在 sl_bt_on_event() 中处理 characteristic 值变更
case sl_bt_evt_gatt_server_attribute_value_id:
    if (evt->data.evt_gatt_server_attribute_value.attribute == gattdb_prop_char) {
        OSFlagPost(&proprietary_event_flags,
                    CHARACTERISTIC_CHANGED,
                    OS_OPT_POST_FLAG_SET,
                    &err);
    }
    break;

// 在 proprietaryAppTask() 无限循环之前，设置 Tx FIFO 和调度器信息
RAIL_SetTxFifo(railHandle, txFifo, 0, RAIL_TX_FIFO_SIZE);
RAIL_SchedulerInfo_t txSchedulerInfo = (RAIL_SchedulerInfo_t){ .priority = 100,
                                                                .slipTime = 100000,
                                                                .transactionTime = 800 };

// 在无限循环内等待标志并发送
while (DEF_TRUE) {
    RTOS_ERR err;
    OSFlagPend(&proprietary_event_flags,
                CHARACTERISTIC_CHANGED,
                (OS_TICK)0,
                OS_OPT_PEND_BLOCKING       \
                + OS_OPT_PEND_FLAG_SET_ANY \
                + OS_OPT_PEND_FLAG_CONSUME,
                NULL,
                &err);
    sl_status_t result;
    result = sl_bt_gatt_server_read_attribute_value(gattdb_prop_char, 0, 16, data_len, dataPacket);
    RAIL_WriteTxFifo(railHandle, dataPacket, data_len, true);
    RAIL_StartTx(railHandle, 0, RAIL_TX_OPTIONS_DEFAULT, &txSchedulerInfo);
}

static void sl_rail_app_on_event(RAIL_Handle_t railHandle, RAIL_Events_t events)
{
    if (events & RAIL_EVENT_TX_PACKET_SENT) {
        RAIL_YieldRadio(railHandle);
    }
}

#define PACKET_RECEIVED ((OS_FLAGS)0x02)

#define RAIL_RX_FIFO_SIZE (64)
static uint8_t rxFifo[RAIL_RX_FIFO_SIZE];

// 设置接收后自动返回 Rx 状态的状态转换
RAIL_StateTransitions_t stateTransition = (RAIL_StateTransitions_t){ .success = RAIL_RF_STATE_RX,
                                                                    .error = RAIL_RF_STATE_RX };
RAIL_SetRxTransitions(railHandle, &stateTransition);

// 设置 Rx 优先级（低于 Tx）并启动接收
RAIL_SchedulerInfo_t rxSchedulerInfo = (RAIL_SchedulerInfo_t){ .priority = 200 };
RAIL_StartRx(railHandle, 0, &rxSchedulerInfo);

if (events & RAIL_EVENT_RX_PACKET_RECEIVED) {
    RAIL_RxPacketInfo_t packetInfo;
    RTOS_ERR err;

    RAIL_GetRxPacketInfo(railHandle,
                        RAIL_RX_PACKET_HANDLE_NEWEST,
                        &packetInfo);

    if (packetInfo.packetStatus == RAIL_RX_PACKET_READY_SUCCESS) {
        RAIL_CopyRxPacket(rxFifo, &packetInfo);
        OSFlagPost(&proprietary_event_flags, PACKET_RECEIVED, OS_OPT_POST_FLAG_SET, &err);
    }
}

while (DEF_TRUE) {
    RTOS_ERR err;
    OS_FLAGS active_flags = OSFlagPend(&proprietary_event_flags,
                                        CHARACTERISTIC_CHANGED \
                                        + PACKET_RECEIVED,
                                        (OS_TICK)0,
                                        OS_OPT_PEND_BLOCKING       \
                                        + OS_OPT_PEND_FLAG_SET_ANY \
                                        + OS_OPT_PEND_FLAG_CONSUME,
                                        NULL,
                                        &err);

    if (active_flags & PACKET_RECEIVED) {
        sl_bt_gatt_server_write_attribute_value(gattdb_prop_char, 0, 16, rxFifo);
        sl_bt_external_signal(CHARACTERISTIC_CHANGED);
    }
}

case sl_bt_evt_system_external_signal_id:
    if (bluetooth_evt->data.evt_system_external_signal.extsignals & CHARACTERISTIC_CHANGED) {
        sl_bt_cmd_gatt_server_send_characteristic_notification(
            0xff, gattdb_prop_char, 16, rxFifo, &sent_len);
    }
    break;