Skip to content

USB UART driver based on libusb. Implemented as a relay of bulk endpoint data to Linux pipes. Supports Android.

License

Notifications You must be signed in to change notification settings

hutorny/usbuart

Repository files navigation

USBUART

A cross-platform library for reading/wring data via USB-UART adapters

Introduction

USBUART is a LIBUSB based library that implements a relay from USB-UART converter’s endpoints to a pair of I/O resources, either appointed by given file descriptors, or created inside the library with pipe(2).

User application may then use standard I/O operations for reading and writing data. USBUART Library provides API for three languages - C++, C and Java.

See C/C++ API description in usbuart.h and Android API in

Usage with C++

// Instantiate a context
context ctx;

// Attach USB via a pipe channel
channel chnl;
ctx.pipe(device_id{0x067b,0x0609},chnl,_115200_8N1n);

//Run loop in one thread
while(ctx.loop(10) >= -error_t::no_channel);

//Read/write data in other thread(s)
char buff[256];
read(chnl.fd_read, buff, sizeof(buff));

//or use non-blocking I/O in the loop body

Usage on Android

// Instantiate a context
ctx = new UsbUartContext();

// Start a thread running event loop 
new Thread(ctx).start();

// Obtain permission to the USB device
UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE);
usbManager.requestPermission(device, PendingIntent.getBroadcast(...));

// Open device
UsbDeviceConnection connection = usbManager.openDevice(device);

// Create pipe channel
Channel channel = ctx.pipe(connection, 0, EIA_TIA_232_Info._115200_8N1n());

// Open streams
InputStream input = channel.getInputStream();	
OutputStream output = channel.getOutputStream();	

// Perfrom I/O operations with the streams

Building

  1. Get USBUART library sources

     git clone https://github.com/hutorny/usbuart.git
    
  2. Get libusb sources

     cd usbuart
     git clone https://github.com/libusb/libusb.git
    
  3. Change directory to libusb

     cd libusb
    
  4. Configure and build libusb

     ./autogen.sh --disable-udev
     make
    
  5. Change directory to usbuart

     cd ..
    
  6. Make USBUART

     make
    

Building for Android

  1. Get USBUART library sources

     git clone https://github.com/hutorny/usbuart.git
    
  2. Get Android-tuned libusb fork

     cd usbuart
     git clone https://github.com/hutorny/libusb.git
    
  3. Download the latest NDK from: http://developer.android.com/tools/sdk/ndk/index.html

  4. Extract the NDK.

  5. Open a shell and make sure there exist an NDK global variable set to the directory where you extracted the NDK.

  6. Change directory to usbuart/libusb

  7. Configure libusb

     ./android/autogen.sh --enable-system_log
    
  8. Change directory to usbuart

     cd ..
    
  9. Build libary and modules

     ant debug
    

About

USB UART driver based on libusb. Implemented as a relay of bulk endpoint data to Linux pipes. Supports Android.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published