microVNC micro-VNC operation manual


Introduction

Installation of micro-VNC

Quick start

Operation before/after connection

Operation under connection(VNC connection)

Operation under connection(SSH connection)

Setup ZYWRLE

Setup sound server

FAQ:Frequently Asked Questions

Acknowledgement

Change log

Copyright, a qualification, etc.


Introduction

This document explains the operation of micro-VNC.

In order to use micro-VNC, you needs prior preparation such as a setup of the network of Palm, installation/setup of the VNC server on PC to connect and network/firewall setup, etc.
We assume that prior preparation is already completed and explain.


Installation of micro-VNC

Please extract distributed micro-VNC package (mVNC.zip) and you will get 4 PRC files. You can select a favorite one from them and install in an Palm OS machine using functions, such as HotSync.
4 PRC files are as follows.

* When using Tungsten T3 of PalmOne, you need to install the additional library for enabling a DIA function. A required file can download from here. (This is not the distribution of our company but a distribution from PalmOne.)

* When you use SSH2 (SSH protocol Version 2), please install the *.prc file in below a SSH2/subdirectory.

If you install micro-VNC in an Palm OS machine, the micro-VNC icon will appear on a launcher.


Quick start

Before knowing details operation of micro-VNC, the minimum procedure shows how to use micro-VNC.


Connection list form

Tap the micro-VNC icon on a launcher, and micro-VNC is started. and Connection list form appears.

The meaning of each part of the form is as follows.

In addition, you can perform following operation by the Jog dial when you use SONY CLIE.


Connection edit form

This form appears when you made a new connection or edit a certain connection.

The meaning of each part of the form is as follows.


Details setting form

If you tap [Details] button on the Connection edit form, this form appears.

The meaning of each part of the form is as follows.


Display setting form

If you tap [Display..] button on the Connection edit form, this form appears.

The meaning of each part of the form is as follows.


Key setting form

If you tap [Keys..] button on the Connection edit form, this form appears.

The meaning of each part of the form is as follows.


Menu setting form

If you tap [Menu..] button on the Connection edit form, this form appears.

The meaning of each part of the form is as follows.


System log form

In micro-VNC, the situation of operation is recorded as a log. A log can be referred to on this form. Moreover, when a connection mistake is made, this screen appears automatically and a user may be notified of the situation which made a connection mistake.

The meaning of each part of the form is as follows.


Shareware registration form

micro-VNC is shareware. you may use this software for 14 days after installation free of charge. you also can continuously use this software by purchasing a license code.
you can perform registration operations like the check of your Registration Code required for license purchase or the input of purchased License Code.

The meaning of each part of the form is as follows.

In addition, as for the code, Registration Code and License Code consist of an English capital letter, a number, and "- (minus/hyphen)." Moreover, in order to prevent confusion of a character, 0 (zero) and 1 (one) are not used but O (ou) and I (ai) are used. Be careful to prevent mistakes when you input the code.


Macro setting form

Though side menu is convenient function as is, you can customize side menu by editing macro.

Macro is series of operation. It consists from 8 operations like key or mouse operation.

You can do the series of operation by selecting macro with side menu.

The meaning of each part of the form is as follows.


Operation under connection(VNC connection)

Once you connect with PC, all key(Graffiti) inputs and pen inputs are sent as the key/mouse input to PC, so you can operate PC in the same way with using PC directly.

However, in the some operations which are not in standard Palm OS such as a Shift key,a right mouse button click, etc, you have to use the special input ways.
Moreover, there is also operation for operating not the PC but the micro-VNC itself.
Here, we explain these operations.

(Notice): Although we explain the button function as V0.92 compatible binding, the button binding can be changed from V0.93. So, this explanation may not fit with the button function when you change button binding.

Although Tungsten T3 was used as a Palm OS machine and Windows XP was used as an OS of PC in this explanation, the operation method is the same at every OS and an Palm OS machine.

The meaning of each part of the form is as follows.

The network indicator that shows the status of communication is displayed on the right-top corner of the screen while communicating. The meaning of this indicator is as follows.

The pen and the key operation are accepted at the status of no communication. the status might keep for a long time in the S and R status when the status of the telecommunication line is bad. At this time, the pen and the key operation are not processed though they are collected in the queue. So, you might have to wait to enter the state of no communication.

About Side menu

If you push 5-way select(PalmOne) or JogPush(SONY), you can see "Side menu". You can do various operation with this menu. The following is explanation of each menu.

(Notice): You can change each menu function by editing "Macro". See Editing macro for more detail.

About File Transfer

If you select [File Transfer] in side menu, File Transfer dialog appears and you can upload/download a file between external memory card on palm and your remote PC.

(Notice): We use Ultr@VNC style file transfer protocol. So, you should use Ultr@VNC or compatible VNC server when you use this function.

(Notice): Though you can select any source file with this dialog, you can't change distination directory. distination directory was fixed as the following.

If transfer was complete, You will see "Transfer Complete" alert. If some error was occured, You will see the following error alert.

