TapSmart KeyLink - The Keyboard Alternative Readme.txt file Version 2.1.7 August 2007 CONTENTS -------- I. Introduction II. TapSmart KeyLink 1.X Upgrade Instructions III. TapSmart KeyLink QuickStart IV. Using KeyLink and Product Features V. Palm and PC Requirements VI. Known Problems and Change History VII. License, Support, and Contact Information Appendix A: Packaging Contents I. INTRODUCTION ---------------- Thank you for your interest in TapSmart(TM) KeyLink(TM) - The Keyboard Alternative. KeyLink is the premier solution for linking your PC keyboard to your Palm handheld for fast and easy typing of data directly into any Palm application. KeyLink lets you use the PC keyboard that you are already familiar with in a new way. And since you already own this keyboard, KeyLink can save you the expense of having to buy an external keyboard. Trial Period ------------ KeyLink is fully functional on a trial basis for 14 days from when you installed it. Give it a spin, We're sure you'll like what you see. After the trial period expires, you must purchase a registration code to continue to use KeyLink. Where to purchase ----------------- If you wish to purchase a registration code, please visit www.mobilityware.com. II. TAPSMART KEYLINK 1.x UPGRADE INSTRUCTIONS ---------------------------------------------- KeyLink 2.x uses a different registration mechanism than KeyLink 1.x. If you are a registered KeyLink 1.x user you can email support@mobilityware.com to request a KeyLink 2.x registration code. If you have created a shortcut for KeyLink on your desktop you should delete it and create a new one after installing KeyLink 2.x. III. TAPSMART KEYLINK QUICK START ---------------------------------- This Quick Start procedure assumes a simple hardware configuration of a handheld device connected to a personal computer via a USB cable. By using other communications technology on your handheld device such as Bluetooth or Wi-Fi, more sophisticated scenarios are possible. 1. Run Setup.exe and follow the on screen directions. 2. To install the KeyLink handheld component, perform a HotSync operation on the handheld device that you selected during the install process. 3. Locate the TapSmart KeyLink program on your PC by going to the Start menu and selecting Programs and then selecting TapSmart KeyLink. Run the TapSmart KeyLink program from this menu. 4. In several seconds a KeyLink window should appear on your screen. 5. Make sure that your handheld is in the cradle or has a HotSync cable attached. 6. Run the KeyLink program on your handheld and tap the Activate button. 7. If KeyLink is installed correctly and your handheld has a good USB connection to the PC you should see a trial screen that you can click OK on. If you are using a registered copy of KeyLink you will not see the trial screen. 8. The title bar of the KeyLink window should now show (Connected). Every keystroke you make while the KeyLink window has the focus will be acted upon and the appropriate command will be sent to the Palm handheld. 9. Specific keys on the keyboard can be programmed to do a variety of different functions on the handheld. To program keys select the Key Configuration... menu item from the File menu in the PC program. IV. USING KEYLINK AND PRODUCT FEATURES --------------------------------------- Default Keyboard Programming ---------------------------- KeyLink comes with a default configuration for the keyboard that can be changed. The default keyboard configuration is: F3 = Activate the global find function F5 = Press first hard key on the device F6 = Press second hard key on the device F7 = Press third hard key on the device F8 = Press fourth hard key on the device F10 = Bring up the current applications menu F11 = Activate the calculator. F12 = Activate the devices on screen keyboard Home = Put the text insertion point at the beginning of the text field End = Put the text insertion point at the end of the text field Up Arrow = up arrow (may not work in all applications) Down Arrow = down arrow (may not work in all applications) Left Arrow = left arrow (may not work in all applications) Right Arrow = right arrow (may not work in all applications) Page Up = Press page up button Page Down = Press page down button Ctrl C = Copy text from the handheld clipboard to the PC clipboard Ctrl Tab = Next text field Ctrl Enter = Press center (select) navigation button Ctrl Up Arrow = Press up navigation button Ctrl Down Arrow = Press down navigation button Ctrl Left Arrow = Press left navigation button Ctrl Right Arrow = Press right navigation button Ctrl V = Paste text from PC clipboard as a series of keys to the device Ctrl Home = Activate the application launcher Alt Z = Press the OK button if it is on the screen Alt X = Press the Done button if it is on the screen Alt C = Press the Cancel button if it is on the screen Alt V = Press the Details button if it is on the screen Alt B = Press the Edit button if it is on the screen Alt N = Press the New button if it is on the screen Alt M = Press the Delete button if it is on the screen Alt Comma = Press the Note button if it is on the screen Alt Period = Press the Send button if it is on the screen Alt Left Arrow = Skip one word to the left in some word processors Alt Right Arrow = Skip one word to the right in some word processors Alt = Bring up the current applications menu Shift Tab = Previous field command (may not work in all applications) Shift Left Arrow = Select the character to the left of the insertion point Shift Right Arrow= Select the character to the right of the insertion point Shift Down Arrow = Selects line of text below the cursor in some word processors Shift Up Arrow = Selects line of text above the cursor in some word processors Custom Keyboard Programming --------------------------- When using KeyLink, specific keys and key combinations on the PC keyboard can be configured to perform a variety of different actions on the handheld. To configure keys select the Key Configuration... menu item from the File menu in the KeyLink PC component and the KeyLink Configuration screen will be displayed. The main KeyLink Configuration screen will display the existing key configuration - key stroke on the left and their "configured" action on the handheld device on the right. To add a key configuration, click the Add button. To edit or remove a key configuration, select the key configuration to be acted upon and press the appropriate button - Edit or Remove. To return to the default key configuration present when the KeyLink product was installed, click the Defaults button. When adding or editing a key configuration, you have the choice of configuring many different keys and key combinations as well as many actions to assign within the key configuration. Configurable key actions are divided into several categories: Device, Navigation, Launch Application, Text, Tap Button, Special and Raw Key Event categories. When choosing to add or edit a key configuration, the Key Map screen will be displayed. The Key Map screen displays the selection of Keys and Modifiers on the Key Stroke side of the display, and configurable functions for the handheld device on the Action side of the display. To add or edit a key configuration, select the key and it's modifiers on the Key Stroke display on the left and the desired configurable function from the Action display on the right. Then click the OK button. New key configurations and key configuration changes take effect immediately. Configuring KeyLink To Use Bluetooth, Wi-Fi, Etc. ------------------------------------------------- KeyLink can be configured to use your handheld's networking capabilities instead of USB. To configure KeyLink to use the currently configured handheld network go to the KeyLink Preferences screen on your handheld and select Network as the Connection Type. You will next need to configure the IP address or host name of the PC that you want to connect to. The default TCP/IP port number is 6767, you will need to make sure that any firewall that you are using will allow this port number through. On the PC you will need to go to the KeyLink program's File menu and select Options... on the Options screen make sure that Network Connections is selected for the Allowed Connections. Click the OK button on the Options screen. You will need to shutdown the KeyLink PC program and run it again for the change to take effect. You can now Activate the KeyLink program on the handheld and it should connect to the KeyLink PC program using the current handheld network configuration. You can also configure KeyLink to use a Bluetooth serial port connection to your PC, this is the same way that HotSync usually uses to communicate with your PC when using Bluetooth to HotSync. To configure KeyLink to use a Bluetooth serial port go to the KeyLink Preferences screen on your handheld and select Bluetooth as the Connection Type. On the PC you will need to go to the KeyLink program's File menu and select Options... on the Options screen make sure that Bluetooth Serial Connections is selected. You will need to select the COM Port that is configured on your PC for use with Bluetooth, if you HotSync over Bluetooth then select the same COM port that you have configured for HotSync. Click the OK button on the Options screen. You will need to shutdown the KeyLink PC program and run it again for the change to take effect. You can now Activate the KeyLink program on the handheld and it should connect to the KeyLink PC program using Bluetooth, you will see a screen with a list of Bluetooth devices, you should select your PC from this list. Spell Checking Feature ---------------------- The spell checking feature provided by KeyLink will only work against text data contained in standard Palm OS text fields, the Memo Pad application uses standard text fields. Most 3rd party word processors do not use standard text fields and the KeyLink spell checker will not work with them. KeyLink comes with an English dictionary, other dictionaries can be used with KeyLink. KeyLink will use all files found in the dict subdirectory that have a .dict file extension. KeyLink dictionary files are simple text files that contain lists of words, with one word per line. Quick Send Option ----------------- Quick Send is an option present in KeyLink running on Palm OS 5 devices. Quick Send effects the way that KeyLink performs it's USB communications with the PC. With Quick Send checked you may see better performance on some PCs. However the downside is that Quick Send is incompatible with some Palm/PC combinations. The only way to know if it is of any benefit in your situation is to try it out. Note: KeyLink only checks the setting of Quick Send at Activation time, changing the setting should only be done while KeyLink is deactivated. V. PALM AND PC REQUIREMENTS ---------------------------- Handheld Platform Requirements ------------------------------ The Handheld component of KeyLink is designed to work on any Palm OS 4.0 or 5.0 device. KeyLink is known to work on the following handhelds: Palm m505 Palm m515 Palm Treo 600 Palm Treo 650 Palm Treo 680 Palm Treo 700P Palm Tungsten C Palm Tungsten E Palm Tungsten T Palm Tungsten T2 Palm Tungsten T3 Palm Tungsten T5 Palm TX Palm LifeDrive Palm Zire Palm Zire 21 Palm Zire 31 Palm Zire 71 Palm Zire 72 Palm Z22 Garmin iQue 3600 Sony SJ22 Sony TJ25 Sony TJ37 Sony TH55 Janam XP20 KeyLink is not compatible with the Treo 90 NOTE: While the handheld component of KeyLink is compatible for use on many Palm devices, it is only supported for use in a configuration that is supported by the device manufacturer. Consequently, some of the devices listed above may be supported for use with some Windows operating systems, but not others. To establish connectivity between the KeyLink Handheld component and the KeyLink keyboard input component, some type of physical network access to a TCP/IP network (e.g., Bluetooth, Wi-Fi, wireless data service, etc.) or Bluetooth serial port must be available or a USB cradle/cable is required. PC Platforms Requirements ------------------------- The keyboard input component of KeyLink requires a personal computing device running a Java virtual machine version 1.4 or later. In order to use USB connectivity Windows 98/ME/2000/XP/Vista is required. The Palm Desktop software must also be installed if USB connectivity is used. Support for Windows Vista --------------------------------------- TapSmart KeyLink has been qualified and is supported for use on the Microsoft Windows Vista operating system in conjunction with the recently released Palm Desktop 6.2 Beta for Windows. The 6.2 Beta version (or later) of Palm Desktop for Windows MUST be installed for KeyLink to function properly on Windows Vista. VI. KNOWN PROBLEMS AND CHANGE HISTORY -------------------------------------- Known Problems -------------- The Delete key may not work if you are using a version of Java older than 1.4.2. To correct this problem you should upgrade your Java by downloading the latest version from www.java.com. The Java version that KeyLink is using is displayed in the KeyLink About box. Sony Clies implement USB slightly different than PalmOne devices, this requires KeyLink to know that it is communicating with a Sony device. KeyLink attempts to auto detect Sony devices, sometimes this auto detection fails. If you are using a Sony Clie and have problems with KeyLink using USB then you should try the following: 1. Click the File menu on the KeyLink PC program and select Options... 2. Click on Advanced Options... 3. Check the Force Sony Clie Detection checkbox 4. Click OK on each of the options screens 5. Exit and then restart the KeyLink PC program. Tapping the status bar on Sony Clie 480x320 or 320x480 devices is not supported. Tapwave Zodiac Limitations: Left handed operation is not supported. Closing the input area in programs that do not support it is not handled correctly. The input area and status bar are not displayed on the PC in portrait mode. Product Changes --------------- 2.1.7 Added support for Windows Vista. Added support for Janam XP20. Device Applications drop down box now keeps track of the last 5 applications that were launched from the drop down box. 2.1.5 Fixed some problems with left handed landscape mode. Improved 5-way navigation for KeyLink application forms on some devices. 2.1.4 Fixed a problem when tapping exactly on the boundry of a scroll bar. Added compatability with Palm Z22. 2.1.3 Improved USB disconnect handling. 2.1.2 Fixed a problem installing to more than one user on the same PC. 2.1.1 Corrected a problem with the Install not recognizing all declared Palm users. 2.1.0 LifeDrive support. Improved Java detection at install time. 2.0.9 Added support for Tapwave Zodiac. 2.0.8 Added a low memory warning message Added No Alarms option to correct some program compatibility problems. Corrected screen taps on T5 and LifeDrive when using left handed landscape mode. Corrected screen taps on the Garmin 3200 and Samsung i539 2.0.7 Allow Euro symbol to be entered from keyboard Add Quick Send option for USB on Palm OS 5 devices Correct USB problems on some devices Fix screen taps on T3 in landscape mode with slider closed Fixed a problem setting Options in some rare cases 2.0.5 Correct problems with Treo 650 navigation functions. Improved USB error handling. 2.0.4 Improved support for Windows 98. 2.0.3 Improved USB error recovery. 2.0.2 Fixed "queue full err!" when changing application categories. 2.0.1 Fixed compatibility with new T5 desktop software. Fixed a problem with screen taps on a Garmin iQue 3600. Fixed some problems with closing USB connections. Application names are now sorted case insensitive in the toolbar drop down box. Fixed a problem with screen images getting corrupted. 2.0.0 Added the capability to view the handhelds screen on the PC when using Palm OS 5. Added a toolbar which allows access to common functions. Added a spell checker that works with standard Palm text fields. Added the ability to select different look and feels for the PC program. Added the ability to configure keys to send any raw key down event. Added the ability to configure keys to cause the handheld dynamic input area to expand/collapse Added the ability to configure keys to rotate the handheld screen on capable devices. Added the ability to configure keys to insert the current date or time. 1.1.0 Added advanced options mostly for trouble shooting purposes. Fixed a performance problem causing slow input with some programs. Fixed a problem where button text changes were not being detected. 1.0.6 Fixed USB connection problem with Samsung i500 Smartphone. 1.0.5 Improved removal from cradle when connected. Fixed a USB connection problem with some Sony Clie models. 1.0.4 Added support for Bluetooth serial port connectivity. 1.0.3 The Paste menu command was always enabled even when there was nothing to paste. Improved device power off handling while connected. Improved device removal from cradle handling while connected. Added text selection capability for text fields. Added the capability to copy from the Palm clipboard to the Windows clipboard. Eliminated the need for a local TCP/IP connection when using USB. 1.0.2 Improvements to Key Configuration user interface. Fixed sorting problems when clicking on key list headings. Fixed problems launching applications with accented characters in their names. Fixed scrolling problem when an application was displaying lots of buttons. Added confirmation dialog when resetting key configuration to the defaults. Added ability to remove multiple key definitions at one time. Fixed a problem where Alt key combinations would stop working. Fixed a problem where the key configuration would become corrupted. 1.0.1 Corrected a problem where keys could not be programmed to launch certain applications. Added support for Hard Key 5 (voice memo button on some Tungsten devices.) Corrected a problem where the KeyLink PC program's File menu would sometimes disappear. User confirmation is now required to delete a key's configuration. When adding a key its current configuration is shown if it has one. VII. LICENSE, SUPPORT AND CONTACT INFORMATION ----------------------------------------------- License ------- KeyLink is not freeware or shareware. The KeyLink product has two main components, the PC keyboard entry component that runs on the PC and the Handheld component that runs on your Palm device. The Handheld component is licensed and restricted to a single Palm device by its HotSync ID. The PC keyboard entry component can be installed and run on any supported platform. To use the KeyLink product on multiple handheld devices you need to obtain multiple licenses. See the Mwla.txt file for complete license terms and conditions. Product Support --------------- Please send e-mail inquiries for assistance to support@mobilityware.com. Visit www.mobilityware.com to find additional product information, such as product FAQs, documentation, etc., and to sign up for future product e-mails. Contact Information ------------------- MobilityWare 70 Discovery Irvine, CA 92618 www.mobilityware.com support@mobilityware.com Trademark Attribution --------------------- Palm OS, HotSync, Palm Powered logo are registered trademarks and Palm Powered is a trademark of Palm Trademark Holding Company, LLC. TapSmart is a trademark of MobilityWare. Other brands may be trademarks of their respective owners. APPENDIX A: PACKAGING CONTENTS ------------------------------- TapSmart(TM) KeyLink(TM) contains the following files: Install.exe The installation program. KeyLink.jar The jar file that contains the Java class files for the keyboard input component. butil.jar The jar file that contains Java utility class files. jazzy-core.jar The jar file that contains Java spell checking class files. jazzy-swing.jar The jar file that contains Java spell checking class files. comm.jar The jar file that contains Java serial communication class files for Bluetooth. javax.comm.properties Properties file used by comm.jar. win32com.dll DLL file used by comm.jar. KeyLinkUSB.dll The dynamic link library that provides USB communication to/from the handheld device. KeyLink.prc The Palm device component. KeyLinkLib.prc The Palm device component shared library. KeyLink.ico KeyLink icon file. KeyLink.gif KeyLink icon file in gif format. syskey.map Default key programming. vkey.map Key programming definitions. MobilityWare.gif MobilityWare logo used by KeyLink. Install.lst Control file used by Install.exe. Uninstall.exe The TapSmart KeyLink uninstall program. pinfo Reseller identification. Readme.txt This readme file. Mwla.txt The license terms and conditions. dict\english.dict The English dictionary file for spell checking. images\blank.gif Toolbar image. images\config.gif Toolbar image. images\copy.gif Toolbar image. images\home.gif Toolbar image. images\paste.gif Toolbar image. images\refresh.gif Toolbar image. images\spell-check.gif Toolbar image. images\closed_button.gif images\closed_button_pressed.gif