<!doctype linuxdoctr system>

<article>

<title>ALSA ドライバ インストールガイド<newline>
(Advanced Linux Sound Architecture)</title>

<!--                Advanced Linux Sound Architecture - Driver
		==========================================
			    Installation guide
-->

<author>ALSA Project</author>
<date>v0.9.3 April 30 2003</date>
<trans>JF Project
<tdate>v0.9.3-j June 2 2003

<!--The ALSA driver replaces the OSS/Free driver. The OSS/Free driver is
present in current Linux kernels (2.2).  Since version 0.4.0, ALSA has
supported only 2.2+ kernels. The 2.0 kernels are no longer supported. You
must compile the kernel with sound support (you do not need to select
any of the other sound modules apart from sound support).-->

<abstract>
ALSA はサウンド用のデバイスドライバで、OSS/Free ドライバを置き換えて使います。
OSS/Free というのは、Linux カーネル (2.2 版) に含まれているサウンドドライバ
のことです。ALSA の 0.4.0 版以降では 2.2 版以降のカーネルのみをサポートして
おり、2.0 版のカーネルも対象外になりました。(訳注: 2.0.x 版カーネルには
0.3.0-pre4 版をお使いください )。
カーネルをコンパイルする際には、サウンドサポートを有効
にする必要があります。ただし、サウンドサポート以外の各サウンドモジュールは
不要です。

<!--Before installing this driver, it will be helpful to read carefully
the documentation for insmod, modprobe, kmod and for the isapnp
module if you have an ISA PnP soundcard.-->

このドライバをインストールする前に、insmod, modprobe, kmod, あるいはもし ISA 
PnP サウンドカードを持っているなら isapnp 等に関する文書を精読しておくと役に立
つでしょう。(訳注: <htmlurl 
url="http://www.linux.or.jp/JF/JFdocs/Plug-and-Play-HOWTO.html" 
name="Plug-and-Play-HOWTO">, <htmlurl 
url="http://www.linux.or.jp/JF/JFdocs/ISAPnP-HOWTO.html" 
name="ISAPnP-HOWTO">)

</abstract>

<toc>
<!--
Module option name change after 0.9.0rc3
========================================
-->
<sect>0.9.0rc3 のあと、モジュールオプション名が変わりました
<!--
Note that module option names were changed in 0.9.0rc4. The 'snd_' prefix
was removed. You may use script in utils directory (module-options) to
convert your older /etc/modules.conf to newer one.
-->
<p>
モジュールオプション名が 0.9.0rc4 で変更されたことに注意してください。'snd_' 
プレフィックス(接頭辞)が取り除かれました。
utils ディレクトリにあるスクリプト (module-options) を用いて、旧式の
/etc/modules.conf を新式に変換できます。

<!--Quick install=============-->
<sect>クイック・インストール
<!--
1) You must have full configured source for the Linux kernel which you
   want to use for the ALSA drivers. Note that ALSA drivers are part
   of the kernel, so there is necessary to resolve all symbol dependencies
   between the used kernel and ALSA driver code. Partly installed kernels
   (for example from distributor makers) can be unuseable for this action.
2) You must turn on sound support (soundcore module).
3) Run './configure' script.
   If you have ISA Plug & Play soundcard, use &#045;-with-isapnp=yes switch.
   If you want sequencer support, use &#045;-with-sequencer=yes switch.
   If you do not want OSS/Free emulation, use &#045;-with-oss=no switch.
   If you want turn on debug mode use &#045;-with-debug=full switch.
   If you want debug soundcard detection try &#045;-with-debug=detect switch.
   If you have kernel source code in another directory than /usr/src/linux,
   use &#045;-with-kernel=<kernel_directory>.
   Example: ./configure &#045;-with-isapnp=yes &#045;-with-debug=full
4) Run 'make install'.
5) Run the './snddevices' script to create new sound devices in /dev directory.
   Skip this step, if you have a kernel with the DEVFS support.
6) Edit your /etc/modules.conf (see the kmod support section below).
7) Run 'modprobe snd-xxxx' where xxxx is the name of your card.
   Note: If you have a ISA PnP soundcard you need to first run the isapnp
         program from isapnptools package to initialize your
         soundcard. You can also use the native ISA PnP support by
         using the &#045;-with-isapnp=yes configuration switch, in which
	 case you do not need the isapnptools package.
-->

