目次

...

はじめに

...

SDK ver.1.71以前は、ambaCV2X用のアプリのみ作成が可能でしたが、
SDK ver.1.80以降は、ambaCV2X用アプリに加えambaCV5X用アプリの作成が可能となります。
この機能拡張に伴い、アプリ内のフォルダ構成やスクリプトファイルが変更されています。
そのため、SDK ver.1.71以前のSDKで開発されたアプリをSDK ver.1.80以降でコンパイルするためには、
ここで記す移行手順を実施して頂く必要があります。本ページで記す移行手順を実施して頂く必要があります。

このチュートリアルでは、SDK ver.1.71以前のインストールディレクトリを${SDK_DIR_ver.1.71}とし、SDK ver.1.80以降のインストールディレクトリを${SDK_DIR_ver.1.80}として記載します。

SDK ver.1.71以前の環境で開発/作成していたambaCV2X用アプリの移行手順

...

SDK ver.1.71以前の環境で開発/作成していたambaCV2X用アプリを、SDK ver.1.80以降の環境でambaCV2X用アプリを作成できるようにします。

SDK ver.1.71以前での移行準備

移行する前にSDK ver.1.71以前の環境で準備を行います。また、SDK ver.1.80は事前に取得しインストールを行っておいてください。

スクリプトファイルのバックアップ

setupフォルダに配置されているスクリプトファイル(install.sh など)に対し、アプリ固有の変更を施されている場合、変更したスクリプトファイルのバックアップを取得しておいてください。

移行するアプリフォルダのcleanとコピー

SDK ver.1.71以前の環境で、移行するアプリフォルダ内でmake cleanを実行してください。
skeleton_sampleSDK ver.1.71以前の環境で作製したアプリをhoge_app で実施した例を示します。とした例を示します。

$ cd ${SDK_DIR_ver.1.71}/src/adamapp/skeletonhoge_sample_app
$ make clean
[Example result]
 CLEAN bin/SkeletonSampleAppHogeApp
 CLEAN conf/profile.bin
 CLEAN conf/applicense.bin
 CLEAN conf/appConf.json
 CLEAN conf/development.key
 CLEAN SkeletonSampleAppHogeApp_V0_3_ambaCV2X.zip
 CLEAN SkeletonSampleAppHogeSampleApp_V0_3_ambaCV2X.ext
 CLEAN SkeletonSampleAppHogeSampleApp

cleanが完了したらアプリフォルダをSDK ver.1.80環境にコピーします。

${SDK_DIR_ver.1.80}/src/adamapp/skeletonhoge_sample_app

Makefileの修正

アプリフォルダ内のMakefileをエディタで開き、下記修正を行ってください。

変更前：BUILD_DIR=

変更後：BUILD_DIR= $(ADAM_OBJ_DIR)

skeleton_sample_appの場合は下記に格納されています。通常は下記に格納されています。

${SDK_DIR_ver.1.80}/src/adamapp/skeleton_samplehoge_app/Makefile

機種固有データ(AIモデル等)の対応

AIモデル等の機種固有データを使用している場合、以下の対応が必要です。
※機種固有データを使用してない場合、次項へ進んでください。

新たにdata_CV2Xフォルダを作成し、dataフォルダ下に格納されている機種固有データを、フォルダ構成や属性などを変更せず、dataからdata_CV2Xに移動してください。
skeleton_samplehoge_appの場合は下記になります。

変更前：${SDK_DIR_ver.1.80}/src/adamapp/skeleton_samplehoge_app/data/cnn/sample.bin

変更後：${SDK_DIR_ver.1.80}/src/adamapp/skeleton_samplehoge_app/data_CV2X/cnn/sample.bin

スクリプトファイルの対応

スクリプトファイルに「アプリ固有の処理を行ってない場合」と「アプリ固有の変更を行っている場合」の移行手順は異なります。いずれかの移行手順を実施してください。
まず、「アプリ固有の処理を行ってない場合」の移行手順を説明します。

スクリプトファイルの対応：アプリ固有の処理を行ってない場合

スクリプトファイルの変更

configuration.txtを編集します。skeleton_sampletxtを編集します。hoge_appの場合は下記に格納されています。

${SDK_DIR_ver.1.80}/src/adamapp/skeletonhoge_sample_app/configuration.txt

Script files Informationの下記3項目を記載通りに編集してください。

...

setupフォルダの削除

setupフォルダを削除します。hoge_appの場合は下記に格納されています。

${SDK_DIR_ver.1.80}/src/adamapp/hoge_app/setup

スクリプトファイルの対応：アプリ固有の変更を行っている場合

スクリプトファイルの変更

SDK ver.1.80ではスクリプトファイル[install.sh/update.sh/modelSwitching.sh]が下記フォルダに格納されています。

...

configration.txtの編集

登録時/更新時のスクリプト実行が必須のため、下記のconfigration.txtファイルを編集します。

...

INSTALLER install.sh
UPDATER update.sh
UNINSTALLER uninstall.sh

install.shの編集

install.shの先頭で、modelSwitching.shを呼ぶように編集してください。
${SDK_DIR_ver.1.80}/src/adamapp/.setup/install.sh　を参考にしてください。

update.shの編集

update.shの先頭で、modelSwitching.shを呼ぶように編集してください。
${SDK_DIR_ver.1.80}/src/adamapp/.setup/update.sh　を参考にしてください。

uninstall.shについて

削除時に必要な処理は特にありませんので、uninstall.shは削除してください。
独自処理を加えている場合は何も編集する必要はありません。

make方法

ambaCV2X用アプリのmake手順は、SDK ver.1.71以前から変更有りません。下記を参考に実施してください。

