Table of contents
...
| Table of Contents | ||||
|---|---|---|---|---|
|
Overview
...
AdamAppSDK (Application Development Kit for i-PRO AI Camera) works in Linux environment.
AdamAppSDK operating requirements
For development PC ：x86_64(amd64)
For development OS ：Ubuntu Linux 16.04 LTS (64bit版)
Ubuntu Linux 18.04 LTS (64bit版)development language ：C/C++, Python
In this tutorial, assuming that the OS of the development PC is windows, explain the installation procedure of VirtualBox and Ubuntu.
If the OS of the development PC is Ubuntu, start by establishing the Preparation-for-establishing-the-SDK-development-environment.
Install VirtualBox
...
Download the installer
Download the VirtualBox installer from the website.
Versions to be installed in the tutorial.
VirtualBox 6.1.36 platform packages
...
Click "Windows hosts" to download the installer.
Install VirtualBox
Follow the wizard to install.
No changes are required.
...
Once done, Virtual Box will start.
...
Establish Ubuntu environment
...
Download image file
Download the Ubuntu Desktop image file from the website.
Installation target OS in the tutorial
Ubuntu 18.04.6 LTS
...
Create a virtual machine
Start VirtualBox and click the "New (N)" button.
...
Select the virtual machine name and OS type.
Virtual machine name : Optional
OS type : Linux
Version : Ubuntu (64bit)
...
Arbitrarily allocate memory for the virtual machine. Recommended is 1024MB or more.
If you plan to use the AI model conversion tool, please make it at least 4096MB.
...
Create a virtual hard disk.
...
The hard disk file type does not need to be changed.
...
We recommend "Variable size" for the virtual hard disk.
...
Set arbitrary size.
...
Once complete, your virtual machine will be created.
...
Install Ubuntu
Install Ubuntu on the created virtual machine.
Start the created virtual machine.
...
Click the folder mark in the wizard that starts.
...
Click Add.
...
Select the image file you downloaded.
...
Click Select.
...
Click "Launch" to start the installation.
...
Set up Ubuntu
Configure Ubuntu.
Select your language and click Install Ubuntu.
...
Select your keyboard layout and click Continue.
...
Click Continue without making any changes.
...
Click Install without making any changes.
...
Click Continue.
...
Select your region and click Continue.
...
Set your login information and click Continue.
...
After the installation is complete, reboot the OS.
...
Type Enter and if it boots, you're done.
...
Network settings for communicating with the outside world
Configure settings for network access from outside VirtualBox. By default, NAT is set, so please use the setting as it is.
If you want VirtualBox to communicate with the Windows PC running VirtualBox, refer to the following URL and set Host only network.
http://christophermaier.name/blog/2010/09/01/host-only-networking-with-virtualbox
This completes the environment construction of the virtualization software VirtualBox and Ubuntu.
Please continue establishing the SDK environment.
Preparation for establishing the SDK development environment
...
Settings for downloading and installing software
Set up a package management system ‘apt’ in Ubuntu in order to download and install software tools.
...
| Code Block |
|---|
$ sudo apt-get update |
Installing tools for host machine
Install tools for the host machine including a toolchain such as compiler, linker or assembler along with the libraries etc. Use apt-get command for the installation.
...
| Code Block |
|---|
$ sudo apt-get install multiarch-support |
About i-pro camera SoC
The i-pro camera uses SoC provided by ambarella. Hereafter, ambarella's CV2X (generic term for chip types such as CV2, CV22, CV25, etc.) SoC will be abbreviated as ambaCV2X. There are SoCs such as CV52 with higher performance, in which case it is called ambaCV5X. Please see below for compatibility between the camera and the SoC used.
Installation conditions for applications - Technology Partner FAQ (En) - Confluence (atlassian.net)
Installing modules in accordance with each target
Install Ambarella_Toolchain_Linaro_2018.08 included in AdamAppSDK_DevTools_YYYYMMDD.zip(get here) as a cross compiler to build AdamApps for i-pro ambaCV2X models.
...
Execute the file as follows to install the cross compiler.
| Note |
|---|
In the environment on VirtualBox, installation may fail on shared directories. Please install in the directory on Ubuntu. |
| Code Block |
|---|
$ sudo apt-get install python3 $ tar xvf Ambarella_Toolchain_Linaro_2018.08.tar.xz $ cd Ambarella_Toolchain_Linaro_2018.08 $ sudo chmod +x ubuntuToolChain-201808 $ ./ubuntuToolChain-201808 |
| Note |
|---|
In the environment on VirtualBox, installation may fail on shared directories. Please install in the directory on Ubuntu. |
| Info |
|---|
The Python environment pre-installed in the i-PRO camera is as follows. Interpreter : Python 3.7.9 External library : python adam module for ADAM API |
Installing Google Chrome Browser
Install Google Chrome Browser from the URL below. The location to install Chrome can be either on Windows or on Ubuntu in VirtualBox.
Google Chrome browser :
Installing Adam Operation UI in Chrome
Install the Adam Operation UI extension for Google Chrome.
Click “menu” -> “More tools” -> “Extensions”, and open “Extensions” page.
...
Open /tool folder using file manager, then drag and drop “AdamControlExtension” folder on Extensions page.
...
Enable “Developer mode” on Extensions page if you could not install the extension.
...
Installing Resource Monitor Extension in Chrome
Install Resource Monitor Extension for Google Chrome. The installation procedure is the same as Adam Operation UI Extension.
Open /tool folder using file manager, then drag and drop “ResourceMonitorExtension” folder on Extensions page.
...
...
| Info |
|---|
If you are prompted for TOOLCHAIN PATH[/usr/local]: when you run |
How to install AdamAppSDK
Installing AdamAppSDK
Unzip iPRO_CAMERA_SDK_Vx_xx.zip(get here) in any directory on your Development PC as indicated below. (iPRO_CAMERA_SDK file name’s Vx_xx is a value of the AdamAppSDK version).
| Code Block |
|---|
$ cd <The directory in which a developer is going to install AdamAppSDK> $ unzip iPRO_CAMERA_SDK_Vx_xx.zip $ ls –CF iPRO_CAMERA_SDK_Vx_xx/ |
| Note |
|---|
Be sure to copy the SDK zip file into Ubuntu before extracting the zip file. If you extract it on another OS such as Windows and then move it to Ubuntu, it will not work properly. |
The installation is completed.
| Note |
|---|
In the environment on VirtualBox, creation of symbolic links and compilation may fail on shared directories. Install it in a directory on Ubuntu. |
Getting the Development License
In principle, only encrypted AdamApp can be installed into i-PRO cameras sold in general. A development license is embedded in SDK so that AdamApp that has not been encrypted can be installed into i-PRO camera with specified MAC address. Please obtain a development license file from i-PRO Co., Ltd. then save the file as shown below.
<AdamAppSDK’s Installation Directry>/conf/development.key
Build the sample app
Build the sample application "additional_info_sample_app" and install it on the camera. If sample application works, the construction of the SDK development environment is completed.
Only the minimum necessary steps are described. Please see here for details on how to develop.
Generate and place source files
Source files of the AdamApp must be placed in the following directory.
...
It’s recommended that you copy and modify additional_info_sample_app directory to generate new application for ease.
| Info |
|---|
By copying the skeleton_sample_app directory and creating a new directory, the set of files necessary to create a new AdamApp will also be copied. It’s recommended that you copy and modify skeleton_sample_app directory to generate new application for ease. |
Build the sample app
setup_env.sh is provided as a setup file for the building environment. You can set up building
environment by reading setup_env.sh using ‘source’ command with parameter depending on execution
environment of AdamApp.
...
| Code Block |
|---|
$ cd <directory of installed AdamAppSDK> $ source setup_env.sh ipro-ambaCV2X ***** /usr/local/linaro-aarch64-2018.08-gcc8.2/bin/aarch64-linux-gnu-gcc found. ***** PF_BASEDIR = /home/user/adamappsdk BUILD_TARGET = ipro-ambaCV2X TARGET_FOR_ADAM = ambaCV2X TARGET_ARCH = aarch64-linux-gnu VERBOSE = 0 PATH = /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games |
Execute make (build and generate package of AdamApp)
You will need to execute make to build and generate an AdamApp package. AdamApp package will be build and generated automatically. When it is successful, the following three files are generated within skelton_sample_app directory.
AdditionalInfoSampleApp : The execution program of additional_info_sample_app
AdditionalInfoSampleApp.zip ：The package of additional_info_sample_app
AdditionalInfoSampleApp.ext ：Encoded file by BASE64
| Code Block |
|---|
$ cd <directory of installed AdamAppSDK>
$ cd src/adamapp/additional_info_sample_app
$ make |
| Info |
|---|
The following error may occur during make. In that case, please set the permissions of adamapp_configurator as shown below and make again. |
Operation check of the sample application
Install the created "AdditionalInfoSampleApp.ext" to the camera and check the operation.
...