Documentation/driver-api/fpga/fpga-bridge.rst GitHub 원문 ↗

Linux 6.18.37 · Driver API

FPGA Bridge

FPGA bridge structure, low-level ops와 owner-aware registration·unregister API를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

fpga-bridge.rst:1-25

FPGA bridge API는 bridge object와 low-level operation을 core에 등록하고 해제하는 최소 contract를 제공합니다. `fpga_bridge_register()` helper는 등록 module을 owner로 자동 지정합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 FPGA Bridge
2 ===========
3
4 API to implement a new FPGA bridge
5 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6
7 * struct fpga_bridge - The FPGA Bridge structure
8 * struct fpga_bridge_ops - Low level Bridge driver ops
9 * __fpga_bridge_register() - Create and register a bridge
10 * fpga_bridge_unregister() - Unregister a bridge
11
12 The helper macro ``fpga_bridge_register()`` automatically sets
13 the module that registers the FPGA bridge as the owner.
14
15 .. kernel-doc:: include/linux/fpga/fpga-bridge.h
16 :functions: fpga_bridge
17
18 .. kernel-doc:: include/linux/fpga/fpga-bridge.h
19 :functions: fpga_bridge_ops
20
21 .. kernel-doc:: drivers/fpga/fpga-bridge.c
22 :functions: __fpga_bridge_register
23
24 .. kernel-doc:: drivers/fpga/fpga-bridge.c
25 :functions: fpga_bridge_unregister
26

3. 한국어 전문 번역

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

새 FPGA bridge 구현 API

1-14

문서 제목은 `FPGA Bridge`입니다.

새 FPGA bridge를 구현할 때 사용하는 API는 다음과 같습니다.

  • `struct fpga_bridge`: FPGA bridge structure
  • `struct fpga_bridge_ops`: low-level bridge driver operation
  • `__fpga_bridge_register()`: bridge 생성과 등록
  • `fpga_bridge_unregister()`: bridge 등록 해제

Helper macro `fpga_bridge_register()`는 FPGA bridge를 등록하는 module을 owner로 자동 설정합니다.

FPGA bridge API 역할
API역할
fpga_bridgeBridge instance state
fpga_bridge_opsLow-level enable·disable operation
__fpga_bridge_register()Bridge 생성과 core 등록
fpga_bridge_register()Owner를 자동 설정하는 helper macro
fpga_bridge_unregister()Core에서 bridge 제거

Bridge object, low-level operation과 registration 생명주기를 연결합니다.

FPGA bridge kernel-doc

15-25

Bridge structure와 operation 문서는 `include/linux/fpga/fpga-bridge.h`에서 가져옵니다.

.. kernel-doc:: include/linux/fpga/fpga-bridge.h
   :functions: fpga_bridge
.. kernel-doc:: include/linux/fpga/fpga-bridge.h
   :functions: fpga_bridge_ops

등록과 해제 function 문서는 `drivers/fpga/fpga-bridge.c`에서 가져옵니다.

.. kernel-doc:: drivers/fpga/fpga-bridge.c
   :functions: __fpga_bridge_register
.. kernel-doc:: drivers/fpga/fpga-bridge.c
   :functions: fpga_bridge_unregister