本文轉(zhuǎn)自公眾號(hào),歡迎關(guān)注
基于DWC2的USB驅(qū)動(dòng)開發(fā)-UVC的單元和終端類請(qǐng)求驅(qū)動(dòng)代碼優(yōu)化 (qq.com)

前言

前面介紹了UVC的處理單元和相機(jī)終端，可以看到各單元和終端的請(qǐng)求形式都是一樣的, 只是支持的CS和操作類型不一樣，數(shù)據(jù)的大小不一樣。目前的驅(qū)動(dòng)是基于層層switch去解析的，這樣代碼冗余非常大，每一個(gè)接口的每一個(gè)單元和終端的每一個(gè)CS的每一個(gè)操作類型都要單獨(dú)添加代碼處理，而且這些處理應(yīng)該位于類相關(guān)代碼中，對(duì)用戶不可見，用戶只需要關(guān)心具體的值的獲取與更新。而現(xiàn)在的處理方式做不到，現(xiàn)在用戶必須去修改這部分代碼才能獲取和更新值，并且添加修改接口，終端和單元就需要修改代碼。所以有必要對(duì)驅(qū)動(dòng)進(jìn)行優(yōu)化，下面介紹優(yōu)化細(xì)節(jié)。

https://mp.weixin.qq.com/s/4CTR1yjUmBsHqZPLEC7BhA

數(shù)據(jù)抽象

前面我們可以看到，單元和終端請(qǐng)求及其數(shù)據(jù)都是類似的，變化的是接口號(hào)，單元和終端號(hào)，CS，操作類型，值的大小，所以對(duì)這些進(jìn)行抽象，抽象為數(shù)據(jù)結(jié)構(gòu)，對(duì)應(yīng)的變量即數(shù)據(jù)結(jié)構(gòu)的成員變量。

首先對(duì)CS對(duì)應(yīng)的值空間分配進(jìn)行抽象

規(guī)格書P173中類相關(guān)的請(qǐng)求，對(duì)應(yīng)如下，即對(duì)應(yīng)不同的數(shù)據(jù)類型，其中SET只有一個(gè)，其他都是GET，暫時(shí)不考慮ALL的操作，對(duì)于ALL的操作預(yù)留回調(diào)接口到時(shí)單獨(dú)實(shí)現(xiàn)，目前基本是不會(huì)用到ALL相關(guān)的操作的。

那么我們需要如下的值空間，共7個(gè)值

CUR 當(dāng)前值

MIN 最小值

MAX 最大值

RES 分辨率

LEN 數(shù)據(jù)長(zhǎng)度

INFO 信息

DEF 默認(rèn)值

最直接的分配空間的方法是以上7個(gè)類型各存一份，可連續(xù)放在一起。

但是不是所有的CS都支持這些值，所以為了減少空間占用，我們只分配支持的，不支持的不需要分配空間。并且我們還需要知道每個(gè)值的長(zhǎng)度,

于是一個(gè)CS需要一片空間，這一片空間再分配給具體的某個(gè)類型，這樣每個(gè)類型還需要一個(gè)長(zhǎng)度信息，于是抽象出如下結(jié)構(gòu)體

/**
 * struct usbd_uvc_utcs_t
 * UVC類的終端和單元對(duì)應(yīng)CS的值,所有操作類型的值空間分配
 */
typedef struct 
{
    uint8_t  cs;                  /**< Control Selector Codes                            */
    uint8_t* buffer;              /**< 數(shù)據(jù)緩沖區(qū)                                         */
    uint8_t  len[7];              /**< [CUR MIN MAX RES LEN INFO DEF]的順序,索引0對(duì)應(yīng)CUR   */
} usbd_uvc_utcs_t;

Cs即為對(duì)應(yīng)的CS

Buffer即分配給該CS下所有類型值的空間

Len[7]對(duì)應(yīng)7個(gè)類型，每個(gè)類型的長(zhǎng)度，長(zhǎng)度為0表示該類型不支持。

那么怎么知道該類型在buffer中的偏移呢，可以通過前面所有l(wèi)en累計(jì)來計(jì)算，

比如MAX在CUR和MIN后面，其偏移就是len[0]+len[1],

并且還可以用GET_XXX的值是連續(xù)遞增的特點(diǎn)來計(jì)算，比如GET_MAX=GET_CUR+2,

所以前面有2個(gè)值，所以計(jì)算偏移循環(huán)計(jì)算前面2個(gè)即可。

