^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Kernel driver gsc-hwmon
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) =======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Supported chips: Gateworks GSC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Datasheet: http://trac.gateworks.com/wiki/gsc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Author: Tim Harvey <tharvey@gateworks.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) ------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) This driver supports hardware monitoring for the temperature sensor,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) various ADC's connected to the GSC, and optional FAN controller available
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) on some boards.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Voltage Monitoring
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) ------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) The voltage inputs are scaled either internally or by the driver depending
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) on the GSC version and firmware. The values returned by the driver do not need
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) further scaling. The voltage input labels provide the voltage rail name:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) inX_input Measured voltage (mV).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) inX_label Name of voltage rail.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Temperature Monitoring
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) ----------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Temperatures are measured with 12-bit or 10-bit resolution and are scaled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) either internally or by the driver depending on the GSC version and firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) The values returned by the driver reflect millidegree Celcius:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) tempX_input Measured temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) tempX_label Name of temperature input.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) PWM Output Control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) ------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) The GSC features 1 PWM output that operates in automatic mode where the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) PWM value will be scalled depending on 6 temperature boundaries.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) The tempeature boundaries are read-write and in millidegree Celcius and the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) read-only PWM values range from 0 (off) to 255 (full speed).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Fan speed will be set to minimum (off) when the temperature sensor reads
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) less than pwm1_auto_point1_temp and maximum when the temperature sensor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) equals or exceeds pwm1_auto_point6_temp.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) pwm1_auto_point[1-6]_pwm PWM value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) pwm1_auto_point[1-6]_temp Temperature boundary.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)