
                               GET_DS7
                              Version 1.2.4
                   FUJIFILM DS-7 Data receive program
                     Copyright (C) 1997,1998 Mamoru Ohno

GET_DS7 は、富士フイルム デジタルカメラ DS-7(DSシリーズ) の画像データ
を受信するプログラムです。GET_DS7 は Perl で記述されています。

概要
	GET_DS7 は DS-7 の画像データを RS232C ケーブル経由で受信するプ
	ログラムです。富士フイルムインターフェースセット(IF-DS7/W)に付
	属のケーブルを使用します。また、perl5.004(それ以降)と perl の 
	POSIX モジュールを使用します。
	
	DS-7 に格納されている画像データを連続して転送し、ファイルに出
	力します。

	GET_DS7 は、DS-7 以外の富士フイルム DSシリーズ(DS-220A,DS-8,
	DS-10,DS-20,DS-30,DS-300,FinePix700,Apple QuickTake200)でも基
	本的に動作すると思います。この文書内で DS-7 と記述している部分
	は DSシリーズをさしています。

動作環境
	現在までに以下の環境での動作が確認されています。

	・PC-AT互換機 Linux 2.0.30
	・Sun SPARCStation-10 SunOS 4.1.3-JL
	・Sun SPARCStation-5 SunOS 4.1.3-JL
	・Sun SPARCStation-10 Solaris 2.5.1
	・SGI Indy R4600SC 133MHz 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

	他の OS で動作が報告された場合は、GET_DS7 のホームページで公開
	しています。次の URL を参照して下さい。

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

インストール
	GET_DS7 は、以下の2つのファイルから構成されています。

	ds7_lib.pm      DS-7 インタフェースライブラリ
	get_ds7         DS-7 画像データ受信プログラム

	1. ds7_lib.pm を perl が参照するライブラリのパスにコピーします。
	   例えば、/usr/lib/perl5/ ディレクトリへコピーします。

	2. get_ds7 ファイルの以下の変数値を環境に合わせて編集します。

	   $serial_line		使用するシリアルポートのデバイスファイ
				ル名を設定。
				そのポートに getty が起動されている場
				合は、getty を停止して下さい。

	   $serial_speed        OSがサポートしている通信速度を設定。
				57600,38400,19200,9600 の中からひとつ
				を選択。受信に失敗する(受信中"Retry"と
				表示される)場合は、速度を落して下さい。

	3. get_ds7 を path の通ったディレクトリにコピーします。

	注意:perl ライブラリパスにはカレントディレクトリが含まれていま
	     す。ds7_lib.pm ファイルが存在するディレクトリで get_ds7 
	     を実行すると、カレントディレクトリの ds7_lib.pm を読み込
	     むことがあります。バージョンの違う ds7_lib.pm を読み込ん
	     だ場合正常に動作しません。

利用方法
	1.DS-7とコンピュータを 通信用接続ケーブルで接続し、DS-7の電源
	  をONにして、「PCモード」にします。

	2.画像データを格納したいディレクトリに移動します。

	3.get_ds7 を実行します。
	  DS-7 に入っている画像データを連続して受信し、ファイルに出力
	  します。

	  受信する画像データのコマ番号を引数として指定できます。

	    ・単数指定      get_ds7 15
	          コマ番号 15 を指定
	    ・範囲指定      get_ds7 10-15
	          コマ番号 10〜15 を指定
	                    get_ds7 15-
	          コマ番号 15 以降のコマを指定
	    ・複数指定      get_ds7 -2,4-7,15,20-
	          コマ番号 1,2,4,5,6,7,15,20,… を指定

	  get_ds7 を引数なしで起動した場合、DS-7 に入っている画像デー
	  タを全て受信します。

	出力ファイル名は、以下の3つの形式のどれかを選択できます。

	  ・撮影された日時を表すファイル名 19970429224550.jpg 形式
	  ・DS-7 に格納されているファイル名 DSC00001.JPG 形式
	  ・任意の文字列とコマ番号のファイル名 XXXX.1.jpg 形式

	  - デフォルトは 19970429224550.jpg 形式です。
	    なお、DS-10 の場合は撮影された日時の代わりに、受信した日時
	    を表すファイル名を使用します。

	  - DSC00001.JPG 形式で出力する場合は、get_ds7 の引数に "-DSC"
	    を付けて下さい。

	  - XXXX.1.jpg 形式で出力する場合は、get_ds7 の引数に "-uXXXX"
	    を付けて下さい。XXXX には任意の文字列を指定して下さい。

	注意:get_ds7 は出力ファイルと同名のファイルがある場合、上書き
	     します。

