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

From ElphelWiki
Jump to: navigation, search
Line 195: Line 195:
===Error 5 (frame buffer overflow)===
===Error 5 (frame buffer overflow)===
* Buffer overflow counter -
* Frame buffer overflow counter (<font color='red'>'''dropped frames'''</font>).
* Buffer overflow = <font color='red'>'''dropped frames'''</font>.
* Possible causes:
* Possible causes:
** FPS and compression quality (combined) set too high: 5fps + 100%
** FPS and compression quality (combined) set too high: 5fps + 100%

Revision as of 12:25, 18 April 2017

Download & Install

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


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/eyesisgui"
2b. Or copy all the files to /var/www/eyesisgui.
Note: "/var/www" is the (apache2) web server's document root folder.

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


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

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

GUI access

Network Setup

IP address: (example)

Note: Eyesis4Pi 393 default IP addresses:



Setting recording parameters: camera settings

  • Settings -> Camera-tab
Trigger period,ms  - 1/FPS, 200 = 5fps, 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
Normal REC - record to a file system
Fast REC - record to a raw partition (default mode)
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
Reboot - system reboot
Eyesis4pi393gui tab camera.png
Eyesis4pi393gui tab other.png


  • Record-button to start recording


  • Stop-button for stop.


Error 5 (frame buffer overflow)

  • Frame buffer overflow counter (dropped frames).
  • Possible causes:
    • 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