Android开发之USB数据通信

/ Android / 没有评论 / 2283浏览

Android开发之USB数据通信

Android开发中USB串口通信开发主要涉及到以下几个类及相应的方法:

一. UsbManager

负责管理USB设备的类,你可以在相应代码中通过以下方法获得

//获取UsbManager实例方法
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

该类提供的主要方法有:

  1. getDeviceList() 获得设备列表,返回的是一个HashMap.

  2. hasPermission(UsbDevice device) 判断你的应用程序是否有接入此USB设备的权限,如果有则返回真,否则返回false.

  3. openDevice(UsbDevice device) 打开USB设备,以便向此USB设备发送和接受数据,返回一个关于此USB设备的连接。

  4. requestPermission(UsbDevice device, PendingIntent pi) 向USB设备请求临时的接入权限。

二. UsbDevice

一个USB设备对象,每个设备一般包括一个接口,也可能有多个,每个接口又包含节点用来与此设备传输数据。主要方法有:

  1. getDeviceClass() 返回此USB设备的类别,用一个整型来表示。

  2. getDeviceId() 返回唯一标识此设备的ID号,也用一个整型来表示。

  3. getDeviceName() 返回此设备的名称,用一个字符串来表示。

  4. getDeviceProtocol() 返回此设备的协议类别,用一个整型来表示。

  5. getDeviceSubclass() 返回此设备的子类别,用一个整型来表示。

  6. getVendorId() 返回生产商ID

  7. getProductId() 返回产品ID

  8. getInterfaceCount() 返回此设备的接口数量

  9. getInterface(int index) 得到此设备的一个接口,返回一个UsbInterface。

三. UsbInterface

代表USB设备的一个接口(物理接口),UsbInterface本身是一个类,此类的主要方法有以下:

  1. getId() 得到给接口的id号。

  2. getInterfaceClass() 得到该接口的类别。

  3. getInterfaceSubclass() 得到该接口的子类。

  4. getInterfaceProtocol() 得到该接口的协议类别。

  5. getEndpointCount() 获得关于此接口的节点数量。

  6. getEndpoint(int index) 对于指定的index获得此接口的一个节点,返回一个UsbEndpoint.

四. UsbEndpoint

代表一个接口的某个节点的类。该类主要方法:

  1. getAddress() 获得此节点的地址

  2. getAttributes() 获得此节点的属性

  3. getDirection() 获得此节点的数据传输方向

五. UsbDeviceConnection

代表USB连接的一个类。用此连接可以想USB设备发送和接收数据,主要方法有:

  1. bulkTransfer(UsbEndpoint endpoint, byte[] buffer, int length, int timeout) 通过给定的endpoint来进行大量的数据传输,传输的方向取决于该节点的方向,buffer是要发送或接收的字节数组,length是该字节数组的长度。传输成功则返回所传输的字节数组的长度,失败则返回负数。

  2. controlTransfer(int requestType, int request, int value, int index, byte[] buffer, int length, int timeout) 该方法通过0节点向此设备传输数据,传输的方向取决于请求的类别,如果requestType为USB_DIR_OUT则为写数据,USB_DIR_IN, 则为读数据

以上介绍资料主要来自博文: http://www.osedu.net/article/linux/2014-04-16/678.html

—-示例代码——

