To view README in English, click here

XGlove

XGlove — Python-библиотека для работы с перчаткой-контролёром X.Glove. Позволяет считывать данные с тензорезисторов и инерциального датчика, а также выводить их на OLED-дисплей.

Возможности

• Считывание углов наклона (roll, pitch, yaw) с инерциального датчика.
• Получение процентного соотношения сгиба пальцев.
• Получение выходного напряжения с тензорезистора каждого пальца.
• Отображение данных на монохромном OLED-дисплее 128x64 через luma.oled.
• Простая интеграция в Python-проекты.

Установка

pip install xglove

pip install git+https://github.com/XaleraBLT/xglove.git

Функции

Физическое устройство

Инициализация устройства

import xglove
glove = xglove.Glove()

Считывание данных с тензорезисторов

glove.get_finger_percent(0) - получение процентного отношения сгиба пальца

glove.get_finger_voltage(0) - получение выходного напряжения с пальца

glove.get_finger_raw(0) - получение сырого значения изгиба от 0 до 65536

Считывание данных с инерциональных датчиков

glove.get_angles("roll", "pitch", "yaw") - получение углов поворота ладони (0-360)

Вывод данных на дисплей:

glove.render_data(angles, fingers) - вывод данных на дисплей

Обмен данных между устройствами

Через провод

На устройстве:

import xglove
glove = xglove.Glove()
xglove.connectors.host.Serial_connector(glove)

На приёмной машине:

import xglove
con = xglove.connectors.client.Serial_connector(port="COM1") # В зависимости от порта в диспетчере устройств

Через точку доступа

На устройстве:

import xglove
glove = xglove.Glove()
xglove.connectors.host.Socket_connector(glove)

На приёмной машине:

import xglove
con = xglove.connectors.client.Socket_connector()

Загрузка python-файла на устройство (только через точку доступа)

import xglove
xglove.utils.update_code("путь_к_коду.py")

Каллибровка перчатки (только через точку доступа)

import xglove
xglove.utils.update_calib("путь_к_файлу.json")

Пример файла с калибровочными данными:

{
  "0": [2869, 2826, 2346, 2177, 2121],
  "1": [3941, 2237, 2413, 1698, 1483],
  "2": [5607, 2898, 2517, 2200, 1797],
  "3": [6596, 3123, 3039, 2275, 2048]
}

Чертёж устройства