Kernel driver jc42

JC 42.4 지원 칩과 공통 식별 정보

`jc42` 드라이버는 JEDEC JC 42.4 규격을 따르는 여러 제조사의 메모리 온도 센서를 지원합니다. 모든 칩은 공통 접두사 `jc42`를 사용하며 I2C 주소 `0x18`부터 `0x1f`까지 검색합니다. 작성자는 Guenter Roeck입니다.

지원 목록에는 Analog Devices ADT7408, Atmel AT30TS00·AT30TS002A/B·AT30TSE004A, IDT TSE2002B3·TSE2002GB2·TSE2004GB2·TS3000B3·TS3000GB0·TS3000GB2·TS3001GB2, Maxim MAX6604가 포함됩니다.

또한 Microchip MCP9804·MCP9805·MCP9808·MCP98242·MCP98243·MCP98244·MCP9843, NXP SE97·SE97B·SE98·SE98A, ON Semiconductor CAT34TS02·CAT6095, ST STTS424·STTS424E02·STTS2002·STTS2004·STTS3000과 기타 JEDEC JC 42.4 호환 센서를 지원합니다. 데이터시트 주소는 원문 링크에 모두 보존되어 있습니다.

Kernel driver jc42
==================

Supported chips:

  * Analog Devices ADT7408

    Datasheets:

        https://www.analog.com/static/imported-files/data_sheets/ADT7408.pdf

  * Atmel AT30TS00, AT30TS002A/B, AT30TSE004A

    Datasheets:

        http://www.atmel.com/Images/doc8585.pdf

        http://www.atmel.com/Images/doc8711.pdf

        http://www.atmel.com/Images/Atmel-8852-SEEPROM-AT30TSE002A-Datasheet.pdf

        http://www.atmel.com/Images/Atmel-8868-DTS-AT30TSE004A-Datasheet.pdf

  * IDT TSE2002B3, TSE2002GB2, TSE2004GB2, TS3000B3, TS3000GB0, TS3000GB2,

        TS3001GB2

    Datasheets:

        Available from IDT web site

  * Maxim MAX6604

    Datasheets:

        http://datasheets.maxim-ic.com/en/ds/MAX6604.pdf

  * Microchip MCP9804, MCP9805, MCP9808, MCP98242, MCP98243, MCP98244, MCP9843

    Datasheets:

        https://ww1.microchip.com/downloads/en/DeviceDoc/22203C.pdf

        https://ww1.microchip.com/downloads/en/DeviceDoc/21977b.pdf

        https://ww1.microchip.com/downloads/en/DeviceDoc/25095A.pdf

        https://ww1.microchip.com/downloads/en/DeviceDoc/21996a.pdf

        https://ww1.microchip.com/downloads/en/DeviceDoc/22153c.pdf

        https://ww1.microchip.com/downloads/en/DeviceDoc/22327A.pdf

  * NXP Semiconductors SE97, SE97B, SE98, SE98A

    Datasheets:

        https://www.nxp.com/documents/data_sheet/SE97.pdf

        https://www.nxp.com/documents/data_sheet/SE97B.pdf

        https://www.nxp.com/documents/data_sheet/SE98.pdf

        https://www.nxp.com/documents/data_sheet/SE98A.pdf

  * ON Semiconductor CAT34TS02, CAT6095

    Datasheet:

        https://www.onsemi.com/pub_link/Collateral/CAT34TS02-D.PDF

        https://www.onsemi.com/pub/Collateral/CAT6095-D.PDF

  * ST Microelectronics STTS424, STTS424E02, STTS2002, STTS2004, STTS3000

    Datasheets:

        http://www.st.com/web/en/resource/technical/document/datasheet/CD00157556.pdf

        http://www.st.com/web/en/resource/technical/document/datasheet/CD00157558.pdf

        http://www.st.com/web/en/resource/technical/document/datasheet/CD00266638.pdf

        http://www.st.com/web/en/resource/technical/document/datasheet/CD00225278.pdf

        http://www.st.com/web/en/resource/technical/document/datasheet/DM00076709.pdf

  * JEDEC JC 42.4 compliant temperature sensor chips

    Datasheet:

        http://www.jedec.org/sites/default/files/docs/4_01_04R19.pdf


  Common for all chips:

    Prefix: 'jc42'

    Addresses scanned: I2C 0x18 - 0x1f

