Documentation/driver-api/w1.rst GitHub 원문 ↗

Linux 6.18.37 · Driver API

W1: Dallas' 1-wire bus

Dallas 1-Wire bus의 W1 header, core, family, master, netlink와 I/O kernel-doc source를 설명하는 한국어 전문 번역입니다.

Source pathDocumentation/driver-api/w1.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약·해설

w1.rst:1-67

W1 문서는 1-Wire core의 API 구현 위치를 source별로 구분합니다. Header와 core, family operation, master 초기화, netlink command와 실제 I/O helper의 internal/export 경계를 확인할 수 있습니다.

문서 구성
원문 줄핵심 내용
1-17W1 header API
18-40Core, family와 master declaration
41-67Master init, netlink와 I/O

2. 영어 원문 전체

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

원문 전체 펼치기
1 ======================
2 W1: Dallas' 1-wire bus
3 ======================
4
5 :Author: David Fries
6
7 W1 API internal to the kernel
8 =============================
9
10 include/linux/w1.h
11 ~~~~~~~~~~~~~~~~~~
12
13 W1 kernel API functions.
14
15 .. kernel-doc:: include/linux/w1.h
16 :internal:
17
18 drivers/w1/w1.c
19 ~~~~~~~~~~~~~~~
20
21 W1 core functions.
22
23 .. kernel-doc:: drivers/w1/w1.c
24 :internal:
25
26 drivers/w1/w1_family.c
27 ~~~~~~~~~~~~~~~~~~~~~~~
28
29 Allows registering device family operations.
30
31 .. kernel-doc:: drivers/w1/w1_family.c
32 :export:
33
34 drivers/w1/w1_internal.h
35 ~~~~~~~~~~~~~~~~~~~~~~~~
36
37 W1 internal initialization for master devices.
38
39 .. kernel-doc:: drivers/w1/w1_internal.h
40 :internal:
41
42 drivers/w1/w1_int.c
43 ~~~~~~~~~~~~~~~~~~~~
44
45 W1 internal initialization for master devices.
46
47 .. kernel-doc:: drivers/w1/w1_int.c
48 :export:
49
50 drivers/w1/w1_netlink.h
51 ~~~~~~~~~~~~~~~~~~~~~~~~
52
53 W1 external netlink API structures and commands.
54
55 .. kernel-doc:: drivers/w1/w1_netlink.h
56 :internal:
57
58 drivers/w1/w1_io.c
59 ~~~~~~~~~~~~~~~~~~~
60
61 W1 input/output.
62
63 .. kernel-doc:: drivers/w1/w1_io.c
64 :export:
65
66 .. kernel-doc:: drivers/w1/w1_io.c
67 :internal:
68

3. 한국어 전문 번역

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

W1 header와 core API

1-17

David Fries가 작성한 이 문서는 Dallas 1-Wire bus의 kernel-internal W1 API를 source file별로 정리합니다.

`include/linux/w1.h`에는 W1 kernel API function과 내부 type declaration이 있으며 `:internal:` kernel-doc 범위로 문서화됩니다.

W1 public kernel header
Source path역할
`include/linux/w1.h`W1 kernel API function과 internal declaration

======================
W1: Dallas' 1-wire bus
======================

:Author: David Fries

W1 API internal to the kernel
=============================

include/linux/w1.h
~~~~~~~~~~~~~~~~~~

W1 kernel API functions.

.. kernel-doc:: include/linux/w1.h
   :internal:

W1 core, family와 master 초기화

18-40

`drivers/w1/w1.c`는 W1 core function을 내부 kernel-doc으로 제공합니다.

`drivers/w1/w1_family.c`는 device family operation을 등록하는 exported API를 제공합니다. Family별 protocol behavior를 W1 core에 연결하는 계층입니다.

`drivers/w1/w1_internal.h`는 master device의 W1 내부 초기화 declaration을 담습니다.

W1 core registration layers
Master internal declarations in `w1_internal.h`Core functions in `w1.c`Register family operations through `w1_family.c`Bind discovered 1-Wire slaves to family behavior

Master 초기화 뒤 core가 bus를 관리하고 family operation이 device 종류별 동작을 연결합니다.

drivers/w1/w1.c
~~~~~~~~~~~~~~~

W1 core functions.

.. kernel-doc:: drivers/w1/w1.c
   :internal:

drivers/w1/w1_family.c
~~~~~~~~~~~~~~~~~~~~~~~

Allows registering device family operations.

.. kernel-doc:: drivers/w1/w1_family.c
   :export:

drivers/w1/w1_internal.h
~~~~~~~~~~~~~~~~~~~~~~~~

W1 internal initialization for master devices.

.. kernel-doc:: drivers/w1/w1_internal.h
   :internal: