CipherLab RS36 User manual

Terminal Emulator User Guide
RS36
RS35
RS51
RK95
RK25
Version 1.04

Copyright © 2023 CIPHERLAB CO., LTD.
All rights reserved
The software contains proprietary information of CIPHERLAB CO., LTD.; 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 CIPHERLAB and the client and
remains the exclusive property of CIPHERLAB CO., LTD. If you find any problems in the
documentation, please report them to us in writing. CIPHERLAB 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 CIPHERLAB CO., LTD.
For product consultancy and technical support, please contact your local sales representative. Also,
you may visit our web site for more information.
The CipherLab logo is a registered trademark of CIPHERLAB CO., LTD.
All brand, product and service, 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

RELEASE NOTES
Version
Date
Notes
1.04 Jul 17, 2023 Pictures updated
New: RS35, RS36, and RK95 included
Modified: 2.2, 4.3 Screen Orientation –
location of the icon and
options updated
Modified: 2.3.2 Session Items – Session Title, Command Prompt
and Command added in Host Profile
Modified: 2.3.2 Session Items – Port, Barcode settings, Login
Name, Login Password, Login Name Prompt, Login Password
Prompt descriptions
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Remote Character Set removed and Sever Language added in VT
Settings
Removed: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Code Page, Auto Reset, and Custom Device Name in TN Settings
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Sever Language, WorkStation ID, and Override field properties
added in TN Settings
Removed: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Show Session Number, Set HW Key to Exit App, Set HW Key to
Control SIP, Show Navigation Bar, Show Wi-
Fi/Battery Info on Full
Screen, Update Wi-Fi/Battery Icon Interval, Choose Wi-Fi Alert
level, and Choose Battery Alert Level in Screen Setting
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Floating Action Button, Auto Popup SIP On Connection, Haptic
Feedback On Keypress, Popup On Keypress, Keyboard Layout, Line
Spacing, and Show Status Bar added in Screen Setting
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Font
Size and Color Settings options updated in Screen Setting
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Control Reader By Command, Feedback By Command/Text options
updated in VT Alarm
Modified: 2.3.2 Session Items, 4.1.2 Emulator Settings –
Connect Timeout added in Network Setting
Removed: 2.3.4 Activation Key, 2.3.6 Program Name
Modified: 2.4.2 Option, 2.4.3 Register, and 2.4.5 Session
Details added
Modified: 2.4.6 About –Keypad Type and Serial Number added
Modified: 4.1.1 Settings – Generate Log file path updated
Modified: 4.1.2 Emulator Settings –Key Mapping and SSH
descriptions
Removed: Appendix

1.03 May 21, 2019 Pictures updated
Removed: 2.3.6 Languages
New: RS51 included
Modified: 4.1.1 Settings – Generate Log file path
Modified: 4.1.2 Emulator Settings – Remote Character Set
descriptions
Modified: 4.1.2 Emulator Settings – Override Server Color
added in Screen Settings
Modified: 4.1.2 Emulator Settings – Sound and Sound File Name
descriptions
1.02 Nov. 02, 2018 New: RK25 included
1.01 Apr. 12, 2018 Modified: 2.2.2 Session Items – “Clear field before inputting scan
data” updated for TN Settings
Modified: 2.2.2 Session Items – font size options updated
Modified: 2.2.2 Session Items – Volume Up 
VT ESC function
added
Modified: 4.1.2 Emulator Settings – “
Clear field before inputting
scan data” updated for TN Settings
Modified: 4.1.2 Emulator Settings – font size options updated
Modified: 4.1.2 Emulator Settings – Volume Up VT ESC
function added
1.00 Jan. 04, 2018 Initial release