<p>
<enum>
<item>ALSA ドライバを使いたい Linux カーネルの、完全に設定されたソースが
必須です。ALSA ドライバはカーネルの一部なので、カーネルと ALSA 
ドライバのコード間で、すべてのシンボルの依存関係を解決する必要が
あることに注意してください。部分的にインストールされたカーネル
(たとえば、ディストリビューション製のもの)は、依存関係の解決が
できないことがあります。
<item>(soundcore モジュールの) sound support を有効にする必要があります。
<item><tt>``./configure'' </tt>で設定スクリプトを実行します。利用できるスイッチは、
<itemize>
<item>ISA Plug &amp; Play (PnP) カードの場合、<tt>&#045;-with-isapnp=yes</tt>
<item>シーケンサーサポートを有効にする場合、<tt>&#045;-with-sequencer=yes</tt>
<item>OSS/Free エミュレーションを無効にする場合、<tt>&#045;-with-oss=no</tt>
<item>デバッグモードを有効にする場合、<tt>&#045;-with-debug=full</tt>
<item>デバッグモードでカードの自動認識をしたい場合、<tt>&#045;-with-debug=detect</tt>
<item>/usr/src/linux とは別のディレクトリにカーネルのソースコードがある場合、<tt>&#045;-with-kernel=&lt;kernel_directory&gt;</tt>
<item>例: <tt>'./configure &#045;-with-isapnp=yes &#045;-with-debug=full'</tt>
</itemize>

<item><tt>``make install''</tt> を実行します。

<item><tt>``./snddevices''</tt> でスクリプトを実行して、<tt>/dev</tt> 
ディレクトリにサウンドデバイスファイルを作成します。カーネルが DEVFS を
サポートしている場合、この手順は不要です。

<item><tt>/etc/modules.conf</tt> ファイルを編集します。(訳注: 詳細は
<url url="http://www.alsa-project.org/documentation.php3" 
name="ALSA Users Documentation">をご覧ください)

<!--
(see the kmod support section below).は、kmod support section が
もう存在していないので、訳文では削除.
-->

<item><tt>``modprobe snd-xxx''</tt> を実行します。<tt>"xxx"</tt> 
部分には、使用するカードのモジュール名を指定してください。<newline>

* 注意* ISA PnP カードを使っている場合、サウンドカード初期化のために、
isapnptools パッケージの <tt>isapnp</tt> プログラムを最初に実行する必要があり
ます。ただし、ALSA インストールの際、<tt>configure</tt> スクリプトに
<tt>&#045;-with-isapnp=yes</tt> スイッチをつけて実行すれば、ALSA で独自
に ISA PnP サポートを有効にできるので、その場合 isapnptools は不要です。

</enum>

<!--You can also look at the utils/alsasound file. This script is designed for
the RedHat distribution, but it can be used with other distributions which
use System V style rc init scripts.-->
<p>また、<tt>utils/alsasound</tt> というスクリプトも覗いてみてください。
Red Hat ディストリビューションを念頭に書かれたものですが、<tt>System V</tt> 
スタイルの <tt>rc</tt> 初期化スクリプトを使っているディストリビューション
なら利用できます。

<!--Note: All mixer channels are muted by default. You must use a native
      or OSS mixer program to unmute appropriate channels (for example a
      mixer from the alsa-utils package).-->
<p> *注意* 初期状態では、ミキサーの全チャンネルの音量がミュート(ゼロにセット)
されているので、音が鳴りません。ALSA 専用か、 OSS 用のミキサープログラムを
使って、必要なチャンネルのミュートを解除してください。
(例えば、<tt>alsa-utils</tt> パッケージのミキサーなどを使ってください。)

<!--Note: This document notices the /etc/modules.conf file. Many current
      distributions uses the old /etc/conf.modules file. Both names are
      valid.-->
<p> *注意* この文書では、<tt>/etc/modules.conf</tt> という設定ファイル名を
使っています。ディストリビューションによっては、 <tt>/etc/conf.modules</tt> 
という古いファイルを使っているところが今もたくさんあります。どちらのファイ
ル名でも有効です。


<!--Driver cannot be activated?-->
<sect>ドライバが有効にならない
<!--
1) You can check your soundcard setup again and read this install file
   (module parameters) carefully.
2) If you have got ISA PnP soundcard:
   - native ISA PnP support: is your setup in /proc/isapnp correct?
   - isapnptools: is configuration on isapnp.conf same as for the driver?