以上對(duì)小的顆粒CS的數(shù)據(jù)空間進(jìn)行了抽象，再往上一層，一個(gè)單元和終端支持多個(gè)CS，但是不一定所有的都會(huì)支持，所以需要再將支持的CS進(jìn)行組合

抽象出如下結(jié)構(gòu)體

typedef void (*uvc_ut_set_pf)(void* data, uint32_t len); /**< SET回調(diào)函數(shù) */
typedef void (*uvc_ut_get_pf)(void* data, uint32_t len); /**< GET回調(diào)函數(shù) */

/**
 * struct usbd_uvc_utcr_t
 * UVC類的終端和單元控制請(qǐng)求結(jié)構(gòu)體
 * Unit and Terminal Control Requests
 */
typedef struct usbd_uvc_utcr
{
    uint8_t itf;                /**< 位于的接口               */
    uint8_t id;                 /**< 終端和單元ID             */
    uint8_t csnum;              /**< 終端和單元的CS個(gè)數(shù)        */
    usbd_uvc_utcs_t* cs;        /**< 終端和單元CS對(duì)應(yīng)的值空間  */
    uvc_ut_set_pf set_cb;       /**< SET回調(diào)                  */
    uvc_ut_get_pf get_cb;       /**< GET回調(diào)                  */ 
    struct usbd_uvc_utcr* next; /**< 指向下一個(gè)終端或單元       */
} usbd_uvc_utcr_t;

用戶初始化

這樣用戶只需要分配上述空間，并注冊(cè)回調(diào)函數(shù)，實(shí)現(xiàn)回調(diào)函數(shù)即可

usbd_uvc_utcr_t s_uvc_utcr2_t=
{
    0,                                                 /**< 接口0                     */
    2,                                                 /**< ID2                       */
    sizeof(s_uvc_utcs2_t)/sizeof(s_uvc_utcs2_t[0]),    /**< 總共19個(gè)屬性               */
    .cs=s_uvc_utcs2_t,                                 /**< 終端和端元CS及其值          */
    .set_cb=0,                                         /**< set回調(diào)                    */
    .get_cb=0,                                         /**< get回調(diào)                    */
    .next=0,                                           /**< usbd_uvc_reg_utcr時(shí)自動(dòng)鏈接 */
};

如下注冊(cè)即可
usbd_uvc_reg_utcr(&s_uvc_utcr2_t);

對(duì)應(yīng)s_uvc_utcs2_t一行對(duì)應(yīng)一個(gè)CS，我們根據(jù)手冊(cè)的描述來設(shè)置

以PU_BACKLIGHT_COMPENSATION_CONTROL為例

該CS支持的類型有CUR，MIN，MAX，RES，INFO，DEF除了LEN都支持

對(duì)應(yīng)長(zhǎng)度分別時(shí){2,2,2,2,0,1,2}總長(zhǎng)為11，所以需要11字節(jié)緩沖區(qū)

uint8_t s_backlight_buffer_au8[11];

/** 處理單元
* len[CUR MIN MAX RES LEN INFO DEF]
*/
usbd_uvc_utcs_t s_uvc_utcs2_t[]=
{
{
.cs = PU_BACKLIGHT_COMPENSATION_CONTROL,
.buffer = s_backlight_buffer_au8,
{2,2,2,2,0,1,2},
},
}

以上就完成了初始化，緩沖區(qū)可以動(dòng)態(tài)分配也可以靜態(tài)分配。

注冊(cè)過程

如下將每個(gè)終端和的單元的結(jié)構(gòu)體通過單向鏈表鏈接起來，usb_uvc為類結(jié)構(gòu)體全局變量，屬于驅(qū)動(dòng)部分這里不講，后面會(huì)講到。

/**

* @fn int usbd_uvc_reg_utcr(usbd_uvc_utcr_t* item)
* 注冊(cè)類相關(guān)單元和終端控制請(qǐng)求
* @param[in] item ref usbd_uvc_utcr_t
* @retval 0:成功.
* @retval !=0:其他值失敗.
  */
int usbd_uvc_reg_utcr(usbd_uvc_utcr_t* item)
  {
  if(item == (usbd_uvc_utcr_t*)0)
  {
  return -1;
  }
  if(usbd_uvc.utcr_list == (void*)0)
  {
  /* 當(dāng)前鏈表為空,直接添加到頭
  * 設(shè)置Next為空
    */
item- >next = (usbd_uvc_utcr_t*)0;
    usbd_uvc.utcr_list = item;
    }
    else
    {
    /* 當(dāng)前鏈表不為空,插入到頭
  * 設(shè)置Next為之前的頭
    */
item- >next = (usbd_uvc_utcr_t*)(usbd_uvc.utcr_list);
    usbd_uvc.utcr_list = item;
    }
    return 0;
    }

