요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver abituguru3
========================
Supported chips:
* Abit uGuru revision 3 (Hardware Monitor part, reading only)
Prefix: 'abituguru3'
Addresses scanned: ISA 0x0E0
Datasheet: Not available, this driver is based on reverse engineering.
Note:
The uGuru is a microcontroller with onboard firmware which programs
it to behave as a hwmon IC. There are many different revisions of the
firmware and thus effectively many different revisions of the uGuru.
Below is an incomplete list with which revisions are used for which
Motherboards:
- uGuru 1.00 ~ 1.24 (AI7, KV8-MAX3, AN7)
- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
AW9D-MAX)
The abituguru3 driver is only for revision 3.0.x.x motherboards,
this driver will not work on older motherboards. For older
motherboards use the abituguru (without the 3 !) driver.
Authors:
- Hans de Goede <j.w.r.degoede@hhs.nl>,
- (Initial reverse engineering done by Louis Kruger)
Module Parameters
-----------------
* force: bool
Force detection. Note this parameter only causes the
detection to be skipped, and thus the insmod to
succeed. If the uGuru can't be read the actual hwmon
driver will not load and thus no hwmon device will get
registered.
* verbose: bool
Should the driver be verbose?
* 0/off/false normal output
* 1/on/true + verbose error reporting (default)
Default: 1 (the driver is still in the testing phase)
Description
-----------
This driver supports the hardware monitoring features of the third revision of
the Abit uGuru chip, found on recent Abit uGuru featuring motherboards.
The 3rd revision of the uGuru chip in reality is a Winbond W83L951G.
Unfortunately this doesn't help since the W83L951G is a generic microcontroller
with a custom Abit application running on it.
Despite Abit not releasing any information regarding the uGuru revision 3,
Louis Kruger has managed to reverse engineer the sensor part of the uGuru.
Without his work this driver would not have been possible.
Known Issues
------------
The voltage and frequency control parts of the Abit uGuru are not supported,
neither is writing any of the sensor settings and writing / reading the
fanspeed control registers (FanEQ)
If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
include the output of: `dmesg | grep abituguru`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Revision 3 전용 driver
1-35`abituguru3` driver는 Abit uGuru revision 3의 hardware-monitor 기능을 read-only로 지원합니다. Prefix는 `abituguru3`, scan address는 ISA `0x0E0`이며 공식 datasheet 없이 reverse engineering에 기반합니다.
uGuru는 onboard firmware로 hwmon IC처럼 동작하는 microcontroller이므로 firmware마다 실질적인 revision이 달라집니다. 문서는 revision 1·2 계열의 motherboard 목록과 함께 revision 3.0.0.0~3.0.x.x가 AW8·AL8·AT8·NI8 SLI·AT8 32X·AN8 32X·AW9D-MAX에 쓰인다고 기록합니다.
이 driver는 revision 3.0.x.x motherboard 전용이며 이전 motherboard에서는 동작하지 않습니다. 이전 board는 숫자 3이 없는 `abituguru` driver를 사용해야 합니다.
저자는 Hans de Goede이며 초기 reverse engineering은 Louis Kruger가 수행했습니다.
Revision 3와 이전 세대의 driver를 구분합니다.
Motherboard revision이 선택 기준입니다.
Kernel driver abituguru3
========================
Supported chips:
* Abit uGuru revision 3 (Hardware Monitor part, reading only)
Prefix: 'abituguru3'
Addresses scanned: ISA 0x0E0
Datasheet: Not available, this driver is based on reverse engineering.
Note:
The uGuru is a microcontroller with onboard firmware which programs
it to behave as a hwmon IC. There are many different revisions of the
firmware and thus effectively many different revisions of the uGuru.
Below is an incomplete list with which revisions are used for which
Motherboards:
- uGuru 1.00 ~ 1.24 (AI7, KV8-MAX3, AN7)
- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
AW9D-MAX)
The abituguru3 driver is only for revision 3.0.x.x motherboards,
this driver will not work on older motherboards. For older
motherboards use the abituguru (without the 3 !) driver.
Authors:
- Hans de Goede <j.w.r.degoede@hhs.nl>,
- (Initial reverse engineering done by Louis Kruger)
Parameter, 구현과 known issue
36-75`force` boolean은 detection만 건너뛰어 `insmod`를 성공시킵니다. uGuru를 실제로 읽지 못하면 hwmon driver와 device는 등록되지 않습니다.
`verbose` boolean은 0/off/false에서 normal output, 1/on/true에서 verbose error reporting을 사용합니다. Testing phase이므로 기본값은 1입니다.
Driver는 최신 Abit uGuru motherboard의 third revision hardware-monitor 기능을 지원합니다. 실제 chip은 custom Abit application이 실행되는 generic Winbond `W83L951G` microcontroller입니다.
Abit이 revision 3 정보를 공개하지 않았지만 Louis Kruger가 sensor 부분을 reverse engineer하여 driver 구현이 가능해졌습니다.
Voltage와 frequency control은 지원하지 않습니다. Sensor setting write와 fan-speed control register(FanEQ)의 write·read도 지원하지 않습니다. 문제가 있으면 `dmesg | grep abituguru` 출력을 포함해 maintainer에게 보고합니다.
Revision 3 driver의 의도적인 read-only 범위입니다.
Detection 강제는 실제 hardware access 성공을 보장하지 않습니다.
Module Parameters
-----------------
* force: bool
Force detection. Note this parameter only causes the
detection to be skipped, and thus the insmod to
succeed. If the uGuru can't be read the actual hwmon
driver will not load and thus no hwmon device will get
registered.
* verbose: bool
Should the driver be verbose?
* 0/off/false normal output
* 1/on/true + verbose error reporting (default)
Default: 1 (the driver is still in the testing phase)
Description
-----------
This driver supports the hardware monitoring features of the third revision of
the Abit uGuru chip, found on recent Abit uGuru featuring motherboards.
The 3rd revision of the uGuru chip in reality is a Winbond W83L951G.
Unfortunately this doesn't help since the W83L951G is a generic microcontroller
with a custom Abit application running on it.
Despite Abit not releasing any information regarding the uGuru revision 3,
Louis Kruger has managed to reverse engineer the sensor part of the uGuru.
Without his work this driver would not have been possible.
Known Issues
------------
The voltage and frequency control parts of the Abit uGuru are not supported,
neither is writing any of the sensor settings and writing / reading the
fanspeed control registers (FanEQ)
If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
include the output of: `dmesg | grep abituguru`
요약·해설
abituguru3.rst:1-75uGuru 3.0.x.x motherboard의 sensor reading을 지원하며 setting write와 FanEQ는 지원하지 않습니다.
Source와 핵심 지원 범위입니다.
Driver를 적용할 때의 기본 순서입니다.