android deployment configurator - cipherlab

130
Android Deployment Configurator For Android™ 9700A RS30 RS31 RS50 RS51 RK25(P) RK95 HERA51 Version 1.10

Upload: others

Post on 30-May-2022

13 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Android Deployment Configurator - CipherLab

Android Deployment Configurator

For Android™

9700A

RS30

RS31

RS50

RS51

RK25(P)

RK95

HERA51

Version 1.10

Page 2: Android Deployment Configurator - CipherLab

- 2 -

Android Deployment Configurator User Guide

Copyright © 2019~2020 CIPHERLAB CO., LTD.

All rights reserved

The software contains proprietary information of its owner; it is provided under a license

agreement containing restrictions on use and disclosure and is also protected by copyright

law. Reverse engineering of the software is prohibited.

Due to continued product development, this information may change without notice. The

information and intellectual property contained herein is confidential between the owner

and the client and remains the exclusive property of the owner. If having any problems in

the documentation, please report them to us in writing. The owner does not warrant that

this document is error-free.

No part of this publication may be reproduced, stored in a retrieval system, or transmitted

in any form or by any means, electronic, mechanical, photocopying, recording or otherwise

without the prior written permission of the owner.

For product consultancy and technical support, please contact the local sales representative.

Also, visit our website for more information.

All brand, logo, product and service, and trademark names are the property of their

registered owners.

Google, Google Play, Android and other marks are trademarks of Google Inc.

The editorial use of these names is for identification as well as to the benefit of the owners,

with no intention of infringement.

CIPHERLAB logo is a registered trademark of CIPHERLAB CO., LTD. All other brands,

products and services, and trademark names are the property of their registered owners.

The editorial use of these names is for identification as well as to the benefit of the owners,

with no intention of infringement.

CIPHERLAB CO., LTD.

Website: http://www.CipherLab.com

Page 3: Android Deployment Configurator - CipherLab

- 3 -

Release Notes

Release Notes

Version Date Notes

1.10 Sep. 02, 2020 Modified: Getting Started – sections and contents rearranged

Modified: 1.4.2 Advanced System Settings – ADC files backup

onto hidden partition added

Modified: 2.6.5 Barcode Reader – description revised

Modified: 2.6.9 Wi-Fi Settings – Wi-Fi Connection Timeout added

Modified: 2.6.11 Terminal Emulation – description for all functions added

Modified: 2.6.13 System Settings – Notifications & Sound added

Modified: 2.6.15 EZConfig (for RK25 UHF RFID Reader) –

power mode & descriptions for all tabs appended

New: 2.6.16 Enterprise Settings

New: 2.6.17 SIP Controller

Modified: Chapter 3 Barcode To Setting – only the Barcode Reader tab reserved for example demonstration

1.09 Feb. 4, 2020 RK95 mobile computer is supported.

Update all figures in Section 1.3 “Start with a New Project”.

Update the figures in “Enable a Profile” of Section 2.6.5 “Barcode Reader”.

Add “Advanced Data Formatting” to Section 2.6.5 “Barcode Reader” & Section 3.3 “Barcode Reader”.

Add description about “Performance Mode” & “Balance Mode” to

“Battery” part in Section 2.6.13 “System Settings” and update the related figure.

Add description & figure about RK95 to “System” part in Section 2.6.13 “System Settings”.

1.08 Nov. 15, 2019 Add “OS Image Update Method” to Section 1.5 “Main Screen”.

Update Section 1.5.3 “Preference”.

Update the releated figures.

1.07 August 6, 2019 RS51 mobile computer & HERA51 mobile POS are supported.

Update all figures.

Update Section 1.2 “Install ADC Program on PC”.

Update Section 1.3 “Start with a New Project”.

Add new Section 1.5.1 “Palette”.

Update Section 2.6 “Customize Project Setting”.

Add new Section 2.6.14 “Software Trigger”.

Add new Section 2.6.15 “EZConfig”.

Update Chapter 3: “Barcode To Setting”.

Add new Section 3.11 “Software Trigger”.

Add new Section 3.12 “EZConfig”.

1.06 Jan. 8, 2019 Add “Keypad Lock” to 2.6.7 “Button Assignment for RK25 & 9700A”.

Page 4: Android Deployment Configurator - CipherLab

- 4 -

Android Deployment Configurator User Guide

1.05 July 5, 2018 Add new Section 2.6.7 “Button Assignment for RK25 & 9700A”.

Modify the “Add Shortcuts” part of Section 2.6.12 “AppLock”.

Add “For RK25 & 9700A Mobile Computer” to Section 3.4 “Button Assignmenmt”.

Modify the “Add Shortcuts” part of Section 3.9 “AppLock”.

Update all related figures.

1.04 June 8, 2018 RK25 Mobile Computer is supported.

Add “Captive Portal Detection Enabled” to Section 2.6.8 & Section 3.6: Wi-Fi Setting.

Update Section 2.6.11 & Section 3.9: “AppLock”.

Add “Show filtered notifications” to Section 2.6.11: “AppLock”.

Update all related figures.

1.03 March 26, 2018 Revise the discription about "Update OS Image through SD Card" & "Activate System Update" in Section 1.5: “Main Screen”.

Add “Advanced” to Section 2.6.8 “Wi-Fi Settings” & Section 3.6 “Wi-Fi Settings”.

Revise the chapter heading of Chapter 3 from “Stage Tool” to

“BarcodeToSetting”.

Update all releated figures.

1.02 Dec. 21, 2017 Add “Option” part to Section 2.6.11 “AppLock”.

Add the description about new funtion “Home” to Section 2.6.12 “System Settings”.

Add new sections (3.2 Auto Run, 3.3 Barcode Reader, 3.4 Button

Assignment, 3.7 Cellular Data, 3.8 Terminal Emulation, and 3.9 AppLock) to Chapter 3 “BarcodeToSetting”.

Update all related figures.

1.01 Dec. 1st , 2017 Revise “Button Assigment” to Section 2.6.

Add “System Settings” to Section 2.6.

Add Section 2.7 “Deploy All Settings to Devices”.

Add Chapter 3 “BarcodeToSetting”.

Update all figures.

1.00 Apr 27, 2017 Initial release

Page 5: Android Deployment Configurator - CipherLab

5

Content

RELEASE NOTES ............................................................................................................................ - 3 -

CONTENT .......................................................................................................................................... 5

INTRODUCTION ................................................................................................................................. 7

1.1 ADC Features ........................................................................................................... 7

GETTING STARTED ............................................................................................................................ 8

1.1 Prerequisites ............................................................................................................ 9 1.1.1 ADC (Android Deployment Configurator) ................................................................ 9 1.1.2 WMDS (Wireless Mobile Deployment System) .................................................... 11

1.2 Installing ADC Program on PC ............................................................................... 11 1.3 Launching the ADC Tool ........................................................................................ 14

1.3.1 Startup Dialog ........................................................................................................ 15 1.4 Main Work Area ..................................................................................................... 18

1.4.1 Toolbar ................................................................................................................... 19 1.4.2 Advanced System Settings .................................................................................... 24 1.4.3 Checkbox List of Deployment Task ...................................................................... 28 1.4.4 Snackbar ................................................................................................................ 28

PROJECT MANAGEMENT ................................................................................................................. 29

2.1 Creating a New Project .......................................................................................... 30 2.2 Opening a Project .................................................................................................. 31 2.3 Deleting a Project .................................................................................................. 32 2.4 Duplicating a Project ............................................................................................. 33 2.5 Project Information ................................................................................................ 34 2.6 Customizing Project Configurations ..................................................................... 35

2.6.1 Configurable Settings ............................................................................................ 36 2.6.2 File Transfer ........................................................................................................... 38 2.6.3 Auto Installation ..................................................................................................... 40 2.6.4 Auto Run ................................................................................................................. 42 2.6.5 Barcode Reader (ReaderConfig Utility) ................................................................ 47 2.6.6 Button Assignment (for RS30, RS31, RS50, RS51, & HERA51) ........................ 65 2.6.7 Button Assignment (for RK25, RK95, & 9700A) ................................................. 67 2.6.8 Wireless Manager .................................................................................................. 77 2.6.9 Wi-Fi Settings ......................................................................................................... 78 2.6.10 Cellular Data .......................................................................................................... 81 2.6.11 Terminal Emulation ............................................................................................... 83 2.6.12 AppLock .................................................................................................................. 94 2.6.13 System Settings ................................................................................................... 105 2.6.14 Software Trigger ................................................................................................... 110 2.6.15 EZConfig (for RK25 UHF RFID Reader) .............................................................. 111 2.6.16 Enterprise Settings .............................................................................................. 117 2.6.17 SIP Controller ....................................................................................................... 118

2.7 Deploying All Settings to Devices ....................................................................... 119

BARCODE TO SETTING .................................................................................................................. 120

3.1 Getting Started..................................................................................................... 121

Page 6: Android Deployment Configurator - CipherLab

6

Android Deployment Configurator User Guide

3.2 Instructions on How to Generate Setting Barcodes .......................................... 122

MULTI-LANGUAGE SUPPORT ......................................................................................................... 125

4.1 Creating Your Own Language File ....................................................................... 126 4.2 Editing Your Own Language File ......................................................................... 130

Page 7: Android Deployment Configurator - CipherLab

7

Introduction

Introduction

ADC (Android Deployment Configurator) is a windows-based tool designed to configure the

Android device settings by creating a particular project.

1.1 ADC Features

Easy management interface for you to create/edit/save multiple projects

Comprehensive scope of configurable settings to fulfill various requirements:

- Transferring files (configuration files, applications or any files) from the server to

client mobile devices

- Auto installation of APK files

- Auto run of your designated applications

- Configuration of barcode reader settings, including symbology settings, scanning

preferences, notification, data output, etc.

- Turning On/Off wireless connection such as Wi-Fi, Bluetooth or Cellular data

- Configuration of Wi-Fi settings by giving SSID, security mechanism, password, etc.

- Configuration of cellular data settings

- Configuration of Terminal Emulation sessions properties

- Configuration of AppLock by defining the applications allowed as well as

showing/hiding notification bar, changing background display, setting up a

password to restrict the access, etc.

Password protection for critical project management actions

Adding languages to user interface and customization of wording

Device settings synchronization over USB connection

One-at-a-time device deployment over USB connection

Page 8: Android Deployment Configurator - CipherLab

8

Android Deployment Configurator User Guide

This chapter helps you get ready to use this program. If you're running ADC on PC for the

first time, everything starts with setting up a project.

In This Chapter

1.1 Prerequisites ................................................................ 9

1.2 Installing ADC Program on PC ....................................... 11

1.3 Launching the ADC Tool ............................................... 14

1.4 Main Work Area .......................................................... 18

Getting Started

Page 9: Android Deployment Configurator - CipherLab

9

Introduction

1.1 Prerequisites

1.1.1 ADC (Android Deployment Configurator)

In order for ADC to work on your computer:

Make sure the operating system on your computer is Windows 7 or 8 or 10.

The client mobile device is already set to USB debugging Mode.

The device is connected to your computer with the supplied USB cable. This is essential

for data synchronization (application list, Barcode Reader, Button Assignment,

Wireless Manager, AppLock etc.) and device deployment.

How Do I Enable Debugging Mode on My Device?

Please follow the steps below to turn on debugging mode on your device:

1) Go to All Apps | Settings | About phone | Build number.

Page 10: Android Deployment Configurator - CipherLab

10

Android Deployment Configurator User Guide

2) Tap Build number seven times. When the “You are now a developer!” prompt message

shows up, you have succeeded in entering developer mode.

3) Return to Settings and tap “ Developer options”, tap both Developer options and

USB debugging to on. Then tap “OK” in the confirmation window.

Page 11: Android Deployment Configurator - CipherLab

