Android USB Host 使用详解(U盘)(二)

上一篇介绍了读取Android手机连接的USB设备信息的例子,本篇介绍官方文档中关于USB的API:官方API。注:主要介绍关于Host Mode的。

1)UsbAccessory

用于代表USB从设备的一个类,这个从设备通过USB数据线与Android应用进行通信。

 

2)UsbConfiguration

用于代表USB设备(指连接Android手机的USB从设备)配置信息的一个类。

 

3)UsbConstants

这个类主要包含USB协议常量的类,这些常量与Linux内核下linux/usb/ch9.h 里面定义的相对应。

 

4)UsbDevice

这个类代表在Host Mode下,连接Android手机的USB设备的类。

equals(object) : 用于判断本设备是否与object相等,在编程时判断两个设备是否为同一设备时会用到。

其余的get函数都是返回相应的值。如:getDeviceProtocol()返回代表协议的常量,getDeviceProtocol()==UsbConstants.USB_CLASS_HID则说明此设备为HID设备。

getInterfaceCount():返回设备的接口总数。对于U盘的接口数为1。

getInterface():获取接口(UsbInterface)。

 

5)UsbInterface

这个类代表USB设备上的一个接口。一个USB设备可以有1个或多个接口,每个接口提供不同的功能。一个接口又有1个或者多个端点(UsbEndpoint),端点是用于数据或者命令传输的通道。

getEndpointCount():返回此接口的端点数。对于U盘,返回的端点数为2(用上一篇博客介绍的方法可得)。

getEndpoint(index):返回对应的端点。

 

6)UsbEndpoint

这个类代表接口上的一个端点。端点是用于数据传输的通道。典型的bulk端点用于传输大量的数据,interrupt端点用于传输小量数据,如事件,与数据流分开传输。在官方文档中说端点0是用于传输控制信息的,而端点0是所有USB设备都默认拥有的。但是这个端点0并不会被枚举出来,也就是说,要传输control信息直接用controlTransfer()传输即可,不要试图打开端点0后再进行传输。举个例子:大家所熟悉的U盾,为HID设备,拥有一个接口,缺省的控制端点;用getInterface(0)获取接口0,在getEndpointCount()返回的值为0,端点数为0;控制端点没有被枚举出来。再如U盘有一个接口,拥有控制端点,bulk-in端点,bulk-out端点,总共3个,但是getEndpointCount()返回的值是2。还有鼠标键盘等HID设备为单向传输设备,不能被获取到。

注:在Google API中提到的endpoint 0特指控制端点,而不是指端点号为0的端点。

 

7)UsbManager

这个类允许你获取USB的状态并和USB设备进行通信。

openDevice(),打开要进行通信的USB设备,返回一个UsbDeviceConnection对象。

在使用UsbDeviceConnection对象进行通信前,必须获取权限(获取使用者的同意)。使用

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
获取UsbManager对象,用hasPremission()判断设备是否拥有权限,如果没有,使用如下方法获取权限

mPermissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0);
IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION);
registerReceiver(mUsbReceiver, filter);
mUsbManager.requestPermission(mUsbDevice, mPermissionIntent); 

 
    private final BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {

        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            if (ACTION_USB_PERMISSION.equals(action)) {
                synchronized (this) {
                    if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
                    	// 获取权限后的操作
                    } 
                    else {
                        finish();
                    }
                }
            }
        }
    };

8)UsbRequest

一个代表请求传输数据包的类。UsbRequest类可以用于在bulk端点和interrupt端点传输数据。control信息的传输不可使用此类。


9)UsbDeviceConnection

这个类用于在Android手机从USB设备接收和发送控制信息和数据信息。此类由openDevice()创建。

bulkTransfer(UsbEndpoint endpoint, byte[] buffer, int length, int timeout)

这个函数用于数据传输的。

      endpoint 为传输端点,注意端点的方向。

      buffer 为传输的数据,至于传输数据的格式,需要了解手中的设备具体PDF,不然发送的数据是无意义的,并且无法接收数据。

      length 为buffer的长度。

      timeout 为有效时间(设为0可能导致程序意外终止退出)。

