Bluetooth Connection Plugin #

A comprehensive Flutter plugin for connecting to Bluetooth devices, specifically designed for bluetooth machines and similar IoT devices. This plugin provides robust connectivity, data reading capabilities, and real-time data monitoring.

Features #

✅ Device Discovery: Scan and list paired Bluetooth devices
✅ Connection Management: Connect to and disconnect from Bluetooth devices
✅ Data Reading: Read data from connected devices with multiple attempt retries
✅ Real-time Listening: Continuous data monitoring with background listening
✅ Multiple UUID Support: Compatible with various Bluetooth protocols (SPP, etc.)
✅ Permission Handling: Automatic Bluetooth permission management for Android 12+
✅ Error Handling: Comprehensive error handling with descriptive error messages

Supported Platforms #

• ✅ Android (API 21+)
• ✅ iOS (iOS 11.0+)

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  bluetooth_connection_plugin: ^1.0.0

Then run:

flutter pub get

Android Setup #

Permissions #

The plugin automatically handles all required permissions. The following permissions are included in the plugin's Android manifest:

For Android 12+ (API 31+):

• BLUETOOTH_SCAN
• BLUETOOTH_CONNECT
• BLUETOOTH_ADVERTISE

For Older Android versions:

• BLUETOOTH
• BLUETOOTH_ADMIN
• ACCESS_FINE_LOCATION
• ACCESS_COARSE_LOCATION

Minimum SDK Version #

Ensure your app's android/app/build.gradle has:

android {
    compileSdkVersion 34
    
    defaultConfig {
        minSdkVersion 21  // Required minimum
        targetSdkVersion 34
    }
}

iOS Setup #

Permissions #

Add the following permissions to your app's ios/Runner/Info.plist:

<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app needs Bluetooth access to connect to Bluetooth devices and read data from devices.</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>This app needs Bluetooth access to connect to Bluetooth devices and read data from devices.</string>

Minimum iOS Version #

Ensure your app's ios/Podfile has:

platform :ios, '11.0'

iOS Bluetooth Behavior #

• Device Discovery: iOS uses Bluetooth Low Energy (BLE) scanning instead of accessing system-paired devices
• Connection Process: Devices must be discovered first before connecting
• Background Support: Limited background Bluetooth capabilities due to iOS restrictions
• Permissions: iOS automatically manages Bluetooth permissions when your app accesses Bluetooth features

Usage #

1. Initialize the Plugin #

import 'package:bluetooth_connection_plugin/bluetooth_connection_plugin.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    BluetoothConnectionPlugin.initialize();
  }
}

2. Get Paired Devices #

Future<void> getPairedDevices() async {
  try {
    List<Map<String, dynamic>> devices = await BluetoothConnectionPlugin.getPairedDevices();
    
    for (var device in devices) {
      print('Device: ${device['name']} - ${device['address']}');
    }
  } on BluetoothException catch (e) {
    print('Error: ${e.message}');
  }
}

3. Connect to a Device #

Future<void> connectToDevice(String deviceAddress) async {
  try {
    Map<String, dynamic> result = await BluetoothConnectionPlugin.connectToDevice(deviceAddress);
    print('Connected to: ${result['deviceName']}');
  } on BluetoothException catch (e) {
    print('Connection failed: ${e.message}');
  }
}

4. Read Data #

Future<void> getData() async {
  try {
    BluetoothData data = await BluetoothConnectionPlugin.readData();
    
    if (data.data.isNotEmpty) {
    // Automatically extracted weight value
     
      print('Raw data: ${data.rawData}');
      print('Timestamp: ${data.dateTime}');
    }
  } on BluetoothException catch (e) {
    print('Read failed: ${e.message}');
  }
}

5. Real-time Data Listening #

Future<void> startListening() async {
  try {
    await BluetoothConnectionPlugin.startListening();
    print('Started listening for data');
    
    // Data will be received via method channel callbacks
    // Implement _handleMethodCall to receive data
  } on BluetoothException catch (e) {
    print('Start listening failed: ${e.message}');
  }
}

Future<void> stopListening() async {
  try {
    await BluetoothConnectionPlugin.stopListening();
    print('Stopped listening');
  } on BluetoothException catch (e) {
    print('Stop listening failed: ${e.message}');
  }
}

6. Disconnect Device #

Future<void> disconnect() async {
  try {
    await BluetoothConnectionPlugin.disconnectDevice();
    print('Disconnected from device');
  } on BluetoothException catch (e) {
    print('Disconnect failed: ${e.message}');
  }
}

7. Check Connection Status #

Future<void> checkConnection() async {
  try {
    bool isConnected = await BluetoothConnectionPlugin.isConnected();
    print('Connection status: $isConnected');
  } on BluetoothException catch (e) {
    print('Status check failed: ${e.message}');
  }
}

Data Models #

BluetoothData #

Represents data received from a Bluetooth device:

class BluetoothData {
  final String data;          // Processed data
  final String rawData;       // Raw data from device
  final int bytesRead;        // Number of bytes read
  final int timestamp;        // Timestamp in milliseconds
  
}

BluetoothDeviceInfo #

Represents a Bluetooth device:

class BluetoothDeviceInfo {
  final String name;          // Device name
  final String address;       // Device MAC address
  final String type;          // Device type (Classic, LE, Dual Mode)
}

BluetoothException #

Custom exception for Bluetooth operations:

class BluetoothException implements Exception {
  final String code;          // Error code
  final String message;       // Error message
}

The extraction algorithm:

• Removes non-numeric characters except decimals, minus, and plus signs
• Handles multiple values by selecting the first valid number
• Works with various data formats from different weighing machine brands

Complete Example #

Troubleshooting #

Common Issues #

1. Permission Denied: Ensure Bluetooth permissions are granted in Android settings
2. Connection Failed: Check if the device is paired and within range
3. No Data: Some devices require specific commands to start data transmission
4. Compatibility: Test with your specific machine model

Debug Tips #

1. Enable detailed logging in your app
2. Check raw data format from your device
3. Test connection with Bluetooth terminal apps first
4. Verify device pairing in Android Bluetooth settings

Supported Device Types #

• Digital weighing scales
• Medical weighing machines
• Industrial scales
• Bluetooth serial devices
• Any device using SPP (Serial Port Profile)

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Support #

For issues and feature requests, please use the GitHub Issues page.

Changelog #

See CHANGELOG.md for a detailed list of changes.