Difference between revisions of "Eyesis User Guide"

From ElphelWiki
Jump to: navigation, search
Line 30: Line 30:
 
==Operating==
 
==Operating==
 
===Output===
 
===Output===
 +
[[File:Eyesis frames.jpg|400px|thumb|Fig.4 Output images]]
 
* 3x HDDs, each containing *.mov files from 3x 3-sensor modules (a single HDD is connected to an individual camera module).
 
* 3x HDDs, each containing *.mov files from 3x 3-sensor modules (a single HDD is connected to an individual camera module).
 
* Each frame in a *.mov file is a combination of frames from 3 sensors glued vertically - triplet.
 
* Each frame in a *.mov file is a combination of frames from 3 sensors glued vertically - triplet.
Line 36: Line 37:
 
* The frames in *.movs are indexed.
 
* The frames in *.movs are indexed.
 
* A single image format is '''[http://wiki.elphel.com/index.php?title=JP4 JP4]''' - a raw format with a higher quality and frame rate against JPEG.
 
* A single image format is '''[http://wiki.elphel.com/index.php?title=JP4 JP4]''' - a raw format with a higher quality and frame rate against JPEG.
 +
* JP4 images can be converted to either TIFF or DNG format with [http://wiki.elphel.com/index.php?title=Movie2dng Movie2DNG] or [http://wiki.elphel.com/index.php?title=Elphel_Software_Kit_for_Ubuntu#ImageJ_and_Elphel_plugins_for_imageJ ImageJ Elphel plugins].
 
* Corresponding frames have the same time stamps generated by the 1st module.
 
* Corresponding frames have the same time stamps generated by the 1st module.
 
* The 1st module frames are geotagged.
 
* The 1st module frames are geotagged.
Line 46: Line 48:
 
Should be pre-installed on the laptop - these are HTML pages, PHP scripts and JavaScript files.
 
Should be pre-installed on the laptop - these are HTML pages, PHP scripts and JavaScript files.
 
  http://127.0.0.1/eyesis.html
 
  http://127.0.0.1/eyesis.html
 +
[http://wiki.elphel.com/index.php?title=Eyesis_gui More info]
 
====[http://wiki.elphel.com/index.php?title=Elphel_353_series_quick_start_guide#Network Camera Module Web UI]====
 
====[http://wiki.elphel.com/index.php?title=Elphel_353_series_quick_start_guide#Network Camera Module Web UI]====
 
Is used for color, white balance, autoexposure, frame rate and all the other settings - the default Eyesis settings are for a sunny day. The changes are applied only to an individual module - need to be repeated for the other 2 Eyesis modules.
 
Is used for color, white balance, autoexposure, frame rate and all the other settings - the default Eyesis settings are for a sunny day. The changes are applied only to an individual module - need to be repeated for the other 2 Eyesis modules.
Line 52: Line 55:
 
  http://192.168.0.222
 
  http://192.168.0.222
 
  http://192.168.0.223
 
  http://192.168.0.223
 +
[http://wiki.elphel.com/index.php?title=Elphel_353_series_quick_start_guide#Network More info]
 +
====Recording====
 +
Is controlled from '''http://127.0.0.1/eyesis.html'''
  
====Recording====
 
 
=====Recording Format=====
 
=====Recording Format=====
Combined tripple images in the [http://wiki.elphel.com/index.php?title=JP4 JP4] format are stored in *.mov files.  
+
Combined tripple images in the [http://wiki.elphel.com/index.php?title=JP4 JP4] format are stored in *.mov files. By default, a mov-file consists of 100x jp4 images.
  
''Note:'' On the previews JP4 looks gray colored and not really viewable. Before recording it is more convenient to use jpeg to adjust settings, then switch to JP4 format.
+
''Note:'' On the previews (where viewed as a jpeg, before processing) JP4 looks gray colored, cubic - not really viewable. Before recording it is more convenient to use jpeg to adjust settings, then switch to JP4 format (''A "force JP4 recording" checkbox enabled by default will be added to elphel-eyesis-gui v0.5'').
 
{|
 
{|
|[[File:Fruits jp4.jpg|200px|thumb|JP4 sample]]
+
|[[File:Jp4 jpeg sample.jpeg|600px|thumb|JP4 opened like JPEG]]
 
|}
 
|}
 +
=====Default settings=====
 +
* autoexposure is ON.
 +
* maximum autoexposure upper limit AUTO_EXP_MAX = 1000 (=1ms).
 +
''Comment: the exposure outdoors at daytime is usually 0.1 ms, indoors under good light conditions - 15-20ms.''
 +
* 2.5 FPS - TRIG_PERIOD=38400000 (parameter is set in 96MHz clock units)
  
 
=====Start=====
 
=====Start=====
RECORD - HDDs will be automatically mounted.
+
RECORD-button - HDDs will be automatically mounted. If the elphel-eyesis-gui is >0.4 then there's a force_jp4_recording enabled by default.
 
=====Stop=====
 
=====Stop=====
STOP - HDDs will be automatically unmounted.
+
STOP-button - HDDs will be automatically unmounted.
 
===Power OFF===
 
===Power OFF===
 
Once the camera is not recording and HDDs are unmounted it can be safely powered off.
 
Once the camera is not recording and HDDs are unmounted it can be safely powered off.

Revision as of 15:35, 3 December 2010

Camera

Outside

Fig.1 Eyesis camera
Fig.2 Interfaces

Power 110V/220V AC

A custom cable is provided with a connector mating part on. Goes to a wall plug / a car power converter.

USB (for GPS receiver)

An external Garmin GPS 18x is provided. Connector's mating part is shipped - should be put on the receiver's end.

Ethernet (control)

The connector's mating part is shipped and should be put on a network cable that will go to a PC or laptop. Eyesis modules have default addresses:

192.168.0.221 (master, gps connected, once online syncs the other 2 modules)
192.168.0.222
192.168.0.223

HDDs

Fig.3 HDDs

Not hot-pluggable. If a HDD is reinserted or inserted when the power is on the corresponding module should be rebooted (please read about reboot options). Each HDD is connected to a separate camera module.

Inside

Eyesis camera consists of 3 individual modules. Each module records data from 3 sensors organizing it vertically in triplets. There is a master module (192.168.0.221) that has GPS reciever connected, syncs the timestamps and triggers the other 2 modules. More information here.

Operating

Output

Fig.4 Output images
  • 3x HDDs, each containing *.mov files from 3x 3-sensor modules (a single HDD is connected to an individual camera module).
  • Each frame in a *.mov file is a combination of frames from 3 sensors glued vertically - triplet.
  • The modules are numbered - 1,2,3 - having individual ip addresses.
  • The sub images are [1.1, 1.2, 1.3], [2.1, 2.2, 2.3], [3.1, 3.2, 3.3]. 3.1 is the fisheye image.
  • The frames in *.movs are indexed.
  • A single image format is JP4 - a raw format with a higher quality and frame rate against JPEG.
  • JP4 images can be converted to either TIFF or DNG format with Movie2DNG or ImageJ Elphel plugins.
  • Corresponding frames have the same time stamps generated by the 1st module.
  • The 1st module frames are geotagged.

Power ON

Attach the HDDs and the GPS receiver then power ON. The boot process takes ~40-60 sec. After that the camera modules can be accessed through the network either all through the Eyesis GUI or individual camera Web UI.

Controls

Eyesis GUI

Contains recording, quality and some other settings. Displays recording, free space, file size status, also shows previews and histograms from all the modules. Should be pre-installed on the laptop - these are HTML pages, PHP scripts and JavaScript files.

http://127.0.0.1/eyesis.html

More info

Camera Module Web UI

Is used for color, white balance, autoexposure, frame rate and all the other settings - the default Eyesis settings are for a sunny day. The changes are applied only to an individual module - need to be repeated for the other 2 Eyesis modules. The control laptop should have address from the same subnetwork - 192.168.0.xxx - then Eyesis modules can be accessed:

http://192.168.0.221 (master module, gps connection, once online syncs the other 2 modules)
http://192.168.0.222
http://192.168.0.223

More info

Recording

Is controlled from http://127.0.0.1/eyesis.html

Recording Format

Combined tripple images in the JP4 format are stored in *.mov files. By default, a mov-file consists of 100x jp4 images.

Note: On the previews (where viewed as a jpeg, before processing) JP4 looks gray colored, cubic - not really viewable. Before recording it is more convenient to use jpeg to adjust settings, then switch to JP4 format (A "force JP4 recording" checkbox enabled by default will be added to elphel-eyesis-gui v0.5).

JP4 opened like JPEG
Default settings
  • autoexposure is ON.
  • maximum autoexposure upper limit AUTO_EXP_MAX = 1000 (=1ms).

Comment: the exposure outdoors at daytime is usually 0.1 ms, indoors under good light conditions - 15-20ms.

  • 2.5 FPS - TRIG_PERIOD=38400000 (parameter is set in 96MHz clock units)
Start

RECORD-button - HDDs will be automatically mounted. If the elphel-eyesis-gui is >0.4 then there's a force_jp4_recording enabled by default.

Stop

STOP-button - HDDs will be automatically unmounted.

Power OFF

Once the camera is not recording and HDDs are unmounted it can be safely powered off.

Pictures

Fig.1 Eyesis camera
Eyesis hdds.jpeg
Eyesis head bottom.jpeg
Eyesis pole cables.jpeg
Eyesis polebox.jpeg