Difference between revisions of "Eyesis4Pi 393 User Guide - Recording"

From ElphelWiki
Jump to: navigation, search
(Stop)
(Description)
 
(42 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Download & Install==
+
== Download & Install GUI==
 
Install GUI to the device that will be used for recording. There are several ways to install it:
 
Install GUI to the device that will be used for recording. There are several ways to install it:
  
 
Terminal:
 
Terminal:
  cd <any-path>
+
  <font size='2'>cd <any-path>
 
  git clone https://git.elphel.com/Elphel/eyesis4pi-393-gui.git
 
  git clone https://git.elphel.com/Elphel/eyesis4pi-393-gui.git
  git pull (repeat any time to get the latest)
+
  git pull (repeat any time to get the latest)</font>
https://git.elphel.com:
 
https://git.elphel.com/Elphel/eyesis4pi-393-gui/tree/master
 
  
 
Follow the instructions in INSTALL.txt:
 
Follow the instructions in INSTALL.txt:
  1. (For Kubuntu 16.04) Install the following packages, terminal:
+
  <font size='2'>1. (For Kubuntu 16.04) Install the following packages, terminal:
 
   sudo apt-get install apache2 php5.6 php5.6-curl
 
   sudo apt-get install apache2 php5.6 php5.6-curl
 
    
 
    
 
  2. Make the src folder visible to the web server:
 
  2. Make the src folder visible to the web server:
  2a. Create a link, terminal: "sudo ln -sf <path-to-eyesis4pi_gui-folder> /var/www/eyesisgui"
+
  2a. Create a link, terminal: "sudo ln -sf <path-to-eyesis4pi_gui-folder> /var/www/html/eyesisgui"
 
  2b. Or copy all the files to /var/www/eyesisgui.
 
  2b. Or copy all the files to /var/www/eyesisgui.
  Note: "/var/www" is the (apache2) web server's document root folder.
+
  Note: ''/var/www/html'' is apache2 document root folder.
 
   
 
   
  (for recording to the device over network only)
+
  (for recording over network only to host device)
 
  2c. Make the footage root folder "/data/footage" writable for everyone.
 
  2c. Make the footage root folder "/data/footage" writable for everyone.
 
+
 +
3. Make editable ''eyesis4pi-393-gui/settings.xml'' for the webserver
 +
    $ chmod 777 settings.xml
 +
    This file restores the settings from previous session.</font>
  
 
== Equipment/Package ==
 
== Equipment/Package ==
Line 35: Line 36:
 
* Connect all cables - power, network, eSATA.
 
* Connect all cables - power, network, eSATA.
 
* Power on: switch, SSD enclosure, Eyesis4Pi393. Boot takes about 1 min.
 
* Power on: switch, SSD enclosure, Eyesis4Pi393. Boot takes about 1 min.
* Setup PC IP (can be done beforehand).
+
* Setup PC IP (can be done beforehand, see [[Eyesis4Pi_393_User_Guide_-_Recording#Network_Setup|Network Setup ]] below)
 
* Refresh GUI after camera boots
 
* Refresh GUI after camera boots
  Note 1: If GUI is refreshed before subcamera has mounted SSD it will not display SSD free space. Refresh in a few moments or until SSD gets mounted.
+
  http://127.0.0.1/eyesisgui
 +
 
 +
<font size='2'>Note: If GUI is refreshed before subcamera has mounted SSD it will not display SSD free space. Refresh in a few moments or until SSD gets mounted.
 +
Note: Each subcamera's drive has 2 partitions:
 +
      * /dev/sda1 - ext4 file system - used by the logger on the 1st subcamera (192.168.0.161), and stored write info of the second partition
 +
      * /dev/sda2 - no file system - images are written to the 'raw' partition for better speed. They are extracted later, using ''dd'' mostly
 +
      In the GUI under '''SSD free space''':
 +
          * the 1st number - /dev/sda1
 +
          * the 2nd number - /dev/sda2</font>
  
 
<b>
 
<b>
  Important Notice: Use a fan to cool the camera's pole when shooting indoors.
+
  Important Note: Use a fan to cool the camera's pole when shooting indoors.
 
</b>
 
</b>
 
{|
 
{|
 
|[[File:Eyesis4pi393 gui access.png|thumb|500px|GUI access]]
 
|[[File:Eyesis4pi393 gui access.png|thumb|500px|GUI access]]
 +
|valign='top'|[[File:Eyesis4pi393gui preview.png|thumb|560px|Live preview: opens in a new tab, can be refreshed during recording but a bit slow because of format conversion]]
 
|}
 
|}
  
Line 51: Line 61:
  
 
*Connect the PC to the Gigabit port of the switch.  
 
*Connect the PC to the Gigabit port of the switch.  
*Configure the PC's network settings ([http://linuxlibrary.org/kubuntu-network-configuration/ Kubuntu Network Configuration Guide]):
+
*Configure the PC's network settings:
  
 
<font size="2"></font>
 
<font size="2"></font>
Line 60: Line 70:
 
</font>
 
</font>
  
<font size="2"></font> '''''Note:''' Eyesis4Pi 393 default IP addresses: 192.168.0.161-163'' <br><br>  
+
<font size="2"></font> '''''Note:''' Eyesis4Pi 393 default IP addresses are 192.168.0.161-163'' <br><br>
  
 
== Tests ==
 
== Tests ==
  
...
+
* http://127.0.0.1/eyesis4pi_gui_393/ > Test-tab > '''Run System Tests''' button
 
 
<!--
 
== System Tests ==
 
 
 
*Open the GUI page (the address is bookmarked in the Firefox and in the Chrome). The GUI address is:
 
 
 
<font size="2"></font>
 
 
 
<font size="2">
 
http://127.0.0.1/eyesisgui/index.html
 
</font>
 
 
 
<font size="2"></font>  
 
  
 
{|
 
{|
|- valign="top"
+
|[[File:Eyesis4pi_393_gui_tests.png|thumb|300px|Test results output]]
| [[Image:Recording gui settings.jpeg|thumb|500px]]
 
 
|}
 
|}
  
*Go to the "Settings" -&gt; "Test"-tab:
+
<!--
 
 
*Follow the '''Open the test page'''-link, the tests are:
 
 
 
<font size="2"></font>
 
 
 
<font size="2">
 
1. All the modules are online.
 
2. GPS locked
 
3. IMU detected
 
4. Internal CF cards are present
 
</font>
 
  
 
<font size="2"></font>  
 
<font size="2"></font>  
Line 145: Line 130:
  
 
== Setting recording parameters: camera settings ==
 
== Setting recording parameters: camera settings ==
 
+
===Description===
 
* '''Settings''' -&gt; '''Camera'''-tab
 
* '''Settings''' -&gt; '''Camera'''-tab
  
  '''Trigger period,ms ''' - 1/FPS, 200 = 5fps, 250 = 4fps, 500 = 2fps, 1000 = 1fps...
+
  <font size='2'>'''Trigger period,ms ''' - 1/FPS, 250 = 4fps, 500 = 2fps, 1000 = 1fps...
 
  '''HDRVexpos''' - not used.
 
  '''HDRVexpos''' - not used.
 
  '''Manual Exposure''' - used when auto exposure is off.
 
  '''Manual Exposure''' - used when auto exposure is off.
Line 156: Line 141:
 
  '''AutoExp frame ahead''' - number of previous frames used for calculatin the current frame exposure.
 
  '''AutoExp frame ahead''' - number of previous frames used for calculatin the current frame exposure.
 
  '''HDR mode''' - not used
 
  '''HDR mode''' - not used
  '''Compression quality''' - JP4/JPEG compression quality.
+
  '''Compression quality''' - JP4/JPEG compression quality.</font>
  
 
* '''Settings''' -&gt; '''Other'''-tab
 
* '''Settings''' -&gt; '''Other'''-tab
  
  Displays temperatures
+
  <font size='2'>Displays temperatures
  '''Normal REC''' - record to a file system
+
  '''External''' - switch to external SSD (wait ~30s then click '''Refresh''' button and refresh the whole page - note the '''free space''' data)
  '''Fast REC''' - record to a raw partition (default mode)
+
  '''Internal''' - switch to internal SSD (wait ~30s then click '''Refresh''' button and refresh the whole page - note the '''free space''' data)
  '''Reset Fast REC''' - when Fast REC is enabled the system remembers write pointers, '''reset''' - sets the write pointer back to the beginning of the raw partiiton
+
'''Refresh''' - refreshes the recorder program write pointer (raw partition) - is needed mostly if the GUI was loaded before SSD was detected.
  '''Reboot''' - system reboot
+
  '''Reset''' - the system stores write pointer on an SSD, '''reset''' sets the write pointer back to the beginning of the raw partiiton
 +
  '''Reboot''' - system reboot</font>
  
 
{|
 
{|
Line 171: Line 157:
 
| [[File:Eyesis4pi393gui tab other.png|thumb|500px]]
 
| [[File:Eyesis4pi393gui tab other.png|thumb|500px]]
 
|}
 
|}
 +
 +
===Minimum setup example===
 +
# '''Trigger period''' = '''250''' - hit '''APPLY''' (below '''AutoExp frame ahead''')
 +
# '''Compression quality''' = '''96''' - edit or use +/-, the value is applied on change
 +
# Start recording
  
 
== Start ==
 
== Start ==
Line 193: Line 184:
  
 
== Troubleshooting ==
 
== Troubleshooting ==
 +
 +
===Error 5 (frame buffer overflow)===
 +
* Frame buffer overflow counter ( = <font color='red'>'''dropped frames'''</font>).
 +
* Possible causes:
 +
** Not enough bandwidth - FPS and compression quality (combined) set too high: 5fps + 100%
 +
** SSD write speed is slowed
 +
{|
 +
|[[File:Eyesis4pi 393 gui error5.png|thumb|400px|Buffer overflow errors]]
 +
|}
 +
* Errors are displayed as '''err5(N)''' against each buffer, where N is a cumulative number of errors
 +
  
 
<!--
 
<!--
Line 216: Line 218:
  
 
*[[Eyesis4Pi_393|Eyesis4Pi 393 Main Article]]  
 
*[[Eyesis4Pi_393|Eyesis4Pi 393 Main Article]]  
*[[Eyesis4Pi workflow|Workflow]]  
+
*[[Eyesis4Pi_393_workflow|Workflow]]
*[[Eyesis4Pi User Guide|User Guide - Recording]]  
+
*[[Eyesis4Pi_393_User_Guide_-_Recording|User Guide: Recording]]
*[[Eyesis4Pi Footage Procedures page|User Guide - Post-Processing: Footage Procedures]]  
+
*[[Eyesis4Pi_393_User_Guide_-_SSDs|User Guide: SSD maintenance (partition, format, check)]]
 +
*[[Eyesis4Pi_393_Downloading_footage|User Guide: Downloading footage]]
 +
*[[Eyesis4Pi_393_Footage_Procedures_page|User Guide: Post-Processing selected few panoramas]]
 
*[[Eyesis4pi Post-Processing|User Guide - Post-processing: ImageJ]]  
 
*[[Eyesis4pi Post-Processing|User Guide - Post-processing: ImageJ]]  
 +
<!--
 
*[[Eyesis4Pi data structure|Data Structure Description]]  
 
*[[Eyesis4Pi data structure|Data Structure Description]]  
 
*[[Eyesis4Pi Calibration|Calibration Process]]
 
*[[Eyesis4Pi Calibration|Calibration Process]]
[[Category:Eyesis4Pi]]
+
-->
 +
[[Category:Eyesis4Pi393]]
 
[[Category:User Guide]]
 
[[Category:User Guide]]

Latest revision as of 10:54, 3 May 2017

Download & Install GUI

Install GUI to the device that will be used for recording. There are several ways to install it:

Terminal:

cd <any-path>
git clone https://git.elphel.com/Elphel/eyesis4pi-393-gui.git
git pull (repeat any time to get the latest)

Follow the instructions in INSTALL.txt:

1. (For Kubuntu 16.04) Install the following packages, terminal:
 sudo apt-get install apache2 php5.6 php5.6-curl
 
2. Make the src folder visible to the web server:
2a. Create a link, terminal: "sudo ln -sf <path-to-eyesis4pi_gui-folder> /var/www/html/eyesisgui"
2b. Or copy all the files to /var/www/eyesisgui.
Note: /var/www/html is apache2 document root folder.

(for recording over network only to host device)
2c. Make the footage root folder "/data/footage" writable for everyone.

3. Make editable eyesis4pi-393-gui/settings.xml for the webserver
   $ chmod 777 settings.xml
   This file restores the settings from previous session.

Equipment/Package

  • Eyesis4Pi 393
  • External SSD enclosure
  • Switch
  • PC / Laptop



Power On

  • Connect all cables - power, network, eSATA.
  • Power on: switch, SSD enclosure, Eyesis4Pi393. Boot takes about 1 min.
  • Setup PC IP (can be done beforehand, see Network Setup below)
  • Refresh GUI after camera boots
http://127.0.0.1/eyesisgui
Note: If GUI is refreshed before subcamera has mounted SSD it will not display SSD free space. Refresh in a few moments or until SSD gets mounted.
Note: Each subcamera's drive has 2 partitions:
      * /dev/sda1 - ext4 file system - used by the logger on the 1st subcamera (192.168.0.161), and stored write info of the second partition
      * /dev/sda2 - no file system - images are written to the 'raw' partition for better speed. They are extracted later, using dd mostly
      In the GUI under SSD free space:
          * the 1st number - /dev/sda1
          * the 2nd number - /dev/sda2

Important Note: Use a fan to cool the camera's pole when shooting indoors.

GUI access
Live preview: opens in a new tab, can be refreshed during recording but a bit slow because of format conversion



Network Setup

  • Connect the PC to the Gigabit port of the switch.
  • Configure the PC's network settings:

IP address: 192.168.0.68 (example)
Mask:       255.255.255.0

Note: Eyesis4Pi 393 default IP addresses are 192.168.0.161-163

Tests

Test results output


Setting recording parameters: camera settings

Description

  • Settings -> Camera-tab
Trigger period,ms  - 1/FPS, 250 = 4fps, 500 = 2fps, 1000 = 1fps...
HDRVexpos - not used.
Manual Exposure - used when auto exposure is off.
AutoExp max, ms - the autoexposure value limit.
AutoExp level - value of a pixel at which the autoexposure works.
AutoExp fracpix - number of pixels below the Autoexp level.
AutoExp frame ahead - number of previous frames used for calculatin the current frame exposure.
HDR mode - not used
Compression quality - JP4/JPEG compression quality.
  • Settings -> Other-tab
Displays temperatures
External - switch to external SSD (wait ~30s then click Refresh button and refresh the whole page - note the free space data)
Internal - switch to internal SSD (wait ~30s then click Refresh button and refresh the whole page - note the free space data)
Refresh - refreshes the recorder program write pointer (raw partition) - is needed mostly if the GUI was loaded before SSD was detected.
Reset - the system stores write pointer on an SSD, reset sets the write pointer back to the beginning of the raw partiiton
Reboot - system reboot
Eyesis4pi393gui tab camera.png
Eyesis4pi393gui tab other.png

Minimum setup example

  1. Trigger period = 250 - hit APPLY (below AutoExp frame ahead)
  2. Compression quality = 96 - edit or use +/-, the value is applied on change
  3. Start recording

Start

  • Record-button to start recording
Rec.jpeg

Stop

  • Stop-button for stop.
Rec.jpeg


Troubleshooting

Error 5 (frame buffer overflow)

  • Frame buffer overflow counter ( = dropped frames).
  • Possible causes:
    • Not enough bandwidth - FPS and compression quality (combined) set too high: 5fps + 100%
    • SSD write speed is slowed
Buffer overflow errors
  • Errors are displayed as err5(N) against each buffer, where N is a cumulative number of errors


Links