Skip to content

Releases: mik3y/usb-serial-for-android

v2.0.0

12 Oct 09:55
@kai-morich kai-morich
v2.0.0
9755a4c
Compare
Choose a tag to compare
v2.0.0

merged back changes collected in kai-morich's fork

new features:

  • support ft_232h, cp210_ multiport devices
  • CH34x: data bits, parity, stop bits
  • CP21xx: mark+space
  • support USB devices with other non CDC related endpoints
  • CH34x: support more baudrates

changes:

  • increased minimum Android version to 4.3 (API 17)

  • Always use async read (UsbDeviceConnection.requestWait), as bulkTransfer (UsbDeviceConnection. bulkTransfer) can cause data loss at high baud rates. Before this release only the CdcAcm driver used async read.

    With async read currently read timeout != 0 is ignored. read blocks until data is available (except Ftdi, where status data is available each 16msec).

    Instead of using read you can use the asynchronuos SerialInputOutputManager to be notified on available data. SerialInputOutputManager.writeAsync is also affected, as the loop blocks in a read. Instead you can write directly in your UI thread.

Assets 2
Loading

v0.1.0 (November 13, 2012)

04 Mar 07:48
@mik3y mik3y
v0.1.0
3812fbc
Compare
Choose a tag to compare
v0.1.0 (November 13, 2012) Pre-release
Pre-release

Version: 0.1.0
Release date: November 13, 2012
Notes: First public release of usb-serial-for-android.

Quick Start

1. Download usb-serial-for-android-v010.jar

2. Copy the jar to your Android project's libs/ directory. (See Android's FAQ for help).

3. Copy device_filter.xml to your project's res/xml/ directory.

4. Configure your AndroidManifest.xml to notify your app when a device is attached (see Android USB Host documentation for help).

<activity
    android:name="..."
    ...>
  <intent-filter>
    <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
  </intent-filter>
  <meta-data
      android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" 
      android:resource="@xml/device_filter" />
</activity>

5. Use it! Example code snippet:

// Get UsbManager from Android.
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

// Find the first available driver.
UsbSerialDriver driver = UsbSerialProber.acquire(manager);

if (driver != null) {
  driver.open();
  try {
    driver.setBaudRate(115200);

    byte buffer[] = new byte[16];
    int numBytesRead = driver.read(buffer, 1000);
    Log.d(TAG, "Read " + numBytesRead + " bytes.");
  } catch (IOException e) {
    // Deal with error.
  } finally {
    driver.close();
  } 
}

For a more complete example, see the UsbSerialExamples/ project, which is a simple application for reading and showing serial data.

A simple Arduino application is also available (in arduino/), which can be used for testing.

Author, License, and Copyright

usb-serial-for-android is written and maintained by mike wakerly.

This library is licensed under LGPL Version 2.1. Please see LICENSE.txt for the complete license.

Copyright 2011-2012, Google Inc. All Rights Reserved.

Portions of this library are based on libftdi (http://www.intra2net.com/en/developer/libftdi). Please see FtdiSerialDriver.java for more information.

Help & Discussion

For common problems, see the Troubleshooting wiki page.

For other help and discussion, please join our Google Group, usb-serial-for-android.

Assets 3
Loading