요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
Kernel driver kbatt
4
===================
6
Supported chips:
8
* KEBA battery monitoring controller (IP core in FPGA)
10
Prefix: 'kbatt'
12
Authors:
14
Gerhard Engleder <eg@keba.com>
15
Petar Bojanic <boja@keba.com>
17
Description
18
-----------
20
The KEBA battery monitoring controller is an IP core for FPGAs, which
21
monitors the health of a coin cell battery. The coin cell battery is
22
typically used to supply the RTC during power off to keep the current
23
time. E.g., the CP500 FPGA includes this IP core to monitor the coin cell
24
battery of PLCs and the corresponding cp500 driver creates an auxiliary
25
device for the kbatt driver.
27
This driver provides information about the coin cell battery health to
28
user space. Actually the user space shall be informed that the coin cell
29
battery is nearly empty and needs to be replaced.
31
The coin cell battery must be tested actively to get to know if its nearly
32
empty or not. Therefore, a load is put on the coin cell battery and the
33
resulting voltage is evaluated. This evaluation is done by some hard wired
34
analog logic, which compares the voltage to a defined limit. If the
35
voltage is above the limit, then the coin cell battery is assumed to be
36
ok. If the voltage is below the limit, then the coin cell battery is
37
nearly empty (or broken, removed, ...) and shall be replaced by a new one.
38
The KEBA battery monitoring controller allows to start the test of the
39
coin cell battery and to get the result if the voltage is above or below
40
the limit. The actual voltage is not available. Only the information if
41
the voltage is below a limit is available.
43
The test load, which is put on the coin cell battery for the health check,
44
is similar to the load during power off. Therefore, the lifetime of the
45
coin cell battery is reduced directly by the duration of each test. To
46
limit the negative impact to the lifetime the test is limited to at most
47
once every 10 seconds. The test load is put on the coin cell battery for
48
100ms. Thus, in worst case the coin cell battery lifetime is reduced by
49
1% of the uptime or 3.65 days per year. As the coin cell battery lasts
50
multiple years, this lifetime reduction negligible.
52
This driver only provides a single alarm attribute, which is raised when
53
the coin cell battery is nearly empty.
55
====================== ==== ===================================================
56
Attribute R/W Contents
57
====================== ==== ===================================================
58
in0_min_alarm R voltage of coin cell battery under load is below
59
limit
60
====================== ==== ===================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
KEBA 배터리 감시 IP 코어
1-16GPL-2.0 라이선스의 `kbatt` 드라이버는 FPGA에 구현된 KEBA 배터리 감시 컨트롤러 IP 코어를 지원합니다. 접두사는 `kbatt`이고 작성자는 Gerhard Engleder와 Petar Bojanic입니다.
항목값
장치KEBA battery monitoring controller
구현FPGA IP core
접두사kbatt
작성자Gerhard Engleder, Petar Bojanic
지원 IP 코어와 소프트웨어 연결입니다.
KEBA FPGA에서 IP 코어 탐색→상위 드라이버가 auxiliary device 생성→kbatt 드라이버 결합→배터리 시험 인터페이스 연결→단일 alarm 속성 게시
상위 FPGA 드라이버가 보조 장치를 제공합니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver kbatt
===================
Supported chips:
* KEBA battery monitoring controller (IP core in FPGA)
Prefix: 'kbatt'
Authors:
Gerhard Engleder <eg@keba.com>
Petar Bojanic <boja@keba.com>
코인 셀 상태 시험 원리
17-42KEBA 배터리 감시 컨트롤러는 FPGA용 IP 코어로 코인 셀 배터리의 상태를 감시합니다. 코인 셀은 보통 전원이 꺼졌을 때 RTC에 전력을 공급해 현재 시간을 유지합니다. 예를 들어 CP500 FPGA는 PLC의 코인 셀을 감시하는 이 코어를 포함하고 `cp500` 드라이버가 `kbatt`용 보조 장치를 만듭니다.
드라이버는 코인 셀이 거의 방전되어 교체해야 한다는 정보를 사용자 공간에 제공합니다.
상태를 알기 위해 배터리에 부하를 걸고 그때의 전압을 평가합니다. 고정 배선된 아날로그 로직이 전압을 정의된 한계와 비교합니다. 한계보다 높으면 정상, 낮으면 거의 방전됐거나 고장·제거된 상태로 보고 교체해야 합니다.
컨트롤러는 시험을 시작하고 전압이 한계 위인지 아래인지 결과만 제공합니다. 실제 전압 값은 제공하지 않으며 한계 미만 여부만 알 수 있습니다.
시험 단계결과
시험 부하 인가전원 차단 상태와 비슷한 부하
아날로그 비교전압과 고정 한계 비교
한계 초과배터리 정상으로 간주
한계 미만거의 방전·고장·제거 가능, 교체 필요
사용자 공간 값실제 전압 없음, 한계 미만 여부만 제공
부하 상태 전압을 이진 결과로 변환합니다.
코인 셀에 시험 부하 인가→부하 상태 전압 감지→아날로그 한계와 비교→정상 또는 한계 미만 판정→사용자 공간에 alarm 게시
부하 인가에서 alarm 결과까지의 흐름입니다.
Description
-----------
The KEBA battery monitoring controller is an IP core for FPGAs, which
monitors the health of a coin cell battery. The coin cell battery is
typically used to supply the RTC during power off to keep the current
time. E.g., the CP500 FPGA includes this IP core to monitor the coin cell
battery of PLCs and the corresponding cp500 driver creates an auxiliary
device for the kbatt driver.
This driver provides information about the coin cell battery health to
user space. Actually the user space shall be informed that the coin cell
battery is nearly empty and needs to be replaced.
The coin cell battery must be tested actively to get to know if its nearly
empty or not. Therefore, a load is put on the coin cell battery and the
resulting voltage is evaluated. This evaluation is done by some hard wired
analog logic, which compares the voltage to a defined limit. If the
voltage is above the limit, then the coin cell battery is assumed to be
ok. If the voltage is below the limit, then the coin cell battery is
nearly empty (or broken, removed, ...) and shall be replaced by a new one.
The KEBA battery monitoring controller allows to start the test of the
coin cell battery and to get the result if the voltage is above or below
the limit. The actual voltage is not available. Only the information if
the voltage is below a limit is available.
시험 주기, 수명 영향, alarm 속성
43-60상태 확인용 시험 부하는 전원 차단 중의 부하와 비슷해 각 시험 시간만큼 배터리 수명을 직접 줄입니다. 영향을 제한하기 위해 시험은 최대 10초에 한 번만 실행되고 부하는 100ms 동안 인가됩니다.
최악의 경우 배터리 수명 감소는 가동 시간의 1%, 연간 3.65일입니다. 코인 셀이 여러 해 지속되므로 원문은 이 감소를 무시할 수 있는 수준으로 평가합니다.
드라이버는 코인 셀이 거의 방전됐을 때 설정되는 읽기 전용 `in0_min_alarm` 하나만 제공합니다. 이 속성은 부하 상태 배터리 전압이 한계보다 낮다는 뜻입니다.
항목값
최소 시험 간격10초
시험 부하 시간100ms
최악 수명 감소가동 시간의 1%, 연간 3.65일
속성in0_min_alarm
권한읽기 전용
의미부하 상태 코인 셀 전압이 한계 미만
시험 제한과 사용자 공간 결과입니다.
마지막 시험 후 10초 확인→100ms 시험 부하 인가→전압 한계 비교→in0_min_alarm 갱신→다음 시험까지 대기
배터리 수명 영향을 제한하면서 상태를 갱신합니다.
The test load, which is put on the coin cell battery for the health check,
is similar to the load during power off. Therefore, the lifetime of the
coin cell battery is reduced directly by the duration of each test. To
limit the negative impact to the lifetime the test is limited to at most
once every 10 seconds. The test load is put on the coin cell battery for
100ms. Thus, in worst case the coin cell battery lifetime is reduced by
1% of the uptime or 3.65 days per year. As the coin cell battery lasts
multiple years, this lifetime reduction negligible.
This driver only provides a single alarm attribute, which is raised when
the coin cell battery is nearly empty.
====================== ==== ===================================================
Attribute R/W Contents
====================== ==== ===================================================
in0_min_alarm R voltage of coin cell battery under load is below
limit
====================== ==== ===================================================
요약·해설
kbatt.rst:1-60코인 셀에 100ms 시험 부하를 걸어 전압의 한계 미만 여부만 판정하고 읽기 전용 alarm으로 제공합니다.
원문 분량과 핵심 인터페이스입니다.
하드웨어 측정에서 hwmon 게시까지의 핵심 순서입니다.