Main Menu
Make donations with PayPal!
Donat-o-Meter Stats
August's Goal: $150.00
Due Date: Aug 31
Gross Amount: $0.00
Net Balance: $0.00
Surplus: $-150.00

How to install or upgrade UV4L on Raspbian (for the Raspberry Pi)

To install UV4L open a terminal and type the following commands:
$ curl | sudo apt-key add -
Add the following line to the file /etc/apt/sources.list :
deb wheezy main

$ sudo apt-get update
$ sudo apt-get install uv4l uv4l-raspicam
The last two commands will upgrade UV4L to the most recent version, if it's already installed.

If you want the driver to be loaded at boot, also install this optional package:
$ sudo apt-get install uv4l-raspicam-extras
As a convenience, the above package will also provide a service script for starting or stopping the driver at any time:
$ sudo service uv4l_raspicam restart
When (re)starting the service, uv4l will be instructed to parse the configuration file /etc/uv4l/uv4l-raspicam.conf to get the default values for the (main) driver options. You can edit that file as you prefer to add, remove or change the default options. The same service is used at boot.

Now the UV4L core component and the Video4Linux2 driver for the CSI Camera Board are installed. If you occasionally get unexpected errors from the driver, make sure the Camera is enabled and enough memory is reserved for the GPU (not less than 128MB is suggested) from the below menu:
$ sudo raspi-config
Also consider updating the firmware with the following command:
$ sudo rpi-update
For detailed informations, options, etc... about the modules installed type accordingly:
$ man uv4l
$ man uv4l-raspicam
To get a list of available options:
$ uv4l --help --driver raspicam --driver-help
If you did not install the optional uv4l-raspicam-extras package (which already contains a script for starting uv4l with the settings taken from a configuration file) but want to quicly test uv4l, load it manually:
$ uv4l --driver raspicam --auto-video_nr --width 640 --height 480 --encoding jpeg
and take a JPEG snapshot from the Camera:
$ dd if=/dev/video0 of=snapshot.jpeg bs=11M count=1
For a list of other use cases click here.

To terminate a running driver, close the applications and kill the corresponding uv4l process:
$ pkill uv4l
Apart from the driver for the Raspberry Pi Camera Board, the following modules or drivers can be optionally installed:
$ sudo apt-get install uv4l-server
$ sudo apt-get install uv4l-uvc
$ sudo apt-get install uv4l-xscreen
$ sudo apt-get install uv4l-mjpegstream
For the Raspberry Pi 2 only, the WebRTC extension for the Streaming Server is also available:
$ sudo apt-get install uv4l-webrtc
Once you have installed the HTTP Streaming Server module, make sure to reload uv4l for it to notice and start the server. Afterwards you can access the server with the browser at the default address and port http://raspberry:8080/ (where raspberry has to be replaced with the actual hostname or IP address of your RaspberryPi).

To get further help:
$ man uv4l-server
$ man uv4l-uvc
$ man uv4l-xscreen
$ man uv4l-mjpegstream
Note: by default WebRTC gets the audio stream from the default installed soundcard, which generally is the first indexed card shown by arecord -l. If you want to make use of an USB soundcard by default, edit /etc/modprobe.d/alsa-base.conf and modify or add the following lines and reboot the system:
options snd-usb-audio index=0
options snd_bcm2835 index=1
After you have rebooted, make sure capture volumes are unmuted and increased to the desired level. alsamixer is an handful tool for this purpose.

Return to Sections Index Return to Sections Index
[ Back to UV4L, Userspace Video4Linux framework | Return to Sections Index | Printer Friendly Page]


Lost Password?

Register now!