
                               GET_DS7
                              Version 1.2.4
                  Program to receive data from FUJIFILM DS-7 
                     Copyright (C) 1997,1998 Mamoru Ohno

----------------------------------------------------------------------
Introduction

GET_DS7 is a program package to get the data of pictures sequentially
from FUJIFILM DS-7(DS series) and to put them into each file.
It is programmed with Perl.

The following are required to use this program:

	- perl5.004 or later and POSIX module.
	- FUJIFILM RS232C interface cable(depend on IF-DS7/W).

Though this program has developed for DS-7, it may be available for
other FUJIFILM DS series digital cameras(ex. DS-220A,DS-8,DS-10,DS-20,
DS-30,DS-300,FinePix700,Apple QuickTake200). 

"DS-7" means DS series digital cameras in this document.

----------------------------------------------------------------------
Supported Systems

The following systems are known to run this program.

 *PC-AT Linux 2.0.30
 *Sun SPARCStation-10 SunOS 4.1.3-JL
 *Sun SPARCStation-10 Solaris 2.5.1
 *SGI Indy R4600SC IRIX 6.2
 *FUJITSU FM TOWNS II MA TOWNS Linux 2.0.14
 *PC-AT FreeBSD 2.2.2R
 *PowerMac 7100/66AV MkLinux DR2.1
 *DEC Alpha station 600 OSF/1 v3.2

If you would like to get the latest information of supported systems,
see the following URL.

  http://www.yk.rim.or.jp/~mamo/Computer/DS-7/index.html

----------------------------------------------------------------------
Installation

The GET_DS7 package consists of following two files.

	ds7_lib.pm      DS-7 interface library
	get_ds7         DS-7 data transfer program

1. Copy the "ds7_lib.pm" file to the directory of perl5 library search
   path. For example:

   # cp ds7_lib.pm /usr/lib/perl5/

2. Edit the "get_ds7" file to set the environment variables for your
   system.

	$serial_line	Set the device name of serial port you use.
			If getty process is running on that port, you
			must stop the process.

	$serial_speed	Set the serial port speed (baud rate) which
			your system supports, such as 57600,38400,
			19200,9600.
			If the speed is too high, get_ds7 would
			receive missing data and output the word
			"Retry" on your display. You should set
			lower speed at that time.

3. Copy the "get_ds7" file to the directory of your command search
   path. For example:

   $ cp get_ds7 ~/bin

----------------------------------------------------------------------
Usage

1.Connect serial port of your DS-7 and computer with serial cable.
  Turn the DS-7 on and then, set the mode to "PC mode".

2.Change current directory to work directory.

3.Run get_ds7. You will get some picture files copied from DS-7 into
  the work directory.

You can give frame number(s) to get_ds7 argument.

   - single	get_ds7 15
	Frame No.15
   - range	get_ds7 10-15
	Frame No.10,11,12,13,14,15
   - plural	get_ds7 -2,4-7,15,20-
	Frame No.1,2,4,5,6,7,15,20,...

Running get_ds7 without argument, you will get all of frames in the
DS-7.

You can choose three types of filename.

   - The date and time when the picture had taken.
	ex. 19970429224550.jpg
   - Same filename as in the DS-7.
	ex. DSC00001.JPG
   - Given argument strings and frame no.
	ex.XXXX.1.jpg

The first type is default. If you would like to choose the second
type, you would have to give "-DSC" to get_ds7 argument.If you whold
like to choose the last type,you would have to give "-uXXXX" to
get_ds7 argument.

----------------------------------------------------------------------
Porting and Applying

Since GET_DS7 calls POSIX based modules of perl, it may work on any
other POSIX based system.

  - How to use 57600 baud rate.
    57600 baud rate is not included in POSIX. If you want use speed
    57600 baud rate, you have to edit the "ds7_lib.pm" file.
    Modify the following line to match your system.

	eval 'sub B57600 {0010001;}';

If you know the system to work that is not on "Supported Systems" list,
please let me know. And also when you found the program bug.

  - required data
	System name(Hardware, OS), Modification
  - E-mail address
	mamo@yk.rim.or.jp

----------------------------------------------------------------------
Changes
Version 1.2.4
	1998/8/1
	- Bugfixes
	  The program was modified to finish it when it failed in the
	  file output(ex.disk is full).
	  The previous version failed in the data acquisition of the
	  109th frame. This is the achievement of Mr. Tsuyoshi Iguchi.

Version 1.2.3
	1997/8/8
	- Added the "-uXXXX" argument to use new filetype
	  "XXXX.1.jpg".(by Mr. Yutaka Matsumoto)

Version 1.2.2 Beta
	1997/7/17
	- Bugfixes for FUJIFILM DS-10 and DS-20
	  The "image_date" command in ds7_lib.pm was failed to get
          date-time on DS-10 and DS-20.
----------------------------------------------------------------------
ATTENTION

There is no warranty fo dameges caused by using this program.

---------------------------------
 Yokohama ,Japan
 mamo@yk.rim.or.jp (Mamoru Ohno)
---------------------------------
