kopia lustrzana https://github.com/felHR85/UsbSerial
191 wiersze
5.8 KiB
Markdown
191 wiersze
5.8 KiB
Markdown
UsbSerial [![](https://jitpack.io/v/felHR85/UsbSerial.svg)](https://jitpack.io/#felHR85/UsbSerial) [![AndroidArsenal](https://img.shields.io/badge/Android%20Arsenal-UsbSerial-green.svg?style=true)](https://android-arsenal.com/details/1/4162) [![Join the chat at https://gitter.im/UsbSerial/Lobby](https://badges.gitter.im/UsbSerial/Lobby.svg)](https://gitter.im/UsbSerial/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
=========
|
|
Usb serial controller for Android. For more information, there is [a more complete description](http://felhr85.net/2014/11/11/usbserial-a-serial-port-driver-library-for-android-v2-0/).
|
|
|
|
[A brief list of Apps and projects using UsbSerial](http://felhr85.net/2016/03/19/apps-and-projects-using-usbserial/)
|
|
|
|
Devices Supported
|
|
--------------------------------------
|
|
[CP210X devices](http://www.silabs.com/products/mcu/pages/usbtouartbridgevcpdrivers.aspx) Default: 9600,8,1,None,flow off
|
|
|
|
[CDC devices](https://en.wikipedia.org/wiki/USB_communications_device_class) Default 115200,8,1,None,flow off
|
|
|
|
[FTDI devices](http://www.ftdichip.com/FTProducts.htm) Default: 9600,8,1,None,flow off
|
|
|
|
[PL2303 devices](http://www.prolific.com.tw/US/ShowProduct.aspx?p_id=225&pcid=41) Default 9600,8,1,None,flow off
|
|
|
|
[CH34x devices](https://www.olimex.com/Products/Breadboarding/BB-CH340T/resources/CH340DS1.PDF) Default 9600,8,1,None,flow off
|
|
|
|
[CP2130 SPI-USB](http://www.silabs.com/products/interface/usb-bridges/classic-usb-bridges/Pages/usb-to-spi-bridge.aspx)
|
|
|
|
How to use it?
|
|
--------------------------------------
|
|
Instantiate a new object of the UsbSerialDevice class
|
|
```java
|
|
UsbDevice device;
|
|
UsbDeviceConnection usbConnection;
|
|
...
|
|
UsbSerialDevice serial = UsbSerialDevice.createUsbSerialDevice(device, usbConnection);
|
|
```
|
|
|
|
Open the device and set it up as desired
|
|
```java
|
|
serial.open();
|
|
serial.setBaudRate(115200);
|
|
serial.setDataBits(UsbSerialInterface.DATA_BITS_8);
|
|
serial.setParity(UsbSerialInterface.PARITY_ODD);
|
|
serial.setFlowControl(UsbSerialInterface.FLOW_CONTROL_OFF);
|
|
```
|
|
|
|
If flow control is needed (currently only supported in CP201x and FTDI devices)
|
|
```java
|
|
/**
|
|
Values:
|
|
UsbSerialInterface.FLOW_CONTROL_OFF
|
|
UsbSerialInterface.FLOW_CONTROL_RTS_CTS
|
|
UsbSerialInterface.FLOW_CONTROL_DSR_DTR
|
|
**/
|
|
serial.setFlowControl(UsbSerialInterface.FLOW_CONTROL_RTS_CTS);
|
|
```
|
|
|
|
There is no need to be polling if you want to perform a bulk transaction to a IN endpoint. Define a simply callback
|
|
```java
|
|
private UsbSerialInterface.UsbReadCallback mCallback = new UsbSerialInterface.UsbReadCallback() {
|
|
|
|
@Override
|
|
public void onReceivedData(byte[] arg0)
|
|
{
|
|
// Code here :)
|
|
}
|
|
|
|
};
|
|
```
|
|
|
|
And pass a reference of it
|
|
```java
|
|
serial.read(mCallback);
|
|
```
|
|
|
|
Changes in the CTS and DSR lines will be received in the same manner. Define a callback and pass a reference of it.
|
|
```java
|
|
private UsbSerialInterface.UsbCTSCallback ctsCallback = new UsbSerialInterface.UsbCTSCallback() {
|
|
@Override
|
|
public void onCTSChanged(boolean state) {
|
|
// Code here :)
|
|
}
|
|
};
|
|
|
|
private UsbSerialInterface.UsbDSRCallback dsrCallback = new UsbSerialInterface.UsbDSRCallback() {
|
|
@Override
|
|
public void onDSRChanged(boolean state) {
|
|
// Code here :)
|
|
}
|
|
};
|
|
|
|
serial.getCTS(ctsCallback);
|
|
//serial.getDSR(dsrCallback);
|
|
```
|
|
|
|
|
|
|
|
Write something
|
|
```java
|
|
serial.write("DATA".getBytes()); // Async-like operation now! :)
|
|
```
|
|
|
|
Raise the state of the RTS or DTR lines
|
|
```java
|
|
serial.setRTS(true); // Raised
|
|
serial.setRTS(false); // Not Raised
|
|
serial.setDTR(true); // Raised
|
|
serial.setDTR(false); // Not Raised
|
|
```
|
|
|
|
Close the device:
|
|
```java
|
|
serial.close();
|
|
```
|
|
|
|
I recommend using UsbSerial as shown above but if you want to perform write and read operations in synchronous way it is possible using these methods:
|
|
```java
|
|
public boolean syncOpen();
|
|
public int syncWrite(byte[] buffer, int timeout)
|
|
public int syncRead(byte[] buffer, int timeout)
|
|
public void syncClose();
|
|
```
|
|
|
|
|
|
In Android usb api, when a usb device has been close it must be reopened
|
|
```java
|
|
UsbDevice device;
|
|
...
|
|
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
|
|
manager.openDevice(UsbDevice device)
|
|
```
|
|
How to use the SPI interface (BETA)
|
|
--------------------------------------
|
|
Support for USB to SPI devices was added recently but it is still in beta. Although I tried to keep the api as close to standard UsbSerial api as possible, be aware because the beta nature of this feature this api may change in the future. Only CP2130 chipset is supported at the moment.
|
|
|
|
```java
|
|
UsbSpiDevice spi = UsbSpiDevice.createUsbSerialDevice(device, connection);
|
|
spi.connectSPI();
|
|
spi.selectSlave(0);
|
|
spi.setClock(CP2130SpiDevice.CLOCK_3MHz);
|
|
```
|
|
Define the usual callback
|
|
|
|
```java
|
|
private UsbSpiInterface.UsbMISOCallback misoCallback = new UsbSpiInterface.UsbMISOCallback()
|
|
{
|
|
@Override
|
|
public int onReceivedData(byte[] data) {
|
|
// Your code here :)
|
|
}
|
|
};
|
|
//...
|
|
spi.setMISOCallback(misoCallback);
|
|
```
|
|
|
|
```java
|
|
spi.writeMOSI("Hola!".getBytes()); // Write "Hola!" to the selected slave through MOSI (MASTER OUTPUT SLAVE INPUT)
|
|
spi.readMISO(5); // Read 5 bytes from the MISO (MASTER INPUT SLAVE OUTPUT) line. Data will be received through UsbMISOCallback
|
|
spi.writeRead("Hola!".getBytes(), 15); // Write "Hola!" and read 15 bytes synchronously
|
|
```
|
|
|
|
Close the device when done
|
|
|
|
```java
|
|
spi.closeSPI();
|
|
```
|
|
|
|
Gradle
|
|
--------------------------------------
|
|
Add the jitpack repo to your your project's build.gradle at the end of repositories
|
|
|
|
/build.gradle
|
|
```groovy
|
|
allprojects {
|
|
repositories {
|
|
jcenter()
|
|
maven { url "https://jitpack.io" }
|
|
}
|
|
}
|
|
```
|
|
|
|
Then add the dependency to your module's build.gradle:
|
|
|
|
/app/build.gradle
|
|
```groovy
|
|
compile 'com.github.felHR85:UsbSerial:4.5'
|
|
```
|
|
|
|
TO-DO
|
|
--------------------------------------
|
|
- RTS/CTS and DSR/DTR implementations for PL2303 and CDC
|
|
|
|
|
|
|
|
|
|
|
|
|