Documentation/admin-guide/media/cx88.rst GitHub 원문 ↗

Linux 6.18.37 · Administration / Media

The cx88 driver

cx2388x V4L2 driver의 video·audio·VBI 상태와 새 card profile 추가 절차를 설명합니다.

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

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

Driver 상태

cx88.rst:1-27

Video, audio DMA, VBI 지원 상태를 정리합니다.

새 card 지원

cx88.rst:28-58

Kernel log, `cx88-cards.c`, subsystem ID와 tuner 정보를 이용하는 절차를 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 The cx88 driver
4 ===============
5
6 Author: Gerd Hoffmann
7
8 This is a v4l2 device driver for the cx2388x chip.
9
10
11 Current status
12 --------------
13
14 video
15 - Works.
16 - Overlay isn't supported.
17
18 audio
19 - Works. The TV standard detection is made by the driver, as the
20 hardware has bugs to auto-detect.
21 - audio data dma (i.e. recording without loopback cable to the
22 sound card) is supported via cx88-alsa.
23
24 vbi
25 - Works.
26
27
28 How to add support for new cards
29 --------------------------------
30
31 The driver needs some config info for the TV cards. This stuff is in
32 cx88-cards.c. If the driver doesn't work well you likely need a new
33 entry for your card in that file. Check the kernel log (using dmesg)
34 to see whenever the driver knows your card or not. There is a line
35 like this one:
36
37 .. code-block:: none
38
39 cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
40 34xxx models [card=1,autodetected]
41
42 If your card is listed as "board: UNKNOWN/GENERIC" it is unknown to
43 the driver. What to do then?
44
45 1) Try upgrading to the latest snapshot, maybe it has been added
46 meanwhile.
47 2) You can try to create a new entry yourself, have a look at
48 cx88-cards.c. If that worked, mail me your changes as unified
49 diff ("diff -u").
50 3) Or you can mail me the config information. We need at least the
51 following information to add the card:
52
53 - the PCI Subsystem ID ("0070:3400" from the line above,
54 "lspci -v" output is fine too).
55 - the tuner type used by the card. You can try to find one by
56 trial-and-error using the tuner=<n> insmod option. If you
57 know which one the card has you can also have a look at the
58 list in CARDLIST.tuner
59

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

cx2388x V4L2 driver 상태

1-27

작성자: Gerd Hoffmann

`cx88`은 cx2388x chip용 V4L2 device driver입니다.

기능현재 상태
Video동작합니다. Overlay는 지원하지 않습니다.
Audio동작합니다. Hardware의 자동 감지 bug 때문에 TV standard는 driver가 감지합니다. Sound card로 loopback cable을 연결하지 않는 audio-data DMA recording은 `cx88-alsa`가 지원합니다.
VBI동작합니다.

새 card 지원 추가

28-58

Driver가 TV card를 설정하는 데 필요한 정보는 `cx88-cards.c`에 있습니다. Card가 제대로 동작하지 않으면 이 파일에 새 entry가 필요할 가능성이 큽니다.

`dmesg`로 kernel log를 확인해 driver가 card를 아는지 판단합니다. 정상적으로 자동 감지된 예시는 다음과 같습니다.

cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
	34xxx models [card=1,autodetected]

`board: UNKNOWN/GENERIC`으로 표시되면 driver가 알지 못하는 card입니다. 먼저 최신 snapshot으로 upgrade해 그 사이 지원이 추가됐는지 확인합니다.

직접 `cx88-cards.c`에 entry를 작성해 동작했다면 변경을 unified diff(`diff -u`)로 maintainer에게 보낼 수 있습니다.

설정 정보를 보낼 때는 최소한 PCI Subsystem ID와 tuner type이 필요합니다. 위 예시에서는 `0070:3400`이 subsystem ID이며 `lspci -v` 출력도 사용할 수 있습니다.

Tuner type은 `tuner=<n>` insmod option으로 시행착오 방식으로 찾을 수 있습니다. 실제 tuner를 안다면 `CARDLIST.tuner` 목록과 대조할 수도 있습니다.