Skip to content

Most visited

Recently visited




public interface UartDeviceDriver
implements UartDevice

UART user driver. A UartDeviceDriver must implement all UART functions, but additionally this class provides an open() function that will be called whenever a process obtains ownership of the UART, to match the existing close() function.


Inherited constants

From interface

Public methods

abstract void close()

Closes the UART.

default String getName()

Returns null.

abstract void open()

Opens the UART.

abstract void registerUartDeviceCallback(UartDeviceCallback callback, Handler handler)

Registers an interrupt callback on the UART.

Inherited methods

From interface
From interface
From interface java.lang.AutoCloseable

Public methods


void close ()

Closes the UART. This will be called when the UART is closed by its owner. Any resources that need to be cleaned up should be done so here. This method may throw IOException to indicate I/O failure, but will still be considered closed and may attempt to be re-opened in the future.

IOException on I/O failure; the driver will still be considered closed.


String getName ()

Returns null. I/O user drivers can be registered under any name so this returns null by default. Child classes may override this if other behavior is desired.



void open ()

Opens the UART. This will be called when ownership of a UART is obtained. The driver should do any initialization needed to configure the UART for use here.

IOException on I/O failure; the driver will remain closed.


void registerUartDeviceCallback (UartDeviceCallback callback, 
                Handler handler)

Registers an interrupt callback on the UART. See registerGpioCallback(GpioCallback, Handler) for information on how callbacks work for user drivers. A typical use-case for UART user driver interrupts is an external UART chip which uses a GPIO line to indicate when data is ready to read. In this case, the driver code might look something like this:

 public class UartWithInterruptDriver implements UartDeviceDriver {
     // The data-ready signal GPIO.
     private Gpio mInterruptGpio;

     // Our GPIO interrupt handler.
     private InterruptCallback mInterruptCallback;

     // Implement other UartDeviceDriver functionality.
     // ...

     public void registerUartDeviceCallback(UartDeviceCallback callback, Handler handler)
             throws IOException {
         // Configure mInterruptGpio to begin listening for interrupts.
         mInterruptCallback = new InterruptCallback(callback);
         mInterruptGpio.registerGpioCallback(mInterruptCallback, handler);

     public void unregisterUartDeviceCallback(UartDeviceCallback callback) {
         mInterruptCallback = null;

     // Bounces the underlying GPIO callbacks into the registered UART callback.
     private class InterruptCallback implements GpioCallback {
         private final UartDeviceCallback mUartCallback;

         public InterruptCallback(UartDeviceCallback uartCallback) {
             mUartCallback = uartCallback;

         public boolean onGpioEdge(Gpio gpio) {
             return mUartCallback.onUartDeviceDataAvailable(null);

         public void onGpioError(Gpio gpio, int error) {
             // The underlying interrupt GPIO failed, we won't get any more callbacks.
             mUartCallback.onUartDeviceError(null, error);

callback UartDeviceCallback: UartDeviceCallback to register; only one will ever be registered at a time.
handler Handler: Handler to optionally run callbacks on. Provided as a convenience if needed, but it's not required to execute callbacks on this.
IOException if this UART doesn't support interrupts.
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)