13bce5377STim Harvey.. SPDX-License-Identifier: GPL-2.0 23bce5377STim Harvey 33bce5377STim HarveyKernel driver gsc-hwmon 43bce5377STim Harvey======================= 53bce5377STim Harvey 63bce5377STim HarveySupported chips: Gateworks GSC 73bce5377STim HarveyDatasheet: http://trac.gateworks.com/wiki/gsc 83bce5377STim HarveyAuthor: Tim Harvey <tharvey@gateworks.com> 93bce5377STim Harvey 103bce5377STim HarveyDescription: 113bce5377STim Harvey------------ 123bce5377STim Harvey 133bce5377STim HarveyThis driver supports hardware monitoring for the temperature sensor, 143bce5377STim Harveyvarious ADC's connected to the GSC, and optional FAN controller available 153bce5377STim Harveyon some boards. 163bce5377STim Harvey 173bce5377STim Harvey 183bce5377STim HarveyVoltage Monitoring 193bce5377STim Harvey------------------ 203bce5377STim Harvey 213bce5377STim HarveyThe voltage inputs are scaled either internally or by the driver depending 223bce5377STim Harveyon the GSC version and firmware. The values returned by the driver do not need 233bce5377STim Harveyfurther scaling. The voltage input labels provide the voltage rail name: 243bce5377STim Harvey 253bce5377STim HarveyinX_input Measured voltage (mV). 263bce5377STim HarveyinX_label Name of voltage rail. 273bce5377STim Harvey 283bce5377STim Harvey 293bce5377STim HarveyTemperature Monitoring 303bce5377STim Harvey---------------------- 313bce5377STim Harvey 323bce5377STim HarveyTemperatures are measured with 12-bit or 10-bit resolution and are scaled 333bce5377STim Harveyeither internally or by the driver depending on the GSC version and firmware. 34*12087a36SRandy DunlapThe values returned by the driver reflect millidegree Celsius: 353bce5377STim Harvey 363bce5377STim HarveytempX_input Measured temperature. 373bce5377STim HarveytempX_label Name of temperature input. 383bce5377STim Harvey 393bce5377STim Harvey 403bce5377STim HarveyPWM Output Control 413bce5377STim Harvey------------------ 423bce5377STim Harvey 433bce5377STim HarveyThe GSC features 1 PWM output that operates in automatic mode where the 44*12087a36SRandy DunlapPWM value will be scaled depending on 6 temperature boundaries. 45*12087a36SRandy DunlapThe tempeature boundaries are read-write and in millidegree Celsius and the 463bce5377STim Harveyread-only PWM values range from 0 (off) to 255 (full speed). 473bce5377STim HarveyFan speed will be set to minimum (off) when the temperature sensor reads 483bce5377STim Harveyless than pwm1_auto_point1_temp and maximum when the temperature sensor 493bce5377STim Harveyequals or exceeds pwm1_auto_point6_temp. 503bce5377STim Harvey 513bce5377STim Harveypwm1_auto_point[1-6]_pwm PWM value. 523bce5377STim Harveypwm1_auto_point[1-6]_temp Temperature boundary. 533bce5377STim Harvey 54