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 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

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

요약·해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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: