Emotiv Launcher
  • What is EMOTIV Launcher?
  • Getting started
    • System requirements
    • Installation
    • Establishing Trust for Emotiv Certificates
    • Running the EMOTIV Launcher
    • Creating an EMOTIV account
    • Forgotten password
    • Logging in to EMOTIV Launcher
  • Settings
    • Understanding the settings
  • Devices - Setting up an EEG headset
    • Setting up your EEG headset
    • Connecting your headset
    • Connected headset information
    • Disconnecting a headset
    • Fitting a headset
    • Contact quality map
    • Upgrading firmware
  • Devices - Setting up virtual Brainwear®
    • What is Virtual Brainwear?
    • Creating a Virtual Brainwear device
    • Turning a Virtual Brainwear device on/off
    • Connecting and disconnecting your Virtual Brainwear® device
    • Virtual Brainwear® device statuses and configuration
    • Configuring a Virtual Brainwear device ®
    • Contact quality for Virtual Brainwear ®
    • Virtual Brainwear ® Simulation
    • Virtual Brainwear ® Detections
  • Account
    • Your Emotiv account
  • Apps
    • Your applications
  • Tools
    • Decryption tool
    • Connect to remote cortex
  • Updating Manually
    • Uninstall the software
  • Release Notes
    • v3.0
    • v3.7.0
Powered by GitBook
On this page
  • Install Cortex on Pi
  • Remote connect to Cortex running on Pi
  • Connect headset
  • Develop a remote application
  1. Tools

Connect to remote cortex

PreviousDecryption toolNextUninstall the software

Last updated 2 years ago

This feature is only available since 2.7.1 release.

Following steps are the guideline to use the remote tool to work with Cortex running on Raspberry Pi 4

Install Cortex on Pi

To install Cortex on Pi :

  • ssh to Pi

  • Download the file emotivapps_2.7.1.beta_armhf.deb

    • Note: The version number of the file you downloaded can be different from the manual, however, the steps should be the same, you only need to change the version number in the command line.

  • Run the following command to install

$ sudo apt-get install ./emotivapps_2.7.1.beta_armhf.deb

After installing, you can check if cortex service is running with command

$ sudo systemctl status cortex

Remote connect to Cortex running on Pi

  • ssh to Pi and change directory to /usr/local/emotivapps/bin

$ cd /usr/local/emotivapps/bin
  • Run following command to allow access from remote IP. More usage of cortexaccess tool can be found .

# cortexaccess ip accept ip_address_of_machine_which_does_remote_to_pi
# for example:
$ ./cortexaccess ip accept 192.168.1.11
  • After allowing access, run the following command to confirm

$ ./cortexaccess ip list
  • Put the above IP address (or emotiv-cortex.remote if the IP address is not supported) into the text box under the Remote Connect session

  • Then click Connect

Connect headset

After Cortex is running on Pi and EMOTIVApp remotes to Pi successfully, user can connect a headset to Pi with Dongle or Bluetooth connection. Headsets will be showed up on the Devices tab.

Note with bluetooth connection, in case the headset connection is lost unexpectedly (even the headset is turned on), there may be an issue with bluetooth service, you should make sure this bluetooth service is running stable. Most of the time, you can troubleshoot by restarting bluetooth service first, then cortex service, using the following commands on Pi:

$ sudo systemctl restart bluetooth
$ sudo systemctl restart cortex

Develop a remote application

In order to connect with Cortex running on Pi and develop an application, user must change url to Pi's IP address.

For example with python example, user should have following change in file

    def __init__(self, user, debug_mode=False):
        url = "wss://ip_address_of_PI:6868"

Find the IP address of your Pi device with command ifconfig, for example 192.168.1.21. Note that only IP addresses in a specific range are supported, otherwise you have to configure hosts file and use emotiv-cortex.remote DNS.

here
See the range of supported IP addresses and how to configure hosts files.
https://github.com/Emotiv/cortex-v2-example/blob/master/python/cortex.py