Table of contents
...
| Table of Contents | ||||
|---|---|---|---|---|
|
Introduction
...
This chapter shows how you can execute, for example, to install, start, stop or uninstall AdamApps over i-pro.
Also, this tutorial refers to the SDK installation directory as ${SDK_DIR}.
...
on i-
...
This section shows how to execute AdamApp.
Adam execution environment Considerations
Please consider the following when running the Adam execution environment.
Please be advised that you can only install encrypted AdamApp into the i-PRO camera sold in general. However, AdamAppSDK cannot generate encrypted AdamApp. Please request i-PRO Co., Ltd. to encrypt and install AdamApp. Unencrypted AdamApp can be installed into particular i-PRO camera using a development license.
How to set up Adam execution environment
You do not need to set up execution environment as an Adam execution environment is pre-installed on i-pro.
How to start Adam execution environment
You do not need a manual operation as the Adam execution environment and HTTP server will start automatically when i-pro is turned on.
How to operate AdamApps: Install, Start, Stop, Uninstall, etc.
You have two methods to operate AdamApp over i-pro. One is by using Adam Control Extension and another is by using an operation display of i-pro camera. Method 1 “Using Adam Control Extension“ and Method 2 “Using the operation page of i-pro Camera“ are explained below.
Method 1: Using Adam Control Extension
This section shows how to operate AdamApp (installing, starting, stopping, uninstalling and more) while the machine’s Adam execution environment is in operation.
(1) Launch Chrome browser (Chrome version 6.0 or later)
First, launch Chrome browser. User interface to operate AdamApps is provided as an extension of Chrome browser.
(2) Start Adam Control Extension
Click the "Extensions" button on the right side of the address bar in Chrome and click "Adam application manager for i-pro".
...
(3) Connect with Adam execution environment
Enter the IP address of the camera in Target and click the Connect button.
...
However, you cannot connect to the camera unless you are logged in to the camera.
If you cannot connect, enter the camera's IP address (eg 192.168.0.10) in the browser URL as shown below, and click the "Connect" button while logged into the camera.
...
(4) Install AdamApp
Select an AdamApp to install.
...
Finish installation.
...
(5) Start AdamApp
...
(6) Stop AdamApp
...
(7) Update AdamApp
...
(8) Uninstall AdamApp
...
Method 2: Using the operation page of i-pro Camera
(1) Open a browser (Internet Explorer 7 or later)
Open Internet Explore to install AdamApps. The operation page is supported by Internet Explorer 7 or later.
(2) Access the extended software operation page
Access the following URL to install AdamApps to i-pro.
<http://<IP Address of i-pro>/admin/setup_ext_software.html
The operating page appears once you access the URL.
...
(3) Install AdamApp
The installation will begin by selecting an AdamApp you want to install and click “Execute”.
...
The following page appears when the installation completes.
...
(4) Start AdamApp
To start an AdamApp, turn on “Operation content” in the “Operation sched.” in “Ext.software”, or execute “startAdamApp.sh” script from command line. AdamApp SDK comes with Adam Control Extension and “startAdamApp.sh” to start AdamApp.
Please refer to “Method 1: Using Adam Control Extension“ when using Adam Control ExtensionPRO camera.
| Info |
|---|
Only encrypted AdamApp can be installed into i-PRO camera on the market. Non-encrypted app can be installed only for cameras that you have requested development license for the camera. Please visit here to request encryption or development license. |
There are various methods to install app to camera
Camera web browser is easy way for one camera.
Developer tool “Adam control extension” is also easy way, but this is only for developer.
i-PRO Configuration Tool (iCT) is useful when user wants to install or update app for multiple cameras at the same time.
Control app via WEB API from partner’s system
1. Camera web browser
...
(1) Access the camera using web browser, http://<ip>.
(2) Move to configuration page [Ext software] - [Software mng.].
(3)Choose File and Execute
...
(4)Installed app will be appeared with uninstall button.
...
(5) Start and stop AdamApp
Installed app will start and stop automatically according to “Operation sched.” configuration.
Default is always running.
...
In addition, AdamApp SDK provides script “startAdamApp.sh” to start AdamApp and “stopAdamApp.sh” to stop it.
A shell script must be executed as indicated below when using “startAdamApp.sh shell script. Note that there are macro variables at the beginning of starAdamApp.sh script that specify the information of the surveillance camera. Please set up these variables with the IP address (IPRO_ADDR), the username (IPRO_USER) and the password (IPRO_PASSWD) before the execution.
| Code Block |
|---|
$ cd ${SDK_DIR}/tool/adamapp
$ ./startAdamApp <AdamApp’s FuncID (in decimal)>
##### AdamApp Information #####
FUNC_ID=257
INSTALL_ID=0DAF95AC
##### start application result #####
{} |
...
AdamApp を停止します。i-pro の操作ページでは、「拡張ソフトウェア」の「動作スケジュール」画面にて、「動作内容」を「Off」に設定することで開始することができます。また、AdamAppSDK では、Adam Control Extension、及び、AdamApp 停止用シェルスクリプト stopAdamApp.sh を用意しています。
Adam Control Extension を利用する場合は、i-proでAdamAppsを実行するの「方法 1: Adam Control Extensionを使用する」を参照してください。
stopAdamApp.sh シェルスクリプトを利用する場合は、下記のようにシェルスクリプトを実行してください。なお、stopAdamApp.sh スクリプトの先頭に、監視カメラの情報を設定するマクロ変数があります。これらのマクロ変数に、監視カメラの IP アドレス(IPRO_ADDR マクロ)、及び、ユーザ名(IPRO_USER マクロ)とパスワード(IPRO_PASSWD マクロ)を設定したのち、このスクリプトを実行してください。
| Code Block |
|---|
$ cd ${SDK_DIR}/tool/adamapp
$ ./stopAdamApp <AdamApp’s FuncID (in decimal)>
##### AdamApp Information #####
FUNC_ID=257
INSTALL_ID=0DAF95AC
##### stop application result #####
{} |
* ${SDK_DIR} is the installation directory.
2. Adam Control Extension (Google Chrome extension tool)
...
2.1 How to install
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.
...
| Info |
|---|
If an Auth error is displayed when connecting to the ADAM OPERATION UI, please check the FAQ below. |
2.2 How to use
(1) Open Google Chrome (version 6.0 or later), access to camera(http://<ip>) AdamApp のアンインストール
AdamApp のアンインストールは、i-pro の操作ページを使って行います。拡張ソフトウェアの操作ページにアクセスします。
<http://<IP Address of i-pro>/admin/setup_ext_software.html
アクセスに成功すると、下記の操作ページが表示されます。 この画面中の「Uninstall」ボタンを押すと、アンインストールが始まります。
...
アンインストールが完了すると、下記の画面になります。
...
Adam 実行環境の停止方法
i-pro では、電源 off すると、Adam 実行環境と、HTTP サーバが終了します。このため、終了のために、新規の作業はありません。and login in advance.
(2) Click the "Extensions" button on the right side of the address bar in Chrome and click "Adam application manager for i-pro".
...
(3) Connect with Adam execution environment
Enter the IP address of the camera and click the Connect button.
When you cannot connect, please do step (1), access to the camera in advance.
| Info |
|---|
If you have not accessed the camera using the same browser as in step (1), you will not be able to connect even if you press the "Connect" button. |
...
(4) Install AdamApp
Select an AdamApp to install.
...
Finish installation.
...
(5) Start AdamApp
...
(6) Stop AdamApp
...
(7) Update AdamApp
...
(8) Uninstall AdamApp
...
3. i-PRO Configuration Tool
...
Download from i-PRO Configuration Tool from https://i-pro.com/products%5fand%5fsolutions/en/surveillance/learning-and-support/tools/ict .
Please refer to the manual for basic usage.
(1)Detect cameras on the network
(2)From the menu [Ext. Software Management]- [App. installation/Update], select cameras that you want to install app, select Partner Applications on right side, select app file and Start.
...
4. Control app via WEB API from partner’s system
...
Camera firmware support CGI for app installation “/cgi-bin/adam_install.cgi”, updating “/cgi-bin/addon_update“, and uninstallation ”/cgi-bin/addon_uninstall“. Refer to CGI documentation for the detail.
ADAM WEB API provides start and stop API that are also used in Adam Control Extension (Google Chrome extension tool). Refer to SDK documentation “AdamWebAPI_Specification_Vx_xx.pdf“ for the detail.