Setup Empatica E4

4. Setup Empatica E4#

4.1. Requirements#

4.1.1. Hardware#

4.1.2. Accounts#

4.1.3. Key#

4.1.4. Software#

  • Empatica E4 Streaming Server / Windows only (download here: E4 Streaming Server)

  • Bluegiga Bluetooth Smart Dongle BLED112 Driver (download here: BLED112 Driver)

  • Visual C++ Redistributable Package installed

4.2. Installation#

  1. Register a Developer Account in the Empatica e4 dashboard (see E4 Dashboard Login)

  2. The Empatica Devices must be registered via key as purchased device or the account must be permitted as a shared device (in this dashboard E4 Developer Dashboard)

  3. Follow installation steps here: E4 Streaming Server Docs

  4. If everything done correct, you can see in the Empatica E4 Streaming Server, the connection established with a green button.

    • If not allowed with 0% battery shows up, your account/API key is not registered to the device or there is a bug with the Empatica Device which can only be resolved when Empatica E4 is factory resetted (see here how: E4 Factory Reset.)

      • If still not working try to upgrade software version via the Empatica manager software Empatica Manager

4.3. Usage#

  1. After connection established in the Empatica E4 Streaming Server the data aquisition software can be started.

  2. The data streams are subscribed automatically.

  3. The data becomes visible after ~2-10 seconds as timeseries plots.

  4. The recording can be started by pressing “#” or via button.

4.4. Executable (pyinstaller bundling)#

To bunde the application to a portable .exe on windows with following steps:

If not already created/installed:

python -m venv venv

.\venv\Scripts\activate 

pip install -r requirements.txt

Bundling:

cd Empatica

pyinstaller --clean --onefile Empatica.py

The bundled .exe can be found in the dist folder after finish.

  • The documentation of the pyinstaller what the arguments are used for can be found here: Pyinstaller Docs

Contents