Difference between revisions of "Using the cameras"
|Line 110:||Line 110:|
''Free Software and Open Hardware. Elphel, Inc., 2005''
''Free Software and Open Hardware. Elphel, Inc., 2005''
Revision as of 15:25, 11 November 2005
Elphel network cameras — complex devices in whose development advanced technologies and non-standard program decisions are used. We constantly improve our products so that users can use the cameras with the least expenses of time and effort. In this section of Elphel Network Cameras Manual you can find detailed information about using Elphel cameras.
The complete camera delivery set includes the actual network camera Elphel-313/323/333, and Live-CD or Live-DVD with special edition of the Debian-based GNU/Linux operating system Knoppix, complete with all the necessary software for the camera.
Also the complete delivery set can include lenses, an external power unit and connection cables for an additional payment.
On the back side of the camera case are located a socket for connection of a network cable, the switch-on push button for the software reloading mode, and camera's model number mark. We constantly improve the products, therefore the amount and appearance of the elements placed on the back panel can change.
On the bottom side of the camera case is the standard carving socket for installation of the camera on a support.
Main Control Page
On the top part of the page you should see a preview image. It is always 640x512, 800x600 or 512x386 pixels (1/2 or 1/4 of camera resolution depending on the sensor) and does not change with the selected decimation and window of interest (red rectangle over the image).
Below the preview image there are camera controls:
In the Window section there are 2 buttons at the bottom-right corner of window. You may specify window of interest (WOI) by dragging these buttons with the mouse. You may also change it numerically by entering data to W(idth), H(eight), L(eft) and T(op) input fields below. That numbers are rounded according to the selected sensor decimation and to use integer multiples of 16x16 pixels MCUs in JPEG compression.
In the Exposure field there is an input field to specify frame exposure time (in ms) - it is possible to specify fractions. You may change this parameter by dragging the slider with the mouse.
Saturation section allows adjusting contrast saturation.
Gamma field controls contrast by adjusting intensity conversion, gamma=1.0 corresponds to linear response (high contrast). Values less than 1 increase input dynamic range by expanding low intensity values (low contrast). You may change this parameter by dragging the slider with the mouse.
JPEG Quality sets standard JPEG compression quality. The higher the quality the bigger the resulting file. It does not change the camera frame rate.
White balance section is a drop-down menu containing four static parameters: Sunlight, Cloudy, Incandenscent and Fluorescent. You can choose one of these parameters to achieve the highest quality image depending on the lighting conditions.
In the Image size drop-down menu you may choose the static window size.
In the Resolution section there are radiobuttons to select sensor decimation (resolution). Selecting 1 uses all pixels in WOI, 1/2 - every other one (in both directions) - 1/4 total, 1/4 - 1 in 4 in each direction - 1/16 total and so on. Both WOI and decimation control the actual sensor operation that runs from the 20 MHz pixel clock, so the smaller the total number of pixels the higher the frame rate (it is actually slower as the sensor has some "margins" around the active area).
Below are 3 buttons Preview, Reset and Apply. Preview button refreshes the image in the top portion on a page (ignoring selected WOI and decimation), Reset button returns the initial adjustment parameters. The Apply button is used to accept the new changes.
Also there are two links after Photo: New contains a link to a camera CGI program that has all acquisition parameters attached. You may just click it to open the image in a new window or right-click it and select "Save link target as..." (or equivalent) to save the image on your computer. The second link Last points to the last image already in the camera memory, you may use it to save the previously aquired image to your hard drive.
Video Controls in this section allow users to record a video clip in the camera memory and send it over the LAN/Internet as a Quicktime video file. All settings for the image size, resolution, compression quality, analog gains and exposure are the same as for still images described above, and that link adds extra parameters - Frame Rate and Time Scale. The first of them set desired frame rate (leave blank or set to 0 for the maximal rate), the second field sets how much the playback time is longer than the acquisition one. I.e. setting of "10" makes the clip play 10 times slower that it was shot.
Total size of the clip (6-7MB) is determined by a camera internal buffer used for compressed images storage and the total number of frames as the frame headers are attached during the clip output and are not stored in the buffer. There are 2 ways to shoot a clip (usual duration 3-5 sec, depending on compression quality). First is to press Start stream button, wait for the event to occur and then press Acquire. In this mode after Start stream the camera continuously writes to the buffer, overwriting footage when all the available space is used. Pressing the Stop stream button ends data saving and so the buffer contains the last data recorded. Another way is to press Acquire before the event. In that mode the clip recording starts after the trigger and stops when the whole buffer is full.
There are additional controls to preview a videoclip from the camera memory. Frame number 1 is the first one, 2 - second, etc. Frame number 0 is the last one in the clip, -1 - previous before last, etc. Any image acquisition (including Preview) erases the stored clip and makes it one frame long.
Clicking on the Video Clip link opens the clip in the Apple QuickTime ™ (or compatible) player plugin (if installed), you may also use this link to save the clip as a file on your computer.
Advanced Panel tab opens additional adjustment parameters of the image. In this section you may specify more exact adjustments of color levels of the image.
Gains section control the sensor analog gain settings. R, G and B input fields control color component gains. Using high gain settings increases sensor noise but is required to view fast events with 1ms exposure time with the lighting used in the current setup.
R-Y specifies color saturation for red color component.
B-Y specifies color saturation for blue color component.
B specifies color saturation for blue color component.
W specifies level saturation for white color component.
The Flip-X button allows to turn the image horizontally.
The Flip-Y button allows to turn the image vertically.
NOTE: Some parameters (e.g. window size) cannot be changed without stopping the acquisition/compression.
Technical Information for the Elphel-333
The default IP address of the camera is 192.168.0.9 netmask 255.255.255.0
You should be able to ping the camera from another machine on the same subnet.
By default, the following TCP ports are open:
You can log in to the camera via telnet on TCP port 23
User: root Password: pass
Free Software and Open Hardware. Elphel, Inc., 2005