R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 1 | Kernel driver ds1621 |
| 2 | ==================== |
| 3 | |
| 4 | Supported chips: |
Robert Coulson | cd6c8a4 | 2013-05-08 22:45:53 -0700 | [diff] [blame^] | 5 | * Dallas Semiconductor / Maxim Integrated DS1621 |
R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 6 | Prefix: 'ds1621' |
| 7 | Addresses scanned: I2C 0x48 - 0x4f |
Robert Coulson | cd6c8a4 | 2013-05-08 22:45:53 -0700 | [diff] [blame^] | 8 | Datasheet: Publicly available from www.maximintegrated.com |
| 9 | |
R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 10 | * Dallas Semiconductor DS1625 |
Robert Coulson | cd6c8a4 | 2013-05-08 22:45:53 -0700 | [diff] [blame^] | 11 | Prefix: |
| 12 | 'ds1621' - if binding via _detect function |
| 13 | 'ds1625' - explicit instantiation |
R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 14 | Addresses scanned: I2C 0x48 - 0x4f |
Robert Coulson | cd6c8a4 | 2013-05-08 22:45:53 -0700 | [diff] [blame^] | 15 | Datasheet: Publicly available from www.datasheetarchive.com |
| 16 | |
| 17 | * Maxim Integrated DS1721 |
| 18 | Prefix: 'ds1721' |
| 19 | Addresses scanned: I2C 0x48 - 0x4f |
| 20 | Datasheet: Publicly available from www.maximintegrated.com |
R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 21 | |
| 22 | Authors: |
| 23 | Christian W. Zuckschwerdt <zany@triq.net> |
| 24 | valuable contributions by Jan M. Sendler <sendler@sendler.de> |
| 25 | ported to 2.6 by Aurelien Jarno <aurelien@aurel32.net> |
| 26 | with the help of Jean Delvare <khali@linux-fr.org> |
| 27 | |
| 28 | Module Parameters |
| 29 | ------------------ |
| 30 | |
| 31 | * polarity int |
| 32 | Output's polarity: 0 = active high, 1 = active low |
| 33 | |
| 34 | Description |
| 35 | ----------- |
| 36 | |
| 37 | The DS1621 is a (one instance) digital thermometer and thermostat. It has |
| 38 | both high and low temperature limits which can be user defined (i.e. |
| 39 | programmed into non-volatile on-chip registers). Temperature range is -55 |
| 40 | degree Celsius to +125 in 0.5 increments. You may convert this into a |
| 41 | Fahrenheit range of -67 to +257 degrees with 0.9 steps. If polarity |
| 42 | parameter is not provided, original value is used. |
| 43 | |
| 44 | As for the thermostat, behavior can also be programmed using the polarity |
| 45 | toggle. On the one hand ("heater"), the thermostat output of the chip, |
| 46 | Tout, will trigger when the low limit temperature is met or underrun and |
| 47 | stays high until the high limit is met or exceeded. On the other hand |
| 48 | ("cooler"), vice versa. That way "heater" equals "active low", whereas |
| 49 | "conditioner" equals "active high". Please note that the DS1621 data sheet |
| 50 | is somewhat misleading in this point since setting the polarity bit does |
| 51 | not simply invert Tout. |
| 52 | |
| 53 | A second thing is that, during extensive testing, Tout showed a tolerance |
| 54 | of up to +/- 0.5 degrees even when compared against precise temperature |
| 55 | readings. Be sure to have a high vs. low temperature limit gap of al least |
| 56 | 1.0 degree Celsius to avoid Tout "bouncing", though! |
| 57 | |
Jean Delvare | 25f3311 | 2009-03-30 21:46:41 +0200 | [diff] [blame] | 58 | The alarm bits are set when the high or low limits are met or exceeded and |
| 59 | are reset by the module as soon as the respective temperature ranges are |
| 60 | left. |
R.Marek@sh.cvut.cz | 7f15b66 | 2005-05-26 12:42:19 +0000 | [diff] [blame] | 61 | |
| 62 | The alarm registers are in no way suitable to find out about the actual |
| 63 | status of Tout. They will only tell you about its history, whether or not |
| 64 | any of the limits have ever been met or exceeded since last power-up or |
| 65 | reset. Be aware: When testing, it showed that the status of Tout can change |
| 66 | with neither of the alarms set. |
| 67 | |
| 68 | Temperature conversion of the DS1621 takes up to 1000ms; internal access to |
| 69 | non-volatile registers may last for 10ms or below. |
Robert Coulson | cd6c8a4 | 2013-05-08 22:45:53 -0700 | [diff] [blame^] | 70 | |
| 71 | The DS1625 is pin compatible and functionally equivalent with the DS1621, |
| 72 | but the DS1621 is meant to replace it. |
| 73 | |
| 74 | The DS1721 is pin compatible with the DS1621, has an accuracy of +/- 1.0 |
| 75 | degree Celsius over a -10 to +85 degree range, a minimum/maximum alarm |
| 76 | default setting of 75 and 80 degrees respectively, and a maximum conversion |
| 77 | time of 750ms. |