요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=================
ALSA BT87x Driver
=================
Intro
=====
You might have noticed that the bt878 grabber cards have actually
*two* PCI functions:
::
$ lspci
[ ... ]
00:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
00:0a.1 Multimedia controller: Brooktree Corporation Bt878 (rev 02)
[ ... ]
The first does video, it is backward compatible to the bt848. The second
does audio. snd-bt87x is a driver for the second function. It's a sound
driver which can be used for recording sound (and *only* recording, no
playback). As most TV cards come with a short cable which can be plugged
into your sound card's line-in you probably don't need this driver if all
you want to do is just watching TV...
Some cards do not bother to connect anything to the audio input pins of
the chip, and some other cards use the audio function to transport MPEG
video data, so it's quite possible that audio recording may not work
with your card.
Driver Status
=============
The driver is now stable. However, it doesn't know about many TV cards,
and it refuses to load for cards it doesn't know.
If the driver complains ("Unknown TV card found, the audio driver will
not load"), you can specify the ``load_all=1`` option to force the driver to
try to use the audio capture function of your card. If the frequency of
recorded data is not right, try to specify the ``digital_rate`` option with
other values than the default 32000 (often it's 44100 or 64000).
If you have an unknown card, please mail the ID and board name to
<[email protected]>, regardless of whether audio capture works
or not, so that future versions of this driver know about your card.
Audio modes
===========
The chip knows two different modes (digital/analog). snd-bt87x
registers two PCM devices, one for each mode. They cannot be used at
the same time.
Digital audio mode
==================
The first device (hw:X,0) gives you 16 bit stereo sound. The sample
rate depends on the external source which feeds the Bt87x with digital
sound via I2S interface.
Analog audio mode (A/D)
=======================
The second device (hw:X,1) gives you 8 or 16 bit mono sound. Supported
sample rates are between 119466 and 448000 Hz (yes, these numbers are
that high). If you've set the CONFIG_SND_BT87X_OVERCLOCK option, the
maximum sample rate is 1792000 Hz, but audio data becomes unusable
beyond 896000 Hz on my card.
The chip has three analog inputs. Consequently you'll get a mixer
device to control these.
Have fun,
Clemens
Written by Clemens Ladisch <[email protected]>
big parts copied from btaudio.txt by Gerd Knorr <[email protected]>
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Bt878의 두 PCI 기능과 캡처 전용 드라이버
1-30Bt878 그래버 카드는 실제로 두 개의 PCI 기능을 제공한다. `lspci`에서 `00:0a.0`은 Brooktree Corporation Bt878 멀티미디어 비디오 컨트롤러로 나타나고, `00:0a.1`은 같은 칩의 멀티미디어 컨트롤러로 나타난다.
$ lspci
[ ... ]
00:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
00:0a.1 Multimedia controller: Brooktree Corporation Bt878 (rev 02)
[ ... ]첫 번째 기능은 비디오를 처리하며 bt848과 하위 호환된다. 두 번째 기능은 오디오를 처리하고 `snd-bt87x`가 이 기능의 드라이버다. 이 사운드 드라이버는 녹음만 지원하며 재생은 지원하지 않는다. 대부분의 TV 카드에는 사운드 카드의 라인 입력에 연결하는 짧은 케이블이 있으므로 단순히 TV를 보는 용도라면 이 드라이버가 필요하지 않을 수 있다.
일부 카드는 칩의 오디오 입력 핀에 아무것도 연결하지 않고, 다른 일부 카드는 오디오 기능으로 MPEG 비디오 데이터를 운반한다. 따라서 사용하는 카드에서는 오디오 녹음이 동작하지 않을 가능성도 있다.
같은 칩이 비디오와 오디오를 별도 PCI 기능으로 노출한다.
=================
ALSA BT87x Driver
=================
Intro
=====
You might have noticed that the bt878 grabber cards have actually
*two* PCI functions:
::
$ lspci
[ ... ]
00:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
00:0a.1 Multimedia controller: Brooktree Corporation Bt878 (rev 02)
[ ... ]
The first does video, it is backward compatible to the bt848. The second
does audio. snd-bt87x is a driver for the second function. It's a sound
driver which can be used for recording sound (and *only* recording, no
playback). As most TV cards come with a short cable which can be plugged
into your sound card's line-in you probably don't need this driver if all
you want to do is just watching TV...
Some cards do not bother to connect anything to the audio input pins of
the chip, and some other cards use the audio function to transport MPEG
video data, so it's quite possible that audio recording may not work
with your card.
드라이버 상태와 알 수 없는 카드
31-46드라이버 자체는 안정적이지만 많은 TV 카드 정보를 알지 못하므로, 인식하지 못한 카드에는 적재를 거부한다.
`Unknown TV card found, the audio driver will not load`라는 메시지가 나오면 `load_all=1` 옵션으로 해당 카드의 오디오 캡처 기능 사용을 강제로 시도할 수 있다. 녹음 데이터의 주파수가 맞지 않으면 기본값 32000 대신 `digital_rate`에 다른 값을 지정한다. 흔한 값은 44100 또는 64000이다.
알 수 없는 카드를 사용한다면 오디오 캡처 성공 여부와 관계없이 카드 ID와 보드 이름을 `<[email protected]>`로 보내야 향후 드라이버 버전에 카드 정보를 추가할 수 있다.
적재 실패와 잘못된 녹음 주파수에 대응하는 옵션이다.
Driver Status
=============
The driver is now stable. However, it doesn't know about many TV cards,
and it refuses to load for cards it doesn't know.
If the driver complains ("Unknown TV card found, the audio driver will
not load"), you can specify the ``load_all=1`` option to force the driver to
try to use the audio capture function of your card. If the frequency of
recorded data is not right, try to specify the ``digital_rate`` option with
other values than the default 32000 (often it's 44100 or 64000).
If you have an unknown card, please mail the ID and board name to
<[email protected]>, regardless of whether audio capture works
or not, so that future versions of this driver know about your card.
디지털 및 아날로그 오디오 모드
47-83칩에는 디지털과 아날로그라는 두 모드가 있고 `snd-bt87x`는 모드별 PCM 장치를 하나씩 등록한다. 두 PCM 장치는 동시에 사용할 수 없다.
첫 번째 장치 `hw:X,0`은 16비트 스테레오 디지털 오디오를 제공한다. 표본률은 I2S 인터페이스를 통해 Bt87x에 디지털 사운드를 공급하는 외부 소스에 따라 결정된다.
두 번째 장치 `hw:X,1`은 8비트 또는 16비트 모노 아날로그 A/D 오디오를 제공한다. 지원 표본률은 119466~448000Hz로 실제로 매우 높다. `CONFIG_SND_BT87X_OVERCLOCK`을 설정하면 최대 1792000Hz지만, 작성자의 카드에서는 896000Hz를 넘으면 오디오 데이터를 사용할 수 없었다.
칩에는 아날로그 입력이 세 개 있으므로 이 입력들을 제어하는 믹서 장치도 제공된다. 문서는 Clemens Ladisch가 작성했으며 큰 부분은 Gerd Knorr의 `btaudio.txt`에서 가져왔다.
서로 배타적인 두 PCM 장치의 형식과 표본률이다.
Audio modes
===========
The chip knows two different modes (digital/analog). snd-bt87x
registers two PCM devices, one for each mode. They cannot be used at
the same time.
Digital audio mode
==================
The first device (hw:X,0) gives you 16 bit stereo sound. The sample
rate depends on the external source which feeds the Bt87x with digital
sound via I2S interface.
Analog audio mode (A/D)
=======================
The second device (hw:X,1) gives you 8 or 16 bit mono sound. Supported
sample rates are between 119466 and 448000 Hz (yes, these numbers are
that high). If you've set the CONFIG_SND_BT87X_OVERCLOCK option, the
maximum sample rate is 1792000 Hz, but audio data becomes unusable
beyond 896000 Hz on my card.
The chip has three analog inputs. Consequently you'll get a mixer
device to control these.
Have fun,
Clemens
Written by Clemens Ladisch <[email protected]>
big parts copied from btaudio.txt by Gerd Knorr <[email protected]>
요약·해설
bt87x.rst:1-83Bt878의 오디오 PCI 기능을 담당하는 `snd-bt87x` 캡처 전용 드라이버의 카드 인식 옵션, 디지털·아날로그 PCM 모드와 매우 높은 A/D 표본률 제약을 설명합니다.