3) The driver is not still working: remake driver with:
     ./configure &#045;-with-debug=detect; make clean; make
   Reinsert new driver modules to kernel and look to /var/log/messages if
   there are some messages. If these messages do not help you, please
   create a new ticket in our bug reporting system.
-->
<p>
<enum>
<item>サウンドカードの設定を再確認して、このインストールマニュアル (特に
 <ref id="module-parameters" name="各モジュールのパラメータ">)を慎重に読
み返してください。
<item>ISA PnP サウンドカードを使用している場合、
 <itemize>
 <item>ALSA 専用の PnP サポートについては、<tt>/proc/isapnp</tt> の
設定が正しいか確認してください。
 <item>isapnptools については、<tt>isapnp.conf</tt> ファイルの設定が使用
しようとするドライバ用の設定になっているか確認してください。
 </itemize>
<item>それでもドライバがきちんと機能しない場合は、
ドライバを作り直しましょう。<newline>
<tt>./configure &#045;-with-debug=detect; make clean;
make</tt> を実行し、作成された新しいドライバモジュールをカーネルに
組み込み直して、関連メッセージが表示されているかどうかを <tt>
/var/log/messages</tt> を見て確認してください。
メッセージに有益な情報が何も含まれていない場合は、われわれのバグ報告
システムに経緯を報告してください。
</enum>

<!--
Compilation from CVS sources
============================
-->
<sect>CVS ソースからのコンパイル
<!--
You need GNU packages autoconf and automake installed in your system
to compile CVS sources of alsa-driver package.

For compilation you can use these commands:
-->
<p>
alsa-driver パッケージの CVS ソースをコンパイルするには、
お使いのシステムにインストールされた GNU autoconf と automake の
パッケージが必要です。
<p>
コンパイルするには、これらのコマンド群が使えます:
<verb>
	make ALSAKERNELDIR=../alsa-kernel all-deps
		(if the alsa-kernel-dir is really there)
	aclocal
	autoconf
	./configure
	make dep
	make
</verb>
<!--
The included cvscompile script does this job for you.

Note: Some automake packages have missing aclocal program. Use newer version
      in the case.
-->
<p>
同梱された cvscompile スクリプト は、この作業をやってくれます。
<p>
注意: automake パッケージの中には、aclocal プログラムがないものも
あります。この場合は、もっと新しいバージョンを使いましょう。

<!--
Cross-compiling
===============
-->
<sect>クロスコンパイル
<!--
Use '&#045;-with-cross=prefix' parameter for the configure script.

Example:
  './configure &#045;-with-cross=arm-linux- &#045;-with-kernel=/home/ipaq/kernel/linux'.
-->
<p>
configure スクリプトで、'&#045;-with-cross=prefix' パラメータを使います。
<p>
例:
<verb>
  './configure --with-cross=arm-linux- --with-kernel=/home/ipaq/kernel/linux'.
</verb>

<!--Bug reporting system-->
<sect>バグ報告システム

<p>
バグ報告システムは、次のサイトで稼働しています。
<p>
<tt>http://www.alsa-project.org/cgi-bin/bugs</tt>



<!--###########################第三章　各モジュールのパラメータ###########-->


<!--Module parameters-->
<sect>各モジュールのパラメータ<label id="module-parameters">

<!--
For the drivers already integrated into 2.5 kernel tree, please see
alsa-kernel/Documentation/ALSA-Configuration.txt
-->
<p>
ドライバはすでに 2.5 カーネルへ統合されたので、
alsa-kernel/Documentation/ALSA-Configuration.txt をご参照ください。


<!--
Additional Modules
==================
-->
<sect>追加モジュール

<!--
  Module snd-azt3328
-->
<sect1>snd-azt3328 モジュール
<!--
    Module for soundcards based on Aztech AZF3328 PCI chip.

    Module supports up to 8 cards.
-->
<p>
Aztech AZF3328 PCI chip ベースのサウンドカード用のモジュールです。
<p>
このモジュールは、8 枚までのカードをサポートしています。

<!--
  Module snd-msnd-pinnacle
-->
<sect1>snd-msnd-pinnacle モジュール
<!--
    Module for Turtle Beach MultiSound Pinnacle/Fiji soundcards.

    io		- Port # for pinnacle/fiji card
    irq		- IRQ # for pinnalce/fiji card
    mem		- Memory address (0xb0000, 0xc8000, 0xd0000, 0xd8000,
		  0xe0000 or 0xe8000)
    write_ndelay - enable write ndelay
    calibrate_signal - calibrate signal (?)

    Module supports only one card.
