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