Kernel driver pli1209bc | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

pli1209bc.rst:1-75

호스트와 BCM 사이의 격리형 감독기로 입출력 전압·전류·전력과 다이 온도의 정격·최대·임계 한계를 제공합니다.

문서 개요

항목값

SourceDocumentation/hwmon/pli1209bc.rst

분량75 source lines

주소0x50~0x5F

하위 장치BCM 1개

원문 분량과 핵심 장치 구성을 정리합니다.

운영 흐름

주소 검색격리 통신전압·전류 측정전력·온도 비교보호 경보 보고

장치 인식부터 측정·제어까지의 핵심 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 .. SPDX-License-Identifier: GPL-2.0

3 Kernel driver pli1209bc

4 =======================

6 Supported chips:

8 * Digital Supervisor PLI1209BC

10 Prefix: 'pli1209bc'

12 Addresses scanned: 0x50 - 0x5F

14 Datasheet: https://www.vicorpower.com/documents/datasheets/ds-PLI1209BCxyzz-VICOR.pdf

16 Authors:

17 - Marcello Sylvester Bauer <sylv@sylv.io>

19 Description

20 -----------

22 The Vicor PLI1209BC is an isolated digital power system supervisor that provides

23 a communication interface between a host processor and one Bus Converter Module

24 (BCM). The PLI communicates with a system controller via a PMBus compatible

25 interface over an isolated UART interface. Through the PLI, the host processor

26 can configure, set protection limits, and monitor the BCM.

28 Sysfs entries

29 -------------

31 ======================= ========================================================

32 in1_label "vin2"

33 in1_input Input voltage.

34 in1_rated_min Minimum rated input voltage.

35 in1_rated_max Maximum rated input voltage.

36 in1_max Maximum input voltage.

37 in1_max_alarm Input voltage high alarm.

38 in1_crit Critical input voltage.

39 in1_crit_alarm Input voltage critical alarm.

41 in2_label "vout2"

42 in2_input Output voltage.

43 in2_rated_min Minimum rated output voltage.

44 in2_rated_max Maximum rated output voltage.

45 in2_alarm Output voltage alarm

47 curr1_label "iin2"

48 curr1_input Input current.

49 curr1_max Maximum input current.

50 curr1_max_alarm Maximum input current high alarm.

51 curr1_crit Critical input current.

52 curr1_crit_alarm Input current critical alarm.

54 curr2_label "iout2"

55 curr2_input Output current.

56 curr2_crit Critical output current.

57 curr2_crit_alarm Output current critical alarm.

58 curr2_max Maximum output current.

59 curr2_max_alarm Output current high alarm.

61 power1_label "pin2"

62 power1_input Input power.

63 power1_alarm Input power alarm.

65 power2_label "pout2"

66 power2_input Output power.

67 power2_rated_max Maximum rated output power.

69 temp1_input Die temperature.

70 temp1_alarm Die temperature alarm.

71 temp1_max Maximum die temperature.

72 temp1_max_alarm Die temperature high alarm.

73 temp1_crit Critical die temperature.

74 temp1_crit_alarm Die temperature critical alarm.

75 ======================= ========================================================

3. 한국어 전문 번역

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

격리형 BCM 전력 감독기

1-27

GPL-2.0 `pli1209bc` 드라이버는 Vicor Digital Supervisor PLI1209BC를 지원합니다. 접두사는 `pli1209bc`이고 `0x50`부터 `0x5F`까지 주소를 검색하며 Marcello Sylvester Bauer가 작성했습니다.

PLI1209BC는 호스트 프로세서와 하나의 BCM(Bus Converter Module) 사이에 통신 인터페이스를 제공하는 격리형 디지털 전력 시스템 감독기입니다.

PLI는 격리 UART 위에서 동작하는 PMBus 호환 인터페이스로 시스템 컨트롤러와 통신합니다. 호스트는 PLI를 통해 BCM을 구성하고 보호 한계를 설정하며 상태를 감시할 수 있습니다.

PLI1209BC 연결

항목내용

장치Vicor PLI1209BC

I2C 검색 범위0x50~0x5F

상위 호스트시스템 컨트롤러·프로세서

하위 전력 장치BCM 1개

전송격리 UART 위 PMBus 호환 인터페이스

기능구성, 보호 한계, 모니터링

호스트와 BCM 사이의 격리 통신 경로입니다.

PLI 감독 경로

호스트가 PMBus 명령 생성PLI가 격리 UART로 전달BCM 설정 또는 측정 수행PLI가 상태·경보 반환hwmon 속성으로 공개

격리 경계를 넘어 BCM을 관리합니다.

.. SPDX-License-Identifier: GPL-2.0

Kernel driver pli1209bc
=======================