11

Introduction

1.1.2 WMDS (Wireless Mobile Deployment System)

The created ADC project can be deployed to multiple client devices by the WMDS tool. The

WMDS (Wireless Mobile Deployment System) software package consists of two parts as

follows:

WMDS Components Descriptions

WMDS Windows-based tool deploying configurations to multiple clients.

WMDS Agent WMDS agent, with .APK filename extension, is installed on the mobile device as the client program.

1.2 Installing ADC Program on PC

Download ADC program installer from http://wmds.cipherlab.com/ to your PC.

Double-click the ADC installer. The first dialog shows up asking you to select your language.

Click the drop-down menu to select your preferred language.

Page 12: Android Deployment Configurator - CipherLab

12

Android Deployment Configurator User Guide

Click Next to continue. Or click the Browse button to select your preferred destination

installation folder.

If you want to create a desktop shortcut after installation, click to check the checkbox. Then

click Next to continue.

Page 13: Android Deployment Configurator - CipherLab

13

Introduction

If you want to review or change any settings, click Back to return to the previous page. Click

Install to continue when you are sure everything is ready.

When you see the screen below, click the Finish button to end the installation.

Page 14: Android Deployment Configurator - CipherLab

14

Android Deployment Configurator User Guide

1.3 Launching the ADC Tool

Click the ADC item on the Start menu to launch Android Deployment Configurator.

Then please wait for initialization.

Page 15: Android Deployment Configurator - CipherLab

15

Introduction

1.3.1 Startup Dialog

Every time when ADC is launched, a dialog shows up first. If you don’t want to see this

dialog again, please remove the tick from the checkbox in the bottom-left corner.

In the dialog you can create a new project by clicking the pencil button.

In the New Project dialog, type the project name; click the drop-down menus to specify

device model, operating system, reader module, and keypad type. When finished, click the

green tick button to create a new project. Or click the cross button to cancel the task.

Page 16: Android Deployment Configurator - CipherLab

16

Android Deployment Configurator User Guide

Project Name – Please input a project name clear enough for you to easily identify

the purpose of this project.

Device Model – Click the drop-down menu to select the correct model name of the

device(s). By selecting “General (except RS30)”, this project will be applicable for

all the device models excluding RS30 mobile computers.

Operation System – Click the drop-down menu to select the operating system

depending on the device model you select.

Reader Module – If you want to configure Barcode Reader properties by this

project, please click the drop-down menu to select the reader type. While “Device

Model” is set to “General (except RS30)”, this drop-down menu lists all the reader

types.

Keypad Type – If you want to configure button settings by this project, please

click the drop-down menu to select the corresponding keypad type (only for

devices equipped with the physical keypad).

While “Device Model” is set to “General (except RS30)”, the “Keypad Type” drop-down

menu lists all the keypad types. If “None” is selected, the configurable keys listed on

“Button Assignment” will be based on RS51 mobile computer.

The figure of the keypad type you select.

Page 17: Android Deployment Configurator - CipherLab

17

Introduction

UHF RFID – By ticking the checkbox of “UHF RFID” in the bottom-left corner, you

can further use the EZConfig application to configure the UHF RFID Reader

embedded in CipheLab RK25 to read RFID tags.

Click “Create ” to finish creating a project and enter the Main Work Area.

Page 18: Android Deployment Configurator - CipherLab

18

Android Deployment Configurator User Guide

1.4 Main Work Area

After closing the Startup dialog, you will enter Main Work Area.

As the figure shown below, the main work area mainly consists of four parts: Toolbar, Advanced system settings, Checkbox list of deployment tasks, and Status bar.

Page 19: Android Deployment Configurator - CipherLab

19

Introduction

1.4.1 Toolbar

Functions of icons in the toolbar are depicted in the table below.

Button Description

New Project Click to create a new project.

Open Project Click to open an existing project.

Save Project Click to save changes made to the current project.

Save Project As Click to save the current project in a new project file.

Project Information Click to view information about the current project.

Open ADC Folder

Click to open the project folder where you may view, delete or duplicate project files. By default, all projects are saved in the C:\CipherLab\ADC directory which can be modified in Preferences settings.

Save to SD Card

Copy the current project to an SD card, and you can deploy the project to a device with this card. Please insert an SD card into a card reader and connect it to your PC in advance.

Deploy

Save and deploy the current project to the connected device via USB connection

Launch WMDS

This icon will appear once WMDS server is already installed on the same computer as ADC program. Click on it to launch WMDS program.

Palette To change the color of ADC background, icons, and borders.

Security Click to change security settings if necessary

Preferences Click to change preferences if necessary

Help

Click to access either the Help contents or the About information

Help Contents To open the ADC User Guide.

Page 20: Android Deployment Configurator - CipherLab

20

Android Deployment Configurator User Guide

Palette

Click the Palette button to bring the dialog customizing the color of ADC user interface,

including background and control items.

OK – Click “OK” to apply the user interface settings.

Cancel – Click “Cancel” to close the pop-up window without changing any

settings.

Background Color – Click to switch between Light and Dark to change the

background color. The default setting is Light.

Page 21: Android Deployment Configurator - CipherLab

21

Introduction

Current palette – Click the drop-down menu to select the color for the control

items. The default color is blue.

Page 22: Android Deployment Configurator - CipherLab

22

Android Deployment Configurator User Guide

Security

You can enable the password protection for certain features in this program.

1) Click the “Security ” button to bring up the dialog.

2) Enter and confirm your password if you want to enable password protection.

3) Click “Save ” to save the settings which will immediately take effect.

Save – Save the settings and close the pop-up window at the same time.

Cancel – Directly close the pop-up dialog without changing any settings.

Clear password – Clear the “Enter password (maximun 32 characters)” and

“Confirm password” fields.

Page 23: Android Deployment Configurator - CipherLab

23

Introduction

Preferences

Click “Preferences ” in the toolbar.

Item Description

Choose a display language

Choose a display language other than the default English if necessary. You may click “Add” to create your own language or “Edit” to customize wordings. See Multi-language Support.

Project location Change your project location if necessary. Click “Browse” to look through the folders on your PC to locate the folder you’d like to save your ADC projects.

Save log file by project

Decide whether to have logs saved (in ADC program folder) while working on your project. You may click “Clear log” to clear all log files if necessary.

Show dialog at Startup

Decide whether to show the startup dialog when ADC starts.

Show Snackbar

Decide whether to show the status message on Snackbar. If “Show Snackbar” is deselected, the warning message and hint message will be shown by windows message box instead as the right-hand figure shows.

Snackbar messages timeout

Click the drop-down menu to adjust snackbar messages timeout if necessary. See Snackar & Messages.

Save Cancel

Browse

Clear log

Delete

Edit

Add

Page 24: Android Deployment Configurator - CipherLab

24

Android Deployment Configurator User Guide

1.4.2 Advanced System Settings

Click the “Configure… ” icon on the right-hand side of “Advanced System Settings” to

bring up the window for selecting how to update the OS image on your device(s), and back

up ADC files to the hidden partition.

The buttons on the “Advanced System Settings” window deliver the following functions:

Apply – To save settings and close the window.

Cancel –Directly close the window without saving any settings.

Create 1D barcode – Click to create 1D barcodes that include the OS Image

update settings. Use your mobile computers to apply the configurations by

scanning the barcodes.

Create 2D barcode – Click to create a 2D barcode that include the OS Image

update settings. Use your mobile computers to apply the configurations by

scanning the barcode.

Page 25: Android Deployment Configurator - CipherLab

25

Introduction

Create PDF file – After you click “Create 1D barcode” or “Create 2D barcode”,

the “Create PDF file” button appears for generating the barcode saved in a PDF file,

the same file name with the project’s.

Update OS Image

Select between the radio buttons to specify the OS image update method, and make sure to

click “Apply ” to save the settings.

Item Description

Enable Select the checkbox to enable the execution of OS update on the device(s) for “Zip file in SD card” and “Activate System Update (OTA)”.

Zip file in SD card

Click the drop-down menu to select this item which will deploy a project to the mobile device using the SD card. Remember to give the file path (*.zip file with sdupgrade in its file name) of the image. With the correct file path, the OS image will be stored onto the SD card after you click the “Save current project to SD card” button in the toolbar.

Please make sure there is sufficient storage space on your SD card.

Zip file from URL Click the drop-down menu to select this item to deploy a project to the mobile device by giving the specific URL.

Activate System

Update (OTA)

Upon completion of deployment, the device will automatically check the latest OS image available over the Internet.

Please make sure the selected devices are capable of accessing Internet.

Page 26: Android Deployment Configurator - CipherLab

26

Android Deployment Configurator User Guide

By selecting “ZIP file from URL” or “Activate System Update (OTA)”, you can generate

barcodes to include the settings for your device(s) to scan for OS upgrade:

Depending on the barcode type you will use, click the “Create 1D barcode ” or “Create 2D

barcode ” button.

1) Click to turn the switch on and then click the “Create PDF file ” button to generate

the barcodes saved in the pdf file.

2) Print out the barcodes for your devices to scan to apply the configuration.

Page 27: Android Deployment Configurator - CipherLab

27

Introduction

Miscellaneous

Select the checkbox to back up ADC files onto the hidden partition.

Page 28: Android Deployment Configurator - CipherLab

28

Android Deployment Configurator User Guide

1.4.3 Checkbox List of Deployment Task

On the Specify your deployment task(s) checkbox list, check ONLY the settings that you

wish to be deployed in this project. Click “Configure… ” when you finish checking the

items and proceed to modify detailed settings of each checkbox (refer to Configurable

Deployment Tasks).

It is essential that you be careful with the selection made in “Specify your deployment task(s)”, for once you check an item whose relevant settings will all be written to the devices;

therefore, by checking “All Device Configuration”, you will have all the settings applied to

selected devices.

With the “Reboot after Deployment” checkbox enabled, the selected devices will

automatically start rebooting process upon completion of deployment.

1.4.4 Snackbar

Snackbar & Messages

The snackbar at the bottom gives information or feedback after you take an action. Certain

critical messages will also show in a pop-up window to catch your attention. To dismiss the

message, please click “OK” on the right-hand side of the snackbar. See Preferences on how

to adjust snackbar message timeout and turn off the pop-up messages.

Page 29: Android Deployment Configurator - CipherLab

29

Project Management

Project Management

Click “Open Project ” in the toolbar to open the project folder. You may view, delete or

duplicate project files. By default, all projects are saved in the path C:\CipherLab\ADC, which can be modified in Preferences.

In This Chapter

2.1 Creating a New Project ................................................ 30

2.2 Opening a Project ....................................................... 31

2.3 Deleting a Project ....................................................... 32

2.4 Duplicating a Project .................................................... 33

2.5 Project Info................................................................. 34

2.6 Customizing Project Configurations ................................ 35

2.7 Deploying All Settings to Devices ................................. 119

Page 30: Android Deployment Configurator - CipherLab

30

Android Deployment Configurator User Guide

2.1 Creating a New Project

1) From the startup dialog, click “New Project ” to create a project.

2) If the startup dialog has been dismissed,

click “New Project ” in the toolbar.

Define the scope of your project and click

“Create ”.

Project Name – Enter a name to identify your project.

Device Model – Specify which model will be used in the project.

Operation System – Specify which operating system the model is running.

Reader Module – Specify which barcode reader module is equipped on your device.

Keypad Type – Specify which type of keypad is equipped on your device.

UHF RFID – Select whether to configure the settings of the application EZConig

which is for CipheLab RK25 mobile computer to works with RK25 UHF RFID Reader

to read RFID tags.

New Project Cancel

Create Cancel

Page 31: Android Deployment Configurator - CipherLab

31

Project Management

2.2 Opening a Project

1) From the startup dialog, double-click a project or select a project and click “Open ”

if you already have some projects.

Item Description

Open Project: Select a

project and click “Open

Project” to open it.

Cancel: Directly close

the window without

opening any existing

project.

New Project: Open the

“New Project” window to

create a new project.

Copy to SD card: Save

the selected project to

the USB stick connected

to your PC.

2) If the startup dialog has been dismissed, click “Open Project ” in the toolbar.

3) On the project list, double-click the desired project or select the project and click “Open

” to open it.

Item Description

Open:

Open the selected

project.

Cancel: Directly

close the window

without opening any

existing project.

Delete:

Delete the project.

1

1

2

2

Page 32: Android Deployment Configurator - CipherLab

32

Android Deployment Configurator User Guide

2.3 Deleting a Project

If you want to delete an existing project, please:

1) Click “Open Project ” in the toolbar.

2) Then, select the project from the project list and click “Delete ”.

1

2

Page 33: Android Deployment Configurator - CipherLab

33

Project Management

2.4 Duplicating a Project

1) To duplicate an existing project, click “Open Project ” in the toolbar.

2) Click “Save Project As ”in the toolbar.

3) Change the project scope if necessary,

and then save it to a different project

name.

Click “Save ” after making changes

to the project scope.

4) On Main Screen, modify the configuration settings and click “Save ” in the toolbar to

save this new project.

Browse

Save Cancel

Page 34: Android Deployment Configurator - CipherLab

34

Android Deployment Configurator User Guide

2.5 Project Information

If you want to view the summary of the current project, please:

1) Click on “Project Information ” in the toolbar.

2) A Project Information window will pop up. You can click on “X” to close it.

Page 35: Android Deployment Configurator - CipherLab

35

Project Management

2.6 Customizing Project Configurations

Before going into detailed settings of the project configurations, please read carefully

through this chapter. In Specify your deployment task(s) area, click on “Configure… ”

Configurable Settings

Page 36: Android Deployment Configurator - CipherLab

36

Android Deployment Configurator User Guide

2.6.1 Configurable Settings

Item Description All Device

Configuration Click to select or deselect all device settings

File Transfer When the check box is selected with files specified in the configuration, the files will be copied to device while deploying.

Auto Installation

When the check box is selected with install files (.APK) specified in the configuration, the files will be copied to device while deploying and programs will be installed automatically upon completion of deployment.

Auto Run When the check box is selected with executable files specified in the configuration, the programs will be executed automatically when the device restarts.

Barcode Reader

When the check box is selected with changes made to its configuration, the Barcode Reader settings will be updated to device while deploying. (When you select the Barcode Reader Settings task, it will have the File Transfer task selected as well.)

Button Assignment When the check box is selected with changes made to its configuration, the Button Assignment settings will be updated to device while deploying.

Wireless Manager When the check box is selected with changes made to its configuration, the Wireless Manager settings will be updated to device while deploying.

Wi-Fi Settings When the check box is selected with changes made to its configuration, the Wi-Fi settings will be updated to device while deploying.

Cellular Data When the check box is selected with changes made to its configuration, the cellular data settings will be updated to device while deploying.

Terminal Emulation

When the check box is selected with changes made to its configuration, the Terminal Emulation settings will be updated to device, via file transfer, while deploying. (When you select the Terminal Emulation Settings task, it will have the File Transfer task selected as well.)

AppLock

When the check box is selected with changes made to its configuration, the AppLock settings will be updated to device, via file transfer, while deploying. (When you select the AppLock Settings task, it will have the File Transfer task selected as well.)

System Settings When the check box is selected with changes made to its configuration, the System Settings will be updated to device while deploying.

Software Trigger When the check box is selected with changes made to its configuration, the Software Trigger settings will be updated to device while deploying.

Page 37: Android Deployment Configurator - CipherLab

37

Project Management

EZConfig

When the check box is selected with changes made to its configuration, the EZConfig settings will be updated to device, via file transfer, while deploying. (When you select the EZConfig Settings task, it will have the File Transfer task selected as well.)

In the Configure Device Settings window, the buttons in the toolbar deliver the functions as

below:

Item Description

Apply: Click to save the settings and close the Configure Device Settings

window. Always remember to click Apply before you close the window.

Cancel: Directly close the Configure Device Settings window without saving

any settings.

Synchronize with all settings with Device: Instead of working on the

device configurations from scratch, you may fetch the current configurations

from the device which is connecting to your PC via USB connection.

Reset all settings to default: You may also click thisbutton to reset ALL

settings if necessary. For this synchronization to be carried out successfully,

please make sure the USB debugging mode on your device is already enabled (refer to How Do I Enable Debugging Mode on My Device?).

Create 1D barcode: Export and generate the settings as 1D barcodes for your

mobile computers to apply the configurations by scanning the barcodes.

Create 2D barcode: Export and generate the settings as 2D barcodes for your

mobile computers to apply the configurations by scanning the barcodes.

After completing the settings, return to Main Screen and remember to click “Save Project

” before exiting this program.

Page 38: Android Deployment Configurator - CipherLab

38

Android Deployment Configurator User Guide

2.6.2 File Transfer

The specified files will be copied to device while deploying.

1) Drag-and-drop any file(s) to the file list or click “Add File.. ” to browse your

computer to locate the file.

Add File.. – Add the file which is saved in your PC.

Add URL – Add the file from the internet by entering the filename and its link

location.

Delete – Delete the selected item.

Delete All– Delete all the removable items.

Page 39: Android Deployment Configurator - CipherLab

39

Project Management

2) Click the Location field to choose between the device internal storage or SD card and

then the Destination Path field to fill in the path to where the file shall be located. Please

make sure the path you manually input is valid.

– Move the selected item up.

– Move the selected item down.

3) Click on Apply before you close the Configure Device Settings window.

2 1

Please make sure the path you input here is the absolute location on the device and has to be precise.

Page 40: Android Deployment Configurator - CipherLab

40

Android Deployment Configurator User Guide

2.6.3 Auto Installation

With this configuration, the specified files will be copied to device while deploying and the

programs will be automatically installed upon completion of deployment.

Before an auto installation takes place on the device, please make sure to exit all the

running programs. Otherwise, your programs may not function correctly.

1) Drag-and-drop any file(s) to the file list or click Add button to browse your

computer to locate the file.

Add File.. – Add the file which is saved in your PC.

Add URL – Add the file from the internet by enter the filename and its link

location.

Page 41: Android Deployment Configurator - CipherLab

41

Project Management

Delete – Delete the selected item.

Delete All– Delete all the items.

– Move the selected item up.

– Move the selected item down.

2) Click on Apply before you close the Configure Device Settings window.

Page 42: Android Deployment Configurator - CipherLab

42

Android Deployment Configurator User Guide

2.6.4 Auto Run

With this configuration, the specified programs will be executed automatically when the

device restarts. During deployment, the new Auto Run app list will overwrite the previous

one. Therefore, if you check “Auto Run” item on the Specify your deployment task(s) on

Main screen, DO remember to configure the Auto Run app list here; otherwise, the previous Auto Run app list on your device will be overwritten by a blank list.

Please select the source of the application from the drop-down menu:

(a) File from auto installation

(b) File from device syncing

(c) Customer Defined app

Page 43: Android Deployment Configurator - CipherLab

43

Project Management

File from Auto Installation

If the source is "File from Auto Installation" and the source list is blank, you must

configure Auto Installation first. Click an entry and fill in the package name (please acquire

the package name from the application developer). Once you finish, select the File name

and click the Move Down button.

– Move all the files (on the Auto Installation list) down (to the Auto Run list).

– Move the selected file (on the Auto Installation list) down (to the Auto Run

list).

– Remove the selected file (from the Auto Run list).

– Remove all the files file (from the Auto Run list).

Page 44: Android Deployment Configurator - CipherLab

44

Android Deployment Configurator User Guide

File from Device Syncing

If your source is "File from device syncing" and the source list is blank, you must click

to sync with your device first. The small Sync button on the right is to synchronize with

device for available executable files. Once you finish, select the File name and click the

Move Down button.

– Move all the files (on the device syncing list) down (to the Auto Run list).

– Move the selected file (on the device syncing list) down (to the Auto Run list).

– Remove the selected file (from the Auto Run list).

– Remove all the files file (from the Auto Run list).

Page 45: Android Deployment Configurator - CipherLab

45

Project Management

Customer Defined app

If your source is "Customer Defined app", then you must click the Create button. In the File

text field, type the filename of the program. In the Package Name text field, type the full

name of this package (please acquire the package name from the application developer).

Once you finish, click the Move Down button.

– Create a new “Customer Defined app".

– Delete the selected Customer Defined app (on the Customer Defined app list)

– Move all the files (on the Customer Defined app list) down (to the Auto Run list).

– Move the selected file (on the Customer Defined app list) down (to the Auto Run list).

– Remove the selected file (from the Auto Run list).

– Remove all the files file (from the Auto Run list).

Page 46: Android Deployment Configurator - CipherLab

46

Android Deployment Configurator User Guide

Auto Run App List

1) Make sure you have selected the desired items and move them to the Selected Package

List below using Move Down button. Only the selected items will be saved to this

project and deployed to devices.

– Move the selected file (on the Auto Run list) upward to change its sorting order.

– Move the selected files file (on the Auto Run list) downward to change its sorting order.

2) Define the interval of each auto run application in Delay Time (second) if necessary.

3) Click on Apply before you close the Configure Device Settings window.

Page 47: Android Deployment Configurator - CipherLab

47

Project Management

2.6.5 Barcode Reader (ReaderConfig Utility)

To synchronize the device settings by ADC, please make sure that the app “ReaderConfig”

has been launched on the device for at least one time.

Note that pictures illustrated in this section are for demonstration purposes. The setting

options may differ depending on the equipped reader module.

New Profile – To create a new profile.

Edit Profile – To edit the selected profile.

Delete Profile – To delete the selected profile.

Copy Profile – To copy the selected profile and make changes from it.

Rename Profile – To rename the selected profile.

Reset current option – To reset the current option of this settings to

default.

Page 48: Android Deployment Configurator - CipherLab

48

Android Deployment Configurator User Guide

Profile Management

Creating a New Profile

Click “New Profile ” to open the “New Profile” dialog; then enter the profile name and

click “OK ” to create it.

Editing a New Profile

By double-clicking a profile or clicking a profile and then “Edit Profile ”, the profile

detailed window shows up. Make changes respectively to all setting tabs if necessary

(please refer to the mobile computer reference manual describing the RederConfig utility

for further details). And remember to click “Apply ” to save the settings before you

close the Detail and Configure Device Settings windows.

Page 49: Android Deployment Configurator - CipherLab

49

Project Management

Delete an Existing Profile

To delete a profile, simply click to select the profile and then click “Delete Profile ”.

Copy Profile

Please click the profile and then click to open the “Copy Profile” dialog. Enter a name

for the new profile and click “OK ” to make a copy.

Note:

An application can be set as the associated app to only one profile. Thus, the “Profile” part

will not be duplicated when copying a profile.

Rename a Profile

To rename a profile, click a profile and then click “Rename Profile ” to open the dialog.

Enter a new name for the profile and click “OK ” to change its name.

Page 50: Android Deployment Configurator - CipherLab

50

Android Deployment Configurator User Guide

Scanner Preferences

Click the Scanner Preferences tab to configure settings respectively.

Decode Timeout: Click the drop-down menu to specify the decoding timeout ranging from

1 to 9 seconds. Set the maximum time for the decoding process during a scan.

Redundancy Level: Click the drop-down menu to specify the redundancy level. Set how

many successful readings should be done before linear barcodes such as Codabar, MSI, and

Interleaved 2 of 5 can be decoded.

Security Level: Click the drop-down menu to specify the security level to ensure decoding

