Android USB HID bulkTransfer()参数解析

一、概述

1、上一篇文章，记录的是Android UsbDeviceConnection.controlTransfer() 参数解析，那个也是相对于较难的，这文章是记录调试公司另一种产品，使用USB HID 类中的“中断传输”方式。

2、在Android USB Hos通讯开发中，中断传输是使用bulkTransfer() 方法的，这也是百度上资料最多的，用的最多最广范的一种usb通讯方式。

二、参数解析

1、中断传输：

（1）在USB HID 中，中断传输是HID设备使用中断管道与主机通信。

（2）在USB HID 设备类协议中，中断传输分为： A、中断输入 -- 传输从设备到主机的输入数据    B、 中断输出 -- 传输从主机到设备的输出数据

其中，中断输入是必须的，而中断输出是可选的。

（3）下面的代码是谷歌官方的介绍

    /**
     * Performs a bulk transaction on the given endpoint.
     * The direction of the transfer is determined by the direction of the endpoint.
     * 

     * This method transfers data starting from index 0 in the buffer.
     * To specify a different offset, use
     * {@link #bulkTransfer(UsbEndpoint, byte[], int, int, int)}.
     * 
     *
     * @param endpoint the endpoint for this transaction
     * @param buffer buffer for data to send or receive
     * @param length the length of the data to send or receive
     * @param timeout in milliseconds
     * @return length of data transferred (or zero) for success,
     * or negative value for failure
     */
    public int bulkTransfer(UsbEndpoint endpoint, byte[] buffer, int length, int timeout);

意思就是说，这个函数是使用端点传输的，且输出和输入都是使用同一个方法，传输方向取决于所使用的端点，

也就是使用输入端点，则是Host 主机从HID从机获取数据，使用输出端点，则是Host主机向HID从机发送数据。

（1）endpoint ： 定义通讯使用的端点， OUT or IN（Host to Device用OUT，Device to Host 用IN）

如何获取输入或则输出端点呢？

这就需要使用从接口中获取，我使用的，

        mUsbInterface = mUsbDevice.getInterface(0);             //设备的接口也需要在设备接口的描述符中获取
        if(mUsbInterface == null)
            return 2;

        //从端点0   
        mInEndpoint = mUsbInterface.getEndpoint(0);		//端点号，一般可以在HID设备的端点描述符中查到，并且可以确定输入输出端点号
        if(mInEndpoint == null)
            return 3;

        //端点1
        mOutEndpoint = mUsbInterface.getEndpoint(1);
        if(mOutEndpoint == null)
            return 4;

（2）buffer： 输出流/h或输入流

当endpoint 指定为输出端点时，则buffer 定义为输出报告。

当endpoint指定为输入端点时，则buffer 定义为输入报告。

大神形象解释：你将要发送/接收的指令或数据，当endpoint为OUT，buffer为你定义好的指令或数据，将下发给device，当endpoint为IN，buffer则是一个容器，用来存储device返回的应答指令或数据，此时一定要注意buffer的大小，以足够存储所有的数据；

（3）length: 定义输入或则输出端点的报告的长度

这个长度，可以在HID设备端点描述符中，查看到如下图，我调试的HID设备的输入和输出端点描述符：

（4）timeout:: 超时时间

因此，针对上面的解析，以下是我调试设备配置的参数：

A、Host 主机发送输出报告

int outLength = mConnection.bulkTransfer(mOutEndpoint, outputStream, 64, timeOut);

B、Host主机获取输入报告

int recLength = mConnection.bulkTransfer(mInEndpoint, inputStream, 64, timeOut);

以上就是Android USB Host 通讯中，中断传输使用的bulkTransfer() 方法的参数解析。这个相比于之前控制传输的controlTransfer() 参数还是简单些，而且也很容易理解。

下一篇，将记录我如何调试两种HID设备。