Supported chips:

  * Digital Supervisor PLI1209BC

    Prefix: 'pli1209bc'

    Addresses scanned: 0x50 - 0x5F

    Datasheet: https://www.vicorpower.com/documents/datasheets/ds-PLI1209BCxyzz-VICOR.pdf

Authors:
    - Marcello Sylvester Bauer <sylv@sylv.io>

Description
-----------

The Vicor PLI1209BC is an isolated digital power system supervisor that provides
a communication interface between a host processor and one Bus Converter Module
(BCM). The PLI communicates with a system controller via a PMBus compatible
interface over an isolated UART interface. Through the PLI, the host processor
can configure, set protection limits, and monitor the BCM.

입출력 전압·전류와 보호 한계

28-59

`in1_label`은 `vin2`입니다. 현재 입력 전압, 정격 최소·최대 입력 전압, 최대 입력 전압, 고전압 경보, 임계 입력 전압, 임계 경보를 제공합니다.

`in2_label`은 `vout2`입니다. 현재 출력 전압, 정격 최소·최대 출력 전압과 출력 전압 경보를 제공합니다.

`curr1_label`은 `iin2`입니다. 현재 입력 전류, 최대 입력 전류와 고전류 경보, 임계 입력 전류와 임계 경보를 제공합니다.

`curr2_label`은 `iout2`입니다. 현재 출력 전류, 임계 출력 전류와 경보, 최대 출력 전류와 고전류 경보를 제공합니다.

PLI 전압·전류 속성

그룹라벨제공 값

in1vin2input, rated_min, rated_max, max, max_alarm, crit, crit_alarm

in2vout2input, rated_min, rated_max, alarm

curr1iin2input, max, max_alarm, crit, crit_alarm

curr2iout2input, crit, crit_alarm, max, max_alarm

현재값·정격·상한·임계값과 경보를 구분합니다.

PLI 보호 상태 판정

vin2·vout2 읽기iin2·iout2 읽기정격 범위 확인max와 crit 한계 비교대응 alarm 확인

측정값을 최대·임계 한계와 비교합니다.

Sysfs entries
-------------

======================= ========================================================
in1_label                "vin2"
in1_input                Input voltage.
in1_rated_min                Minimum rated input voltage.
in1_rated_max                Maximum rated input voltage.
in1_max                        Maximum input voltage.
in1_max_alarm                Input voltage high alarm.
in1_crit                Critical input voltage.
in1_crit_alarm                Input voltage critical alarm.

in2_label                "vout2"
in2_input                Output voltage.
in2_rated_min                Minimum rated output voltage.
in2_rated_max                Maximum rated output voltage.
in2_alarm                Output voltage alarm

curr1_label                "iin2"
curr1_input                Input current.
curr1_max                Maximum input current.
curr1_max_alarm                Maximum input current high alarm.
curr1_crit                Critical input current.
curr1_crit_alarm        Input current critical alarm.

curr2_label                "iout2"
curr2_input                Output current.
curr2_crit                Critical output current.
curr2_crit_alarm        Output current critical alarm.
curr2_max                Maximum output current.
curr2_max_alarm                Output current high alarm.

입출력 전력과 다이 온도

60-75

`power1_label`은 `pin2`이며 현재 입력 전력과 입력 전력 경보를 제공합니다.

`power2_label`은 `pout2`이며 현재 출력 전력과 정격 최대 출력 전력을 제공합니다.

`temp1_input`은 현재 다이 온도, `temp1_alarm`은 다이 온도 경보, `temp1_max`와 `temp1_max_alarm`은 최대 다이 온도와 고온 경보를 제공합니다.

`temp1_crit`과 `temp1_crit_alarm`은 임계 다이 온도와 임계 경보입니다.

PLI 전력·온도 속성

그룹라벨속성

power1pin2input, alarm

power2pout2input, rated_max

temp1dieinput, alarm, max, max_alarm, crit, crit_alarm

전력 흐름과 다이 보호 온도를 정리합니다.

전력·열 감시

pin2 입력 전력 읽기pout2 출력 전력 읽기정격 최대 출력과 비교다이 온도 max·crit 비교전력·온도 경보 보고

BCM 전력과 PLI 다이 온도를 함께 점검합니다.


power1_label                "pin2"
power1_input                Input power.
power1_alarm                Input power alarm.

power2_label                "pout2"
power2_input                Output power.
power2_rated_max        Maximum rated output power.

temp1_input                Die temperature.
temp1_alarm                Die temperature alarm.
temp1_max                Maximum die temperature.
temp1_max_alarm                Die temperature high alarm.
temp1_crit                Critical die temperature.
temp1_crit_alarm        Die temperature critical alarm.
======================= ========================================================