update PWM documentation

git-svn-id: http://lm-sensors.org/svn/lm-sensors/trunk@1678 7894878c-1315-0410-8ee3-d5d059ff63e0

doc/chips/SUMMARY

@@ -148,6 +148,10 @@ vt1211
 vt8231
 	vt8231		2-7	2-7	2	2	no	yes
 
+w83627hf
+	w83627hf	3	9	3	2 pwm	no	yes (LPC)
+	w83697hf	2	6	2	2 pwm	no	yes
+
 w83781d
 	as99127f	3	7	3	2 pwm?  yes	no
 	w83781d		3	7	3	-	yes	yes

doc/chips/mtp008

@@ -43,7 +43,13 @@ For the 2510, which has two MTP008 chips, each with a different
 configuration, follow the instructions in the mtp008 section of
 etc/sensors.conf.eg to configure 'sensors' correctly.
 
-The PWM outputs are configurable but not via the driver.
+The PWM outputs are configurable via the driver.
+PWM values are from 0 to 255. The first value in the /proc entry is
+the pwm value; the second is the enable (0 or 1).
+
+The fan3 and pwm1 functions share a pin.
+If pwm1 is enabled than fan3 will read as 0.
+
 The Fan input types (2 wire or 3 wire) are configurable but
 not via the driver.
 

doc/chips/smsc74m1

@@ -41,8 +41,8 @@ all readings twice as high. Not all RPM values can accurately be represented,
 so some rounding is done. With a divider of 2, the lowest representable
 value is around 2600 RPM.
 
-PWM values are from 0 to 100%. The first value in the /proc entry is
-the percentage; the second is the enable (0 or 1).
+PWM values are from 0 to 255. The first value in the /proc entry is
+the pwm value; the second is the enable (0 or 1).
 
 If an alarm triggers, it will remain triggered until the hardware register
 is read at least once. This means that the cause for the alarm may 

doc/chips/vt1211

@@ -58,8 +58,8 @@ all readings twice as high. Not all RPM values can accurately be represented,
 so some rounding is done. With a divider of 2, the lowest representable
 value is around 2600 RPM.
 
-PWM values are from 0 to 100%. The first value in the /proc entry is
-the percentage; the second is the enable (0 or 1).
+PWM values are from 0 to 255. The first value in the /proc entry is
+the pwm value; the second is the enable (0 or 1).
 
 If an alarm triggers, it will remain triggered until the hardware register
 is read at least once. This means that the cause for the alarm may 

doc/chips/vt8231

@@ -70,8 +70,8 @@ all readings twice as high. Not all RPM values can accurately be represented,
 so some rounding is done. With a divider of 2, the lowest representable
 value is around 2600 RPM.
 
-PWM values are from 0 to 100%. The first value in the /proc entry is
-the percentage; the second is the enable (0 or 1).
+PWM values are from 0 to 255. The first value in the /proc entry is
+the pwm value; the second is the enable (0 or 1).
 
 If an alarm triggers, it will remain triggered until the hardware register
 is read at least once. This means that the cause for the alarm may 

doc/chips/w83627hf

@@ -0,0 +1,71 @@
+Kernel driver `w83627hf.o'
+=========================
+
+Status: Beta.
+
+Supported chips:
+  * Winbond W83627HF (ISA accesses ONLY)
+    Prefix 'w83627hf'
+    Addresses scanned: ISA address retrieved from Super I/O registers
+    Datasheet: Publicly available at the Winbond website
+  * Winbond W83697HF (ISA accesses ONLY)
+    Prefix 'w83697hf'
+    Addresses scanned: ISA address retrieved from Super I/O registers
+    Datasheet: Publicly available at the Winbond website
+
+Authors: Frodo Looijaard <frodol@dds.nl>, Philip Edelbrock <phil@netroedge.com>,
+         and Mark Studebaker <mdsxyz123@yahoo.com>
+
+
+Module Parameters
+-----------------
+
+* force: short array (min = 1, max = 48)
+  List of adapter,address pairs to boldly assume to be present
+* force_addr: int
+  Program the Super I/O register for the sensors ISA base address
+* force_w83627hf: short array (min = 1, max = 48)
+  List of adapter,address pairs which are unquestionably assumed to contain
+  a `w83781d' chip
+* force_w83697hf:
+  Ditto
+* ignore: short array (min = 1, max = 48)
+  List of adapter,address pairs not to scan
+* ignore_range: short array (min = 1, max = 48)
+  List of adapter,start-addr,end-addr triples not to scan
+* probe: short array (min = 1, max = 48)
+  List of adapter,address pairs to scan additionally
+* probe_range: short array (min = 1, max = 48)
+  List of adapter,start-addr,end-addr triples to scan additionally
+* init=[0,1] (default 1)
+  Use 'init=0' to bypass initializing the chip.
+  Try this if your computer crashes when you load the module.
+
+
+Description
+-----------
+
+This driver implements support for ISA accesses *only* for
+the Winbond W83627HF and W83697HF Super I/O chips.
+We will refer to them collectively as Winbond chips.
+
+This driver supports ISA accesses, which should be more reliable
+than i2c accesses. Also, for Tyan boards which contain both a
+Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
+using this driver will avoid i2c address conflicts and complex
+initialization that were required in the w83781d driver
+(lm_sensors releases 2.7.0 and earlier).
+
+If you really want i2c accesses for these Super I/O chips,
+use the w83781d driver. However this is not the preferred method
+now that this ISA driver has been developed.
+
+For further information on the w83627hf/697hf driver, /proc values, etc.
+see the w83781d driver documentation.
+
+
+Author/Maintainer
+-----------------
+Mark D. Studebaker (mdsxyz123@yahoo.com).
+Derived from the w83781d driver.
+Send requests to the sensors@stimpy.netroedge.com mailing list.

doc/chips/w83781d

@@ -523,12 +523,13 @@ See the lm78 documentation for details.
 
 Additional entries not in the lm78:
 
-	pwm[1-4]: (782d/783s only)
+	pwm[1-4]: (not on w83781d)
 	  Controls the speed of the fans with PWM (Pulse Width Modulation)
 	  Valid values:
 	    0 - 255. 255 = max speed.
+        Second value is PWM enable 0/1.
 
-	sensor[1-3]: (782d/783s only)
+	sensor[1-3]: (not on w83781d)
 	  Controls the sensor type. To change to a different
 	  sensor type, for example, do 'echo 2 > sensor1'.
 	  Valid values:
@@ -565,7 +566,8 @@ NOTES:
 
   782d and 783s pin is programmable for fan3 input or pwm2 output;
        defaults to fan3 input.
-       no control in driver so pwm2 doesn't work.
+       If pwm2 is enabled (with echo 255 1 > pwm2), then
+       fan3 will report 0.
 
   782d has pwm1-2 for isa, pwm1-4 for i2c. (pwm3-4 share pins with
        the isa pins)