요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
The saa7134 driver
==================
Author Gerd Hoffmann
This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
boards.
Status
------
Almost everything is working. video, sound, tuner, radio, mpeg ts, ...
As with bttv, card-specific tweaks are needed. Check CARDLIST for a
list of known TV cards and saa7134-cards.c for the drivers card
configuration info.
Build
-----
Once you pick up a Kernel source, you should configure, build,
install and boot the new kernel. You'll need at least
these config options::
./scripts/config -e PCI
./scripts/config -e INPUT
./scripts/config -m I2C
./scripts/config -m MEDIA_SUPPORT
./scripts/config -e MEDIA_PCI_SUPPORT
./scripts/config -e MEDIA_ANALOG_TV_SUPPORT
./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT
./scripts/config -e MEDIA_RADIO_SUPPORT
./scripts/config -e RC_CORE
./scripts/config -e MEDIA_SUBDRV_AUTOSELECT
./scripts/config -m VIDEO_SAA7134
./scripts/config -e SAA7134_ALSA
./scripts/config -e VIDEO_SAA7134_RC
./scripts/config -e VIDEO_SAA7134_DVB
./scripts/config -e VIDEO_SAA7134_GO7007
To build and install, you should run::
make && make modules_install && make install
Once the new Kernel is booted, saa7134 driver should be loaded automatically.
Depending on the card you might have to pass ``card=<nr>`` as insmod option.
If so, please check Documentation/admin-guide/media/saa7134-cardlist.rst
for valid choices.
Once you have your card type number, you can pass a modules configuration
via a file (usually, it is either ``/etc/modules.conf`` or some file at
``/etc/modules-load.d/``, but the actual place depends on your
distribution), with this content::
options saa7134 card=13 # Assuming that your card type is #13
Changes / Fixes
---------------
Please mail to linux-media AT vger.kernel.org unified diffs against
the linux media git tree:
https://git.linuxtv.org/media.git/
This is done by committing a patch at a clone of the git tree and
submitting the patch using ``git send-email``. Don't forget to
describe at the lots what it changes / which problem it fixes / whatever
it is good for ...
Known Problems
--------------
* The tuner for the flyvideos isn't detected automatically and the
default might not work for you depending on which version you have.
There is a ``tuner=`` insmod option to override the driver's default.
Credits
-------
[email protected] + [email protected] for providing
saa7134 hardware specs and sample board.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
SAA7134 driver 소개
1-10이 문서는 GPL-2.0 라이선스를 따릅니다. 저자는 Gerd Hoffmann입니다.
이 driver는 saa7130/33/34/35 기반 capture/TV board를 위한 v4l2/oss device driver입니다.
상태
11-20video, sound, tuner, radio, mpeg ts 등 거의 모든 기능이 동작합니다.
bttv와 마찬가지로 card별 조정이 필요합니다. 알려진 TV card 목록은 CARDLIST를 확인하고, driver의 card configuration 정보는 saa7134-cards.c를 확인하십시오.
Build
21-50Kernel source를 준비한 뒤 새 Kernel을 configure, build, install하고 boot해야 합니다. 최소한 다음 config option이 필요합니다.
./scripts/config -e PCI
./scripts/config -e INPUT
./scripts/config -m I2C
./scripts/config -m MEDIA_SUPPORT
./scripts/config -e MEDIA_PCI_SUPPORT
./scripts/config -e MEDIA_ANALOG_TV_SUPPORT
./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT
./scripts/config -e MEDIA_RADIO_SUPPORT
./scripts/config -e RC_CORE
./scripts/config -e MEDIA_SUBDRV_AUTOSELECT
./scripts/config -m VIDEO_SAA7134
./scripts/config -e SAA7134_ALSA
./scripts/config -e VIDEO_SAA7134_RC
./scripts/config -e VIDEO_SAA7134_DVB
./scripts/config -e VIDEO_SAA7134_GO7007Build와 설치에는 다음 명령을 실행하십시오.
make && make modules_install && make install새 Kernel로 boot하면 saa7134 driver가 자동으로 load되어야 합니다.
Card type 지정
51-62Card에 따라 insmod option으로 `card=<nr>`를 전달해야 할 수 있습니다. 유효한 값은 Documentation/admin-guide/media/saa7134-cardlist.rst에서 확인하십시오.
Card type number를 확인한 뒤 module configuration file을 통해 설정할 수 있습니다. 보통 `/etc/modules.conf` 또는 `/etc/modules-load.d/` 아래의 파일을 사용하지만 실제 위치는 distribution에 따라 다릅니다. 내용은 다음과 같습니다.
options saa7134 card=13 # Assuming that your card type is #13`card=13`은 예시입니다. 실제 hardware에 맞는 number를 card list에서 선택해야 합니다.
변경·수정 사항 제출
63-75Linux media git tree를 기준으로 만든 unified diff를 linux-media AT vger.kernel.org로 보내십시오.
Git tree의 clone에서 patch를 commit한 뒤 `git send-email`로 제출합니다. 무엇을 변경하는지, 어떤 문제를 수정하는지, 어떤 점에 유용한지를 충분히 설명하는 것을 잊지 마십시오.
알려진 문제
76-83- flyvideos의 tuner는 자동으로 감지되지 않으며, 사용 중인 version에 따라 기본값이 동작하지 않을 수 있습니다. Driver의 기본값을 덮어쓰려면 `tuner=` insmod option을 사용하십시오.
기여
84-89saa7134 hardware specification과 sample board를 제공한 [email protected] 및 [email protected]에게 감사드립니다.
설치·식별 흐름
saa7134.rst:1-89SAA7134 driver는 analog·digital TV, radio, remote control과 관련 subdriver를 Kernel config에서 활성화한 뒤 module로 build합니다. 자동 board 감지가 맞지 않으면 card list의 number와 tuner override를 사용합니다.