Skip to main content

Connecting OpenBCI's Cyton Hardware and Streaming Live Sensor Data with Fathym's IoT Ensemble

Cyton Biosensing Board

In this tutorial, we will be taking OpenBCI’s Cyton Biosensing Board, reading its sensor datastreams, and sending real-time messages to Fathym's IoT Ensemble. The Cyton allows you to gather 8-channels of scientifically-validated physiological data.

Things you will need

Part 1 - Hooking Up Your Hardware

  1. You will need to plug in your USB “dongle” into your computer. Ensure that the small toggle on your USB dongle is set to “GPIO_6.”

  2. Plug in the provided lithium ion battery into the Cyton board itself.

  3. Once this is done, slide the small toggle switch to “PC.”

If you need additional docs for setting up the Cyton board, go here.

note

No need to install OpenBCI’s GUI, just follow the hardware setup portion.

Part 2 - Download the OpenBiotech IoT Stream Application

Now that we have the board set up, we need to download and install the data streaming application to your Windows PC.

  1. Download the “.msi” file from the release page here.

  2. Run the downloaded file, which should open up a wizard installer.

  3. Complete step through of the installation wizard.

Biotech Wizard Start Screen

tip

Certain firewalls/virus protection programs may attempt to block the download/install of the file. Be sure to make a firewall exception in order for the application to install/run.

Part 3 - Register with Fathym IoT Ensemble and Create a Device

To get started with OpenBiotech’s tools, simply sign up for fathym for free on the Fathym website. This will give you access to the Fathym Platform, IoT Ensemble and Habistack.

First you will land on the Fathym platform dashboard. To get started with OpenBiotech, let’s navigate to the IoT Ensemble dashboard. In the navbar, click Discover.

Dashboard Header Links

Then select and launch IoT Ensemble.

Launch IoT Ensemble Card

To get started with a device, simply enter a device name and enroll it.

Enroll New Device

We'll start off with a symmetric key protected device, and can move to other security in the future. Once created, the connection string will be available for use in the next steps.

Device List

All that's needed for the following sections is the device connection string. Copy it from the dashboard, after creating a first device, using the Icon Copy button.

Copy Connection String

note

When connecting devices, the connection is to a cloud-native Azure IoT Hub. We don't place any technology between the device and the IoT Hub, making it possible to develop solutions with the full capabilities of Azure IoT Hub. Read more on how to connect devices using the connection string.

Part 4 - Running the application and Streaming your Data

  1. Open the newly installed OpenBiotech IoT Stream - Brainflow application. This application utilizes Brainflow, a library for obtaining, parsing and analyzing EEG, EMG, ECG and other kinds of data from biosensors.

OpenBiotech Connection String Prompt

  1. When prompted, paste your IoT Ensemble connection string (copied from the previous step).

  2. The application will ask you to select which computer port the Cyton is connected to. Type the corresponding port selection and hit enter.

OpenBiotech Port Selection

If everything is correct, the application will start to read and pull data from the Cyton board, and send them to the device created within IoT Emsemble.

OpenBiotech Datastream

From there, you can use IoT Ensemble’s built in API endpoints to query and access your data.