https://iproiot.atlassian.net/wiki/spaces/TPFAQ/pages/1027771372/AdamApp#AdamApp-%E3%81%AE%E3%83%93%E3%83%AB%E3%83%89%E3%81%A8%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E7%94%9F%E6%88%90

SDK ver.1.80環境でambaCV5X用アプリの作成手順

...

ここまでの手順で、SDK ver.1.71以前の環境で開発/作成していたambaCV2X用アプリをSDK ver.1.80環境で作成できるようになりました。続いて、SDK ver.1.71以前の環境で開発/作成していたアプリをambaCV5X用として作成できるようにします。

前準備として「SDK ver.1.71以前の環境で開発/作成していたambaCV2X用アプリの移行手順」を全て終えている必要があります。

ambaCV5X用toolchainの登録

...

Info
Dockerを使ったiPRO Camera SDKアプリの開発環境構築 に従って開発環境を構築している場合、すでに開発環境にambaCV5X用toolchainもインストールされていますので「ambaCV5X用toolchainの登録」手順は不要です。

i-pro の ambaCV5X モデル向けの AdamApp を作成するには、SDKに含まれている Ambarella_CortexA76_Toolchain_GCC12.1_202304 をインストールしてく ださい。toolchainは下記にあります。
${SDK_DIR_ver.1.80}/.devcontainer/Ambarella_CortexA76_Toolchain_GCC12.1_202304.tar.xz

ambaCV5X モデル以外の場合は適宜読み替えてください。

下記のようにファイルを実行して、クロスコンパイラをインストールし てください。

Note
VirtualBox上の環境の場合、共有ディレクトリ上ではインストールに失敗する可能性がありますので、Ubuntu上のディレクトリにてインストールしてください。

Code Block
$ sudo apt-get install python3 $ cd ${SDK_DIR_ver.1.80}/.devcontainer $ tar xvf Ambarella_CortexA76_Toolchain_GCC12.1_202304.tar.xz $ cd Ambarella_CortexA76_Toolchain_GCC12.1_202304 $ sudo chmod +x ubuntuToolChain-linux5.15-202304 $ ./ubuntuToolChain-linux5.15-202304

Info
./ubuntuToolChain-linux5.15-202304を実行したときにTOOLCHAIN PATH[/usr/local]: の入力を求められた場合、何も入力せずにエンターキーを押下します。その後、インストール先パスが自動生成されますのでYキーを入力してください。

機種固有データ(AIモデル等)の対応

AIモデル等の機種固有データを使用している場合は、ここで記載している手順に従って対応してください。機種固有データを使用していない場合は、対応不要ですので次項に進んでください。AIモデル等の機種固有データを使用している場合は、本章で記載している手順に従って対応してください。機種固有データを使用していない場合は、対応不要ですので次項に進んでください。

事前に各自でambaCV5X用の機種固有データを準備しておいてください。

アプリフォルダに新たに[data_CV5X]フォルダを作成し、準備したambaCV5x用の固有データを格納してください。AIモデルの機種固有データ「***.bin」を例にすると、下記の構成になります。

[C/C++]
${SDK_DIR_ver.1.80}/src/adamapp/[任意のサンプルアプリ]/data_CV5X/cnn/***.bin

[Python]
${SDK_DIR_ver.1.80}/src/adamapp-py/[任意のサンプルアプリ]/data_CV5X/cnn/***.bin

外部ライブラリの対応

外部ライブラリ「lib***.so」などを使用している場合は、ここで記載している手順に従って対応してください。外部ライブラリを使用していない場合は、対応不要ですので次項に進んでください。so」などを使用している場合は、本章で記載している手順に従って対応してください。外部ライブラリを使用していない場合は、対応不要ですので次項に進んでください。

事前にambaCV5X用外部ライブラリを準備し、「aarch64-linux-gnu_CV5X」フォルダを新規作成して格納してください。gnu」フォルダに格納してください。ambaCV2X用外部ライブラリをそのまま流用可能であれば、そのまま利用ください。

ambaCV5X用外部ライブラリのデータ「lib***.so」を例にすると、下記の構成になります。

[C/C++]
${SDK_DIR_ver.1.80}/src/adamapp/[任意のサンプルアプリ]/external/lib/aarch64-linux-gnu_CV5X/lib***.so

[Python]
${SDK_DIR_ver.1.80}/src/adamapp-py/[任意のサンプルアプリ]/external/lib/aarch64-linux-gnu_CV5X/lib***.so

CV52用のPythonアプリの場合

SDK ver.1.80以前で開発したCV2x用のPythonアプリを、SDK ver.2.00以降でCV52用アプリを作成する場合、下記手順を実施いただく必要があります。Python版のみですので、C版は実施不要です。

ここではSDK ver.2.00以降のディレクトリを${SDK_DIR_ver2.00}とします。

SDK ver.1.80以降で動作していた開発アプリ(hoge_sample_appとします)を下記のように移動します。

${SDK_DIR_ver2.00}\src\adamapp-py\hoge_sample_app

SDK ver.2.00の下記フォルダをコピーします。

${SDK_DIR_ver2.00}\src\adamapp-py\additional_info_sample_app\.c_cxx_src

下記構成になるように移行した開発アプリフォルダにペーストします。

${SDK_DIR_ver2.00}\src\adamapp-py\hoge_sample_app\.c_cxx_src

移行が完了したらビルドして動作することを確認してください。

make方法

ambaCV5X用アプリのmake手順は、setup_env.shの引数を[ipro-ambaCV5X]に変更するだけで、他はambaCV2Xの場合と同じです。

$ cd ${SDK_DIR_ver.1.80}
$ source setup_env.sh ipro-ambaCV5X

makeの手順について詳細はこちらを参照ください。