From 99be68b07c24b3d32fb22939bf8ce814a0b5161b Mon Sep 17 00:00:00 2001 From: Guenter Roeck Date: Sat, 5 Aug 2017 15:44:31 -0700 Subject: [PATCH] Update README The driver supports additional chips, and up to 6 fans and fan controls. Signed-off-by: Guenter Roeck --- README | 68 ++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 38 insertions(+), 30 deletions(-) diff --git a/README b/README index 87d5826..79eb07f 100644 --- a/README +++ b/README @@ -2,8 +2,8 @@ Note ==== This driver supercedes the NCT6775F and NCT6776F support in the W83627EHF -driver. It supports NCT6106D, NCT6775F, NCT6776F, NCT6779D, NCT6791D, and -NCT6792D. +driver. It supports NCT6106D, NCT6775F, NCT6776F, NCT6779D, NCT6791D, +NCT6792D, NCT6793D, and NCT6795D. The driver is also available in the upstream kernel. This version is maintained for backward compatibility with older kernels. I am trying to keep it buildable @@ -39,6 +39,14 @@ Supported chips: Prefix: 'nct6792' Addresses scanned: ISA address retrieved from Super I/O registers Datasheet: Available from Nuvoton upon request + * Nuvoton NCT6793D + Prefix: 'nct6793' + Addresses scanned: ISA address retrieved from Super I/O registers + Datasheet: Available from Nuvoton upon request + * Nuvoton NCT6795D + Prefix: 'nct6795' + Addresses scanned: ISA address retrieved from Super I/O registers + Datasheet: Available from Nuvoton upon request Authors: Guenter Roeck @@ -48,12 +56,12 @@ Description ----------- This driver implements support for the Nuvoton NCT6106D, NCT6775F, NCT6776F, -NCT6779D, NCT6791D, and NCT6792D super I/O chips. We will refer to them -collectively as Nuvoton chips. +NCT6779D, NCT6791D, NCT6792D, NCT6793D, and NCT6795D super I/O chips. +We will refer to them collectively as Nuvoton chips. The chips implement up to 8 temperature sensors depending on the chip type and configuration. Temperatures used to control fan speed are reported separately. -There are 4 to 5 fan rotation speed sensors, 8 to 15 analog voltage sensors, +There are 3 to 6 fan rotation speed sensors, 8 to 15 analog voltage sensors, one VID, alarms with beep warnings (control unimplemented), and some automatic fan regulation strategies (plus manual fan control mode). @@ -85,7 +93,7 @@ In this mode, the chip attempts to keep the measured temperature in a predefined temperature range. If the temperature goes out of range, fan is driven slower/faster to reach the predefined range again. -The mode works for fan1-fan5. +The mode works for fan1-fan6. sysfs attributes ---------------- @@ -94,10 +102,10 @@ name - this is a standard hwmon device entry, it contains the name of the device (see the prefix in the list of supported devices at the top of this file) -pwm[1-5] - this file stores PWM duty cycle or DC value (fan speed) in range: +pwm[1-6] - this file stores PWM duty cycle or DC value (fan speed) in range: 0 (stop) to 255 (full) -pwm[1-5]_enable - this file controls mode of fan/temperature control: +pwm[1-6]_enable - this file controls mode of fan/temperature control: * 0 Fan control disabled (fans set to maximum speed) * 1 Manual mode, write to pwm file any value 0-255 (full speed) * 2 "Thermal Cruise" mode @@ -105,33 +113,33 @@ pwm[1-5]_enable - this file controls mode of fan/temperature control: * 4 "Smart Fan III" mode (NCT6775F only) * 5 "Smart Fan IV" mode -pwm[1-5]_mode - controls if output is PWM or DC level +pwm[1-6]_mode - controls if output is PWM or DC level * 0 DC output (0 - 12v) * 1 PWM output Common fan control attributes ----------------------------- -pwm[1-5]_temp_sel Temperature source. Value is temperature sensor index. +pwm[1-6]_temp_sel Temperature source. Value is temperature sensor index. For example, select '1' for temp1_input. -pwm[1-5]_weight_temp_sel +pwm[1-6]_weight_temp_sel Secondary temperature source. Value is temperature sensor index. For example, select '1' for temp1_input. -pwm[1-5]_weight_enable Set to 1 to enable secondary temperature control. +pwm[1-6]_weight_enable Set to 1 to enable secondary temperature control. If secondary temperature functionality is enabled, it is controlled with the following attributes. -pwm[1-5]_weight_duty_step +pwm[1-6]_weight_duty_step Duty step size. -pwm[1-5]_weight_temp_step +pwm[1-6]_weight_temp_step Temperature step size. With each step over temp_step_base, the value of weight_duty_step is added to the current pwm value. -pwm[1-5]_weight_temp_step_base +pwm[1-6]_weight_temp_step_base Temperature at which secondary temperature control kicks in. -pwm[1-5]_weight_temp_step_tol +pwm[1-6]_weight_temp_step_tol Temperature step tolerance or hysteresis. This is a relative value. @@ -141,27 +149,27 @@ Thermal Cruise mode (2) If the temperature is in the range defined by: -pwm[1-5]_target Target temperature, unit millidegree Celsius +pwm[1-6]_target Target temperature, unit millidegree Celsius (range 0 - 127000) -pwm[1-5]_auto_temp1_hyst +pwm[1-6]_auto_temp1_hyst Hysteresis, unit millidegree Celsius - Hysteresis value is relative to pwm[1-5]_auto_temp1. + Hysteresis value is relative to pwm[1-6]_auto_temp1. there are no changes to fan speed. Once the temperature leaves the interval, fan speed increases (temp is higher) or decreases if lower than desired, using the following steps and times. -pwm[1-5]_start_output fan pwm start value (range 1 - 255), to start fan +pwm[1-6]_start_output fan pwm start value (range 1 - 255), to start fan when the temperature is above defined range. -pwm[1-5]_stop_output lowest fan pwm (range 1 - 255) if temperature is below +pwm[1-6]_stop_output lowest fan pwm (range 1 - 255) if temperature is below the defined range. -pwm[1-5]_stop_output_enable - Set to 1 to enable pwm[1-5]_stop_output. If disabled +pwm[1-6]_stop_output_enable + Set to 1 to enable pwm[1-6]_stop_output. If disabled (set to 0), the fan will stop if the temperature is below the defined range. -pwm[1-5]_step_up_time milliseconds [ms] before fan speed is increased -pwm[1-5]_step_down_time milliseconds [ms] before fan speed is decreased -pwm[1-5]_stop_time how many milliseconds [ms] must elapse to switch +pwm[1-6]_step_up_time milliseconds [ms] before fan speed is increased +pwm[1-6]_step_down_time milliseconds [ms] before fan speed is decreased +pwm[1-6]_stop_time how many milliseconds [ms] must elapse to switch corresponding fan off (when the temperature was below defined range). @@ -180,13 +188,13 @@ pwm values to achieve higher fan speeds with increasing temperature. The last data point reflects critical temperature mode, in which the fans should run at full speed. -pwm[1-5]_auto_point[1-5]_pwm +pwm[1-6]_auto_point[1-6]_pwm pwm value to be set if temperature reaches matching temperature range. -pwm[1-5]_auto_point[1-5]_temp +pwm[1-6]_auto_point[1-6]_temp Temperature at which the matching pwm is enabled. -pwm[1-5]_step_up_time milliseconds [ms] before fan speed is increased -pwm[1-5]_step_down_time milliseconds [ms] before fan speed is decreased +pwm[1-6]_step_up_time milliseconds [ms] before fan speed is increased +pwm[1-6]_step_down_time milliseconds [ms] before fan speed is decreased Usage Notes -- 2.39.2