flutter_serial_communication

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Flutter que habilita a comunicação serial em dispositivos Android via USB OTG, permitindo interação com Arduino e outros dispositivos USB serial sem necessidade de acesso root. Ele utiliza a API de Host USB do Android para estabelecer conexões confiáveis para troca de dados. A biblioteca é projetada para desenvolvedores que criam aplicativos que se comunicam com hardware externo por meio de protocolos seriais, como sensores ou microcontroladores. Simplifica a configuração e o manuseio de portas seriais em aplicações Flutter no Android.

Casos de uso

Conectando-se ao Arduino por meio de USB OTG
Lendo dados do sensor de hardware externo
Controlando dispositivos IoT por meio de protocolo serial
Desenvolvendo aplicativos de automação industrial ou de laboratório
Construindo interfaces móveis para sistemas embarcados

Principais recursos

Suporte a USB OTG no Android
Nenhuma acesso root é necessário
API simples para gerenciamento de porta serial
Streaming de dados em tempo real
Compatível com várias plataformas (apenas Android)
Tratamento de erros embutido

Indicado para

desenvolvedores de aplicativos IoT
Projetos de interface de hardware
Robótica educacional
Aplicativos de controle de sistema embarcado
Necessidades de comunicação serial exclusivas para Android

Considerações

Limitado à plataforma Android
Requer hardware OTG USB
Pode ser necessário o tratamento de permissões
Compatibilidade USB específica do dispositivo
Não adequado para iOS ou desktop

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

About Flutter Serial Communication

This library aims to ease Flutter Developers to do serial communcation with their peripherals without too much hassle.

Currently supports Android USB (OTG) to communicate with Arduinos and other USB serial hardware on Android WITHOUT using root access.

Installing

1. Install it to your flutter project

flutter pub add flutter_serial_communication

or by adding dependencies to your package's pubspec.yaml then run dart pub get

dependencies:
  flutter_serial_communication: 0.2.8

2. Import it in your .dart file

import 'package:flutter_serial_communication/flutter_serial_communication.dart';

Features

Doesn't require root in Android
Easy to use
Using listener for reading message & device connection status

Functions

Get All Available Devices:

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

List<DeviceInfo> availableDevices = await _flutterSerialCommunicationPlugin.getAvailableDevices();

Connect:

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

DeviceInfo device = DeviceInfo(); // DeviceInfo from getAvailableDevices()
int baudRate = 0; // Your device's baud rate
bool isConnectionSuccess = await _flutterSerialCommunicationPlugin.connect(device, baudRate);

Disconnect:

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

await _flutterSerialCommunicationPlugin.disconnect();

Write:

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

bool isMessageSent = await _flutterSerialCommunicationPlugin.write(Uint8List.fromList([0xBB, 0x00, 0x22, 0x00, 0x00, 0x22, 0x7E]));
debugPrint("Is Message Sent:  $isMessageSent");

Read (Listener):

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

EventChannel eventChannel = _flutterSerialCommunicationPlugin.getSerialMessageListener();
eventChannel.receiveBroadcastStream().listen((event) {
  debugPrint("Received From Native:  $event");
});

Device Connection Status (Listener):

final _flutterSerialCommunicationPlugin = FlutterSerialCommunication();

EventChannel eventChannel = _flutterSerialCommunicationPlugin.getDeviceConnectionListener();
eventChannel.receiveBroadcastStream().listen((event) {
  debugPrint("Received From Native:  $event");
});

Implementation

Android: Bridging from native Android library usb-serial-for-android

Buscar pacotes, repositórios e categorias de apps

Instalar pacote