Elphel workshop in Bordeaux during RMLL 2010

From ElphelWiki
Revision as of 05:15, 1 July 2010 by Polto (talk | contribs) (Automation)
Jump to: navigation, search


About RMLL 

RMLL 2010 (Libre Software Meeting) is a free (as a beer and as a speech) and non commercial conferences, workshops and round table about Free Software and its applications. The LSM goal is to provide a platform for exchange among Free Software developers, users and stakeholders.

This year RMLL will take place in Bordeaux, France from 6th to 11th of July and is organised by a set of local Free Software user groups and organizations with the help of several public and private sponsors. The event will be hosted by ENSEIRB-MATMECA, U-Bordeaux 1, LaBRI & ENSCB.

About the workshop

The workshop will take place during RMLL 2010 and is organized by our Swiss partner Alsenet SA.

All our European customers, partners and friends of Elphel are invited to participate in the workshop. It will be a perfect occasion to meet other Elphel customers, users & developers, to test the hardware, software and to discuss project ideas and future developments. RMLL is also an ideal place to get a better understanding of the economical models of Free Software.

Some preparations on your end (e.g. pre-installing required packages) would allow us to focus on the main topics and cover any remaining questions. Any question prior or during the workshop should be discussed on Elphel’s IRC channel, wiki or public mailing list so we can have a public log that is potentially useful to other Elphel users as well.

Please sign up on the participant’s list, and please add your availability during RMLL so that we can find the optimal day & time for the workshop. All further information about this workshop will be available on this wiki page.

We are looking forward to seeing you at the workshop!

Dates, time and place

The workshop will take place on 7th July from 13:00 to 17:00 in the room TD14 of ENSEIRB.

For accomodation, map, and any other information please visit RMLL web site.

Overview of the camera building blocks

Elphel's goal is to provide high-quality, intelligent, network cameras based on open hardware and free software. Elphel hopes its modular camera design will attract software and FPGA engineers interested in exploring high-definition videography, among other innovative applications.

Both turnkey camera assemblies and OEM modules are available. All the documentation is published on this wiki and our mailing list under GNU FDL v1.3 license and all the source code including FPGA Verilog code, Linux drivers and software are available under GNU GPL v3 license.


All the separate camera components are listed on this page.

Here are the most commonly used:

The 10338 & 10353 boards are the minimum requirements to assemble a camera:

Those two are optional and very flexible extension boards:

  • 10359 - multi-function board. It can be connected between the 10353 Processor board and a sensor one (up to three sensor boards can be connected)
  • 10369 - IO extension board. SATA, CF, USB 1.1, GPIO, i2c, ... This board also have few adapters

On each of the board pages you will find links to circuit diagram, parts list, PCB layout & Gerber files. Some data-sheets and other necessary documentations are linked from.


Our turnkey modules are listed here and are documented more in detail on Elphel camera parts.

price list

http://www3.elphel.com/price_list , last day of RMLL 2010 few cameras will be sold with a special 10% GPL contribution discount.

under development

Elphel is currently working on Eyesis high resolution panoramic camera - http://blogs.elphel.com/category/panoramic/

And soon we return to our next generation camera development - http://blogs.elphel.com/category/andrey/10373/

Elphel SDK

reflashing camera firmware & FPGA bitstream

 Overview of th main software available on the camera


Imgsrv was developed to increase the transfer rate of individual images acquired by the Elphel 353 series cameras. Imgsrv is connected through 8081 port and writes GET responses directly to the socket (reading image data from the circbuf using zero-copy memory mapping mmap), reaching 9-10MB/sec - virtually the full bandwidth of the network. This server does not provide any control over the sensor or FPGA compressor operation, its only purpose is to get data acquired to the (currently 19 MB) circular buffer in the system RAM. It is intended to have the functionality similar to the camera video streamers that also deal with the data already being acquired to the system buffer to be used when individual images are needed rather than the continuous video stream .

The imgsrv makes use of the new functionality of the /dev/circbuf driver providing it with a convenient web front end. It serves JPEG images (with Exif data attached) as well as metadata and circbuf status formatting output as the xml files.




lighttpd / FastCGI / PHP

different PHP scripts

client software compatible with Elphel cameras


Firefox 3.6


You can use command line tools such as wget or curl to automate many things on the camera.

For example on your PC you can use cron and wget to automatically download a full resolution snapshot once per minute. When we can use mencoder for example to assemble videos:

On the PC edit your cron:

crontab -e

you should add a line like

#.---------------- minute (0 - 59) 
#|   .------------- hour (0 - 23)
#|   |   .---------- day of month (1 - 31)
#|   |   |   .------- month (1 - 12) OR jan,feb,mar,apr ... 
#|   |   |   |  .----- day of week (0 - 7) (Sunday=0 or 7)  OR sun,mon,tue,wed,thu,fri,sat 
#|   |   |   |  |
#*   *   *   *  *  command to be executed
 * 6-21  *   *  *  wget -O ~/timelapse/`date +%s`.jpg  > /dev/null 2>&1
 10  23  *   *  *  mencoder -ovc copy -mf fps=8:type=jpg 'mf://~/timelapse/*.jpg' -o ~/timelapse_videos/time_lapse_`date +%s`.avi  > /dev/null 2>&1; mv ~timelapse ~/timelapse_`date +%s` ;mkdir /home/polto/timelapse

