Difference between revisions of "Eyesis User Guide"

From ElphelWiki
Jump to: navigation, search
Line 43: Line 43:
 
===Power ON===
 
===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 [http://wiki.elphel.com/index.php?title=Eyesis_gui Eyesis GUI] or individual camera [http://wiki.elphel.com/index.php?title=Elphel_353_series_quick_start_guide#Network Web UI].
 
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 [http://wiki.elphel.com/index.php?title=Eyesis_gui Eyesis GUI] or individual camera [http://wiki.elphel.com/index.php?title=Elphel_353_series_quick_start_guide#Network Web UI].
 +
====Default settings====
 +
* autoexposure is ON (parameter AUTOEXP_ON=1).
 +
* maximum autoexposure upper limit parameter 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 measured in 96MHz clock units)
 +
* Compression Quality 95% (parameter QUALITY=95)
 +
 +
====Tests====
 +
=====check images=====
 +
[[Image:Color pattern 9.jpeg|300px|thumb|Fig.5 Color bars test pattern]]
 +
1. Go to the Other tab - switch on the Color bars pattern.
 +
2. Press Get Previews button (it is ok if the images are cut from the bottom - it's the browser problem - just press the button again)
 +
3. turn off the color pattern mode.
 +
=====check HDDs=====
 +
* When a HDD is attached correctly a blue led is on.
 +
* Make a test <font color=red>RECORD/STOP</font> to check if all HDDs are present (the default RECORD delay is set to 5 seconds, so wait until camogm state becomes "running" then issue a STOP)
 +
 
===Controls===
 
===Controls===
 
====[http://wiki.elphel.com/index.php?title=Eyesis_gui Eyesis GUI]====
 
====[http://wiki.elphel.com/index.php?title=Eyesis_gui 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.
+
Controls 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.
 
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=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.
+
Controls 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:
 
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.221 (master module, gps connection, once online syncs the other 2 modules)
Line 64: Line 81:
 
''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'').
 
''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:Jp4 jpeg sample.jpeg|600px|thumb|JP4 opened like JPEG]]
+
|[[File:Jp4 jpeg sample.jpeg|600px|thumb|Fig.6 JP4 opened like JPEG]]
 
|}
 
|}
=====Default settings=====
 
* autoexposure is ON (parameter AUTOEXP_ON=1).
 
* maximum autoexposure upper limit parameter 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 measured in 96MHz clock units)
 
* Compression Quality 95% (parameter QUALITY=95)
 
  
 
=====Start=====
 
=====Start=====

Revision as of 16: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.

Default settings

  • autoexposure is ON (parameter AUTOEXP_ON=1).
  • maximum autoexposure upper limit parameter 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 measured in 96MHz clock units)
  • Compression Quality 95% (parameter QUALITY=95)

Tests

check images
Fig.5 Color bars test pattern
1. Go to the Other tab - switch on the Color bars pattern.
2. Press Get Previews button (it is ok if the images are cut from the bottom - it's the browser problem - just press the button again)
3. turn off the color pattern mode.
check HDDs
  • When a HDD is attached correctly a blue led is on.
  • Make a test RECORD/STOP to check if all HDDs are present (the default RECORD delay is set to 5 seconds, so wait until camogm state becomes "running" then issue a STOP)

Controls

Eyesis GUI

Controls 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

Controls 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).

Fig.6 JP4 opened like JPEG
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