bionic-bt-serial v0.0.3

bionic-bt-serial

Send data between bluetooth devices using a serial like interface

Install

npm install bionic-bt-serial
npx cap sync

API

• addListener(PluginEvents, ...)
• addListener('discoveryState', ...)
• addListener('discovered', ...)
• addListener('rawData', ...)
• addListener('connected', ...)
• addListener('connectionFailed', ...)
• addListener('connectionLost', ...)
• getBondedDevices()
• startListening(...)
• stopListening()
• isListening()
• connect(...)
• isConnected(...)
• getConnectedDevices()
• disconnect(...)
• disconnectAll()
• write(...)
• isEnabled()
• enableAdapter()
• disableAdapter()
• showBluetoothSettings()
• startDiscovery(...)
• cancelDiscovery()
• setName(...)
• getName()
• setDiscoverable(...)
• Interfaces
• Type Aliases
• Enums

addListener(PluginEvents, ...)

addListener(eventName: PluginEvents, callback: EventCallback) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('discoveryState', ...)

addListener(eventName: 'discoveryState', callback: (result: { starting?: boolean; completed?: boolean; }) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('discovered', ...)

addListener(eventName: 'discovered', callback: (result: BTDevice) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('rawData', ...)

addListener(eventName: 'rawData', callback: (result: RawDataResult) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('connected', ...)

addListener(eventName: 'connected', callback: (result: BTDevice) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('connectionFailed', ...)

addListener(eventName: 'connectionFailed', callback: (result: BTDevice) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('connectionLost', ...)

addListener(eventName: 'connectionLost', callback: (result: BTDevice) => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

getBondedDevices()

getBondedDevices() => Promise<{ result: BTDevice[]; }>

Gets a list of the bonded (paired) devices.

Returns: Promise<{ result: BTDevice[]; }>

startListening(...)

startListening(_options: {}, callback: ListenCallback) => Promise<void>

Start listening for incoming connections

stopListening()

stopListening() => Promise<void>

Stops listening for incoming connections.

isListening()

isListening() => Promise<{ result: boolean; }>

True if listening for an accepting incoming connections. A device acting as a server should be listening.

Returns: Promise<{ result: boolean; }>

connect(...)

connect(options: { macAddress: string; }) => Promise<void>

Connect to another device acting as a server that is in listening mode. Should already be paired?

isConnected(...)

isConnected(options: { macAddress: string; }) => Promise<{ result: boolean; }>

True if there is an active connection to the provided macAddress false otherwise.

Returns: Promise<{ result: boolean; }>

getConnectedDevices()

getConnectedDevices() => Promise<{ result: BTDevice[]; }>

Gets a list of the connected devices.

Returns: Promise<{ result: BTDevice[]; }>

disconnect(...)

disconnect(options: { macAddress: string; }) => Promise<{ result: boolean; }>

Disconnects specified connection.

Returns: Promise<{ result: boolean; }>

disconnectAll()

disconnectAll() => Promise<void>

Disconnects all connections (incomming and outgoing).

write(...)

write(options: { macAddress: string; data: number[]; }) => Promise<{ result: boolean; }>

Write data to specified macAddress

Returns: Promise<{ result: boolean; }>

isEnabled()

isEnabled() => Promise<{ result: boolean; }>

True if device has bluetooth enabled, false otherwise

Returns: Promise<{ result: boolean; }>

enableAdapter()

enableAdapter() => Promise<void>

Prompt the user to enable bluetooth. Resolved if bluetooth is enabled, rejects otherwise.

disableAdapter()

disableAdapter() => Promise<void>

Prompt the user to enable bluetooth. Resolved if bluetooth is enabled, rejects otherwise.

showBluetoothSettings()

showBluetoothSettings() => Promise<void>

Open the bluetooth settings screen for the user.

startDiscovery(...)

startDiscovery(_options: {}, callback: DiscoveryCallback) => Promise<void>

Starts discovery process, sends info about found devices to the callback. Scans for about 12 seconds.

cancelDiscovery()

cancelDiscovery() => Promise<void>

Stops any running discovery process.

setName(...)

setName(options: { name: string; }) => Promise<void>

Sets the name of the bluetooth adapter. Name is what paired devices will see when they connect.

getName()

getName() => Promise<{ result: string; }>

Gets the name of the bluetooth adapter.

Returns: Promise<{ result: string; }>

setDiscoverable(...)

setDiscoverable(options: { durationSec?: number; }) => Promise<void>

Ensure bluetooth is enabled and the device is discoverable to remote scanners. Default durationSec is 120 is not provided. Max is 300 seconds.

Interfaces

PluginListenerHandle

Type Aliases

EventCallback

(info: any, err?: any): void

BTDevice

{name:string, macAddress:string, class:number}

RawDataResult

{bytes:number[], from:BTDevice}

ListenCallback

(device: BTDevice, err?: any): void

DiscoveryCallback

(device: BTDevice, err?: any): void

Enums

PluginEvents