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

Anleitung zum aufspielen und starten von HALCON/HPEEK auf einem PHYTEC i.MX6 Board mit einem BSP ab PD20
========================================================================================================

Allgemein:
Diese Anleitung zeigt ihnen folgende Möglichkeiten mit HALCON/HPEEK zu arbeiten.
A) Verwendung der HPEEK Demoversion von Halcon (kein Dongle/Lizenz erforderlich)
B) Verwendung von HPEEK zum starten von hdev-Demos mit Zugriff auf phyCAM-Kameramodule (Dongle/Lizenz erforderlich) 

--------------------------------------------

Schritte:
1) Vision-BSP PD20.1.0 (oder höher) auf eine microSD-Card spielen (Wähle entsprechend der verwendeten Plattform (Mira [microSD-Card], Nunki [microSD-Card], phyFLEX[SD-Card]))
   Alternativ kann ein vorcompiliertes SDCARD Image vom PHYTEC-FTP verwendet werden, in diesem Fall kann bei Schritt 4 begonnen werden.
2) Speicher auf microSD-Card anpassen 
3) HPEEK/HALCON installation
4) HPEEK starten 
5) HALCON Demos aufspielen. HALCON Demos mit phyCAM-Kameras starten


Voraussetzung:
- phyBOARD Nunki (phyboard-nunki-imx6-1), phyBOARD Mira (phyboard-mira-imx6-3) oder phyFLEX-i.MX6 (phyflex-imx6-2)
- PD20.x.x, i.MX6 Vision-BSP (ftp://ftp.phytec.de/pub/Software/Linux/BSP-Yocto-i.MX6/BSP-Yocto-i.MX6-PD20.1.0/images/yogurt-x11/) 
  oder dem vorcompilierten BSP mit HALCON vom PHYTEC FTP (ftp://ftp.phytec.de/pub/ImageProcessing/)
- freie microSD-CARD min. 2GB (oder SD-CARD mit Adapter auf microSD)
- HDMI Monitor oder Display
- Host PC, im nachfolgenden wurde ein Windowsrechner mit den Programmen: "Putty", "WinSCP" und "Win32DiskImager" verwendet. 


Schritt 1) Image auf microSD-Card spielen
=========================================
Nachfolgend wird die Vorgehensweise mittels BSP auf microSD-Card beschrieben:
- SD-Card-BSP PD20.x.x auf microSD-Card spielen (z.B. mit "Win32DiskImager" auf einem Windows Rechner)
- microSD-Card einstecken und von SD booten (Bootjumperstellung abhängig von Plattform)
- Mittels eines Terminalprogramms (z.B. "Putty") können die nachfolgenden Consolenbefehle auch über einem Windowsrechner eingegeben werden 
- nach dem durchbooten als root anmelden, type "root"
- QT und X11 mittels ".../gstreamer_examples/remove_qt_demo.sh" abschalten
- Netzwerkverbindung ihrem Netzwerk anpassen (Einstellung in der "/lib/systemd/network/10-eth0.network")
- type "reboot" (neustart)


Schritt 2) Speicher auf microSD-Card anpassen
=============================================
Beim aufspielen des BSPs wird die microSD-CARD üblicherweise nur mit der Größe des BSP formatiert.
Damit wir jedoch das HPEEK mit aufspielen können wird die volle Größe der microSD-Card benötigt. 
- Prüfen und einstellen der microSD-CARD Größe.
  * Linux von microSD-CARD booten und mittels "root" anmelden
  * <df> Speicher anzeigen lassen, dev/root soll verwendet werden und min. 2GB groß sein
  * <parted> eingeben
  * <print devices> eingeben
  Unter "/dev/mmcblk0" wird die mögliche Speichergröße ausgegeben. 
  * <select /dev/mmcblk0> eingeben
  * <resizepart 2 2008MB>  (hier das Ende des Gesamtspeichers angeben, z.B 2GB)
  * <quit> parted verlassen
  * <resize2fs /dev/mmcblk0p2> neueinlesen des Speichers
  * <df> Speicher anzeigen lassen, dev/root sollte nun die neue Speichergröße haben


Schritt 3) HPEEK/HALCON installation
====================================
- Eine aktuelle Version von HALCON/HPEEK finden Sie auf der Homepage der Firma MVTEC
https://www.mvtec.com/de/produkte/embedded-vision/
- Bevor Sie HALCON/HPEEK herunterladen können, müssen Sie sich dort registrieren.
- Wählen Sie Produkt->HALCON / Version->HPeek / Betriebssystem->Linux for ARM (32-Bit Version)
  * Info: HPEEK ist ohne Lizenz lauffähig, für HALCON wird eine Lizenz benötigt
