Skip to content

Latest commit

 

History

History
140 lines (91 loc) · 3.7 KB

README.md

File metadata and controls

140 lines (91 loc) · 3.7 KB
Raw

SensoGlove

Python wrapper module to interact with SensoGloves.

It handles for you the socket connection and the raw payload parsing, only leaving to you the fun parts of the job !

Installation

$ pip install sensoglove

Usage

Import the SensoGlove class in your python code

from sensoglove import SensoGlove

Then, instantiate a new SensoGlove object and connect

glove = SensoGlove('127.0.0.1', 53451)
glove.connect()

Now, you just have to create a loop to continuously fetch data from gloves and the data is yours !

while 1:
    gloves.fetch_data()
    print(gloves.hand.fingers.index.pinch)
    print(gloves.hand.fingers.middle.pinch)
    print(gloves.hand.fingers.third.pinch)
    print(gloves.hand.fingers.little.pinch)

Documentation

SensoGlove(host, port)

  • host {String} - Glove's listener host
  • port {Integer} - Glove's listener port

Properties

  • host {String} - Host passed in

  • port {Integer} - Port passed in

  • src {String} - Glove's source mac address

  • name {String} - Glove's name

  • battery {Integer} - Glove's battery level

  • temperature {Integer} - Glove's temperature

  • hand {Hand Object} - Hand Object containing hand's informations

Methods

  • connect() - Connect the script to the glove
  • fetch_data() - Fetch data to be parsed by the module. (Has to be put in a loop, so the fetching is continuous)
  • send_vibration(fingers, [duration], [strength])
    • fingers {List of String} - List of fingers you want to vibrate
    • duration {Integer} - Duration of the vibration <0-65536>
    • strength {Integer} - Strength of the vibration <0 - 10>

Hand

Properties

  • type {String} - Hand type (lh/rh for left-hand/right-hand)
  • palm {Palm Object} - Palm Object containing palm's informations
  • wrist {Wrist Object} - Wrist Object containing wrist's informations
  • fingers {Fingers Object} - Fingers Object containing fingers' informations

Palm

Properties

  • rotation {Rotation Object} - Rotation of the Palm
  • speed {Speed Object} - Speed of the Palm
  • acceleration {Speed Object} - Acceleration of the Palm
  • data {Dictionary} - Raw Palm data (shouldn't be needed)

Speed

Properties

  • x {Integer} - Speed/Acceleration on x axis
  • y {Integer} - Speed/Acceleration on y axis
  • z {Integer} - Speed/Acceleration on z axis

Wrist

Properties

  • rotation {Rotation Object} - Rotation of the Wrist
  • data {Dictionary} - Raw Wrist data (shouldn't be needed)

Fingers

Properties

  • thumb {Thumb Object} - Thumb Object containing Thumb informations
  • middle {Rotation Object} - Rotation of the middle finger
  • third {Rotation Object} - Rotation of the third finger
  • little {Rotation Object} - Rotation of the little finger
  • data {Dictionary} - Raw Fingers data (shouldn't be needed)

Notes

Roll property is not set in Rotation Object that represent finger rotation, as usually human cannot rotate finger in that axis.

Thumb

  • rotation {Rotation Object} - Rotation of the thumb
  • bend {Integer} - Bending of the distal phalanx of the thumb

Rotation

Properties

  • pitch {Integer} - Pitch Rotation
  • roll {Integer} - Roll Rotation (not set for finger representation)
  • yaw {Integer} - Yaw Rotation

Useful links

Contributing

See something that could be improved ? Open an issue or contribute !

  • Fork it
  • Create your feature branch
  • Commit your changes and push them to your branch
  • Create a new Pull Request

License

MIT