DVS Sepia is an extension to the Sepia library to read events from a DVS 128.

install

clone

Within a Git repository, run the commands:

mkdir -p third_party
cd third_party
git submodule add https://github.com/neuromorphic-paris/dvs_sepia.git
git submodule update --init --recursive

dependencies

An application using DVS Sepia must link to usb-1.0.

Debian / Ubuntu

Open a terminal and run:

sudo apt install libusb-1.0 # cross-platform USB API

macOS

Open a terminal and run:

brew install libusb # cross-platform USB API

If the command is not found, you need to install Homebrew first with the command:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Windows

Download libusb 1.0 (Downloads > Latest Windows Binaries). After downloading and decompressing libusb-1.0.22.7z, run in the command prompt as administrator:

copy "%userprofile%\Downloads\MS32\dll\libusb-1.0.dll" "C:\Windows\SysWOW64"
copy "%userprofile%\Downloads\MS32\dll\libusb-1.0.lib" "C:\Windows\SysWOW64"
copy "%userprofile%\Downloads\MS32\dll\libusb-1.0.pdb" "C:\Windows\SysWOW64"
mkdir C:\Include\libusb-1.0
copy "%userprofile%\Downloads\include\libusb-1.0\libusb.h" "C:\Include\libusb-1.0"

contribute

development dependencies

Debian / Ubuntu

Open a terminal and run:

sudo apt install premake4 # cross-platform build configuration
sudo apt install clang-format # formatting tool

macOS

Open a terminal and run:

brew install premake # cross-platform build configuration
brew install clang-format # formatting tool

test

To test the library, run from the dvs_sepia directory:

premake4 gmake
cd build
make
cd release
./dvs_sepia

After changing the code, format the source files by running from the dvs_sepia directory:

clang-format -i source/dvs_sepia.hpp
clang-format -i test/dvs_sepia.cpp

license

See the LICENSE file for license rights and limitations (GNU GPLv3).