e-con Systems e-CAM51 USB User manual

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 1 of 34
e-con Systems India Pvt Ltd
17, 54th Street,
Ashok Nagar
Chennai-600083
www.e-consystems.com
e-CAM51_USB
Linux Application User Manual
Revision 1.0
Friday August 17, 2012
Customer/Partner
NA

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 2 of 34
Contents
1Revision History ...............................................................................................................................3
2Introduction ......................................................................................................................................4
3Scope...............................................................................................................................................4
4Reference.........................................................................................................................................4
5Identifying the Deliverables...............................................................................................................4
6Launching the Application.................................................................................................................5
7Application Features.........................................................................................................................6
7.1 Image Control Tab....................................................................................................................6
7.2 Video and Files Tab .................................................................................................................8
7.2.1 Video Capture Properties ...................................................................................................12
7.2.2 Frame Rate........................................................................................................................13
7.2.3 Capture Menu ....................................................................................................................15
7.2.4 Video Recording.................................................................................................................18
7.3 Audio Tab ..............................................................................................................................20
7.4 Ecam Controls Tab.................................................................................................................22
7.4.1 AF Status...........................................................................................................................25
7.4.2 AF Trigger..........................................................................................................................26
7.4.3 Focus Mode .......................................................................................................................27
7.4.4 Update GPI Status .............................................................................................................30
7.4.5 Set / Clear GP0..................................................................................................................31
7.4.6 Sensor ID...........................................................................................................................32
7.4.7 Firmware Version ...............................................................................................................33
8Conclusion.............................................................................................................................34

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 3 of 34
1 Revision History
Rev No
Date
Major Changes
Edited By
1.0
August 17th, 2012
Initial Draft
Camera Dev. and QA
Team

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 4 of 34
2 Introduction
e-CAM51_USB is a plug and play UVC and UAC, auto focus USB camera module based on CMOS
Image sensor from OmniVision Inc. It is fully compliant with USB Video Class (UVC) 1.0 Standard, the
USB Audio Class 1.0 Standard. So video streaming through UVC and audio streaming through UAC is
possible without any special drivers on Operating Systems that have built-in support for these UVC and
UAC standards.
e-CAM51_USB has a built in microphone and an integrated ADC which can provide user with high quality
audio sampling functions. 16 bit Pulse code modulation is supported with sample rate of 48 KHz.
e-CAM51_USB has 3 General purpose Input pin and 1 General purpose Output pin through UVC
extension control.
The e-con guvcviewer or eCAMGUVCView is a simple GTK+ interface for capturing and viewing video
from the devices supported by the Linux UVC driver. This tool also supports extension unit control of e-
con‟s usb webcam products. The features provided in the application are as follows:
a) Enumerating and listing all USB video and audio devices connected.
b) Properties of audio capture devices (if any audio device is available).
c) Properties of video renderer.
d) Changing resolution and color space/compression for video stream(if different resolution are
supported by the device)
e) Currently configured values of preview which is being shown.
f) User can capture still images and set the path where still images will be saved.
g) Configure UVC Extension Control (if supported by device)
h) Displaying the average frame rate.
All the above listed properties can be configured by attractive and easy to use Graphical User Interface.
The application will run in Ubuntu 10.04, 10.10 and 11.04.
3 Scope
This is an e-CAM51_USB Linux Application User Manual document for Linux users of e-CAM51_USB
product. This document is intended for the users working on the UVC XU Control application for
e-CAM51_USB web cam.
4 Reference
1 ecamguvcview_Build_&_Install_Guide.pdf
2 e-CAM51_Linux_XU_Library_Specification_Manual.pdf
5 Identifying the Deliverables
The release package e-con_guvcviewer_app_package_xxxx.tar.gz is a compressed (i.e. tar.gz) file which
will provide the UVC XU control application binary , source and documents when uncompressed.
Use the command „tar‟ for uncompressing this release package
tar –xzvf e-con_guvcviewer_app_package_xxxx.tar.gz
After uncompressing this package, a directory is created in the name
e-con_guvcviewer_app_package_xxxx
The hierarchy of the e-con_guvcviewer_app_package_xxxx directory is as follows
e-con_guvcviewer_app_package_xxxx
|── binary
| ├── bin
| ├── install-sh

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 5 of 34
| └── share
|── doc
| ├── ecamguvcview_Build_&_Install_Guide.pdf
| ├── e-CAM51_Linux_App_User_Manual.pdf
| └── e-CAM51_Linux_XU_Library_Specification_Manual.pdf
|── README
|── src
└── ecamguvcview-src-1.4.1
6 Launching the Application
Connect the e-CAM51_USB camera to the Linux Development System.
Refer „ecamguvcview_Build_&_Install_Guide.pdf to install the application in the linux system.
Launch the ecamguvcview from the terminal as shown in the figure 1 below.
Figure 1 Terminal Window where application is launched
Some of the linux distribution needs the user to run the application in the super privilege mode.
Then add sudo before the application command.
To run in superuser privilege mode , run with sudo -i ecamguvcview. For more information, refer
README file in the delivery package.
When application is launched, control window and video display window will appear as shown in
figure 2 below.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 6 of 34
Figure 2 Initial Window Appearance when application is launched
7 Application Features
The features that are supported in the current version of ecamguvcview are briefly described here. The
features are categorized into 4 tab controls. They are
1. Image Controls tab
2. Video & Files tab
3. Audio tab
4. ecam controls tab
7.1 Image Control Tab
On selecting Image Controls Tab, control menu will display camera control settings. The user can adjust
the video preview settings in the Menu tab. Sliders whose labels are not grayed out can only be
configured.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 7 of 34
The user can move the slider and configure the preview settings according to their needs. The value
being set will be displayed in the text box based on the position of the slider marker. As soon as the slider
is moved to configure the values the preview‟s property will change at that instance.
Figure 3 Image control Tab Menu

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 8 of 34
For eg. Here we adjust the camera brightness slider, which results in increasing the brightness of the
preview is shown in the figure 4.
Figure 4 Adjusting Camera brightness
Note: In Exposure control, Manual (Exposure Absolute) and Aperture Priority Mode (Exposure Auto
Priority) only supported by e-CAM51_USB device. If user select other than this mode, setting control will
be failed and previous mode will retained in the camera.
7.2 Video and Files Tab
On selecting Video and Files Tab, video renderer properties will be displayed. The user can adjust the
video preview settings in the Menu tab. This tab will have device selection list, frame rate control,
resolution control color space control, image capture and video record controls.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 9 of 34
When user clicks on Device sub menu in Video and Files Tab all the video devices connected to the PC
will be enumerated and listed out.
Figure 5 Enumerated Device List
User can switch between the connected and enumerated video devices to see the images being
previewed from the selected device (as shown in figure 6). As soon as user selects a different device to
see its preview, start new dialog will appear (as shown in the figure 7). If user selects the restart button,
preview of the selected device will run.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 10 of 34
Figure 6. Switch Preview Device

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 11 of 34
Figure 7. Start new dialog

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 12 of 34
7.2.1 Video Capture Properties
The user can configure the output size (Resolution) and compression features (Camera Output) of stream
format. The available output size and color spaces will be listed in the combo box.
Figure 8 Supported video resolutions in Video tab page

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 13 of 34
Figure 9 Supported Video Colour space in Video tab Page
7.2.2 Frame Rate
Frame rate of the preview can be viewed by selecting the „show‟ check button in the Video & Files Tab.
After selecting Show button, frame will be displayed in the top of the preview window. Frame rate will be
affected by various environmental parameters.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 14 of 34
Figure 10 Select Show to display frame rate

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 15 of 34
Figure 11 Display of frame rate in the preview window
7.2.3 Capture Menu
The user can capture still image or record a video from the selected device in the Device Menu.
7.2.3.1 Still Image Capture
The user can capture the still image by selecting Cap.Image button in the bottom of the control panel. The
image will be saved in the home directory by default. The user can configure the folder where in to save
the images. The still image will be saved in the name as in the Image File edit box (as shown in the figure
13).

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 16 of 34
Figure 12 Capture still image

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 17 of 34
Figure 13 Still Image name
7.2.3.2 Still File Path
The user can set up the folder where the images captured will be saved. The user can browse to the
required directory so that in future images captured will be saved in that folder.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 18 of 34
Figure 14 Browse Folder dialog to set the Still Image Folder
7.2.4 Video Recording
The user can record a video by selecting Cap.Video button in the bottom of the control panel. The video
will be saved along with the audio (from the selected audio device in the audio tab) in the home directory
by default. The user can configure the folder where in to save the images. The video will be saved in the
name as in the Video File edit box (as shown in the figure 16).

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 19 of 34
Figure 15 Record video from the device
7.2.4.1 Video File Path
The user can set up the folder where the video recorded will be saved. The user can browse to the
required directory so that in future images captured will be saved in that folder.

ecamguvcview e-CAM51_USB Linux Application User Manual 17 August 2012
www.e-consystems.com | Subject to change without notice Page 20 of 34
Figure 16 Browse Folder dialog to set the recorded Video Folder
7.3 Audio Tab
On selecting the audio tab, audio properties menu will launch in which the user can configure the Audio
Input mixer properties. All the audio devices connected to the PC will be enumerated and listed out in the
Input Device. User can switch between the connected and enumerated audio devices to record the audio
sound from the selected device.