diff --git a/CHANGES b/CHANGES index ae0c6354..b42f4bb1 100644 --- a/CHANGES +++ b/CHANGES @@ -42,6 +42,7 @@ ask CVS about it: Module i2c-amd8111: New (SMBus 2.0) Module i2c-ipmb: New Module i2c-ipmi: New + Module i2c-keywest: Sync with kernel 2.4.20 Module i2c-sis630: Add support for SiS730 Module i2c-sis645: Improve support for SiS645/961; add support for SiS645DX/961 and SiS735 @@ -51,7 +52,7 @@ ask CVS about it: Module vt8231: Fix inx limits and alarms; fix in0 Module w83781d: Fix in0/in1 initialization Module smartbatt: New - Modules (several): Remove #ifndefs, require i2c-2.7.0 + Modules (several): Remove #ifndefs, require i2c-2.7.0; HZ fixes Program decode-dimms.pl: Code cleanup; valid HTML; better HTML output; stop decoding on checksum error Program dmidecode: Fix read bug; upgrade to version 1.8 @@ -66,7 +67,7 @@ ask CVS about it: fix w83781d temp3 alarm; fix gl518sm rev 0x00 recognition; initial support for Sony Vaio eeprom Program sensors-detect: Add support for MC1066, smart battery, 8235, - IPMI, AMD8111; + IPMI, AMD8111; add help if no sensors found; add ACPI method for IBM system detection; work with old Perl versions again; initial support for Sony Vaio eeprom diff --git a/doc/chips/SUMMARY b/doc/chips/SUMMARY index 92822973..1dabe698 100644 --- a/doc/chips/SUMMARY +++ b/doc/chips/SUMMARY @@ -131,8 +131,8 @@ sis5595 smartbatt smartbatt 1 1 - - yes no -smsc74m1 - smsc74m1 - - 2 2 no yes (LPC) +smsc47m1 + smsc47m1 - - 2 2 no yes (LPC) thmc50 adm1022 3 2 - 1 dac yes no @@ -145,6 +145,9 @@ via686a vt1211 vt1211 2-7 2-7 2 2 no yes (LPC) +vt8231 + vt8231 2-7 2-7 2 2 no yes + w83781d as99127f 3 7 3 2 pwm? yes no w83781d 3 7 3 - yes yes @@ -162,6 +165,9 @@ SUPPORTED NON-SENSOR CHIPS Driver Chips ------ ----- +bmcsensors + An interface to an IPMI BMC (Baseboard management controller) + bt869 bt869 video modulator chip diff --git a/doc/chips/bmcsensors b/doc/chips/bmcsensors index 3badc285..c7444d1a 100644 --- a/doc/chips/bmcsensors +++ b/doc/chips/bmcsensors @@ -47,11 +47,15 @@ You must configure the following features in your kernel IPMI KCS handler The IPMI device interface and IPMI watchdog handler are not required. +You must modprobe i2c-ipmi separately, it will not +load automatically when you modprobe bmcsensors. + If the KCS handler (ipmi_kcs_drv) is configured as a module, -you must modprobe it separately, it will not load automatically +you must also modprobe it separately, it will not load automatically when you modprobe i2c-ipmi or ipmi_msghandler (unless you set up /etc/modules.conf to load ipmi_kcs_drv when ipmi_msghandler is loaded). + /proc entries ------------- diff --git a/doc/developers/new_drivers b/doc/developers/new_drivers index 3367e6ee..88ee7630 100644 --- a/doc/developers/new_drivers +++ b/doc/developers/new_drivers @@ -1,5 +1,6 @@ These are the steps you should follow to write a new driver and submit it to us so that it will be applied cleanly to our package. +See at the bottom for adding new chip support to an existing driver. Don't be intimidated by the list, it's just here so we don't forget anything. @@ -37,6 +38,7 @@ Steps which apply to only one type of driver are noted. Be sure and use 8 column tabs. Also, please do not use // comments. Also, please do not go past column 80. + Also, please use C99 struct initializers {.foo = blat} Please do this _before_ you check in your driver. * Add sysctl definitions to kernel/include/sensors.h (for chip drivers only). @@ -140,3 +142,33 @@ Checklist for mkpatch support, after the driver is tested and stable: * Move .o reference in kernel/[chips,busses]/Module.mk from first to second section. + + +--------------------------------------------------------------------- +Checklist for _adding_ support for a chip to an _existing_ driver: + +* Make the changes to the driver itself. + +* Add detection information to prog/detect/sensors-detect. + +* Add a strncmp() call for the new prefix in prog/sensors/main.c + (chip drivers only). + +* Add entries for the new prefix to etc/sensors.conf.eg (chip drivers only). + +* Update config help in mkpatch/mkpatch.pl. + +* Update config entry in mkpatch/Config.in (chip drivers only) + +* Update config entry in mkpatch/mkpatch.pl (bus drivers only) + +* Update doc/[chips,busses]/xxx file + +* Update doc/chips/SUMMARY file (chip drivers only) + +* Update list in README + +* Submit the changes as a patch or check them in + +* Update entry on 'new drivers' page + diff --git a/doc/developers/proc b/doc/developers/proc index bd8b881e..faa90970 100644 --- a/doc/developers/proc +++ b/doc/developers/proc @@ -34,12 +34,19 @@ There is no facility in the lm_sensors package for drivers to output general strings via /proc. This facility may be added in the future. +Alarms are direct indications read from the chips. The drivers do NOT make +comparisons of readings to thresholds. This allows violations +between readings to be caught and alarmed. The exact definition of +an alarm (for example, whether a threshold must be met or must be +exceeded to cause an alarm) is chip-dependent. + Guidelines for new entries: - If there are multiple values, some r/w and some r/o, put the r/w ones first. - Additional non-standard values should be after the standard values. + ------------------------------------------------------------------------- /proc entries are as follows: @@ -66,7 +73,7 @@ beep 2 Beep/interrupt enable and bitmask. same format as 'alarms' with same bit locations. curr[1-n] 3 Current max, min or hysteresis, and input value. - Floating point values XXX.X or XXX.XX in Amps. + Floating point values XX.X or XX.XX in Amps. The second value is preferably a hysteresis value, reported as a absolute current, NOT a delta from the max value.