Welcome to NewtKEmu v1.00 (Freeware)

NewtKEmu v1.00

Copyright Christian Morency 1999.

Introduction

NewtKEmu is a Newton keyboard emulator for the PsionS5 and all Epoc32 devices. It will emulate a Newton Keyboard through the PsionS5's RS232 serial port, enabling the PsionS5 to control a Newton, a PalmPilot or a WindowsCE PPC or HPC.

All non-Newton devices will require a small utility from a third party developer that can interpret the Newton keyboard protocol (ie Freekey or Keyz for PalmPilot, NewtonKey or HKKey for WindowsCE. A null-modem cable may be required to connect the devices.

Please refer to the NewtKEmu webpage at http://www.shoresystems.net/palmtime/ for links to these utilities.

Freeware

NewtKEmu is Freeware.

Copyrights, Warranties, Distribution

Copyrights

NewtKEmu is Copyright Christian Morency 1999.

License & Warranties

NewtKEmu is copyrighted software. NewtKEmu v1.00 is available free of charge. The user is free to use this software as long as he respect the copyright and the software is not modified and/or decompiled and/or reverse translated. The author, Christian Morency, cannot be held responsible for any damage that is a result of running NewtKEmu. This product is provided as is, without any representation or warranty of any kind, either express or implied. Use at your own risk.

General Distribution

Online distribution by http://www.shoresystems.net/palmtime/

Internet software distribution sites can distribute this software if the files remain unaltered, the distribution remains unaltered (no files added / removed) and that this software remains free of charge.

Commercial distribution must contact anakinsolo@geocities.com for further information.

Individuals are welcome to exchange free copies with friends as long as all files included in the distribution are also copied.

If you want to distribute NewtKEmu in any forms (online, CDs, etc.), the first step is to email the author at anakinsolo@geocities.com.

Installation

Installation

Be sure to have checked the "Show System folder" option in System. To do so, press on the Orange Epoc Symbol at the bottom left of your screen, press ctrl-k and check the "Show System folder" checkbox.

Under the \System\Apps\ directory, create a folder named NewtKEmu. Here is the list of files you have to copy in the \System\Apps\NewtKEmu folder.

NewtKEmu.app

NewtKEmu.mbm

NewtKEmu.aif

NewtKEmu.hlp

If any file is missing, be sure to download the latest version at http://www.shoresystems.net\palmtime\

General Use

Let's emulate some keys !

Tap the Start button or select the Start menu option to begin emulating the Newton keyboard. Tap the Stop button or select the Stop menu option to end the emulation. The Output protocol window will display all the codes sent through the PsionS5 RS232 serial port.

Hardware Setup

Troubleshooting

The cable between the Newton keyboard and the Newton is, AFAIK, a null-modem cable.

If there is only one null-modem serial cable (the PsionS5's sync cable), then simply make a direct connection to the device.

If there is two null-modem serial cable (the PsionS5's sync cable and another cable such has the WindowsCE's sync cable), you will need a third null-modem serial cable, three null-modem serial cables acts like one.

Newton (untested)

• 1. Power off both PsionS5 and Newton.

• 2. Connect PsionS5's sync cable to it's serial port.

• 3. Connect PsionS5's sync cable to the Newton keyboard/serial's port.

• 4. Power on PsionS5 and Newton.

• 5. Start NewtKEmu on PsionS5 and have fun !

PalmPilot (untested), WindowsCE and other palmtops (untested)

• 1. Power off both PsionS5 and the other palmtop.

• 2. Connect PsionS5's sync cable to it's serial port.

• 3.0 Connect PsionS5's sync cable to the other palmtop cradle's serial port.

OR

• 3.0 Connect PsionS5's sync cable to a null modem cable.

• 3.1. Connect the null modem cable to the other palmtop's sync cable.

• 3.2. Connect the other palmtop's sync cable to it's serial port or it's cradle serial port.

• 4. Put the other palmtop in it's cradle (if necessary).

• 5. Power on PsionS5 and the other palmtop.

• 6. Start Newton keyboard protocol interpreter on the other palmtop (ie Newtonkey, HKKey, Freekey, KeyZ, etc).

• 7. Start NewtKEmu on PsionS5 and have fun !

Example of a PsionS5 - WindowsCE HP620LX connection :

S5 <-> S5 sync cbl <-> null-modem cbl <-> HP sync cable <-> HP

Key settings

Specific PsionS5 keyboard settings

• CTRL is the Newton Keyboard's Control button.

• FN is the Newton Keyboard's Command button.

• FN-CTRL is the Newton Keyboard's Option button.

• FN-Y will make a ‘

• FN-U will make a |

• FN-I will make a +

• FN-O will make a -

• FN-P will make a =

• FN-1 will make a _

• FN-2 will make a ~

• FN-3 will make a \

• FN-4 will make a /

• FN-5 will make a <

• FN-6 will make a >

• FN-7 will make a [

• FN-8 will make a ]

• FN-9 will make a {

• FN-0 will make a }

• FN-{ Z,X,C,V,B,Q } are unavailable due to the way the EPOC system handle these events.

• Unfortunately, no accented characters are available at this time.

That's all for now !

Christian Morency, May 1999

anakinsolo@geocities.com

http://www.shoresystems.net/palmtime/