Kernel driver ibmaem | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

ibmaem.rst:1-44

IPMI를 통해 BMC의 AEM 센서 뱅크를 읽고 v1·v2 기능 차이와 읽기 전용 전력 상한을 제공합니다.

문서 개요

항목값

SourceDocumentation/hwmon/ibmaem.rst

분량44 source lines

의존성ipmi-si

버전AEM v1 / v2

원문 분량과 핵심 인터페이스입니다.

동작 흐름

ipmi-si 로드AEM 버전 확인센서 뱅크 등록에너지·전력 읽기

장치에서 hwmon 속성까지의 핵심 순서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Kernel driver ibmaem

2 ====================

4 This driver talks to the IBM Systems Director Active Energy Manager, known

5 henceforth as AEM.

7 Supported systems:

9 * Any recent IBM System X server with AEM support.

11 This includes the x3350, x3550, x3650, x3655, x3755, x3850 M2,

12 x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.

14 The IPMI host interface

15 driver ("ipmi-si") needs to be loaded for this driver to do anything.

17 Prefix: 'ibmaem'

19 Datasheet: Not available

21 Author: Darrick J. Wong

23 Description

24 -----------

26 This driver implements sensor reading support for the energy and power meters

27 available on various IBM System X hardware through the BMC. All sensor banks

28 will be exported as platform devices; this driver can talk to both v1 and v2

29 interfaces. This driver is completely separate from the older ibmpex driver.

31 The v1 AEM interface has a simple set of features to monitor energy use. There

32 is a register that displays an estimate of raw energy consumption since the

33 last BMC reset, and a power sensor that returns average power use over a

34 configurable interval.

36 The v2 AEM interface is a bit more sophisticated, being able to present a wider

37 range of energy and power use registers, the power cap as set by the AEM

38 software, and temperature sensors.

40 Special Features

41 ----------------

43 The "power_cap" value displays the current system power cap, as set by the AEM

44 software. Setting the power cap from the host is not currently supported.

3. 한국어 전문 번역

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

IBM Active Energy Manager 지원 시스템

1-21

`ibmaem` 드라이버는 IBM Systems Director Active Energy Manager(AEM)와 통신합니다. AEM을 지원하는 최신 IBM System X 서버가 대상이며 x3350, x3550, x3650, x3655, x3755, x3850 M2, x3950 M2와 일부 HC10·HS2x·LS2x·QS2x 블레이드가 포함됩니다.

드라이버가 동작하려면 IPMI 호스트 인터페이스 드라이버 `ipmi-si`가 먼저 로드되어야 합니다. 접두사는 `ibmaem`이고 공개된 데이터시트는 없습니다. 작성자는 Darrick J. Wong입니다.

ibmaem 지원 조건

항목값

관리 기능IBM Systems Director Active Energy Manager

지원 플랫폼AEM 지원 IBM System X 서버와 일부 블레이드

예시x3350·x3550·x3650·x3850 M2·x3950 M2

필수 드라이버ipmi-si

접두사ibmaem

데이터시트제공되지 않음

서버 계열과 필수 의존성을 정리했습니다.

AEM 접근 준비

AEM 지원 System X 확인IPMI host interface 준비ipmi-si 로드ibmaem 드라이버 연결BMC 센서 뱅크 탐색

BMC의 에너지 센서에 도달하기 위한 의존 관계입니다.

Kernel driver ibmaem
====================

This driver talks to the IBM Systems Director Active Energy Manager, known
henceforth as AEM.

Supported systems:

  * Any recent IBM System X server with AEM support.

    This includes the x3350, x3550, x3650, x3655, x3755, x3850 M2,
    x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.

    The IPMI host interface
    driver ("ipmi-si") needs to be loaded for this driver to do anything.

    Prefix: 'ibmaem'

    Datasheet: Not available

Author: Darrick J. Wong

AEM v1·v2 에너지 및 전력 계측

22-39

이 드라이버는 여러 IBM System X 장비에서 BMC를 통해 제공되는 에너지·전력 미터 값을 읽습니다. 모든 센서 뱅크를 플랫폼 장치로 내보내며 AEM v1과 v2 인터페이스를 모두 지원합니다. 이전 `ibmpex` 드라이버와는 완전히 별개입니다.

AEM v1은 에너지 사용량을 감시하는 단순한 기능 집합을 제공합니다. 마지막 BMC 재설정 이후의 원시 에너지 소비 추정치를 표시하는 레지스터와, 설정 가능한 구간 동안의 평균 전력 사용량을 반환하는 전력 센서가 있습니다.

AEM v2는 더 넓은 범위의 에너지·전력 사용 레지스터, AEM 소프트웨어가 설정한 전력 상한, 온도 센서를 제공하는 더 정교한 인터페이스입니다.

AEM 인터페이스 비교

기능AEM v1AEM v2

에너지BMC 재설정 이후 원시 소비 추정더 넓은 에너지 레지스터 집합

전력설정 구간의 평균 전력더 넓은 전력 레지스터 집합

전력 상한없음AEM 소프트웨어 설정값 표시

온도없음온도 센서 제공

내보내기플랫폼 장치플랫폼 장치

v1과 v2에서 노출하는 계측 기능의 차이입니다.

AEM 센서 노출

BMC에서 AEM 버전 확인v1 또는 v2 센서 뱅크 조회센서 뱅크를 플랫폼 장치로 내보내기에너지·전력 값 제공v2는 전력 상한·온도 추가

BMC 인터페이스 버전에 맞춰 센서 뱅크를 플랫폼 장치로 만듭니다.


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

This driver implements sensor reading support for the energy and power meters
available on various IBM System X hardware through the BMC.  All sensor banks
will be exported as platform devices; this driver can talk to both v1 and v2
interfaces.  This driver is completely separate from the older ibmpex driver.

The v1 AEM interface has a simple set of features to monitor energy use.  There
is a register that displays an estimate of raw energy consumption since the
last BMC reset, and a power sensor that returns average power use over a
configurable interval.

The v2 AEM interface is a bit more sophisticated, being able to present a wider
range of energy and power use registers, the power cap as set by the AEM
software, and temperature sensors.

AEM 전력 상한의 읽기 전용 성격

40-44

특수 속성 `power_cap`은 AEM 소프트웨어가 설정한 현재 시스템 전력 상한을 표시합니다. 현재 호스트에서 이 값을 설정하는 기능은 지원하지 않으므로, 이 드라이버에서는 외부 관리 소프트웨어가 정한 제한을 관찰하는 용도로 사용합니다.

power_cap 동작

항목동작

표시값현재 시스템 전력 상한

설정 주체AEM software

호스트 읽기지원

호스트 설정현재 지원하지 않음

전력 상한의 설정 주체와 호스트 기능을 구분합니다.

전력 상한 확인

AEM 소프트웨어가 상한 설정BMC/AEM 인터페이스에 값 반영ibmaem이 power_cap 노출호스트가 현재 상한 읽기

관리 소프트웨어가 정한 제한을 호스트에서 읽는 경로입니다.

Special Features
----------------

The "power_cap" value displays the current system power cap, as set by the AEM
software.  Setting the power cap from the host is not currently supported.