capacitor-usb-serial v1.0.2

capacitor-usb-serial

This plugin provides a simple interface for USB serial communication in Capacitor applications. It allows you to connect to USB devices, send and receive data, and manage multiple device connections.

The plugin only supports Android devices and it uses usb-serial-for-android under the hood.

If you want to contribute the apple part feel free to open an issue / PR on the github repo.

Install

npm install capacitor-usb-serial
npx cap sync

API

• getDeviceHandlers()
• getDeviceConnections()
• openConnection(...)
• getActivePorts()
• endConnection(...)
• endConnections(...)
• write(...)
• read(...)
• Interfaces
• Type Aliases

Defines the interface for USB serial communication plugin

getDeviceHandlers()

getDeviceHandlers() => Promise<DeviceHandler[]>

Returns an array of DeviceHandler objects for all connected USB devices. This helper function provides a simplified interface for interacting with the plugin methods. It is recommended for most use cases unless more granular control is required. Each DeviceHandler object includes methods for connecting, disconnecting, writing to, and reading from a specific device.

Returns: Promise<DeviceHandler[]>

getDeviceConnections()

getDeviceConnections() => Promise<{ devices: DeviceInfo[]; }>

Returns all connected devices

Returns: Promise<{ devices: DeviceInfo[]; }>

openConnection(...)

openConnection(options: FullConnectionParams) => Promise<{ portKey: string; }>

Connect to a device using its deviceId

Returns: Promise<{ portKey: string; }>

getActivePorts()

getActivePorts() => Promise<{ ports: string[]; }>

Returns all active ports

Returns: Promise<{ ports: string[]; }>

endConnection(...)

endConnection(options: { key: string; }) => Promise<void>

Disconnect from a device using its assigned portKey

endConnections(...)

endConnections(options?: { keys?: string[] | undefined; } | undefined) => Promise<void>

Disconnect from all devices or specified devices

write(...)

write(options: { key: string; message: string; }) => Promise<void>

Write a message to a device using its assigned portKey

read(...)

read(options: { key: string; }) => Promise<ReadResponse>

Read a message from a device using its assigned portKey

Returns: Promise<ReadResponse>

Interfaces

DeviceHandler

Provides a simplified interface for handling a specific device

DeviceInfo

Represents information about a connected device

FullConnectionParams

Extends ConnectionParams to include deviceId

Type Aliases

ReadResponse

Represents the response from a read operation

{ data: string, bytesRead: number }