Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

pypowermate

This module encapsulates access to the Griffin USB PowerMate "knob" device 1. The PowerMate is an "assignable controller" in the shape of a knob. The knob can be rotated, pressed and also features a LED at its base that can be used to indicate events to the operator.

This module provides functions to read knob events (rotate/press) and to set the LED brightness and pulse speed (when in "pulse"-mode).

The module interfaces with the device through the powermate Linux kernel driver and will therefore only work on Linux systems.

Both Python 2.7 and Python 3.x are supported.

Getting started

  1. Install using pip:
    $ pip install .
    
  2. Ensure "powermate" kernel module is loaded in your system. It ships with most modern Linux distros and should insmod automatically when you plug in the PowerMate.
    $ lsmod | grep powermate
    
  3. Ensure your user can read/write the powermate input device. On Ubuntu, this means adding yourself to the "input" usergroup.
  4. Testrun the example script.
    $ python examples/pulse_and_brightness.py
    

This will run a small example program that lets you control the LED behaviour by pressing and/or rotating the knob. The example will use the first Powermate knob it finds; if you have multiple, you may optionally specify the device path to the example, like so:

```
$ python examples/pulse_and_brightness.py /dev/input/by-id/usb-Griffin_Technology_Inc._Griffin_PowerMate-event-if00
```

(Your device path may differ)

API

See the documentation in pypowermate/powermate.py for details on how to use the module from your own code.

Tests

A small number of semi-automated tests can be found in the tests/ subdir. They require a Knob-device plugged in and some interaction to run.

```
$ python tests/test_powermate.py
```

The tests will use the first found Powermate, should there be several connected at the same time.

License

This module is licensed under GNU Lesser General Public License (LGPL v3). See LICENSE.txt for details.

About

A Python module that encapsulates access to a Griffin PowerMate USB knob.

Resources

License

Packages

No packages published

Languages