iSMAVONTROLLI DMP220en iC Smart View User Manual

iSMAVONTROLLI DMP220en iC Smart View

iC SmartView
User Manual

Introduction

The iC SmartView is an app designed for the iSMA CONTROLLI Android panels, offering comprehensive controllers management and seamless access throughout the building. The iC SmartView simplifies the process of managing credentials with a primary focus on facilitating easy logins and access to Niagara stations and other HTML5 web servers, thereby enhancing building maintenance and management. Once entered, the credentials for the Niagara station or controller’s web server need only be input once, as the app ensures that users are automatically logged back in with each log-out or restart of the Android panel. When operating in the Kiosk mode, the application becomes dedicated to this specific purpose, preventing the use of any other applications on the panel. To exit the Kiosk mode, a password is required, ensuring controlled access to the device. The application offers remote management of its functions using rest API, which allows remote control of the panel.
This user manual provides an in-depth exploration of iC SmartView’s features .

Revision History

• new design
• full screen mode upgrade
• auto-update function added
• LED API added
• screensaver
• light and dark modes

Quick Start Guide
Getting started with iC SmartView is easy! The QuickStart Guide provides an overview of the application’s key features, allowing users to take full advantage of its potential. The Quick Start Guide is available from a separate tile or, when deleted, from the device settings. The Quick Start guide describes the application’s features and includes quick-start steps and videos for the following actions:

• adding a new view:
  • customizing a tile;
  • auto-login;
  • PIN protection;
• UI configuration:
  • hiding a navigation bar;
  • hiding a system navigation;
  • switching on a screensaver;
  • switching a theme mode;
• kiosk mode:
  • accessing kiosk mode settings;
  • restricting panel access;
  • setting kiosk unlock password;
  • managing connections in the kiosk mode;
• import/export settings:
  • accessing import/export settings;
  • saving application settings;
  • importing saved settings;
• Rest API:
  • accessing API settings;
  • enabling API versions;
  • defining API credentials;
• auto update:
  • accessing auto update settings;
  • enabling automatic version checks;
  • manually checking for updates.

Installation

• The iC SmartView application is exclusively designed to be installed on iSMA CONTROLLI branded Android panels. To enhance user convenience, this application comes pre-installed on every panel, ensuring seamless accessibility from the moment of power-up. In the event that the panel is reset to factory defaults, the iC_SmartView.apk is readily available for installation. Users can easily obtain the application by downloading it from the web or directly opening it from a USB drive.
• Note: The application includes a built-in auto-update feature, which has been available since the 5.0 version.
• This feature is, by default, disabled to provide users with control over updates. However, when an Internet connection is available, users can conveniently update the application directly from within the application itself, ensuring that they always have access to the latest enhancements and security updates.

Logging In

Adding Station
When the application turns on, the main screen, which allows for adding multiple stations, appears. To add a new Niagara station, touch an Add View button:

• Enter credentials:
  • panel name;
  • panel url
• and save them. Then, select a tile background file or color (from a palette or entering a hex number).
• Logging into the station is available with two options to check:
  • Enable Autologin feature, and
  • Protect with pin.

Autologin
Checking the Enable Autologin feature extends the username and password fields. Saved, the credentials are remembered, and the station is automatically logged from the panel. If the option remains unchecked, logging in is redirected to an external login website (Niagara or other ).

• Note: If there are any problems with logging in, it is advised to leave the option unchecked, which redirects to the Niagara or other login website and enables logging in there.
• Please note that it supports logging in to any controller, which enables HTML5 graphics.
• Note: If there are any problems with opening of the login page, please add the “/login.html” or “/prelogin” part at the end of the station’s url, or add any other extension that leads the user to the login page.
• Note: To enable a proper functioning of autologin, please remember to add a port number after a panel’s IP address:
  • :443 for https connection;
  • :80 for http connection,

For example: https://168.192.1.1:443.
Note: Selecting the autologin feature is available from the iSMA Android Application 4.0.

PIN Protection

• Checking the Protect with pin option enables the station to require entering a pin number after a set time of inactivity in the Kiosk mode. Go to the Kiosk mode settings for more information about entering the Kiosk mode and setting the pin lock timeout.
• After successful logging in, the application goes back to the main screen with a list of added stations.

Station Menu

• The three-dots button in the bottom right corner of the station tile extends the station menu:
  • Edit: edits the station credentials;
  • Delete: deletes the station;
  • Home station: can be chosen only for one station; the chosen station will be automatically logged in after restarting or turning on the panel (Disable home station option appears once for the selected home station).

Settings

• The Setting button in the top right corner of the main view opens the application settings:
• Available settings:
  • UI
  • Kiosk Mode
  • Lighting Color
  • Pin Lock
  • Import/Export
  • Auto Restart
  • Rest API
  • Updates

UI

The UI settings allow to adjust the following elements:

• Navigation hiding: causes the application to automatically hide a navigation bar after a set period of time;
• Navigation hiding delay: sets time after which the navigation bar is hidden; Fullscreen: hides system navigation outside of the kiosk mode;
• Enable screensaver: allows to switch on a screensaver after a set period of inactivity; Screensaver delay [s]: allows to set the time of inactivity after which the screensaver is started;
• Enable screensaver graphic mode:  allows to switch on a graphic mode on a screensaver (with a floating graphic file);
• Screensaver graphic:  allows to select a file, which will be floating on a screensaver; by default, it is the iSMA CONTROLLI logo; supported formats: .png, .jpg;
• Theme mode: allows to switch between a light and dark (default) mode of the application (or allows to set the panel’s default setting).

