在藍牙協(xié)議棧開發(fā)過程中，有時需要預(yù)先知道 LLCP。本文將介紹如何利用 Trace 機制實現(xiàn) LLCP 預(yù)覽功能。

實現(xiàn)原理

打開 TracePLATFORM_TRACE_ID_LLCP類型，Controller 會在接收到 LLCP 時通過 Trace 回調(diào)函數(shù)導(dǎo)出數(shù)據(jù)。 我們可以在回調(diào)函數(shù)里截獲PLATFORM_TRACE_ID_LLCP，并預(yù)覽數(shù)據(jù)。這個的“預(yù)覽”包含兩層含義：

Controller 尚未處理該 PDU（Controller 將于 Trace 回調(diào)完成后處理 PDU）；

只可讀取 PDU 內(nèi)容，不可修改。

讓我們詳細介紹實現(xiàn)方法。

1.Trace數(shù)據(jù)結(jié)構(gòu)

PLATFORM_TRACE_ID_LLCPTrace 類型使用的頭信息結(jié)構(gòu)如下：

#pragmapack (push, 1)
typedefstruct
{
 uint32_tA;
 uint32_tB;
 uint8_t id;
 uint8_t tag;
}header_t;
#pragmapack (pop)

這個結(jié)構(gòu)使用#pragmapack (push, 1)指令確保內(nèi)存對齊。

2.Trace回調(diào)處理

假設(shè)cb_trace_read_llcp函數(shù)為 Trace 回調(diào)函數(shù)，在函數(shù)開頭添加代碼截獲接收到的 LLCP：

staticuint32_tcb_trace_read_llcp(constplatform_evt_trace_t*Trace,void*ctx)
{
 if(Trace->len1 ==sizeof(header_t))
  {
   constheader_t*p = (constheader_t*)Trace->data1;
   if((p->id == PLATFORM_TRACE_ID_LLCP) && (p->tag &1))
    {
     constuint8_t*p8 = (constuint8_t*)Trace->data2;
     llcp_preview(p->tag >>1, p8[0], p8 +1, Trace->len2 -1);
    }
  }
 // ...
 return0;
}

llcp_preview函數(shù)負責預(yù)覽 LLCP。下面的參考代碼打印了關(guān)于 LLCP 的完整信息：

連接句柄（handle）

操作碼（op_code）

控制數(shù)據(jù)

staticvoidllcp_preview(hci_con_handle_thandle,uint8_top_code,constuint8_t*ctr_data,intctr_data_len)
{
 platform_printf("LLCP[%d] OP %02x: ", handle, op_code);
 printf_hexdump(ctr_data, ctr_data_len);
 platform_printf("
");
}

特殊用法

目前 SDK 未提供設(shè)置公司 ID 的接口，暫時可以通過直接修改LLCP_VERSION_IND內(nèi)容的方法修改公司 ID（修改這個值不影響 Controller 的行為和流程。） 在下面的代碼里，公司 ID 被修改為0xABCD，小版本號被修改為0x1234。

#pragmapack (push, 1)
typedefstruct
{
 uint8_t version;
 uint16_tcompany_id;
 uint16_tsubversion;
}llcp_version_ind_t;
#pragmapack (pop)
staticuint32_tcb_trace_read_llcp(constplatform_evt_trace_t*trace,void*ctx)
{
 if(trace->len1 ==sizeof(header_t))
  {
   constheader_t*p = (constheader_t*)trace->data1;
   // 判斷是否為發(fā)送方向的 LLCP
   if((p->id == PLATFORM_TRACE_ID_LLCP) && (0== (p->tag &1)))
    {
     constuint8_t*p8 = (constuint8_t*)trace->data2;
     constuint16_tcon_handle = p->tag >>1;
     constuint8_t op_code  = p8[0];
     constintctrl_data_len  = trace->len2 -1;
     uint8_t* ctrl_data    = (uint8_t*)p8 +1;
     // 判斷是否為 LLCP_VERSION_IND
     if((op_code ==0x0c) && (ctrl_data_len ==sizeof(llcp_version_ind_t)))
      {
       llcp_version_ind_t*ver_ind = (llcp_version_ind_t*)(ctrl_data);
        ver_ind->company_id =0xABCD;
        ver_ind->subversion =0x1234;
      }
    }
  }
 // ...
 return0;
}

總結(jié)

利用 Trace 機制實現(xiàn)的 PDU 預(yù)覽功能，能幫助開發(fā)者實時監(jiān)控 LLCP 通信，實現(xiàn)必要功能。

溫馨提示：不要忘記設(shè)置PLATFORM_CFG_TRACE_MASK，其中要包含PLATFORM_TRACE_ID_LLCP。