CONTENTS
RELEASE NOTES ...............................................................................................................................III
CONTENTS ..........................................................................................................................................I
INTRODUCTION ................................................................................................................................. 1
Features............................................................................................................................................. 2
1 SETUP ............................................................................................................................................ 3
1.1. Install........................................................................................................................ 4
1.2. Launch Terminal Emulator...................................................................................... 4
2 USER INTERFACE........................................................................................................................... 5
2.1. Screen Terminology................................................................................................. 6
2.2. Screen Orientation................................................................................................... 7
2.3. Session List & Session Settings ............................................................................. 8
2.3.1. Session Management ............................................................................................. 8
2.3.2. Session Items .......................................................................................................... 9
2.4. More Button ...........................................................................................................16
2.4.1. Full Screen .............................................................................................................16
2.4.2. Option .....................................................................................................................17
2.4.3. Register ..................................................................................................................20
2.4.4. Export/Import Settings..........................................................................................22
2.4.5. Session Details ......................................................................................................23
2.4.6. About ......................................................................................................................23
2.4.7. Exit ..........................................................................................................................24
2.5. Connection.............................................................................................................25
2.6. Terminal Screen.....................................................................................................26
2.7. Using On-Screen Keyboard ...................................................................................27
3 USAGE AND DATA COLLECTION................................................................................................... 28
3.1. Start a Telnet Session ...........................................................................................29
3.2. Collect Data............................................................................................................30
3.3. End a Telnet Session.............................................................................................30
4 SETTINGS..................................................................................................................................... 31
4.1. Session...................................................................................................................32
4.1.1. Settings ..................................................................................................................32
4.1.2. Emulator Settings ..................................................................................................35
4.2. Host Session ..........................................................................................................48
4.3. Screen Orientation.................................................................................................49

1
INTRODUCTION
Terminal Emulator is brought to support mobile devices, which are high performance products
powered by the Android platform. The application is developed for industries which make extensive
use of terminal emulators. It enables your mobile computer to act as a terminal emulator while
communicating with a host of the same environment.
Terminal Emulator is a telnet client with extended ability to launch and configure reader module(s). It
links to available reader module(s) when a physical scan button is pressed, to collect decoded data
and submit data to the host afar.
This manual details the setup and usage of Terminal Emulator. The application is simply addressed as
“Terminal Emulator” hereinafter. We recommend that you keep one copy of this manual at hand for
quick reference.
Thank you for choosing CipherLab products!

2
Terminal Emulator User Guide
FEATURES
Support TN5250 and TN3270 terminal emulators
Support VT100, VT102, VT220, and ANSI terminal emulators
Full-screen maximization with a double tap
Control over reader module(s)
Data auto-insertion by reading printed barcodes or RFID tags
Data submission to a remote host
Password control for accessing settings and exiting the application
Easy reproduction of settings by means of a configuration file
Support auto login, cursor tracking, etc.
Support key mapping
Audio/tactile feedback control
Font size, line spacing configuration
Font, background, cursor color configuration (for activated devices only)
Multi-language support for TN 5250 and TN 3270 emulators
Support multiple host sessions and Macro operation (for activated devices only)

3
1 SETUP
This chapter provides a straightforward guide for setting up the Terminal Emulator. It only requires a
few clicks to activate the installer and complete the installation process.
IN THIS CHAPTER
1.1 Install ................................................................................... 4
1.2 Launch Terminal Emulator ....................................................... 4

4
Terminal Emulator User Guide
1.1.
INSTALL
Terminal Emulator is pre-installed and pre-licensed only on mobile devices with physical keyboards.
Some functions may be disabled on other models before users purchase the license.
To update this app on your mobile device, you can transfer the installation file (.apk) from the
computer to your device through USB connection. It is strongly recommended to install applications
from trusted sources.
1.2.
LAUNCH TERMINAL EMULATOR
Once the installation finishes, proceed to launch Terminal Emulator:
Tap the icon to run the Terminal Emulator.