Kiosk Mode

• Kiosk mode: restricts a panel access to the iC SmartView application alone. Unlocking requires an admin password.
• The kiosk mode settings allow to switch the kiosk mode on and off, set the admin password to unlock it, and set access to connections in the kiosk mode.
• Kiosk mode: switches the kiosk mode on and off;
• Kiosk unlock password: allows to set a password required to access settings when the kiosk mode is active;
  • Default password: password
• Note: While setting the unlock password, it is required to type it twice for confirmation.
• Allow connections management in kiosk: allows the user to add, remove, and edit connections in the kiosk mode.

Lighting Color

• Note: Available only on panels equipped with the LED bar.
• The Lighting color settings allow to switch on and off and choose the color of the panel’s LED lighting. Setting the lighting color is also available using the Rest API. Please refer to the Rest API manual.

Pin Lock

• The pin lock settings allow to enable an automatic pin lock required to access connection settings in the kiosk mode.
• Automatic pin lock: switches the pin lock on and off;
• Pin lock timeout: allows to set the time after which entering pin is required.

Import/Export

Export of Settings

• The Export option allows to export application settings or settings and views to a .json file.
• To export application settings, follow the below steps:
  • Step 1: Select the Export settings or Export setting with views (exports settings along with connection data).
  • Step 2: New window shows up. A default name of the file is ’iSMA_export.json‘ but it is freely editable; also at this point the user has to pick the location of the file (touch the three dashes icon in the left top corner of the screen).

Import of Settings

• The Import option allows to import application settings or settings and views from a .json file.

• To import application settings, follow the below steps:

  • Step 1 : Select the Import settings.
    Note: Importing settings overwrites current settings, including added connections.

  • Step 2: Choose a file to import (touch the three dashes icon in the left top corner of the screen); it can be downloaded from the panel or any other storage source connected to the panel.

Auto Restart
The Auto restart option enables a daily restart of the panel at a selected time.

• Enable auto restart: switches the auto restart option on and off;
• Restart time: sets the time for auto restart.

Rest API
The API setting allow to switch on and off available Rest API interface .

• Enable API v1: enables the Rest API V1.0.0. interface;
• Enable API v2: enables the Rest API V2.0.0. interface;
• API username: allows to set the username for the Rest API interface;
• API password: allows to set the password for the Rest API interface;

Rest API

• The iC SmartView is equipped with the Rest API interface, which provides a remote access to some of application’s functions like a screensaver mode, LED bar color configuration, modifying saved connections, or managing screen brightness and inactivity timeout. Rest API, when enabled, is available on the port 5580.
• A complete functional documentation of the iC SmartView’s Rest API is available in the iC-SmartView_Rest-API.html document. It provides commands in the following programming languages:
  • Curl;
  • Java;
  • Java for Android;
  • Obj-C;
  • JavaScript;
  • C#;
  • PHP;
  • Perl;
  • Python.
• The Rest API for the iC SmartView is available in two versions.

Rest API V1.0.0

• The API V1.0.0 has the following functionalities:
  • managing the Kiosk mode;
  • managing an autostart connection view;
  • adding, editing, and removing connection views.
• Note: Rest API does not require an additional authentication. Make sure to use the Rest API V.1.0.0 only on a secured network.

Rest API V2.0.0

• The API V2.0.0 has the following functionalities:
  • enables an HTTP basic authentication;
  • managing screen brightness and timeout;
  • playing tunes on a device’s speaker;
  • protection with a configurable username and password;
• LED management.

Note: Taking into consideration required functionalities, enable the relevant Rest API version in the application’s menu.

Updates
Updating from the iSMA Android Application V4.2.0 to iC SmartView V5.0

• Step 1:  Download the latest version of the iC SmartView.apk to the PC or directly to the Android panel.
• Step 2: Connect the panel to the PC or copy the iC SmartView.apk to the pendrive external memory.
• Step 3 : Copy the downloaded .apk file to the panel’s internal memory.
• Step 4: Open the file’s location on the panel and open the .apk file. The upgrade is started automatically.

Auto Update
From the iC SmartView, it is possible to use the auto update function, which automatically checks the availability of a new version of application and performs the installation.

• Enable app auto update: (disabled by default) switches the auto update function on and off;
• Check for updates button.

Language

Changing Language

• There is a possibility to change the language of the application. The list of added translations includes:
  • PL;
  • DE;
  • CZ;
  • IT;
  • HU;
  • LV.
• The iSMA Android application will be displayed in the system language, provided the language is included in the application list of languages. If the user sets the Android system language to one that is not available on the list, the application will be displayed in English. To change the system language, follow the below steps:
  • Step 1 : Go to the main menu of the Android panel PC–a round, white icon with dots at the bottom center of the screen:
  • Step 2: Go to the Settings:
  • Step 3: Go to the Language & input:
  • Step 4: Go to the Language, which expands the list of languages available to choose from. Tap the chosen language:

www.ismacontrolli.com
DMP220en | 5th Issue rev. 0 | 11/2023
iSMA CONTROLLI S.p.A. – Via Carlo Levi 52, 16010 Sant’Olcese (GE) – Italy | [email protected]

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>