messagedescription
Reject from remote.Transfer was rejected by VNC server.There are some reason as the following.
  • File was write protected ... For example, running program file, etc.
  • File system was write protected ... For example, memory card was write protected.
  • Not logon on remote PC ... User and privilege weren't fixed until you log on your PC.
Disable under sound.File transfer is prohibited while playing sound back.
Timeout transfer.Unsupport transfer VNC server?VNC server didn't respond to your file transfer request. If you use Ultr@VNC, this message is never occur. This message is often occur when you use non Ultr@VNC which doesn't support file transfer.
Error in file access.Some error was occur in accessing file in Palm.There are some reason as the following.
  • Palm unsupport external memory card ... You can't use file transfer with a such Palm.
  • memory card wasn't inserted ... Please insert memory card in your Palm slot.


Operation under connection(SSH connection)

By the case of SSH connection as well as the Operation under connection(VNC connection), all key(Graffiti) inputs and pen inputs are sent as the key/mouse input to PC, so you can operate PC in the same way with using PC directly.
(Since it is at terminal connection, there is no pen (mouse) operation.)

In the some operations which are not in standard Palm OS, you will use the special keypad as well as VNC connection.

Refer to the Operation under connection(VNC connection) for operation of a special keypad.

In addition, if FN is changed into ON state, it will be in a button shift state like the following screen.

In this state, the button of the 12th which cannot usually be displayed on a screen comes to be displayed on the position of the button of the 6th. (The 1st button is in the leftmost on this screen, and the 13th button is in the rightmost.)

When you operate the Key(15th) button or the Rot(16) button, Please operate it after pushing the FN button and displaying these first.


Setup ZYWRLE

Almost VNC server doesn't support ZYWRLE because it was developed by us. If you want to use ZYWRLE, you need to do the following.
Windows:Ultr@VNC V1.0.2
We provided binary of ZYWRLE support Ultr@VNC V1.0.2.
Please download it and replace files after installing Ultr@VNC V1.0.2.
UltraVNC-102-ZYWRLE.zip
Other OS/Other VNC server
Build VNC server yourself. Please get VNC server source and apply the patch.

We propose to VNC developer that VNC server support ZYWRLE. So, you will not need to do above additional step in the future.

If you want to learn about detail of ZYWRLE, see the reference implementation of ZYWRLE.


Setup sound server

Sound stream is delivered by another server separated from VNC server. Sound protocol is ESD(Enlightened Sound Daemon) with Vorbis sound compression extension by us. If you want to use sound stream, you need to do the following.
Windows:Use EsdMonSrv
We provided sound server named EsdMonSrv.
Please download it and launch it when you want to use sound stream.
ESDMonSrv.zip
If you want to use EsdMonSrv, you also need to download Ogg Vorbis DLL from rarewares. Please extract it and copy it in EsdMonSrv directory.
UNIX type(Linux, etc.):
We provided the patch which adds Vorbis sound compression extension to original esd. Please get esd source, apply the patch and build it.
esound-0.2.35-vorbis.diff.txt


FAQ:Frequently Asked Questions

Q. Although I can connect in PalmVNC, I can't connect in micro-VNC. Why?
Q. The connection disconnects immediately after the connection. Why?
A. Plese turn Use SSS extension(VNC compatible)mode off.
If you can connect in this mode, your VNC server does not support SSS(Server Side Scaling).
Since SSS is extension, not all VNC server support it.(PalmVNC will not use SSS if scaling is set to 1:1) We recommend you to upgrade your VNC server because SSS is important in low-power device or low-bandwidth. But you can also use old VNC server in this mode. Notice that Scaing and Fuzzy drawing disable in this mode.
The SSS support of popular VNC servers is following:

OS/Server type VNC Server SSS Support Comment
Windows RDP Proxy rdp2vnc Support The server is provided from our site.
Standalone Ultr@VNC Support Garbage may sometimes remain in a screen.
RealVNC Support in part It unsupports by default.
We provided the SSS supporting server of V3.3.7.
Others
(TightVNC etc.)
Unsupport  
Unix Xvnc RealVNC Need to patch You need to patch to the source code and need to rebuild it.
The binary distribution like a Linux package may not support SSS.
Mac OS X Native OSXvnc Support It supports by default from V1.5

Q. Scroll bar is displayed incorrectly in Tungsten T3.
A. Have you installed T3_DIA_Compatibility_prcs.zip? You must install it in Tungsten T3.


Acknowledgement

The following non-GPL freeware is built into micro-VNC. These excellent softwares are licensed under a licence which basically means that you are free to get and use it for commercial and non-commercial purposes. I am thankful to authors from my heart. (Please refer to the following link about each author's copyright display.)

Moreover, micro-VNC was not born without the following excellent software for Plam OS. I pay my respects to their original way-of-thinking power on an advanced target, and thankful from my heart.

And the micro-VNC itself is not realized without the open source technology of VNC above all. Similarly, I pay my respects to their original way-of-thinking power on an advanced target, and thankful from my heart.


Change log


Copyright, a qualification, etc.


All Rights Reserved Copyright (c) 2000-2004, Hitachi Systems & Services, Ltd., RDC(Research & Developement Center)