install

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

Installation:
-------------
1) unpack the casio-2.2.tgz file on the root directory whose 
subdirectory it is supposed to reside on;
if you have the gnu version of tar it should be as simple as
tar -xvfz casio-2.2.tgz
if this doesnt work then i suggest i) gunzip casio.tgz then
ii) tar -xvf casio.tar

2) cd to the casio directory; 
i) if you are running sunos4.x just copy Makefile.simple to Makefile
and type make sun to create the executable
Same applies for Solaris 2 users i.e type make Solaris2
Linux users type make linux.

This will output two binaries; boss for the BOSS casio models
and illum for the ILLUMINATOR casio models

ii) for other than the above OSes, you can create the binary by:
	a) invoking the script makemake which will create a Makefile
	for you by making use of the imake utility in your system. You
	then type make to create the binary
or
	just look at the simple Makefile and make appropriate adjustments
	for your OS. Please send any updates to [e-mail]

3) touch ~/.casiodb
4)   copy casiorc.default to ~/.casiorc then edit it your copy.

5) you could then move the binary to a desired location in your path.
   No make install is included.

6) Try a quick setup test to see if your paramaters are set correctly
by setting the debug level to 6. This will just print your setup
and exit.

Using CasioBoss/illuminator
---------------------------

All the parameters can be set in the .casiorc; but you can override
then at the command line

The syntax is:

casio <-r|-w> [-l <commport>] [-s <baudrate>] [-p <parity] [-b <bytelength] [-o <file>] [-t]

    -r|-w:      The direction of the data transfer. -r is used for reading
                data from the CASIO to the PC. -w for the opposite direction.
		The default if none of the above is specified is to read from 
		the casio to the PC (-r).

    commport:   The PC's serial port that has to be used. Specify as COM1,
                COM2,COM3 or COM4 or simply as 1,2,3 or 4. For Solaris and 
	        specify TTYA or TTYB or simply as A or B.
		you can permanently set this parameter in the .casiorc.

    baudrate:   Either 1200, 2400, 4800 or 9600 must be specified. 
		you can permanently set this parameter in the .casiorc.
		
    parity:     none, odd, even. 
		you can permanently set this parameter in the .casiorc.

    bytelength: The number of bits transfered for one Byte,
		you can permanently set this parameter in the .casiorc.
                7 or 8 are valid values

    file:       The name of the file where the backup data are to be written
                to or read from. The default is .casiodb in your home dir.
		you can permanently set this parameter in the .casiorc.

The layout of the used file is not directly in a readable format since
all data records as needed for the CASIO are not really processed into
a convenient format. The file data are used for backup/restore purposes
only and should not be edited.

the -t option is used to output a readable ascii file of the data during
a transfer from the casio to the PC.
The config file is self documenting. Take a look at the casiorc.default.

The command line is used to override the config file.

EXAMPLES
--------

- to read from casio at 9600 bps via com1 (ttyS1) to file thismonth
and also capture a readable format of the data. 
Note: if you already have specified different parameters in the 
.casiorc then they will be overriden here.

casio -r -l 1 -s 9600 -f thismonth -t

- to write the same file back to the casio via com2 at 4800 bps:
Note: if you already have specified different parameters in the 
.casiorc then they will be overriden here.

casio -w -l 2 -s 4800 -o thismonth

- to read from the casio using the default parameters specified in
the config file (.casiorc):

casio

- to write to the casio using the default parameter specified in
the config file (.casiorc):

casio -w

Known Problems
--------------

I noticed at times that if i try to use the port which was just
used by the mouse via gpm i get transmission errors;
killing gpm doesnt help either -- the cleanest solution is to
reboot linux ;->.


Availability:
-------------

Primary-site:	sunsite.unc.edu /pub/Linux/apps/comm
		111kB casio-2.2.tar.gz
		1kB casio.lsm
Alternate-site:	ftp.cyberus.ca/pub/users/hadi/casio/casio-2.2.tgz


Feedback (Author):
------------------
1) When you run into problems: 
      i.edit your config file and set the parameter debug to 2 to
	start with. You might have to set it to 3 if not enough
	information is captured. You can also set the debug level
	using -d <debuglevel> on the command line.
     ii.run the casio program .. when done send me the debug file
	 (note this can be a huge file if the casio runs for a long
	  time)
2) For any other comments additional features you would like to see
etc please feel free to drop me a line.


--------

Jamal Hadi Salim
Ottawa, Canada
[e-mail]