MOCHA Telnet for Android
USER GUIDE
Contents
1.0 Screen
- Move finger on the screen = scroll the screen (only if fixed font in menu - settings is not enabled)
- 2 finger pinch on the screen = Zoom in/out
- Hold finger down on the screen for 1 second = Enter window mode. Move finger up/down to move the 5250 window
- Select scroll from menu - arrows, and a finger up/down can scroll back in the 400 lines buffer.
1.1 Clipboard
From the menu, click select, and the top menu change to Cancel,Copy and Copy all. Move the finger on the screen to select an area
to copy, and hereafter click Copy.
If using a real mouse, it can also be used to select an area. Mouse right click brings up a menu with copy and paste.
Red status line
- Cursor y,x : is the cursor position.
- ctrl : Ctrl key is pressed
1.2 Menu bar
- ABC: Will pop up the normal keyboard.
- F1-F12: function keys F1 - F12 .
- F13-F20: function keys F13 - F20 + PA1-PA4 .
- Arrow keys: Arrow up, down left and right. Also extra keys such as ctrl and scroll.
- Keys: Other telnet keys.
- Zoom: Zoom the screen out.
- Select: Enter clipboard select mode.
- Paste: Paste clipboard data at cursor position.
-
Disconnect: Close the connection.
- Font size: Change the font size. (only if fixed font in menu - settings is enabled)
-
Barcode scanner: Use the build in camera as a barcode scanner.
-
Voice input: Use the OS build in voice to text function
There is not space on the title bar for all menu elements. The hidden elements can be selected either with a click on the 3 dots icon , or on some devices the "menu" button.
1.3 Wireless keyboard
- f1 - f12 = f1 - f12
- shift + f1 = f13
- shift + f2 = f14
- shift + f3 = f15
- shift + f4 = f16
- shift + f5 = f17
- shift + f6 = f18
- shift + f7 = f19
- shift + f8 = f20
- shift + f9 = PF1
- shift + f10 = PF2
- shift + F11 = PF3
- shift + F12 = PF4
- Insert = VT220 Insert here
- Delete = VT220 Remove
- Page up = VT220 Previous screen
- Page down = VT220 Next screen
- End = VT220 select
- Home = VT220 Find key
1.4 menu - Configure
A list of already configured Telnet sessions is shown. Select
+ in the titlebar to create a
new configuration.
- Server IP Address: Name of the Telnet server. Either a TCP/IP address as 155.22.11.2 or a DNS name.
-
Alias Name: Give the session configuration a name, as it is easier to remember
than the IP address. This is only useful, if more than one host configuration
will be used.
- Port number:Port number for the session. As default Telnet uses port 23 and with SSH2 port 22
- SSH2: Enable SSH2 protocol. Certificates are not supported, only user/password validation.
- Terminal type: Use this command to define the telnet Terminal type. As default it is vt220. This type is send to the Host on session setup, and will be saved as the environment variable TERM
- Auto login: If the user and password field should be used. Notice there is not much security involved doing it! It could be an idea to contact the system administrator to verify it is your company politic to have open access to the system without any password security.
- Search user/password:
As to know when to send send the user id and password, Telnet will look for 2 data strings.
- Send keep alive : If Telnet should send extra keep alive frames at Telnet protocol level.
- Local echo : Defines if characters typed on the keyboard should be echoed local on the screen.
- CR = CRLF: Select if the Return key should send CR or CRLF.
- 8 bit mode: As default a VT220 terminal starts in 7 bit mode. Key data can be send in 7 or 8 bit mode. The UNIX server can with an Escape sequence
overrule this parameter.
1.5 Menu - Settings - Network
- Show telnet negotiation: Use it if problems, to view the low level negotiation
- Keep WIFI online: Tell the OS to keep the network alive, when Telnet is running
-
Stay connected: If Telnet is send to the background, it
can either close an active session with
the server or keep it alive
1.6 Menu - Settings - Terminal
- Make space for Fxx keys: The key banner can be selected to be displayed above the telnet window.
- Fxx keys in portrait mode: On a large screen, use the extra space between the QWERTY keyboard and telnet window, to display all the VT220 keys.
- Fixed font: if enabled, adjust the font size from menu "font size". if not enabled, use 2 finger pitch to change the font size.
- Lock screen:: Selected, and the screen will not change orientation, when in a telnet session.
- Stop screen from scrolling:: Selected, and the screen cannot scroll, when in a telnet session.
- Use full height in portrait: Either the screen can zoom out to use the full height or width when in portrait. In landscape the height is always used
- Bell: If a bell request from server should be accepted or ignored.
- Application mode: If the VT220 terminal can use this special mode.
- Show IP address: If the server IP address should be shown in the red status bar
- Barcode Enter: Send Enter key value after a barcode scan. Can only be used with camera as barcode scanner.
- Barcode Tab: Send Tab (0x9) value after a barcode scan. Can only be used with camera as barcode scanner.
- Scroll speed: How fast the screen should scroll
- Keep display on: The screen will not turn off, when inactive.
- Confirm close session:A confirm dialog will pop up, if back key is pressed.
- Connect on app start:Make a session to the first server in the configuration list.
- Display keyboard at session start:Pop up the screen keyboard at session start.
- Use raw key input from hardware:A hardware barcode scanner should use it. If using a BT hardware keyboard, which uses double keys, turn this option off.
1.7 Menu - Settings - Colors
Text, background and Cursor colors can be changed with this dialog.
1.8 Menu - Settings - Lock configuration
Lock access to configure and settings with this option. If the key is lost, the program must be deleted and installed again.
This option gives no data protection, but is
included as to make it easier for a system administrator to support many devices in a company environment.
1.8 Menu - Settings - Key values
Define what each key should send. Write special characters as octal \xxx. Example, ESC is 0x1b or octal \033
Click here for an ASCII table
2.0 Import/Export a configuration
In menu - configure - top menu is an option "export configuration". It can build an URL, which
includes the full configuration for the first server in the list + all settings values.
This URL can later be used to import the data, either using a mail client or a web page. You cannot click example below from a PC browser, only the web browser on an Android device.
Example
It is also possible to export a limited configuration URL, which can be used to build a QR code.
A QR code with the configuration, can be scanned with the camera, and imported to Telnet.
A large QR code can give problems to read for some camera types, therefore try to make the data in the URL as small as possible.
2.1 Using a standard Bluetooth barcode scanner
As default a standard BT barcode scanner is seen as a physical keyboard, and it will block the screen keyboard.
In Android Settings - Language and Input - Physical keyboard, enable option Show virtual keyboard. This will keep the screen keyboard on, while a physical keyboard or barcode scanner is active.
2.2 Enable Automated Enter or TAB after a scan on Zebra barcode devices
- Select app DataWedge from the Launcher
- Tap Profile0.
- Select Basic Data Formatting under the Keystroke Output section.
Warning, there is also a Basic Data Formatting in section IP output.
- Check the box Send ENTER Key. (or TAB)
- Go back to the home screen, and your setting has been applied.