NRVCORP CIS_DVS Host Application Documentation

The CIS_DVS host code provides concurrent data streaming from both CIS and DVS sensors through PCIe. Input frames can be displayed concurrently on OpenCV windows, along with each of their FPS. Utilizing our novel algorithm, ROI can be drawn around events detected by the DVS, and used to crop image input from the CIS.

Actions

Run ./main with the following options :

Option	Streaming Mode
-c	CIS streaming mode
-d	DVS streaming mode
-s	CIS-DVS concurrent mode
-w	Save DVS frame data
-r	DVS ROI mode
-b	CIS bounding box mode
-o	CIS-DVS calibration mode
-f	DVS FPS mode
-p	CIS and DVS FPS mode
-v	DVS raw data to .avi
-g	DVS raw data to .pngs

• Save DVS frame data
  Write DVS raw data to ./bin_files. The directory CIS_DVS/bin_files must exist.
  
• DVS ROI mode
  Displays a bounding box on top of DVS streaming mode.
  
• CIS bounding box mode
  Displays a bounding box on DVS and CIS streaming windows. Calibration required using ./main -o beforehand.
  
• CIS-DVS calibration mode
  Displays a red grid to calibrate between CIS and DVS viewpoints. Modify config.hpp according to console messages.
  
• DVS FPS mode
  Prints DVS FPS to the console (no error-checking functionality)
  
• CIS and DVS FPS mode
  Displays CIS and DVS video streams with their FPS. Also runs error checks. DVS is downsampled, so the screen might appear laggy or shaded.
  
• DVS raw data to .avi
  Converts the bin file obtained from ./main -w into .avi format. Through iostream, typing the path to the .bin file and the path to the resulting .avi file is required.
• DVS raw data to .pngs
  Converts the bin file obtained from ./main -w into a series of consecutive png images. Through iostream, typing the path to the .bin file and the path to the folder containing png files is required.

Execution Steps

1) Open the terminal in root permission by running sudo -i.

2) Navigate to the 3.CIS_DVS/host directory.

3) Run make all.

4) Run ./main with the above options.