accuracy giving consideration to the printed quality of barcodes such as Code 128, Code 93,

and UPC/EAN. The higher the level is, the more security is ensured.

Inter-Char-Gap Size: Click the drop-down menu to specify the inter-character gap size

for Code 39 and Codabar. This option is to allow the digital scanner to adjust its decoding

standard so as to tolerate out-of-specification bar codes that are improperly printed out

(which may cause the inter-character size to become larger). Switch between Normal and

Large.

Scan Mode: Click the drop-down menu to specify the reader’s scanning behavior.

Presentation Mode Timeout: This option is available when Presentation is selected as the

scan mode. This defines the duration of how long Presentation mode stays active, after

which the laser light beam will automatically be disabled.

Aim Mode Timeout: This option is available when Aim Mode is selected as the scan mode.

Move the slider to limit the aiming time interval (1~30).

Page 51: Android Deployment Configurator - CipherLab

51

Project Management

Decoding Illumination: Select the checkbox to enable an LED light beam to aid barcode

reading.

Decoding Aiming Pattern: Select the checkbox to project a crosshair at the center of the

laser light beam to facilitate barcode reading.

Picklist Mode: When selected, only barcodes aligned at the crosshair of the laser light

beam will be decoded.

Display Mode: Select the checkbox to enable improved performance for reading barcodes

on electronic displays and mobile phones.

Inverse Type: Decide whether to disable or enable decoding inverse barcodes, or set as

auto.

Addon Redundancy: This function works when “auto-discriminate” is applied to UPC/EAN

addons. Move the slider to increase/decrease the number of times of supplemental

decoding of the same barcode in order to count as a valid read.

Illumination Power Level: Move the slider to increase/decrease the intensity of the LED

light beam to aid barcode reading.

Transmit AIM Code ID: Select the checkbox to enable transmitting AIM Code ID.

Data Output

Click the Data Output tab to configure settings respectively.

Page 52: Android Deployment Configurator - CipherLab

52

Android Deployment Configurator User Guide

Keyboard Emulation: Click the drop-down menu to specify the keyboard emulation. The

reader module treats decoded data as typed text and outputs it to the active application on

the mobile computer. Options include:

None: Disables keyboard emulation. The decoded data will be sent by the broadcast

intent message.

InputMethod: Allows the active application to receive characters or symbols that can

be input by the input method.

KeyEvent: Allows the active application to receive characters or symbols that can be

input by key events.

Intent Action: When Keyboard Emulation is set to "None", you can specify the intent

action.

Intent Data: When Keyboard Emulation is set to "None", you can specify the intent data.

Auto Enter: Add an ENTER character before or after each string of decoded data. The

ENTER character can be defined in the “Auto Enter Character” field below. This function

saves the trouble of pressing a confirmation key to accept each string of decoded data.

Options are:

Disable

Decoded data + Enter char

Enter char + Decoded data

Auto Enter character: Add a key code before or after the decoded data. If [Auto Enter] is

enabled, select the ENTER character to send. Options are:

None

Carriage Return

Tab

Space

Comma

Semicolon

Display Code Type: Click the right-hand button to open the ASCII table to prefix the

output data with code type information.

Display Code Length: Click the right-hand button to open the ASCII table to suffix the

output data with code length information.

Field Delimiter: Set the delimiter to separate the output barcode data to the following

pieces: code type, decoded barcode data, and code length (if applicable). Options are:

None

Comma

Semicolon

Full stop

Barcode Charset: Click the drop-down menu to specify the current decoding for barcode

data.

Clear Previous Data: By enabling this option, only the last scanned data entry will be

output.

Key Event Delay Time: Click the drop-down menu to specify the delay time.

Page 53: Android Deployment Configurator - CipherLab

53

Project Management

Advanced Data Formatting

Users can add rules defining the data format applied to the decoded data.

Click the Add button to bring up the dialog creating a new rule. Input the rule name in the

text field and click the green tick.

After a rule is created, double-click the rule or click the Edit button to configure further

details.

Page 54: Android Deployment Configurator - CipherLab

54

Android Deployment Configurator User Guide

Criteria

As the picture shown, control items are used to set the limits and requirements to filter the

decoded data. The decoded data meeting the criteria will be processed with the actions

defined below.

Barcode Input: Click the drop-down menu to select a particular barcode type to perform

the data formatting. All barcode types are selected by default.

String Length: Move the slider to define the length of decoded barcode.

String Position: This function works with “Specific String”. Move the slider to define the

particular position the specific string should be located. By selecting “0”, the specific string

can be in any position.

Specific String: Designate the string the decoded data must include.

Page 55: Android Deployment Configurator - CipherLab

55

Project Management

Actions

Click the Actions label to expand the setting page. And then click the Add button to bring up

the dialog creating a new action.

In the dialog, click the drop-down menu to specify a command and the button to bring up

the ASCII table to select the specified character (click the Save button to close the ASCII

table).

Command: The commands mainly consists of six types. Please refer to the tables as

follows.

Page 56: Android Deployment Configurator - CipherLab

56

Android Deployment Configurator User Guide

Sending Barcode Data

These actions affect the output character field and the output length (count of characters). All the

other kinds of actions must collaborated with the “Sending Barcode Data” actions to reformat the

barcode data to be sent out.

Command Description

Send up to character

To set a specific character as a period, and only the part anterior to this specific character will be output.

Example

The decoded

data: 0001112223334

Actions: Send data up to “3”.

The output data: 000111222

Send up to

To set how many characters to be output.

Example

The decoded data:

0001112223334

Actions: Send up to “3” characters.

The output data: 000

Send up To specific string

To send the part up till the specific string (this specific string is excluded).

Example

The decoded data:

0001112223334

Actions: Send up to the string “333”.

The output data: 000111222

Send remaining

This command works with those commands of “Move Cursor” to send the data posterior to the cursor.

Example

The decoded data:

0001112223334

Actions: Move cursor to next 1. Send all the data that remains.

The output data: 001112223334

Send remaining and skip

To send all the data (posterior to the cursor) aside from the last character(s) you set.

Example

The decoded data:

0001112223334

Actions: Send all the data that remains and skip the last 1.

The output data: 000111222333

Page 57: Android Deployment Configurator - CipherLab

57

Project Management

Cursor Movement

This group of actions must work with those “Sending Barcode Data” actions to define the start

position to output the decoded data.

Command Description

Move to start

To move the cursor to the very beginning.

Example

The decoded

data: 0001112223334

Actions: Move cursor to the start.

Send all the data that remains.

The output data: 0001112223334

Move to end

To move the cursor to the end.

Example

The decoded

data: 0001112223334

Actions: Move cursor to the end. Send all the data that remains.

The output data: None.

Move to character

To move the cursor in front of the specific character you set.

Example

The decoded data:

0001112223334

Actions: Move cursor to the character “2”. Send all the data that remains.

The output data: 2223334

Move to next

To move the cursor to the specific position from the beginning.

Example

The decoded data:

0001112223334

Actions: Move cursor to the next “5”. Send all the data that remains.

The output data: 12223334

Move to specific string

To move the cursor in front of the specific string you set.

Example

The decoded data:

0001112223334

Actions: Move cursor to the string “333”. Send all the data that remains.

The output data: 3334

Page 58: Android Deployment Configurator - CipherLab

58

Android Deployment Configurator User Guide

Data Replacement

Command Description

Replace String

To replace the specific string with the one you designate.

Example

The decoded data:

0001112223334

Actions: Replace the string “333” with “CCC”.

Send all the data that remains.

The output data: 000111222CCC4

Replace character

To replace the specific character with the one you designate.

Example

The decoded data:

0001112223334

Actions: Replace the character “0” with “C”. Send all the data that remains.

The output data: CCC1112223334

Data Removement

Command Description

Remove string

To delete the specific string.

Example

The decoded data:

0001112223334

Actions: Remove the string “222”.

Send all the data that remains.

The output data: 0001113334

Remove character

To delete the specific character.

Example

The decoded data:

0001112223334

Actions: Remove the character “3”. Send all the data that remains.

The output data: 0001112224

Page 59: Android Deployment Configurator - CipherLab

59

Project Management

Sending Character

Command Description

Send character

To add a specific character in front of the output data.

Example

The decoded data:

0001112223334

Actions: Send the character “C”.

Send up to “5” characters

The output data: C00011

Sending Key Event

Command Description

Send key event

To make a “Send key event” action to be effective, “Keyboard

Emulation” should be set as “KeyEvent”.

The following example is to output the data to two fields by

“KeyEvent”:

Example

The decoded

data: 21234569

Actions: Send data Next 4 Send KeyEvent 0x1D Send Data Next 4

The output data:

Note: The decoded data is processed by actions sequentially. The permutation of actions

affects the output data, that is, different permutations of actions may result in different

output data.

Page 60: Android Deployment Configurator - CipherLab

60

Android Deployment Configurator User Guide

Notification Settings

Notification Settings enables audible, visible and tactile feedback for scanning good read,

which helps notify the user of a successful decoding.

Visual Indicator

Enable LED when good read: Enable/disable LED light for good read.

Vibrator

Vibrate when good read: Click the drop-down menu to select the time duration for good

read vibration.

Beeper

Beep when good read: Click the drop-down menu to select the beeper sound for good

read. Users can choose to mute the beeper sound, or configure the beeper between sounds

1 to 9.

Page 61: Android Deployment Configurator - CipherLab

61

Project Management

1D Symbologies

Click the checkbox beside the label to enable/disable decoding a particular 1D symbology.

When a symbology is enabled, as the picture illustrated below, users can click the More

icon to proceed with symbology settings.

2D Symbologies

Click the checkbox beside the label to enable/disable decoding a particular 2D symbology.

When a symbology is enabled, as the picture illustrated below, users can click the More

icon to proceed with symbology settings.

Page 62: Android Deployment Configurator - CipherLab

62

Android Deployment Configurator User Guide

Profile

To enable a profile, you need to assign an “Associated App” to this profile beforehand:

1) Open the profile detailed window and go to the “Profile” tab.

2) Select an app from the drop-down menu. The drop-down menu appears only after

synchronizing the mobile device with ADC.

3) Select the checkbox of “Profile Enable”.

Page 63: Android Deployment Configurator - CipherLab

63

Project Management

4) Remember to click “Apply ” to save the setting before you close the profile detailed

window.

An app can be set as the associated app to only one profile. If the app you select is already

assigned to another profile, a prompt appears indicating that the app is being occupied.

Note:

(1) The “Default” profile doesn’t support “Associated app”. Please assign “Associated app”

to the profile(s) you create.

(2) Multiple profiles can be enabled at the same time.

After synchronizing, the Barcode Reader tab lists all the profiles (including the “Default” profile which cannot be deleted) from the built-in “ReaderConfig” app on the mobile device.

You can create a new profile and designate an app as the “Associated app” to it.

With an “Associated app” designated, the profile can be enabled, and the “Associated app”

will receive the decoded data output by “ReaderConfig”. Multiple profiles can be enabled at

the same time.

Page 64: Android Deployment Configurator - CipherLab

64

Android Deployment Configurator User Guide

Security

You can set a password to restrict other users of this mobile computer from changing

certain configurations or accessing certain functions in the app ReaderConfig. Click the

"Security" tab. Enter and confirm a password and check the items that will be protected by

this password.

Page 65: Android Deployment Configurator - CipherLab

65

Project Management

2.6.6 Button Assignment (for RS30, RS31, RS50, RS51, & HERA51)

With this configuration, you can define the function of the physical keys of your device. The

settings will vary by device model. Please note that the virtual keys (soft keys) could not be

set to “Enable wakeup”.

1) Double-click the Key name to enter more detailed settings.

2) Click “Apply ” before you close the Configure Device Settings window.