- nach dem durchbooten als root anmelden, type "root"
- Legen Sie auf dem phyCORE ein Verzeichnis ../usr/share/halcon an.
- Spielen Sie die "xxxarmv7a-linux-hpeek.tar.gz" Datei ins ../usr/share/halcon Verzeichnis (z.B. mittels "WinSCP")
- wechsle ins Verzeichnis "../usr/share/halcon"
- Attribute setzen und auspacken:
  * chmod 755 halcon-20.05.0.0-armv7a-linux-hpeek.tar.gz
  * tar -xvf halcon-20.05.0.0-armv7a-linux-hpeek.tar.gz

extra
=====
- Bildschirmschoner X11 deaktivieren (Bei vorgefertigtem BSP schon enthalten)
 * Datei "X11_disable_screensaver.tar" in das Verzeichnis "/usr/share/X11/..." spielen.
 * chmod 755 X11_disable_screensaver.tar
 * tar -xvf X11_disable_screensaver.tar
- type "reboot" (neustart)


Schritt 4) HPEEK starten
========================
Voraussetzung:
	a) das von Ihnen angepaßte Vision-BSP mit HPEEK/HALCON auf einer microSD-Card
	b) oder das auf unserem FTP bereitgestellte SD-CARD-Image, welches Sie auf eine microSD-Card spielen (z.B. mittels "WinSCP")
- starten Sie das System und melden sich an ("root")
- wechsle ins Verzeichnis ../usr/share/halcon
- X11 server starten
  * <systemctl start xserver-nodm>
- Setze die Umgebungsvariable fürs Display.
  * <export DISPLAY=:0.0>
- HPEEK starten
  * <./run_overview.sh>
  * <./run_deep_learning.sh>

HPEEK anpassen
- Anpassen Auflösung und Auswahl Demos:
/usr/share/halcon/examples/hpeek/config.txt öffnen

1) Auflösung des Bildschirms einstellen
WindowWidth     xxx (gewünschte Auflösung setzen)
WindowHeight    xxx (gewünschte Auflösung setzen)

2) demos an- und abwählen
setzen der Variablen, zB.:
  * show_intro 0 (intro aus)
  * show_intro 1 (intro an)


Schritt 5) HALCON starten
=========================
Voraussetzung:
	a) das von Ihnen angepaßte Visio-BSP mit HPEEK/HALCON auf einer microSD-Card
	b) oder das auf unserem FTP bereitgestellte SD-CARD-Image, welches Sie auf eine microSD-Card spielen (z.B. mittels "WinSCP")
	c) eine HALCON Lizenz/Dongle
- starten Sie das System und melden sich an ("root")
- spielen Sie ihre Lizenzdatei in den Pfad .../halcon/license/... und stecken den Dongle an.
- melden Sie die angeschlossenen Kamera im Bootloader an (siehe Dokument "phyCAM_with_xxx-iMX6_Getting_Started", 
  ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- Datei "halcon_examples.tar" in den Ordner ../usr/share/halcon/ spielen. (Bei vorgefertigtem BSP schon enthalten)
- Attribute setzen und auspacken:
  * chmod 755 halcon_examples.tar
  * tar -xvf halcon_examples.tar
- gehen Sie in das Verzeichnis ../usr/share/halcon/examples/phytec/
- X11 server starten
  * <systemctl start xserver-nodm>
- Starten Sie die "start.sh"


Fehlersuche:
============
Sollte bei Ihnen der Fehler "Cannot run unsigned script phyCAM_show_stream.hdev (5)" erscheinen, so prüfen sie bitte die eingestellte Systemzeit. Aktualisieren Sie diese gegebenenfalls.


---------------------------------------------------------------------------------------------------------------------

English:
=======

How to install and start HALCON/HPEEK on a PHYTEC i.MX6 board with BSP version PD20.
====================================================================================


General:
This tutorial shows you the following ways to work with HALCON/HPEEK.
A) Using the HPEEK demo version of Halcon (no dongle/license required)
B) Use of HPEEK for starting hdev-demos with access to phyCAM camera modules (dongle/license required)

--------------------------------------------


Steps:
1) Written the Visio-BSP PD20.1.0 (or higher) on a microSD-Card (choose according to the platform used (Mira, Nunki, phyFLEX))
   Alternatively, a precompiled SDCARD image from PHYTEC-FTP can be used; in this case, step 4 can be started.
2) Adjust memory to microSD-Card
3) HPEEK/HALCON installation
4) Start HPEEK demo
5) Written HALCON demos on modul. Start HALCON demos with phyCAM cameras


