Deutsch (English below)
=======================

Anleitung zum verwenden einer PHYTEC phyCAM unter OpenCV.
=================================================================

Schritte:
1) BSP mit Windos-Manager X11 compilieren (alternativ kann ein vorcompilierte Image verwendet werden, in diesem Fall kann bei Schritt 4 begonnen werden)
2) BSP auf SOM aufspielen und starten
3) OpenCV Beispiele aufspielen
4) OpenCV Beispiele starten

Hinweis: Sollten Sie mit den OpenCV plugin's die Ihnen mit dem GStreamer (<gst-inspect-1.0 | grep opencv>) zur Verfügung
gestellt werden Ihre Aufgabe lösen können, so wird kein Windowsmanager (X11/Wayland) benötigt.



Voraussetzung:
- PD18.1.x, i.MX6 (phyBOARD Nunki, Mira oder phyFLEX)
- min. 1GB RAM
- SD-Card min. 2GB


Schritt 1)
==========
Damit Sie das Ergebnis eines mittels OpenCV bearbeiteten Bildes sehen können, empfehlen wir die Verwendung eines Window Managers.
Entwicklungsumgebung entsprechend Quickstart einrichten und BSP zum compilieren vorbereiten.
Patches ("0001-recipe-images-Add-X11-to-vision-image", "0002-conf-distro-Add-yogurt-x11-distro") anwenden und BSP neu bauen:

A) BSP nach YOCTO Anleitung runterladen.

B) Vor dem ersten bauen mit bitbake die Patches apply'en in:
- cd sources/meta-yogurt
- git am <patch>

C) Weiterhin in der "conf/local.conf" folgenden Namen anpassen: 
- 'DISTRO ?= "yogurt"' ändern in 'DISTRO ?= "yogurt-x11"' 

D) Image bauen:
- bitbake phytec-vision-image


Schritt 2)
==========
Nachfolgend wird die Vorgehensweise mittels BSP auf SD-CARD beschrieben:
- Compilierte BSP (mit X11) auf SD-Card spielen
- SD-Card einstecken und von SD booten (Bootjumperstellung abhängig von Plattform)
- Kamera anmelden (siehe Dokument "phyCAM_with_xxx-iMX6_Getting_Started", ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- Nachdem mittels "../gstreamer-examples/remove_qt_demo.sh" Qt abschaltet wurde erscheint das X11 Ausgabefenster
- Prüfen Sie die Kameraeinstellung mittels den Beispielen im Verzeichnis ../gstreamer-examples/ 
- Netzwerkverbindung herstellen (../lib/systemd/network/...)


Schritt 3)
==========
- Datei "opencv.tar" in den Ordner ../usr/share/ spielen.
- Attribute setzen und auspacken:
  * chmod 755 opencv.tar
  * tar -xvf opencv.tar
  * neustart

  
Schritt 4)
==========
Voraussetzung:
	a) das von Ihnen erstellte X11 BSP mit OpenCV auf einer SD Karte
	b) oder Sie verwenden das bereitgestellte Image, welches Sie auf eine SD Karte spielen (z.B. mittels WinSCP)
- starten Sie das System und melden sich an ("root")
- gehen Sie in das Verzeichnis ../usr/share/opencv_examples/
- Starten Sie die Beispiele in Abhängigkeit ob Sie eine Farb- oder Monochrome Kamera angeschlossen und angemeldet haben.

--------------------------------------------------------------------------------------------------------------------------
English:
=======

Instruction for use PHYTEC phyCAM and OpenCV.
=============================================

Steps:
1) BSP with windos-manager X11 compile (if you want to use the precompiled image, you can start at step 4)
2) BSP on SOM transfering and starting
3) OpenCV examples transfering
4) OpenCV examples starting

Note: If you are using the OpenCV plugins to solve your application you can use the GStreamer (<gst-inspect-1.0 | grep opencv>),
no Window Manager (X11 / Wayland) is needed.

Requirements:
- PD18.1.x, i.MX6 (phyBOARD Nunki, Mira or phyFLEX)
- min. 1GB RAM


Step 1)
=======
Therefore you can see the result of the OpenCV process image, we recommend to use a windows manager.
Set up development environment according to Quickstart and prepare BSP for compilation.
Apply patches ("0001-recipe-images-Add-X11-to-vision-image", "0002-conf-distro-Add-yogurt-x11-distro") and built BSP new:

A) Download BSP accordingly YOCTO manual.

B) Before the first build with bitbake, apply the patches in:
- cd sources/meta-yogurt
- git am <patch>

C) Continue to customize the name in conf / local.conf: 
- 'DISTRO ?= "yogurt"' change in 'DISTRO ?= "yogurt-x11"' 

D) Built image:
- bitbake phytec-vision-image


Step 2)
=======
The procedure is described below using BSP on SD-CARD:
- Transfer compiled BSP (with X11) on SD-Card
- plugin SD-Card and boot from SD-Card (Bootjumper are depend of baseboard)
- Register camera (see document "phyCAM_with_xxx-iMX6_Getting_Started", ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- After Qt has been switched off with "../gstreamer-examples/remove_qt_demo.sh" the X11 output window appears
- Test the camera setup via examples in the directory ../gstreamer-examples/ 
- Set up network connectivity (../lib/systemd/network/...)


Step 3)
==========
- Transfer file "opencv.tar" into directory ../usr/share/ .
- Set attributes and unzip:
  * chmod 755 opencv.tar
  * tar -xvf opencv.tar
  * reboot

  
Step 4)
==========
Requirements:
	a) the self compiled image with X11 and OpenCV on a SD-Card
	b) or you have written the precompiled image from PHYTEC on SD-CARD (eg via WinSCP).
- turn on the system and authorized you ("root")
- change to the directory ../usr/share/opencv_examples/
- Start the examples depend on your connected and registered color- oder monochrome camera.