Virtual keys could not set to

be “Enable wakeup”

Page 66: Android Deployment Configurator - CipherLab

66

Android Deployment Configurator User Guide

Button Assignment

Key

Physical Key (Hardware Key) Virtual Key (Soft Key)

Volume Up

Volume Down

Pistol Function

Right Function

Soft Back

Soft Home

Soft App Switch

Soft Search (for RS50, RS51, & HERA51)

Enable

Wakeup

Select the checkbox to enable

pressing the key to wake the device

from suspend mode.

“Enable Wakeup” is disabled if

keycode is set as “None”.

“Enable Wakeup” is disabled all

the time.

Key

Mapping

Select the key categories and the physical key to be assigned to the key

from the drop-down menu, and click “Apply” to save the setting.

Be sure to click “Apply ” before closing the Configure Device Settings

window.

Launch

Applications

Please connect your device with PC in advance. Make sure that the debugging mode is enabled (refer to How Do I Enable Debugging Mode on My Device?),

and then proceed with synchronization to get the device application list.

Select the application to be assigned to the key from the drop-down menu,

and click “Apply” to save the setting.

Be sure to click “Apply ” before closing the Configure Device Settings

window.

Launch

Applications

with Intent

Input the intent (the specific intent string should be input beforehand in the

configuration xml file on your device) to assign the key to launch a specific

application. Click “Apply” to save the setting.

Be sure to click “Apply ” before closing the Configure Device Settings

window.

Page 67: Android Deployment Configurator - CipherLab

67

Project Management

2.6.7 Button Assignment (for RK25, RK95, & 9700A)

For the device with physical keypad, such as the RK25 or 9700A mobile computer, “Button Assignment” setting page is as below:

Button Assignment page lists a “System Profile” which is fixed in the first row. A profile

contains definitions of key behavior or actions. Only one profile can be active at a time.

The key behavior of your device is based on the "System Profile" which cannot be deleted.

You can change the definitions of key behavior or actions of the System Profile by:

1) Redefining the key behavior.

2) Setting a profile as system profile, and the key behavior or actions of the System Profile

will change.

Page 68: Android Deployment Configurator - CipherLab

68

Android Deployment Configurator User Guide

Profile Management

Item Description Figure

New Profile

Create a new profile.

Enter a profile name and click “OK ” to create it.

Edit Profile

Change the definitions of key behavior or actions of the selected profile.

Please refer to Editing Profile for details.

Delete Profile

Delete the selected profile. Please note that the active profile & the System Profile cannot be deleted.

Click “Yes” to confirm deleting.

Copy Profile

Copy an existing profile and make changes from it.

Enter a name for the new profile and

click “OK ” to make a copy.

Rename Profile

To rename an existing profile.

Enter a new name for the selected, and

click “OK ” to change its name.

Page 69: Android Deployment Configurator - CipherLab

69

Project Management

Selecting the Active Profile

You can create different profiles for different work environments, and only one profile can

be active at a time.

Click a right-hand radio button to make the profile active.

Remember to click to make the key behavior of the “System Profile” change to be

the same with the active profile.

Page 70: Android Deployment Configurator - CipherLab

70

Android Deployment Configurator User Guide

Editing Profile

Change the key functions of the physical keys to meet your needs.

1) Click a profile and then “Edit ”, or double-click a profile to list all the keys it contains.

2) Double-click the key that you’d like to assign a new action.

Page 71: Android Deployment Configurator - CipherLab

71

Project Management

Control Items Description

Key Mapping Click the radio button to select “Key Mapping” to map the selected key to another key.

Launch Application Click the radio button to select “Launch Application” if you’d like to launch an app with a key press. Please synchronize to fetch the applications on your device beforehand.

Launch Activity with Intent

Click the radio button to select “Launch Activity with Intent” if your app supports launch by intent in its manifest.

Wake Up Select the checkbox to enable pressing the key to wake up the mobile computer from suspend mode.

Key Mapping

Click the radio button to select “Key Mapping” to map the selected key to another key:

1) Expand the drop-down menu and select the key type.

2) Select the key function you would like to assign, and click on “Apply”.

Page 72: Android Deployment Configurator - CipherLab

72

Android Deployment Configurator User Guide

If a desired key is not listed, you can still map the key by entering the key code defined in

the Android operating system:

1) Expand the pull-down menu and select "Miscellaneous", and then select

"User-defined".

2) Input key code in the text field, and click “Apply”.

Remember to click the “Save ” button after profile editing is done.

Page 73: Android Deployment Configurator - CipherLab

73

Project Management

Launch Application

Click the radio button to select “Launch Application” if you’d like to launch an app with a key

press.

Expand the pull-down menu for the entire application list and select the app you would like

to assign.

Remember to click “Save ” button after profile editing is done.

Page 74: Android Deployment Configurator - CipherLab

74

Android Deployment Configurator User Guide

Launch Application with Intent

In order to support launch by intent in your app, you need to add an intent-filter action in

your app’s AndroidManifest.xml file.

The following example uses “cipherlab.intent.action.Test” as the name of the intent to be

launched.

<activity

android:name=".MainActivity"

android:label="@string/app_name" >

<intent-filter>

<action android:name="android.intent.action.MAIN" />

<action android:name="cipherlab.intent.action.Test" />

<category

android:name="android.intent.category.LAUNCHER" />

</intent-filter>

</activity>

Click to select the “Launch Application with Intent” radio button and fill in the text field

with “cipherlab.intent.action.Test”. Then click the “Apply” button. Once the action is set,

your application can be launched with a key press.

Wake Up

Select the checkbox to enable pressing the key to wake up the mobile computer from

suspend mode. This function is available only for RK25/RK95 scan keys.

Remember to click the “Save ” button after profile editing is done.

Page 75: Android Deployment Configurator - CipherLab

75

Project Management

Enabling/Disabling a Key in Profile

To enable/disable a key in a profile, simply enter the profile to list all of its keys. Then tick/

untick the checkbox next to the key you’d like to enable/disable.

Save – Save your changes of the key functions or key enabling/disabling.

Cancel – Directly close the window without saving any changes.

Reset – Restore the key functions to the default.

Remember to click on the “Configure Device Settings” screen to have the key behavior

of the profile take effect.

Page 76: Android Deployment Configurator - CipherLab

76

Android Deployment Configurator User Guide

Keypad Lock

For the device with physical keypad, you can lock the physical keys by pressing Shift key

and then Backspace key to avoid pressing the keys accidentally. If you would like to enable

or disable the keypad lock function, you can:

1) Click a profile and then “Edit” , or double-click a profile to list all the keys it contains

2) Scroll to find “Keypad lock”.

3) Click the checkbox next to “Keypad lock” to tick or untick it.

4) Remember to click the “Save ” button after you change the key functions or key

enabling/disabling. Then click on the “Configure Device Settings” screen to have

the key behavior of the profile take effect.

Note:

The three soft keys, Back , Home , and App Switch , are never locked even

if Keypad lock is enabled.

Page 77: Android Deployment Configurator - CipherLab

77

Project Management

2.6.8 Wireless Manager

1) Make changes if necessary. Click the right-hand toggle switches to turn on/off one or

more wireless signals.

2) Click “Apply ” before you close the Configure Device Settings window.

Page 78: Android Deployment Configurator - CipherLab

78

Android Deployment Configurator User Guide

2.6.9 Wi-Fi Settings

1) Click on “Add” to add a new wireless profile and fill in the necessary fields. Click on

“Apply” to save the settings.

Add – To add a new wireless profile.

Edit – To edit the selected wireless profile.

Delete – To delete the selected wireless profile.

Network Name (SSID): Type the network name.

Security: Click the drop-down menu to select a wireless security protocol.

Password: Type the Wi-Fi password.

Show advanced options: Click the checkbox to show/hide the two items below.

Proxy: Click the drop-down menu to select a proxy option.

IPv4 settings: Click the drop-down menu to select the way how the IP address of this

mobile is assigned.

2) Click “Apply ” before you close the Configure Device Settings window.

Page 79: Android Deployment Configurator - CipherLab

79

Project Management

Advanced

Unfold “Wi-Fi Settings” and click the “Advanced” option, the advanced Wi-Fi settings page is

shown to deliver the following functions:

Item Description

Network Notification Notification shows up when an open network is available.

Keep Wi-Fi on during sleep

Set when to turn Wi-Fi on during sleep.

Wi-Fi Frequency band Select the Wi-Fi Frequency band from Automatic, 5GHz only, and 2.4 GHz only.

Roaming Enable Select whether to enable Wi-Fi roaming or not.

Roaming trigger Set the signal strength below which the Wi-Fi roaming is triggered. The higher value means the sensitivity of triggering roaming is higher.

Roaming delta Set the qualification for roaming candidates. The higher value means the signal strength of candidate APs should be higher than the current connected AP.

Page 80: Android Deployment Configurator - CipherLab

80

Android Deployment Configurator User Guide

Background scan interval

Set the frequency of background scan when the device does not connect to the Internet. The shorter time means the scanning frequency is higher.

Set Country Code Select the Wi-Fi country code for your device. The default country code setting is automatically set by the SIM card inserted in your device.

Wi-Fi connection timeout

Select the checkbox, and move the slider to decrease/increase the timeout value in seconds.

Captive Portal Detection Enable

Select whether to enable “Captive Portal Detection” whose feature is to prevent your device from automatically reconnecting to a network without internet.

Page 81: Android Deployment Configurator - CipherLab

81

Project Management

2.6.10 Cellular Data

Click the Cellular Data tab to configure your cellular data network.

Add – To add a new cellular data network.

Edit – To edit the selected cellular data network.

Delete – To delete the selected cellular data network.

Page 82: Android Deployment Configurator - CipherLab

82

Android Deployment Configurator User Guide

1) “Add ” or “Edit ” a cellular data network. Finish all settings and click the Apply

button.

2) Click “Apply ” before you close the Configure Device Settings window.

Carrier / ISP name

Page 83: Android Deployment Configurator - CipherLab

83

Project Management

2.6.11 Terminal Emulation

Before you perform the synchronization by ADC, make sure Terminal Emulation has been

launched on the device for at least one time.

Select a Host for TE default connection: Click the radio button to set a host profile as

the active profile. You can click a host to enter its settings page.

Screen Orientation: Click the drop-down menu to switch between Keep Portrait and

Keep Landscape.

Access Control

Terminal Emulation allows setting up a password mechanism to prevent unauthorized

access of application settings, or leaving the application without authorization.

Enter your password: Specify the password for access control.

Confirm password: Type the same password again.

Select to apply password protection: Select the checkboxes to apply the password

protection to the access control items.

Page 84: Android Deployment Configurator - CipherLab

84

Android Deployment Configurator User Guide

Session Settings

Settings of a session consist of four tabs: Host Profile, Emulation Settings, Network,

and Debug.

Host Profile

Emulation Type: Click the drop-down menu to set the profile to connect to the prospective

host, VT or TN type.

IP Address: Input the IP address or name of the host.

Port: Input the port number or click the left/right arrow to decrease/increase port number.

Auto Connect: Select the checkbox to enable auto connection.

Auto Sign On: Select the checkbox to enable auto sign-on and proceed with further

settings below.

Login Name: Input the login name.

Login Password: Input the login password.

Command (VT Only): Input the command (only for VT emulation type).

Login Prompt (VT Only): Specify the text exactly displayed by the host service to prompt

for user name. This function is available for VT host types only.

Password Prompt (VT Only): Specify the text exactly displayed by the host service to

prompt for password. This function is available for VT host types only.

Command Prompt (VT Only): Specify the text exactly displayed by the host service to

prompt for command. This function is available for VT host types only.

Page 85: Android Deployment Configurator - CipherLab

85

Project Management