Requirements:
- phyBOARD Nunki (phyboard-nunki-imx6-1), phyBOARD Mira (phyboard-mira-imx6-3) oder phyFLEX-i.MX6 (phyflex-imx6-2)
- PD20.xx, i.MX6 Vision-BSP (ftp://ftp.phytec.de/pub/Software/Linux/BSP-Yocto-i.MX6/BSP-Yocto-i.MX6-PD20.1.0/images/ yogurt-x11 /)
   or the precompiled BSP with HALCON from PHYTEC FTP (ftp://ftp.phytec.de/pub/ImageProcessing/)
- empty microSD-Card min. 2GB (or SD-CARD with adapter to microSD)
- HDMI monitor or display
- Host PC, in the following a Windows computer with the programs: "Putty", "WinSCP" and "Win32DiskImager" was used.


Step 1) put image on microSD-Card
=================================
The procedure is described below using the BSP on microSD-Card:
- Transfer compiled BSP on microSD-Card (e.g with "Win32DiskImager" via a Windows computer) 
- plugin microSD-Card and boot from microSD-Card (Bootjumper depend on baseboard)
- The following console commands can also be entered via a Windows computer using a terminal program (e.g. "Putty")
- turn on the system and authorized you, type "root"
- Switch off QT and X11 using ".../gstreamer_examples/remove_qt_demo.sh"
- Set up network connectivity to your network (setting in "/lib/systemd/network/10-eth0.network")
- type "reboot" (restart)


Step 2) Adjust memory to microSD-Card
=====================================
When installing the BSP, the microSD-Card is usually formatted only with the size of the BSP.
However, in order for us to be able to play the HPEEK, the full size of the microSD-Card is needed.
- Check and setup the microSD-Card size.
   * Boot Linux from microSD-Card and log in using "root"
   * Enter <df> Show memory,  "dev/root" should be used and min. 2GB in size
   * Enter <parted>
   * Enter <print devices>
   The possible memory size is output under "/dev/mmcblk0".
   * Enter <select / dev / mmcblk0>
   * Enter <resizepart 2 2008MB> (specify here the end of the total memory, for example 2GB)
   * Enter <quit>  leave program "parted"
   * Enter <resize2fs / dev / mmcblk0p2> re-reading the memory
   * Enter <df> Show memory, dev / root should now have the new memory size


Step 3) HPEEK/HALCON installation
=================================
- A current version of HPEEK is located on the homepage of company MVTEC:
https://www.mvtec.com/de/produkte/embedded-vision/
- Before you can download HPEEK, you need to register there.
- Select Product-> HALCON / Version-> HPeek / Operating System-> Linux for ARM (32-Bit Version)
  * Note: HPEEK work without licence, HALCON need a licence
- turn on the system and authorized you, type "root"
- Create a directory ../usr/share/halcon on the phyCORE.
- Play the "xxxarmv7a-linux-hpeek.tar.gz" file into the ../usr/share/halcon directory (e.g. via "WinSCP")
- change into path ../usr/share/halcon
- Set attributes and unpack:
  * chmod 755 halcon-20.05.0.0-armv7a-linux-hpeek.tar.gz
  * tar -xvf halcon-20.05.0.0-armv7a-linux-hpeek.tar.gz


extra
=====
- turn off screen saver X11
 * copy file "xorg.conf" in to path "/etc/X11/..."
 * chmod 755 xorg.conf 
- type "reboot" (restart)


Step 4) Start HPEEK demo
========================
Requirements:
	a) the Vision-BSP you have adapted with HPEEK/HALCON on an microSD-Card
	b) or you have written the precompiled image from PHYTEC on microSD-Card (eg via "WinSCP").
- turn on the system and authorized you ("root")
- change into path ../usr/share/halcon
- Start X11 server
  * <systemctl start xserver-nodm>
- set the environment for display
  * <export DISPLAY=:0.0>
- start HPEEK
  * <./run_overview.sh>
  * <./run_deep_learning.sh>

Adapt HPEEK:
- adapt resolution and choise demos:
open /usr/share/halcon/examples/hpeek/config.txt

1) setup the resolution of display
WindowWidth     xxx (set desired resolution)
WindowHeight    xxx (set desired resolution)

2) choise the demos
set the variablen, e.g.:
  * show_intro 0 (intro off)
  * show_intro 1 (intro on)


Step 5) Start HALCON demo
=========================
Requirements:
	a) the Vision-BSP you have adapted with HPEEK/HALCON on an microSD-Card
	b) or you have written the precompiled image from PHYTEC on microSD-Card (eg via "WinSCP").
	c) an HALCON Licence/Dongle
- turn on the system and authorized you ("root")
- copy licence file into .../halcon/license/... path and stick the dongle in
- set up the connected camera in bootloader environment (see document "phyCAM_with_xxx-iMX6_Getting_Started", 
  ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- copy "halcon_examples.tar" into path ../usr/share/halcon/  (is include at the precompiled image)
- set attributes and unpack:
  * chmod 755 halcon_examples.tar
  * tar -xvf halcon_examples.tar
- change into path ../usr/share/halcon/examples/phytec/
- Start X11 server
  * <systemctl start xserver-nodm>
- call "start.sh"



Troubleshooting:
================
If you get the error "Cannot run unsigned script phyCAM_show_stream.hdev (5)", please check the set system time. Update them if necessary.