MQTT stands for Message Queue Telemetry Transport. It's a protocol designed for low-bandwidth, high latency networks. You can learn more about it here.

The Bluefruit LE Connect App allows you to send and receive data using the MQTT protocol. This may be useful for making sensor readings from a Bluefruit device viewable on the web.

Configuration

You will need an adafruit.io account in order to log and collect your data. You can make one here.

Once you have your Adafruit IO account set up, connect to your device using the Bluefruit LE Connect app. Tap the UART mode.

In the UART module, tap the MQTT button at the top of the screen.

Change the Address to io.adafruit.com. Set the Port to 1883.

Before filling in the necessary information, you will need to create 3 feeds on your adafruit.io account: rx, tx, and output.

Create a feed named tx to store data entered in the App's UART terminal.

Create a feed named rx to store data sent by the board.

Create a feed named output to display new data on the Bluefruit LE app.

Under PUBLISH,

  • Set Uart RX to your_username/f/rx
  • Set Uart TX to your_username/f/tx

Under SUBSCRIBE,

  • Set Topic to your_username/f/output

You are also going to need your Adafruit IO username and secret API key.

Navigate to your profile and click the View AIO Key button to retrieve them. Write them down in a safe place, you'll need them for the next step.

Under ADVANCED, enter your Adafruit IO username and key.

Do NOT enter your Adafruit IO password! Use your Adafruit IO KEY

Usage

Here are some examples of feeds created using the Bluefruit LE Connect app in the same manor as described above.

Received Data

This is an example of an RX feed that presents data sent from an Adafruit Feather Bluefruit and is received by iPhone using the Bluefruit LE Connect app via MQTT. The data is sent using an ASCII Numeric format similar to how plotter data is sent. You can see the plotter feature here.

Written Data

This is an example of a TX feed that presents data sent from the Bluefruit LE Connect app to adafruit.io via MQTT.

Output Data

This is an example of an output feed that presents data created on adafruit.io sent to the Bluefruit LE Connect app via MQTT

This guide was first published on Feb 20, 2015. It was last updated on Feb 20, 2015.
This page (MQTT) was last updated on Aug 02, 2020.