-->
<p>
Turtle Beach MultiSound Pinnacle/Fiji サウンドカード用のモジュールです。
<verb>
    io		- Port # for pinnacle/fiji card
    irq		- IRQ # for pinnalce/fiji card
    mem		- Memory address (0xb0000, 0xc8000, 0xd0000, 0xd8000,
		  0xe0000 or 0xe8000)
    write_ndelay - enable write ndelay
    calibrate_signal - calibrate signal (?)
</verb>
<p>
このモジュールは、カードを 1 枚のみサポートしています。
<!--
  Module snd-serialmidi
-->
<sect1>snd-serialmidi モジュール
<!--
    Module for generic serial MIDI adapters.

    sdev	- Device file string for serial device
		  (default = "/dev/ttyS0")
    speed	- Speed in bauds. (9600,19200,38400,57600,115200)
		  (default = 38400)
    adaptor	- Type of adaptor.
                  0 = Soundcanvas, 1 = MS-124T, 2 = MS-124W S/A,
		  3 = MS-124W M/B

    Module supports up to 8 cards.
-->
<p>
一般的なシリアル MIDI アダプタ用のモジュールです。
<verb>
    sdev	- Device file string for serial device
		  (default = "/dev/ttyS0")
    speed	- Speed in bauds. (9600,19200,38400,57600,115200)
		  (default = 38400)
    adaptor	- Type of adaptor.
                  0 = Soundcanvas, 1 = MS-124T, 2 = MS-124W S/A,
		  3 = MS-124W M/B
</verb>
<p>
このモジュールは、8 枚までのカードをサポートしています。


<!--
  Module snd-sscape
-->
<sect1>snd-sscape モジュール
<!--
    Module for ENSONIQ SoundScape PnP cards.

    port	- Port # (PnP setup)
    irq		- IRQ # (PnP setup)
    mpu_irq	- MPU-401 IRQ # (PnP setup)
    dma		- DMA # (PnP setup)

    Module supports up to 8 cards.  ISA PnP must be enabled.
    You need sscape_ctl tool in alsa-tools package for loading
    the microcode.
-->
<p>
ENSONIQ SoundScape PnP カード用のモジュールです。
<verb>
    port	- Port # (PnP setup)
    irq		- IRQ # (PnP setup)
    mpu_irq	- MPU-401 IRQ # (PnP setup)
    dma		- DMA # (PnP setup)
</verb>
<p>
このモジュールは、8 枚までのカードをサポートしています。
ISA PnP を有効にする必要があります。マイクロコードを
ロードするには、alsa-tools パッケージの sscape_ctl
ツールが必要です。


<!--
  Module snd-vx222
-->
<sect1>snd-vx222 モジュール
<!--
    Module for Digigram VX-Pocket VX222, V222 v2 and Mic cards.

    mic		- Enable Microphone on V222 Mic (NYI)

    Module supports up to 8 cards.

    For loading the firmware, use vxloader utility in alsa-tools
    package.  For loading the firmware automatically, add the
    following to /etc/modules.conf

	post-install snd-vx222 "/usr/bin/vxload"
-->
<p>
Digigram VX-Pocket VX222, VX222 v2, VX222-Mic の各カード用のモジュールです。
<verb>
    mic		- Enable Microphone on V222 Mic (NYI)
</verb>
<p>
このモジュールは、8 枚までのカードをサポートしています。
<p>ファームウェアをロードするには、alsa-tools パッケージの
vxloader ユーティリティを使います。ファームウェアを自動的に
ロードするには、/etc/modules.conf に次の行を追加してください。
<verb>
	post-install snd-vx222 "/usr/bin/vxload"
</verb>


<!--
  Module snd-vxpocket
-->
<sect1>snd-vxpocket モジュール
<!--
    Module for Digigram VX-Pocket VX2 PCMCIA card.

    irq_mask - IRQ bitmask, specifies the available IRQs as bits

    Module supports up to 8 cards.  The module is compiled only when
    PCMCIA is supported on kernel.  For compiling with the external
    PCMCIA, pass &#045;-with-pcmcia=external and &#045;-with-pcmcia-root
    options.

    To activate the driver via the card manager, you'll need to copy
    vx/pcmcia/vxpocket.conf to /etc/pcmcia directory.
    For loading the firmware, use vxloader utility in alsa-tools
    package.
