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

Bot Commander r1 Released

I just published Bot Commander , the code for my Lego NXT rover . There's a lot left to be done, but release early and often, right? Currently it provides a UI for controlling the direction and speed of all three motor ports on the NXT brick. You can link motors together to adjust their speed in unison. In addition, you can enable "Tilt Control" for a steering-wheel-type experience. To use tilt control: Hook up motor A and B to be the left and right wheels of your vehicle. Hold the phone sideways (i.e. landscape). Tilt the phone forward and backward to drive forward and backward. Turn the phone right and left (like a steering wheel) to steer right and left. As you tilt the phone, you'll see the UI update the slider controls for the speed of motors A and B. I plan to expand the UI to provide a lot more than just motor control. Before that, though, I'll push a JAR to make it easy to integrate control of Lego NXT robots into your own Android project. The code
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