← Documents Documentation/i2c/index.rst GitHub 원문 ↗

Linux 6.18.37 · I2C

I2C/SMBus Subsystem

I2C/SMBus 문서를 입문, 드라이버 작성, 디버깅, 슬레이브, 고급, 레거시 주제로 분류한 색인입니다.

Source pathDocumentation/i2c/index.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약·해설

index.rst:1-75

I2C 색인은 프로토콜과 토폴로지 입문부터 클라이언트 구현, 오류 주입, 슬레이브 백엔드, 10비트 주소, 레거시 매개변수까지 하위 시스템 문서를 역할별로 연결합니다.

문서 개요
항목값
SourceDocumentation/i2c/index.rst
분량75 source lines
주제 그룹6
연결 문서21

원문 분량과 핵심 검토 대상을 요약합니다.

핵심 흐름
입문과 프로토콜드라이버 작성디버깅Slave I2C고급·레거시

문서의 주요 판단 또는 탐색 순서를 압축합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ===================
4 I2C/SMBus Subsystem
5 ===================
6
7 Introduction
8 ============
9
10 .. toctree::
11 :maxdepth: 1
12
13 summary
14 i2c-protocol
15 smbus-protocol
16 instantiating-devices
17 busses/index
18 i2c-topology
19 muxes/i2c-mux-gpio
20 i2c-sysfs
21 i2c-address-translators
22
23 Writing device drivers
24 ======================
25
26 .. toctree::
27 :maxdepth: 1
28
29 writing-clients
30 dev-interface
31 dma-considerations
32 fault-codes
33 functionality
34
35 Debugging
36 =========
37
38 .. toctree::
39 :maxdepth: 1
40
41 gpio-fault-injection
42 i2c-stub
43
44 Slave I2C
45 =========
46
47 .. toctree::
48 :maxdepth: 1
49
50 slave-interface
51 slave-eeprom-backend
52 slave-testunit-backend
53
54 Advanced topics
55 ===============
56
57 .. toctree::
58 :maxdepth: 1
59
60 ten-bit-addresses
61
62 Legacy documentation
63 ====================
64
65 .. toctree::
66 :maxdepth: 1
67
68 old-module-parameters
69
70 .. only:: subproject and html
71
72 Indices
73 =======
74
75 * :ref:`genindex`
76

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

I2C/SMBus 하위 시스템 입문 문서

1-22

이 색인은 GPL-2.0 라이선스로 제공되는 I2C/SMBus 하위 시스템 문서를 주제별로 연결합니다.

입문 영역에는 하위 시스템 요약, I2C 프로토콜, SMBus 프로토콜, 장치 생성, 버스 드라이버 색인, 복잡한 I2C 토폴로지, GPIO 기반 mux, I2C sysfs, 주소 변환기 문서가 포함됩니다.

입문 문서
순서문서
1`summary`
2`i2c-protocol`
3`smbus-protocol`
4`instantiating-devices`
5`busses/index`
6`i2c-topology`
7`muxes/i2c-mux-gpio`
8`i2c-sysfs`
9`i2c-address-translators`

toctree의 원문 경로를 순서대로 보존합니다.

입문 학습 순서
I2C/SMBus 요약I2C와 SMBus 프로토콜장치와 버스 생성mux·토폴로지·주소 변환sysfs로 실행 중 구조 확인

기본 개념에서 실제 토폴로지 탐색으로 확장합니다.

.. SPDX-License-Identifier: GPL-2.0

===================
I2C/SMBus Subsystem
===================

Introduction
============

.. toctree::
   :maxdepth: 1

   summary
   i2c-protocol
   smbus-protocol
   instantiating-devices
   busses/index
   i2c-topology
   muxes/i2c-mux-gpio
   i2c-sysfs
   i2c-address-translators

장치 드라이버 작성과 디버깅

23-43

장치 드라이버 작성 영역은 클라이언트 드라이버 작성, 사용자 공간 `/dev` 인터페이스, DMA 고려사항, fault code, 어댑터 기능 확인 문서를 연결합니다.

장치 드라이버 작성 문서
문서주제
`writing-clients`I2C 클라이언트 드라이버 작성
`dev-interface`사용자 공간 I2C 장치 인터페이스
`dma-considerations`DMA-safe 버퍼와 전송 기준
`fault-codes`I2C/SMBus 오류 반환 규칙
`functionality`기능 비트 보고와 검사

클라이언트 구현에 필요한 경로입니다.

디버깅 영역에는 GPIO 결함 주입기와 실제 하드웨어 없이 칩을 모사하는 `i2c-stub` 문서가 있습니다.

디버깅 문서
문서용도
`gpio-fault-injection`선 고정·중재 상실·패닉 등 실제 버스 상태 주입
`i2c-stub`메모리 배열 기반 가상 SMBus 장치

버스 오류 주입과 가상 장치 시험을 구분합니다.

드라이버 개발 흐름
클라이언트 API와 기능 비트 설계DMA·오류 처리 구현i2c-stub으로 레지스터 동작 시험GPIO 결함 주입으로 복구 경로 시험

작성 문서와 디버깅 문서를 함께 사용하는 순서입니다.

Writing device drivers
======================

.. toctree::
   :maxdepth: 1

   writing-clients
   dev-interface
   dma-considerations
   fault-codes
   functionality

Debugging
=========

.. toctree::
   :maxdepth: 1

   gpio-fault-injection
   i2c-stub

I2C 슬레이브와 고급 주제

44-61

Slave I2C 영역에는 슬레이브 인터페이스, EEPROM 백엔드, 테스트 유닛 백엔드 문서가 포함됩니다.

Slave I2C 문서
문서주제
`slave-interface`Linux I2C 슬레이브 인터페이스
`slave-eeprom-backend`EEPROM 슬레이브 백엔드
`slave-testunit-backend`시험 유닛 슬레이브 백엔드

슬레이브 프레임워크와 백엔드 구현 문서입니다.

고급 주제 영역은 10비트 I2C 주소 문서 `ten-bit-addresses`를 연결합니다.

고급 주제
문서주제
`ten-bit-addresses`10비트 I2C 주소 사용

현재 색인에 등록된 고급 문서입니다.

Slave I2C
=========

.. toctree::
   :maxdepth: 1

   slave-interface
   slave-eeprom-backend
   slave-testunit-backend

Advanced topics
===============

.. toctree::
   :maxdepth: 1

   ten-bit-addresses

레거시 문서와 HTML 색인

62-75

레거시 문서 영역에는 과거 I2C 모듈 매개변수를 설명하는 `old-module-parameters`가 포함됩니다.

하위 프로젝트의 HTML 출력에서는 일반 색인 `genindex` 링크도 표시됩니다.

레거시·출력 전용 항목
조건항목
Legacy documentation`old-module-parameters`
`subproject and html``genindex`

toctree와 조건부 HTML 색인을 정리합니다.

Legacy documentation
====================

.. toctree::
   :maxdepth: 1

   old-module-parameters

.. only::  subproject and html

   Indices
   =======

   * :ref:`genindex`