Using Common Vision Blox on ARM 7 Ubuntu boards

Application Note Using Common Vision Blox on ARM 7 Ubuntu boards Version 1.0.2 Author: Martin Kersting Application Note The ARM 7 is used in many little box-style systems as an inexpensive alternative to standard Intel processors. Common Vision Blox is available for these systems and this document describes how to setup Common Vision Blox on such systems. Version Author Date Comment 1.0.0 MKe 17.02.16 Initial version 1.0.1 MKe 25.02.16 Added installation via package 1.0.2 Chart 31.03.17 Adaption for new CVB and Linux Version STEMMER IMAGING is Europe s largest HEAD OFFICE independent supplier of vision technology and services STEMMER IMAGING GmbH Phone: +49 89 80902-0 Gutenbergstraße 9-13 Fax: +49 89 80902-116 WWW.ST EMMER - IM AG ING.COM IMAG ING IS OUR PASSION 82178 Puchheim, Germany info@stemmer-imaging.de

Copyright Copyright 2017 STEMMER IMAGING GmbH, Puchheim. All rights reserved and subject to change. STEMMER IMAGING, Common Vision Blox, Windows, Visual Basic, Visual C++, C++Builder, Visual Studio.net, Visual C#, Delphi are registered trademarks. All rights to this manual are the property of STEMMER IMAGING GmbH, Puchheim/Germany. It may not be reproduced or copied in printed, electronic or photographic form or translated into another language, either in whole or in part, without the written agreement of STEMMER IMAGING GmbH. I M A G I N G I S O U R P A S S I O N 2 W W W. S T E M M E R - I M A G I N G. C O M

Using Common Vision Blox on ARM 7 Ubuntu boards Content 1. Introduction... 4 2. Using the provided ISO image for the Odroid platform... 5 Microsoft Windows... 6 Apple OS X... 7 Booting your system... 9 3. Installing Common Vision Blox on ARM 7 based systems... 13 4. First steps with Common Vision Blox... 16 Further hints... 22 5. Accessing the Odroid from your Windows or Apple machine... 23 6. Useful Linux commands... 26 I M A G I N G I S O U R P A S S I O N 3 W W W. S T E M M E R - I M A G I N G. C O M

