Installation
Software
Dependencies
Operating system
Ubuntu 22.04 or newer, or equivalent Linux distribution
Software
CMake 3.15 or newer
Python 3.8 or newer
Source Code
The TouchLab Comm Python ( touchlab_comm_py ) is the driver for reading data from Touchlab Sensors. This is a python wrapper of the C++ library. The C++ binaries are included in the package.
Install CMake and Python
Extract the source files and change directory to the source folder.
Install the python package using pip pip install .
Run the example script located in examples/example.py
Windows 11 and Ubuntu Instructions
pip install touchlab-comm-pyIdentify connection port
Once the fingertip is connected to your PC identify which port it is communicating on.
For Windows this can be found in the Device Manager.
For linux, open a terminal and use the ls /dev/tty*` command.
Run the supplied example Python script
Run the supplied Python script and pass the port and calibration file as an arguments. The calibration file is a .bin file which contains the calibration for the sensor.
python3 example.py <SERIAL_PORT> <CALIBRATION_FILE>Alternatively, if you only need the un-calibrated values, you can run the example script without the calibration file argument:
python3 example.py <SERIAL_PORT>When reading data from the Fingertip the data is returned as a list of floats in the following order for both the calibrated and raw output.
[taxel_A1, taxel_A2, taxel_A3, taxel_B1 ... taxel_n]
Fingertip Taxels
Taxel ID | Index when reading data |
|---|---|
A1 | 0 |
A2 | 1 |
A3 | 2 |
B1 | 3 |
B2 | 4 |
B3 | 5 |
C1 | 6 |
C2 | 7 |
C3 | 8 |
C4 | 9 |
D1 | 10 |
D2 | 11 |
D3 | 12 |
E1 | 13 |
E2 | 14 |
E3 | 15 |
