요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
=======================
4
zl3073x devlink support
5
=======================
7
This document describes the devlink features implemented by the ``zl3073x``
8
device driver.
10
Parameters
11
==========
13
.. list-table:: Generic parameters implemented
14
:widths: 5 5 90
16
* - Name
17
- Mode
18
- Notes
19
* - ``clock_id``
20
- driverinit
21
- Set the clock ID that is used by the driver for registering DPLL devices
22
and pins.
24
Info versions
25
=============
27
The ``zl3073x`` driver reports the following versions
29
.. list-table:: devlink info versions implemented
30
:widths: 5 5 5 90
32
* - Name
33
- Type
34
- Example
35
- Description
36
* - ``asic.id``
37
- fixed
38
- 1E94
39
- Chip identification number
40
* - ``asic.rev``
41
- fixed
42
- 300
43
- Chip revision number
44
* - ``fw``
45
- running
46
- 7006
47
- Firmware version number
48
* - ``custom_cfg``
49
- running
50
- 1.3.0.1
51
- Device configuration version customized by OEM
53
Flash Update
54
============
56
The ``zl3073x`` driver implements support for flash update using the
57
``devlink-flash`` interface. It supports updating the device flash using a
58
combined flash image ("bundle") that contains multiple components (firmware
59
parts and configurations).
61
During the flash procedure, the standard firmware interface is not available,
62
so the driver unregisters all DPLLs and associated pins, and re-registers them
63
once the flash procedure is complete.
65
The driver does not support any overwrite mask flags.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
zl3073x devlink 지원
1-9이 문서는 `GPL-2.0` 라이선스를 따릅니다.
`zl3073x` 장치 드라이버가 구현한 devlink 기능을 설명합니다.
.. SPDX-License-Identifier: GPL-2.0
=======================
zl3073x devlink support
=======================
This document describes the devlink features implemented by the ``zl3073x``
device driver.
DPLL clock ID
10-23매개변수
이름모드참고
`clock_id`driverinit드라이버가 DPLL 장치와 핀을 등록하는 데 사용할 clock ID를 설정합니다.
DPLL 장치와 핀을 등록할 때 사용할 클록 식별자를 초기화 시점에 지정합니다.
Parameters
==========
.. list-table:: Generic parameters implemented
:widths: 5 5 90
* - Name
- Mode
- Notes
* - ``clock_id``
- driverinit
- Set the clock ID that is used by the driver for registering DPLL devices
and pins.
ASIC와 구성 버전
24-52정보 버전
`zl3073x` 드라이버는 다음 버전을 보고합니다.
이름유형예설명
`asic.id`fixed1E94칩 식별 번호
`asic.rev`fixed300칩 리비전 번호
`fw`running7006펌웨어 버전 번호
`custom_cfg`running1.3.0.1OEM이 맞춤 설정한 장치 구성 버전
고정 ASIC 식별 정보와 실행 중인 펌웨어·OEM 맞춤 구성을 함께 보여 줍니다.
Info versions
=============
The ``zl3073x`` driver reports the following versions
.. list-table:: devlink info versions implemented
:widths: 5 5 5 90
* - Name
- Type
- Example
- Description
* - ``asic.id``
- fixed
- 1E94
- Chip identification number
* - ``asic.rev``
- fixed
- 300
- Chip revision number
* - ``fw``
- running
- 7006
- Firmware version number
* - ``custom_cfg``
- running
- 1.3.0.1
- Device configuration version customized by OEM
DPLL 재등록을 수반하는 플래시 갱신
53-65플래시 갱신
`zl3073x` 드라이버는 `devlink-flash` 인터페이스를 사용하는 플래시 갱신을 지원합니다. 펌웨어 부분과 구성 등 여러 구성 요소를 포함한 결합 플래시 이미지인 번들로 장치 플래시를 갱신합니다.
플래시 절차 중에는 표준 펌웨어 인터페이스를 사용할 수 없습니다. 따라서 드라이버는 모든 DPLL과 관련 핀을 등록 해제하고, 플래시 절차가 끝나면 다시 등록합니다.
이 드라이버는 어떤 overwrite mask 플래그도 지원하지 않습니다.
DPLL·핀 등록 해제→번들 플래시 갱신→절차 완료→DPLL·핀 재등록
펌웨어 인터페이스 중단 구간을 DPLL 등록 수명 주기와 맞춥니다.
Flash Update
============
The ``zl3073x`` driver implements support for flash update using the
``devlink-flash`` interface. It supports updating the device flash using a
combined flash image ("bundle") that contains multiple components (firmware
parts and configurations).
During the flash procedure, the standard firmware interface is not available,
so the driver unregisters all DPLLs and associated pins, and re-registers them
once the flash procedure is complete.
The driver does not support any overwrite mask flags.
요약·해설
zl3073x.rst:1-65`zl3073x` devlink 지원은 DPLL 등록용 clock ID와 ASIC·펌웨어·OEM 구성 버전을 노출합니다. 플래시 갱신 중 표준 펌웨어 인터페이스가 중단되므로 DPLL과 핀을 잠시 등록 해제했다가 완료 후 복원하는 수명 주기가 중요합니다.