readme.2.2

与Casio BOSS进行串口通讯的程序

What is Casio Diary?
------------------
It is a package originally ported from DOS to allow communication to
the CASIO series of hand-held organizers based on a protocol posted
by Knut Radloff <[e-mail]>. 

There has been substantial change from the DOS origins.

Version 2.2 has been tested on Linux2.x , Solaris2.x, sunos4.x. 
For both the BOSS and ILLUMINATOR models

The term 'computer' henceforth will refer to any machine
that supports these operating systems.
It is provided as is i.e. i am not to be responsible for any
damages it causes to you, your CASIO or your environment.

features:
----------
	- Backup from CASIO to your computer
	- Restore a Backup file from your computer
	  to the CASIO.
	- currently recognizes only: Phone, Calendar,schedule
	  memo, reminder,Free File, Expense, Reminder 2, todo list,
	  and Bussines Card. If you need any other format
	  and i get access to a model that has this format
	  then i could add it. All formats not listed above will
	  still be backed up and restored fine except they wont be 
          recognized for printing on the screen.
	- Outputs 3 different files when sending data from
	  the CASIO to the computer during backup:

		i) the binary file whose name must be
		chosen by the user. This is the file
		used when restoring

		ii) data.<yyddmm> --- an ASCII file.
		A user can view this file. At the moment
		this is all that can be done. This is file
                is created if the user passes the -t option
		option on the command line.

		iii) debug.<yyddmm> contains debug information.
		by default the debug level is turned off i.e set to
		0 -- so this file will only contain one line which
		identifies the file id of the debug file.
		different levels of debugging info can be set on
		.casiorc file.

	- User can stop the transmission:
	-	from the CASIO side -- by pressing the 'next' button
		(or whatever the prompt says on the CASIO)
	-	from the computer side by hitting the ESC key or just killing
		the process via a control-c
	
	- Supports 1200, 2400,4800 and 9600 for 8N, 7E, 7O, 7N, 8E and 8O

	- Online help is available; just type casio with any bogus
	options; or casio -h or casio -? or just casio to get the
	verbose help output; future plan is to have different option 
	levels for help (i.e verbose and quick)
	- Status display of transmission both ways.

Requirements:
-------------
1)You definitely need the cable to connect the casio; two different
  schematics are included here courtesy of Victor; if you cannot
  build the cable -- a friend of mine, Denis Rouleau at:
  [e-mail] will build a PC-cable for you. The file
  CABLES in the package has more details.
  This is not an endorsement, but it could save you some time + bucks. 
  He helped me build my first cable and it cost me about $15 US to get 
  the parts together; 
  NOTE:  He's given me consent to add the information here; 
  if you cant get hold of him the get hold of me i will try to track him 
  for you.

2)This program was compiled and tested on 
	i)  Linux 2.0.33 using gcc version 2.7.2 and a 16550 UART;
	ii) sunos 4.01, and solaris2.5 

  Because of its simplicity it should be able to compile on
  lower or higher versions of the above mentioned tools.
  It should also be able to compile on any *nix; if you manage
  to get it running on any other Unix please send me the changes
  so that i can include them on the imakefile config files etc. and add 
  you to the CREDITS.
NOTE: i have tested the program on models sf4600 and sf8000 for
4800,2400 and 1200,9600(sf 8000) only. look at the file models.tested
for more info on different models known to work.
If you own a different model and this works let me know so that 
i can add it to the list.

CAUTION: Do not interface the CASIO directly to the PC's serial port, since
         this may cause permanent damage to the CASIO. Always use the
         circuit as described in circuit*.gif. It contains level converters
         for converting the +12/-12 Volts levels on the PC side to the
         +5/0 Volts levels that the CASIO uses.


--------
Jamal Hadi Salim
Ottawa, Canada
[e-mail]