How to install and run AdamApp

Owned by Tachibana Yuta (立花 裕太)
Last updated: Dec 02, 2024
5 min read

 

Table of contents

Introduction

This chapter shows how to install, start, stop or uninstall AdamApps on i-PRO camera.

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

  1. Camera web browser is easy way for one camera.

  2. Developer tool “Adam Operation UI” is also easy way, but this is only for developer.

  3. i-PRO Configuration Tool (iCT) is useful when user wants to install or update app for multiple cameras at the same time.

  4. 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

image-20240705-103612.png

(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.

$ cd ${SDK_DIR}/tool/adamapp $ ./startAdamApp <AdamApp’s FuncID (in decimal)> ##### AdamApp Information ##### FUNC_ID=257 INSTALL_ID=0DAF95AC ##### start application result ##### {}

 

$ 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 Operation UI (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.

If an Auth error is displayed when connecting to the ADAM OPERATION UI, please check the FAQ below.
https://dev-partner-en.i-pro.com/space/TPFAQEN/1105854654

2.2 How to use

(1) Open Google Chrome (version 6.0 or later), access to camera(http://<ip>) 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.

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.

https://i-pro.com/products_and_solutions/en/surveillance/learning-and-support/device-integration/i-pro-camera

 

  • ADAM WEB API provides start and stop API that are also used in Adam Operation UI (Google Chrome extension tool). Refer to SDK documentation “AdamWebAPI_Specification_Vx_xx.pdf“ for the detail.