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

Anleitung zum aufspielen und starten von HALCON/HPEEK auf einem PHYTEC i.MX8M Mini Board mit einem BSP ab PD22
==============================================================================================================

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 PD22.1.0 (oder höher) auf eine microSD-Card spielen (Wähle "phytec-vision-image-phyboard-polis-imx8mm-4.sdcard" [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 Polis
- PD22.x.x, i.MX8MM Vision-BSP (https://download.phytec.de/Software/Linux/BSP-Yocto-i.MX8MM/) 
  oder dem vorcompilierten BSP mit HALCON vom PHYTEC FTP (https://download.phytec.de/ImageProcessing/)
- freie microSD-CARD min. 4GB (oder SD-CARD mit Adapter auf microSD)
- Display am phyBOARD Polis
- 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-Image PD22.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 Demo 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. 4GB groß sein
  * <parted> eingeben
  * <print devices> eingeben
  Unter "/dev/mmcblk1" wird die mögliche Speichergröße ausgegeben. 
  * <select /dev/mmcblk1> eingeben
  * <resizepart 2 4009MB>  (hier das Ende des Gesamtspeichers angeben, z.B 4GB)
  * <quit> parted verlassen
  * <resize2fs /dev/mmcblk1p2> 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 (64-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 "halcon-xxx-aarch64-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-22.05.0.0-aarch64-linux-hpeek.tar.gz
  * tar -xvf halcon-22.05.0.0-aarch64-linux-hpeek.tar.gz



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
- Setze die Umgebungsvariable fürs Display.
  * <export DISPLAY=:0.0>
- Sollte wayland noch nicht gestartet sein, starten Sie den windowmanager.
  * <systemctl start weston>
- 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, edit .../halcon/examples/hpeek/config.txt:
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_phyBOARD-Polis-iMX8M_Mini_Getting_Started", 
  ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- Datei "i.MX8M_Mini_halcon_examples.tar" in den Ordner ../usr/share/halcon/ spielen. (Bei vorgefertigtem BSP schon enthalten)
- Attribute setzen und auspacken:
  * chmod 755 i.MX8M_Mini_halcon_examples.tar
  * tar -xvf i.MX8M_Mini_halcon_examples.tar
- gehen Sie in das Verzeichnis ../usr/share/halcon/examples/phytec-halcon-examples/
- 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.MX8M Mini board with BSP version PD22
=========================================================================================


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 PD22.1.0 (or higher) on a microSD-Card (choose "phytec-vision-image-phyboard-polis-imx8mm-4.sdcard" [SDCARD])
   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 Polis
- PD21.xx, i.MX8MM Vision-BSP (https://download.phytec.de/Software/Linux/BSP-Yocto-i.MX8MM/)
   or the precompiled BSP with HALCON from PHYTEC FTP (https://download.phytec.de/ImageProcessing/)
- empty microSD-Card min. 4GB (or SD-CARD with adapter to microSD)
- display at phyBOARD Polis
- 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 PD22.x.x Image 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 demo 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. 4GB in size
   * Enter <parted>
   * Enter <print devices>
   The possible memory size is output under "/dev/mmcblk1".
   * Enter <select / dev / mmcblk1>
   * Enter <resizepart 2 4009MB> (specify here the end of the total memory, for example 4GB)
   * Enter <quit>  leave program "parted"
   * Enter <resize2fs / dev / mmcblk1p2> 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 (64-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 "halcon-xxx-aarch64-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-22.05.0.0-aarch64-linux-hpeek.tar.gz
  * tar -xvf halcon-22.05.0.0-aarch64-linux-hpeek.tar.gz


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
- set the environment for display
  * <export DISPLAY=:0.0>
- if Wayland is not yet started, start the window manager
  * <systemctl start weston>
- 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, edit .../halcon/examples/hpeek/config.txt
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_phyBOARD-Polis-iMX8M_Mini_Getting_Started", 
  ftp://ftp.phytec.de/pub/ImageProcessing/<product-name>/Dokumentation/)
- copy "i.MX8M_Mini_halcon_examples.tar" into path ../usr/share/halcon/  (is include at the precompiled image)
- set attributes and unpack:
  * chmod 755 i.MX8M_Mini_halcon_examples.tar
  * tar -xvf i.MX8M_Mini_halcon_examples.tar
- change into path ../usr/share/halcon/examples/phytec-halcon-examples/
- 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.