General Purpose Input/Output (GPIO) | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

index.rst:1-50

GPIO 문서의 최상위 index로서 개념·사용·provider·consumer·board 문서와 gpiolib 구현의 kernel-doc source를 연결합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ===================================

2 General Purpose Input/Output (GPIO)

3 ===================================

5 Contents:

7 .. toctree::

8 :maxdepth: 2

10 intro

11 using-gpio

12 driver

13 consumer

14 board

15 legacy-boards

16 drivers-on-gpio

17 bt8xxgpio

19 Core

20 ====

22 .. kernel-doc:: include/linux/gpio/driver.h

23 :internal:

25 .. kernel-doc:: drivers/gpio/gpiolib.c

26 :export:

28 ACPI support

29 ============

31 .. kernel-doc:: drivers/gpio/gpiolib-acpi-core.c

32 :export:

34 Device tree support

35 ===================

37 .. kernel-doc:: drivers/gpio/gpiolib-of.c

38 :export:

40 Device-managed API

41 ==================

43 .. kernel-doc:: drivers/gpio/gpiolib-devres.c

44 :export:

46 sysfs helpers

47 =============

49 .. kernel-doc:: drivers/gpio/gpiolib-sysfs.c

50 :export:

3. 한국어 전문 번역

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

GPIO 문서 목차

1-18

문서 제목은 `General Purpose Input/Output (GPIO)`이며 GPIO 문서 모음의 시작점입니다. 원문의 toctree는 다음 항목을 최대 depth 2로 나열합니다.

.. toctree::
   :maxdepth: 2

   intro
   using-gpio
   driver
   consumer
   board
   legacy-boards
   drivers-on-gpio
   bt8xxgpio

목차는 introduction, GPIO 사용, provider driver interface, consumer descriptor interface, board mapping, legacy board support, GPIO 기반 subsystem driver와 bt8xx GPIO hardware 문서로 이어집니다.

GPIO 문서 안내

항목주제

introGPIO 개념과 공통 electrical property

using-gpioGPIO 사용 지침

driverGPIO provider driver 작성

consumerDescriptor consumer API

boardFirmware·board mapping

legacy-boardsLegacy board lookup

drivers-on-gpio표준 GPIO 기반 subsystem driver

bt8xxgpiobt8xx GPIO hardware

Toctree 항목을 독자 역할별로 정리했습니다.

Core·ACPI·Device Tree·devres·sysfs API

19-50

Core provider의 internal kernel-doc는 `include/linux/gpio/driver.h`에서 가져옵니다.

.. kernel-doc:: include/linux/gpio/driver.h
   :internal:

Gpiolib core의 exported API는 `drivers/gpio/gpiolib.c`에서 가져옵니다.

.. kernel-doc:: drivers/gpio/gpiolib.c
   :export:

ACPI support의 exported API는 `drivers/gpio/gpiolib-acpi-core.c`입니다.

.. kernel-doc:: drivers/gpio/gpiolib-acpi-core.c
   :export:

Device Tree support의 exported API는 `drivers/gpio/gpiolib-of.c`입니다.

.. kernel-doc:: drivers/gpio/gpiolib-of.c
   :export:

Device-managed API의 exported kernel-doc source는 `drivers/gpio/gpiolib-devres.c`입니다.

.. kernel-doc:: drivers/gpio/gpiolib-devres.c
   :export:

Sysfs helper의 exported API는 `drivers/gpio/gpiolib-sysfs.c`입니다.

.. kernel-doc:: drivers/gpio/gpiolib-sysfs.c
   :export:

GPIO kernel-doc source

영역Source path범위

Core structuresinclude/linux/gpio/driver.hinternal

Gpiolib coredrivers/gpio/gpiolib.cexport

ACPIdrivers/gpio/gpiolib-acpi-core.cexport

Device Treedrivers/gpio/gpiolib-of.cexport

Device manageddrivers/gpio/gpiolib-devres.cexport

Sysfsdrivers/gpio/gpiolib-sysfs.cexport

문서에 삽입되는 API 선언과 구현 source path입니다.