flutter_amazon_freertos_plugin

Flutter plugin wrapper for amazon freertos ios and android sdk

EXPIREMENTAL

This library is being actively developed by the QWIC team. It is meant for internal experimentation with amazon freertos devices

SDKs

• Amazon iOS FreeRTOS
• Amazon android FreeRTOS

Usuage

Obtain an instance

FlutterAmazonFreeRTOSPlugin amazonFreeRTOSPlugin = FlutterAmazonFreeRTOSPlugin.instance;

Check for bluetooth state

BluetoothState bluetoothState = await amazonFreeRTOSPlugin.bluetoothState;

// Listen to bluetooth state changes
amazonFreeRTOSPlugin.registerBluetoothStateChangeCallback((bluetoothState) {
    if(!mounted) return;

    setState(() {
        _bluetoothState = bluetoothState;
    });
});

Scan for devices

amazonFreeRTOSPlugin.startScanForDevices()

// Scan for devices
amazonFreeRTOSPlugin.startScanForDevices()

// Scan for devices with custom service UUIDs
// args: List<string> serviceUUIDS
amazonFreeRTOSPlugin.startScanForDevices(["c6f2d9e3-49e7-4125-9014-xxxxxx"])

Get discovered devices

// You can use Dart.Timer class to call this peridiocally to refresh the list
List<FreeRTOSDevice> devices = await amazonFreeRTOSPlugin.discoveredDevices;

Stop / Rescan devices

// stop scan
amazonFreeRTOSPlugin.stopScanForDevices();

// rescan will clear the device list and start rescan of the devices
amazonFreeRTOSPlugin.rescanForDevices();

// rescan will clear the device list and start rescan of the devices with custom service UUIDS
// args: List<string> serviceUUIDS
amazonFreeRTOSPlugin.rescanForDevices();

Connect / disconnect to device

List<FreeRTOSDevice> devices = await amazonFreeRTOSPlugin.discoveredDevices;

FreeRTOSDevice device = devices[0];
await device.connect();

// observe device state
final deviceStateListener = device.observeState().listen((state) {
	if (state == FreeRTOSDeviceState.CONNECTED) {
		// discover custom services
	}
})

deviceStateListener.cancel();

// Disconnect
await device.disconnect();

Get device services / characteristics

await device.discoverServices(serviceUUIDS: ["c6f2d9e3-49e7-4125-9014-xxxxxxxx"]);
List services = await device.services();
List<BluetoothCharacteristic> characteristics = services[0].characteristics;

Read characteristics

// WIP

Listen to notifications

// WIP

Write characteristics

// Write charactertistic value
// args: Uint8List data

Example app

Duplicate example/android/app/src/main/res/raw/awscredentials_template.json file, rename it into example/android/app/src/main/res/raw/awscredentials.json and fill in proper Cognito credentials:

{
  "UserAgent": "MobileHub/1.0",
  "Version": "1.0",
  "CredentialsProvider": {
    "CognitoIdentity": {
      "Default": {
        "PoolId": "Federated Identities -> Edit identity pool -> Identity pool ID. (eg. us-west-2:fc4d19b1-873f-44d8-bdcf-3a8e7aabf3ea)",
        "Region": "Your Region. (eg. us-east-1)"
      }
    }
  },
  "IdentityManager": {
    "Default": {}
  },
  "CognitoUserPool": {
    "Default": {
      "PoolId": "UserPool -> General settings -> Pool Id. (eg. us-east-1_example)",
      "AppClientId": "UserPool -> General settings -> App clients -> Show Details. (eg. 3tcegaot7efa8abgn1fxnebq5)",
      "AppClientSecret": "UserPool -> General settings -> App clients -> Show Details. (eg. dse11rx91vs1t9600uacc0ssw1byju8em3k60271n748s26ts9l)",
      "Region": "Your Region. (eg. us-east-1)"
    }
  }
}

Cognito

Cognito initialization code is in cognito.store.dart

Credits

Heavily influenced by the following plugins.

• Flutter_blue
• Flutter_cognito_plugin
• Plugin_scaffold