Skip to main content

Logitech Pan/Tilt Python C Extension

I just started learning C++ in earnest about a month ago. This weekend I felt like I knew enough to start looking at Python C extensions, so I wrote one to control the pan and tilt functions of my Logitech Orbit. I used this camera previously for my OLPC telepresence project.

There's already a similar module out there, called lpantilt, that does this using Cython. But, I wanted to take a crack at it myself and do it with straight C.
#include <Python.h>
#include <errno.h>
#include <sys/ioctl.h>
#include <fcntl.h>

#include "linux/videodev2.h"
#include "uvcvideo.h"

static int pantilt(int pan, int tilt, int reset) {
struct v4l2_ext_control xctrls[2];
struct v4l2_ext_controls ctrls;

if (reset) {
xctrls[0].id = V4L2_CID_PAN_RESET;
xctrls[0].value = 1;
xctrls[1].id = V4L2_CID_TILT_RESET;
xctrls[1].value = 1;
} else {
xctrls[0].id = V4L2_CID_PAN_RELATIVE;
xctrls[0].value = pan;
xctrls[1].id = V4L2_CID_TILT_RELATIVE;
xctrls[1].value = tilt;

ctrls.count = 2;
ctrls.controls = xctrls;

int fd;
if (-1 == (fd = open("/dev/video0", O_RDWR))) {
PyErr_SetString(PyExc_IOError, "Couldn't open /dev/video0.");
return 0;

if (-1 == ioctl(fd, VIDIOC_S_EXT_CTRLS, &ctrls)) {
PyErr_SetString(PyExc_IOError, "ioctl failed.");
return 0;

if (-1 == close(fd)) {
PyErr_SetString(PyExc_IOError, "Failed to close /dev/video0.");
return 0;

return 1;

static PyObject* pantilt_reset(PyObject* self, PyObject* args) {
if (!PyArg_ParseTuple(args, "")) {
return NULL;
if (!pantilt(0, 0, 1)) {
return NULL;

static PyObject* pantilt_pantilt(PyObject* self, PyObject* args) {
int pan;
int tilt;
if (!PyArg_ParseTuple(args, "ii", &pan, &tilt)) {
return NULL;
if (!pantilt(pan * 64, tilt * 64, 0)) {
return NULL;

static PyMethodDef PantiltMethods[] = {
{"pantilt", pantilt_pantilt, METH_VARARGS, "Set relative pan and tilt of the camera."},
{"reset", pantilt_reset, METH_VARARGS, "Reset the pan and tilt of the camera."},

PyMODINIT_FUNC initpantilt(void) {
(void) Py_InitModule("pantilt", PantiltMethods);
And here is the associated script to build it:
from distutils.core import Extension
from distutils.core import setup

m = Extension('pantilt', sources=['pantilt.c'])

description='Control pan and tilt of supported webcams.',
To get this to build and run on Ubuntu, I had to:
  • Download and install libwebcam.
  • Execute uvcdynctrl -i logitech.xml (logitech.xml can be found in the source for libwebcam).
  • Install the linux-source-* package and extract the /usr/src/linux-source*.tar.bz2 to disk.
  • Copy uvcvideo.h in to the same directory as pantilt.c.
  • Execute python install
Finally, here's a sample usage of the pantilt module:
import pantilt, time

pantilt.reset() # Reset the pan and tilt to the origin.
pantilt.pantilt(10, 0) # Increase relative pan by 10 degrees.
pantilt.pantilt(0, 10) # Increase relative tilt by 10 degrees.

Popular posts from this blog

Email Injection

Not so long ago, I ran a wiki called SecurePHP. On that wiki, there was one particular article about email injection that received a lot of attention. Naturally, with all the attention came lots of spam. As a result, I disabled editing of the wiki and content stagnated. Still, the email injection article remained popular. About a year later, the server that hosted SecurePHP died and I never had a chance to hook it all back up. I saved the article though and I'm reposting it now. It may be a bit old (I've been away from PHP for a long time), and I didn't write all of it, so feel free to leave comments about needed updates and corrections. Though this article focuses on PHP, it provides a lot of general information regarding email injection attacks. The PHP mail() Function There are a lot of ways to send anonymous emails, some use it to mass mail, some use it to spoof identity, and some (a few) use it to send email anonymously. Usually a web mailform using the mail() funct
Read more

XBee ZNet 2.5 Wireless Accelerometer

I managed to put together a wireless accelerometer the other night using my two new XBees, an Arduino XBee shield, an XBee Explorer USB, an ADXL330, and some Python. I struggled a bit with some of it, so here's what I learned: First, a parts list. XBee 2mW Series 2.5 Chip Antenna Arduino XBee (with XBee Series 2.5 module) XBee Explorer USB ADXL330 I'm not sure exactly what the specs are on the XBee that comes with the Arduino shield. But, it is definitely a series 2.5. The first thing to do is to configure and upgrade the firmware on your XBees. To do that, you'll need X-CTU (for the firmware upgrade at least, but it's also nice for configuration) which, unfortunately, is only available for Windows. But, it works fine from VMware. First up, the XBee we'll hook up to the computer to read incoming data from the accelerometer: Plug one of the XBees into the Explorer (it's also possible to do this from the Arduino shield by shifting the two XBee/USB jumpers to USB
Read more

Android Recipes and Snippets

I've put together a small collection of Android recipes. For each of these recipes, this is an instance of Context (more specifically, Activity or Service ) unless otherwise noted. Enjoy :) Intents One of the coolest things about Android is Intents . The two most common uses of Intents are starting an Activity (open an email, contact, etc.) and starting an Activity for a result (scan a barcode, take a picture to attach to an email, etc.). Intents are specified primarily using action strings and URIs. Here are some things you can do with the android.intent.action.VIEW action and startActivity() . Intent intent = new Intent(Intent.ACTION_VIEW); // Choose a value for uri from the following. // Search Google Maps: geo:0,0?q=query // Show contacts: content://contacts/people // Show a URL: intent.setData(Uri.parse(uri)); intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); startActivity(intent); Other useful action/URI pairs include: Intent.ACTION_DIAL , tel://867530
Read more