Package detailsv0.4.0

flutter_bluetooth_serial

A basic Flutter Bluetooth Serial library

Android

pub.dev API documentation Source code

30-day downloads: 9.6K
Likes: 377
Pub points: 130

Install package

flutter pub add flutter_bluetooth_serial

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A lightweight Flutter package for connecting and communicating with Bluetooth serial devices on Android. It enables bidirectional data transfer between a Flutter app and compatible hardware such as sensors, microcontrollers, or custom IoT devices using standard Bluetooth Serial protocols. The library abstracts low-level Bluetooth operations, providing an easy-to-use API for scanning, pairing, and sending/receiving data. Designed specifically for Android, it supports basic Bluetooth functionality without requiring complex configurations.

Use cases

Connecting to Arduino-based devices
Transmitting sensor data from Bluetooth modules
Controlling IoT devices via Bluetooth
Integrating with custom hardware peripherals
Enabling real-time data exchange in mobile apps

Key features

Simple API for Bluetooth communication
Supports Android only
Bidirectional data transfer
Device discovery and pairing
Lightweight and minimal dependencies

Suitable for

IoT application developers
Hardware integration projects
Educational robotics
Embedded system prototyping
Android-only Bluetooth applications

Considerations

Limited to Android platform
No support for iOS
Requires Bluetooth permissions in manifest
Depends on device compatibility with serial protocol
Basic feature set without advanced Bluetooth profiles

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

`flutter_bluetooth_serial`

Flutter basic implementation for Classical Bluetooth (only RFCOMM for now).

Features

The first goal of this project, started by @edufolly was making an interface for Serial Port Protocol (HC-05 Adapter). Now the plugin features:

Adapter status monitoring,
Turning adapter on and off,
Opening settings,
Discovering devices (and requesting discoverability),
Listing bonded devices and pairing new ones,
Connecting to multiple devices at the same time,
Sending and receiving data (multiple connections).

The plugin (for now) uses Serial Port profile for moving data over RFCOMM, so make sure there is running Service Discovery Protocol that points to SP/RFCOMM channel of the device. There could be max up to 7 Bluetooth connections.

For now there is only Android support.

Funding

Your contribution will help drive the development of quality tools for the Flutter and Dart developer community. Any amount will be appreciated. Thank you for your continued support!

PIX

Sua contribuição ajudará a impulsionar o desenvolvimento de ferramentas de qualidade para a comunidade de desenvolvedores Flutter e Dart. Qualquer quantia será apreciada. Obrigado pelo seu apoio contínuo!

Getting Started

Depending

# Add dependency to `pubspec.yaml` of your project.
dependencies:
  # ...
  flutter_bluetooth_serial: ^0.4.0

Installing

flutter pub get

Importing

import 'package:flutter_bluetooth_serial/flutter_bluetooth_serial.dart';

Usage

You should look to the Dart code of the library (mostly documented functions) or to the examples code.

// Some simplest connection :F
try {
    BluetoothConnection connection = await BluetoothConnection.toAddress(address);
    print('Connected to the device');

    connection.input.listen((Uint8List data) {
        print('Data incoming: ${ascii.decode(data)}');
        connection.output.add(data); // Sending data

        if (ascii.decode(data).contains('!')) {
            connection.finish(); // Closing connection
            print('Disconnecting by local host');
        }
    }).onDone(() {
        print('Disconnected by remote request');
    });
}
catch (exception) {
    print('Cannot connect, exception occured');
}