Introduction 1. Introduction There are several ARM based SoC (System on a Chip) systems available that include more or less different hardware components such as USB 3 or Gigabit Ethernet. STEMMER IMAGING provides standard Debian installation packages to install Common Vision Blox on those systems. The package includes drivers for GigE- Vision as well as USB3-Vision camera devices. The licensing scheme for ARM based systems is the same as on Intel based Windows or Linux systems. You can select between 3 different licenses: - Using a regular Common Vision Blox hardware license based on WiBu dongles - A Node-lock license using features of the particular hardware - Or a Common Vision Blox Camera Suite license that is supplied for free with all GigE-Vision or USB3- Vision cameras purchased from STEMMER IMAGING Beside the standard Debian installation package STEMMER IMAGING provides an ISO image for one of the popular systems which makes it even easier to get up and running with Common Vision Blox on the ARM. Both installation methods are described in this document. You may also be interesting in an Application Note describing the recommended cross-platform development for Common Vision Blox supporting Windows, Intel and ARM based Linux. This Application Note is also available on www.commonvisionblox.com. I M A G I N G I S O U R P A S S I O N 4 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform 2. Using the provided ISO image for the Odroid platform For the Odroid XU4 board STEMMER IMAGING provides an ISO image with Common Vision Blox and other required tools being installed as a predefined package. The XU4 board uses a Samsung Exynos5422 chip and contains all important connectors to use USB3-Vision or GigE-Vision cameras: Samsung Exynos5422 Cortex -A15 2Ghz and Cortex -A7 Octa core CPUs Mali-T628 MP6(OpenGL ES 3.0/2.0/1.1 and OpenCL 1.1 Full profile) 2Gbyte LPDDR3 RAM PoP stacked emmc5.0 HS400 Flash Storage 2 x USB 3.0 Host, 1 x USB 2.0 Host Gigabit Ethernet port HDMI 1.4a for display Size : 82 x 58 x 22 mm approx.(including cooling fan) Additional information about the board can be found here: Germany http://www.pollin.de/shop/dt/mdk1otgxotk- /Bausaetze_Module/Entwicklerboards/Odroid/ODROID_XU4_Einplatinen_Computer_SAMSUNG_Exyn os_5422_2_gb_2x_usb_3_0.html?gclid=clkc-ljk_socfe4y0wodmhqnjq England http://www.hardkernel.com/main/products/prdt_info.php France http://www.eu.diigiit.com/fr/odroid-xu4 Korea http://www.hardkernel.com/main/shop/good_list.php?lang=kr The manual of the system is available here http://magazine.odroid.com/odroid-xu4/. I M A G I N G I S O U R P A S S I O N 5 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform To install the image on an Micros-SD card you need a tool such as the Win32DiskImager to be installed on your Windows system. You can find the tool here: https://sourceforge.net/projects/win32diskimager/ Apple users might use the ApplePi-Baker which can be found here: http://www.tweaking4all.com/hardware/raspberry-pi/macosx-apple-pi-baker/ The supplied image requires a Micro-SD card of at least 4GByte. Of course you can use large Micro-SD cards and extend the partition afterwards when booting the device. The complete installation will be described in this document step by step. Microsoft Windows After installing the tool to read and write SD card images insert a Micro-SD card of at least 4GByte to your system and start the Win32DiskImager. Select your target SD card. Click the button to load the image file and click the Write button. This will take roughly 6 minutes for a 4 GByte image: You can now remove the SD card and insert it in your Odroid system to boot up Ubuntu on your Odroid. I M A G I N G I S O U R P A S S I O N 6 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform To create a backup of your Odroid system insert its Micros-SD card into your Windows system and start the Win32DiskImager. Select your SD card and click the Read button: The procedure will take roughly 4 minutes for a 4 GByte SD card. Apple OS X After installing the tool to read and write SD card images insert a Micro-SD card of at least 4GByte to your system and start the ApplePi-Baker. Select your target SD card. Click the button to load the image file and click the Restore Backup button. This will take roughly 6 minutes for a 4 GByte image: You can now remove the SD card and insert it in your Odroid system to boot up Ubuntu on your Odroid. I M A G I N G I S O U R P A S S I O N 7 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform To create a backup of your card insert it into your system and start the ApplePi-Baker. Select your SD card and click the Create Backup button: Specify the name of the output file and click the Save button: The procedure will take roughly 4 minutes for a 4 GByte SD card. I M A G I N G I S O U R P A S S I O N 8 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform Booting your system Your system is now ready for booting. Install the Micro-SD card into your system and check the state of the Boot mode selector to ensure your system will boot from the attached Micro-SD card instead of the emmc module. To boot the system from the Micro-SD card, move the Boot mode selector to the left: Attach a USB keyboard, a USB mouse, a monitor via HDMI and a network connection. Power up your system. The system includes two users: Username odroid password odroid Username support password support Both users are administrators and all supplied tools are installed on the desktop of the support user. Login as the support user. As this image was generated using a different Odroid system (especially a different MAC address) then your own system you have to change the network settings to use your Ethernet chip. Go to System / Preferences / Network Connections. I M A G I N G I S O U R P A S S I O N 9 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform Edit the Wired connection 1: Select the Ethernet tab and select the Device MAC address to <YOUR SYSTEM MAC>eth1. Be sure to setup proper IPv4 settings in this dialog as well: I M A G I N G I S O U R P A S S I O N 10 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform If you use a Micro-SD card with more than 4 GByte it s time to extend the system partition. On the Desktop you will find the Odroid Utility tool. Start it and enter your password (support): The tool will give you the option to resize your system partition. I M A G I N G I S O U R P A S S I O N 11 W W W. S T E M M E R - I M A G I N G. C O M

Using the provided ISO image for the Odroid platform Choose this option to resize your partition. After the operation finished you have to reboot your system. Select System / Shut Down to restart your system. Your system is ready to start Common Vision Blox which is described in chapter 4 of this document. I M A G I N G I S O U R P A S S I O N 12 W W W. S T E M M E R - I M A G I N G. C O M

Installing Common Vision Blox on ARM 7 based systems 3. Installing Common Vision Blox on ARM 7 based systems Copy the contents of the CVB installation package for ARM system to a folder on your desktop. In this case we created a folder named setup. Ensure that you have an internet connection because the installation might have to install additional packages such as wxwidgets. Open a terminal and make the installation script executable. To do this change to the Desktop folder using cd ~/Desktop and type in the following command: sudo chmod 755./install_cvb.sh Now execute the installation script: sudo sh./install_cvb.sh I M A G I N G I S O U R P A S S I O N 13 W W W. S T E M M E R - I M A G I N G. C O M

Installing Common Vision Blox on ARM 7 based systems The installation might take some time and you may have to reboot your system. If so reboot your system: After rebooting your system, you will find some new application in your start folder. Some of the samples require Qt being installed on your system. Depending on your installed Qt version you may have to recompile the samples. A recipe on how to use CVB with Qt can be found in UsingCVBwithQT_en.pdf which is included together with other required files in CVBQt.zip in opt/cvb/tutorial. I M A G I N G I S O U R P A S S I O N 14 W W W. S T E M M E R - I M A G I N G. C O M

