TI OMAP3 DM3730 USB host controller high full low speed?

因為 TI OMAP3 DM3730 在 USB host controller 上偵測不到 full/low speed USB device，經查之後發現目前的硬體接線 ULPI 因為 DM3730 跟選用的 USB transceiver 的ULPI phy 的 serial 排線順序不一樣，在設定為外接 USB transceiver phy，而非 TLL 的接線方式時，無法使用 full/low speed mode，選用 device 時必須注意只能接 high speed device，如果要保持原有 

USB host controller ---phy--- USB transceiver --D+D-

接法， ulpi phy 線路不改而想要使用 full/low speed USB device，可以再外接一顆 high speed USB hub 解決。

2012/02/24

今天又花了些時間跟 Ken，還有 EE 確定 USB 問題，有些地方一開始誤解，因為是從軟體驅動程式行為，發現硬體有問題，一開始以為是目前元件接法

USB host controller ---phy--- USB transceiver --D+D-

無法實作， EE 在我提出有問題後就進行調查，發現是 ulpi serial 無法對應，其實並非這樣子的元件接法問題，而是 DM3730 的輸出分 ulpi parallel, ulpi serial, TLL 三種，因為我們有接 transceiver，就只能選擇 transceiver 有支援的 ulpi parallel 或 ulpi serial二擇一，high speed 的接法是 ulpi parallel，而 full/low speed 的 ulpi serial 接法，因需要接腳比 parallel 少，原本可以使用同一組硬體排線，但是因為 DM3730 跟所用 transceiver 的 ulpi serial 接腳順序與 transceiver 不同，造成無法使用現有的線路，待跳線驗證後可確定。

結論：

跳線加上 ohci driver 實測驗證後發現以 3 wire 的 ulpi serial 對 usb transceiver 就已經會發生誤判為有 USB low device (MiniPCI-E 上沒插卡)，但我們 usb host port 的 transceiver 又沒有介面控制調整為 3-wire serial, 6-wire serial 或 12(8+4) parallel(預設)，再加上 DM3730 SoC 原有的 ehci 轉換到 ohci 就會鎖死的 bug，最後確定無法使用原來的 

DM3730 USB host controller -- phy -- USB transceiver -- D+D- 

的接法，必須要再外接一個 USB hub 在 MiniPCI-E 上才能使用 USB full/low speed device.

相關文章：

linux USB hid driver cypress_m8.c

linux USB hid driver cypress_m8.c

參考 USB Device Class Definition for Human Interface Devices(HID)
firmware spec version 1.11，範例 driver 是 USB Cypress M8 driver
~linux/drivers/usb/serial/cypress_m8.c，source code 中說有
文件就在 ~linux/Documentation/usb/usb-serial.txt。

主要是看 DeLorme Earthmate USB 的 usb hid 如何設定，她使用的
是 feature report 的方式，在 control pipe 傳送 5 bytes 資料。
對應到 USB HID spec 的 7.2 Class-specific Requests 裡面的 7.2.1
Get_Report Request 跟 7.2.2 Set_Report Request，透過 control
pipe 傳送 host <-> device 資料。

呼叫 usb_control_msg()，定義在 USB core 的實作中
~linux/drivers/usb/core/message.c：


/**
* usb_control_msg - Builds a control urb, sends it off and waits for completion
* @dev: pointer to the usb device to send the message to
* @pipe: endpoint "pipe" to send the message to
* @request: USB message request value
* @requesttype: USB message request type value
* @value: USB message value
* @index: USB message index value
* @data: pointer to the data to send
* @size: length in bytes of the data to send
* @timeout: time in msecs to wait for the message to complete before timing
* out (if 0 the wait is forever)
*
* Context: !in_interrupt ()
*
...
*/
int usb_control_msg(struct usb_device *dev, unsigned int pipe, __u8 request,
__u8 requesttype, __u16 value, __u16 index, void *data,
__u16 size, int timeout)



有兩種用法，差異在於傳輸方向，是以 host 為主體而有 in/out, set/get 不同。
一個是 host 傳到 device(out/set)，另一個是 device 到 host(in/get)。

host->device 是 USB_DIR_OUT，使用 HID_REQ_SET_REPORT request
建立 send endpoint pipe 是用 usb_sndctrlpipe()

device->host 是 USB_DIR_IN，使用 HID_REQ_GET_REPORT request
建立 receive endpoint pipe 是用 usb_rcvctrlpipe()


retval = usb_control_msg(port->serial->dev,
usb_sndctrlpipe(port->serial->dev, 0),
HID_REQ_SET_REPORT,
USB_DIR_OUT | USB_RECIP_INTERFACE | USB_TYPE_CLASS,
0x0300, 0, feature_buffer,
feature_len, 500);

retval = usb_control_msg(port->serial->dev,
usb_rcvctrlpipe(port->serial->dev, 0),
HID_REQ_GET_REPORT,
USB_DIR_IN | USB_RECIP_INTERFACE | USB_TYPE_CLASS,
0x0300, 0, feature_buffer,
feature_len, 500);


第一個參數就是 struct usb_device *dev，probe 時就可以取到
第二個是利用 MACRO 從 usb device 找到 usb device 的 endpoint pipe
第三個參數是 message request value，HID_REQ_SET_REPORT 或
HID_REQ_GET_REPORT
第四個是 message request type value，
USB_DIR_OUT | USB_RECIP_INTERFACE | USB_TYPE_CLASS, 或
USB_DIR_IN | USB_RECIP_INTERFACE | USB_TYPE_CLASS,

第五個參數是 message value 看 device hard code: 0x0300
第六個參數是 message index value hard code: 0

因為採用的是 feature report 的方式傳送 5 bytes 資料存在
第七個參數 feature_buffer 中，
第八個參數是 feature_len 是資料長度。
第九個參數是 500 micro seconds 的 timeout。

相關文章：

TI OMAP3 DM3730 USB host controller high full low speed?

相關連結：

http://www.usb.org/developers/devclass_docs/HID1_11.pdf

~linux/drivers/usb/serial/cypress_m8.c

~linux/drivers/usb/core/message.c