readme update

README.md

@@ -1,31 +1,33 @@
 DIY fan controller for ThinkPads (should be adaptable to other laptops/desktops).
 
 Introduction/Rationale:
-Newer ThinkPads are dumb, their fan controllers use an obscure method of communication with the kernel, that does not give direct access to PWM frequency. The fan(s) is(are) either off, or on in one of 2 or 3 levels, making for very jarring transitions that are clearly audible.
+Newer ThinkPads are dumb, their fan controllers use an obscure method of communication with the kernel. Direct access to PWM frequency is not possible, the fan(s) is(are) either off, or on in one of 2 or 3 levels making for very jarring speed transitions that are clearly audible.
 
 This project aims to replace the built-in PWM controller with an attiny or other arduino compatible board containing a custom fan curve. The controller reads a temperature value from a thermocouple and sets the fan accordingly, proportionally to the given temperature.
 WARNING: the PWM wire must be cut/desoldered from the fan so that we can inject our signal and drive the fan; it is also useful to crimp/solder 5V and GND for the microcontroller from the fan's connector directly, so that our chip/board will turn on/off with the laptop.
 
 Required parts:
-- Attiny45 or similar (I suggest using an arduino nano or esp32/esp8266 if you wan to add serial/wireless functionality)
+- Attiny45 or similar (I suggest using an arduino nano or esp32/esp8266 if you want to easily add serial/wireless functionality)
 - 3x 1k resistors if using a 5V microcontroller (build a voltage divider on the PWM output, as the fan operates at 3.3V); esp boards do not need this, but an output resistor at 1~3k in series with the output is recommended to protect the microcontroller and fan.
 - 10~100k resistor (or potentiometer if you want to perform manual calibration of the thermocouple)
 - some perfboard
-- NTC thermocouple (10 or 100k, calibrate accordingly)
+- NTC/PTC thermistor/thermocouple (suggested 10 or 100k, as they are widely available, place on top of heatsink near the CPU, affix with thermal glue and calibrate accordingly)
 	Useful resources when using thermistors/thermocouples:
 	- https://www.circuitbasics.com/arduino-thermistor-temperature-sensor-tutorial/
 	- https://www.arduino.cc/reference/en/libraries/ntc_thermistor/
 	- https://learn.adafruit.com/thermistor/using-a-thermistor
 - some wires (AWG24 or thereabout)
-- bulk capacitor (a few 10s of uF, value is non critical, if in doubt, use electrolytic, 10V 100uF)
+- bulk capacitor (a few 10s of uF, value is non critical, if in doubt, use electrolytic 10V 100uF)
+- a 6 or 10 pin ICSP connector to make programming and updating easier (necessary when using an attiny or other standalone chip without USB). Use USBasp or similar programmer to flash bios and upload code.
 
 Quirks:
-- arduino and other 8-bit AVRs usually generate 1KHz PWM, but computer fans run on 25KHz (will usually spin with anything from about 20 to 30KHz, but different ones may have other tolerances). Access to the individual hardware timers is needed to circumvent this problem and the "analogWrite" command cannot be used.
+- arduino and other 8-bit AVRs usually generate 1KHz PWM, but computer fans accept 25KHz (will likely spin with anything from 20 to 30KHz; different ones may have tighter tolerances). Access to the individual AVR hardware timers is needed to circumvent this problem and the "analogWrite" command cannot be used.
 	Read more here: https://docs.arduino.cc/tutorials/generic/secrets-of-arduino-pwm
-- desired PWM value is calculated in real time, but is averaged over the last 10 values to dampen "noise" (spikes and dips in temperature would otherwise lead to abrupt speed changes).
-- some fans operate on a reversed PWM logic, with speed following an inverse relation to duty cycle
+- desired PWM value is calculated in real time and is then averaged over the last 10 values to dampen "noise" (spikes and dips in temperature would otherwise result in abrupt changes in speed).
+- some fans operate on a reversed PWM logic, with speed following an inverse relation to duty cycle.
+- Currently no os/kernel control is present and the controller operates as stand-alone. The OS has no way to spin up the fan should the temperature sensor fall off/break, or other issues arise.
 
 Future goals:
-- add serial/usb communication
+- add serial/usb communication (some ThinkPads have dedicated USB connections for fingerprint/card readers that can be repurposed for this)
 - add buttons/switch to choose between fan curves
 - add software control mode (with fallback to default built-in curve when serial is down)