readメソッド

readシステムコールが呼び出すreadメソッドの関数名をdio_readとする。 このdio_readの書式は、L.D.D.3の「3.7 readとwrie]に合わせて、 次のようにする。

各引数(パラメータ)は次のような意味を持つ。

filpは、dio_openやdio_releaseと同じくファイルポイン タ(file pointer)を示している。

buffは、デバイスのデータを格納してユーザ空間に渡すためのバッファ (buffer)である。

countは、読み込みを行うデータのサイズである。

offpは、ユーザアプリケーション側からアクセスしているファイルの位 置を示す。今回の実験はDIOボードの制御なので特には使用しない。

戻り値(返り値)は、readシステムコールの呼び出しを行ったアプリケー ション側で、以下のような意味となるように実装していくことにする。

• readシステムコール実行時に渡したcount値と等しい場合 は、要求した通りのバイト数のデータが取得できたことを示す。
  

• 戻り値が正の値で、conutよりも少ない場合には、要求したバイト 数の一部分のみが取得できたことを示す。(汎用入力の最大点数を越える ような値を指定した場合に、最大点数まで入力を行って制御を完了する。)
  

• 戻り値が負の値の場合は、エラーが発生したことを示す。エラーの種類は <linux/erro.h>の値を使用する。
  

今回の実験では、最初はdio_readメソッドを次のようなスペック(仕様)で作 成することにする。

• 取得する汎用入力データはバイト単位で、バイトデータとして単純変数 bdataに入力させる。なお、bdataはbyte dataの略である。
  

• 入力サイズは1バイトだけとする。
  

• 入力データの開始点は、PCIバスのAD(00)である。
  実際にはマルチプレックスされたAddress and DataのData であり、PCIバスのピン58（サイドＡ側）が受け持っている。
  (教科書「PCIバスによるI/O制御」の15ページ、表1-1参照)
  このAD(00)は、DIOボードPCI-2726CのIN1に対応する。
  IN1とはINPUT1の略である。(配布資料を参照すること。)
  さらに、このIN1はチェッカー(スイッチ & LEDテストボード)の最初の入力ス イッチ1に接続されている。
  

• 1バイトの入力データはチェッカーの入力スイッチ1から入力スイッチ8まで の8個のスイッチから入力することにする。