Parys Technografx Ltd PTvncWM5 Manual Installing PTeSVNC (You can connect PTvncWM5 to other VNC servers instead) PTeSVNC is Parys Technografx' VNC server and client software for the PC. The installer file is "SetUpPTeSVNC.exe". To install PTeSVNC on your PC you need to run "SetUpPTeSVNC.exe", the installer will install PTeSVNC to a destination of your choice. Once installed, in order to connect to your Pocket PC you must have PTvncWM5 installed on your Pocket PC, run the WinVNC server program with a valid TCP/IP connection (eg. WiFi, Bluetooth or via the Internet) available from your Pocket PC to your PC and then run PTvncWM5 on your Pocket PC. NB. PTvncWM5 is also compatible with versions of RealVNC, TightVNC, UltraVNC, eSVNC etc. Note that when you first run WinVNC on your PC you should supply a suitable password to allow client software (such as PTvncWM5) to connect to your PC and set the desired port/display. On some systems you may need to go into the advanced options in WinVNC and enable loopback connections in order to connect to PTvncWM5 (try this if you’re sure you’re using the correct password but PTvncWM5 returns "authentication failed" when trying to connect). If connecting to RealVNC or TightVNC (or other VNC servers without compatible server scaling) then you must select the "Scaling Off" option on the password screen in PTvncWM5. Also if connecting to versions of RealVNC (or some of the other alternative VNC servers) then the "Tight" and maybe other encodings will be ignored by the VNC server and "RAW" used instead so you should change the encoding type to one compatible with the VNC server (say "Hextile") by going to the Connection Settings on the hostname entry screen in PTvncWM5 (by tapping "F1"). If you decide to use UltraVNC instead of PTeSVNC then when making changes to the connection settings from within PTvncWM5 you should select "Reconnect" or "New connection" as "Apply changes" will not work correctly. If you wish to use UDP ports other than 5900 to 5909 you will have to use a VNC server other than PTeSVNC - e.g. UltraVNC. WinVNC WinVNC is VNC server software for the PC. It allows compatible VNC client software to connect to, view (and control) your PC when it is running. When you first run WinVNC you need to supply a password that will be required from any VNC client software trying to connect to your machine. The configuration menu that appears when you first run the program can also be accessed any time WinVNC is running by either right-clicking on the WinVNC icon on your taskbar and selecting Properties, or by selecting Programs : PTeSVNC : Server : WinVNC User Settings from your Start menu. The important things to note are that you can set WinVNC to allow a client to connect and view your PC but without having remote control of your PC's mouse and keyboard, you may also disable the PC's own mouse and keyboard allowing ONLY remote control. The remove wallpaper option will do exactly that when any connection is made, this makes transfer much faster when the PC's desktop is in view. In the Update Handling it's worth enabling "Poll Console Windows Only" for many uses as most Windows software will still be viewed on the remote machine. Note that you may also disable File Transfer. On some systems you may need to "enable loopback" in the Advanced section to connect to PTvncWM5. One of the features in the Advanced section allows you to enable logging of activity - this could be useful if you have problems. To close WinVNC when it's running right-click on the WinVNC icon on your taskbar and select close from the menu (you can also change the settings this way). You may set up WinVNC as a service, if you do so WinVNC will be running each time you boot up your PC. To set WinVNC as a service go to Programs : PTeSVNC : Server : Install WinVNC Service from your Start menu (the remove service is here also). Reboot your PC after installation of the service and then set the WinVNC password/ports etc. (these are stored separately from when WinVNC is run 'normally'). In the advanced options there is an option to lock your PC when a client disconnects. If a PC is locked then you will only be able to reconnect if WinVNC is running as a service. Note also that a Control-Alt-Delete key combination sent from the client program will only affect the PC if WinVNC is installed as a service. Note that after a cold boot of a PC that requires initial logon you won’t be able to connect via VNC before initial logon even using the service version of WinVNC. DO NOT CHANGE "Initial Screen Scale" if connecting to PTvncWM5 as PTvncWM5 assumes that the screen size given it on initial connection is the unaltered pixel resolution of the server. VNCviewer The VNCviewer provided with PTeSVNC is the VNCviewer from eSVNC 112r2. VNCviewer is VNC client software for the PC that allows a remote PC to connect/control another PC running the PTeSVNC WinVNC (or other VNC) server. As with PTvncWM5 you can control your connection settings from the options in VNCviewer. Note that in order to configure your settings manually you must first disable "Automatically select parameters compatible with Connection Speed". See the section about PTvncWM5 for more help regarding the connection settings. Note also that in the VNCviewer once you have made changes you may need to select "Request screen refresh" from the menu for changes to become apparent Installing PTvncWM5 PTvncWM5 is Parys Technografx’ VNC client software for the Window’s PPC Phones and Window’s PPCs. The installer file is "InstallPTvncWM5.exe". To install PTvncWM5 to your Pocket PC you need to connect your Pocket PC to your PC via ActiveSync and then run "InstallPTvncWM5.exe" on your PC. If you are unable to do this as you only have an OSX or Linux system etc. simply copy the PTvncWM5 CAB file from the original PTvncWM5 zip file (or CD) to Windows\Start Menu\ on your PPC and then run the CAB file on your PPC to install PTvncWM5. After retrieving information from your Pocket PC the installer will allow you the option of installing to the default download location (Program Files in your normal Pocket PC memory) or to select an alternative location eg. a storage card or other directory. Simply follow the instructions on PC and PPC to install. Once installed, in order to connect to your PC you must have PTeSVNC (or other VNC software) installed on your PC, have the VNC server program (eg. WinVNC) running and ready to accept connections, and of course a valid TCP/IP connection available from your Pocket PC to your PC. Note that to connect over Bluetooth or over USB then Activesync must be running over the connection for the VNC connection to be made - this is not required over GPRS/CDMA or WiFi. NB. PTvncWM5 will now connect successfully to versions of eSVNC, PTeSVNC or UltraVNC AND RealVNC and TightVNC. Note that for VNC servers that do not have server scaling (eg. RealVNC or TightVNC) then you must use the joypad to select "Scaling Off" on the password entry screen in PTvncWM5 (see later). Also if connecting to WinVNC servers that do not support the "Tight" encoding then for optimum performance you should change the encoding type to say "Hextile" or "RRE" by going to the Connection Settings on the hostname entry screen in PTvncWM5 (by tapping "F1" - see next page). If you decide to use UltraVNC instead of PTeSVNC then when making changes to the connection settings from within PTvncWM5 you must select "Reconnect" or "New connection" as "Apply changes" will not work correctly. To uninstall PTvncWM5 from your Pocket PC the best way is to re-run the installer program on your PC, select "no" when asked if you wish to install then select PTvncWM5 from the list of installed software and select "remove". Connecting PTvncWM5 to PTeSVNC First of all a VNC server (eg. WinVNC from PTeSVNC) needs to be installed and running on your PC (see above) and you must have a valid TCP/IP connection from your PC to your Pocket PC (this could be WiFi, Bluetooth or a remote Internet connection eg. GPRS or CDMA). Secondly you need to know either the network name of the server PC or its IP address and the password that was given to the VNC server to allow connection. Now you can run PTvncWM5, select remote or local, enter the host (server) name or IP address and then the password to connect to the VNC server (eg. WinVNC). NB. The default port used is 5900, specifying a port number from 0 to 9 will use a port from 5900 to 5909, specifying a port number 10+ will use that exact port number and for remote connection the port used must be available through any router/firewall. Once connected you will view some or all of your PC's screen on your Pocket PC and (optionally in the VNC server) have control over the PC's mouse and keyboard from your Pocket PC plus (optionally in the VNC sever) be able to transfer files between PC and PPC. Entering the host (server) name/IP (and optional port) When you run PTvncWM5 you will be presented with a screen to enter the host name or IP address eg. "dave" or "192.168.0.1" (if you wish you can specify a display/port as well eg. "dave:1" or "192.168.0.1:80"). To type in the text just tap your stylus on the graphical keyboard or use your hardware keyboard if you have one. See later for more instructions on the graphical keyboard. Use the joypad directions to choose local or remote connection (irrelevant on a non-phone PPC). It should be noted that if you opt for a Bluetooth/WiFi connection then any current open connection to GPRS or CDMA (eg. from when browsing or downloading) will be disconnected. You can tap "Tab" if you wish to choose a previously saved connection. You can tap "F1" to set the initial connection options, note that some options are not supported by RealVNC (see later for more info). The initial connection options menu also features the ability to rotate your display to any 90 degree orientation. When you've entered the host (:port) the password entry screen will appear for you to give the appropriate password. If a host name is used rather than an IP address then the IP address found for the given name is displayed on the password screen (this gives you some idea whether your router located the correct machine or not). On the password entry screen you can use the joypad directions to choose whether to use server scaling or not. Note that some VNC servers (eg. RealVNC or TightVNC) do not support server-scaling and to connect to these you must choose the "Scaling Off" option. Again simply tap in text on the graphical keyboard to enter the password. After entering the password if you are running PTvncWM5 for the first time then you will enter the button definition screen. As prompted simply press the buttons you wish to use for left mouse button, right mouse button, PTvncWM5 options and as the quick exit, note that you should use the main OS control buttons (ie. not your QWERTY buttons if you have a QWERTY keyboard). Users of the some PPCs note that you should press the "Home" button when prompted for the button to use as quick exit and this button will actually be used to send "enter" keypresses to the server rather than being used for quick exit - to exit the program you'll have to use the options menu instead, if no other button reacts when trying to select a button for quick exit then press joypad centre (and again to exit the program you must use the options menu instead). IF you have major problems defining the buttons (eg. a single button press allocated to two operations) then try over-writing the "buttons.dat" file on your PPC in the PTvncWM5 folder with the version from the original zip you downloaded (from Handango, PocketGear or wherever). This will hopefully set the buttons to a usable state, if you do this and still have problems then contact support@parystec.demon.co.uk All users note that file transfer mode must be exited before you can quit the program. When viewing the Options, pressing the Options button a second time will bring up the Connection Settings menu. When viewing the Connection Settings or the Netstats pressing the Options button will remove the menu. Once the buttons are defined (or straight after entering the password) the connecting screen will appear. After a few seconds connection should be made and your PC's screen appear on your Pocket PC. If it takes longer than a minute or so for this to happen using Bluetooth or WiFi, or longer than 2 or 3 minutes using GPRS then tap the stylus on "Tap here to cancel" to go back and make sure you got the host(:port) and password correct. If you're sure you have the host(:port) and password correct and have repeated the procedure two or three times without success, then exit PTvncWM5 and re-run it to try again. Obviously when wanting a remote connection on a PPC phone via GPRS or CDMA you must have GPRS or CDMA available with a (preferably decent) signal. Please note that VNC servers from some versions of VNC are not compatible with PTvncWM5 so if you have tried everything suggested in this help file (see the support section at the end) and are still unable to connect then try using a different VNC server (such as PTeSVNC or UltraVNC) instead of the version you are currently using. For example PTvncWM5 definitely works with UltraVNC v1.0.0 rc11d, RealVNC 3.3.7 and TightVNC 1.2.9 as well as the included version of PTeSVNC. The Options menu When you press the Options button the Options menu will appear. To select an option tap it once and it will be highlighted in red. Tap the option a second time to execute the option. Redefine buttons allows you to do exactly that. Rotate screen does as it says (for left/right handed use and to switch between landscape and portrait mode). Toggle Magnify toggles the optional magnifying glass at the mouse position.. Toggle Keyboard toggles Keyboard mode on and off. Toggle Keypad toggles the Keypad on and off. Full-screen/No-Zoom/Zoom lets you set the viewing mode. Updating All/Visible allows you to choose whether changes to areas of your PC screen not currently in view are updated immediately or not. When using Updating Visible such changes will only be updated in the visible area, this can save a lot of bandwidth. Note however that when scrolling around using Updating Visible there may be a slight delay before the view is updated. Connection takes you to the Connection Settings. Netstats displays your connection statistics. Save Connection allows you to save the current connection (hostname and all settings) with a chosen name for ease of future connection. You could call the connection "Work:Bluetooth" or "Home:GPRS" etc. These connections can be recalled from the hostname entry screen by pressing Tab next time you are making a new connection. Exit program, well, exits the program. Exit Options simply removes the Options menu. It's worth noting that if the Options menu is displayed then pressing the Options button will take you directly to the Connection Settings menu. Connection Settings The Connections menu will appear when you tap "F1" from the hostname entry screen, the full Connection Settings menu will appear when connected when you either select Connection from the Options menu or press the Options button while the Options menu is displayed: Use the same method to select/change options as for the Options menu ie. tap once to select and a second time to apply. The first option allows you to enable or disable the "Copy Rect" feature of the transfer encodings, selecting this option will toggle between "Copy Rect Enabled" and "Copy Rect Disabled". (So far I have found no reason to disable this) The second option ("Tight") is the main transfer encoding method. Selecting it will rotate between: Tight (+JPG option), Zlib, Zlib Hextile, Hextile, CoRRE, RRE and Raw Note that only Hextile, CoRRE, RRE and RAW are supported by versions of RealVNC and in this case choosing the other options means the VNC server will use RAW encoding so it's best to set the encoding to Hextile if you wish to connect to RealVNC remotely (eg. GPRS) or to RRE if connecting locally via WiFi or Bluetooth. The third option allows you to toggle between 8 bit RGB and 16 bit RGB transfer. 8 bit is up to twice as fast but 16 bit provides much better colours. Note that for the Tight JPG options JPG is only used when using 16 bit transfer. The fourth option allows you to choose between Optimum Speed, Optimum Quality or Highest Quality. Optimum speed can be up to 4 times faster than Optimum Quality but Optimum Quality is more legible. Highest Quality is more legible still but costly in terms of speed and bandwidth. On the initial settings menu you can rotate the screen to the desired orientation, when connected "Rotate Screen" is available from the main options menu. If selecting the connection options from the hostname entry screen then simply exit the menu when the settings are as you require. NOTE THAT FROM THE FULL CONNECTION SETTINGS MENU CHANGES TO THE ABOVE SETTINGS WILL ONLY BE APPLIED AFTER YOU SELECT "APPLY CHANGES", "RECONNECT" OR "NEW CONNECTION". Apply Changes simply applies changes you have made to the settings without disconnecting from the current host. Reconnect actually disconnects then reconnects to the current host. This option is mainly in case you get a "hung" connection. New Connection disconnects from the current host and lets you select a new host to connect to. If you use UltraVNC instead of PTeSVNC then when making changes to the connection settings you must select "Reconnect" or "New connection" as "Apply changes" will not work correctly. Copy File from Server will enter file transfer to copy a file from the server to the Pocket PC. Copy File To Server will enter file transfer to copy a file from the Pocket PC to the server. Set Min Refresh Time allows you to force delayed updates from the server ie. tells PTvncWM5 to request screen updates from the server less often. Changing the seconds to values >0 will cause screen updates from the server to be requested at a maximum one update every x seconds hence reducing the GPRS bandwidth usage. Simply tap on the "+" or "-" to change the refresh value. If using local WiFi or Bluetooth this setting should be kept at zero. Exit Settings turns off the Connection Settings menu (as does pressing the Options button). Netstats When you select Netstats from the Options menu, a screen showing various statistics will appear. This information is mainly a guide for those of you who are paying per byte downloaded please note that the values will not be the exact amount of data transferred but they do give a good idea as to the bandwidth you are using. Note that the "Total" values are those from when you ran the program, no matter how many different connections you have made. The values for bytes received (RX) and bytes transmitted (TX) include the amounts used for file transfer, however the bytes received figure used internally to calculate the Bytes per pixel does not include bytes received during file transfer hence the Bytes per pixel values give an accurate indication of how good your current Connection Settings are at saving bandwidth (tight or zlib seem the best encodings by far from this point of view). It's worth noting that when a WinVNC server does not support your current encoding selection then it will switch to sending in "RAW" format - you can check for this by looking at the "Current BPP", if this value is 1 when in 8-bit mode or 2 when in 16-bit mode then the server is sending raw data and (assuming you're not using "RAW" anyway) you need to change the selected encoding for optimum performance. To remove the Netstats just tap twice, or press the Options button. Keyboard mode When Keyboard mode is enabled a graphical keyboard will appear. Please note that if you have a hardware keyboard the hardware and graphical keyboards are fully independant (eg. pressing shift on the hardware keyboard will not affect the graphical keyboard and vice-versa) and you do not have to enter Keyboard display mode in order for hardware key presses to be sent to the server. To send key presses to your PC tap the appropriate keys on the virtual keyboard. Note that joypad centre is also used as the "enter" (return) key ("Home" on some PPCs). The layouts change appropriately when Shift, Caps lock or Accents are active. Note that the graphical keyboard keys like shift, alt and control etc. stay pressed when you press them until you press them a second time. Keypad mode The keypad is available when not in keyboard mode. It provides a convenient way of sending the available keypresses to the server, ie. Escape, 0 to 9, ".", "-" and Return. Just tap the appropriate key on the keypad to send a press to the server. Zoom mode You can view your PC screen in "Full-screen" mode or with "No-Zoom" or with "Zoom". Note that Zoom zooms out for larger screen transfer sizes In both "No-Zoom" and "Zoom" modes when less than 80% of the server screen width/height is visible on the PPC a small full-screen view of the server screen will appear in the bottom-right hand corner of the PPC screen. You can tap on this window to move quickly to anywhere on your server screen and you can tap/hold/drag the small window around your PPC screen e.g. if you need to see the bottom-right of your server screen.. Magnify When enabled the area under the current stylus location is displayed in magnified form. If no buttons are pressed and the stylus is not moved the area will remain magnified for 5 seconds. File Transfer From the Connection menu you can opt to copy a file to or from the server. Transferring a file is basically the same in either direction. If you select "Copy file from server" then you will first see a screen showing the available drives on your PC. To choose a drive simply tap the appropriate line once to highlight it, again to select it and you will then view a directory of the drive: You can now browse to find the file you are looking for - also tap once to highlight an option, again to select it. Selecting a folder (in yellow) will take you to that folder's directory, selecting a file will take you to the next stage of file transfer. As you will see you can go back to parent and possibly to next page and previous page. Once you've selected a file you'll now be able to browse for a destination. Browse in the same way until you have the required target, don't worry if you wish to edit the destination filename, you can do that at the next stage. Tap twice on the "Save as" line to proceed to the filename edit stage: Use the keyboard to edit the filename, then tap enter (return). If a file of the selected name & location exists already, you will get the option to overwrite or redo the savename. Tap "Yes" to overwrite the file, "No" to change the name. When you have entered the destination filename, file transfer will begin. During file transfer you can abort by tapping on "Cancel". When transfer is complete simply tap on "Continue". Encodings/Settings To reduce the bandwidth used, ie. to reduce the amount of, and time taken for, data transfer, PTvncWM5 has several encoding options available. In the order of appearance these are: Tight(+JPG), Zlib, Zlib Hextile, Hextile, CoRRE, RRE and Raw. The best option in terms of bandwidth is Tight and the worst is Raw, however the best option in terms of server (PC) overhead is Raw and the worst is Tight so it's down to your requirements as to which option is best for you (actually we found Tight and Zlib to be almost equivalent except when in 16-bit mode the higher JPG compression options in Tight reduce bandwidth noticeably). If connecting to versions of RealVNC then "Tight"," Zlib" and "Zlib Hextile" encodings are not supported (ie. the server will use "RAW" format) so the optimum option when considering bandwidth is Hextile in this case. Also to reduce bandwidth usage you can opt for using 8-bit RGB mode, which will result in some colour banding whereas the colours should look pretty much correct in 16-bit RGB mode. For those of you requiring low bandwidth usage 8-bit is probably the best option as generally speaking it doesn't reduce the legibility of text but requires up to 50% less data transfer, however 16-bit using "Tight + JPG low quality" uses roughly the same bandwidth as "8-bit" "Tight" and may be preferable. Further PTvncWM5 also allows you to set the amount of server scaling (resizing of the screen) to be used before data transfer (with compatible VNC servers): Optimum speed will request server reduction to the SMALLEST size >= 320*240 Optimum quality will request server reduction to the LARGEST size <= 640*512 (or 512*640). Highest quality will request server reduction to the LARGEST size <=1600*1200 (or 1200*1600). This results in the following scaling and screen transfer sizes: 640*480 Opt. Speed (2)320*240 640*480 Opt. Quality (1)640*480 640*480 High Quality (1)640*480 800*600 Opt. Speed (2)400*300 800*600 Opt. Quality (2)400*300 800*600 High Quality (1)800*600 1024*768 Opt. Speed (3)341*259 1024*768 Opt. Quality (2)512*384 1024*768 High Quality (1)1024*768 1280*960 Opt. Speed (4)320*240 1280*960 Opt. Quality (2)640*480 1280*960 High Quality (1)1280*960 1280*1024 Opt. Speed (4)320*256 1280*1024 Opt. Quality (2)640*512 1280*1024 High Quality (1)1280*1024 1600*1200 Opt. Speed (5)320*240 1600*1200 Opt. Quality (3)533*400 1600*1200 High Quality (2)1600*1200 When viewing in full-screen mode the transferred screen is resampled to 640*480 (or 320*240 without VGA) on the PPC after transfer, in "no-zoom" mode the pixels are displayed at the transfer size and in Zoom mode they are displayed at transfer size*2 when using server-scaling or /2 when not using server-sacaling. Magnify magnifies the pixels *2 when available. Note that the screen buffer in PTvncWM5 is 1600*1200 pixels (ie. 1600*1200 or 1200*1600) so when the WinVNC server does not support server scaling server screens larger than this cannot be handled by PTvncWM5 (eg. 2048*1536) - if using server-scaling then the server screen size does not present this problem. Whether it be for legibility, speed of transfer, or overhead on the PC it is best to have your PC in a resolution of 640*480 pixels with the PTvncWM5 settings optimised for speed. If you require one of the larger resolutions on your PC and are having trouble reading the text on your Pocket PC one option is to change your PC settings to use large fonts, either the PC standard option of 125% or a custom font size larger than this. Note also that you will find the colour scheme used on your PC will have a direct bearing on the legibility of the PC text on your Pocket PC - some colour combinations resample far better than others. Support On some systems you may need to "enable loopback" in the advanced options of the WinVNC server (a symptom requiring this is "authentication failed" in PTvncWM5). If connecting remotely and your PC's network uses a router then you must ensure that the appropriate UDP port (5900 to 5909 or other) is being routed to the local IP address of the PC running WinVNC and that the router firewall is allowing data transfer through that port. Note that this means UDP though some firewalls seem to require that you also enable TCP transfer using the port. On the PC itself you need to ensure that any software firewall is also allowing data transfer through the appropriate port (5900 to 5909 or other). If your PC is not on a local LAN then you may need to install the Microsoft Loopback Adapter: http://support.microsoft.com/default.aspx?scid=kb;en-us;839013 http://support.microsoft.com/?kbid=236869 http://support.microsoft.com/default.aspx?scid=kb;en-us;842561 At the time of writing you can check your PC is open for connection remotely when running WinVNC (and get your remote IP address) by going here on your PC: http://www.gotomyvnc.com/ Alternatively (at the time of writing) you can get your remote IP address here: http://www.whatismyip.com/ or here: http://www.showmyip.com/ In rare cases your PC's Internet Service Provider may be blocking UDP ports, if you think everything is set up correctly on the VNC server end using a port 5900 to 5909 and "gotomyvnc" reports no connections open then contact your ISP (for the PC). Some mobile ISP's definitely block UDP ports, so if your PC is open but you can't get PTvncWM5 to connect remotely then check with your PPC phone's ISP: eg. T-Mobile (US) apparently restrict the ports available and one available is port 80 so in this case you would need a VNC server that allows selection of port 80 for connection (eg. UltraVNC). Remember if connecting locally (eg. via Bluetooth) rather than remotely then you must use the local IP address of your PC (or the PC's network name) and not the remote IP address - also note that Bluetooth or USB connection only work using Activesync. If you’ve tried everything and still cannot connect but are using a VNC server other than PTeSVNC or UltraVNC then please try using WinVNC from PTeSVNC or UltraVNC. If you cannot connect to WinVNC from PTeSVNC then you have a connection problem but if you can then there is a compatibility problem with the other VNC server. If you require technical support for PTvncWM5 go to: http://www.parystec.demon.co.uk/pt_vnc_wm5.htm for the latest info, FAQs etc. or E-mail support@parystec.demon.co.uk PTvncGPRS is available for PPC2002 devices. PTvncS and PTvncSWM5 are available for the Window's Smartphones.