draft/man4/dsp56k.4

   1 .\" t
   2 .\" Copyright (c) 2000 lars brinkhoff <lars@nocrew.org>
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
   5 .\" This is free documentation; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\"
  10 .\" The GNU General Public License's references to "object code"
  11 .\" and "executables" are to be interpreted as the output of any
  12 .\" document formatting or typesetting system, including
  13 .\" intermediate and printed output.
  14 .\"
  15 .\" This manual is distributed in the hope that it will be useful,
  16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 .\" GNU General Public License for more details.
  19 .\"
  20 .\" You should have received a copy of the GNU General Public
  21 .\" License along with this manual; if not, see
  22 .\" <http://www.gnu.org/licenses/>.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" Modified, Thu Jan 27 19:16:19 CET 2000, lars@nocrew.org
  26 .\"
  27 .\"*******************************************************************
  28 .\"
  29 .\" This file was generated with po4a. Translate the source file.
  30 .\"
  31 .\"*******************************************************************
  32 .TH DSP56K 4 2012\-08\-05 Linux "Linux Programmer's Manual"
  33 .SH 名前
  34 dsp56k \- DSP56001 のインターフェース・デバイス
  35 .SH 書式
  36 .nf
  37 #include <asm/dsp56k.h>
  38 .sp
  39 \fBssize_t read(int \fP\fIfd\fP\fB, void *\fP\fIdata\fP\fB, size_t \fP\fIlength\fP\fB);\fP
  40 \fBssize_t write(int \fP\fIfd\fP\fB, void *\fP\fIdata\fP\fB, size_t \fP\fIlength\fP\fB);\fP
  41
  42 \fBint ioctl(int \fP\fIfd\fP\fB, DSP56K_UPLOAD, struct dsp56k_upload *\fP\fIprogram\fP\fB);\fP
  43 \fBint ioctl(int \fP\fIfd\fP\fB, DSP56K_SET_TX_WSIZE, int \fP\fIwsize\fP\fB);\fP
  44 \fBint ioctl(int \fP\fIfd\fP\fB, DSP56K_SET_RX_WSIZE, int \fP\fIwsize\fP\fB);\fP
  45 \fBint ioctl(int \fP\fIfd\fP\fB, DSP56K_HOST_FLAGS, struct dsp56k_host_flags *\fP\fIflags\fP\fB);\fP
  46 \fBint ioctl(int \fP\fIfd\fP\fB, DSP56K_HOST_CMD, int \fP\fIcmd\fP\fB);\fP
  47 .fi
  48 .SH 設定
  49 dsp56k デバイスは、メジャー番号 55、マイナー番号 0 の キャラクター・デバイスである。
  50 .SH 説明
  51 Motorola DSP56001 は、Atari Falcon030 互換のコンピュータで使われている フルプログラマブルな 24
  52 ビットのデジタルシグナルプロセッサーである。 スペシャルファイル \fIdsp56k\fP は、DSP56001 の制御と
  53 双方向ハンドシェイクホストポートでのデータの送受信のために使われる。
  54 .PP
  55 データストリームをシグナルプロセッサーに送信するためには、 デバイスに対して \fBwrite\fP(2)  を使うこと。
  56 処理されたデータを受信するためには、 \fBread\fP(2)  を使うこと。 ホスト側では、データは 8, 16, 24, 32
  57 ビット単位で送受信できるが、 DSP56001 内では、24 ビット単位で扱われる。
  58 .PP
  59 次の \fBioctl\fP(2)  コールが \fIdsp56k\fP デバイスを制御するために使われる。
  60 .IP \fBDSP56K_UPLOAD\fP
  61 DSP56001 をリセットし、プログラムをアップロードする。 \fBioctl\fP(2)  の 3 番目の引き数は、 構造体 \fIstruct
  62 dsp56k_binary\fP へのポインタでなければならない。 構造体のメンバー \fIbin\fP は DSP56001 バイナリプログラムを指し、
  63 構造体のメンバー \fIlen\fP は 24 ビットワードで数えた プログラムの長さに設定されていなければならない。
  64 .IP \fBDSP56K_SET_TX_WSIZE\fP
  65 送信ワードサイズを設定する。 設定できる値は 1 〜 4 の範囲で、このバイト数分だけ 1 度に DSP56001 に送信する。
  66 このデータ単位は、DSP56001 本来の 24 ビットデータ形式に合わせるため、 ゼロのバイトで埋められたり、切り詰められたりする。
  67 .IP \fBDSP56K_SET_RX_WSIZE\fP
  68 受信ワードサイズを設定する。 設定できる値は 1 〜 4 の範囲で、 このバイト数分だけ 1 度に DSP56001 から受信する。
  69 このデータ単位は、DSP56001 本来の 24 ビットデータ形式に合わせるため、 切り詰められたり、NULL バイト (\(aq\e0\(aq)
  70 で埋められたりする。
  71 .IP \fBDSP56K_HOST_FLAGS\fP
  72 ホストフラグを読み書きする。 ホストフラグは、一般的な目的で使うことのできるビットで、 ホストコンピュータと DSP56001
  73 の両方から読むことができる。 ビット 0 と 1 は、ホストによって書き込むことができ、 ビット 2 と 3 は、DSP56001
  74 によって書き込むことができる。
  75
  76 ホストフラグにアクセスするためには、 \fBioctl\fP(2)  の 3 番目の引き数が 構造体 \fIstruct dsp56k_host_flags\fP
  77 へのポインタでなければならない。 この構造体のメンバー \fIdir\fP のビット 0 または 1 が設定されると、 メンバー \fIout\fP
  78 の対応するビットの値がホストフラグに書き込まれる。 すべてのホストフラグの状態は、構造体のメンバー \fIstatus\fP の 下から 4
  79 ビットとして返される。
  80 .IP \fBDSP56K_HOST_CMD\fP
  81 ホストコマンドを送信する。 送信できる値は 0 〜 31 の範囲で、DSP56001 で動作しているプログラムによって
  82 処理されるユーザー定義コマンドである。
  83 .SH ファイル
  84 .\" .SH AUTHORS
  85 .\" Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
  86 .\" Tomas Berndtsson <tomas@nocrew.org>.
  87 /dev/dsp56k
  88 .SH 関連項目
  89 \fIlinux/include/asm\-m68k/dsp56k.h\fP, \fIlinux/drivers/char/dsp56k.c\fP,
  90 .UR http://dsp56k.nocrew.org/
  91 .UE ,
  92 DSP56000/DSP56001 Digital Signal
  93 Processor User's Manual
  94 .SH この文書について
  95 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
  96 である。プロジェクトの説明とバグ報告に関する情報は
  97 http://www.kernel.org/doc/man\-pages/ に書かれている。