Author:
        Guenter Roeck <linux@roeck-us.net>

메모리 온도 보호와 히스테리시스

이 드라이버는 모바일 장치와 서버의 DDR3 메모리 모듈에 널리 사용되는 JEDEC JC 42.4 호환 온도 센서를 지원합니다. 일부 시스템은 메모리 과열을 막기 위해 센서 값을 사용해 메모리 컨트롤러를 자동으로 스로틀링합니다.

목록에 있는 칩은 자동 감지하지만 다른 JC 42.4 호환 칩은 수동으로 인스턴스화할 수 있습니다. I2C 버스 1의 주소 `0x18`에 일반 센서를 등록하는 예는 `modprobe jc42` 후 `/sys/bus/i2c/devices/i2c-1/new_device`에 `jc42 0x18`을 기록하는 것입니다.

호환 칩은 온도 센서 하나를 제공하며 최소, 최대, 임계 고온을 설정할 수 있습니다. 저온·고온·임계 경보가 있고, 경보를 해제할 때 적용되는 히스테리시스도 있습니다.

JC 42.4 규격상 히스테리시스는 0, 1.5, 3.0, 6.0도 C 중 하나이므로 설정값은 이 값으로 반올림됩니다. 칩에는 모든 한계에 공통 적용되는 히스테리시스 레지스터 하나만 있습니다. `temp1_crit_hyst`에 기록해 설정하고 다른 히스테리시스 속성은 읽기 전용입니다.

BIOS가 자동 온도 관리를 구성했다면 레지스터를 잠갔을 가능성이 있으며, 이 경우 온도 한계를 변경할 수 없습니다.

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

This driver implements support for JEDEC JC 42.4 compliant temperature sensors,
which are used on many DDR3 memory modules for mobile devices and servers. Some
systems use the sensor to prevent memory overheating by automatically throttling
the memory controller.

The driver auto-detects the chips listed above, but can be manually instantiated
to support other JC 42.4 compliant chips.

Example: the following will load the driver for a generic JC 42.4 compliant
temperature sensor at address 0x18 on I2C bus #1::

        # modprobe jc42
        # echo jc42 0x18 > /sys/bus/i2c/devices/i2c-1/new_device

A JC 42.4 compliant chip supports a single temperature sensor. Minimum, maximum,
and critical temperature can be configured. There are alarms for high, low,
and critical thresholds.

There is also an hysteresis to control the thresholds for resetting alarms.
Per JC 42.4 specification, the hysteresis threshold can be configured to 0, 1.5,
3.0, and 6.0 degrees C. Configured hysteresis values will be rounded to those
limits. The chip supports only a single register to configure the hysteresis,
which applies to all limits. This register can be written by writing into
temp1_crit_hyst. Other hysteresis attributes are read-only.

If the BIOS has configured the sensor for automatic temperature management, it
is likely that it has locked the registers, i.e., that the temperature limits
cannot be changed.

JC42 sysfs 속성

`temp1_input`은 읽기 전용 현재 온도입니다. `temp1_min`, `temp1_max`, `temp1_crit`은 칩 또는 BIOS 잠금 상태에 따라 읽기 전용이거나 읽기·쓰기가 가능합니다.

`temp1_crit_hyst`는 임계 히스테리시스 온도로 읽기 전용 또는 읽기·쓰기가 가능하고, `temp1_max_hyst`는 최대 히스테리시스 온도로 읽기 전용입니다. `temp1_min_alarm`, `temp1_max_alarm`, `temp1_crit_alarm`은 각각 저온, 고온, 임계 온도 경보입니다.

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

======================= ===========================================
temp1_input                Temperature (RO)
temp1_min                Minimum temperature (RO or RW)
temp1_max                Maximum temperature (RO or RW)
temp1_crit                Critical high temperature (RO or RW)

temp1_crit_hyst                Critical hysteresis temperature (RO or RW)
temp1_max_hyst                Maximum hysteresis temperature (RO)

temp1_min_alarm                Temperature low alarm
temp1_max_alarm                Temperature high alarm
temp1_crit_alarm        Temperature critical alarm
======================= ===========================================