Digigram miXart8 및 miXart8AES/EBU ALSA 드라이버

하드웨어 구성과 펌웨어 의존성

Digigram miXart8은 스테레오 오디오 입력 4개와 출력 4개를 갖는 다중 채널 오디오 처리·믹싱 카드다. miXart8AES/EBU는 같은 카드에 디지털 스테레오 입력과 출력 4개씩을 추가하는 확장 카드를 붙인 모델이다.

확장 카드는 AES/EBU, Word Clock, Time Code, Video Synchro를 통한 외부 클록 동기화도 제공한다. 메인보드의 PowerPC는 온보드 MPEG 인코딩·디코딩, 표본률 변환과 여러 효과를 제공한다.

정해진 펌웨어를 적재하기 전에는 드라이버가 제대로 동작하지 않아 PCM과 믹서 장치가 나타나지 않는다. `alsa-tools` 패키지의 `mixartloader`를 사용한다.

==============================================================
Alsa driver for Digigram miXart8 and miXart8AES/EBU soundcards
==============================================================

Digigram <alsa@digigram.com>


GENERAL
=======

The miXart8 is a multichannel audio processing and mixing soundcard
that has 4 stereo audio inputs and 4 stereo audio outputs.
The miXart8AES/EBU is the same with a add-on card that offers further
4 digital stereo audio inputs and outputs.
Furthermore the add-on card offers external clock synchronisation
(AES/EBU, Word Clock, Time Code and Video Synchro)

The mainboard has a PowerPC that offers onboard mpeg encoding and
decoding, samplerate conversions and various effects.

The driver don't work properly at all until the certain firmwares
are loaded, i.e. no PCM nor mixer devices will appear.
Use the mixartloader that can be found in the alsa-tools package.

버전 0.1.0 PCM과 믹서

버전 0.1.0에서 miXart8 보드 하나는 ALSA 카드 네 개로 나타난다. 각 카드에는 stereo analog capture `pcm0c` 하나와 stereo analog playback `pcm0p` 하나가 있다. miXart8AES/EBU에서는 카드마다 stereo digital input `pcm1c`와 output `pcm1p`도 하나씩 추가된다.

지원 형식은 `U8`, `S16_LE`, `S16_BE`, `S24_3LE`, `S24_3BE`, `FLOAT_LE`, `FLOAT_BE`이고 표본률은 8000~48000Hz 연속 범위다.

재생 장치는 예시 구성에서 hardware mixing을 수행하는 substream 최대 4개를 갖지만 원하면 최대 24개로 바꿀 수 있다. Mono 파일은 좌우 채널 모두에서 재생된다. 각 스트림의 채널을 개별 음소거해 analog/digital 출력 8개를 따로 사용할 수 있다. 캡처 장치마다 substream은 하나이며 현재 stereo 형식만 지원한다.

`Master`와 `Master Capture`는 재생·캡처 PCM의 analog volume을 제어한다. `PCM 0-3`과 `PCM Capture`는 각 analog substream의 digital volume, `AES 0-3`과 `AES Capture`는 각 AES/EBU substream의 digital volume을 제어한다. `Monitoring`은 `pcm0c`에서 `pcm0p`로 digital volume·mute를 적용해 loopback한다.

최상의 음질을 위해 PCM과 AES volume은 감쇠 0으로 유지하는 것이 좋다. 0~255 범위에서 값 219이며 `alsamixer`에서는 약 86%다.

VERSION 0.1.0
=============

One miXart8 board will be represented as 4 alsa cards, each with 1
stereo analog capture 'pcm0c' and 1 stereo analog playback 'pcm0p' device.
With a miXart8AES/EBU there is in addition 1 stereo digital input
'pcm1c' and 1 stereo digital output 'pcm1p' per card.

Formats
-------
U8, S16_LE, S16_BE, S24_3LE, S24_3BE, FLOAT_LE, FLOAT_BE
Sample rates : 8000 - 48000 Hz continuously

Playback
--------
For instance the playback devices are configured to have max. 4
substreams performing hardware mixing. This could be changed to a
maximum of 24 substreams if wished.
Mono files will be played on the left and right channel. Each channel
can be muted for each stream to use 8 analog/digital outputs separately.

Capture
-------
There is one substream per capture device. For instance only stereo
formats are supported.

Mixer
-----
<Master> and <Master Capture>
        analog volume control of playback and capture PCM.
<PCM 0-3> and <PCM Capture>
        digital volume control of each analog substream.
<AES 0-3> and <AES Capture>
        digital volume control of each AES/EBU substream.
<Monitoring>
        Loopback from 'pcm0c' to 'pcm0p' with digital volume
        and mute control.

Rem : for best audio quality try to keep a 0 attenuation on the PCM
and AES volume controls which is set by 219 in the range from 0 to 255
(about 86% with alsamixer)

미구현 기능, 펌웨어와 저작권

아직 구현되지 않은 기능은 AES/EBU·Word Clock·Time Code·Video Sync 외부 클록, MPEG 오디오 형식, mono 녹음, 온보드 효과와 표본률 변환, linked stream이다.

커널 2.6.11부터 `CONFIG_FW_LOADER`를 켜면 hotplug로 펌웨어를 자동 적재할 수 있다. `mixartloader`는 더 오래된 커널 또는 드라이버를 커널에 빌트인한 경우에만 필요하다.

모듈 적재 뒤 펌웨어를 자동으로 올리려면 `/etc/modprobe.d/mixart.conf`에 다음 install 명령을 추가한다.

install snd-mixart /sbin/modprobe --first-time -i snd-mixart && \
               /usr/bin/mixartloader

2.2/2.4 커널에서는 대신 `/etc/modules.conf`에 `post-install snd-mixart /usr/bin/vxloader`를 추가한다. 펌웨어 바이너리는 configure prefix에 따라 `/usr/share/alsa/firmware` 또는 `/usr/local/share/alsa/firmware`에 설치되고, DSP 이미지 파일을 정의하는 `miXart.conf`가 있다.

펌웨어 파일의 저작권은 Digigram SA에 있다. 문서 저작권은 Copyright (c) 2003 Digigram SA `<alsa@digigram.com>`이며 GPL로 배포할 수 있다.

NOT YET IMPLEMENTED
===================

- external clock support (AES/EBU, Word Clock, Time Code, Video Sync)
- MPEG audio formats
- mono record
- on-board effects and samplerate conversions
- linked streams


FIRMWARE
========

[As of 2.6.11, the firmware can be loaded automatically with hotplug
 when CONFIG_FW_LOADER is set.  The mixartloader is necessary only
 for older versions or when you build the driver into kernel.]
 
For loading the firmware automatically after the module is loaded, use a
install command.  For example, add the following entry to
/etc/modprobe.d/mixart.conf for miXart driver:
::

        install snd-mixart /sbin/modprobe --first-time -i snd-mixart && \
                           /usr/bin/mixartloader


(for 2.2/2.4 kernels, add "post-install snd-mixart /usr/bin/vxloader" to
/etc/modules.conf, instead.)

The firmware binaries are installed on /usr/share/alsa/firmware
(or /usr/local/share/alsa/firmware, depending to the prefix option of
configure).  There will be a miXart.conf file, which define the dsp image
files.

The firmware files are copyright by Digigram SA


COPYRIGHT
=========

Copyright (c) 2003 Digigram SA <alsa@digigram.com>
Distributable under GPL.