5
2 User Interface
2 USER INTERFACE
This chapter introduces the user interface of Terminal Emulator. Understanding user interface helps
escape confusion and jump seamlessly within the application.
2.1 Screen Terminology ................................................................ 6
2.2 Screen Orientation .................................................................. 7
2.3 Session List & Session Settings................................................. 8
2.4 More Button ..........................................................................16
2.5 Connection............................................................................25
2.6 Terminal Screen ....................................................................26
2.7 Using On-Screen Keyboard .....................................................27
IN THIS CHAPTER

6
Terminal Emulator User Guide
2.1.
SCREEN TERMINOLOGY
The screenshot below shows Terminal Emulator opened on the mobile computer.
On-screen elements include the following:
Term
Description
Toolbar Present a few icons that quickly launch some actions from Terminal
Emulator.
Terminal screen Show the exact output displayed on the emulated terminal.
Connection button /
Open On-screen
Keyboard
On a session screen where the current session is not yet connected, tap on
this button to build up connection.
On a screen of a connected session, this button turns into ;
tap on it to open on-screen keyboard to input text.

7
2 User Interface
2.2.
SCREEN ORIENTATION
To set screen orientation, tap icon in the toolbar. Then tap icon in the upper-right corner to
bring up the dialog.
When the dialog shows up, tap the icon in the center of the dialogue box to switch among Keep
Portrait, Keep Landscape 90
°
and Keep Landscape 270
°
. Then tap “APPLY”to complete the
setting.

8
Terminal Emulator User Guide
2.3.
SESSION LIST & SESSION SETTINGS
2.3.1.
SESSION MANAGEMENT
Terminal Emulator features a menu, which manifests itself as a list of options for accessing Terminal
Emulator settings.
The Session List and Session Settings are mainly designed to configure telnet sessions.
Tap icon in the toolbar and then tap the plus sign icon to add new sessions or tap the setting icon
to configure an existing session.
To delete an unwanted session, just swipe the item from left to right. Then tap the trash can icon to
remove the session.

9
2 User Interface
Or, you can also tap icon in the toolbar to configure the current selected session.
2.3.2.
SESSION ITEMS
The following tables briefly explain each setting item for a particular session in the list.
Host Profile
Menu Item
Brief Description
Session Title Tap this item to bring up the dialog to specify a session title.
Emulator Type Tap Emulator Type to set the profile to connect to the prospective
host, VT or TN type.
IP Tap this item to bring up the dialog to specify IP address or name of
the host.
Port Tap this item to specify a port number.
Auto Connect Check this item to enable/disable auto connection.
Auto Login Check this item to enable/disable auto login.
Login Name Tap this item to bring up the dialog to specify login name.
(This option is available after you enable “Auto Login”)
Login Password Tap this item to bring up the dialog to specify login password.
(This option is available after you enable “Auto Login”)
Command Tap this item to bring up the dialog to specify the command to send
to the host at the command prompt. This function is only available
for VT host types.
(This option is available after you enable “Auto Login”)
Login Name Prompt Tap this item to bring up the dialog to specify the text exactly
displayed by the host service to prompt for user name. This function
is only available for VT host types.
(This option is available after you enable “Auto Login”)

10
Terminal Emulator User Guide
Login Password Prompt Tap this item to bring up the dialog to specify the text exactly
displayed by the host service to prompt for password. This function is
only available for VT host types.
(This option is available after you enable “Auto Login”)
Command Prompt Tap this item to bring up the dialog to specify the text exactly
displayed by the host service to prompt for command. This function
is only available for VT host types.
(This option is available after you enable “Auto Login”)
Term Login Tap this item to bring up the dialog. Select the radio buttons between
Tab and Enter to assign the key to switch over Login Name and Login
Password when Auto Login is enabled. This function is only available
for VT host types.
(This option is available after you enable “Auto Login”)
Emulator Settings
Menu Item
Brief Description
VT Settings
Convert to Uppercase Capitalize all the letters of input data.
Line Buffer Show typed text and commands locally on Terminal Emulator, and
transmits them to host service only after Enter key is hit to confirm
the input.
By default and by characteristic of VT Emulator, Terminal
Emulator sends entered text to host service character by
character without hitting Enter key.
Local Echo Show typed text locally on Terminal Emulator just as it is being
transmitted to host service.
Typed commands will not be shown locally.
Send String when Connect Define the command that Terminal Emulator sends to host service
on connection. Tap the text field to enter the desired command.
New Answer Back Specify a string to be sent to the host when receiving an ENQ from
the host.
Server Language Assign the character code for displaying the characters received
from the server.
Replace Char if Unconvertable When “UTF-8” is assigned in Server Language, this control bar is
available. Swipe it from left to right and tap to assign a replacement
character.
If the characters received from the server are unconvertable, a
replacement will be displayed on the terminal. Options are:
(Blank), X, %, &, ≠, -, _
TN Settings
Server Language Assign the character code for displaying the characters received
from the server.
WorkStation ID Specify a string less than 10 characters to be sent to the host when
receiving an ENQ from the host. Users can include the variables as
follows for device identification:

