e-cam51_usb Linux Application User Manual

Transcription

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

2 Contents 1 Revision History Introduction Scope Reference Identifying the Deliverables Launching the Application Application Features Image Control Tab Video and Files Tab Video Capture Properties Frame Rate Capture Menu Video Recording Audio Tab Ecam Controls Tab AF Status AF Trigger Focus Mode Update GPI Status Set / Clear GP Sensor ID Firmware Version Conclusion Subject to change without notice Page 2 of 34

3 1 Revision History Rev No Date Major Changes Edited By 1.0 August 17 th, 2012 Initial Draft Camera Dev. and QA Team Subject to change without notice Page 3 of 34

4 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, and 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 Subject to change without notice Page 4 of 34

5 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 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. Subject to change without notice Page 5 of 34

6 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. Subject to change without notice Page 6 of 34

7 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 Subject to change without notice Page 7 of 34

8 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. Subject to change without notice Page 8 of 34

9 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. Subject to change without notice Page 9 of 34

10 Figure 6. Switch Preview Device Subject to change without notice Page 10 of 34

11 Figure 7. Start new dialog Subject to change without notice Page 11 of 34

12 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 Subject to change without notice Page 12 of 34

13 Figure 9 Supported Video Colour space in Video tab Page 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. Subject to change without notice Page 13 of 34

14 Figure 10 Select Show to display frame rate Subject to change without notice Page 14 of 34

15 Figure 11 Display of frame rate in the preview window Capture Menu The user can capture still image or record a video from the selected device in the Device Menu 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). Subject to change without notice Page 15 of 34

16 Figure 12 Capture still image Subject to change without notice Page 16 of 34

17 Figure 13 Still Image name 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. Subject to change without notice Page 17 of 34

18 Figure 14 Browse Folder dialog to set the Still Image Folder 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). Subject to change without notice Page 18 of 34

19 Figure 15 Record video from the device 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. Subject to change without notice Page 19 of 34

20 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. Subject to change without notice Page 20 of 34

21 Figure 17 List of Audio devices Subject to change without notice Page 21 of 34

22 Figure 18 Audio device Properties 7.4 Ecam Controls Tab On selecting the ecam controls tab, the XU control will appears, if the device supports extension unit. The ecam controls has the features mentioned as below Auto Focus Status Auto Focus Trigger Focus Mode Update GPI Status Set / Clear GPO s Get Sensor ID Get Firmware Version Subject to change without notice Page 22 of 34

23 Figure 19 ecam Controls If non-econ device or e-con usb camera without UVC XU control is selected for preview in the Video & Files Tab(as shown in the figure ), ecam controls tab items will be disabled and greyed out (as shown in the figure. Subject to change without notice Page 23 of 34

24 Figure 20 Selection of non-econ device Subject to change without notice Page 24 of 34

25 Figure 21 UVC Extension Controls disabled for non-econ device AF Status The AF Status button shows the current auto focus status. The focus status as mentioned below. AF Status is Manual AF Status is Single Trigger Focusing AF Status is Single Trigger Focused Subject to change without notice Page 25 of 34

26 Figure 22 AF Status Dialog box AF Trigger The AF Trigger button will perform the Single Trigger Auto Focus. Subject to change without notice Page 26 of 34

27 Figure 23 AF Trigger Button Focus Mode The Focus Mode button opens the Focus Mode Dialog to perform Auto Focus and Manual Focus. It contains two Radio buttons. 1) Auto Focus (Single Trigger) 2) Manual Focus Auto focus Radio button is selected by default. Subject to change without notice Page 27 of 34

28 Figure 24 Focus Mode Dialog On selecting the Auto Focus radio button the slider control and edit box will be disabled. The controls will be enabled once the manual focus radio button is selected Auto Focus Select the Auto Focus radio button and click the Ok button to set the Auto Focus mode. Subject to change without notice Page 28 of 34

29 Figure 25 Auto Focus Dialog Manual Focus Select manual focus radio button to enable the Slider control and edit box. Slide the slider to set the manual focus. The slider position (Manual Focus Position) displays in the edit box. The Manual focus will be set after leave the slider. Subject to change without notice Page 29 of 34

30 Figure 26 Manual Focus Dialog Update GPI Status Click Update GPI Status button to know the status of GPI's. There are three GPI s: DI0, TRIGGER and F/M. The GPI status has shown as LO in red color when it is Low and HI in green color when it is high. Subject to change without notice Page 30 of 34

31 Figure 27 Update GPI Status Set / Clear GP0 The Set will set the GPO to High and Clear button will set the GPO to Low. Subject to change without notice Page 31 of 34

32 Figure 28 GPI and GPO Status Sensor ID The Sensor ID button will display the current sensor id details. Subject to change without notice Page 32 of 34

33 Figure 29 Sensor Status Firmware Version The Firmware Version button will display the current firmware version details. Subject to change without notice Page 33 of 34

34 Figure 30 Firmware Version 8 Conclusion This document provides detail explanation on various features and options available in ecamguvcview application. Subject to change without notice Page 34 of 34