Installing Common Vision Blox on ARM 7 based systems If you do have a GigE-Vision or USB3-Vision camera attached to your system start the CVB GenICam Browser. Congratulations your system is ready to use Common Vision Blox. In the following chapter you will be guided through the first steps with Common Vision Blox. I M A G I N G I S O U R P A S S I O N 15 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox 4. First steps with Common Vision Blox Common Vision Blox for ARM based systems requires a license that can either be based on a WiBu USB protection device (hardware dongle), a node-lock license or a Camera Suite license that is being shipped with GigE-Vision or USB3-Vision cameras purchased from STEMMER IMAGING. In this example we want to use a Camera Suite license of a USB3-Vision camera. As a first step we need to connect the camera to a USB3 port (blue connector) and activate the Camera Suit License supplied with the camera. If you don t have a valid license your image will show a water mark. From the Home menu select Common Vision Blox / CVB Licensing Console: Enter your password and select Enter/Edit CameraSuite Codes. I M A G I N G I S O U R P A S S I O N 16 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox In the following dialog click the + button to add a new Camera Suite code. Enter your Camera Suite license code that you will find on your camera package and click OK. If you do have Common Vision Blox WiBu key attached to your Odroid you can view it and the licenses for Common Vision Blox tools by clicking the Show Serial Numbers button in the Common Vision Blox Licensing Console. I M A G I N G I S O U R P A S S I O N 17 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox You can also show your Common Vision Blox tool licenses by clicking the Show/Edit Magic Numbers button. I M A G I N G I S O U R P A S S I O N 18 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox Close the Common Vision Blox Licensing Console and open your Home folder on the desktop. Navigate to File System / etc / opt /cvb / drivers. Right click the GenICam.ini file and select Open With Pluma to edit the file. I M A G I N G I S O U R P A S S I O N 19 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox Ensure that the CreateAutoIni flag is set to a value of 1 and that there are no more lines below the [Channel_0] line. This will ensure that the CVB GenICam driver will automatically detect the hardware and write the configuration data to this file. After saving the file your system is ready for using the camera. From the Home menu start the QTSizeable Display application. Click the Open Image button and load the GenICam VIN driver from the File System / opt / cvb / drivers directory. I M A G I N G I S O U R P A S S I O N 20 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox I M A G I N G I S O U R P A S S I O N 21 W W W. S T E M M E R - I M A G I N G. C O M

First steps with Common Vision Blox The application will detect the connected hardware whether it might be a USB3-Vision or GigE-Vision camera and show an image of that camera. Toggle the grab using the Grab checkbox. You will find the source code of this application in /opt/cvb/tutorial/imagemanager/qt/qtsizeabledisplay. Further hints If you want to use GigE-Vision cameras with a direct connection to the Odroid you should configure your IPv4 settings to Link-Local Only. The display of the QT Sizeable Display application does not support OpenGL or OpenCL so far which might cause display problems in case of high camera data rates (blocks of lines are displayed incorrectly). STEMMER IMAGING recommends Qt to be used as a developing platform as it provides a comfortable way to develop applications under Windows or Intel Linux and cross compile them on the ARM platform. The provided ISO image for the Odroid already includes the required toolchain and a documentation on how to use Qt for Common Vision Blox. If you installed the system manually you may want to download this Application Note on www.commonvisionblox.com. I M A G I N G I S O U R P A S S I O N 22 W W W. S T E M M E R - I M A G I N G. C O M

Accessing the Odroid from your Windows or Apple machine 5. Accessing the Odroid from your Windows or Apple machine Sometimes it s important to read or write files on your Odroid system. To do so STEMMER IMAGING recommends the WinSCP tool for Windows which you can download here https://winscp.net/eng/index.php. If you start the tool you can open a new connection by supplying the IP address and login credentials of your Odroid. Click the Login button to connect to your Odroid. After login, the tool will display the content of your local system as well as the connect of the Odroid Micros-SD. Simply use drag and drop to copy files back and forth. I M A G I N G I S O U R P A S S I O N 23 W W W. S T E M M E R - I M A G I N G. C O M

Accessing the Odroid from your Windows or Apple machine For Apple users we recommend the Midnight Commander which can be found here http://rudix.org/packages/mc.html. The Midnight commander can be started from with the terminal. Start a terminal and enter mc. Select fn + F9 to open the Left menu. From that menu select the Shell Link option. Enter support@odroid_ip as the link to the machine. I M A G I N G I S O U R P A S S I O N 24 W W W. S T E M M E R - I M A G I N G. C O M

Accessing the Odroid from your Windows or Apple machine In the left tree you will find the content of your Odroid Micro-SD card while the right tree shows your local directory structure. Use tab key to toggle between the two directory sets and use the function keys to execute one of the commands displayed in the last line of the Midnight Commander. Additionally you may use Putty under Windows or the ssh terminal command under OS X to remote login to your Odroid system using SSH. I M A G I N G I S O U R P A S S I O N 25 W W W. S T E M M E R - I M A G I N G. C O M