Term Login (VT Only): Click the drop-down menu to select between Tab and Enter to

assign the key to switch over Login Name and Login Password. This function is available for

VT host types only.

Emulation Settings

Click the Emulation Settings tab as the picture shown below.

Emulation Settings – VT Settings

Click the VT Settings panel to show settings.

Data Input Uppercase: Capitalizes all the letters of input data.

LineBuffer: Shows typed text and commands locally on Terminal Emulation, and transmits

them to host service only after Enter key is hit to confirm the input.

Page 86: Android Deployment Configurator - CipherLab

86

Android Deployment Configurator User Guide

Local Echo: Shows typed text locally on Terminal Emulation just as it is being transmitted

to host service.

Send String When Connect: Defines the command that Terminal Emulation sends to host

service upon connection. Click the right-hand icon to bring up a character table for entering

the desired command.

New Answer Back: Specify a string to be sent to the host when receiving an ENQ from the

host. Users can include the variables as follows for device identification.

Variables Description

%m%n%o%p%q%r depict six octets of the MAC address

%a%b%c%d depict four octets of the IP address

%s depict the TE session number

%t depict the Terminal ID (vt100,vt102, vt220 and ansi)

For example:

Users specify the “%m%n%o%p%q%r-%a.%b.%c.%d-%s-%t” string. The mobile device

will send “0017231BABF9-192.168.241.65-1-vt220” (0017231BABF9 representing MAC

address, 192.168.241.65 representing IP address, 1 representing the TE session number,

and vt220 representing the terminal ID) to VT Server when receiving ENQ from the host.

Remote Character Set: Assigns the character code for displaying the characters received

from the server.

Replace Char if Unconvertable: When UTF-8 is assigned, this checkbox is available.

Select the checkbox and click the drop-down menu to assign the character for replacement.

Emulation Settings – Screen

Click the Screen panel to show settings.

Page 87: Android Deployment Configurator - CipherLab

87

Project Management

Show Session Number: Displays a session icon on the screen to allow quick

switching to other sessions.

Show Connecting Host IP: Displays connecting host IP right beneath the toolbar.

Screen Panning: Enable/disable viewing the desired portion of the screen by swiping the

display.

Auto Popup SIP On Connection: Check it to enable the pop-up SIP on connection.

Activate Macro: Check it to enable pop-up Macro toolbar on the screen once the session is

connected.

Set HW Key (SHIFT + RIGHT) to Exit App: Enable/disable the hardware key

combination (SHIFT + RIGHT) to exit the app.

Set HW Key (SHIFT + ESC) to Control SIP: Enable/disable the hardware key

combination (SHIFT + ESC) to control SIP.

Cursor Type: Click the drop-down menu to select the cursor type.

Auto Tracking: Auto-positions Terminal Screen to bring cursor into view. Select the

checkbox and click the drop-down menu to select.

Visible (The cursor constantly shows at the upper-right of the screen.)

Center (The cursor constantly shows in the center of the screen.)

Locked Location (The screen is locked to the position set by column and row.)

Column/Row: When Auto Tracking is set to Locked Location, users can specify the

accurate coordinates.

Fonts: click the drop-down menu to assign the font to show characters in Terminal Screen.

Font Size: click the drop-down menu to assigns the size to show characters in Terminal

Screen

Line Spacing: Specify the line spacing.

Color Settings: Click the right-hand icon to bring up the dialog. Select the font color and

background color in the Terminal Screen to suit users’ preferences.

Override Server Color: Select the checkbox to apply color settings to the server.

Full Screen

Auto Full Screen On Connection: Check it to enable full screen mode automatically when

connecting to the server.

Show Navigation Bar: Check it to enable the Navigation bar in full screen mode.

Show Wi-Fi/Battery Info on Full Screen: Sets the items to display in full screen, either

the battery level icon or Wi-Fi signal strength icon, on condition that the title bar is not

enabled. The SIP icon can be enabled regardless of whether the taskbar is shown on full

screen.

Update Wi-Fi/Battery Icon Interval: Click the drop-down menu to select

Wi-Fi/battery status icon update Interval (min). Options are: 1, 3, 5, 15, 30, 60

minutes.

Choose Wi-Fi Alert Level (%): Select to define threshold for low Wi-Fi signal alert to

appear (by a pop-up dialog indicating the Wi-Fi signal strength). Options are: 10, 20,

30, 40, 50, 60, 70, 80, 90%.

Page 88: Android Deployment Configurator - CipherLab

88

Android Deployment Configurator User Guide

Choose Battery Alert Level (%): Select to define threshold for low battery alert to

appear (by a pop-up dialog indicating the remaining battery level). Options are: 10, 20,

30, 40, 50, 60, 70, 80, 90%.

Emulation Settings – Alarm

Click the Control Reader By Command panel to show settings.

Enable the host service to send commands in order to turn on/off the reader module.

Enable Command: Assign a command (escape sequence) for turning on the reader

module.

Disable Command: Assign a command (escape sequence) for turning off the reader

module.

Sound: Select a sound from the drop-down menu.

Click the Feedback By Command/Text panel to show settings.

Page 89: Android Deployment Configurator - CipherLab

89

Project Management

Good Feedback: Assign the command (escape sequence) for input success. When

Terminal Emulation receives the command, the mobile computer will play the specified

beeper sound or vibrate for the specified amount of time.

Feedback Type: Select Command or Text.

Command/Text: Enter the sequence of interest.

Sound: Select a sound from the drop-down menu.

Vibrator: Select the amount of time to vibrate. Configure vibration duration between

0 and 5 sec (in increments of 0.5 sec).

Error Feedback: Assign the command (escape sequence) for input failure. When Terminal

Emulation receives the command, the mobile computer will play the specified beeper sound

or vibrate for the specified amount of time.

Emulation Settings – Key Mapping

Click the Key Mapping panel to show settings. This function is only for devices equipped

with physical keyboard. Terminal Emulation supports “Key Mapping”, enabling users to

define a physical key (or combined keys) of the mobile device mapping to a specific function

performed on the server.

Page 90: Android Deployment Configurator - CipherLab

90

Android Deployment Configurator User Guide

Select a particular key item (e.g. Tab key) and then click the pencil icon to show the setting

page. Click the right-hand keyboard icon to bring up the dialog to specify the server

command string for the Tab key.

Setting Description

Server Key The function performed on the server.

Mapped Physical Key

Configures the selected Server Key.

Setting Description

Category Lists the categories of Physical Keys.

Alphabets

Numbers

Punctuations

Function Keys

Navigation Keys

Editing Keys

Physical Key Serves the function of the Server Key.

Ctrl/ Shift/ Alt Functions with the physical key if selected.

Volume Up - -> VT ESC

This function is only for devices without physical keyboard.

With this function enabled, after a connection to the VT server is established, pressing the

volume up button sends ESC to the VT server. This function is available only for VT

Emulation.

Page 91: Android Deployment Configurator - CipherLab

91

Project Management

Emulation Settings – SSH

Click the SSH panel to show settings.

The secured connection protocol Secure Socket Shell (SSH) is available for VT emulation. As

it provides strong authentication and secures encrypted data communications, it suits the

needs of a solution which requires high security level of data transmission.

Enable SSH: Select the checkbox to enable SSH.

Generate SSH Log: Select the checkbox to generate SSH log.

Authentication Type: Click the drop-down menu to select between Key File and

Name/Pwd.

Load a profile key:

Transfer a key file (*.pem or *.ppk) to your mobile computer. Click the Advance icon to

bring up the dialog. Click the plus icon to import the key file.

Page 92: Android Deployment Configurator - CipherLab

92

Android Deployment Configurator User Guide

Name/Password:

Or with Name/Pwd selected, you can access the remote server using Name and Password.

Click the Advance icon and then key in your Login name and Password respectively.

The other settings are depicted as follows:

General Options

Use TCP No-Delay

Enable this option to enhance the performance of small-amount data transmission between Server and client Device. However, this function might result in excessive traffic of short packets.

No Pseudo-Terminal on Host

The “pseudo-terminal mode” is fundamental for VT (UNIX) host system to build up emulation sessions between client Devices. Disable it if necessary.

No Host Shell

Enable this option to have TE not run shell or command after

connecting to the remote host server. This option is applicable only when:

1. SSH connection is used for port forwarding, and your user account on the server is not allowed to run a shell.

2. SSH protocol version 2 is supported on host server.

Re-Key Every 60 Minutes

In RFC 4253 (the SSH Transport Layer Protocol), the Re-Key method ensures the key is exchanged only upon per gigabyte of

transmitted data or per hour of connection time, whichever occurs sooner. Enable these options to trigger TE to exchange a new key with the server every 60 minutes or following a total data flow of 1 Gigabyte in either direction.

Re-Key Every 1G of Traffic

Overwrite Existing Log File

Enable this function to have the new Log file always overwrite the previous one.

Page 93: Android Deployment Configurator - CipherLab

93

Project Management

Server

Environment

Specifies environment variables to be set on the SSH server.

Commands

Represents a special command or subsystem to invoke on the SSH server in lieu of an interactive shell. This is typically used for non-interactive host sessions. For most users this will be blank.

TTY

This setting can be used to add TTY Modes to be sent to the SSH server.

Proxy

Type

Proxy allows you to configure CL TE to use various types of proxy servers in order to make network connections.

The settings affect the primary network connection from your CL TE SSH session, but also any extra connections made as a result of SSH port forwarding.

Click the drop-down menu to configure what type of proxy you want CL TE to use for its network connections. The choices are:

- None: no proxy is used.

- SOCKS 4 or SOCKS 5: proxy through a SOCKS server.

- HTTP: proxy through a web server supporting the HTTP CONNECT command.

The default setting is None.

Host

Specify the DNS name or IP address of the proxy server. The

default is blank.

Port

Specify the port on which the proxy server is listening. Set this to match the port on the proxy server for connections.

User

If your proxy server requires authentication, enter the username. The default is blank.

Password

If your proxy server requires authentication, enter the password. The default is blank.

Click on “Apply ” before you close the Configure Device Settings window.

Note:

Emulation Settings involve key mapping with the physical keys of the device, thus the

settings will vary by device model.

Page 94: Android Deployment Configurator - CipherLab

94

Android Deployment Configurator User Guide

2.6.12 AppLock

For AppLock configuration, synchronize settings with your device first so that the

applications and system settings can be imported to the white page. Please make sure

AppLock application has been launched on the device for at least one time before you

perform the synchronization.

Synchronize to fetch the AppLock settings in the device.

Page 95: Android Deployment Configurator - CipherLab

95

Project Management

Add Package Naming Rule

“Add Package Naming Rule” is for administrators to set the naming rule to prescribe which

apk (Android application package) can be manually installed by users and automatically

added to “Allowed apps list” after installation.

By adding your package naming rule, if users try to install the apk which doesn’t match the

rule, it will be blocked.

1) Click on “Add Package Naming Rule ” to open the “Package naming rule white list” window:

Add – To add a new

package naming rule.

Edit – To edit the selected

package naming rule.

Delete – To delete the

selected package naming rule.

2) “Add ” or “Edit ” a package naming rule and click “OK ” to save the setting.

Page 96: Android Deployment Configurator - CipherLab

96

Android Deployment Configurator User Guide

Add App & Shortcut

1) Click “Add App ”; check the “Create a new App item” radio button to input app

information. Or check the “Select an existing app item” radio button to select from your

desired apps. Click “Apply” to save the settings.

2) To add shortcuts to settings, click

“Add Shortcut ”; select the

item and then click “Apply” to save

the settings.

Page 97: Android Deployment Configurator - CipherLab

97

Project Management

3) Back to the previous page. Define if the chosen apps are going to be the Auto Start Apps or on Recent Apps Whitelist:

Item Description

