Xilinx Zynq MPSoC EEMI Documentation | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

eemi.rst:1-40

ZynqMP firmware driver는 client driver와 secure firmware·PMC 사이에 공통 EEMI API를 제공합니다. EEMI IOCTL은 system ioctl이 아니라 device-specific·shared configuration을 다루는 firmware command입니다.

문서 구성

원문 줄핵심 내용

1-11Firmware와 PMC interface

12-21EEMI power-management communication

22-35PLL fractional IOCTL IDs

36-40EEMI guide

2. 영어 원문 전체

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

원문 전체 펼치기

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

2 Xilinx Zynq MPSoC EEMI Documentation

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

5 Xilinx Zynq MPSoC Firmware Interface

6 -------------------------------------

7 The zynqmp-firmware node describes the interface to platform firmware.

8 ZynqMP has an interface to communicate with secure firmware. Firmware

9 driver provides an interface to firmware APIs. Interface APIs can be

10 used by any driver to communicate with PMC(Platform Management Controller).

12 Embedded Energy Management Interface (EEMI)

13 ----------------------------------------------

14 The embedded energy management interface is used to allow software

15 components running across different processing clusters on a chip or

16 device to communicate with a power management controller (PMC) on a

17 device to issue or respond to power management requests.

19 Any driver who wants to communicate with PMC using EEMI APIs use the

20 functions provided for each function.

22 IOCTL

23 ------

24 IOCTL API is for device control and configuration. It is not a system

25 IOCTL but it is an EEMI API. This API can be used by master to control

26 any device specific configuration. IOCTL definitions can be platform

27 specific. This API also manage shared device configuration.

29 The following IOCTL IDs are valid for device control:

30 - IOCTL_SET_PLL_FRAC_MODE 8

31 - IOCTL_GET_PLL_FRAC_MODE 9

32 - IOCTL_SET_PLL_FRAC_DATA 10

33 - IOCTL_GET_PLL_FRAC_DATA 11

35 Refer EEMI API guide [0] for IOCTL specific parameters and other EEMI APIs.

37 References

38 ----------

39 [0] Embedded Energy Management Interface (EEMI) API guide:

40 https://www.xilinx.com/support/documentation/user_guides/ug1200-eemi-api.pdf

3. 한국어 전문 번역

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

Zynq MPSoC firmware interface

1-11

`zynqmp-firmware` node는 Xilinx Zynq MPSoC platform firmware와의 interface를 설명합니다. ZynqMP는 secure firmware와 통신할 수 있는 interface를 가지며 firmware driver가 firmware API를 노출합니다.

어떤 driver든 이 interface API를 사용해 PMC(Platform Management Controller)와 통신할 수 있습니다.

ZynqMP firmware communication

Client kernel driverZynqMP firmware driver APISecure firmware interfacePlatform Management Controller

Platform driver가 공통 firmware API를 통해 secure firmware와 PMC service에 접근합니다.

====================================
Xilinx Zynq MPSoC EEMI Documentation
====================================

Xilinx Zynq MPSoC Firmware Interface
-------------------------------------
The zynqmp-firmware node describes the interface to platform firmware.
ZynqMP has an interface to communicate with secure firmware. Firmware
driver provides an interface to firmware APIs. Interface APIs can be
used by any driver to communicate with PMC(Platform Management Controller).

Embedded Energy Management Interface

12-21

EEMI(Embedded Energy Management Interface)는 chip 또는 device의 서로 다른 processing cluster에서 실행되는 software component가 device의 PMC와 통신해 power-management request를 보내거나 응답하게 합니다.

PMC와 통신하려는 driver는 각 EEMI function에 제공되는 함수를 사용합니다.

EEMI power-management request path

Software component in processing clusterCall function-specific EEMI APIFirmware interface transports requestPMC handles power-management operationResponse returns to caller

여러 processing cluster의 software가 공통 interface로 PMC에 요청하고 응답을 받습니다.

Embedded Energy Management Interface (EEMI)
----------------------------------------------
The embedded energy management interface is used to allow software
components running across different processing clusters on a chip or
device to communicate with a power management controller (PMC) on a
device to issue or respond to power management requests.

Any driver who wants to communicate with PMC using EEMI APIs use the
functions provided for each function.

EEMI device-control IOCTL

22-35

이 IOCTL API는 device control과 configuration을 위한 EEMI API이며 system ioctl이 아닙니다. Master가 device-specific configuration을 제어하는 데 사용할 수 있고 definition은 platform-specific일 수 있습니다. Shared-device configuration도 이 API가 관리합니다.

유효 ID는 fractional PLL mode 설정 `IOCTL_SET_PLL_FRAC_MODE` 8, mode 조회 `IOCTL_GET_PLL_FRAC_MODE` 9, fractional data 설정 `IOCTL_SET_PLL_FRAC_DATA` 10, data 조회 `IOCTL_GET_PLL_FRAC_DATA` 11입니다.

각 IOCTL parameter와 다른 EEMI API는 EEMI API guide를 참조합니다.

EEMI IOCTL IDs

IDSymbol기능

8`IOCTL_SET_PLL_FRAC_MODE`PLL fractional mode 설정

9`IOCTL_GET_PLL_FRAC_MODE`PLL fractional mode 조회

10`IOCTL_SET_PLL_FRAC_DATA`PLL fractional data 설정

11`IOCTL_GET_PLL_FRAC_DATA`PLL fractional data 조회

IOCTL
------
IOCTL API is for device control and configuration. It is not a system
IOCTL but it is an EEMI API. This API can be used by master to control
any device specific configuration. IOCTL definitions can be platform
specific. This API also manage shared device configuration.

The following IOCTL IDs are valid for device control:
- IOCTL_SET_PLL_FRAC_MODE        8
- IOCTL_GET_PLL_FRAC_MODE        9
- IOCTL_SET_PLL_FRAC_DATA        10
- IOCTL_GET_PLL_FRAC_DATA        11

Refer EEMI API guide [0] for IOCTL specific parameters and other EEMI APIs.

EEMI API guide

36-40

참고문헌 `[0]`은 Xilinx Embedded Energy Management Interface API guide이며 EEMI command와 parameter의 기준 문서입니다.

EEMI reference

자료URL

Embedded Energy Management Interface API guidehttps://www.xilinx.com/support/documentation/user_guides/ug1200-eemi-api.pdf


References
----------
[0] Embedded Energy Management Interface (EEMI) API guide:
    https://www.xilinx.com/support/documentation/user_guides/ug1200-eemi-api.pdf