Amazon FreeRTOS
User Guide

Mobile SDKs for Amazon FreeRTOS Bluetooth Devices

You can use the Mobile SDKs for Amazon FreeRTOS Bluetooth Devices to create mobile applications that interact with your microcontroller over Bluetooth Low Energy. The Mobile SDKs can also communicate with AWS services, using Amazon Cognito for user authentication.

Android SDK for Amazon FreeRTOS Bluetooth Devices

Use the Android SDK for Amazon FreeRTOS Bluetooth Devices to build Android mobile applications that interact with your microcontroller over Bluetooth Low Energy. The SDK is available on GitHub.

To install the Android SDK

  1. Download the SDK from GitHub.

  2. Open Android Studio, and import the amazon-freertos-ble-android-sdk/amazonfreertossdk/ directory into your app project.

  3. In your app's gradle file, add the following dependencies:

    dependencies { implementation project(":amazonfreertossdk") }
  4. In your app's AndroidManifest.xml file, add the following permissions:

    <uses-permission android:name="android.permission.BLUETOOTH"/> <!-- initiate device discovery and manipulate bluetooth settings --> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <!-- allow scan Bluetooth Low Energy --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- AWS Mobile SDK --> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

For information about setting up and running the demo mobile application that is included with the SDK, see Prerequisites and Amazon FreeRTOS Bluetooth Low Energy Mobile SDK Demo Application.

iOS SDK for Amazon FreeRTOS Bluetooth Devices

Use the iOS SDK for Amazon FreeRTOS Bluetooth Devices to build iOS mobile applications that interact with your microcontroller over Bluetooth Low Energy. The SDK is available on GitHub.

To install the iOS SDK

  1. Install CocoaPods:

    $ gem install cocoapods $ pod setup

    Note

    You might need to use sudo to install CocoaPods.

  2. Install the SDK with CocoaPods:

    $ pod 'AmazonFreeRTOS', :git => 'https://github.com/aws/amazon-freertos-ble-ios-sdk.git'

For information about setting up and running the demo mobile application that is included with the SDK, see Prerequisites and Amazon FreeRTOS Bluetooth Low Energy Mobile SDK Demo Application.