11
2 User Interface
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 (TN Emulators)
Convert to Uppercase Capitalize all the letters of input data.
Auto Unlock Enable the mobile computer not to be locked or give out an alarm
sound when pressing any keys.
Override field properties Check it to send the contents of all fields to the host service when
pressing field exit keys or entering the last character in the last
required field.
Clear field before scanning
data
Check it to clear the field before inputting the scanned data.
Field Length if Exceed Define how to handle a scanned data when it exceeds 5250’s
specified field length. Options are:
Reject, Truncate, Split to next field
Error Message Adjust the location and the form of an error message to display on
the terminal screen.
Setting
Description
Default
Display
error in
ROW
Select the location (row number) to
display an error message if an error
occurs.
23
Pop-up
Window
Show the error message in the form of
a pop-up window.
Deselected
(Disabled)
Screen
Show Connecting Host IP Display connecting host IP right beneath the toolbar.
Screen Panning Check it to enable/disable viewing the desired portion of the screen
by swiping the display.
Floating Action Button Check it to enable/disable showing the floating action button for the
on-screen keyboard.
Activate Macro Check it to enable/disable pop-up Macro toolbar on the screen once
the session is connected.
Auto Popup SIP On Connection Check it to enable/disable the pop-up SIP to automatically display
on connection.
Haptic Feedback On Keypress Check it to enable/disable vibration when pressing the keys on the
on-screen keyboard.
Popup On Keypress Check it to enable/disable key icons popping up when pressing the
keys on the on-screen keyboard.
Keyboard Layout Tap to choose the on-screen keyboard layout between Type 1 and
Type 2.
Cursor Type Change the cursor type between three different modes. Options are:

12
Terminal Emulator User Guide

Default (half block cursor)
Underline (underline cursor)
Block (full block cursor)
Auto Tracking Auto-position Terminal Screen to bring cursor into view. Enable auto
tracking by swiping the control bar from left to right and tap 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.)
Locked Location When Auto Tracking is set to Locked Location, users can tap this
item to specify the accurate coordinates.
Font Tap to assign the font to show characters in Terminal Screen.
Options are:
Courier New
Lucida Console
Excalibur Monospace
NetTerm ANSI
NetTerm OEM
Font Size Tap to assign the size to show characters in Terminal Screen.
Line Spacing Tap to assign the line spacing in Terminal Screen.
Color Settings Tap this item to customize the font color, background color, and
cursor color in the Terminal Screen according to user preferences.
Override Server Color Check this item to display the customized font, background, and
cursor colors in Terminal Screen, instead of the colors assigned by
the server.
Full Screen
Auto Full Screen On Connection Tap to enable/disable full screen mode automatically when the
device connects to the server.
With Terminal Screen maximized, both the Android status bar
and the application’s toolbar are covered up.
Show Status Bar Tap to enable/disable the Status Bar in full screen mode.
Alarm
Control Reader By Command Enable the host service to send commands in order to turn on/off
the reader module. Deselected by default.
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: Tap to select a sound from the pop-up list or tap the
User Defined radio button to locate a wav file.
Sound File Name: When User Defined is selected, tap to
select a wav file for playing when a message is displayed.
Vibration Duration: Tap to specify the time interval ranging
from 0 to 5 seconds in increment of 0.5 seconds.

