Table of contents
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.
Adjust setting if network is connected to Internet via Proxy.(only in the necessary environment)
Edit /etc/apt/apt.conf as follows
Acquire::http::proxy "http://my.http-proxy.co.jp:Port_Number";
Acquire::https::proxy "http://my.https-proxy.co.jp:Port_Number";
Modify http://my.http-proxy.co.jp:PortNumber and http://my.https-proxy.co.jpd epending on your environment.
Update apt package index.
$ 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.
Install g++ toolchain.
$ sudo apt-get install g++
Install g++-multilib.
$ sudo apt-get install g++-multilib
Install libjpeg package.
$ sudo apt-get install libjpeg-turbo8-dev
Install g++-multilib again.
$ sudo apt-get install g++-multilib
Install packages for executing 32-bit binary over the 64-bit system
$ sudo dpkg –-add-architecture i386 $ sudo apt-get update $ sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386
If fails, do also.
$ sudo apt-get install multiarch-support
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.
The compiler is located in the following location in AdamAppSDK_DevTool and is Ubuntu 64bit version only.
AdamAppSDK_DevTools_YYYYMMDD/toolchain/Ambarella_Toolchain_Linaro_2018.08
Execute the file as follows to install the cross compiler.
In the environment on VirtualBox, installation may fail on shared directories. Please install in the directory on Ubuntu.
$ 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
If you are prompted for TOOLCHAIN PATH[/usr/local]: when you run ./ubuntuToolChain-201808, just press enter without typing anything. After that, the installation path will be automatically generated, so enter the Y key.
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.
If an Auth error is displayed when connecting to the ADAM OPERATION UI, please check the FAQ below.
ADAM OPERATION UI Shows Auth Error - Technology Partner FAQ (En) - Confluence (atlassian.net)
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.
Please refer to here for the instruction of Resource Monitor.
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).
$ 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/
The installation is completed.
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.
<AdamAppSDK installation directory>/src/adamapp
The Python source code should be placed below.
<AdamAppSDK installation directory>/src/adamapp-py
Thus, source codes of the sample program (SkeltonSampleApp) should be placed in the following directory.
<AdamAppSDK installation directory>/src/adamapp/additional_info_sample_app
When you generate new AdamApp, also generate the following directory and place the source files, header files and Makefile in there.
<AdamAppSDK installation directory>/src/adamapp/<directory name of the new AdamApp>
It’s recommended that you copy and modify additional_info_sample_app directory to generate new application for ease.
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.
*For Python, we recommend using the jpeg_app directory.
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.
Addressable parameters are as follows:
When creating an AdamApp that runs on i-pro ambaCV2X model ipro-ambaCV2X
*When creating an AdamApp that runs on i-pro ambaCV2X model
$ 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
$ cd <directory of installed AdamAppSDK> $ cd src/adamapp/additional_info_sample_app $ make
The following error may occur during make.make: execvp: <AdamAppSDK installation directory>/tool/adamapp_configurator: Permission denied
In that case, please set the permissions of adamapp_configurator as shown below and make again.cd <AdamAppSDK installation directory>/toolsudo chmod +x adamapp_configurator
Operation check of the sample application
Install the created "AdditionalInfoSampleApp.ext" to the camera and check the operation.
Here, access the camera from the web browser as shown below and try the installation.
Install from the green frame of the image. Press the file selection button, select the created "AdditionalInfoSampleApp.ext", and execute the installation.
When the installation is complete, press the red frame button in the image and check the operation of the sample application.
If the string similar to following is displayed on the application screen, the establish of the development environment is successful.
{"r_appDataType":"0","r_appData":"e3tMYW5ndWFnZTowfX0="}