Dies ist eine Modifikation von J. Angelo Racoma's OWVTerm.
Sie enthlt spezielle Escape-Sequenzen, um Grafik-Funktionen
(pixel, line, show, clrscr) auszulsen.

Author: Marcus Wolschon <Suran@gmx.net>

Thanks to J.Angelo Racoma! With my own term-proggy (in C)
I wouldn't have been able to do this this quickly.

Protocol:

from PV:
   bytes          meaning
 [FF,FE,FE] =  reset, abort all sending in progress, please send info for redraw
 [FF,X,Y]   =  point X, Y (<FF) touched
 
from HOST:
 [X<0xFA]   display CHR$(X)
 [FF,X,Y,C] c==0 clear pixel x,y
            c==1 set pixel x,y 
            c==3 invert pixel x,y
 [FE]       clear screen
 [FD]       let the graphics-operations take effect (swap buffers)
 [FC,X,Y,X2,Y2,C] draw a line from X,Y to X2,Y2 in
                   c==0 black
                   c==1 white
 [FB,X,Y,XS,YS,...] draw a bitmap starting in X,Y of size XS,YS*8 pixel
                    ... =  XS horizontal lines of YS bytes each bit
                           of which representing a pixel
                           0=clear
                           1=set                   
                    


___________________________________________________________________________________

Distributed under the GNU General Public License.  You may make modifications
to the source, or use it for your own purposes.  However, in distributing
this application, please do not make any alterations to the
copyright information, or documentation.

**Special thanks to Wolfgang Ortmann <noo@uni-jena.de> for his OWBasic
BASIC interpreter for the Pocketviewer.  Works wonders for people whose C
skills are as rusty as mine (not to mention SDK-installation problems under my Win2000).


VERSION UPDATE

1.0 12/13/2000
Streamlined code, fixed problem regarding non-response of screen tap when in
receive mode.  In 0.9, when the receive buffer is not empty while in input mode,
the user will have problems opening the keyboard later on.  This has been
remedied.



INTRODUCTION

OWBTerm for PV is a simple terminal emulation program for the Casio Pocketviewer.
It supports versions that can install add-on software (international versions:
250X, 450X, S250, S450, 750, 750plus).  This simple application runs with
Wolfgang Ortmann's OWBasic BASIC interpreter.  Potential uses are for login/dialup
to a text-based server such as SLIP access or a BBS.


WARRANTY / DISCLAIMER

The software and accompanying document(s) are distributed without warranty,
explicit or implied.  Much care has been taken that the software is released
and distributed with the aim of being safe and useful to the Pocketviewer users
community.  However, the author assumes NO RESPONSIBILITY for any errors, or
for any damages, direct or consequential, as a result of the use of the
information documented herein or the use of the accompanied software.  Usage
of the information documented herein and usage of the accompanied software is
done at your own risk.


THIS PACKAGE INCLUDES

COPYING.TXT		-	GNU General Public License Document
OWBASIC.BIN		-	Binary file of OWBasic
OWBMAN110.ZIP		-	Samples of OWBasic Programs (by Wolfgang Ortmann)
OWBTERM09.BAS		-	Text file of source
OWBTERM09.TWF		-	TWF file for PCSync
README_OWBTERM.TXT	-	This readme / documentation




SYSTEM REQUIREMENTS

Casio Pocketviewer (international versions)
OWBasic 1.10*
PC with PCSync / Quick Data Copy (for transmission).
Pv Cradle connected via serial cable to modem/PC, etc.


INSTALLATION

There are various means of installation of OWBTerm:

1. By sending the memo-entry consisting of the source code and this documentation
   to the handheld via PC-Sync:

	a. Open the TWF file
	b. Select the necessary memo entries
	c. Click "Casio | Send to Casio"
	d. Select the appropriate area, and click OK;

2. By copying the text of the source code to the clipboard, then sendingto    the handheld via Quick Data Copy:

	a. Select the desired text
	b. Right-click on the QDC icon in your Windows taskbar system tray
	c. Select "Quick Data Copy - Edit"
	d. Select the appropriate memo area then press OK;

3. By manually entering the source code to the Pv via Memo.


INSTRUCTIONS FOR USE

Install/copy OWBTerm to the desired memo area.  You should then run OWBasic from
the PV main menu.  Make sure you have set it to read source from the memo area
you installed OWBTerm in.  If not, you may either install OWBTerm to the area
OWBasic is set to by default, or you may tap "Options," then select the appropriate
area.

**Make sure other applications that may be using the PV's COM port are inactive.
Such are PCSync and the auto-sync feature of Harmony/Outlook.

Once you have setup OWBasic to read from the area containing OWBTerm, once again
execute OWBasic and select OWBTerm for PV.

You will then see the welcome screen, and keyboard.  You are now free to input
data into the connection through the keyboard.  Press the ENTER/RETURN symbol
after each entry.  Press "NEXT" if you desire to transmit a Carriage Return (ENTER).

After you press ENTER, your keyboard will disappear, and the terminal waits to
receive information from the other side (PC side terminal, modem, etc.).  You may
bring up keyboard input again at any time by tapping on any point in the working
area of the screen (within the box).

To exit, simply input "!!!" (without quotations) with the PV keyboard, and press
ENTER.  OWBTerm will now close the serial port.  You may also exit by pressing
MENU when in the keyboard-entry mode.  Doing this might leave the serial port,
however, draining battery life and degrading performance.


TIPS

While inputting, you can use your "NEXT" button to insert a Carriage return at any point in the text.  This will be transmitted once you press RETURN.

If you can't see the keyboard, the terminal is receiving or waiting for information from the other side of the connection.  Tap on any point of the working area to
bring up the keyboard for input.

Your terminal can receive input, but could not display them if your PV keyboard is
displayed.  Press ENTER at any time if you wish your keyboard to be hidden.
Incoming data will now appear.  You may also use the ESC key to hide the
keyboard,but this may cause problems (discussed later in this README).


KNOWN PROBLEMS

In some rare cases, the PV won't respond to tapping on the screen while waiting for
input.  One solution is by pressing the RESET button at the back of the unit.
You are then prompted with the digitizer-alignment crosshairs.Make sure you
select "No" when prompted for reset.  You will also be asked to adjust your system
time.

Also, when the PV automatically turns off, the Serial port is also closed
automatically.  You must turn on OWBasic then launch OWBTerm again after such.


TESTING

You may wish to test the terminal emulation using a PC-side terminal.  To do so,
simply setup your terminal to connect to the COM port used by the PV.  You can
see your input transmitted to the PC-terminal as you press ENTER.  Your keyboard
input will also simoultaneously appear on the PV screen when you are in RECEIVE
mode (PV keyboard hidden).


CONTACT INFORMATION

If you wish to contact the author, you may do so through the following means:

Email :
jangelo@racoma.cjb.net

Mobile phone / SMS (text):
+63 (919) 331-7022

Mobile email:
mobile@racoma.cjb.net
(Include full message text in subject line)


Thank you for using OWBTerm.


-------
* Installation of OWBasic and other applications requires PVM.EXE.  Please refer to
  the official Casio website, at http://www.casio.co.jp/english/download/pv.