Auto Start Apps Make the desired App(s) automatically start when AppLock is launched on the mobile computer.

Recent Apps Whitelist Select the applications to retain in the recent apps list.

4) Double-click the app to bring up the dialog to edit its settings.

Page 98: Android Deployment Configurator - CipherLab

98

Android Deployment Configurator User Guide

In the dialog, you can:

Item Description

Apply Click Apply to save the settings and close the dialog at the same time.

Delete

Delete the application from “Allowed Apps” list and close the dialog at the same time.

Cancel Directly close the dialog without saving any changes.

Label Input the new name for this app in the blank under Label to rename this app.

Hide icon on AppLock desktop

Determine whether this app on the Allowed Apps list is visible on AppLock main screen.

With “Hide icon on AppLock desktop” enabled, this app will not be shown on AppLock main screen, but it is still operational as other apps displayed on Allowed Apps view.

Screen Pinning

Users cannot exit or close Apps with “Screen Pinning” enabled by tapping any hardware buttons on your devices or by any means, even if the application itself offers the quit/exit/leave function. The only way to unpin the screen-pinned application is to long press Back button and then input the admin password in the “Unpin Application” pop-up window.

5) Continue to finish advanced settings under Options if necessary.

6) Click “Apply ” before you close the Configure Device Settings window.

Page 99: Android Deployment Configurator - CipherLab

99

Project Management

Options – Notification Bar

Show Notification Bar

Select whether to show the notification bar on the top of the screen of your device when the

Home app is set to be AppLock. Use the notification bar to check battery status, wireless

connection status, and system notifications.

Enable Notification Bar

Select whether to enable the notification bar of your device when the Home app is set to be AppLock. If it is enabled, the notification bar could be slid down to check & manage system notifications and open Quick Setting Menu. Also, all the notifications on the lock screen will be shown. If it is disable, the setting of “Show filtered notifications” takes control whether to block the notification bar and to show the notifications on the lock screen.

Show filtered notifications

“Show filtered notifications” is to determine whether showing the notifications of allowed apps, and this function only works when “Enable Notification Bar” is off. When “Show filtered notifications” is enabled, the status bar could be slid down to reveal notification drawer for checking the notifications from allowed apps only. The quick settings panel is unavailable as well as the quick setting tiles on it.

Heads-up notifications

Select whether to enable the head-up notifications to pop-up in your device when the Home app is set to be AppLock. If not, only notification icon will be shown in the notification bar. Please note that“Heads-up notifications” is not supported for RS30 mobile computer.

Enable Notification Bar

ON

Enable Notification Bar

OFF

Show filtered notifications ON

Show filtered notifications

OFF

Notification Bar

Notification bar can be slid down.

Notification bar could be slid down to reveal notification drawer.

Unable to slide down the notification bar.

Lock Screen

All notifications on the lock screen will be shown.

Only the notifications from Allowed apps will be shown.

No notifications will be shown on lock screen.

Note: The function “Heads-up notifications” is not supported for RS30 mobile computer.

Page 100: Android Deployment Configurator - CipherLab

100

Android Deployment Configurator User Guide

Options – Display

Click on each item to expand the subcategory for more settings:

Wallpaper

Select whether to Use system wallpaper. If not, you could set Portrait Wallpaper & Landscape Wallpaper. Please click the right-hand icons to bring the dialog. Browse the wallpaper (bmp file, jpg file, or png file) from your PC; or input the URL directly, and designate the path (device internal storage or SD card) to save it to.

Item Description

Select the file from PC.

Input the URL to download the file.

Save the file in device internal storage.

Save the file in SD card.

Page 101: Android Deployment Configurator - CipherLab

101

Project Management

Logo

By checking the “Enable” checkbox, you can set the Logo to be shown on the main screen of AppLock.

Please browse the Logo (png file) from your PC or input URL directly, and designate the path (device internal storage or SD card) to save it to.

The Image Height could be set from 1 pixel to 270 pixels.

Item Description

Select the file from PC.

Input the URL to download the file.

Save the file in device internal storage.

Save the file in SD card.

To browse through the PC folder to find the file.

Tune up the value of “Image Hight” whose range is from 1 pixel to 270

pixels.

Page 102: Android Deployment Configurator - CipherLab

102

Android Deployment Configurator User Guide

Home screen text color

The default text color displayed on AppLock home screen is white whose RGB color is (255,255,255) and the color hex is #FFFFFF.

Click “Change ” to open the “Color Settings” dialog where you can change the text color on AppLock home screen by dragging the RGB color sliders or directly input the color hex triplet (hexcode) to designate your home screen text color.

Remember to click “OK ” to save the settings.

Page 103: Android Deployment Configurator - CipherLab

103

Project Management

Options – Security

Set Login Password

Click the “Change” button to open the “Configure Password” dialog to set the login password for AppLock admin.

To make the input password visible, please select the “Show Password” checkbox.

Make sure to click “OK ” to save the password setting.

Item Description

OK: Save the settings and close the “Configure Password” dialog.

Cancel: Directly close the “Configure Password” dialog without saving any

setting changes.

Clear Password: Clear the password in both “Enter password” and “Confirm

password” field.

Show Password

Select whether to show the entered password when logging in AppLock Admin mode.

Monitoring App Installation

Select to enable “Monitoring App Installation” which restricts AppLock users from installing any apk of the apps excluded from the “Allowed App” list.

The default setting of “Monitoring App Installation” is disabled. Users can install the apk of the disallowed app, but the app cannot be launched.

Page 104: Android Deployment Configurator - CipherLab

104

Android Deployment Configurator User Guide

Options – Assist app, Remove Lockscreen Icons, & USB Connection Allowed

Assist App

Please synchronize with your device first to get the Assist app list from the device to ADC Client.

“Choose the assist app” from the drop-down menu, and the selected assist app could be opened by no matter Admin or users with long press Home button on the device when the Home app is set to be AppLock.

Remove Lockscreen Icons

Tick the checkbox to make the app shortcut on the Lockscreen of your device to be hidden.

USB Connection Allowed

If “USB Connection Allowed” is enabled, the device is visible from PC client when it is connected with PC by USB cable, whereas it is invisible if “USB Connection Allowed” is unticked.

Page 105: Android Deployment Configurator - CipherLab

105

Project Management

2.6.13 System Settings

On the “System Settings” screen, click each item to expand the subcategory for more

settings:

Device

Home: Click the drop-down menu to select Launcher3 or AppLock to be the Home app.

Display

Brightness level: Drag the slider to the right to increase brightness, or left to reduce

brightness.

Adaptive brightness: Select the checkbox to adjust the device backlight automatically

with the mobile computer’s built-in sensor.

Use system wallpaper: By default, the system wallpaper is applied. You can decide not to

use the system wallpaper in favor of yours by removing the tick from the checkbox. And

then click the right-hand button to bring up the dialog.

Page 106: Android Deployment Configurator - CipherLab

106

Android Deployment Configurator User Guide

Item Description

Select the file from PC.

Input the URL to download the file.

Save the file in device internal storage.

Save the file in SD card.

To browse through the PC folder to find the file.

Image path: If “Use system wallpaper” is unticked, you could select the wallpaper file (in

bmp., jpg., or png. format) from PC by clicking browse button, or directly input URL.

Device path: If “Use system wallpaper” is unticked, please input the designated path in

device to save the wallpaper from PC client.

Sleep: Select the time lapse for screen timeout.

Font Size: Select the font size between Small, Normal, Large and Largest.

Display Size: Select the display size from Small, Default, and Large.

Auto-rotate screen: Select whether to enable automatically screen rotation when the

device is turned sideways.

Battery

Click the drop-down menu to select the battery mode. “Performance mode” offers better &

extra 10% to 20% working hour performance but might affect battery life; “Balance mode”

balances between working hour and battery life.

Page 107: Android Deployment Configurator - CipherLab

107

Project Management

Notifications

Click the drop-down menu to select whether to show notifications on the lock screen.

Sound

Media Volume: Move the slider to decrease/increase the media volume.

Alarm Volume: Move the slider to decrease/increase the alarm volume.

Ring Volume: Click the drop-down menu to select between Normal, Vibrator, and Mute.

With Normal selected, you can move the slider to decrease/increase the ring volume.

Page 108: Android Deployment Configurator - CipherLab

108

Android Deployment Configurator User Guide

Personal

Location (9700A & RK95 models not supported)

By selecting “GPS”, you could further select the mode between “High accuracy”, “Battery saving”, and “Device only”.

Security (RK25P & RK95 models not supported)

Select “None”, “Swipe”, “PIN”, or “Password” for Screen lock. By choosing “PIN” or “Password”, you could further input password and confirm it in the fields below.

Select the “Unknow Sources” checkbox to allow installation of apps from unknown sources. Language & Input

Click the drop-down menu to select the desired system language.

By enabling “Spell Checker”, a list of suggested words will be shown as you type on your device.

Page 109: Android Deployment Configurator - CipherLab

109

Project Management

System

Automatic time zone: By unticking this function, you could manually select the time

zone.

Set date & Set time: Manually set the date & time.

Select time zone: Manually select the time zone.

Use 24-hour format: By ticking this checkbox, time format will convert from 12-hour to 24-hour.

NTP Server: Input the address of the NTP server, and make your devices automatically synchronize with this designated NTP server.

Page 110: Android Deployment Configurator - CipherLab

110

Android Deployment Configurator User Guide

2.6.14 Software Trigger

“Softeware Trigger” is an application which serves as a real trigger key on your device, and

it floats on top of all other programs for convenient trigger control of the barcode scanner.

Enable: Select the checkbox to enable “Softeware Trigger” on the device.

Size: Resize the Software Trigger virtual button by selecting between “Small”, “Medium”, and “Large”. The default setting is “Medium”.

Auto start software trigger after startup: Select to automatically start “Softeware Trigger” on device startup.

Remember to click “Apply ” before you close the Configure Device Settings window.

Page 111: Android Deployment Configurator - CipherLab

111

Project Management

2.6.15 EZConfig (for RK25 UHF RFID Reader)

EZConig is a built-in UHF RFID application which is for the CipheLab RK25 mobile computer

to works with RK25 UHF RFID Reader to read RFID tags.

Notification Settings

Visual Indicator

Low Battery LED: Select the checkbox to enable the LED indication when battery charge

of the RFID reader is getting low.

Beeper

Beep when good read: Click the drop-down menu to mute the beeper or select the sound.

Low Battery Beep: Select the checkbox to enable beeping when battery charge of the

RFID reader getting low.

Temperature Warning: Select the checkbox to enable beeping when measured

temperature meets the specified value.

Page 112: Android Deployment Configurator - CipherLab

112

Android Deployment Configurator User Guide

Scan Settings

Click the Scan Settings tab to proceed with preferences and data output settings.

Power Level (30): Move the slider left/right to decrease/increase the power level ranging

from 5 to 30 (The maximum power level value is 24 for Singapore).

Trigger Key: Select "Once" or "Continuous" for the reading mode when pressing the

trigger once. "Alternate" is the mode which "Once" and "Continuous" are performed one

after the other repeatedly. The RK25 UHF RFID Reader starts to read tags after the trigger

key is pressed and it keeps reading tags till the trigger is pressed again.

Preferences

Work Mode: Click to select from "Comprehensive mode", "Multi-tag mode", and "User

define 1 ~ User define 5" on the drop-down menu.

If you select the mode other than "Multi-tag mode", you can further set "RF Link".

RF Link: Click the drop-down menu to select from options including DSB_ASK FM0 40KHz,

PR_ASK Miller4 250KHz, PR_ASK Miller4 300KHz, and DSB_ASK FM0 400kHz.

Page 113: Android Deployment Configurator - CipherLab

113

Project Management