13
2 User Interface
Feedback By Command/Text Enable the host service to respond to Terminal Emulator by
sending a command (escape sequence) for good or erroneous
inputs. Deselected by default.
Good Feedback: Assign the command (escape sequence)
for input success. When Terminal Emulator receives the
command, the mobile computer will play the specified beeper
sound or vibrate for the specified amount of time.
Setting
Description
Default
Feedback
Type
Select By Command or By Text. By
Command
Command Enter the sequence of interest. --
Sound Select a sound from the pop-up
list or tap on User Defined.
Mute
Sound File
Name
When User Defined is selected,
tap to select a wav file from the
device.
Deselected
(Disabled)
Vibration
Duration
Select the amount of time to
vibrate. Configure vibration
duration between 0 and 5 sec
(in increments of 0.5 sec).
0 sec
Error Feedback: Assign the command (escape sequence)
for input failure. When Terminal Emulator receives the
command, the mobile computer will play the specified beeper
sound or vibrate for the specified amount of time.
Setting
Description
Default
Feedback
Type
Select By Command or By Text. By
Command
Command Enter the sequence of interest. --
Sound Select a sound from the pop-up
list or tap on User Defined.
Mute
Sound File
Name
When “User Defined” is
selected, tap to select a wav file
from the device.
Deselected
(Disabled)
Vibration
Duration
Select the amount of time to
vibrate. Configure vibration
duration between 0 and 5 sec
(in increments of 0.5 sec).
0 sec
Key Mapping
Terminal Emulator supports Key Mapping, enabling users to define
a physical key (combined keys) of the mobile device mapping to a
specific function performed on the server.
Key Mapping settings differ between VT and TN Emulators.
Tap to select a Server Key and configure the Mapped Physical Key
settings.
For more details, please refer to Key Mapping in 4.1.2 Emulator
Settings.

14
Terminal Emulator User Guide
Setting
Description
Category List the categories of Physical Keys. Options are:
Alphabets
Numbers
Punctuations
Function Keys
Navigation Keys
Editing Keys
Physical Key Serve the function of the Server Key.
Shift/ Ctrl/
Alt
Function with the physical key if selected.
Clear Key Make the selected Physical Key Undefined.
Trap Assign the command of a Server Key to a
Physical Key by directly pressing the latter one
on the mobile computer.
Reset Return to default Physical Keys.
Volume Up VT ESC
When this function is enabled and a connection to the VT server is
established, pressing the volume up button will send “ESC” to the
VT server. This function is only available for VT Emulator.
SSH (VT Only)
SSH Swipe the control bar from left to right to enable SSH.
SSH Log Tap to enable/disable recording data about SSH connections.
Authentication
Authentication Type Tap to select the authentication type between Name/Pwd and Key
File.
Advanced
Login Name Tap to specify login name.
Key File Tap to manage key files.
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 Emulator 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

15
2 User Interface
Re-Key Every 1G of Traffic
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.
Server
Environment Specifies environment variables to be set on the SSH server.
Commands Represent 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 Tap to configure what type of proxy you want CL TE to use for its
network connections.
Host Tap to specify the DNS name or IP address of the proxy server. The
default is blank.
Port Tap to 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.
Network
Network Keep Alive Tap to enable/disable sending a thread to the host according to the
time interval to make sure it’s connecting to the host.
Detect out of Range Tap to enable/disable detecting if the device is out of network
range.
Connect Timeout
Tap to establish a time period within a connection with the server.
Barcode Settings
Configuration Tap to proceed with related settings. Please refer to the device user
manual.
Debug
Generate Log Tap to determine whether to generate log.