返回值传输的数据的长度,小于0说明传输失败。

controlTransfer (int requestType, int request, int value, int index, byte[] buffer, int length, int timeout)

这个函数用于控制信息的传输,后面三个参数与上面相同。

      requestType 为请求类型,低8位为有效的,第7为表示方向如0x00为发送数据,0x80为接收数据,接收数据时,buffer要有足够的长度。其余7位的设置根据手中设备提供的文档进行设置。(具体值都会在设备文档中给出

      request 与上面的request对应。(具体值都会在设备文档中给出

      value 与上面两个参数对应。(具体值都会在设备文档中给出

      index 表示使用的接口号。(具体值都会在设备文档中给出

HID设备文档下载地址:HID设备文档

U盘设备文档下载地址:U盘bulk-only传输文档

(1)建立连接(HID设备)

	private void makeConnection() {
		if(mUsbDevice == null) {
			Toast.makeText(this, R.string.no_device, Toast.LENGTH_SHORT).show();
        	finish();
			return;
		}
		if(mUsbDevice.getInterfaceCount() != 1) {
			Toast.makeText(this, R.string.interface_error, Toast.LENGTH_SHORT).show();
			finish();
			return;
		}
		
		UsbInterface intf = mUsbDevice.getInterface(0);
						
		if (mUsbDevice != null) {
            UsbDeviceConnection connection = mUsbManager.openDevice(mUsbDevice);
            if (connection != null && connection.claimInterface(intf, true)) {
            	Toast.makeText(this, R.string.connection_fine, Toast.LENGTH_SHORT).show();
                mConnection = connection;
            } else {
            	Toast.makeText(this, R.string.connection_error, Toast.LENGTH_SHORT).show();
                mConnection = null;
                finish();
            }
         }
	}
(2)发送控制信息(mCmd[8]请根据自己的设备进行设置)

	private void sendCommand() {
		
		synchronized (this) {
            if (mConnection != null) {
            	mCmd = new byte[8];
            	mCmd[0] = (byte) 0x00; //请自行设置
            	mCmd[1] = (byte) 0x00;
            	mCmd[2] = (byte) 0x00;
            	mCmd[3] = (byte) 0x00;
            	mCmd[4] = (byte) 0x00;
            	mCmd[5] = (byte) 0x00;
            	mCmd[6] = (byte) 0x00;
            	mCmd[7] = (byte) 0x00;
            	
                int result = mConnection.controlTransfer(0x21, 0x09, 0x0300, 0x00, mCmd, mCmd.length, 1000);
                if(result < 0) {
    				Toast.makeText(this, R.string.send_command_failed, Toast.LENGTH_SHORT).show();
    			} else {
    				Toast.makeText(this, R.string.send_command_successed, Toast.LENGTH_SHORT).show();
    			}    	
            }
        }
	}
(3)根据发送的控制信息,接收控制信息的结果(HID设备)

private void recvMessage() {
		
		synchronized (this) {
            if (mConnection != null) {
            	byte[] message = new byte[32];
                int result = mConnection.controlTransfer(0xA1, 0x01, 0x0300, 0x00, message, message.length, 1000);
                
                if(result < 0) {
    				Toast.makeText(this, R.string.recv_message_failed, Toast.LENGTH_SHORT).show();
    				mMessageView.setText(R.string.string_null);
    			} else {
    				Toast.makeText(this, R.string.recv_message_successed, Toast.LENGTH_SHORT).show();
    				String str = new String();
    				for(int i=0; i<message.length; i++) {
    					str += Integer.toHexString(message[i]&0x00FF)  + " ";
    				}
    				mMessageView.setText(str);
    			}
            }
        }
	}

 

上面是我U盾操作中截取的,请原谅我不能公开命令参数!

Android USB Host的API的简要介绍就到这里,不明白的请看下一篇:Android bulk-only U盘操作实例




评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值