The evdev module

evdev.py

This is a Python interface to the Linux input system’s event device. Events can be read from an open event file and decoded into spiffy python objects. The Event objects can optionally be fed into a Device object that represents the complete state of the device being monitored.

Copyright (C) 2003-2004 Micah Dowty <micah@navi.cx>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

The Device class

class pyamp.ui.input.evdev.Device(filename)

An abstract input device attached to a Linux evdev device node

poll()

Receive and process all available input events

readMetadata()

Read device identity and capabilities via ioctl()

update_EV_ABS(event)

Scale the absolute axis into the range [-1, 1] using absAxisInfo

The BaseDevice class

class pyamp.ui.input.evdev.BaseDevice

Base class representing the state of an input device, with axes and buttons. Event instances can be fed into the Device to update its state.

The Event class

class pyamp.ui.input.evdev.Event(timestamp=0, type=0, code=0, value=0, unpack=None, readFrom=None)

Represents one linux input system event. It can be encoded and decoded in the ‘struct input_event’ format used by the kernel. Types and codes are automatically encoded and decoded with the #define names used in input.h

pack()

Pack this event into an input_event struct in the local machine’s byte order.

readFrom(stream)

Read the next event from the given file-like object

unpack(s)

Unpack ourselves from the given string,, an input_event struct in the local byte order.

The EnumDict class

class pyamp.ui.input.evdev.EnumDict(numberMap)

A 1:1 mapping from numbers to strings or other objects, for enumerated types and other assigned numbers. The mapping can be queried in either direction. All values, by default, map to themselves.