public class UsbTestActivity extends Activity implements View.OnClickListener {
    //设备列表
    private HashMap<String, UsbDevice> deviceList;
    //从设备读数据
    private Button read_btn;
    //给设备写数据(发指令)
    private Button write_btn;
    //USB管理器:负责管理USB设备的类
    private UsbManager manager;
    //找到的USB设备
    private UsbDevice mUsbDevice;
    //代表USB设备的一个接口
    private UsbInterface mInterface;
    private UsbDeviceConnection mDeviceConnection;
    //代表一个接口的某个节点的类:写数据节点
    private UsbEndpoint usbEpOut;
    //代表一个接口的某个节点的类:读数据节点
    private UsbEndpoint usbEpIn;
    //要发送信息字节
    private byte[] sendbytes;
    //接收到的信息字节
    private byte[] receiveytes;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_usb);

        initUsbData();
        initViews();
    }

    private void initUsbData() {
        // 获取USB设备
        manager = (UsbManager) getSystemService(Context.USB_SERVICE);

        //获取到设备列表
        deviceList = manager.getDeviceList();
        Iterator<UsbDevice> deviceIterator = deviceList.values().iterator();
        while (deviceIterator.hasNext()) {
            Log.e("ldm", "vid=" + usb.getVendorId() + "---pid=" + usb.getProductId());
            //if (mVendorID == usb.getVendorId() && mProductID == usb.getProductId()) {//找到指定设备
            mUsbDevice = deviceIterator.next();
            // }
        }
        //获取设备接口
        for (int i = 0; i < mUsbDevice.getInterfaceCount(); ) {
            // 一般来说一个设备都是一个接口,你可以通过getInterfaceCount()查看接口的个数
            // 这个接口上有两个端点,分别对应OUT 和 IN
            UsbInterface usbInterface = mUsbDevice.getInterface(i);
            mInterface = usbInterface;
            break;
        }

        //用UsbDeviceConnection 与 UsbInterface 进行端点设置和通讯
        if (mInterface.getEndpoint(1) != null) {
            usbEpOut = mInterface.getEndpoint(1);
        }
        if (mInterface.getEndpoint(0) != null) {
            usbEpIn = mInterface.getEndpoint(0);
        }

        if (mInterface != null) {
            // 判断是否有权限
            if (manager.hasPermission(mUsbDevice)) {
                // 打开设备,获取 UsbDeviceConnection 对象,连接设备,用于后面的通讯
                mDeviceConnection = manager.openDevice(mUsbDevice);
                if (mDeviceConnection == null) {
                    return;
                }
                if (mDeviceConnection.claimInterface(mInterface, true)) {
                    showTmsg("找到设备接口");
                } else {
                    mDeviceConnection.close();
                }
            } else {
                showTmsg("没有权限");
            }
        } else {
            showTmsg("没有找到设备接口!");
        }
    }

    private void initViews() {
        this.read_btn = (Button) findViewById(R.id.read_btn);
        this.write_btn = (Button) findViewById(R.id.write_btn);
        this.read_btn.setOnClickListener(this);
        this.write_btn.setOnClickListener(this);
    }

    @Override
    public void onClick(View view) {
        switch (view.getId()) {
            case R.id.write_btn:
                sendToUsb("按照规则给设备发指令!");
                break;
            case R.id.read_btn:
                readFromUsb();
                break;
        }
    }

    private void sendToUsb(String content) {
        sendbytes = content.getBytes();
        int ret = -1;
        // 发送准备命令
        ret = mDeviceConnection.bulkTransfer(usbEpOut, sendbytes, sendbytes.length, 5000);
        showTmsg("指令已经发送!");
        // 接收发送成功信息(相当于读取设备数据)
        receiveytes = new byte[128];   //根据设备实际情况写数据大小
        ret = mDeviceConnection.bulkTransfer(usbEpIn, receiveytes, receiveytes.length, 10000);
        // result_tv.setText(String.valueOf(ret));
        Toast.makeText(this, String.valueOf(ret), Toast.LENGTH_SHORT).show();
    }

    private void readFromUsb() {
        //读取数据2
        int outMax = usbEpOut.getMaxPacketSize();
        int inMax = usbEpIn.getMaxPacketSize();
        ByteBuffer byteBuffer = ByteBuffer.allocate(inMax);
        UsbRequest usbRequest = new UsbRequest();
        usbRequest.initialize(mDeviceConnection, usbEpIn);
        usbRequest.queue(byteBuffer, inMax);
        if (mDeviceConnection.requestWait() == usbRequest) {
            byte[] retData = byteBuffer.array();
            try {
                showTmsg("收到数据:" + new String(retData, "UTF-8"));
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
        }
    }

    //文字提示方法
    private void showTmsg(String msg) {
        Toast.makeText(UsbTestActivity.this, msg, Toast.LENGTH_SHORT).show();
    }
}

另外要与USB通信,在开发项目的配置上还需要注意: 1,添加相应权限:

 <uses-permission android:name="android.permission.HARDWARE_TEST" />

2,AndroidManifest.xml中添加uses-feature过滤所有你设备不支持的应用:

 <uses-feature android:name="android.hardware.usb.host" android:required="true"/>

3, SDK必须是12以上的,因为从 Android3.1开始,才正式支持USB Host相应开发。 4,在AndroidManifext.xml中对操作USB对应的Activity配置做修改,添加USB_DEVICE_ATTACHED与:

<activity android:name=".UsbTestActivity">
    <intent-filter>
        <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    </intent-filter>
    <!-- 以下这个meta-data是要手工增加上,他是用来过滤你的具体USB设备的,其中的device_filter是个xml文件 -->
    <meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />
</activity>

—–@xml/device_filter—–

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 以下内容的 vendor-id、product-id就是USB的vid和pid了,填写自己设备对应的数据 -->
    <usb-device vendor-id="1155" product-id="22352"/>
</resources>

参考博客:http://www.xuebuyuan.com/702736.html