応用
	GET_DS7 は、Perl の POSIX モジュールを使用していますので、
	POSIX モジュールが使用できる OS でしたら、そのまま利用できると
	思います。

	・通信速度 57600 ボーの使用方法
	  57600 ボーは POSIX に含まれていません。57600 ボーを使用する
	  場合は、ds7_lib.pm ファイル中の次の行を、OS に合わせて編集し
	  て下さい。

	  eval 'sub B57600 {0010001;}';

	・シリアル読み込みのタイミングを微調整
	  通信中に停止してしまう場合、データ読み込みの前にわずかな待ち
	  時間を設ける事で、正常に動作する事があります。
	  ds7_lib.pm ファイルの以下の行のコメント(#)を外し、値を設定し
	  て下さい。設定する値の単位は秒です。

	  #$Wait = 0.2 ;

	  この値を増減して、動作する値を探して下さい。

	・報告のお願い
	  動作が報告されていない環境で GET_DS7 が動作した場合や、バグ
	  を発見した場合は、「機種名」「OS名」「変更した設定値」につい
	  て大野宛(mamo@yk.rim.or.jp)にメールして頂ければ幸いです。

注意
	このプログラムを使用して、画像データ、DS-7、コンピュータにいか
	なる不具合が生じた場合にも、責任を負いません。

ヒストリ
	Version 1.2.4
	  1998/8/1
	  ファイル書き込みに失敗した(disk full等)場合に、エラーメッセー
	  ジを出力し、終了する様に修正
	  109コマ目以降の画像取り込みに失敗するバグを修正
	  井口剛様 patch をありがとうございました。

	Version 1.2.3
	  1997/8/8
	  松本豊様提供の「XXXX.1.jpg 形式(1の部分はコマ番号)」のファイ
	  ル形式機能を追加。以下は松本豊様のコメントです。
	  「私は、nagano.1.jpg とか 970721.2.jpg の様に "任意の文字.コ
	  マ番号.jpg" のようにファイル名を命名する事が好きなので、-u 
	  オプションを追加しました。」
	  松本豊様 patch をありがとうございました。

	Version 1.2.2β
	  1997/7/17
	  撮影時間取得方法を変更(DS-20,DS-10で発生した不具合のため)
	  日付が取得できない場合(DS-10)に、ファイル出力に失敗するバグ
	  を修正

	Version 1.2.1
	  1997/6/17
	  Perl5.003 以前で発生する複数イメージダウンロード時にファイル
	  名取得に失敗するバグを修正
	  setoflag を使って回線速度を設定していた部分を setospeed に変
	  更(内川 喜章様 patch をありがとうございました)
	  Usage 出力機能のバグを修正

	Version 1.2
	  1997/6/15
	  英語版の READMEを作成
	  出力ファイル名形式切替え機能を追加
	  Usage,version 出力機能を追加
	  
	Version 1.2β3
	  1997/6/9
	  複数イメージダウンロード時にファイル名取得に失敗するバグを修正

	Version 1.2β2
	  1997/6/6
	  端末パラメータ 制御モードを変更
	  &B9600 | &CS8 | &PARENB | &CLOCAL
	                      ↓
	  &B9600 | &CS8 | &PARENB | &CLOCAL |&CREAD
	  端末パラメータ制御文字(termios->c_cc[NCCS])に0を設定

	Version 1.2β
	  1997/6/3 
	  端末パラメータ 制御モードを変更
	  &B9600 | &CS8  | &CREAD | &PARENB | &CRTSCTS
	                      ↓
	  &B9600 | &CS8 | &PARENB | &CLOCAL
	  ioctl を使用していた部分を POSIX の setcflag に変更
	  シリアル読み込みのタイミングを微調整できるようにした

	Version 1.1
	  1997/5/14 GET_DS7 ホームページを公開
	  「フジフィルム」と記述していた部分を「富士フイルム」に修正
	  「チェックサム」と記述していた部分を「BCC(Block Check
	  Character)」に修正 
	  DS-7 のデータをリードする部分のバグ修正 
	  コマ番号指定機能を追加 

	Version 1.0
	  1997/5/8 インターネットニュースに投稿

謝辞
	動作報告、励ましのメールを下さった皆様、どうもありがとうござい
	ました。

おわりに
	このプログラムを利用しての感想や、改善案「こうしたらいいですよ」
	「DS-?でも動きました」などをメールして頂ければ幸いです。

       ----------------------------
        横浜市泉区 
        mamo@yk.rim.or.jp  大野 護
       ----------------------------