Usefull Linux commands 6. Useful Linux commands Directory and file commands Command Description Sample cd [DIRECTORY] Changes the current working directory cd /tmp cd.. Changes the current working directory to the parent directory cd.. cd / Changes the current working directory to the root directory cd / cd ~ Changes the current working directory to the users home directory cd ~ cd - Changes to the previous directory cd - cp [FILE] [DIRECTORY] Copies a file to the directory cp 123.txt /tmp mv [FILE] [DIRECTORY] Moves a file to the directory mv 123.txt /tmp rm [FILE] Deletes a file rm /tmp/123.txt rm /tmp/* rm -rf [DIRECTORY] Deletes all files in a directory as well as the rm -rf /tmp/ directory mkdir [DIRECTORY] Creates a directory mkdir /home/test rmdir [DIRECTORY] Deletes a directory rmdir /home/test ls [DIRECTORY] Displays the contents of a directory ls ls /home/test ll [DIRECTORY] Displays the contents of a directory with ll detailed information ll/home/test pwd Displays the current directory pwd cat [FILE] Displays the content of a file cat 123.txt more [FILE] Displays the content of a file page by page more 123.txt touch [File] Creates an empty file, changes the file timestamp touch 123.txt find [DIRECTORY] grep [FILE] Searches for a file find /etc 123.txt find. grep 123.txt chmod 755 [FILE] Makes a file executable sudo chmod 755./MyScript.sh chmod 666 [FILE] Makes a file readable and writeable by everyone sudo chmod 666./MyScript.sh Users Command Description Sample id Displays the user name and the group id who Displays all connected users who useradd -m [USER] Creates a new user and its Home directory useradd -m chef I M A G I N G I S O U R P A S S I O N 26 W W W. S T E M M E R - I M A G I N G. C O M

Usefull Linux commands userdel -r [USER] Deletes a user and its Home directory useradd -m chef passwd [USER] Changes the password of a user passwd chef Network Command Description Sample ifconfig Displays network information ifconfig iwconfig Displays WLAN information iwconfig ping [DEVICE] Tests the connection to a network device ping 192.168.0.1 Application installation Command Description Sample apt-get update Updates all installed packages sudo apt-get update Installs a package including ist apt-get install [PACKAGENAME] dependencies sudo apt-get install cmake apt-get remove [PACKAGENAME] de-installs a package including ist dependencies sudo apt-get remove cmake Other useful commands Command Description Sample uname -a Displays the kernel version uname -a free Displays the RAM usage free kill [PID] Kills a process by its ID kill 1067 killall [PROGRAM] Kills a process by its name killall Firefox shutdown -h now Shutdowns the computer shutdown -h now shutdown -r now Restarts the computer shutdown -r now top Displays active programs an CPU-load top man [PROGRAM] Display the help for the Program man firefox strg + C Cancels the current shell operation strg + C ps aux Displays all active processes and services ps aux rc-update show Displays all services being loaded at boot time rc-update show I M A G I N G I S O U R P A S S I O N 27 W W W. S T E M M E R - I M A G I N G. C O M

Contact Contact and Feedback We hope that this manual was useful for you and look forward to your feedback. In case of further questions, please do not hesitate to contact our technical support. Additional information and a lot of valuable details regarding image processing, can also be found on our website. DENM ARK Phone: +46 8 555 110 27 E-Mail: support@stemmer-imaging.dk Web: www.stemmer-imaging.dk FINLAND BALTICS Phone: +358 9 43 555 012 E-Mail: support@stemmer-imaging.fi Web: www.stemmer-imaging.fi FRANCE Phone: +33 1 45069560 E-Mail: support@stemmer-imaging.fr Web: www.stemmer-imaging.fr GERM ANY AUSTRIA Phone: +49 89 80902-200 E-Mail: support@stemmer-imaging.de Web: www.stemmer-imaging.de POLAND SWEDEN NORW AY ICELAND Phone: +46 8 555 110 27 E-Mail: support@stemmer-imaging.se Web: www.stemmer-imaging.se SWITZERLAND LIECHTENSTEIN Phone: +41 55 415 90 90 E-Mail: support@stemmer-imaging.ch Web: www.stemmer-imaging.ch THE NETHERLANDS BELGIUM LUXEMBOURG Phone: +31 575 798881 E-Mail: support@stemmer-imaging.nl Web: www.stemmer-imaging.nl UNITED KINGDOM IRELAND Phone: +44 1252 780060 E-Mail: support@stemmer-imaging.co.uk Web: www.stemmer-imaging.co.uk Phone: +46 8 555 110 27 E-Mail: support@stemmer-imaging.pl Web: www.stemmer-imaging.pl I M A G I N G I S O U R P A S S I O N 28 W W W. S T E M M E R - I M A G I N G. C O M