← Documents Documentation/admin-guide/media/saa7134.rst GitHub 원문 ↗

Linux 6.18.37 · Administration / Media

The saa7134 driver

SAA7130/33/34/35 기반 capture·TV board driver의 Kernel 설정, build, card 선택, patch 제출과 tuner 문제 해결 절차입니다.

Source pathDocumentation/admin-guide/media/saa7134.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

설치·식별 흐름

saa7134.rst:1-89

SAA7134 driver는 analog·digital TV, radio, remote control과 관련 subdriver를 Kernel config에서 활성화한 뒤 module로 build합니다. 자동 board 감지가 맞지 않으면 card list의 number와 tuner override를 사용합니다.

단계핵심 값확인 사항
기능 상태video, sound, tuner, radio, mpeg ts대부분 동작하지만 card별 조정이 필요합니다.
Kernel 설정PCI·INPUT, I2C·MEDIA_SUPPORT와 SAA7134 기능기본 subsystem은 enable하고 driver는 module로 구성합니다.
Build·설치make, modules_install, install새 Kernel로 boot하면 driver가 자동으로 load되어야 합니다.
Board 지정card=<nr>Documentation/admin-guide/media/saa7134-cardlist.rst에서 올바른 card number를 선택합니다.
Tuner overridetuner=flyvideos 계열의 자동 감지가 실패할 때 기본 tuner를 덮어씁니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 The saa7134 driver
4 ==================
5
6 Author Gerd Hoffmann
7
8
9 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
10 boards.
11
12
13 Status
14 ------
15
16 Almost everything is working. video, sound, tuner, radio, mpeg ts, ...
17
18 As with bttv, card-specific tweaks are needed. Check CARDLIST for a
19 list of known TV cards and saa7134-cards.c for the drivers card
20 configuration info.
21
22
23 Build
24 -----
25
26 Once you pick up a Kernel source, you should configure, build,
27 install and boot the new kernel. You'll need at least
28 these config options::
29
30 ./scripts/config -e PCI
31 ./scripts/config -e INPUT
32 ./scripts/config -m I2C
33 ./scripts/config -m MEDIA_SUPPORT
34 ./scripts/config -e MEDIA_PCI_SUPPORT
35 ./scripts/config -e MEDIA_ANALOG_TV_SUPPORT
36 ./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT
37 ./scripts/config -e MEDIA_RADIO_SUPPORT
38 ./scripts/config -e RC_CORE
39 ./scripts/config -e MEDIA_SUBDRV_AUTOSELECT
40 ./scripts/config -m VIDEO_SAA7134
41 ./scripts/config -e SAA7134_ALSA
42 ./scripts/config -e VIDEO_SAA7134_RC
43 ./scripts/config -e VIDEO_SAA7134_DVB
44 ./scripts/config -e VIDEO_SAA7134_GO7007
45
46 To build and install, you should run::
47
48 make && make modules_install && make install
49
50 Once the new Kernel is booted, saa7134 driver should be loaded automatically.
51
52 Depending on the card you might have to pass ``card=<nr>`` as insmod option.
53 If so, please check Documentation/admin-guide/media/saa7134-cardlist.rst
54 for valid choices.
55
56 Once you have your card type number, you can pass a modules configuration
57 via a file (usually, it is either ``/etc/modules.conf`` or some file at
58 ``/etc/modules-load.d/``, but the actual place depends on your
59 distribution), with this content::
60
61 options saa7134 card=13 # Assuming that your card type is #13
62
63
64 Changes / Fixes
65 ---------------
66
67 Please mail to linux-media AT vger.kernel.org unified diffs against
68 the linux media git tree:
69
70 https://git.linuxtv.org/media.git/
71
72 This is done by committing a patch at a clone of the git tree and
73 submitting the patch using ``git send-email``. Don't forget to
74 describe at the lots what it changes / which problem it fixes / whatever
75 it is good for ...
76
77
78 Known Problems
79 --------------
80
81 * The tuner for the flyvideos isn't detected automatically and the
82 default might not work for you depending on which version you have.
83 There is a ``tuner=`` insmod option to override the driver's default.
84
85 Credits
86 -------
87
88 andrew.stevens@philips.com + werner.leeb@philips.com for providing
89 saa7134 hardware specs and sample board.
90

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-20

video, sound, tuner, radio, mpeg ts 등 거의 모든 기능이 동작합니다.

bttv와 마찬가지로 card별 조정이 필요합니다. 알려진 TV card 목록은 CARDLIST를 확인하고, driver의 card configuration 정보는 saa7134-cards.c를 확인하십시오.

Build

21-50

Kernel 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_GO7007

Build와 설치에는 다음 명령을 실행하십시오.

make && make modules_install && make install

새 Kernel로 boot하면 saa7134 driver가 자동으로 load되어야 합니다.

Card type 지정

51-62

Card에 따라 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-75

Linux 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-89

saa7134 hardware specification과 sample board를 제공한 andrew.stevens@philips.com 및 werner.leeb@philips.com에게 감사드립니다.