January 4, 1996

		*** CASIO BOSS UTILITIES AND LIBRARY ***

WHAT IS BOSS?
This package consists of a command line utility for
downloading and uploading information to the Casio B.O.S.S. pocket
organizer. This program will store the data on your unix system
in an easy to modify ASCII format. These ASCII files can also be
transmitted to the B.O.S.S.

The functions needed to communicate with the B.O.S.S. have
been organized in an easy to use C library (libboss.a) for
use in your own programs.

COMPILING:
Just typing 'make' will build:
	boss		- utility to communicate with the B.O.S.S.
	bossfmt		- utility to format ASCII files
	libboss.a	- C library of Boss communications functions.

PORTABILITY:
This collection of C code assumes a BSD unix system.
The following features are needed to compile:
	1) termios tty interface.
	2) fcntl() F_SETFL/F_GETFL, Posix non-blocking flag: O_NONBLOCK

Aside from these non-standard features, the rest of the
code should be reasonably portable.

This BOSS package has been compiled/tested on the following
machines:
	1) SUNOS 4.x (sun4 architectures)

CASIO BOSS MODELS:
	I have tested this software only with the Casio ``SF-5500B'' model.

RUNNING:
Assuming 'make' worked successfully, the following commands
can be used to communicate with the B.O.S.S.:

	% boss -r -l /dev/ttyb my_backup
	(read from boss, and store all data received in my_backup)

	% boss -w -l /dev/ttyb new_phone_list
	(write the contents of new_phone_list to the boss)

DOCUMENTATION:
This subdirectory ``man'' contains the manual pages for the
command utilities and the boss library routines.

	man/boss.1		- Boss Comminications utility.
	man/bossfmt.1		- Formatting utility manual.
	man/boss_format.5	- Specification of ASCII file format.

	man/boss_intro.3	- Introduction to routines in libboss.a
	man/BossParse.3		- C library function manual.
	man/BossGenerate.3		""
	man/BossTransmit.3		""
	man/BossReceive.3		""
	man/BossError.3			""
	man/BossDecodeStr.3		""
	man/BossEncodeStr.3		""
	man/BossStop.3			""
	man/BossSetIOCB.3		""
	man/BossFree.3			""
	man/boss_data.3		- Specification of the internal C data structure.

SOURCE CODE:
	boss_lex.c		- Lexical analyser and associated rotuines.
	boss_parse.y		- parser code and associated routines.
	boss_gen.c		- BossGenerate() and associated routines.
	boss_io.c		- Communications library routines.
	bosslib.c		- Misc. functions for libboss.a
	bossP.h			- Private header file for libboss.a
	boss.h			- Public header file for libboss.a

	main.c			- The main program for the 'boss' utility.
	fmt.c			- The main program for the 'bossfmt' utility.

TECHNICAL DOCUMENTAION:
I have included the following files on how to build or obtain a cable
for your B.O.S.S.:

	techdoc/circuit.txt	- text file for the cable diagram.
	techdoc/circuit.gif	- images of the circuit to build.
	techdoc/circuit2.gif		""
	techdoc/Vendors		- list of vendors who will make/sell the cable.
	techdoc/Sparc		- how to make the PC-LINK cable work on a Sparc.
	techdoc/Protocol	- A description of the Casio protocol.

OTHER FILES:
	Sample.boss		- A sample text file showing the ASCII
				  format supported by the parser.

AUTHOR:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~ Ken Stauffer            ~~~~~~~~~~~~~~~~~~~ Phone: (904) 348-2362 ~~
~~ AT&T                    ~~~~~~~~~~~~~~~~~~~   Fax: (904) 391-6012 ~~
~~ 3451 Beach Blvd.        ~~~~~~~~~~~~~~~~~~~                       ~~
~~ Jacksonville, FL. 32207 ~~~~~~~~~~~~~~~~~~~ kstauffer@attmail.com ~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