This example get one image per second in full resolution from the camera from 6:00 to 22:00 and at 23:10 compress acquired images into a time-lapse video.

 Video frameworks



 lib livemedia (live555)

 VLC, libvlc 

VLC is a free and open source cross-platform multimedia player and framework, that plays most multimedias files, medias and streaming protocols.

It is simple to use, yet very powerful and extendable. Vlc page provide usage examples.

 MPlayer / Mencoder

MPlayer focuses on low latency displaying by avoiding caching and is therefore perfectly suited to display live video streams from Elphel cameras.

Another great feature of MPlayer is the wide range of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use GGI, SDL (and this way all their drivers), VESA (on every VESA compatible card, even without X11!) and some low level card-specific drivers (for Matrox, 3Dfx and ATI), too! Most of them support software or hardware scaling.


Using gstreamer

few words about network configuration for unicast and multicast modes


imageJ plugins for Elphel 

JP46 post-processing workflow

There are currently 2 applications and a demo script for post processing JP46 quicktime movies: http://elphel.svn.sourceforge.net/viewvc/elphel/tools/

Movie2DNG is developed by Paulo Henrique Silva and can currently (May 2010) not to the full transition from *.mov to dng but uses ffmpeg to extract a jp46 sequence from the mov. This is the first step in the process.

Once there is a image sequence of JP46 (jpeg) files you can use the next application called "JP4toDNGconverter". This tool uses a modified libtiff to write DNG files that can then be opened the same way as RAW files from other cameras in UFRaw, RawStudio, or Adobe Aftereffects, etc.

The BatchProcess PHP script basically combines the above 2 applications and does a batch conversions of all quicktime movs found in a particular folder to a DNG sequence.

Gstreamer plugins for Elphel

using Gstreamer and GLSL with Elphel cameras

working with OpenCV

using OpenCV and GpuCV with Elphel cameras

Interfacing with the camera, triggering, synchronization

 simple and stupid integration with Arduino

http://arduino.cc can be used to easily interface button, motion detector or any other external trigger to the camera.

In  this example I wrote a code for Arduino to handle a button and a PIR motion detector. The Arduino is attached to camera's USB and send shell commands to the camera for execution. So PIR is binded to camogm to record on the internal CF card on motion detection and the button store a full resolution snapshot.

 trigger internal & external, multiple cameras synchronization, trigger a camera from GPS

Deep hardware / software integration with Elphel: example on likoboard and likomapper software

About Likoboard and Likomapper projects

Likoboard is a re-programmable microprocessor conceived to create a human – machine interface. Originally likoboard was co-developed by Alsenet SA for an exclusive piece of high-end jewelery by the Maison Olfact. Being entirely based on Libre technologies Likobord can be integrated as an autonomous remote control to an application, as well as a peripheral USB of an embedded system or of a personal computer.

Likomapper project was initiated by Phil and implemented by Alsenet SA. It's goal is to map likoboard's tactile interface to control exposure on the camera.

Likoboard is connected to the camera via USB, the camera runs a PHP software as daemon to communicate with likoboard over HID and set the exposure time using Elphel PHP extension.

Cross-compiling the libs

liblikoboard depends on libhid, and libhid needs libusb legacy.

I did compile the latest libusb legacy (0.1.12) from sourceforge, and libhid-svn (rev. 364) from http://libhid.alioth.debian.org/

See here for the cross-compiling method

Porting the PHP extension

To port the PHP extension php_likoboard I had to:

  • Build it for my native cpu,
  • Source init_env from the elphel353/ folder.
  • Copy the php_likoboard folder to elphel353/apps/php/ext/php_likoboard.
  • Change to this folder and run ../../elphize.
  • Run make and copy .libs/php_likoboard.so to /usr/local/crisv32/lib/php/extensions/no-debug-non-zts-20060613/.


php_likoboard was not working on the camera. So I did write a test application sending debugging messages in console to see what was going wrong.

libusb-0.1.12 appears to be broken when running on the camera, so I did restart using libusb-0.1.11 and it worked.

Adding a PHP ELPHEL_DAEMON to the firmware

Integration to Elphel CVS 

 multisensor examples with 10359 board

  • A while ago (somewhere at 8.0.8.xx) the commands addresses were changed - so please check 10359 discussion page
  • Andrey added extra parameters and now everything can be controlled from parsedit.php
  • Following this link might be helpful for changing the camera parameters.

Switching channels

Parameter Default value Equal to 10359 reg Comments
MULTI_SEQUENCE 0x39 0x806 2 LSBs - Direct Channel bits - 0x1 - J2, 0x2 - J3, 0x3 - J4

Combined frame mode

1. set other image parameters

2. set TRIG parameter to 0x4

3. set MULTI_MODE parameter to 0x1