Commit ef960429 by Lars Kosmann

Added README

parent f6941001
# IMGSEE
OpenVX based image scaling on TX2 harware
The SEE is developed with and for JetPack 3.2+ on the Nvidia TX2 SoC. It may also work on TX1 and other tegra accelerated SoCs, but not testest yet.
# Deployment
[Ansible Deployment](http://gitlab.m2dc.eu/middleware/m2dc-ansible)
# Quickstart
On the TX2 the current setup requires Ubuntu 16:04 and Jetpack 3.2 installed. The build process requires activemq-cpp 3.9.x or newer to be installed (which will be build in this process)
Install dependencies:
```
sudo apt-get install build-essential cmake autogen uuid-dev libapr1 libapr1-dev openssl libssl-dev libspdlog-dev libglfw3 libglfw3-dev
```
Checkout and build ActiveMQ from repositroy:
```
git clone https://git-wip-us.apache.org/repos/asf/activemq-cpp.git
cd /activemq-cpp/activemq-cpp
./autogen.sh && ./configure && make
make install
```
After the dependencies are installed the SEE can be build (git submodules required):
```
git clone ssh://git@gitlab.m2dc.eu:15022/lars.kosmann/imgsee.git
cd imgsee
git submodule init
git submodule update
mkdir jetsonsee/build
cd jetsonsee/build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
```
After successfull build, the SEE can be started. The SEE requires some environmental variables for configuration. The SEE will look for input and output messages at `IMGSEE_SOURCE_BASE_PATH` will write to `IMGSEE_TARGET_BASE_PATH`, a relative Path can be given by the job. The SEE will also look for a `.mounted` file in `IMGSEE_SOURCE_BASE_PATH`
```
export IMGSEE_BOARD_ID="XT2_$(cat /etc/machine-id)"
export IMGSEE_PERFFILE_ID="HWP8-Jetson04"
export IMGSEE_QUEUE_URL="10.10.108.30"
export IMGSEE_QUEUE_PORT="61616"
export IMGSEE_QUEUE_DESTINATION_PERF="test.ImagingBenchmark"
export IMGSEE_QUEUE_DESTINATION_IN="test/ImagingQueue"
export IMGSEE_SOURCE_BASE_PATH="/media/data/offis01_imi06/"
export IMGSEE_TARGET_BASE_PATH="/media/data/"
export IMGSEE_MAXNUMOFMESSAGINGTASKS=100
export IMGSEE_MAXRECEIVERCOUNT=1
export IMGSEE_MAXTHREADS=10
export IMGSEE_RESERVEDTHREADS=8
export IMGSEE_LOGFOLDER="/media/data/logs/"
```
For detailed information about these variables have a look in the [Configuration documentation] (doc/Configuration.md)
After everything is configured one can start the SEE:
```
./imgsee
```
The SEE will generate a lockfile `/var/lock/imgsee.lock`. If the SEE is run in background or screen sending `SIGINT` to the process will make sure that the SEE is running emtpy of jobs and exits. The Lock-file is deleted on exit, so observing file existence makes sure that the SEE is stopped e.g. before shutdown.
# Documentation
[SEE Documentation] (doc/Overview.md)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment