eXternal Keyboard 48 v1.0
by Yale Kozinski
yalek@geocities.com

What is it?

XK48 allows you to use your HP48 as a keyboard under Win95.  You can use it as a 
straight up keyboard, ideal for Emu48, or reconfigure it so each of the keys sends
a text string; if perhaps you wanted to have extra buttons on your keyboard you just
need an HP48, a cable, this program, and some super glue... but I digress.

Ok, so how do I use it?

Well, it's a little tricky.  By clicking on "Communications", you get a dialog asking
for your COM port and BPS.  By clicking on "Keys", you can reconfigure the keyboard 
and turn Emu48 mode on and off (more on that later).  Now the tricky part.  If you
click on "Start", as soon as it receives a keypress the light will turn green.  That
lets you know it's working.  If you hit "Stop" while it's running, nothing obvious
will happen, you must send one more keypress for it to actually stop.  This is a bug,
not a feature, I admit it.  What this means is you had better make sure there is an
HP48 connected and working when you hit "Start", otherwise you'll need the old
three finger salute to stop it.

What are the codes I can use?

I wrote this program in Borland C++ Builder using the external component TSendKey.
Available at HTTP://www.fredsterware.com.
The following is from the TSendKeys documentation:

---
Token Keys
	ControlKey = '^'; 	F1 = '{F1}' 	INSERT = '{INSERT}' 	
	AltKey = '@'; 	F2 = '{F2}' 	DELETE = '{DELETE}' 	
	AltGR = '^@'; 	F3 = '{F3}' 	HOME = '{HOME}' 	
	ShiftKey = '~';	F4 = '{F4}' 	END = '{END}' 	
	F5 = '{F5}' 	PGUP = '{PGUP}' 	
	F6 = '{F6}' 	PGDN = '{PGDN}' 	
	F7 = '{F7}' 	ENTER = '{ENTER}' 	
	F8 = '{F8}' 	BKSP = '{BKSP}' 	
	F9 = '{F9}' 	PRTSC = '{PRTSC}' 	
	F10 = '{F10}' 	SHIFT = '{SHIFT}' 	
	F11 = '{F11}' 	ESCAPE = '{ESCAPE}' 	
	F12 = '{F12}'	TAB = '{TAB}' 	
			
			UPARROW = '{UP}' 	
			DWNARROW = '{DOWN}' 	
			LEFTARROW = '{LEFT}' 	
			RIGHTARROW = '{RIGHT}'
---

You can use any combination of standard keystrokes and the above codes, I.E.
to send Shift-F9 you would use ~{F9} .


What is Emu48 mode?

It sends all keystrokes twice except ALPHA, which gets sent four times.  This works
better with Emu48 for some reason.  It works best with Emu48 1.06, but even then
it is still somewhat picky about accepting all of the keys all of the time.  Also, if
you use XK48 in conjunction with Emu48, you need to put the following into the 
keyboard.kmi file:


Scancode 46
	Map 46 54
End

Scancode 187
	Map 187 95
End

Scancode 189
	Map 189 85
End


What do I need to put on my HP48?

At the moment, there is no SYS-RPL solution, which means that you can't use the on
key, but the following USER-RPL works fine:

\<< WHILE 1 
REPEAT KEY
IF 1 ==
THEN CHR 1 CHR
+ XMIT DROP
END
END
/>>

This is the contents of the KEYOUT file, which you should transfer to your HP48.

Where can I send bug reports, comments, questions, flames, etc?

yalek@geocities.com will do.



 