-->
<p>
Digigram VX-Pocket VX2 PCMCIA カード用のモジュールです。
<verb>
    irq_mask - IRQ bitmask, specifies the available IRQs as bits
</verb>
<p>
このモジュールは、8 枚までのカードをサポートしています。
PCMCIA がカーネルでサポートされている時のみ、コンパイル
されます。外付け PCMCIA 対応でコンパイルするには、
--with-pcmcia=external オプションと --with-pcmcia-root
オプションを追加します。
<p>
カードマネージャー経由でドライバを起動させるには、
vx/pcmcia/vxpocket.conf を /etc/pcmcia ディレクトリに
コピーする必要があります。
ファームウェアをロードするには、alsa-tools パッケージの
vxloader ユーティリティを使います。


<!--
  Module snd-vxp440
-->
<sect1>snd-vxp440 モジュール
<!--
    Module for Digigram VX-Pocket 440 PCMCIA card.

    irq_mask - IRQ bitmask, specifies the available IRQs as bits

    Module supports up to 8 cards.  The module is compiled only when
    PCMCIA is supported on kernel.  For compiling with the external
    PCMCIA, pass &#045;-with-pcmcia=external and &#045;-with-pcmcia-root
    options.

    To activate the driver via the card manager, you'll need to copy
    vx/pcmcia/vxpocket.conf to /etc/pcmcia directory.
    For loading the firmware, use vxloader utility in alsa-tools
    package.
-->
<p>
Digigram VX-Pocket 440 PCMCIA カード用のモジュールです。
<verb>
    irq_mask - IRQ bitmask, specifies the available IRQs as bits
</verb>
<p>
このモジュールは、8 枚までのカードをサポートしています。
PCMCIA がカーネルでサポートされている時のみ、コンパイル
されます。外付け PCMCIA 対応でコンパイルするには、
--with-pcmcia=external オプションと --with-pcmcia-root
オプションを追加します。
<p>
カードマネージャー経由でドライバを起動させるには、
vx/pcmcia/vxpocket.conf を /etc/pcmcia ディレクトリに
コピーする必要があります。
ファームウェアをロードするには、alsa-tools パッケージの
vxloader ユーティリティを使います。


<sect>日本語訳について
<p>
この文書は、alsa-driver に同梱されている INSTALL ファイル
の日本語訳です。原文の最新版は
<url url="http://www.alsa-project.org/alsa/cvs/alsa-driver/INSTALL">
から、入手できます。
<p>
読みやすくするため適宜章立てしています。
サポートされるカード名や /etc/modules.conf の設定に関しては、ALSA
のウェブページ等で確認してください。この翻訳のライセンスは、GNU
Free Documentation License
(GNU FDL)とします。ライセンスの詳細は、下記のリンクを参考にしてください。
<p>
<itemize>
<item><url url="http://alsa.linux.or.jp/" name="ALSA 日本語ページ">
<item><url url="http://www.alsa-project.org/" name="ALSA オリジナルページ">
<item><url url="http://www.linux.or.jp/JF/JFdocs/Sound-HOWTO.html"
name="Linux Sound HOWTO 日本語訳">
<item><url url="http://www.linux.or.jp/JF/JFdocs/Plug-and-Play-HOWTO.html"
name="Plug and Play HOWTO 日本語訳">
<item><url url="http://www.linux.or.jp/JF/JFdocs/ISAPnP-HOWTO.html" 
name="ISAPnP-HOWTO">
<item><url url="http://www.linux.or.jp/link/media.html#sound"
name="日本の Linux 情報 リンクページ(サウンド)">
<item><url url="http://www.linux.or.jp/JF/" name="JF のページ">
<item><url url="http://www.opensource.jp/fdl/fdl.ja.html" 
name="GNU FDL の日本語訳">
</itemize>

<verb>
v0.5.11 翻訳  Yuji Senda &lt;ysenda@pop01.odn.ne.jp&gt;
v0.9.3  更新  Masanori Kobayasi &lt;zap03216@nifty.ne.jp&gt;
校正  Nobumitsu TAKEI &lt;takei@webmasters.gr.jp&gt;
      Tsutomu Kawashima &lt;kawawa@mail.interq.or.jp&gt;
      Hiro YAMAZAKI &lt;hiro@linux.or.jp&gt;
      Yoshiyuki YAMASHITA &lt;dica@eurus.dti.ne.jp&gt;
</verb>
</article>
