Skip to main content

The ScientISST SENSE Python API

Project description


The ScientISST SENSE Python API.

Learn how to use it, check examples, and much more here!


  • PySerial

Install it using pip:

pip install pyserial


# Getting this repository 
git clone



  1. Pair your device
  2. Run:
  1. Select the device from the list displayed:
ScientISST devices:
[1] ScientISST-ab-de - 08:3A:F2:49:AB:DE
[2] ScientISST-ac-be - 08:3A:F2:49:AC:BE
Connect to: 
  1. Hit CTRL-C when you wish to stop.


$ python -h

usage: [args] address

description: The program connects to the ScientISST Sense device and starts an acquisition, providing the option to store the received data in a .csv file.

positional arguments:  address               Linux: bluetooth MAC address, Mac: serial port address, Windows: bluetooth serial COM port

optional arguments:
  -h, --help            show this help message and exit
  -f FS, --frequency FS
                        sampling frequency, default: 1000
  -c CHANNELS, --channels CHANNELS
                        analog channels, default: 1,2,3,4,5,6
  -d DURATION, --duration DURATION
                        duration in seconds, default: unlimited
  -o OUTPUT, --output OUTPUT
                        write report to output file, default: None
  -s, --lsl             stream data using Lab Streaming Layer protocol
  -q, --quiet           don't print ScientISST frames
  -v, --verbose         log sent/received bytes



Pair and trust the ScientISST Sense board:

scan on
trust XX:XX:XX:XX:XX

You can now run the script:

python XX:XX:XX:XX:XX


First, you need to pair the ScientISST sense device in the Bluetooth Settings section. Then, you'll need to find the serial port address using the Terminal:

ls /dev/tty.ScientISST*

Copy the String like: /dev/tty.ScientISST-XX-XX-SPP_SE.

You can now run the script:

python /dev/tty.ScientISST-XX-XX-SPP_SE


Turn the ScientISST Sense board on.

Now, go to Control Panel > Hardware and Sound > Devices and Printers. Select "Add a device". Select the ScientISST Sense board, hit "next" until its set up.

While connected to the board, search "Bluetooth settings" on the Control Panel, then go to the "COM ports" tab and check the port name for the outgoing entry. Copy the String like: COMX

You can now run the script:

python COMX


Example usage to acquire AI1 at 10Hz sample rate (Linux):

python3 -f 10 -c 1 -o output.csv 08:3A:F2:49:AC:D2



  • pandas
  • numpy
  • matplotlib

Example ECG


This is not a medical device certified for diagnosis or treatment. It is provided to you as is only for research and educational purposes.


This work was partially supported by Fundação para a Ciência e Tecnologia (FCT) under the projects’ UIDB/50008/2020 and DSAIPA/AI/0122/2020 (AIMHealth) through IT—Instituto de Telecomunicações, which is gratefully acknowledged.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scientisst-sense-1.1.0.tar.gz (18.6 kB view hashes)

Uploaded Source

Built Distribution

scientisst_sense-1.1.0-py3-none-any.whl (21.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page