處理過程

可以簡(jiǎn)單了很多，且支持任意的接口，終端單元，CS和類型的配置。

static void uvc_class_ut_req(dwc_handle *dwc, ureq_t setup)
{
/* 搜尋終端和處理單元號(hào) */
usbd_uvc_utcr_t* p = 0;
usb_class_def* c_p;
int itf;
int id;
int cs;
int req;
int off = 0;
int len = 0;
int getsetlen = 0;
itf = setup- >wIndex & 0xFF;

/* 根據(jù)接口號(hào)查找接口類 */
c_p = dwc- >pclass_cb;
int getitf=0;
while(c_p != 0)
{
for(int i=0; i< 8; i++)
{
if(c_p- >itfs[i] == 0xFF)
{
break;
}
if(c_p- >itfs[i] == itf)
{
getitf = 1;
break;
}
}
if(getitf != 0)
{
p = c_p- >utcr_list;
break;
}
c_p= c_p- >next;
}
if(p == 0)
{
/* 沒有找到接口對(duì)應(yīng)的類 */
USBD_UVC_WARN(("unknow itf:%drn",itf));
return;
}

id =  (setup- >wIndex > > 8) & 0xFF;
cs = (setup- >wValue > > 8) & 0xFF;
req = setup- >bRequest;

#if 0
if((req & 0xF0) == 0x90)
{
/* GET_XXX_ALL*/
usb_ep0_set_stall(dwc); /* 暫時(shí)不支持 后面再實(shí)現(xiàn) */
return;
}
else if((req & 0xF0) == 0x10)
{
/* SET_CUR_ALL */
usb_ep0_set_stall(dwc); /* 暫時(shí)不支持 后面再實(shí)現(xiàn) */
return;
}
else
{
/* 其他的支持 */
}
#endif
while(p != (usbd_uvc_utcr_t*)0)
{
if((p- >itf == itf) && (p- >id == id))
{
for(int i=0; i< p- >csnum; i++)
{
if(cs == p- >cs[i].cs)
{
/* 如果長(zhǎng)度為0說明不支持,直接STALL返回 */
len = p- >cs[i].len[(req&0x0F) - 1];
if(len == 0)
{
usb_ep0_set_stall(dwc);
USBD_UVC_WARN(("NOT SUPPORT ITF:%d ID:%d CS:%d REQ%drn",itf,id,cs,req));
return;
}
getsetlen = setup- >wLength > len ? len  : setup- >wLength;
/* 計(jì)算偏移值 */
off = 0;
for(int j=0; j< ((req&0x0F) - 1); j++)
{
off += p- >cs[i].len[j];
}
/* 找到CS
* INFO CUR MIN MAX RES DEF LEN
*/
switch(req)
{
case GET_INFO:
case GET_CUR:
case GET_MIN:
case GET_MAX:
case GET_RES:
case GET_DEF:
case GET_LEN:
if(p- >get_cb != 0)
{
p- >get_cb(0,0);
}
usb_ep0_write(dwc, p- >cs[i].buffer + off, getsetlen);
USBD_UVC_LOG(("ITF:%d ID:%d GET CS:%d REQ:%x OF:%d LEN:%drn",itf,id,cs,req,off,getsetlen));
break;
case SET_CUR:
if(p- >set_cb != 0)
{
p- >set_cb(0,0);
}
usb_ep0_read(dwc, p- >cs[i].buffer + off, getsetlen, 0);
USBD_UVC_LOG(("%d %d SET %d %d %d %drn",itf,id,cs,req,off,getsetlen));
break;
default:
usb_ep0_set_stall(dwc);
break;
}
return;
}
}
}
p = p- >next;
}
/* 未找到匹配項(xiàng)則STALL */
usb_ep0_set_stall(dwc);
}

對(duì)比之前的設(shè)計(jì)，

總結(jié)

以上實(shí)現(xiàn)了終端和單元請(qǐng)求相關(guān)驅(qū)動(dòng)的代碼，實(shí)現(xiàn)可分層設(shè)計(jì)，可擴(kuò)展具備可移植性。后面再考慮實(shí)現(xiàn)ALL相關(guān)的操作。
審核編輯：湯梓紅