Session: Four sessions are used for reading tags, and every session has 2 target states (A

and B). A tag is in state A if it is not read; once it is read, its state flips from “A” to “B” and

stops replying to readers.

Q Value: (two scenarios: a. Fix Q, b. Dynamic Q)

Q value is effected by the number of tags ranging from 0 to 15, and the tag population is

based on 2^Qvalue. For example, if the tag quantity is 50, it is suggested to set the Q value

as 6. However, dynamic Q is suggested for standard use.

Larger Q values decrease the probability of collision, and will reduce the throughput.

Dynamic Mode: When the checkbox is selected to enable dynamic mode, users can specify

the minimum/maximum Q value.

Inventory Status: Click the drop-down menu to select options.

STATE A – Tags are in state A before they are read, and they flip to state B once they are

read.

STATE B – Once a tag is read, it changes its state from “A” to “B”, and the tags in state B

stops responding to a reader using the same session query. The persistence of the tag in

state B varies based on the session.

AB FLIP – Repeats State A and State B over and over.

Data Output

Data output allows users to set the way to output decoded data.

Keyboard Emulation: Select the checkbox to enable treating the decoded data as typed

text and outputting it to the active application on the mobile computer.

On a web page or in an application, tap a text input field and press the trigger of the RK25

UHF RFID reader to read the tags, and the decoded data will be output to the text input field.

Note: Keyboard Emulation is only available when the Trigger Key function is set as “Once”.

Inter-Character Delay: By default, the inter-character delay is set to zero. Specify a

value, ranging from 0 to 254 in units of millisecond, to match the computer response time

of the keyboard interface. Such delay time is inserted between characters being transmitted.

The longer the delay time is, the slower the transmission speed will be.

Prefix/Suffix: Click the keyboard icon to bring up the character table. Affix up to 20

characters to the left of the output data whereas “Suffix” is to affixes up to 20 characters to

the right of the output data.

Page 114: Android Deployment Configurator - CipherLab

114

Android Deployment Configurator User Guide

Decoding Scheme

Click the Decoding Scheme tab. Select the checkboxes to decide which kind of tags can be

read.

Filter

The EPC encoding scheme allows RFID reader to accept various types of tag. However, the

EPC filter can pick only one type of tag from those EPC tags; other types will be bypassed.

Select the EPC encoding scheme which the filter applies to: Click the drop-down

menu to select the EPC encoding scheme; then select “Filter Type” and “Filter method”.

Please note that “Filter method” differs based on the EPC encoding scheme.

Page 115: Android Deployment Configurator - CipherLab

115

Project Management

Filter type: EPC filter is designed to check the contents of the EPC tag with the specified tag

type to determine whether the scanned record is accepted or ignored. Click the drop-down

menu to select “Include EPC” as the whitelist or “Exclude EPC” as the blacklist.

Filter method: Select a filter method from the three radio buttons.

Filter by EPC filter value: Click the drop-down menu to select an EPC filter value as

the filter method.

By GS1 Company Prefix: Specify at least 6 up to 12 digits. Company prefixes are

based on the GS1 prefixes. Note that since GS1 member companies can manufacture

products anywhere in the world, GS1 prefixes do not identify the country of origin for

a given product.

By Item Reference: Specify at least one up to 7 digits.

Maximum number of digits in an Item Reference: This control item is available

when the By Item Reference radio button is selected. Move the slider to

increase/decrease the maximum number of digits.

Other

Power Mode: Click the drop-down menu to select options.

Item Description

Power Save Mode The mode that saves the battery power. Its speed of reading multiple

tags is 30% slower than “Normal Mode” but it improves 7% operating

time compared with “Normal Mode”.

Normal Mode The mode strikes a balance between performance and operating

time.

Boost Mode The mode offers the maximum performance. Its speed of reading

multiple tags is 50% superior to “Power Save Mode”.

Page 116: Android Deployment Configurator - CipherLab

116

Android Deployment Configurator User Guide

Security

Go through each tab page for detailed settings, and set the password in “Security” under

“EZConfig” to restrict other users from changing certain configurations or accessing certain

functions in EZConfig on the device.

Password

Enter and confirm your password for EZConfig.

Pasword-protected features

Select the checkbox to apply password protection from being controlled after you log out EZConfig.

To access the protected functions, please log in with the password.

Page 117: Android Deployment Configurator - CipherLab

117

Project Management

2.6.16 Enterprise Settings

Click the Enterprise Settings tab to control the physical keypad. Items of the settings may

differ depending on the target model.

Disable special Keyevent: Select the checkbox to disable the special keycode (which is

not defined by Android) sent by pressing Function Key, Alpha Key, and Trigger Keys. The

default setting is None.

Change blue key input method: Select the checkbox to change input mode of the

physical keypad. By enabling this function, you can cycle through Alpha Numeric Mode,

Alpha Lowercase Mode, and Alpha Uppercase Mode with simply pressing Alpha Key (the

blue key).

Physical keypad sound: Click the drop-down menu to select the physical keypad sound.

The default setting is “None”.

Doze Mode: Enable to deter background CPU & network activity to reduce battery

consumption for the unused duration.

Convert UHF EPC to ASCII: Select the checkbox converting the UHF EPC data to ASCII

characters.

Page 118: Android Deployment Configurator - CipherLab

118

Android Deployment Configurator User Guide

2.6.17 SIP Controller

Click the SIP (Software-based Input Panel) Controller tab to configure settings of the

switching button.

Enable: Select to display virtual keyboard switching button on the device.

Size: Click the drop-down menu to select the switching button size.

Auto start SIP controller after startup: Select to launch the SIP controller each time the

device starts up.

Force to display: Generally, the virtual keyboard shows up when a text field gets the

cursor. Select this checkbox to force to display the virtual keyboard.

Virtual Keyboard 1: Click the drop-down menu to specify the keyboard type.

Virtual Keyboard 2: Click the drop-down menu to specify the keyboard type.

Page 119: Android Deployment Configurator - CipherLab

119

Project Management

2.7 Deploying All Settings to Devices

Once you finish configurating all the settings, please follow the steps to perform the

deploying:

1) Connect your devices with your PC. Please make sure that the debugging mode is

enabled. (Please refer to How Do I Enable Debugging Mode on My Device?)

2) Click the Deploy button:

3) After completing the deploying, a notification

is shown on your device:

Page 120: Android Deployment Configurator - CipherLab

120

Android Deployment Configurator User Guide

You can generate a PDF file containing 1D or 2D setting barcodes for later use. Users can

then handle a CipherLab mobile device running the BarcodeToSetting app to scan these

setting barcodes printed on paper to configure the device itself.

In This Chapter

3.1 Getting Started ....................................................... 121

3.2 Instructions on How to Generate Setting Barcodes ....... 122

Barcode To Setting

Page 121: Android Deployment Configurator - CipherLab

121

Barcode To Setting

3.1 Getting Started

To export certain configurations from ADC (Android Deployment Configurator) to your

devices without USB connection, please follow the steps:

1) Run “Android Deployment Configurator” to open an existing project or create a new

one.

2) With a project loaded or created, click the “Configure…” to open the “Configure Device Setting” window.

3) You can export the settings of those functions by generating barcodes which could be

scanned by your devices running BarcodeToSetting.

Page 122: Android Deployment Configurator - CipherLab

122

Android Deployment Configurator User Guide

3.2 Instructions on How to Generate Setting Barcodes

The pictures below illustrate how to generate setting barcodes, taking the Barcode Reader

setting for example.

1) Please refer to 2.6.5 Barcode Reader (ReaderConfig Utility) for creating profiles and

configuring the barcode reader settings.

2) Click the “Create 1D barcode ” or “Create 2D barcode ” button in the tool

bar to decide the barcode type to be generated.

3) Select the profile and the profile settings to be exported from each tab page.

Page 123: Android Deployment Configurator - CipherLab

123

Barcode To Setting

4) After double-clicking a profile, the Detail page shows up. You can also configure the

barcode reader settings in this step. Note that settings relating to file location can be

enabled only for assigning the URL (File Transfer and Auto Installation tabs).

5) Click the “Create PDF file ” button to generate the barcode which will be

immediately saved in a PDF file with the file name as the project name.

Page 124: Android Deployment Configurator - CipherLab

124

Android Deployment Configurator User Guide

Note: You could export all your demand settings available for generating barcodes at one

time.

6) Print out the barcodes for your mobile computers running the BarcodeToSetting app to

sequentially scan to apply the configurations.

Then the configurations of your devices is complete.

Page 125: Android Deployment Configurator - CipherLab

125

Multi-language Support

Other than the default interface languages, you can customize your own language file and

apply it to this program.

In This Chapter

4.1 Creating Your Own Language File ................................ 126

4.2 Editing Your Own Language File .................................. 130

Multi-language Support

Page 126: Android Deployment Configurator - CipherLab

126

Android Deployment Configurator User Guide

4.1 Creating Your Own Language File

1) Click Preferences in the Toolbar to open “Preference” window.

2) Click “Add” to create your own display

language. English and Japanese are both

system default languages, to which you are

not allowed to make modifications.

Save : Save the settings and close the “Preference” window.

Cancel : Directly close the “Preference” window without saving any change.

Add : Add a new display language.

Edit : Edit the selected display language.

Delete : Delete the selected display language.

3) Click “Add” to create your own display language. English and Japanese are both system

default languages, to which you are not allowed to make modifications.

Add

The ADC default system language “English” and “Japanese” are not

editable by user.

Page 127: Android Deployment Configurator - CipherLab

127

Multi-language Support

4) In the Edit Language window, select the listed item whose wording you would like to

modify. The default wording is shown on the left while the one on the right is for editing

into your language. Input the text in the edit box.

The default

wording (Uneditable) Edit the text of your

own language here

Click the row to open the edit box to modify your language.

Page 128: Android Deployment Configurator - CipherLab

128

Android Deployment Configurator User Guide

5) In order to locate your desired item, you can change the alphabetical order of the entries

or make use of the Quick Search box.

6) Select a label for your language from the drop-down menu on the lower-left and click on

“Apply ”, you will have new option(s) for the display language.

Quick Search

Select your language from the drop-down menu.

Page 129: Android Deployment Configurator - CipherLab

129

Multi-language Support

The tool bar buttons in the “Edit Language” window are as below:

Button Description

Apply:

Click “Apply” button to save all the wording you edit. Please note that you need to select your edit language from the drop-down menu before applying. The “Edit Language” window will be closed once the setting is saved.

Cancel:

Click “Cancel” button to directly close the “Edit Language” window without saving any setting changes.

Ascending:

To display the default wording (English) in alphabetical order from A to Z.

Descending:

To display the default wording (English) in alphabetical order from Z to A.

Reset:

Reset all the language editing changes to default.

Page 130: Android Deployment Configurator - CipherLab

130

Android Deployment Configurator User Guide

4.2 Editing Your Own Language File

You can edit and delete a customized language file.

1) Click “Preferences ” in the toolbar.

2) Choose the language tag. To delete it, click “Delete” or “Edit” to modify its content.

Save: Save the settings and close the “Preference” window.

Cancel: Directly close the “Preference” window without saving any change.

Add: Add a new display language.

Edit: Edit the selected display language.

Delete: Delete the selected display language.

Browse: Browse through the PC folder to designate the location to save your ADC projects.

Clear Log: Clear all log files.

Save log file by project: Decide whether to have logs saved (in ADC program folder)

while working on your project. You may click “Clear log ” to clear all log files if

necessary.

Show dialog at Startup: Decide whether to show the following dialog when ADC

starts. You may de-select the checkbox right inside the dialog or in Preferences.

Pop-up window: Decide whether to show the status message in the pop-up

window.

Snackbar messages timeout: Adjust Snackbar & Messages timeout if necessary.

3) Make sure to click “Save ” to save your settings.